majordomus rules show
Jedno pravidlo: co ho dokládá, na čem závisí a co chybí
majordomus rules show
Použití
majordomus rules show [OPTIONS] <ID>Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| <ID> | <ID> | povinné | Id pravidla, s verzí nebo bez ní |
| --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) |
| --format | text | json | text | Tvar výstupu (přijímá každý podpříkaz)
|
Příklady
-
Pravidlo, které repozitář nedeklaruje
Id pravidla, které nic nedeklaruje, je not-found, ne prázdná odpověď. Překlep, který se čte jako „toto pravidlo nemá důkaz“, je jediná odpověď, kterou tento příkaz nesmí nikdy dát, protože se nedá odlišit od nálezu, kvůli kterému celý subsystém existuje.
$ majordomus rules show project.no-such-ruleCo tvrdí: exit 12.
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 rules show --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.