Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

majordomus commands list

Každý příkaz, jeden řádek: co to je, co jeho spuštění mění a kde je promítnut

majordomus commands list

Použití

majordomus commands list [OPTIONS]

Argumenty

argumenthodnotavýchozípopis
--origin executable | tool | workflow — Pouze příkazy tohoto programu
  • executable — Tento spustitelný soubor
  • tool — Nástroj shell, bin/majordomus
  • workflow — Pracovní postup, který repozitář deklaruje
--effect read-only | local-mutation | repository-mutation | network-mutation | destructive — Pouze příkazy, jejichž efekt je nejvýše tento
  • read-only — Čte a odpovídá
  • local-mutation — Zapisuje jen to, co žádný commit nenese
  • repository-mutation — Zapisuje sledované soubory
  • network-mutation — Sahá do sítě s účinkem
  • destructive — Něco odstraňuje
--search <TEXT> — Jen příkazy odpovídající tomuto textu v jejich vyvolání, shrnutí, štítcích nebo identitě
--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)
  • vcs — Sledované soubory přes index správy verzí (kontrakt vrstvy); vrstva, z níž není nic sledováno, se čte z pracovního stromu
  • filesystem — Průchod pracovním stromem se stejnou sémantikou glob; zahrnuje nesledované soubory
--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)
  • text — Řádky pro člověka
  • json — Jeden dokument JSON, deterministický

Příklady

  • Pouze to, co čte

    Filtry jsou vlastním slovníkem grafu, ne hledání v textu: `--effect read-only` je každý příkaz, který nikde nic nemění, což je stejný predikát, jakým politika vystavení rozhoduje, co smí volat strojový povrch.

    $ majordomus commands list --effect read-only

    Co tvrdí: skončí s kódem 0; vypíše read-only.

    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 commands list --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.

Prohledává názvy a popisy všech stránek, které tento web publikuje.