import Bunx from "/snippets/cli/bunx.mdx";

NOTE

`bunx` ist ein Alias für `bun x`. Das `bunx`-CLI wird automatisch installiert, wenn Sie `bun` installieren.

Verwenden Sie bunx, um Pakete von npm automatisch zu installieren und auszuführen. Es ist das Bun-Äquivalent zu npx oder yarn dlx.

bunx cowsay "Hello world!"

NOTE

⚡️ **Geschwindigkeit** — Mit den schnellen Startzeiten von Bun ist `bunx` [etwa 100x schneller](https://twitter.com/jarredsumner/status/1606163655527059458) als `npx` für lokal installierte Pakete.

Pakete können ausführbare Dateien im "bin"-Feld ihrer package.json deklarieren. Diese werden als Paket-Ausführbare oder Paket-Binärdateien bezeichnet.

{
  // ... andere Felder
  "name": "my-cli",
  "bin": {
    "my-cli": "dist/index.js"
  }
}

Bei diesen ausführbaren Dateien handelt es sich üblicherweise um einfache JavaScript-Dateien, die mit einer Shebang-Zeile markiert sind, um anzugeben, welches Programm zu ihrer Ausführung verwendet werden soll. Die folgende Datei gibt an, dass sie mit node ausgeführt werden soll.

#!/usr/bin/env node

console.log("Hello world!");

Diese ausführbaren Dateien können mit bunx ausgeführt werden,

bunx my-cli

Wie bei npx prüft bunx zuerst nach einem lokal installierten Paket und greift dann auf die automatische Installation des Pakets von npm zurück. Installierte Pakete werden im globalen Cache von Bun für die zukünftige Verwendung gespeichert.

Argumente und Flags

Um zusätzliche Befehlszeilen-Flags und Argumente an die ausführbare Datei zu übergeben, platzieren Sie diese nach dem Namen der ausführbaren Datei.

bunx my-cli --foo bar

---

Shebangs

Standardmäßig respektiert Bun Shebangs. Wenn eine ausführbare Datei mit #!/usr/bin/env node markiert ist, startet Bun einen node-Prozess, um die Datei auszuführen. In einigen Fällen kann es jedoch wünschenswert sein, ausführbare Dateien mit Buns Laufzeitumgebung auszuführen, auch wenn die ausführbare Datei etwas anderes angibt. Verwenden Sie dazu das --bun-Flag.

bunx --bun my-cli

Das --bun-Flag muss vor dem Namen der ausführbaren Datei stehen. Flags, die nach dem Namen erscheinen, werden an die ausführbare Datei weitergegeben.

bunx --bun my-cli # gut
bunx my-cli --bun # schlecht

Paket-Flag

--package <pkg> oder -p <pkg> - Führt Binärdatei von einem bestimmten Paket aus. Nützlich, wenn sich der Name der Binärdatei vom Paketnamen unterscheidet:

bunx -p renovate renovate-config-validator
bunx --package @angular/cli ng

Um zu erzwingen, dass bun immer mit einem Skript verwendet wird, verwenden Sie einen Shebang.

#!/usr/bin/env bun

---