elide --help liste les commandes courantes ; elide --help-all ajoute le groupe Avancé et toutes les options.
elide help <command> affiche la section de cette page consacrée à cette commande.
Exécuter et développer
run
Exécute un fichier, un script nommé ou le point d’entrée du projet. Ordre de résolution : Configuration du projet.
elide run app.ts -- --port 3000| Option | Effet |
|---|---|
-s, --snippet CODE | Exécute du code en ligne au lieu d’un fichier. |
-l, --language LANG | Langage de l’extrait : js (par défaut), ts, python, java ou kotlin. |
--contexts=<N|auto> | Contextes d’application à créer à l’avance ; auto les dimensionne d’après les cœurs physiques. Par défaut 1. |
Les extraits Java et Kotlin sont des programmes complets avec un main ; les arguments après -- lui sont transmis :
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 extrait Java sans classe ni main échoue avec Could not find a top-level class/record/enum or a main in the Java snippet. ; un extrait Kotlin sans main échoue avec Could not find a `main` function in the Kotlin snippet; declare `fun main() { ... }`.
Options du débogueur, du profileur et de la couverture : Options de diagnostic.
serve (alias start)
Sert un répertoire sous forme de fichiers statiques, ou un script qui exporte un gestionnaire fetch (Serveur de développement).
elide serve ./public
elide serve server.ts -- --verbose| Option | Effet |
|---|---|
--host HOST | Hôte d’écoute. Par défaut 127.0.0.1. |
--port PORT | Port d’écoute. Par défaut 8080. |
--contexts=<N|auto> | Contextes d’application à créer à l’avance, comme pour run. |
--no-tui | Journaux en texte brut au lieu du tableau de bord. |
-- SCRIPT_ARGS | Arguments du script servi. |
dev
Comme serve, avec les mêmes options, sur le port 3000. Pour un répertoire, les pages HTML se rechargent dans le
navigateur quand les fichiers changent ; un script n’est pas rechargé. --no-watch désactive la surveillance et le
rechargement.
install
Installe les dépendances du projet.
| Option | Effet |
|---|---|
--ecosystems LIST | Écosystèmes à installer, par exemple maven,npm. Par défaut maven. |
--workspace | Installe tous les écosystèmes que déclare le projet. |
--with CLASSIFIER | Télécharge aussi sources, docs ou javadoc. |
--slim | Télécharge uniquement les classes. |
--fresh | Télécharge toutes les dépendances et rafraîchit les artefacts du cache global. |
--direct | Copie les artefacts dans le projet au lieu de les lier. |
repl
Démarre le REPL interactif. Un elide seul dans le terminal fait de même.
python
Exécute Python comme python ; les éléments placés après le script vont au programme. Installez-le d’abord avec
setup.
elide python script.py --flag-for-the-script| Option | Effet |
|---|---|
-c CMD | Exécute un programme passé sous forme de chaîne. |
-s | Exclut le répertoire site de l’utilisateur de sys.path. |
Options de l’interpréteur (-B, -W, -m, …) : Options Python.
Construire et tester
build
Construit ce que déclare elide.pkl. Les arguments positionnels nomment des tâches (deps, compile, test,
clean ; le : initial est facultatif). Les arguments après -- vont au sous-processus.
elide build deps compile| Option | Effet |
|---|---|
-i, --inspect | Liste les tâches du projet. |
--workers=<N> | Exécute au plus N tâches à la fois. |
--no-cache | Désactive le cache de build pour cette exécution. |
--offline | Ne récupère aucune ressource distante. |
-f, --flag NAME[=VALUE] | Définit une option de build du manifeste (Options de build). |
test
Exécute les tests, ou seulement ceux situés sous les chemins indiqués. Les tests JVM proviennent d’un source set de
test : src/test/java ou src/test/kotlin par convention, ou un source set déclaré dans elide.pkl (voir
Source sets).
| Option | Effet |
|---|---|
-t, --test-name-pattern REGEX | Exécute les tests dont le nom correspond. |
--where CEL | JS : exécute les tests pour lesquels une expression CEL portant sur name, parents et file est vraie. |
--select SELECTOR | JVM : exécute ce que nomme un sélecteur : class:, method: ou package:. Répétable. |
--include-tag EXPR | JVM : exécute les tests qui correspondent à l’une des inclusions. Répétable. |
--exclude-tag EXPR | JVM : ignore les tests qui correspondent à l’une des exclusions. Répétable. |
--bail[=N] | S’arrête après N échecs. Par défaut 1. |
--test-timeout MS | Délai d’expiration par test. --timeout limite l’exécution entière. |
--only | Exécute uniquement les tests marqués .only. |
--concurrency N | Tests simultanés (fichiers JS, classes JVM). Par défaut 1. |
--reporter NAME | console, junit ou tap. |
--reporter-outfile DIR | Répertoire de sortie du rapport. |
Déboguer les tests : Débogage.
format (alias fmt)
Formate les sources Java et Kotlin. Les chemins et les options du formateur suivent -- : elide format -- src.
| Option | Effet |
|---|---|
--list-files | Affiche chaque fichier qui échoue à la vérification ou qui est modifié. |
--list-diffs[=N] | Affiche un diff par fichier en mode vérification ; avec N, seulement si N fichiers ou moins échouent. |
--dry-run (après --) vérifie sans écrire ; la commande sort avec 1 si un fichier serait modifié.
project
| Commande | Rôle |
|---|---|
elide project info | Affiche les métadonnées résolues du projet. |
elide project advice | Affiche des conseils sur le projet pour les agents de code. |
elide project export | Affiche le projet en JSON, sous forme de pom.xml ou de modèle IntelliJ. |
publish
elide publish [PROJECT...] [--to <name>] [--skip-existing] [--dry-run] [--sign | --no-sign] [--no-wait]
[--allow-http-repositories] [--offline]Construit les JAR du projet et les installe avec un POM dans le dépôt Maven local (~/.m2/repository, sauf si
publishing.maven.localRepository en indique un autre). Depuis la racine d’un espace de travail, la commande publie
tous les projets. Depuis un membre, elle publie ce membre et tous les projets de l’espace de travail dont dépend son
POM, afin que les coordonnées qu’il cite soient installées elles aussi. Chaque projet est construit, préparé et signé
avant toute publication : un échec à ce stade ne publie donc rien ; un envoi qui échoue peut en revanche laisser en
place les projets envoyés avant lui. La configuration se fait dans le bloc
publishing du manifeste.
Nommer des projets de l’espace de travail publie exactement ceux-là, par exemple uniquement ceux qui ont changé depuis
la dernière version : elide publish core util --to central. Un projet de l’espace de travail dont ils dépendent mais
qui n’est pas nommé doit déjà se trouver dans la cible, à la version que déclare son manifeste, sinon rien n’est
publié. Les projets que vous laissez de côté conservent leur configuration publishing, si bien qu’une exécution
ultérieure peut les publier à nouveau.
| Option | Effet |
|---|---|
--to <name> | Publie vers le dépôt de ce nom dans publishing. au lieu du dépôt local. |
--skip-existing | Laisse de côté tout projet dont la version se trouve déjà dans la cible, et indique lesquels. Une version snapshot est toujours publiée. Utile pour relancer une publication qui a échoué à mi-parcours. |
--dry-run | Prépare (et signe) le POM et les JAR sous . et les liste, sans publier. Avec Maven Central, écrit et liste aussi le bundle, sans jeton Portal, mais signe quand même : il faut donc une clé de signature utilisable. Avec des projets nommés ou --skip-existing, les versions sont toujours recherchées dans la cible, de sorte que la liste montre ce qu’une vraie exécution publierait ; pour Central, cela exige le jeton. |
--sign, --no-sign | Signe les fichiers avec gpg, ou non. Les publications distantes signent par défaut lorsque signing est défini. |
--no-wait | Pour Maven Central, rend la main dès que le déploiement est envoyé au lieu d’attendre la validation. |
--allow-http-repositories | Autorise un dépôt http:// non chiffré autre que localhost. |
--offline | Construit sans récupérer de ressources distantes. |
Une version se trouve dans la cible lorsque son POM est dans le dépôt local, lorsque le dépôt distant sert son POM ou lorsque le Central Portal la déclare publiée. Un déploiement Central validé mais pas encore publié ne compte pas. Une recherche qui échoue pour une autre raison, par exemple des identifiants refusés, arrête l’exécution au lieu d’être comptée comme absente.
Formats d’export du projet
elide project export --format=<json|pom|intellij> écrit sur stdout. Par défaut json.
| Format | Sortie |
|---|---|
json | Le manifeste évalué. Les discriminants de type utilisent @type et les noms de types Pkl. |
pom | Coordonnées, dépendances par portée, dépôts, niveaux du compilateur, racines des sources et des ressources. |
intellij | Un module par source set, avec racines de contenu, dépendances, niveau du SDK et facette Kotlin. |
pom
| Élément du POM | Valeur |
|---|---|
<artifactId> | Le nom du projet. |
<groupId> | Le nom de la racine de l’espace de travail, ou le nom du projet hors d’un espace de travail. |
<version> | La version du manifeste, ou 0.0.0. |
<modules> | Les membres d’une racine d’espace de travail. |
<parent> | La racine de l’espace de travail d’un membre. |
| Manifeste | Portée Maven |
|---|---|
packages, modules | compile |
compileOnly, devPackages, processors | provided |
runtimeOnly | runtime |
testPackages | test |
Les projets voisins deviennent des dépendances par coordonnées, et les JAR locaux des dépendances de portée system.
exclusions et kotlinPlugins sont omis. Les racines de sources supplémentaires utilisent
build-helper-maven-plugin.
intellij
Les modules s’appellent <project>.<sourceSet>. Les chemins sont relatifs à root, la racine de l’espace de travail
ou du projet. Les bibliothèques sont résolues depuis localRepository (par défaut .dev/dependencies/m2) : lancez
donc d’abord elide install. Le Plugin IntelliJ IDEA importe ce modèle.
Chaîne d’outils JVM
Elide embarque le JDK 25 et Kotlin. Les options d’Elide se placent avant --, les arguments de l’outil après.
java
Exécute des programmes JVM, comme java.
elide java -- -jar app.jarjavac
Compile du Java, comme javac. Voir Compilateur Java.
| Option | Effet |
|---|---|
--jar JAR | Empaquette un JAR à ce chemin après la compilation. |
--manifest MANIFEST | Manifeste de la sortie --jar. |
--max-errors N | Affiche au plus N erreurs distinctes ; 0 les affiche toutes. |
--report-used-deps PATH | Écrit les entrées du classpath utilisées par la sortie (strict-deps de Bazel). |
--persistent_worker | S’exécute comme worker persistant Bazel. |
--classpath-cache | Réutilise l’état du classpath d’une compilation du worker à l’autre. Worker uniquement. |
--capabilities | Affiche les capacités du compilateur en JSON. |
kotlinc
Compile du Kotlin, comme kotlinc. Voir Compilateur Kotlin.
| Option | Effet |
|---|---|
--incremental | Compile de façon incrémentale ; l’état est placé dans .. |
--incremental-cache-dir DIR | Répertoire de l’état incrémental. |
--plugins LIST | Plugins intégrés : metro, serialization, atomicfu, power-assert. |
--metro / --no-metro | Force l’activation ou la désactivation du plugin d’injection de dépendances Metro. |
--tests | Active les plugins de test (power-assert). |
--abi-only | Produit uniquement un JAR d’ABI (en-têtes) dans -d. |
--max-errors N | Affiche au plus N erreurs distinctes ; 0 les affiche toutes. |
--report-used-deps PATH | Écrit les entrées du classpath utilisées par la sortie (strict-deps de Bazel). |
--persistent_worker | S’exécute comme worker persistant Bazel. |
jar
Construit des JAR, comme jar. Voir Assemblage JAR.
Configuration et outils
Les commandes elide agent s’adressent aux agents de code et aux autres appelants non interactifs ; voir
Pour les agents IA.
| Commande | Options | Effet |
|---|---|---|
elide agent help [TOPIC] | -l, --lang LANG | Affiche le guide pour agents, ou un sujet de la documentation, en Markdown. |
elide agent diagnostics | --json | Affiche la version, la plateforme, le répertoire des rapports de plantage et l’état du terminal. |
elide agent bug | --kind bug|perf|expectation|feature, --json | Affiche une URL de ticket et le corps du rapport ; --json affiche un squelette elide.report/1. N’envoie rien. |
elide agent perf -- COMMAND | --runs N (10), --warmup N (3), --baseline COMMAND, --against VERSION, --json | Chronomètre une commande en local, éventuellement face à un autre environnement d’exécution ou à une version installée d’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 resultsLa commande après -- est une ligne de commande complète, elide compris. Champs du rapport et options en détail :
Signaler un problème.
init
Crée un projet à partir d’un modèle. Sans option, ouvre un éditeur.
Modèles : java, ktjvm, web-demo, web-simple, workspace (bibliothèque Kotlin et application).
| Option | Effet |
|---|---|
--templates | Liste les identifiants de modèle. |
-t, --template TEMPLATE | Sélectionne un modèle. |
--parameters | Liste les paramètres du modèle. |
--json | Affiche --templates ou --parameters en JSON. |
-i, --plain | Pose des questions simples au lieu d’ouvrir l’éditeur. |
-d, --skip-defaults | Ignore les paramètres qui ont une valeur par défaut. Nécessite --plain. |
-s, --skip-run | N’exécute pas Elide après la génération. |
--overwrite | Remplace les fichiers existants. |
adopt
Migre vers Elide le projet du répertoire courant à l’aide d’un agent de code IA
(Adopter un projet existant). Sans option, la commande demande chaque choix. Elle sort avec 0
quand l’agent réussit, 1 quand il échoue ou ne peut pas démarrer, et 130 sur Ctrl+C.
| Option | Effet |
|---|---|
--build STRATEGY | elide (créer un build Elide) ou existing (conserver Maven/Gradle). |
--harness HARNESS | codex, claude ou omp. |
--approval MODE | auto-approve, manual-approve ou yolo (contourne les protections). |
--log | Diffuse la sortie de l’agent en plus de la journaliser. |
--prompt-append FILE | Ajoute des consignes au prompt. Répétable. |
--non-interactive | Mode batch. Exige les trois choix ; pas manual-approve. |
help
Lisez cette documentation hors ligne. Un nom de commande affiche sa section, un slug ou un titre affiche la page, et
options liste toutes les options.
| Option | Effet |
|---|---|
--format FORMAT | auto (par défaut), interactive ou markdown. |
-w, --width WIDTH | Largeur maximale. Par défaut 110. |
-l, --lang LANG | Langue d’affichage. |
--languages | Liste les langues d’affichage. |
--no-animation | Masque l’animation de neige ; Tab l’active ou la désactive. |
info
Affiche des détails sur le binaire, la plateforme, les langages et le transport réseau. --cargo-lockfile affiche le
fichier de verrouillage intégré.
upgrade
Met à jour Elide.
| Option | Effet |
|---|---|
--check | Indique l’état sans appliquer la mise à jour. |
--force | Met à jour même si la version est à jour. |
--channel CHANNEL | release ou nightly. Par défaut, le canal de ce build. |
setup
Installe un composant facultatif : elide setup python.
| Option | Effet |
|---|---|
--channel CHANNEL | release ou nightly. Par défaut, le canal de ce build. |
--force | Réapplique un composant installé. |
setup installe le composant pour la version en cours d’exécution et ne met jamais Elide à niveau ni ne le
rétrograde. elide upgrade conserve les composants installés. setup refuse les installations par gestionnaire de
paquets (Homebrew, apt, RPM, MSI, nix, snap) ; utilisez le script d’installation :
curl -sSL --tlsv1.2 elide.sh | bash -s -- --with-pythonuse
Épingle une version dans .elideversion et la télécharge : elide use 1.6.0.
| Option | Effet |
|---|---|
--channel CHANNEL | release ou nightly. |
--no-install | Écrit la version épinglée sans la télécharger. |
Les versions sont des publications (1.6.0, v1.6.0) ou des dates de builds nightly (20260921).
--ignore-version exécute quand même ce binaire.
lsp
Démarre un serveur Language Server Protocol sur stdio. Prend en charge Java ; voir Autres éditeurs.
mcp
Démarre un serveur Model Context Protocol. Voir Serveur MCP du projet.
| Option | Effet |
|---|---|
--mode MODE | stdio (par défaut) ou http (HTTP+SSE historique). |
--host HOST | Hôte d’écoute HTTP. Par défaut localhost. |
--port PORT | Port d’écoute HTTP. Par défaut 8125. |
Avancé
Commandes listées par elide --help-all.
classpath
Affiche un classpath résolu pour [<sourceSet>:]<usage>, par exemple test:runtime. Usages : toolchain,
processor, compile, modules, runtime, provided. Par défaut main:compile ; un usage inconnu sort avec 2.
| Option | Effet |
|---|---|
--offline | Ne récupère aucune ressource distante. |
index
Indexe les dépendances Maven résolues du projet et interroge cet index. Actions : build, status (par défaut),
get <address>, references <address>, used-by <name>, resolve <name>. Une adresse s’écrit
maven:group:artifact:version, éventuellement suivie de /symbol et #member ; un membre s’écrit
name(paramType,...) pour les méthodes et les constructeurs (<init>), et par son seul nom pour les champs. build
écrit les couches nommées par --layers (par défaut l0,l1 ; l2 ajoute les signatures des membres, l3 les
références sortantes) à côté de celles déjà construites. get, references et resolve sortent avec 1 pour un
artefact, un symbole, un membre ou un nom inconnu, et avec 2 lorsqu’une couche nécessaire n’a pas été construite ;
lancez alors elide index build --layers=....
build compile aussi les sources Java et Kotlin principales et rafraîchit leur index local de références.
references local:<project>/<type> lit les références sortantes d’une classe locale ; used-by <type>[#member]
affiche les fichiers sources locaux correspondants, avec des chemins relatifs au paquet. Les requêtes ne rafraîchissent
pas ces références compilées. Voir Index du code des dépendances pour des exemples et la
portée expérimentale.
| Option | Effet |
|---|---|
--layers=<l0,l1,l2,l3> | Couches qu’écrit build ; l0 est toujours incluse. |
--offline | Ne récupère aucune ressource distante. |
javadoc
Génère la Javadoc, comme javadoc. Les arguments suivent --.
| Option | Effet |
|---|---|
--theme THEME | default ou elide. |
javaformat
Formate du Java avec google-java-format, ou avec le dialecte jfmt de Netflix si --jfmt est fourni. Les arguments
suivent --. Accepte les options --list-files et --list-diffs de format. Voir
Formatage.
javap
Désassemble du bytecode JVM, comme javap. Les arguments suivent --.
jdeps
Analyse les dépendances entre classes JVM, comme jdeps. Les arguments suivent --.
ktfmt
Formate du Kotlin avec ktfmt. Les arguments suivent --. Accepte les options --list-files et --list-diffs de
format.
mvn
Exécute Maven, comme mvn : elide mvn -- package. Voir Native Maven.
Option (après --) | Effet |
|---|---|
--flavor NAME | Ensemble de plugins, par exemple spring@4.1.0. Détecté par défaut à partir de pom.xml. |
--mode=MODE | native (par défaut), mixed ou legacy. |
--yes | Approuve les téléchargements sans demander. |
--porcelain | Diffuse la sortie propre de Maven. |
native-image
Construit un programme JVM sous forme d’exécutable natif. Les arguments suivent --. Voir
Native Image.
rewrite
Exécute des recettes OpenRewrite sur les sources Java principales du projet (expérimental dans 1.6.0). Les recettes
proviennent des bibliothèques fournies et de dependencies.maven.devPackages ; les types des dépendances proviennent
de l’index du code. elide rewrite --list affiche les recettes disponibles ; elide rewrite <name>… les applique dans
l’ordre. Le workflow par défaut compile les sources principales et filtre les fichiers candidats lorsque les
préconditions des recettes le permettent. Voir OpenRewrite pour la configuration, des
exemples et les limites de compatibilité. Sortie 1 pour une recette inconnue, 2 pour une erreur d’utilisation.
| Option | Effet |
|---|---|
--dry-run | Affiche les diffs sans appliquer de modifications aux sources ; l’état du build peut tout de même être écrit. |
--list | Liste les recettes disponibles sans compiler les sources principales. |
--no-prefilter | Ignore la compilation des sources principales et analyse toutes les sources Java principales. |
--offline | Ne récupère aucune ressource distante. |
web
Outils web : elide web build app.ts page.md --out dist construit des fichiers sans manifeste. Voir
Chaîne d’outils Web.
| Option | Effet |
|---|---|
-o, --out DIR | Répertoire de sortie. |
Options globales
Acceptées avant ou après le nom de la commande, avant tout --.
Options courantes
| Option | Effet |
|---|---|
-p, --project PATH | Répertoire du projet. |
-f, --flag NAME[=VALUE] | Définit une option de build du manifeste. |
-q, --quiet | Masque la progression. Les avertissements, les erreurs et la sortie du programme s’affichent toujours. |
-v, --verbose / --debug | Plus de journaux. |
--color / --no-color | Force l’activation ou la désactivation des couleurs. |
--timeout DURATION | Limite de temps, par exemple 30s, 5m ; 0 la désactive. Tue les processus enfants et sort avec 124. |
--max-mem SIZE | Limite du tas, par exemple 512m, 8g. Les exécutions ponctuelles utilisent 4g par défaut. |
--limit NAME=COUNT | Limite de ressources : workers ou fds. Répétable. |
--interop | Partage un seul contexte entre les langages (Langages et interopérabilité). |
-V, --version | Affiche la version. |
Options de bac à sable
Les programmes s’exécutent sans restriction tant que vous ne passez pas d’option de bac à sable. Voir Bac à sable et limites.
| Option | Effet |
|---|---|
--sandbox[=PROFILE] | Profil : trusted. --sandbox seul restreint l’accès au système de fichiers. |
--allow-read[=PATHS] | Autorise la lecture ; sans valeur, partout. |
--allow-write[=PATHS] | Autorise l’écriture ; sans valeur, partout. |
--allow-net[=HOSTS] | Autorise le réseau ; sans valeur, vers tous les hôtes. |
--deny-net=HOSTS | Refuse des hôtes ; prévaut sur --allow-net. |
--allow-run[=CMDS] | Autorise les sous-processus ; sans valeur, tous. |
--deny-run=CMDS | Refuse des commandes ; prévaut sur --allow-run. |
--allow-env[=NAMES] | Variables que le manifeste peut lire ; sans valeur, toutes. |
--fs-audit | Journalise chaque décision d’accès au système de fichiers. |
--allow-threads | Autorise les threads du code invité. Refusés par défaut. |
--allow-native / --no-native | Autorise ou refuse l’accès natif du code invité. |
Options de diagnostic
| Option | Effet |
|---|---|
--debugger[= | Attache un débogueur : auto, cdp, dap ou une adresse JDWP (5005, host:5005). Voir Débogage. |
--debugger-host HOST | Hôte d’écoute du débogueur. Par défaut 127.0.0.1. |
--debugger-port PORT | Port du débogueur. Par défaut 4711 (DAP) ou 1337 (CDP). |
--profiler[=PROFILER] | cputracing, cpusampling ou memtracing. |
--coverage[=auto] | Collecte la couverture. |
--insights INSIGHTS | Injecte des Scripts Insight. |
--error-format FORMAT | Erreurs non interceptées : auto (par défaut), pretty ou plain. |
--abort-on-uncaught-exception | S’interrompt avec SIGABRT sur une exception non interceptée. |
--redirect-warnings FILE | Écrit les avertissements dans FILE au lieu de stderr. |
Options de version
| Option | Effet |
|---|---|
--use-version VERSION | Exécute une autre version installée d’Elide. |
--ignore-version | Ignore .elideversion et --use-version. |
Options avancées
| Option | Effet |
|---|---|
--transport TRANSPORT | Transport réseau (Transport réseau). |
--locale LOCALE | Langue de la CLI, par exemple fr. |
-X, --vm KEY=VALUE | Définit une propriété de la VM. |
--safe-close | S’arrête complètement, même pour les exécutions ponctuelles. |
--pkgst / --no-pkgst | Accepté ; sans effet. Pour contourner le proxy maven.pkg.st, voir Dépôts. |
--otel-endpoint=URL | Envoie les données OpenTelemetry à ce point de terminaison OTLP. |
--otel-provider= | Envoie les données OpenTelemetry à un fournisseur : otlp, sentry, datadog, posthog, honeycomb, grafana. |
--otel-protocol= | Protocole OTLP : grpc, http/protobuf, http/json. |
--otel-shutdown=MODE | Mode d’envoi du dernier export à la sortie : sidecar, inline, drop. |
--no-otel | Désactive l’export OpenTelemetry. |
--help-instruments | Liste les options d’instruments. |
Options Python
Options de CPython ; placez-les avant le script.
| Option | Effet |
|---|---|
-I | Mode isolé. |
-B | N’écrit pas de fichiers de bytecode. |
-E | Ignore les variables d’environnement PYTHON*. |
-S | N’exécute pas import site au démarrage. |
-u | stdout et stderr sans tampon. |
-P | N’ajoute pas de chemin non sûr en tête de sys.path. |
-O | Optimise. Répétable. |
-b | Avertit lors des comparaisons entre bytes et str. Répétable. |
-x | Accepté ; sans effet. |
-W ARG | Contrôle des avertissements. Répétable. |
-m MODULE | Exécute un module en tant que __main__. |
Transport réseau
--transport= | Effet |
|---|---|
auto | Par défaut : v2 sous Linux et macOS, nio ailleurs. |
v2 | Le transport natif d’Elide. |
epoll, kqueue, io_uring | v2 avec ce pilote. Échoue sur les autres plateformes. |
nio | Transport portable. |
Instruments
| Option | Effet |
|---|---|
--jfr FILE | Enregistre un fichier JFR, sauvegardé à la sortie. |
--jfr-settings SETTINGS | default, profile (par défaut) ou un fichier .jfc. |
--jitdump DIR | Écrit les métadonnées JIT pour perf sous Linux. |
--heap-dump FILE | Produit un vidage du tas à la sortie. |
--heap-dump-on-oom FILE | Produit un vidage du tas en cas de mémoire insuffisante, puis sort avec 3. |
--vmstat | Rend le processus visible pour jps, jstat et jcmd. |
Codes de sortie
| Code | Signification |
|---|---|
0 | Succès, aide ou affichage de la version. |
1 | La commande ou le programme a échoué. |
2 | Utilisation invalide, cible d’exécution inconnue ou commande supprimée. |
3 | Mémoire insuffisante ; --heap-dump-on-oom a écrit un vidage du tas. |
124 | --timeout a expiré. |
| autre | Défini par le programme ou l’outil. |
Flux de sortie
- La sortie du programme, les rapports de test et la sortie lisible par machine vont sur stdout.
- La progression et les diagnostics vont sur stderr.
- Les couleurs sont désactivées lorsque le flux n’est pas un terminal.
--color,FORCE_COLORouCLICOLOR_FORCEles forcent ;--no-colorouNO_COLORles désactivent. --quietmasque uniquement la progression.