Start

Installation

Antra ist ein in Zig geschriebener Interpreter. Installiert besteht er aus dem Programm antra (antra.exe unter Windows) und der Standardbibliothek; beides legt antra self install für dich ab – unter Linux, macOS und Windows gleich, ohne Shell-Skripte.

Überblick#

Es gibt zwei Wege:

Fertiges Release-Archiv (antra-<os>-<arch>.tar.gz bzw. .zip): entpacken, antra self install, fertig. Kein Zig nötig. Das Archiv enthält außerdem alle Beispiele, diese Dokumentation und eine README.md, die die ersten Schritte für genau dein Betriebssystem erklärt.
Aus dem Quellcode mit Zig 0.17 bauen und dann ebenso installieren.

Optional, nur für einzelne Pakete:

Bibliothek	Wozu
`libsqlite3`	`Antra::SQLite` (über `Antra::FFI` geladen)
SDL2 / raylib	`Antra::SDL`, `Antra::Raylib` (Fenster, Grafik)
`curl` (Programm)	`Antra::Curl` (ruft das `curl`-Kommando auf)

SDL2, raylib und SQLite holt dir pro Projekt antra native install, siehe Kapitel 22.

1. Aus einem Release-Archiv#

Lade das Archiv für dein System (antra-linux-x86_64.tar.gz, antra-macos-aarch64.tar.gz, antra-windows-x86_64.zip, …), entpacke es und rufe darin antra self install auf:

tar xzf antra-linux-x86_64.tar.gz
antra-linux-x86_64/bin/antra self install

Unter Windows (PowerShell):

Expand-Archive antra-windows-x86_64.zip .
.\antra-windows-x86_64\bin\antra.exe self install

self install kopiert antra und die Standardbibliothek nach ~/.local (Windows: %LOCALAPPDATA%\Programs\antra) und trägt bin in deinen PATH ein (Unix: ~/.profile und vorhandene ~/.bashrc/~/.zshrc; Windows: den Benutzer-PATH). Danach ein neues Terminal öffnen:

antra --version

Optionen: --prefix DIR installiert woanders hin, --no-path lässt den PATH in Ruhe.

2. Aus dem Quellcode#

Du brauchst Zig 0.17 (zig version muss 0.17.x melden; macOS: brew install zig, sonst Archiv von ziglang.org/download). Einen C-Compiler brauchst du nicht: Zig übersetzt die mitgelieferten C-Bibliotheken (PCRE2, Boehm-GC unter vendor/) selbst.

zig build -Drelease=true
zig-out/bin/antra self install

zig-out/bin/antra lässt sich auch direkt aus dem Checkout benutzen; es findet die Standardbibliothek in lib/ des Checkouts. Alternativ installiert Zig alles selbst in ein Präfix deiner Wahl:

zig build -Drelease=true -Dstdlib=true --prefix ~/.local

3. Aktualisieren und entfernen#

antra self update                    # neuestes Release für dieses System
antra self update --from antra-linux-x86_64.tar.gz   # oder ein Archiv/URL
antra self info                      # Version, Programm, Bibliothek
antra self uninstall                 # Programm, Bibliothek und PATH-Eintrag entfernen
antra self uninstall --vscode        # dazu die VS-Code-Erweiterung

update ersetzt auch ein gerade laufendes antra (unter Windows bleibt dabei antra.exe.old liegen, das der nächste Lauf aufräumt). uninstall nimmt den PATH-Eintrag wieder heraus, den install angelegt hat (Windows: aus dem Benutzer-PATH; sonst die markierten Zeilen in ~/.profile, ~/.bashrc, ~/.zshrc).

4. Erste Ausführung#

Lege eine Datei hallo.ant an:

say("Hallo, Antra!")

Und starte sie:

antra hallo.ant

Ausgabe:

Hallo, Antra!

Bibliothekspfade und `ANTRA_LIB`#

Standardbibliothek und mitgelieferte Pakete liegen unter lib/ im Projektverzeichnis und werden automatisch gefunden: das Binary sucht sie oberhalb seines eigenen Pfads. Liegt das Binary woanders, zeigt ANTRA_HOME auf das Verzeichnis, das lib/ enthält. Eigene Paketverzeichnisse fügst du so hinzu:

antra -I meine_lib src/main.ant
# oder dauerhaft über die Umgebungsvariable (mit ':' getrennt):
export ANTRA_LIB="$HOME/antra-pakete:$HOME/mehr-pakete"

Optional: VS-Code-Erweiterung#

Die VS-Code-Erweiterung (Syntax-Highlighting, Vervollständigung, Hover, Live-Diagnosen) installiert antra selbst:

antra self vscode                 # neueste Version installieren oder aktualisieren
antra self install --vscode       # antra und Erweiterung in einem Schritt
antra self vscode --from antra-language.vsix   # eine bestimmte Datei oder URL
antra self vscode --uninstall     # Erweiterung wieder entfernen

antra lädt dafür die aktuelle antra-language.vsix aus den Releases von antra-vscode und übergibt sie an das code-Kommando von VS Code (gesucht werden code, code-insiders und codium im PATH sowie die üblichen Installationsorte; --code PFAD gibt es direkt an). Ist kein Download möglich, installiert VS Code die Erweiterung leobm.antra-language aus seinem Marketplace, sobald sie dort veröffentlicht ist. Die Erweiterung findet antra danach selbst über den PATH.

Unter macOS legt VS Code code erst mit dem Befehl Shell Command: Install 'code' command in PATH an; antra findet es aber auch ohne das im Programmordner.

Fehlerdiagnose#

antra: command not found – ~/.local/bin ist nicht im PATH. Neue Shell öffnen oder export PATH="$HOME/.local/bin:$PATH" setzen.
antra findet seine Standardbibliothek nicht – antra self info zeigt, wo sie gesucht wird. Liegt das Programm getrennt von lib/, zeigt ANTRA_HOME auf das Verzeichnis, das lib/ enthält.
Build-Fehler in build.zig – meist eine andere Zig-Version. zig version muss 0.17.x melden.
Antra::SQLite findet die Bibliothek nicht – libsqlite3 über den Paketmanager installieren (z. B. sudo apt install libsqlite3-0, brew install sqlite).

Nächster Schritt#

Weiter mit 02-einstieg.md – was Antra ist und wie man die Sprache liest.

Quelle dieser Seite