majordomus scope
Rozsah repozitáře: co pracovník čte a co nikdy nečte; s cestami, zda je každá uvnitř, nebo vně, a proč
majordomus scope
Použití
majordomus scope [OPTIONS] [PATHS]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) |
| <PATHS> | <PATHS> | — | Cesty relativní k repozitáři k posouzení; bez nich se vypíše deklarace a součet |
| --format | text | json | text | Tvar výstupu
|
| --check | flag | — | Končí kódem 10, když je kterákoli zadaná cesta mimo rozsah |
Příklady
-
Co pracovník čte z tohoto repozitáře
Bez cesty samotná deklarace a součet: kolik sledovaných souborů je v rozsahu a kolik mimo.
$ majordomus scopeCo tvrdí: skončí s kódem 0.
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í.
-
Posoudit cesty a říct, které pravidlo rozhodlo
Pro každou cestu: uvnitř nebo vně a pravidlo, které rozhodlo. `--check` skončí s kódem 10, je-li kterákoli zadaná cesta vně, čímž hook odmítne ji číst.
$ majordomus scope docs/CLI.md --format jsonCo tvrdí: končí kódem 0; vypíše jeden JSON dokument nesoucí /0/verdict, /0/rule.
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 scope --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.