elide --help показує повсякденні команди; elide --help-all додає групу Advanced і всі прапорці.
elide help <command> виводить розділ цієї сторінки, присвячений команді.
Запуск і розробка
run
Запускає файл, іменований скрипт або точку входу проєкту. Порядок вибору: Налаштування проєкту.
elide run app.ts -- --port 3000| Прапорець | Дія |
|---|---|
-s, --snippet CODE | Виконати код із рядка замість файлу. |
-l, --language LANG | Мова фрагмента: js (за замовчуванням), ts, python, java або kotlin. |
--contexts=<N|auto> | Скільки контекстів застосунку створити заздалегідь; auto рахує за фізичними ядрами. За замовчуванням 1. |
Фрагменти на Java і Kotlin — це цілі програми з main; аргументи після -- передаються їй:
elide run -l java -s 'void main() { System.out.println("hello from java " + (6 * 7)); }'
elide run -l kotlin -s 'fun main(args: Array<String>) = println(args.joinToString())' -- a bhello from java 42
a, bФрагмент на Java без класу або main завершується помилкою
Could not find a top-level class/record/enum or a main in the Java snippet.;
фрагмент на Kotlin без main — помилкою
Could not find a `main` function in the Kotlin snippet; declare `fun main() { ... }`.
Прапорці налагоджувача, профілювальника й покриття: Прапорці діагностики.
serve (псевдонім start)
Роздає каталог як статичні файли або скрипт, що експортує обробник fetch (Сервер розробки).
elide serve ./public
elide serve server.ts -- --verbose| Прапорець | Дія |
|---|---|
--host HOST | Хост для прив’язки. За замовчуванням 127.0.0.1. |
--port PORT | Порт для прив’язки. За замовчуванням 8080. |
--contexts=<N|auto> | Скільки контекстів застосунку створити заздалегідь, як для run. |
--no-tui | Простий вивід журналу замість панелі моніторингу. |
-- SCRIPT_ARGS | Аргументи для скрипта, який обслуговується. |
dev
Те саме, що serve, з тими самими прапорцями, на порту 3000. Для каталогу HTML-сторінки перезавантажуються в
браузері, коли змінюються файли; скрипт не перезавантажується. --no-watch вимикає стеження та перезавантаження.
install
Встановлює залежності проєкту.
| Прапорець | Дія |
|---|---|
--ecosystems LIST | Екосистеми для встановлення, наприклад maven,npm. За замовчуванням maven. |
--workspace | Встановити всі екосистеми, оголошені в проєкті. |
--with CLASSIFIER | Додатково завантажити sources, docs або javadoc. |
--slim | Завантажувати лише класи. |
--fresh | Завантажити всі залежності заново, оновивши артефакти в глобальному кеші. |
--direct | Копіювати артефакти в проєкт, а не посилатися на них. |
repl
Запускає інтерактивний REPL. Те саме робить elide без аргументів у терміналі.
python
Запускає Python так само, як python; аргументи після скрипта передаються програмі. Спершу встановіть його
командою setup.
elide python script.py --flag-for-the-script| Прапорець | Дія |
|---|---|
-c CMD | Виконати програму, передану рядком. |
-s | Не додавати користувацький каталог site до sys.path. |
Прапорці інтерпретатора (-B, -W, -m, …): Параметри Python.
Збирання і тестування
build
Збирає те, що оголошено в elide.pkl. Окремі слова називають завдання (deps, compile, test, clean;
початковий : необов’язковий). Аргументи після -- передаються підпроцесу.
elide build deps compile| Прапорець | Дія |
|---|---|
-i, --inspect | Показати завдання проєкту. |
--workers=<N> | Виконувати щонайбільше N завдань одночасно. |
--no-cache | Вимкнути кеш збирання для цього запуску. |
--offline | Не завантажувати віддалені ресурси. |
-f, --flag NAME[=VALUE] | Задати прапорець збирання з маніфесту (Прапорці збирання). |
test
Запускає тести, усі або лише з указаних шляхів. Тести JVM беруться з тестового набору вихідних файлів: за домовленістю
src/test/java або src/test/kotlin, або з набору, оголошеного в elide.pkl (див.
Набори вихідних файлів).
| Прапорець | Дія |
|---|---|
-t, --test-name-pattern REGEX | Запустити тести, назва яких збігається з виразом. |
--where CEL | JS: запустити тести, для яких вираз CEL над name, parents і file істинний. |
--select SELECTOR | JVM: запустити те, що вказує селектор: class:, method: або package:. Можна повторювати. |
--include-tag EXPR | JVM: запустити тести, що відповідають будь-якому з включень. Можна повторювати. |
--exclude-tag EXPR | JVM: пропустити тести, що відповідають будь-якому з виключень. Можна повторювати. |
--bail[=N] | Зупинитися після N збоїв. За замовчуванням 1. |
--test-timeout MS | Тайм-аут для одного тесту. --timeout обмежує весь запуск. |
--only | Запустити лише тести, позначені .only. |
--concurrency N | Скільки тестів виконувати одночасно (файли JS, класи JVM). За замовчуванням 1. |
--reporter NAME | console, junit або tap. |
--reporter-outfile DIR | Каталог для виводу звіту. |
Налагодження тестів: Налагодження.
format (псевдонім fmt)
Форматує вихідні файли на Java і Kotlin. Шляхи та прапорці форматувальника йдуть після --: elide format -- src.
| Прапорець | Дія |
|---|---|
--list-files | Вивести кожен файл, який не пройшов перевірку або був змінений. |
--list-diffs[=N] | У режимі перевірки вивести diff для кожного файлу; з N — лише якщо не пройшли N файлів або менше. |
--dry-run (після --) перевіряє, нічого не записуючи; якщо якийсь файл змінився б, команда завершується з кодом 1.
project
| Команда | Призначення |
|---|---|
elide project info | Показати розв’язані метадані проєкту. |
elide project advice | Показати поради щодо проєкту для ШІ-агентів. |
elide project export | Вивести проєкт як JSON, pom.xml або модель IntelliJ. |
publish
elide publish [PROJECT...] [--to <name>] [--skip-existing] [--dry-run] [--sign | --no-sign] [--no-wait]
[--allow-http-repositories] [--offline]Збирає JAR-файли проєкту та встановлює їх разом із POM у локальний репозиторій Maven (~/.m2/repository, якщо
publishing.maven.localRepository не вказує інше). З кореня робочого простору публікує всі проєкти. З учасника
публікує цей проєкт і всі проєкти робочого простору, від яких залежить його POM, щоб названі в ньому координати теж
були встановлені. Усі проєкти збираються, готуються й підписуються до публікації будь-якого з них, тож збій на цих
етапах нічого не публікує; збій під час вивантаження може залишити проєкти, вивантажені до нього.
Налаштування — у блоці publishing маніфесту.
Якщо назвати проєкти робочого простору, публікуються саме вони, наприклад лише ті, що змінилися з останнього випуску:
elide publish core util --to central. Проєкт робочого простору, від якого вони залежать, але який не названо, має вже
бути в цільовому репозиторії у версії, оголошеній у його маніфесті, інакше нічого не публікується. Пропущені проєкти
зберігають свою конфігурацію publishing, тож наступний запуск може опублікувати їх знову.
| Прапорець | Дія |
|---|---|
--to <name> | Публікувати в репозиторій із цією назвою з publishing. замість локального. |
--skip-existing | Пропустити всі проєкти, версія яких уже є в цільовому репозиторії, і повідомити, які саме. Snapshot-версія публікується завжди. Корисно, щоб повторно запустити випуск, що зупинився на півдорозі. |
--dry-run | Підготувати (і підписати) POM і JAR-файли в . та вивести їх перелік, нічого не публікуючи. Для Maven Central також записує й виводить пакет і не потребує токена Portal, але все одно підписує файли, тож потрібен робочий ключ підпису. З названими проєктами або --skip-existing однаково перевіряє версії в цільовому репозиторії й виводить те, що опублікував би справжній запуск; для Central для цього потрібен токен. |
--sign, --no-sign | Підписувати файли за допомогою gpg чи ні. Публікації у віддалені репозиторії за замовчуванням підписуються, якщо задано signing. |
--no-wait | Для Maven Central повернутися після вивантаження розгортання, не чекаючи перевірки. |
--allow-http-repositories | Дозволити репозиторій із простим http://, відмінний від localhost. |
--offline | Збирати без завантаження віддалених ресурсів. |
Версія є в цільовому репозиторії, якщо її POM лежить у локальному репозиторії, якщо віддалений репозиторій віддає її POM або якщо Central Portal повідомляє, що її опубліковано. Розгортання в Central, яке пройшло перевірку, але ще не випущене, не враховується. Якщо перевірка не вдалася з іншої причини, наприклад через відхилені облікові дані, запуск зупиняється, а версія не вважається відсутньою.
Формати експорту проєкту
elide project export --format=<json|pom|intellij> виводить результат у stdout. За замовчуванням json.
| Формат | Вивід |
|---|---|
json | Обчислений маніфест. Дискримінатори типів використовують @type та імена типів Pkl. |
pom | Координати, залежності за областями, репозиторії, рівні компілятора, корені вихідних файлів і ресурсів. |
intellij | По модулю на кожен набір вихідних файлів, із коренями вмісту, залежностями, рівнем SDK і фасетом Kotlin. |
pom
| Елемент POM | Значення |
|---|---|
<artifactId> | Назва проєкту. |
<groupId> | Назва кореня робочого простору або назва проєкту поза робочим простором. |
<version> | Версія з маніфесту або 0.0.0. |
<modules> | Учасники кореня робочого простору. |
<parent> | Корінь робочого простору для учасника. |
| Маніфест | Область Maven |
|---|---|
packages, modules | compile |
compileOnly, devPackages, processors | provided |
runtimeOnly | runtime |
testPackages | test |
Сусідні проєкти стають залежностями за координатами, а локальні JAR-файли — залежностями з областю system.
exclusions і kotlinPlugins не включаються. Додаткові корені вихідних файлів використовують
build-helper-maven-plugin.
intellij
Модулі називаються <project>.<sourceSet>. Шляхи вказуються відносно root — кореня робочого простору або проєкту.
Бібліотеки розв’язуються з localRepository (за замовчуванням .dev/dependencies/m2), тож спершу виконайте
elide install. Плагін для IntelliJ IDEA імпортує цю модель.
Інструментарій JVM
Elide постачається з JDK 25 і Kotlin. Прапорці Elide йдуть до --, аргументи інструмента — після.
java
Запускає програми JVM, як java.
elide java -- -jar app.jarjavac
Компілює Java, як javac. Див. Компілятор Java.
| Прапорець | Дія |
|---|---|
--jar JAR | Після компіляції запакувати JAR за цим шляхом. |
--manifest MANIFEST | Маніфест для результату --jar. |
--max-errors N | Показати щонайбільше N різних помилок; 0 показує всі. |
--report-used-deps PATH | Записати елементи classpath, які використовує результат (strict-deps у Bazel). |
--persistent_worker | Працювати як постійний воркер Bazel. |
--classpath-cache | Повторно використовувати стан classpath між компіляціями воркера. Лише для воркера. |
--capabilities | Вивести можливості компілятора в JSON. |
kotlinc
Компілює Kotlin, як kotlinc. Див. Компілятор Kotlin.
| Прапорець | Дія |
|---|---|
--incremental | Компілювати інкрементно; стан зберігається в .. |
--incremental-cache-dir DIR | Каталог для інкрементного стану. |
--plugins LIST | Вбудовані плагіни: metro, serialization, atomicfu, power-assert. |
--metro / --no-metro | Примусово ввімкнути або вимкнути плагін DI Metro. |
--tests | Увімкнути тестові плагіни (power-assert). |
--abi-only | Видати в -d лише ABI-JAR (заголовковий). |
--max-errors N | Показати щонайбільше N різних помилок; 0 показує всі. |
--report-used-deps PATH | Записати елементи classpath, які використовує результат (strict-deps у Bazel). |
--persistent_worker | Працювати як постійний воркер Bazel. |
jar
Збирає JAR-файли, як jar. Див. Збирання JAR.
Налаштування та інструменти
Команди elide agent призначені для ШІ-агентів та інших неінтерактивних програм, що їх викликають; див.
Для ШІ-агентів.
| Команда | Прапорці | Дія |
|---|---|---|
elide agent help [TOPIC] | -l, --lang LANG | Вивести посібник для агентів або тему документації у форматі Markdown. |
elide agent diagnostics | --json | Вивести версію, платформу, каталог звітів про збої та стан термінала. |
elide agent bug | --kind bug|perf|expectation|feature, --json | Вивести URL задачі й текст звіту; --json виводить заготовку elide.report/1. Нічого не надсилає. |
elide agent perf -- COMMAND | --runs N (10), --warmup N (3), --baseline COMMAND, --against VERSION, --json | Заміряти час команди локально, за потреби порівняно з іншим середовищем виконання або встановленою версією Elide. |
elide agent perf --runs 5 --warmup 1 -- elide run hi.mjselide run hi.mjs (5 runs, 1 warmup)
wall 83.4 ms ± 20.1 min 57.7 max 107.0
cpu user 15.8 ms sys 33.1 ms
rss max 66.8 MiB
For servers, measure with wrk or oha and paste the resultsКоманда після -- — це повний командний рядок, разом з elide. Поля звіту та прапорці докладно:
Повідомити про проблему.
init
Створює проєкт із шаблону. Без прапорців відкриває редактор.
Шаблони: java, ktjvm, web-demo, web-simple, workspace (бібліотека на Kotlin і застосунок).
| Прапорець | Дія |
|---|---|
--templates | Вивести ідентифікатори шаблонів. |
-t, --template TEMPLATE | Вибрати шаблон. |
--parameters | Вивести параметри шаблону. |
--json | Вивести --templates або --parameters у JSON. |
-i, --plain | Ставити прості запитання замість відкриття редактора. |
-d, --skip-defaults | Пропустити параметри зі значеннями за замовчуванням. Потребує --plain. |
-s, --skip-run | Не запускати Elide після генерації. |
--overwrite | Замінити наявні файли. |
adopt
Переносить проєкт із поточного каталогу на Elide за допомогою ШІ-агента для програмування
(Перенесення наявного проєкту). Без прапорців питає про кожен вибір. Завершується з кодом 0,
якщо агент відпрацював успішно, 1 — якщо він завершився помилкою або не зміг запуститися, 130 — у разі натискання
Ctrl+C.
| Прапорець | Дія |
|---|---|
--build STRATEGY | elide (створити збирання Elide) або existing (залишити Maven/Gradle). |
--harness HARNESS | codex, claude або omp. |
--approval MODE | auto-approve, manual-approve або yolo (обходить захист). |
--log | Показувати вивід агента на екрані, а не лише в журналі. |
--prompt-append FILE | Додати вказівки до промпту. Можна повторювати. |
--non-interactive | Пакетний режим. Потребує всіх трьох виборів; несумісний із manual-approve. |
help
Читайте цю документацію офлайн. Назва команди виводить її розділ, slug або заголовок — сторінку, а
options перелічує всі прапорці.
| Прапорець | Дія |
|---|---|
--format FORMAT | auto (за замовчуванням), interactive або markdown. |
-w, --width WIDTH | Максимальна ширина. За замовчуванням 110. |
-l, --lang LANG | Мова відображення. |
--languages | Вивести доступні мови відображення. |
--no-animation | Приховати анімацію снігу; Tab перемикає її. |
info
Показує відомості про бінарний файл, платформу, мови та мережевий транспорт. --cargo-lockfile виводить вбудований
lock-файл.
upgrade
Оновлює Elide.
| Прапорець | Дія |
|---|---|
--check | Повідомити про оновлення, не застосовуючи його. |
--force | Оновити, навіть якщо версія актуальна. |
--channel CHANNEL | release або nightly. За замовчуванням — канал цієї збірки. |
setup
Встановлює необов’язковий компонент: elide setup python.
| Прапорець | Дія |
|---|---|
--channel CHANNEL | release або nightly. За замовчуванням — канал цієї збірки. |
--force | Повторно застосувати встановлений компонент. |
setup встановлює компонент для запущеної версії й ніколи не оновлює та не відкочує Elide. elide upgrade зберігає
встановлені компоненти. setup відмовляється працювати з установленнями через менеджери пакетів (Homebrew, apt, RPM,
MSI, nix, snap); скористайтеся скриптом встановлення:
curl -sSL --tlsv1.2 elide.sh | bash -s -- --with-pythonuse
Закріплює версію в .elideversion і завантажує її: elide use 1.6.0.
| Прапорець | Дія |
|---|---|
--channel CHANNEL | release або nightly. |
--no-install | Записати закріплену версію без завантаження. |
Версії — це випуски (1.6.0, v1.6.0) або дати nightly-збірок (20260921). --ignore-version однаково запускає
цей бінарний файл.
lsp
Запускає сервер Language Server Protocol через stdio. Обслуговує Java; див. Інші редактори.
mcp
Запускає сервер Model Context Protocol. Див. MCP-сервер проєкту.
| Прапорець | Дія |
|---|---|
--mode MODE | stdio (за замовчуванням) або http (застарілий HTTP+SSE). |
--host HOST | Хост для прив’язки HTTP. За замовчуванням localhost. |
--port PORT | Порт для прив’язки HTTP. За замовчуванням 8125. |
Додаткові команди
Їх показує elide --help-all.
classpath
Виводить розв’язаний classpath для [<sourceSet>:]<usage>, наприклад test:runtime. Призначення: toolchain,
processor, compile, modules, runtime, provided. За замовчуванням main:compile; невідоме призначення завершує
команду з кодом 2.
| Прапорець | Дія |
|---|---|
--offline | Не завантажувати віддалені ресурси. |
index
Індексує розв’язані залежності Maven проєкту й виконує запити до цього індексу. Дії: build, status (за
замовчуванням), get <address>, references <address>, used-by <name>, resolve <name>. Адреса має вигляд
maven:group:artifact:version, за яким можуть іти /symbol і #member; член — це name(paramType,...) для методів і
конструкторів (<init>) і просто ім’я для полів. build записує шари, указані в --layers (за замовчуванням l0,l1;
l2 додає сигнатури членів, l3 — вихідні посилання), поруч із уже побудованими. get, references і resolve
завершуються з кодом 1 для невідомого артефакту, символу, члена або імені та з кодом 2, якщо потрібний їм шар ще не
побудовано; виконайте elide index build --layers=....
build також компілює основні вихідні файли на Java і Kotlin та оновлює їхній локальний індекс посилань.
references local:<project>/<type> читає вихідні посилання локального класу; used-by <type>[#member] виводить
відповідні локальні вихідні файли зі шляхами відносно пакета. Запити не оновлюють ці скомпільовані посилання.
Приклади та експериментальні межі: Індекс коду залежностей.
| Прапорець | Дія |
|---|---|
--layers=<l0,l1,l2,l3> | Шари, які записує build; l0 додається завжди. |
--offline | Не завантажувати віддалені ресурси. |
javadoc
Генерує Javadoc, як javadoc. Аргументи йдуть після --.
| Прапорець | Дія |
|---|---|
--theme THEME | default або elide. |
javaformat
Форматує Java за допомогою google-java-format або, з --jfmt, у діалекті Netflix jfmt. Аргументи йдуть після --.
Приймає --list-files і --list-diffs команди format. Див. Форматування.
javap
Дизасемблює байт-код JVM, як javap. Аргументи йдуть після --.
jdeps
Аналізує залежності класів JVM, як jdeps. Аргументи йдуть після --.
ktfmt
Форматує Kotlin за допомогою ktfmt. Аргументи йдуть після --. Приймає --list-files і --list-diffs команди
format.
mvn
Запускає Maven, як mvn: elide mvn -- package. Див. Native Maven.
Прапорець (після --) | Дія |
|---|---|
--flavor NAME | Набір плагінів, наприклад spring@4.1.0. За замовчуванням визначається з pom.xml. |
--mode=MODE | native (за замовчуванням), mixed або legacy. |
--yes | Дозволяти завантаження без запиту. |
--porcelain | Показувати власний вивід Maven. |
native-image
Збирає програму JVM у нативний виконуваний файл. Аргументи йдуть після --. Див.
Native Image.
rewrite
Запускає рецепти OpenRewrite для основних вихідних файлів проєкту на Java (експериментально в 1.6.0). Рецепти беруться з
вбудованих бібліотек і dependencies.maven.devPackages; типи залежностей — з індексу коду. elide rewrite --list
виводить доступні рецепти; elide rewrite <name>… застосовує їх по черзі. За замовчуванням команда компілює основні
вихідні файли й відбирає файли-кандидати, коли це дозволяють передумови рецептів. Налаштування, приклади та обмеження
сумісності: OpenRewrite. Код виходу 1 — для невідомого рецепта, 2 — для помилки
використання.
| Прапорець | Дія |
|---|---|
--dry-run | Вивести diff, не застосовуючи змін до вихідних файлів; стан збирання все одно може записуватися. |
--list | Вивести доступні рецепти, не компілюючи основні вихідні файли. |
--no-prefilter | Пропустити компіляцію основних вихідних файлів і розібрати всі основні вихідні файли на Java. |
--offline | Не завантажувати віддалені ресурси. |
web
Веб-інструменти: elide web build app.ts page.md --out dist збирає файли без маніфесту. Див.
Веб-інструментарій.
| Прапорець | Дія |
|---|---|
-o, --out DIR | Каталог для результатів. |
Глобальні параметри
Приймаються до або після назви команди, але до будь-якого --.
Загальні прапорці
| Параметр | Дія |
|---|---|
-p, --project PATH | Каталог проєкту. |
-f, --flag NAME[=VALUE] | Задати прапорець збирання з маніфесту. |
-q, --quiet | Приховати індикацію перебігу. Попередження, помилки й вивід програми однаково друкуються. |
-v, --verbose / --debug | Докладніше журналювання. |
--color / --no-color | Примусово ввімкнути або вимкнути колір. |
--timeout DURATION | Обмеження часу, наприклад 30s, 5m; 0 вимикає його. Завершує дочірні процеси й виходить із кодом 124. |
--max-mem SIZE | Обмеження купи, наприклад 512m, 8g. Для одноразових запусків за замовчуванням 4g. |
--limit NAME=COUNT | Обмеження ресурсу: workers або fds. Можна повторювати. |
--interop | Один спільний контекст для всіх мов (Мови та взаємодія). |
-V, --version | Вивести версію. |
Прапорці пісочниці
Програми працюють без обмежень, доки не передано прапорець пісочниці. Див. Пісочниця та обмеження.
| Параметр | Дія |
|---|---|
--sandbox[=PROFILE] | Профіль: trusted. --sandbox без значення обмежує доступ до файлової системи. |
--allow-read[=PATHS] | Дозволити читання; без значення — усе. |
--allow-write[=PATHS] | Дозволити запис; без значення — усе. |
--allow-net[=HOSTS] | Дозволити мережу; без значення — всю. |
--deny-net=HOSTS | Заборонити хости; має пріоритет над --allow-net. |
--allow-run[=CMDS] | Дозволити підпроцеси; без значення — усі. |
--deny-run=CMDS | Заборонити команди; має пріоритет над --allow-run. |
--allow-env[=NAMES] | Змінні, які може читати маніфест; без значення — усі. |
--fs-audit | Журналювати кожне рішення щодо доступу до файлової системи. |
--allow-threads | Дозволити гостьові потоки. За замовчуванням заборонені. |
--allow-native / --no-native | Дозволити або заборонити гостьовий нативний доступ. |
Прапорці діагностики
| Параметр | Дія |
|---|---|
--debugger[= | Під’єднати налагоджувач: auto, cdp, dap або адресу JDWP (5005, host:5005). Див. Налагодження. |
--debugger-host HOST | Хост для прив’язки налагоджувача. За замовчуванням 127.0.0.1. |
--debugger-port PORT | Порт налагоджувача. За замовчуванням 4711 (DAP) або 1337 (CDP). |
--profiler[=PROFILER] | cputracing, cpusampling або memtracing. |
--coverage[=auto] | Збирати покриття. |
--insights INSIGHTS | Впровадити скрипти Insight. |
--error-format FORMAT | Неперехоплені помилки: auto (за замовчуванням), pretty або plain. |
--abort-on-uncaught-exception | Аварійно завершуватися з SIGABRT у разі неперехопленого винятку. |
--redirect-warnings FILE | Писати попередження у FILE замість stderr. |
Прапорці версії
| Параметр | Дія |
|---|---|
--use-version VERSION | Запустити іншу встановлену версію Elide. |
--ignore-version | Ігнорувати .elideversion і --use-version. |
Додаткові прапорці
| Параметр | Дія |
|---|---|
--transport TRANSPORT | Мережевий транспорт (Мережевий транспорт). |
--locale LOCALE | Локаль CLI, наприклад fr. |
-X, --vm KEY=VALUE | Задати властивість VM. |
--safe-close | Повністю завершувати роботу навіть для одноразових запусків. |
--pkgst / --no-pkgst | Приймається; ні на що не впливає. Як оминути проксі maven.pkg.st, див. Репозиторії. |
--otel-endpoint=URL | Надсилати дані OpenTelemetry на цю кінцеву точку OTLP. |
--otel-provider= | Надсилати дані OpenTelemetry провайдеру: otlp, sentry, datadog, posthog, honeycomb, grafana. |
--otel-protocol= | Протокол OTLP: grpc, http/protobuf, http/json. |
--otel-shutdown=MODE | Як виконується останній експорт під час виходу: sidecar, inline, drop. |
--no-otel | Вимкнути експорт OpenTelemetry. |
--help-instruments | Вивести прапорці інструментів. |
Параметри Python
Прапорці CPython; указуйте їх перед скриптом.
| Параметр | Дія |
|---|---|
-I | Ізольований режим. |
-B | Не записувати файли байт-коду. |
-E | Ігнорувати змінні оточення PYTHON*. |
-S | Не виконувати import site під час запуску. |
-u | Небуферизовані stdout і stderr. |
-P | Не додавати небезпечний шлях на початок sys.path. |
-O | Оптимізувати. Можна повторювати. |
-b | Попереджати про порівняння bytes/str. Можна повторювати. |
-x | Приймається; ні на що не впливає. |
-W ARG | Керування попередженнями. Можна повторювати. |
-m MODULE | Запустити модуль як __main__. |
Мережевий транспорт
--transport= | Дія |
|---|---|
auto | За замовчуванням: v2 у Linux і macOS, nio в інших системах. |
v2 | Власний транспорт Elide. |
epoll, kqueue, io_uring | v2 із цим драйвером. На інших платформах завершується помилкою. |
nio | Переносний транспорт. |
Інструменти діагностики
| Параметр | Дія |
|---|---|
--jfr FILE | Записати файл JFR, який зберігається під час виходу. |
--jfr-settings SETTINGS | default, profile (за замовчуванням) або файл .jfc. |
--jitdump DIR | Записувати метадані JIT для Linux perf. |
--heap-dump FILE | Зробити дамп купи під час виходу. |
--heap-dump-on-oom FILE | Зробити дамп купи в разі нестачі пам’яті, потім вийти з кодом 3. |
--vmstat | Зробити процес видимим для jps, jstat і jcmd. |
Коди виходу
| Код | Значення |
|---|---|
0 | Успіх, вивід довідки або версії. |
1 | Команда або програма завершилася помилкою. |
2 | Неправильне використання, невідома ціль запуску або вилучена команда. |
3 | Нестача пам’яті; --heap-dump-on-oom записав дамп купи. |
124 | Сплив --timeout. |
| інший | Задається програмою або інструментом. |
Потоки виводу
- Вивід програми, звіти про тести й машинозчитуваний вивід ідуть у stdout.
- Індикація перебігу та діагностика йдуть у stderr.
- Колір вимкнено, якщо потік не є терміналом.
--color,FORCE_COLORабоCLICOLOR_FORCEпримусово вмикають його;--no-colorабоNO_COLORвимикають. --quietприховує лише індикацію перебігу.