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скрывает только индикацию хода выполнения.