majordomus release bump
Zvýšit verzi na jediném místě, kde se píše, nejméně na to, co vyžaduje veřejná smlouva; zbytek odvodí scripts/derive
majordomus release bump
Použití
majordomus release bump [OPTIONS]Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| --level | <LEVEL> | — | Zvýšit o tolik místo o naměřené minimum; nikdy pod ně |
| --exact | <VERSION> | — | Nastavit přesně tuto verzi; odmítnuto, je-li pod změřeným minimem |
| --dry-run | flag | — | Říct, co by se změnilo, a nic nezapsat |
| --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 | Jak vykreslit odpověď (přijímá každý podpříkaz)
|
Příklady
-
Jeho zvýšení, na jediném místě, kde se píše
Jediný zapisovač a nic nepočítá: čte plán, který vytiskne `release analyze`, a aplikuje ho, takže verze, kterou zapíše, je změřené minimum, ne jeho vlastní úsudek. `--level` a `--exact` jmenují vyšší verzi, když člověk myslí víc, než co udělal kontrakt, a pod minimem se odmítnou, aniž by se cokoli zapsalo — přepsání, které by mohlo verzi podstřelit, by měření učinilo dekorativním. Přepíše jediný řádek verze manifestu a záznam o něm v lock souboru, přečte oba zpět a share/version.txt a razítka generátorů nechá scripts/derive. Repozitář, který nic nepublikoval, nemá základ, od něhož zvyšovat — příklad běží v takovém — a řekne to s exit 12, místo aby vymýšlel číslo.
$ majordomus release bump --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 release bump --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.