majordomus completion
Doplňování pro jakýkoli povrch, zodpovídané z grafu příkazů: kandidáti, které shell žádá, a jednorázová integrace, která o ně žádá
majordomus completion
Použití
majordomus completion [OPTIONS] [COMMAND]Příkazy
- majordomus completion query Kandidáti pro jeden příkazový řádek z grafu příkazů. Co volá adaptér shellu při každém TAB
- majordomus completion init Integrace shellu, která se načte jednou, nenese žádný vlastní příkaz a ptá se tohoto spustitelného souboru na každého kandidáta
- majordomus completion install Vloží tuto integraci do startovacího souboru shellu, mezi spravované značky, aby ji nikdo neudržoval ručně
Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| --repo | <PATH> | — | Zde začne hledání kořene repozitáře (výchozí: aktuální adresář) (přijímá každý podpříkaz) |
| --discovery | vcs | filesystem | vcs | Jak se vyhledávají deklarativní soubory (přijímá každý podpříkaz)
|
| --strict | flag | — | Odmítne pokračovat, pokud kterýkoli soubor vrstvy nese diagnostiku typu chyba (přijímá každý podpříkaz) |
| --share | <DIR> | — | Adresář share distribuce nástroje (kinds.yaml, schemas/); výchozí: $MAJORDOMUS_SHARE, poté vlastní share/ repozitáře, poté ten vedle spustitelného souboru (přijímá každý podpříkaz) |
Příklady
-
Integrace, kterou člověk instaluje jednou
Bez podpříkazu integrace shellu pro zsh. Neobsahuje žádný příkaz, příznak ani identifikátor: každý kandidát pochází z dotazu na graf příkazů repozitáře, v němž shell je, takže jedna integrace obslouží každý checkout a nikdy nezastará.
$ majordomus completionCo tvrdí: končí kódem 0; vypíše completion query, compdef.
Testuje apps/majordomus-cli/tests/cli_examples.rs, který spouští příkaz nad sestaveným programem a ověřuje, co stránka uvádí.
Odkud to pochází
Deklarováno jednou v apps/majordomus-cli/src/cli.rs: clap pro strukturu, typovaná metadata v Rustu vedle něj pro příklady. Tato stránka, majordomus completion --help, docs/generated/cli.md a docs/generated/cli.json jsou projekce této jediné deklarace.
Celá příkazová řádka na jedné stránce: stránka příkazové řádky registru. Životní cyklus úlohy (init, start, finish, doctor, ...) patří nástroji shell, jinému programu: Příkazy a jeho specifikace.