majordomus prs prove-dry-run
Dokázat, že nemutující cyklus nic nepřesune: pořídit snímek refů originu, otevřených pull requestů, auditní stopy, lease a lokálních refů, spustit refresh, plan, drain --dry-run a cleanup (výpis), pořídit snímek znovu a porovnat; stažená zrcadla refresh musí odpovídat tomu, co origin servíruje. Exit 10 s pojmenováním toho, co se pohnulo. Nemá žádný přepínač: není co zapínat
majordomus prs prove-dry-run
Použití
majordomus prs prove-dry-run [OPTIONS]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) |
| --format | text | json | text | Tvar výstupu (přijímá každý podpříkaz)
|
Příklady
-
Důkaz potřebuje forge, o kterém má něco dokazovat
Důkaz pořídí snímek refs na origin a otevřených pull requestů na forge kolem kroků refresh, plan, drain --dry-run a cleanup a porovná je. Repozitář bez remote na GitHubu nemá co snímkovat, takže skončí s kódem 12 dřív, než se spustí jakýkoli krok: důkaz, který se nemohl podívat, není důkazem, že se nic nepohnulo.
$ majordomus prs prove-dry-runCo 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 prs prove-dry-run --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.