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 web report ui-snapshot

Samotné UI, jednou přečtené při tomto commitu a zapsané jako statické stránky, které publikace nese na /ui (ADR 0141)

majordomus web report ui-snapshot

Použití

majordomus web report ui-snapshot [OPTIONS]

Argumenty

argumenthodnotavýchozípopis
--limit <LIMIT> 240 Nejvíce stránek k zápisu: nejprve každá obrazovka a panel, pak to, na co odkazují
--budget-seconds <BUDGET_SECONDS> 180 Nejvíce sekund, které lze věnovat stránkám, na které obrazovky odkazují; obrazovky a panely se píší bez ohledu na to, co stojí
--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ý
--only <ONLY> — Jen tyto povrchy, podle objeveného id (opakujte nebo oddělte čárkami) (přijímá každý podpříkaz)
--exclude <EXCLUDE> — Všechny povrchy kromě těchto, podle objeveného id (přijímá každý podpříkaz)

Příklady

  • Přečíst UI jednou a zapsat ho jako stránky, které publikace nese na /ui

    Zeptá se UI v procesu na každou obrazovku a panel a pak, vždy po jedné stránce z každé rodiny, dokud se nedosáhne `--limit` stránek nebo `--budget-seconds`, na stránky, na které odkazují, a každou zapíše jako soubor pod target/web/ui-snapshot: odkazy mezi nimi jsou relativní, odkaz, na který odpovídá jen běžící proces, vede na stránku snímku o živém UI, skriptu je řečeno, aby se znovu nečetl, a každá stránka je opatřena commitem, časem a spustitelným souborem, který ji přečetl. Deklarace vedle něj činí z adresáře povrch každé publikace a žádného procesu.

    $ majordomus web report ui-snapshot --limit 20

    Co tvrdí: skončí s kódem 0; vypíše web report, ui-snapshot.

    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 web report ui-snapshot --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.