domain-cli

Use when building CLI tools. Keywords: CLI, command line, terminal, clap, structopt, argument parsing, subcommand, interactive, TUI, ratatui, crossterm, indicatif, progress bar, colored output, shell completion, config file, environment variable, 命令行, 终端应用, 参数解析

1. Dodaj umiejętność domain-cli do swojego projektu Rust jako referencję w kontekście budowania narzędzia wiersza poleceń. Umiejętność aktywuje się automatycznie gdy system wykryje plik Cargo.toml w twoim projekcie.

2. Zdefiniuj strukturę argumentów CLI używając derive makr clap. Utwórz strukturę Rust z atrybutami #[derive(Parser)] i opisz każde pole jako argument lub flagę — clap automatycznie wygeneruje parser i wiadomość pomocy.

3. Ustaw warstwową konfigurację: argumenty CLI mają najwyższy priorytet, następnie zmienne środowiska, potem plik konfiguracyjny, wreszcie wartości domyślne. Użyj figment lub config do łączenia źródeł konfiguracji w określonej kolejności.

4. Obsługuj błędy prawidłowo — wypisuj komunikaty błędów na stderr (eprintln!), dane na stdout (println!), i zwracaj niezerowe kody wyjścia. Zdefiniuj main() zwracającą Result<(), Error> aby automatycznie obsługiwać błędy.

5. Dla narzędzi interaktywnych dodaj pasy postępu (indicatif), kolorowe wyjście (colored) i interaktywne monity (dialoguer). Obsługuj przerwanie Ctrl+C poprzez obsługę sygnałów, aby narzędzie mogło się czysto zamknąć.

6. Dla bardziej złożonych interfejsów terminalowych rozważ ratatui do budowania TUI — umiejętność zawiera wytyczne do integracji z crossterm do kontroli terminala.