cli-builder

Umiejętność do tworzenia interfejsów CLI w TypeScript przy użyciu Bun. Dowiesz się, jak parsować argumenty, organizować subkomendy, formatować wyjście i dystrybuować narzędzia. Idealne dla programistów, którzy chcą budować własne narzędzia deweloperskie, dodawać komendy do istniejących projektów lub tworzyć skrypty integrujące się z shell'em. Zawiera praktyczne przykłady od minimalnego CLI do zaawansowanych wzorców z rejestrem komend.

1. Utwórz plik TypeScript dla swojego narzędzia (np. scripts/my-tool.ts) i dodaj shebang #!/usr/bin/env bun na początku, aby móc uruchamiać plik bezpośrednio z wiersza poleceń.

2. Rozpocznij od najprostszej wersji: pobierz argumenty z process.argv.slice(2), sprawdź pierwszą wartość jako komendę i wyświetl pomoc, jeśli użytkownik poprosi o nią lub nie poda żadnej komendy.

3. Aby obsługiwać flagi i opcje (np. -n, --verbose), użyj modułu parseArgs z Node'a (dostępny w Bun). Zdefiniuj opcje z ich typami, krótkimi aliasami i wartościami domyślnymi.

4. Odczytaj wartości flag z obiektu values i argumenty pozycyjne z tablicy positionals zwróconej przez parseArgs. Użyj ich do sterowania zachowaniem narzędzia.

5. Jeśli planujesz wiele komend, zastosuj wzorzec rejestru komend zamiast długiego łańcucha instrukcji warunkowych – ułatwi to rozszerzanie narzędzia.

6. Uruchom narzędzie poleceniem bun scripts/my-tool.ts nazwa-komendy i testuj różne flagi oraz argumenty, aby upewnić się, że parsowanie i logika działają poprawnie.