5 věcí, které rozhodují o verzování monorepa s více balíčky

Z Mazovia


Co patří do konfiguračního repozitáře a co

Komentáře pište k tomu, proč něco děláte, ne k tomu, co je zřejmé z kódu. Samozřejmostí je mazání mrtvého kódu a zakomentovaných bloků — verze máte v gitu, ne v souboru. Nakonec si zvykněte na malé, srozumitelné commity a průběžné revize. Čistý kód nevznikne jednorázovým úklidem, ale drobnými rozhodnutími při každém zápisu. Když se tyto návyky usadí, přestanete trávit čas dohadováním a začnete řešit skutečný problém.

Na konci odhadu si přečtěte seznam činností a označte ty, které jste nikdy nedělali nebo u kterých si nejste jistí detailem. Ty nejsou rezervou, ale rizikem: buď je před odhadem rychle prozkoumejte, nebo je odhadněte záměrně šířeji a napište k nim, co přesně nevíte. Odhad, který přiznává nejistotu, je užitečnější než přesné číslo, které se za týden ukáže jako nepoužitelné.

Pro kombinace vstupů použijte [TestCase] s parametry nebo [Values] u parametru metody. Tím pokryjete hraniční hodnoty bez opisování stejného kódu. Pro dočasné vypnutí testu slouží [Ignore] s důvodem, ne zakomentování — zakomentovaný test se snadno zapomene a nikdo nepozná, že chybí. Pokud test závisí na čase nebo náhodě, vložte tyto závislosti jako rozhraní a v testu je nahraďte předvídatelnou implementací.

Druhý krok je nastavit nástroj, který změny rozpozná. Nestačí sledovat změněné soubory podle cesty ke složce balíčku, protože změna ve sdílené knihovně ovlivní i balíčky, které ji importují. Potřebujete nástroj, který sestaví graf závislostí a označí balíčky k vydání včetně tranzitivních závislostí. Bez toho se snadno stane, že vydáte balíček, který na novou verzi sdílené knihovny ani neodkazuje, nebo naopak zapomenete vydat ten, který ji používá.

Samotný test má tři části: příprava (arrange), akce (act) a ověření (assert). V přípravě vytvoříte instanci testované třídy a její závislosti. V akci zavoláte jednu metodu. Ve ověření použijete Assert.That s omezením (constraint), například Assert.That(vysledek, Is.EqualTo(42)). Pro výjimky slouží Assert.Throws(() => objekt.Metoda()). Vyhněte se starším formám jako Assert.AreEqual — novější syntaxe s Is.* je čitelnější a dává lepší chybové zprávy.

Kdy je lepší skript a kdy pipeline Skript dává smysl ve chvíli, kdy máte jeden projekt, jednoduché prostředí a potřebujete výsledek rychle. Stačí soubor osvětlení V obýVáKu s příkazy pro instalaci závislostí, spuštění testů a návratovým kódem, který CI server interpretuje jako úspěch nebo selhání. Pipeline se vyplatí, jakmile přibude více prostředí, matice verzí nebo závislost mezi fázemi. Pipeline je ale jen obal nad příkazy – pokud nemáte čistě napsaný skript, pipeline vaše problémy nevyřeší, jen je lépe schová.
Testy spouštějte při každém commitu, ideálně v CI. Selhání musí být okamžitě viditelné, jinak o ně nikdo nezakopne. Pokrytí není cíl, ale ukazatel — test, který nic netvrdí nebo pouze ověřuje, že se metoda nezhroutila, je horší než žádný, protože vytváří falešný pocit jistoty. Pište testy k logice, If you liked this article and you also would like to acquire more info with regards to více informací najdete zde kindly visit our own web site. která se může změnit, a ne k triviálním getterům.

Dbejte na to, aby testy byly deterministické. Test, který závisí na aktuálním čase, síti nebo pořadí spuštění, bude na CI serveru padat nepravidelně a brzy ho začnete ignorovat. Nastavte pevné časové zóny, izolujte databázi a používejte vlastní konfiguraci pro CI prostředí. Pokud test potřebuje externí službu, nahraďte ji v testech lokální náhradou nebo ji spouštějte v kontejneru, který je součástí pipeline.

Automatizace testů na CI serveru často skončí u jednoduchého skriptu, který spustí všechny testy po každém commitu. To je dobrý start, ale dřív nebo později narazí: testy běží příliš dlouho, padají z důvodů nesouvisejících se změnou a výsledek nikdo nečte. Rozdíl mezi funkční automatizací a chaosem není v nástroji, ale v tom, jak přesně definujete, co se má spustit, kdy a co se stane s výsledkem.

Nakonec nastavte publikování tak, aby se dělo pouze z CI a pouze z hlavní větve. Lokální publish snadno vytvoří verzi, která v repozitáři neexistuje. Před vydáním nechte proběhnout testy všech balíčků, které se změnily, a jejich závislostí. Pokud něco selže, vydání se zastaví a tag se nevytvoří. Tím získáte stav, kdy každá verze v registru má odpovídající commit, changelog a prošlé testy, a monorepo přestane být zdrojem překvapení.

Častý problém je testování příliš mnoha věcí v jednom testu. Když spadne, z názvu není poznat, co se pokazilo. Držte se pravidla jednoho chování na test a pojmenujte metodu popisně, třeba Vypocet_ceny_pri_prazdnem_kosiku_vrati_nulu. Asynchronní metody testujte jako async Task, ne přes .Result nebo .Wait() — jinak si zavoláte mrtvé uzamčení a testy budou viset.