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.

Každý nález nese příkaz, který jej reprodukuje

Když doctor, check, watch nebo finish hlásí selhání nebo drift, řádek končí [reproduce: <command>] — shellovým příkazem, který člověk může spustit, aby viděl tentýž fakt bez Majordomus. Nález, který nelze nezávisle reprodukovat, se považuje za chybu v Majordomus.

deklarovaný stavdeklarovaný stav: zaručeno Deklarováno jako deterministické a blokující, implementováno a s uvedeným behaviorálním testem, který to má dokázat. Zda to zaznamenaný běh podporuje, říká verdikt důkazů zobrazený vedle.

zaznamenané důkazyzaznamenané důkazy: nespuštěno Deklarováno jako zaručené, ale nepodložené zaznamenaným během: test je pojmenován, ale žádný úspěšný běh nad současnými vstupy zaznamenán není. jak se zaznamenávají důkazy

Co to znamená

Když doctor, check, watch nebo finish hlásí selhání nebo drift, řádek končí [reproduce: <command>] — shellovým příkazem, kterým člověk uvidí tentýž fakt bez Majordomus. Zjištění, které nelze nezávisle reprodukovat, se považuje za chybu v Majordomus.

Princip

Každý nález prochází jednou tiskárnou v lib/common.sh, která bere úroveň, kategorii, předmět, zprávu a příkaz k reprodukci. S --json vychází stejná pole jako jeden objekt JSON na řádek, takže na ně může skript reagovat.

Jak to vidět

majordomus doctor
# FAIL wiring      finish-on-push — hook .git/hooks/pre-push does not exist  [reproduce: ls -l .git/hooks/pre-push]
majordomus --json doctor | head -1

Co nepokrývá

Informační řádky (INFO) smějí vynechat příkaz k reprodukci, když není co reprodukovat.

Proč existuje

Každý audit v původním prostředí — včetně toho, který uklidil ostatní — obsahoval alespoň jedno nepravdivé tvrzení, které odhalil až nezávislý druhý čtenář. Nález, který si můžete sami zopakovat, nepotřebuje, aby se mu věřilo.

Detail vykreslený z docs/claims/reproduce-command.md.

Od tvrzení k důkazu

  1. 1 · veřejné tvrzení

    Každý nález nese příkaz, který jej reprodukuje

    Vytvořeno na Kontrakt dokončení.

  2. 2 · kanonické tvrzení

    reproduce-commanddeklarovaný stav: zaručeno v docs/CLAIMS.yaml

    Definováno v přečtěte si to na tomto webu · docs/DESIGN.md

  3. 3 · implementace

    lib/common.sh

  4. 4 · test a scénáře

    Test: test/cases/02_doctor_basic.sh

    Provedeno v Doložit, že pravidlo se skutečně vynucuje, a není jen napsané, Zjistit, co se změnilo od doby, kdy se na to naposledy někdo díval, Podmínit CI samotným nástrojem s exit kódem, který je kontraktem.

  5. 5 · zaznamenané běhy

    zaznamenané důkazy: nespuštěno jak se zaznamenávají důkazy

Ověřte si to sami

Test běží v jednorázovém dočasném repozitáři a ověřuje chování, ne řetězec ve zdrojovém kódu.

z klonu repozitáře
bash test/run.sh 02_doctor_basic

Kde se toto tvrzení používá

Související tvrzení stejná implementace

Okamžiky, na které to odpovídá

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