Zum Inhalt springen

CLI-Referenz

Alle Befehle und Flags von Elide: run, build, test, install, die JVM-Werkzeuge, Einrichtungsbefehle, globale Optionen, Instrumente, Exit-Codes und Ausgabeströme.

Auf dieser Seite

elide --help listet die alltäglichen Befehle auf; elide --help-all ergänzt die Gruppe „Erweitert“ und alle Flags. elide help <command> gibt den Abschnitt dieser Seite zu diesem Befehl aus.

Ausführen und entwickeln

run

Führt eine Datei, ein benanntes Skript oder den Einstiegspunkt des Projekts aus. Auflösungsreihenfolge: Projekteinrichtung.

elide run app.ts -- --port 3000
FlagWirkung
-s, --snippet CODEFührt Inline-Code statt einer Datei aus.
-l, --language LANGSprache des Snippets: js (Standard), ts, python, java oder kotlin.
--contexts=<N|auto>Anzahl der vorab gestarteten Anwendungskontexte; auto richtet sich nach den physischen Kernen. Standard: 1.

Java- und Kotlin-Snippets sind vollständige Programme mit einem main; Argumente nach -- werden daran übergeben:

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 b
hello from java 42
a, b

Ein Java-Snippet ohne Klasse oder main schlägt fehl mit Could not find a top-level class/record/enum or a main in the Java snippet.; ein Kotlin-Snippet ohne main schlägt fehl mit Could not find a `main` function in the Kotlin snippet; declare `fun main() { ... }`.

Flags für Debugger, Profiler und Abdeckung: Diagnose-Flags.

serve (Alias start)

Stellt ein Verzeichnis als statische Dateien bereit oder ein Skript, das einen Fetch-Handler exportiert (Entwicklungsserver).

elide serve ./public
elide serve server.ts -- --verbose
FlagWirkung
--host HOSTHost, an den gebunden wird. Standard: 127.0.0.1.
--port PORTPort, an den gebunden wird. Standard: 8080.
--contexts=<N|auto>Anzahl der vorab gestarteten Anwendungskontexte, wie bei run.
--no-tuiEinfache Logausgabe statt des Dashboards.
-- SCRIPT_ARGSArgumente für das bereitgestellte Skript.

dev

Wie serve, mit denselben Flags, auf Port 3000. Bei einem Verzeichnis laden HTML-Seiten im Browser neu, wenn sich Dateien ändern; ein Skript wird nicht neu geladen. --no-watch schaltet Überwachung und Neuladen ab.

install

Installiert die Abhängigkeiten des Projekts.

FlagWirkung
--ecosystems LISTZu installierende Ökosysteme, z. B. maven,npm. Standard: maven.
--workspaceInstalliert jedes Ökosystem, das das Projekt deklariert.
--with CLASSIFIERLädt zusätzlich sources, docs oder javadoc herunter.
--slimLädt nur Klassen herunter.
--freshLädt alle Abhängigkeiten herunter und aktualisiert die Artefakte im globalen Cache.
--directKopiert Artefakte ins Projekt, statt sie zu verlinken.

repl

Startet die interaktive REPL. Ein bloßes elide im Terminal bewirkt dasselbe.

python

Führt Python wie python aus; Tokens nach dem Skript gehen an das Programm. Installieren Sie es zuerst mit setup.

elide python script.py --flag-for-the-script
FlagWirkung
-c CMDFührt ein als Zeichenkette übergebenes Programm aus.
-sLässt das Site-Verzeichnis des Benutzers aus sys.path heraus.

Interpreter-Flags (-B, -W, -m, …): Python-Optionen.

Bauen und testen

build

Baut, was elide.pkl deklariert. Freie Tokens benennen Tasks (deps, compile, test, clean; ein führendes : ist optional). Argumente nach -- gehen an den Unterprozess.

elide build deps compile
FlagWirkung
-i, --inspectListet die Tasks des Projekts auf.
--workers=<N>Führt höchstens N Tasks gleichzeitig aus.
--no-cacheDeaktiviert den Build-Cache für diesen Lauf.
--offlineRuft keine entfernten Ressourcen ab.
-f, --flag NAME[=VALUE]Setzt ein Build-Flag des Manifests (Build-Flags).

test

Führt die Tests aus, oder nur die unter den angegebenen Pfaden. JVM-Tests stammen aus einem Test-Source-Set: per Konvention src/test/java oder src/test/kotlin, oder eines, das in elide.pkl deklariert ist (siehe Source-Sets).

FlagWirkung
-t, --test-name-pattern REGEXFührt Tests aus, deren Name passt.
--where CELJS: Führt Tests aus, für die ein CEL-Ausdruck über name, parents und file wahr ist.
--select SELECTORJVM: Führt aus, was ein Selektor benennt: class:, method: oder package:. Wiederholbar.
--include-tag EXPRJVM: Führt Tests aus, die zu einem Include passen. Wiederholbar.
--exclude-tag EXPRJVM: Überspringt Tests, die zu einem Exclude passen. Wiederholbar.
--bail[=N]Bricht nach N Fehlschlägen ab. Standard: 1.
--test-timeout MSTimeout pro Test. --timeout begrenzt den gesamten Lauf.
--onlyFührt nur mit .only markierte Tests aus.
--concurrency NGleichzeitige Tests (JS-Dateien, JVM-Klassen). Standard: 1.
--reporter NAMEconsole, junit oder tap.
--reporter-outfile DIRAusgabeverzeichnis des Reporters.

Tests debuggen: Debugging.

format (Alias fmt)

Formatiert Java- und Kotlin-Quellen. Pfade und Formatierer-Flags folgen nach --: elide format -- src.

FlagWirkung
--list-filesGibt jede Datei aus, die die Prüfung nicht besteht oder geändert wird.
--list-diffs[=N]Gibt im Prüfmodus einen Diff pro Datei aus; mit N nur, wenn N oder weniger fehlschlagen.

--dry-run (nach --) prüft, ohne zu schreiben; der Exit-Code ist 1, wenn sich eine Datei ändern würde.

project

BefehlZweck
elide project infoZeigt die aufgelösten Projektmetadaten.
elide project adviceZeigt Projekthinweise für Coding-Agenten.
elide project exportGibt das Projekt als JSON, als pom.xml oder als IntelliJ-Modell aus.

publish

elide publish [PROJECT...] [--to <name>] [--skip-existing] [--dry-run] [--sign | --no-sign] [--no-wait]
              [--allow-http-repositories] [--offline]

Baut die JARs des Projekts und installiert sie mit einem POM im lokalen Maven-Repository (~/.m2/repository, sofern publishing.maven.localRepository nichts anderes angibt). Von der Wurzel eines Workspace aus veröffentlicht es jedes Projekt. Von einem Mitglied aus veröffentlicht es dieses Mitglied und jedes Workspace-Projekt, von dem sein POM abhängt, sodass auch die darin genannten Koordinaten installiert werden. Jedes Projekt wird gebaut, bereitgestellt und signiert, bevor eines veröffentlicht wird; ein Fehler in dieser Phase veröffentlicht also nichts. Bei einem fehlgeschlagenen Upload bleiben die zuvor hochgeladenen Projekte jedoch bestehen. Konfiguriert wird es im Block publishing des Manifests.

Werden Workspace-Projekte benannt, werden genau diese veröffentlicht, zum Beispiel nur die seit dem letzten Release geänderten: elide publish core util --to central. Ein Workspace-Projekt, von dem sie abhängen, das aber nicht benannt ist, muss bereits im Ziel liegen, in der Version, die sein Manifest deklariert, sonst wird nichts veröffentlicht. Ausgelassene Projekte behalten ihre publishing-Konfiguration, sodass ein späterer Lauf sie wieder veröffentlichen kann.

FlagWirkung
--to <name>Veröffentlicht in das Repository dieses Namens aus publishing.maven.repositories statt in das lokale.
--skip-existingLässt jedes Projekt aus, dessen Version bereits im Ziel liegt, und nennt diese. Eine Snapshot-Version wird immer veröffentlicht. Nützlich, um ein Release zu wiederholen, das auf halbem Weg fehlgeschlagen ist.
--dry-runStellt POM und JARs unter .dev/staging/publish/maven bereit (und signiert sie) und listet sie auf, ohne zu veröffentlichen. Bei Maven Central wird zusätzlich das Bundle geschrieben und aufgelistet; dafür ist kein Portal-Token nötig, signiert wird aber trotzdem, also ist ein nutzbarer Signaturschlüssel erforderlich. Mit benannten Projekten oder --skip-existing werden die Versionen weiterhin im Ziel nachgeschlagen, sodass die Liste zeigt, was ein echter Lauf veröffentlichen würde; für Central braucht das den Token.
--sign, --no-signSigniert die Dateien mit gpg oder nicht. Entfernte Veröffentlichungen signieren standardmäßig, wenn signing gesetzt ist.
--no-waitKehrt bei Maven Central zurück, sobald das Deployment hochgeladen ist, statt auf die Validierung zu warten.
--allow-http-repositoriesErlaubt ein unverschlüsseltes http://-Repository außer localhost.
--offlineBaut, ohne entfernte Ressourcen abzurufen.

Eine Version liegt im Ziel, wenn ihr POM im lokalen Repository liegt, wenn das entfernte Repository ihr POM ausliefert oder wenn das Central Portal sie als veröffentlicht meldet. Ein validiertes, aber noch nicht freigegebenes Central-Deployment zählt nicht. Eine Abfrage, die aus einem anderen Grund fehlschlägt, etwa wegen abgelehnter Zugangsdaten, beendet den Lauf, statt als fehlend zu gelten.

Exportformate für Projekte

elide project export --format=<json|pom|intellij> schreibt nach stdout. Standard: json.

FormatAusgabe
jsonDas ausgewertete Manifest. Typdiskriminatoren verwenden @type und Pkl-Typnamen.
pomKoordinaten, Abhängigkeiten nach Scope, Repositorys, Compiler-Level, Quell- und Ressourcenwurzeln.
intellijEin Modul pro Source-Set, mit Content-Roots, Abhängigkeiten, SDK-Level und Kotlin-Facet.

pom

POM-ElementWert
<artifactId>Der Projektname.
<groupId>Der Name der Workspace-Wurzel, außerhalb eines Workspace der Projektname.
<version>Die Version aus dem Manifest, sonst 0.0.0.
<modules>Die Mitglieder einer Workspace-Wurzel.
<parent>Die Workspace-Wurzel eines Mitglieds.
ManifestMaven-Scope
packages, modulescompile
compileOnly, devPackages, processorsprovided
runtimeOnlyruntime
testPackagestest

Geschwisterprojekte werden zu Abhängigkeiten über Koordinaten, lokale JARs zu Abhängigkeiten mit Scope system. exclusions und kotlinPlugins werden weggelassen. Zusätzliche Quellwurzeln verwenden build-helper-maven-plugin.

intellij

Module heißen <project>.<sourceSet>. Pfade sind relativ zu root, der Workspace- oder Projektwurzel. Bibliotheken werden aus localRepository aufgelöst (Standard: .dev/dependencies/m2); führen Sie daher zuerst elide install aus. Das IntelliJ-IDEA-Plugin importiert dieses Modell.

JVM-Werkzeugkette

Elide bringt JDK 25 und Kotlin mit. Die Flags von Elide stehen vor --, die Argumente des Werkzeugs danach.

java

Führt JVM-Programme aus, wie java.

elide java -- -jar app.jar

javac

Kompiliert Java, wie javac. Siehe Java-Compiler.

FlagWirkung
--jar JARPackt nach dem Kompilieren ein JAR unter diesem Pfad.
--manifest MANIFESTManifest für die --jar-Ausgabe.
--max-errors NZeigt höchstens N verschiedene Fehler; 0 zeigt alle.
--report-used-deps PATHSchreibt die Classpath-Einträge, die die Ausgabe nutzt (Bazel strict-deps).
--persistent_workerLäuft als persistenter Bazel-Worker.
--classpath-cacheVerwendet den Classpath-Zustand über Worker-Kompilierungen hinweg wieder. Nur im Worker.
--capabilitiesGibt die Fähigkeiten des Compilers als JSON aus.

kotlinc

Kompiliert Kotlin, wie kotlinc. Siehe Kotlin-Compiler.

FlagWirkung
--incrementalKompiliert inkrementell; der Zustand liegt in .dev/artifacts/kotlinc/incremental/.
--incremental-cache-dir DIRVerzeichnis für den inkrementellen Zustand.
--plugins LISTEingebaute Plugins: metro, serialization, atomicfu, power-assert.
--metro / --no-metroSchaltet das Metro-DI-Plugin erzwungen ein oder aus.
--testsAktiviert Test-Plugins (power-assert).
--abi-onlyErzeugt nur ein ABI-JAR (Header) in -d.
--max-errors NZeigt höchstens N verschiedene Fehler; 0 zeigt alle.
--report-used-deps PATHSchreibt die Classpath-Einträge, die die Ausgabe nutzt (Bazel strict-deps).
--persistent_workerLäuft als persistenter Bazel-Worker.

jar

Baut JARs, wie jar. Siehe JAR-Erstellung.

Einrichtung und Werkzeuge

Die Befehle elide agent sind für Coding-Agenten und andere nicht interaktive Aufrufer gedacht; siehe Für KI-Agenten.

BefehlFlagsWirkung
elide agent help [TOPIC]-l, --lang LANGGibt den Agenten-Leitfaden oder ein Dokumentationsthema als Markdown aus.
elide agent diagnostics--jsonGibt Version, Plattform, Verzeichnis für Absturzberichte und Terminalzustand aus.
elide agent bug--kind bug|perf|expectation|feature, --jsonGibt eine Issue-URL und den Berichtstext aus; --json gibt ein elide.report/1-Gerüst aus. Sendet nichts.
elide agent perf -- COMMAND--runs N (10), --warmup N (3), --baseline COMMAND, --against VERSION, --jsonMisst die Laufzeit eines Befehls lokal, optional im Vergleich mit einer anderen Laufzeit oder einer installierten Elide-Version.
elide agent perf --runs 5 --warmup 1 -- elide run hi.mjs
elide 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

Der Befehl nach -- ist eine vollständige Befehlszeile, einschließlich elide. Berichtsfelder und Flags im Detail: Problem melden.

init

Erstellt ein Projekt aus einer Vorlage. Ohne Flags öffnet sich ein Editor.

Vorlagen: java, ktjvm, web-demo, web-simple, workspace (Kotlin-Bibliothek plus App).

FlagWirkung
--templatesListet die Vorlagen-IDs auf.
-t, --template TEMPLATEWählt eine Vorlage aus.
--parametersListet die Parameter der Vorlage auf.
--jsonGibt --templates oder --parameters als JSON aus.
-i, --plainStellt einfache Fragen, statt den Editor zu öffnen.
-d, --skip-defaultsÜberspringt Parameter mit Standardwert. Erfordert --plain.
-s, --skip-runFührt Elide nach dem Generieren nicht aus.
--overwriteErsetzt vorhandene Dateien.

adopt

Migriert das Projekt im aktuellen Verzeichnis mit einem KI-Coding-Agenten zu Elide (Bestehendes Projekt übernehmen). Ohne Flags fragt es jede Auswahl ab. Der Exit-Code ist 0, wenn der Agent erfolgreich ist, 1, wenn er fehlschlägt oder nicht starten kann, und 130 bei Strg+C.

FlagWirkung
--build STRATEGYelide (einen Elide-Build anlegen) oder existing (Maven/Gradle beibehalten).
--harness HARNESScodex, claude oder omp.
--approval MODEauto-approve, manual-approve oder yolo (umgeht Schutzmechanismen).
--logZeigt die Ausgabe des Agenten live an und schreibt sie zusätzlich ins Log.
--prompt-append FILEHängt Hinweise an den Prompt an. Wiederholbar.
--non-interactiveBatch-Modus. Erfordert alle drei Auswahlen; nicht mit manual-approve.

help

Zeigt diese Dokumentation offline an. Ein Befehlsname gibt seinen Abschnitt aus, ein Slug oder Titel die Seite, und options listet alle Flags auf.

0:07 / 0:07
FlagWirkung
--format FORMATauto (Standard), interactive oder markdown.
-w, --width WIDTHMaximale Breite. Standard: 110.
-l, --lang LANGAnzeigesprache.
--languagesListet die Anzeigesprachen auf.
--no-animationBlendet die Schneeanimation aus; Tab schaltet sie um.

info

Zeigt Details zu Binary, Plattform, Sprachen und Netzwerktransport. --cargo-lockfile gibt das eingebettete Lockfile aus.

upgrade

Aktualisiert Elide.

FlagWirkung
--checkMeldet, ohne anzuwenden.
--forceAktualisiert auch, wenn bereits aktuell.
--channel CHANNELrelease oder nightly. Standard: der Kanal dieses Builds.

setup

Installiert eine optionale Komponente: elide setup python.

FlagWirkung
--channel CHANNELrelease oder nightly. Standard: der Kanal dieses Builds.
--forceWendet eine installierte Komponente erneut an.

setup installiert die Komponente für die laufende Version und führt nie ein Upgrade oder Downgrade von Elide durch. elide upgrade behält installierte Komponenten bei. setup lehnt Installationen über Paketmanager ab (Homebrew, apt, RPM, MSI, nix, snap); verwenden Sie das Installationsskript:

curl -sSL --tlsv1.2 elide.sh | bash -s -- --with-python

use

Legt eine Version in .elideversion fest und lädt sie herunter: elide use 1.6.0.

FlagWirkung
--channel CHANNELrelease oder nightly.
--no-installSchreibt die festgelegte Version, ohne herunterzuladen.

Versionen sind Releases (1.6.0, v1.6.0) oder Datumsstempel von Nightly-Builds (20260921). --ignore-version führt trotzdem dieses Binary aus.

lsp

Startet einen Language-Server-Protocol-Server über stdio. Unterstützt Java; siehe Weitere Editoren.

mcp

Startet einen Model-Context-Protocol-Server. Siehe Projekt-MCP-Server.

FlagWirkung
--mode MODEstdio (Standard) oder http (älteres HTTP+SSE).
--host HOSTHTTP-Host, an den gebunden wird. Standard: localhost.
--port PORTHTTP-Port, an den gebunden wird. Standard: 8125.

Erweitert

Von elide --help-all aufgelistet.

classpath

Gibt einen aufgelösten Classpath für [<sourceSet>:]<usage> aus, z. B. test:runtime. Verwendungen: toolchain, processor, compile, modules, runtime, provided. Standard: main:compile; bei einer unbekannten Verwendung ist der Exit-Code 2.

FlagWirkung
--offlineRuft keine entfernten Ressourcen ab.

index

Indiziert die aufgelösten Maven-Abhängigkeiten des Projekts und fragt diesen Index ab. Aktionen: build, status (Standard), get <address>, references <address>, used-by <name>, resolve <name>. Eine Adresse ist maven:group:artifact:version, optional gefolgt von /symbol und #member; ein Member ist name(paramType,...) für Methoden und Konstruktoren (<init>) und der bloße Name für Felder. build schreibt die mit --layers benannten Schichten (Standard: l0,l1; l2 ergänzt Member-Signaturen, l3 ausgehende Referenzen) neben die bereits gebauten. get, references und resolve enden mit Exit-Code 1 bei einem unbekannten Artefakt, Symbol, Member oder Namen und mit 2, wenn eine benötigte Schicht noch nicht gebaut ist; führen Sie dann elide index build --layers=... aus.

build kompiliert außerdem die Haupt-Java- und -Kotlin-Quellen und aktualisiert ihren lokalen Referenzindex. references local:<project>/<type> liest die ausgehenden Referenzen einer lokalen Klasse; used-by <type>[#member] gibt die passenden lokalen Quelldateien relativ zum Paket aus. Abfragen aktualisieren diese kompilierten Referenzen nicht. Beispiele und den experimentellen Umfang finden Sie unter Codeindex für Abhängigkeiten.

FlagWirkung
--layers=<l0,l1,l2,l3>Schichten, die build schreibt; l0 ist immer enthalten.
--offlineRuft keine entfernten Ressourcen ab.

javadoc

Erzeugt Javadoc, wie javadoc. Argumente folgen nach --.

FlagWirkung
--theme THEMEdefault oder elide.

javaformat

Formatiert Java mit google-java-format oder, mit --jfmt, mit dem jfmt-Dialekt von Netflix. Argumente folgen nach --. Akzeptiert --list-files und --list-diffs von format. Siehe Formatierung.

javap

Disassembliert JVM-Bytecode, wie javap. Argumente folgen nach --.

jdeps

Analysiert Abhängigkeiten zwischen JVM-Klassen, wie jdeps. Argumente folgen nach --.

ktfmt

Formatiert Kotlin mit ktfmt. Argumente folgen nach --. Akzeptiert --list-files und --list-diffs von format.

mvn

Führt Maven aus, wie mvn: elide mvn -- package. Siehe Native Maven.

Flag (nach --)Wirkung
--flavor NAMEPlugin-Satz, z. B. spring@4.1.0. Wird standardmäßig aus pom.xml erkannt.
--mode=MODEnative (Standard), mixed oder legacy.
--yesGenehmigt Downloads ohne Nachfrage.
--porcelainStreamt die eigene Ausgabe von Maven.

native-image

Baut ein JVM-Programm zu einer nativen ausführbaren Datei. Argumente folgen nach --. Siehe Native Image.

rewrite

Führt OpenRewrite-Rezepte auf den Haupt-Java-Quellen des Projekts aus (experimentell in 1.6.0). Rezepte stammen aus den mitgelieferten Bibliotheken und aus dependencies.maven.devPackages; die Typen der Abhängigkeiten stammen aus dem Codeindex. elide rewrite --list gibt die verfügbaren Rezepte aus; elide rewrite <name>… wendet sie der Reihe nach an. Der Standard-Workflow kompiliert die Hauptquellen und filtert Kandidatendateien, wenn die Vorbedingungen des Rezepts das unterstützen. Einrichtung, Beispiele und Kompatibilitätsgrenzen finden Sie unter OpenRewrite. Exit-Code 1 bei einem unbekannten Rezept, 2 bei einem Bedienungsfehler.

FlagWirkung
--dry-runGibt Diffs aus, ohne Änderungen an den Quellen anzuwenden; Build-Zustand kann trotzdem geschrieben werden.
--listListet die verfügbaren Rezepte auf, ohne die Hauptquellen zu kompilieren.
--no-prefilterÜberspringt das Kompilieren der Hauptquellen und parst jede Haupt-Java-Quelle.
--offlineRuft keine entfernten Ressourcen ab.

web

Web-Werkzeuge: elide web build app.ts page.md --out dist baut Dateien ohne Manifest. Siehe Web-Werkzeugkette.

FlagWirkung
-o, --out DIRAusgabeverzeichnis.

Globale Optionen

Werden vor oder nach dem Befehlsnamen akzeptiert, vor einem --.

Allgemeine Flags

OptionWirkung
-p, --project PATHProjektverzeichnis.
-f, --flag NAME[=VALUE]Setzt ein Build-Flag des Manifests.
-q, --quietBlendet den Fortschritt aus. Warnungen, Fehler und Programmausgabe erscheinen weiterhin.
-v, --verbose / --debugMehr Logausgabe.
--color / --no-colorErzwingt Farbe oder schaltet sie ab.
--timeout DURATIONZeitlimit, z. B. 30s, 5m; 0 deaktiviert es. Beendet Kindprozesse; der Exit-Code ist 124.
--max-mem SIZEHeap-Limit, z. B. 512m, 8g. Einmalige Läufe verwenden standardmäßig 4g.
--limit NAME=COUNTRessourcenlimit: workers oder fds. Wiederholbar.
--interopTeilt einen Kontext zwischen den Sprachen (Sprachen und Interop).
-V, --versionGibt die Version aus.

Sandbox-Flags

Programme laufen uneingeschränkt, bis Sie ein Sandbox-Flag übergeben. Siehe Sandbox und Limits.

OptionWirkung
--sandbox[=PROFILE]Profil: trusted. Ein bloßes --sandbox schränkt den Dateisystemzugriff ein.
--allow-read[=PATHS]Erlaubt Lesezugriffe; ohne Wert alle.
--allow-write[=PATHS]Erlaubt Schreibzugriffe; ohne Wert alle.
--allow-net[=HOSTS]Erlaubt Netzwerkzugriff; ohne Wert auf alle Hosts.
--deny-net=HOSTSSperrt Hosts; hat Vorrang vor --allow-net.
--allow-run[=CMDS]Erlaubt Unterprozesse; ohne Wert alle.
--deny-run=CMDSSperrt Befehle; hat Vorrang vor --allow-run.
--allow-env[=NAMES]Variablen, die das Manifest lesen darf; ohne Wert alle.
--fs-auditProtokolliert jede Entscheidung über Dateisystemzugriffe.
--allow-threadsErlaubt Threads im Gastcode. Standardmäßig verboten.
--allow-native / --no-nativeErlaubt oder verbietet nativen Zugriff aus dem Gastcode.

Diagnose-Flags

OptionWirkung
--debugger[=MODE|ADDRESS]Hängt einen Debugger an: auto, cdp, dap oder eine JDWP-Adresse (5005, host:5005). Siehe Debugging.
--debugger-host HOSTHost, an den der Debugger gebunden wird. Standard: 127.0.0.1.
--debugger-port PORTDebugger-Port. Standard: 4711 (DAP) oder 1337 (CDP).
--profiler[=PROFILER]cputracing, cpusampling oder memtracing.
--coverage[=auto]Erfasst die Abdeckung.
--insights INSIGHTSFügt Insight-Skripte ein.
--error-format FORMATNicht abgefangene Fehler: auto (Standard), pretty oder plain.
--abort-on-uncaught-exceptionBricht bei einer nicht abgefangenen Ausnahme mit SIGABRT ab.
--redirect-warnings FILESchreibt Warnungen nach FILE statt nach stderr.

Versions-Flags

OptionWirkung
--use-version VERSIONFührt eine andere installierte Elide-Version aus.
--ignore-versionIgnoriert .elideversion und --use-version.

Erweiterte Flags

OptionWirkung
--transport TRANSPORTNetzwerktransport (Netzwerktransport).
--locale LOCALESprache der CLI, z. B. fr.
-X, --vm KEY=VALUESetzt eine VM-Eigenschaft.
--safe-closeFährt auch bei einmaligen Läufen vollständig herunter.
--pkgst / --no-pkgstWird akzeptiert; ohne Wirkung. Wie Sie den Proxy maven.pkg.st umgehen, steht unter Repositorys.
--otel-endpoint=URLSendet OpenTelemetry-Daten an diesen OTLP-Endpunkt.
--otel-provider=PROVIDERSendet OpenTelemetry-Daten an einen Anbieter: otlp, sentry, datadog, posthog, honeycomb, grafana.
--otel-protocol=PROTOCOLOTLP-Protokoll: grpc, http/protobuf, http/json.
--otel-shutdown=MODEWie der letzte Export beim Beenden versendet wird: sidecar, inline, drop.
--no-otelSchaltet den OpenTelemetry-Export ab.
--help-instrumentsListet die Flags für Instrumente auf.

Python-Optionen

CPython-Flags; stellen Sie sie vor das Skript.

OptionWirkung
-IIsolierter Modus.
-BSchreibt keine Bytecode-Dateien.
-EIgnoriert die Umgebungsvariablen PYTHON*.
-SFührt beim Start kein import site aus.
-uUngepuffertes stdout und stderr.
-PStellt sys.path keinen unsicheren Pfad voran.
-OOptimiert. Wiederholbar.
-bWarnt bei Vergleichen zwischen bytes und str. Wiederholbar.
-xWird akzeptiert; ohne Wirkung.
-W ARGSteuerung von Warnungen. Wiederholbar.
-m MODULEFührt ein Modul als __main__ aus.

Netzwerktransport

--transport=Wirkung
autoStandard: v2 unter Linux und macOS, sonst nio.
v2Der native Transport von Elide.
epoll, kqueue, io_uringv2 mit diesem Treiber. Schlägt auf anderen Plattformen fehl.
nioPortabler Transport.

Instrumente

OptionWirkung
--jfr FILEZeichnet eine JFR-Datei auf, die beim Beenden gespeichert wird.
--jfr-settings SETTINGSdefault, profile (Standard) oder eine .jfc-Datei.
--jitdump DIRSchreibt JIT-Metadaten für perf unter Linux.
--heap-dump FILEErstellt beim Beenden einen Heap-Dump.
--heap-dump-on-oom FILEErstellt bei Speichermangel einen Heap-Dump und endet dann mit Exit-Code 3.
--vmstatMacht den Prozess für jps, jstat und jcmd sichtbar.

Exit-Codes

CodeBedeutung
0Erfolg, Hilfe- oder Versionsausgabe.
1Der Befehl oder das Programm ist fehlgeschlagen.
2Ungültige Verwendung, unbekanntes Ausführungsziel oder ein entfernter Befehl.
3Speicher erschöpft; --heap-dump-on-oom hat einen Heap-Dump geschrieben.
124--timeout ist abgelaufen.
andereVom Programm oder Werkzeug gesetzt.

Ausgabeströme

  • Programmausgabe, Testberichte und maschinenlesbare Ausgabe gehen nach stdout.
  • Fortschritt und Diagnosen gehen nach stderr.
  • Farbe ist aus, wenn der Stream kein Terminal ist. --color, FORCE_COLOR oder CLICOLOR_FORCE erzwingen sie; --no-color oder NO_COLOR schalten sie ab.
  • --quiet blendet nur den Fortschritt aus.

War diese Seite hilfreich?