# Pakete und virtuelle Umgebungen

Der native Elide-Launcher verwendet pytools, die optionale Bibliothek von Elide für Python-Paketwerkzeuge. Installieren
Sie sie mit `elide setup python`; mit `elide setup python --force` reparieren Sie eine ältere oder unvollständige
Installation.

Jedes Projekt hat eine automatische Paketumgebung unter `.dev/dependencies/pypi/site-packages`.
Elide fügt sie ohne Aktivierung oder `VIRTUAL_ENV` dem Importpfad von Python hinzu.

Das Projekt ist das nächstgelegene Verzeichnis, ausgehend vom Arbeitsverzeichnis, das `elide.pkl`, `pyproject.toml`,
`requirements.txt`, `package.json`, `Gemfile` oder `.git` enthält; ohne ein solches ist es das Arbeitsverzeichnis.
`elide uv`, `elide install`, `elide python` und `elide run` verwenden aus jedem Unterverzeichnis dieselbe Umgebung,
auch für ein Skript, das an anderer Stelle liegt. `--project PATH` wählt ein Projekt direkt aus.

```bash
elide uv install attrs
elide python -c 'import attrs; print(attrs.__version__)'
```

So installieren Sie die in `pyproject.toml`, `requirements.txt` oder `elide.pkl` deklarierten Abhängigkeiten:

```bash
elide install --ecosystems=pypi
```

`elide install --workspace` umfasst alle deklarierten Ökosysteme. Ein einfaches `elide install` behält seinen
Maven-Standard bei.

## Paketoperationen

`elide uv` akzeptiert `install`, `sync`, `compile`, `check`, `list`, `freeze` und `show`. Der optionale Namensraum
`pip` wird ebenfalls akzeptiert, zum Beispiel `elide uv pip install attrs`.

```bash
elide uv compile requirements.in --generate-hashes --output-file requirements.txt
elide uv sync requirements.txt
elide uv list
elide uv check
```

`compile` fixiert Anforderungen; diese Oberfläche bietet die Projektbefehle `lock` und `run` von uv sowie das
Herunterladen und Verwalten von Interpretern noch nicht an. `sync` entfernt Pakete, die in der Anforderungsdatei fehlen.
Um eine Umgebung mit einer leeren Datei zu leeren, ist die explizite uv-Option `--allow-empty-requirements` nötig.

`check` prüft das Paketverzeichnis des Projekts mit den Diagnosen von uv zu Abhängigkeiten, Python-Version und
Wheel-Kompatibilität. Bei inkompatiblen oder fehlenden Abhängigkeiten liefert es 1.

Wählen Sie mit `elide --project PATH uv ...` ein Projekt. Elide bestimmt Interpreter und Ziel; die Interpreter- und
Zieleinstellungen von uv leiten die Installation nicht in eine andere Umgebung um. Optionen für Index, Offline-Betrieb,
Hash-Prüfung und Cache bleiben verfügbar. Builds aus dem Quellcode sind deaktiviert; nur kompatible Wheels lassen sich
installieren. Für CPython gebaute Wheels funktionieren nicht.

## Isolierte Werkzeuge

Führen Sie ein Python-Konsolenskript aus, ohne seine Abhängigkeiten in Ihr Projekt zu installieren:

```bash
elide uv tool run --from 'httpie==3.2.4' http --help
elide uv tool run --from PACKAGE --with EXTRA_PACKAGE COMMAND ARGS...
elide uv tool list
elide uv tool uninstall ENVIRONMENT_KEY
elide uv tool prune
elide uv tool prune --all
elide uv tool dir
```

Werkzeugoptionen stehen vor `COMMAND`; alles danach wird an das Werkzeug durchgereicht. `--from` ist standardmäßig der
Befehlsname. Nur kompatible Wheels werden unterstützt; Werkzeuge, die nicht unterstützte native Erweiterungen oder Builds
aus dem Quellcode benötigen, schlagen ausdrücklich fehl. Dies ist ein von Elide verwalteter Werkzeug-Runner, nicht die
uneingeschränkte Werkzeugschnittstelle von uv.

Elide führt Konsolen-Einstiegspunkte mit seinem eigenen Python-Interpreter aus und behält Ihr Arbeitsverzeichnis, Ihre
Argumente und den Exit-Code bei. Die Abhängigkeiten eines Werkzeugs sind von Projektpaketen, `PYTHONPATH` und externen
virtuellen Umgebungen isoliert, auch wenn der Interpreter sich neu startet. Werkzeuge haben weiterhin die normalen
Benutzerrechte; die Isolierung der Abhängigkeiten ist keine Sicherheits-Sandbox.

Umgebungen liegen unter `$ELIDE_HOME/python/tools` oder im vorhandenen Benutzerdatenverzeichnis von Elide
(`$XDG_DATA_HOME/elide`, ersatzweise `~/.local/share/elide`). Cache-Schlüssel enthalten die Identität der
Elide-Laufzeit, die Paketanforderungen und die Index-Optionen. Legen Sie Anforderungen für reproduzierbare Ergebnisse
fest; mit `tool run --refresh` wird neu aufgelöst, auch nachdem sich ein lokales Wheel unter demselben Pfad geändert
hat. `--offline`, `--no-index`, `--index-url` und `--find-links` werden unterstützt.

Der Cache ist standardmäßig auf **2 GiB** und **30 Tage seit der letzten Nutzung** begrenzt. Jeder Lauf entfernt
abgelaufene Einträge und bei Bedarf die am längsten ungenutzten inaktiven Umgebungen. Mit
`ELIDE_PYTHON_TOOLS_MAX_BYTES` passen Sie die Größengrenze an. Zu große Installationen werden verworfen; aktive
Umgebungen sind geschützt, sodass ein voller Cache mit laufenden Werkzeugen eine neue Installation ablehnen kann. Die
Größe wird bei Cache-Operationen geprüft und nicht als Dateisystemquote erzwungen, während beliebiger Werkzeugcode läuft.

`tool list` zeigt Umgebungsschlüssel, Größen in Bytes und Anforderungen. `tool uninstall KEY` entfernt eine inaktive
Umgebung. `tool prune` wendet Ablauf- und Größengrenzen an; `tool prune --all` löscht alle inaktiven Umgebungen. Der
Runner vermeidet einen zweiten dauerhaften Download-Cache von uv und entfernt unvollständige Staging-Daten bei der
nächsten Cache-Operation. Die Bereinigung berührt nie Projektumgebungen.

## Externe virtuelle Umgebungen

`VIRTUAL_ENV` wird weiterhin unterstützt, um kompatible Pakete für Python 3.13 aus einer externen virtuellen Umgebung zu
importieren. Die eigenen Pakete des Projekts haben Vorrang vor dieser Umgebung. Das ist optional; für Pakete, die über
Elide installiert wurden, ist es nicht nötig.

Die Python-Unterstützung bleibt experimentell. Native Erweiterungen lassen sich noch nicht
bauen. pip ist nicht enthalten; verwenden Sie die Paketbefehle oben.
