elide --help muestra los comandos de uso diario; elide --help-all añade el grupo Avanzado y todas las opciones.
elide help <command> imprime la sección de esta página dedicada a ese comando.
Ejecutar y desarrollar
run
Ejecuta un archivo, un script con nombre o el punto de entrada del proyecto. Orden de resolución: Configurar un proyecto.
elide run app.ts -- --port 3000| Opción | Efecto |
|---|---|
-s, --snippet CODE | Ejecuta código en línea en lugar de un archivo. |
-l, --language LANG | Lenguaje del fragmento: js (predeterminado), ts, python, java o kotlin. |
--contexts=<N|auto> | Contextos de aplicación que se crean de antemano; auto los calcula a partir de los núcleos físicos. Predeterminado: 1. |
Los fragmentos de Java y Kotlin son programas completos con un main; los argumentos tras -- llegan a él:
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, bUn fragmento de Java sin clase ni main falla con Could not find a top-level class/record/enum or a main in the Java snippet.; un fragmento de Kotlin sin main falla con Could not find a `main` function in the Kotlin snippet; declare `fun main() { ... }`.
Opciones de depurador, perfilador y cobertura: Opciones de diagnóstico.
serve (alias start)
Sirve un directorio como archivos estáticos, o un script que exporta un manejador fetch (Servidor de desarrollo).
elide serve ./public
elide serve server.ts -- --verbose| Opción | Efecto |
|---|---|
--host HOST | Host de escucha. Predeterminado: 127.0.0.1. |
--port PORT | Puerto de escucha. Predeterminado: 8080. |
--contexts=<N|auto> | Contextos de aplicación que se crean de antemano, como en run. |
--no-tui | Registros en texto plano en lugar del panel. |
-- SCRIPT_ARGS | Argumentos para el script servido. |
dev
Como serve, con las mismas opciones, en el puerto 3000. Con un directorio, las páginas HTML se recargan en el
navegador cuando cambian los archivos; un script no se recarga. --no-watch desactiva la vigilancia y la recarga.
install
Instala las dependencias del proyecto.
| Opción | Efecto |
|---|---|
--ecosystems LIST | Ecosistemas que se instalan, p. ej. maven,npm. Predeterminado: maven. |
--workspace | Instala todos los ecosistemas que declara el proyecto. |
--with CLASSIFIER | Descarga también sources, docs o javadoc. |
--slim | Descarga solo las clases. |
--fresh | Descarga todas las dependencias y actualiza los artefactos de la caché global. |
--direct | Copia los artefactos en el proyecto en lugar de enlazarlos. |
repl
Inicia el REPL interactivo. Un elide sin argumentos en la terminal hace lo mismo.
python
Ejecuta Python como python; los tokens posteriores al script van al programa. Instálelo antes con
setup.
elide python script.py --flag-for-the-script| Opción | Efecto |
|---|---|
-c CMD | Ejecuta un programa pasado como cadena. |
-s | Deja el directorio site del usuario fuera de sys.path. |
Opciones del intérprete (-B, -W, -m, …): Opciones de Python.
Compilar y probar
build
Compila lo que declara elide.pkl. Los tokens sueltos nombran tareas (deps, compile, test, clean; el :
inicial es opcional). Los argumentos tras -- van al subproceso.
elide build deps compile| Opción | Efecto |
|---|---|
-i, --inspect | Lista las tareas del proyecto. |
--workers=<N> | Ejecuta como máximo N tareas a la vez. |
--no-cache | Desactiva la caché de compilación en esta ejecución. |
--offline | No descarga recursos remotos. |
-f, --flag NAME[=VALUE] | Define una opción de compilación del manifiesto (Opciones de compilación). |
test
Ejecuta las pruebas, o solo las que están bajo las rutas indicadas. Las pruebas de JVM proceden de un conjunto de
fuentes de pruebas: src/test/java o src/test/kotlin por convención, o uno declarado en elide.pkl (consulte
Conjuntos de fuentes).
| Opción | Efecto |
|---|---|
-t, --test-name-pattern REGEX | Ejecuta las pruebas cuyo nombre coincide. |
--where CEL | JS: ejecuta las pruebas para las que una expresión CEL sobre name, parents y file es verdadera. |
--select SELECTOR | JVM: ejecuta lo que nombra un selector: class:, method: o package:. Repetible. |
--include-tag EXPR | JVM: ejecuta las pruebas que coinciden con alguna inclusión. Repetible. |
--exclude-tag EXPR | JVM: omite las pruebas que coinciden con alguna exclusión. Repetible. |
--bail[=N] | Se detiene tras N fallos. Predeterminado: 1. |
--test-timeout MS | Tiempo límite por prueba. --timeout limita la ejecución completa. |
--only | Ejecuta solo las pruebas marcadas con .only. |
--concurrency N | Pruebas simultáneas (archivos JS, clases de JVM). Predeterminado: 1. |
--reporter NAME | console, junit o tap. |
--reporter-outfile DIR | Directorio de salida del informe. |
Depurar pruebas: Depuración.
format (alias fmt)
Formatea fuentes de Java y Kotlin. Las rutas y las opciones del formateador van tras --: elide format -- src.
| Opción | Efecto |
|---|---|
--list-files | Imprime cada archivo que no supera la comprobación o que cambia. |
--list-diffs[=N] | Imprime un diff por archivo en modo de comprobación; con N, solo cuando fallan N o menos. |
--dry-run (tras --) comprueba sin escribir; sale con 1 si algún archivo cambiaría.
project
| Comando | Propósito |
|---|---|
elide project info | Muestra los metadatos resueltos del proyecto. |
elide project advice | Muestra recomendaciones del proyecto para agentes de programación. |
elide project export | Imprime el proyecto como JSON, como pom.xml o como modelo de IntelliJ. |
publish
elide publish [PROJECT...] [--to <name>] [--skip-existing] [--dry-run] [--sign | --no-sign] [--no-wait]
[--allow-http-repositories] [--offline]Compila los JAR del proyecto y los instala con un POM en el repositorio Maven local (~/.m2/repository, salvo que
publishing.maven.localRepository indique otro). Desde la raíz de un espacio de trabajo publica todos los proyectos.
Desde un miembro publica ese miembro y todos los proyectos del espacio de trabajo de los que depende su POM, de modo
que también se instalan las coordenadas que nombra. Todos los proyectos se compilan, preparan y firman antes de
publicar ninguno, así que un fallo en esa fase no publica nada; una subida fallida sí puede dejar publicados los
proyectos subidos antes. Se configura en el bloque publishing del manifiesto.
Si nombra proyectos del espacio de trabajo, se publican exactamente esos; por ejemplo, solo los que cambiaron desde
la última versión: elide publish core util --to central. Un proyecto del espacio de trabajo del que dependen pero
que no se nombra debe estar ya en el destino, con la versión que declara su manifiesto, o no se publica nada. Los
proyectos que deja fuera conservan su configuración publishing, así que una ejecución posterior puede volver a
publicarlos.
| Opción | Efecto |
|---|---|
--to <name> | Publica en el repositorio con ese nombre de publishing. en lugar del local. |
--skip-existing | Deja fuera todo proyecto cuya versión ya está en el destino e indica cuáles. Una versión snapshot siempre se publica. Útil para repetir una publicación que falló a medias. |
--dry-run | Prepara (y firma) el POM y los JAR en . y los lista, sin publicar. Con Maven Central también escribe y lista el paquete, y no necesita token del Portal, pero sigue firmando, así que necesita una clave de firma utilizable. Con proyectos nombrados o con --skip-existing, sigue consultando las versiones en el destino, de modo que lista lo que publicaría una ejecución real; para Central eso necesita el token. |
--sign, --no-sign | Firma los archivos con gpg, o no. Las publicaciones remotas firman por defecto cuando signing está definido. |
--no-wait | Con Maven Central, termina en cuanto se sube el despliegue en lugar de esperar a la validación. |
--allow-http-repositories | Permite un repositorio http:// sin cifrar distinto de localhost. |
--offline | Compila sin descargar recursos remotos. |
Una versión está en el destino cuando su POM está en el repositorio local, cuando el repositorio remoto sirve su POM o cuando el Central Portal la da por publicada. Un despliegue de Central validado pero aún no liberado no cuenta. Una consulta que falla por cualquier otro motivo, como credenciales rechazadas, detiene la ejecución en lugar de contar como ausente.
Formatos de exportación del proyecto
elide project export --format=<json|pom|intellij> imprime en stdout. Predeterminado: json.
| Formato | Salida |
|---|---|
json | El manifiesto evaluado. Los discriminadores de tipo usan @type y los nombres de tipo de Pkl. |
pom | Coordenadas, dependencias por ámbito, repositorios, niveles del compilador, raíces de fuentes y de recursos. |
intellij | Un módulo por conjunto de fuentes, con raíces de contenido, dependencias, nivel de SDK y faceta de Kotlin. |
pom
| Elemento del POM | Valor |
|---|---|
<artifactId> | El nombre del proyecto. |
<groupId> | El nombre de la raíz del espacio de trabajo, o el nombre del proyecto fuera de un espacio de trabajo. |
<version> | La versión del manifiesto, o 0.0.0. |
<modules> | Los miembros de la raíz de un espacio de trabajo. |
<parent> | La raíz del espacio de trabajo de un miembro. |
| Manifiesto | Ámbito de Maven |
|---|---|
packages, modules | compile |
compileOnly, devPackages, processors | provided |
runtimeOnly | runtime |
testPackages | test |
Los proyectos hermanos pasan a ser dependencias por coordenadas, y los JAR locales, dependencias con ámbito system.
exclusions y kotlinPlugins se omiten. Las raíces de fuentes adicionales usan build-helper-maven-plugin.
intellij
Los módulos se llaman <project>.<sourceSet>. Las rutas son relativas a root, la raíz del espacio de trabajo o del
proyecto. Las bibliotecas se resuelven desde localRepository (predeterminado: .dev/dependencies/m2), así que
ejecute antes elide install. El Plugin de IntelliJ IDEA importa este modelo.
Cadena de herramientas de JVM
Elide incluye JDK 25 y Kotlin. Las opciones de Elide van antes de --; los argumentos de la herramienta, después.
java
Ejecuta programas de JVM, como java.
elide java -- -jar app.jarjavac
Compila Java, como javac. Consulte Compilador Java.
| Opción | Efecto |
|---|---|
--jar JAR | Empaqueta un JAR en esta ruta tras compilar. |
--manifest MANIFEST | Manifiesto para la salida de --jar. |
--max-errors N | Muestra como máximo N errores distintos; 0 los muestra todos. |
--report-used-deps PATH | Escribe las entradas del classpath que usa la salida (strict-deps de Bazel). |
--persistent_worker | Se ejecuta como worker persistente de Bazel. |
--classpath-cache | Reutiliza el estado del classpath entre compilaciones del worker. Solo en modo worker. |
--capabilities | Imprime las capacidades del compilador como JSON. |
kotlinc
Compila Kotlin, como kotlinc. Consulte Compilador Kotlin.
| Opción | Efecto |
|---|---|
--incremental | Compila de forma incremental; el estado se guarda en .. |
--incremental-cache-dir DIR | Directorio del estado incremental. |
--plugins LIST | Plugins integrados: metro, serialization, atomicfu, power-assert. |
--metro / --no-metro | Fuerza la activación o desactivación del plugin de DI Metro. |
--tests | Activa los plugins de pruebas (power-assert). |
--abi-only | Emite solo un JAR de ABI (cabeceras) en -d. |
--max-errors N | Muestra como máximo N errores distintos; 0 los muestra todos. |
--report-used-deps PATH | Escribe las entradas del classpath que usa la salida (strict-deps de Bazel). |
--persistent_worker | Se ejecuta como worker persistente de Bazel. |
jar
Crea JAR, como jar. Consulte Ensamblado de JAR.
Configuración y herramientas
Los comandos elide agent son para agentes de programación y otros llamadores no interactivos; consulte
Para agentes de IA.
| Comando | Opciones | Efecto |
|---|---|---|
elide agent help [TOPIC] | -l, --lang LANG | Imprime la guía para agentes, o un tema de la documentación, en Markdown. |
elide agent diagnostics | --json | Imprime la versión, la plataforma, el directorio de informes de fallos y el estado de la terminal. |
elide agent bug | --kind bug|perf|expectation|feature, --json | Imprime una URL de incidencia y el cuerpo del informe; --json imprime un esqueleto elide.report/1. No envía nada. |
elide agent perf -- COMMAND | --runs N (10), --warmup N (3), --baseline COMMAND, --against VERSION, --json | Mide un comando en local, opcionalmente frente a otro entorno de ejecución o a una versión de Elide instalada. |
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 resultsEl comando tras -- es una línea de comandos completa, elide incluido. Campos del informe y opciones en detalle:
Informar de un problema.
init
Crea un proyecto a partir de una plantilla. Sin opciones, abre un editor.
Plantillas: java, ktjvm, web-demo, web-simple, workspace (biblioteca de Kotlin más aplicación).
| Opción | Efecto |
|---|---|
--templates | Lista los ID de plantilla. |
-t, --template TEMPLATE | Selecciona una plantilla. |
--parameters | Lista los parámetros de la plantilla. |
--json | Imprime --templates o --parameters como JSON. |
-i, --plain | Hace preguntas simples en lugar de abrir el editor. |
-d, --skip-defaults | Omite los parámetros con valor predeterminado. Requiere --plain. |
-s, --skip-run | No ejecuta Elide tras generar. |
--overwrite | Reemplaza los archivos existentes. |
adopt
Migra a Elide el proyecto del directorio actual con un agente de programación con IA
(Adoptar un proyecto existente). Sin opciones, pregunta cada elección. Sale con 0 cuando el
agente termina bien, 1 cuando falla o no puede iniciarse y 130 con Ctrl+C.
| Opción | Efecto |
|---|---|
--build STRATEGY | elide (crear una compilación de Elide) o existing (mantener Maven/Gradle). |
--harness HARNESS | codex, claude u omp. |
--approval MODE | auto-approve, manual-approve o yolo (omite las protecciones). |
--log | Muestra la salida del agente en directo además de registrarla. |
--prompt-append FILE | Añade indicaciones al prompt. Repetible. |
--non-interactive | Modo por lotes. Requiere las tres elecciones; no admite manual-approve. |
help
Lea esta documentación sin conexión. Un nombre de comando imprime su sección, un slug o un título imprime la página y
options lista todas las opciones.
| Opción | Efecto |
|---|---|
--format FORMAT | auto (predeterminado), interactive o markdown. |
-w, --width WIDTH | Ancho máximo. Predeterminado: 110. |
-l, --lang LANG | Idioma de visualización. |
--languages | Lista los idiomas de visualización. |
--no-animation | Oculta la animación de nieve; Tab la activa y desactiva. |
info
Muestra detalles del binario, la plataforma, los lenguajes y el transporte de red. --cargo-lockfile imprime el
archivo de bloqueo incrustado.
upgrade
Actualiza Elide.
| Opción | Efecto |
|---|---|
--check | Informa sin aplicar. |
--force | Actualiza aunque ya esté al día. |
--channel CHANNEL | release o nightly. Predeterminado: el canal de esta compilación. |
setup
Instala un componente opcional: elide setup python.
| Opción | Efecto |
|---|---|
--channel CHANNEL | release o nightly. Predeterminado: el canal de esta compilación. |
--force | Vuelve a aplicar un componente instalado. |
setup instala el componente para la versión en ejecución y nunca actualiza ni revierte Elide. elide upgrade
conserva los componentes instalados. setup rechaza las instalaciones hechas con gestores de paquetes (Homebrew,
apt, RPM, MSI, nix, snap); use el script de instalación:
curl -sSL --tlsv1.2 elide.sh | bash -s -- --with-pythonuse
Fija una versión en .elideversion y la descarga: elide use 1.6.0.
| Opción | Efecto |
|---|---|
--channel CHANNEL | release o nightly. |
--no-install | Escribe la versión fijada sin descargarla. |
Las versiones son publicaciones (1.6.0, v1.6.0) o fechas de compilaciones nightly (20260921).
--ignore-version ejecuta este binario de todos modos.
lsp
Inicia un servidor de Language Server Protocol sobre stdio. Sirve Java; consulte Otros editores.
mcp
Inicia un servidor de Model Context Protocol. Consulte Servidor MCP del proyecto.
| Opción | Efecto |
|---|---|
--mode MODE | stdio (predeterminado) o http (HTTP+SSE heredado). |
--host HOST | Host de escucha HTTP. Predeterminado: localhost. |
--port PORT | Puerto de escucha HTTP. Predeterminado: 8125. |
Avanzado
Comandos que lista elide --help-all.
classpath
Imprime un classpath resuelto para [<sourceSet>:]<usage>, p. ej. test:runtime. Usos: toolchain, processor,
compile, modules, runtime, provided. Predeterminado: main:compile; un uso desconocido sale con 2.
| Opción | Efecto |
|---|---|
--offline | No descarga recursos remotos. |
index
Indexa las dependencias de Maven resueltas del proyecto y consulta ese índice. Acciones: build, status
(predeterminada), get <address>, references <address>, used-by <name>, resolve <name>. Una dirección es
maven:group:artifact:version, seguida opcionalmente de /symbol y #member; un miembro es
name(paramType,...) para métodos y constructores (<init>) y el nombre sin más para campos. build escribe las
capas que nombra --layers (predeterminado: l0,l1; l2 añade las firmas de los miembros y l3, las referencias
salientes) junto a las ya construidas. get, references y resolve salen con 1 ante un artefacto, símbolo,
miembro o nombre desconocido, y con 2 cuando no se ha construido una capa que necesitan; ejecute
elide index build --layers=....
build también compila las fuentes principales de Java y Kotlin y actualiza su índice local de referencias.
references local:<project>/<type> lee las referencias salientes de una clase local; used-by <type>[#member]
imprime los archivos fuente locales coincidentes, con rutas relativas al paquete. Las consultas no actualizan esas
referencias compiladas. Consulte Índice de código de dependencias para ver ejemplos y el
alcance experimental.
| Opción | Efecto |
|---|---|
--layers=<l0,l1,l2,l3> | Capas que escribe build; l0 siempre se incluye. |
--offline | No descarga recursos remotos. |
javadoc
Genera Javadoc, como javadoc. Los argumentos van tras --.
| Opción | Efecto |
|---|---|
--theme THEME | default o elide. |
javaformat
Formatea Java con google-java-format, o con el dialecto jfmt de Netflix si se indica --jfmt. Los argumentos van
tras --. Admite --list-files y --list-diffs de format. Consulte Formato.
javap
Desensambla bytecode de JVM, como javap. Los argumentos van tras --.
jdeps
Analiza las dependencias entre clases de JVM, como jdeps. Los argumentos van tras --.
ktfmt
Formatea Kotlin con ktfmt. Los argumentos van tras --. Admite --list-files y --list-diffs de format.
mvn
Ejecuta Maven, como mvn: elide mvn -- package. Consulte Native Maven.
Opción (tras --) | Efecto |
|---|---|
--flavor NAME | Conjunto de plugins, p. ej. spring@4.1.0. Por defecto se detecta a partir de pom.xml. |
--mode=MODE | native (predeterminado), mixed o legacy. |
--yes | Aprueba las descargas sin preguntar. |
--porcelain | Muestra en directo la salida propia de Maven. |
native-image
Compila un programa de JVM en un ejecutable nativo. Los argumentos van tras --. Consulte
Native Image.
rewrite
Ejecuta recetas de OpenRewrite sobre las fuentes Java principales del proyecto (experimental en 1.6.0). Las recetas
proceden de las bibliotecas incluidas y de dependencies.maven.devPackages; los tipos de las dependencias proceden
del índice de código. elide rewrite --list imprime las recetas disponibles; elide rewrite <name>… las aplica en
orden. El flujo de trabajo predeterminado compila las fuentes principales y filtra los archivos candidatos cuando
las precondiciones de la receta lo permiten. Consulte OpenRewrite para la configuración,
ejemplos y los límites de compatibilidad. Sale con 1 ante una receta desconocida y con 2 ante un error de uso.
| Opción | Efecto |
|---|---|
--dry-run | Imprime los diffs sin aplicar cambios en las fuentes; el estado de compilación puede escribirse igualmente. |
--list | Lista las recetas disponibles sin compilar las fuentes principales. |
--no-prefilter | Omite la compilación de las fuentes principales y analiza todas las fuentes Java principales. |
--offline | No descarga recursos remotos. |
web
Herramientas web: elide web build app.ts page.md --out dist compila archivos sin manifiesto. Consulte
Cadena de herramientas web.
| Opción | Efecto |
|---|---|
-o, --out DIR | Directorio de salida. |
Opciones globales
Se aceptan antes o después del nombre del comando, antes de cualquier --.
Opciones comunes
| Opción | Efecto |
|---|---|
-p, --project PATH | Directorio del proyecto. |
-f, --flag NAME[=VALUE] | Define una opción de compilación del manifiesto. |
-q, --quiet | Oculta el progreso. Las advertencias, los errores y la salida del programa se siguen imprimiendo. |
-v, --verbose / --debug | Más registros. |
--color / --no-color | Fuerza el color o lo desactiva. |
--timeout DURATION | Límite de tiempo, p. ej. 30s, 5m; 0 lo desactiva. Termina los procesos hijos y sale con 124. |
--max-mem SIZE | Límite del heap, p. ej. 512m, 8g. Las ejecuciones puntuales usan 4g por defecto. |
--limit NAME=COUNT | Límite de recursos: workers o fds. Repetible. |
--interop | Comparte un único contexto entre lenguajes (Lenguajes e interoperabilidad). |
-V, --version | Imprime la versión. |
Opciones de sandbox
Los programas se ejecutan sin restricciones hasta que pasa una opción de sandbox. Consulte Sandbox y límites.
| Opción | Efecto |
|---|---|
--sandbox[=PROFILE] | Perfil: trusted. --sandbox sin valor restringe el acceso al sistema de archivos. |
--allow-read[=PATHS] | Concede lectura; sin valor, en todas las rutas. |
--allow-write[=PATHS] | Concede escritura; sin valor, en todas las rutas. |
--allow-net[=HOSTS] | Permite la red; sin valor, con todos los hosts. |
--deny-net=HOSTS | Deniega hosts; tiene prioridad sobre --allow-net. |
--allow-run[=CMDS] | Permite subprocesos; sin valor, los permite todos. |
--deny-run=CMDS | Deniega comandos; tiene prioridad sobre --allow-run. |
--allow-env[=NAMES] | Variables que puede leer el manifiesto; sin valor, las permite todas. |
--fs-audit | Registra cada decisión de acceso al sistema de archivos. |
--allow-threads | Permite hilos del código invitado. Denegados por defecto. |
--allow-native / --no-native | Permite o deniega el acceso nativo del código invitado. |
Opciones de diagnóstico
| Opción | Efecto |
|---|---|
--debugger[= | Conecta un depurador: auto, cdp, dap o una dirección JDWP (5005, host:5005). Consulte Depuración. |
--debugger-host HOST | Host de escucha del depurador. Predeterminado: 127.0.0.1. |
--debugger-port PORT | Puerto del depurador. Predeterminado: 4711 (DAP) o 1337 (CDP). |
--profiler[=PROFILER] | cputracing, cpusampling o memtracing. |
--coverage[=auto] | Recoge la cobertura. |
--insights INSIGHTS | Inyecta Scripts de Insight. |
--error-format FORMAT | Errores no capturados: auto (predeterminado), pretty o plain. |
--abort-on-uncaught-exception | Aborta con SIGABRT ante una excepción no capturada. |
--redirect-warnings FILE | Escribe las advertencias en FILE en lugar de stderr. |
Opciones de versión
| Opción | Efecto |
|---|---|
--use-version VERSION | Ejecuta otra versión de Elide instalada. |
--ignore-version | Ignora .elideversion y --use-version. |
Opciones avanzadas
| Opción | Efecto |
|---|---|
--transport TRANSPORT | Transporte de red (Transporte de red). |
--locale LOCALE | Idioma de la CLI, p. ej. fr. |
-X, --vm KEY=VALUE | Define una propiedad de la VM. |
--safe-close | Cierra por completo incluso en ejecuciones puntuales. |
--pkgst / --no-pkgst | Se acepta; no tiene efecto. Para omitir el proxy maven.pkg.st, consulte Repositorios. |
--otel-endpoint=URL | Envía los datos de OpenTelemetry a este endpoint OTLP. |
--otel-provider= | Envía los datos de OpenTelemetry a un proveedor: otlp, sentry, datadog, posthog, honeycomb, grafana. |
--otel-protocol= | Protocolo OTLP: grpc, http/protobuf, http/json. |
--otel-shutdown=MODE | Cómo se envía la exportación final al salir: sidecar, inline, drop. |
--no-otel | Desactiva la exportación de OpenTelemetry. |
--help-instruments | Lista las opciones de instrumentos. |
Opciones de Python
Opciones de CPython; póngalas antes del script.
| Opción | Efecto |
|---|---|
-I | Modo aislado. |
-B | No escribe archivos de bytecode. |
-E | Ignora las variables de entorno PYTHON*. |
-S | No ejecuta import site al iniciar. |
-u | stdout y stderr sin búfer. |
-P | No antepone una ruta insegura a sys.path. |
-O | Optimiza. Repetible. |
-b | Advierte de comparaciones entre bytes y str. Repetible. |
-x | Se acepta; no tiene efecto. |
-W ARG | Control de advertencias. Repetible. |
-m MODULE | Ejecuta un módulo como __main__. |
Transporte de red
--transport= | Efecto |
|---|---|
auto | Predeterminado: v2 en Linux y macOS, nio en el resto. |
v2 | El transporte nativo de Elide. |
epoll, kqueue, io_uring | v2 con ese controlador. Falla en otras plataformas. |
nio | Transporte portable. |
Instrumentos
| Opción | Efecto |
|---|---|
--jfr FILE | Graba un archivo JFR, que se guarda al salir. |
--jfr-settings SETTINGS | default, profile (predeterminado) o un archivo .jfc. |
--jitdump DIR | Escribe metadatos del JIT para perf de Linux. |
--heap-dump FILE | Vuelca el heap al salir. |
--heap-dump-on-oom FILE | Vuelca el heap cuando se agota la memoria y luego sale con 3. |
--vmstat | Hace visible el proceso para jps, jstat y jcmd. |
Códigos de salida
| Código | Significado |
|---|---|
0 | Éxito, ayuda o salida de la versión. |
1 | El comando o el programa falló. |
2 | Uso no válido, destino de ejecución desconocido o un comando eliminado. |
3 | Memoria agotada; --heap-dump-on-oom escribió un volcado del heap. |
124 | Venció --timeout. |
| otro | Lo fija el programa o la herramienta. |
Flujos de salida
- La salida del programa, los informes de pruebas y la salida legible por máquina van a stdout.
- El progreso y los diagnósticos van a stderr.
- El color se desactiva cuando el flujo no es una terminal.
--color,FORCE_COLORoCLICOLOR_FORCElo fuerzan;--no-coloroNO_COLORlo desactivan. --quietsolo oculta el progreso.