Proč testovací pyramida selhává a jak ji postavit správně?

Když se řekne API, mnoho začátečníků si představí černou skříňku s tlačítky. Ve skutečnosti jde o rozhraní, které umožňuje dvěma programům spolu mluvit. Představ si, že si v restauraci objednáváš jídlo – ty jsi program, číšník je API a kuchyně je server. Číšník převezme tvou objednávku, předá ji kuchyni a pak ti přinese výsledek. Přesně tak funguje API: pošleš požadavek (request), server odpoví (response). Tento princip pochopíš za pět minut, ale zbytek je o detailech.

Při sestavování pyramidy myslete na rychlost a spolehlivost. Jednotkové testy by měly běžet v řádu milisekund, integrační v řádu sekund a end-to-end v řádu minut. Pokud váš testovací běh trvá více než deset minut, snižte počet end-to-end testů a nahraďte je integračními. Dobrým vodítkem je koukat na to, kolik testů se rozbije při změně rozhraní. Čím méně, tím lépe – pyramidová struktura tento počet minimalizuje.

REST API je ideální, když máte stabilní, dobře definované zdroje – třeba uživatele, objednávky nebo články. Využijete ho naplno, pokud klient potřebuje vždy kompletní reprezentaci dané entity. Typický příklad: veřejné API pro třetí strany. Tady oceníte jednoduchou adresaci, snadné testování pomocí běžných nástrojů a přirozenou podporu HTTP metod. Naopak pokud vaše aplikace vyžaduje složená data z více entit najednou, začnete řetězit volání a každé z nich s sebou nese režii. Roste latence a spotřeba dat, což se projeví zejména u mobilních klientů s omezeným připojením.

Pamatujte, že žádné univerzální řešení neexistuje. Špatná volba se projeví až po měsících provozu, kdy předělání API stojí násobně víc než správné rozhodnutí na začátku. Proto si naplánujte, co bude vaše API reálně dělat za rok, ne za týden. If you liked this write-up and you would like to acquire far more information concerning návod najdete zde kindly visit the web-site. Testujte na reálných datech, ne na vzorových příkladech. A hlavně – nenechte se zlákat marketingovými přísliby, ale vycházejte z vlastních měření a požadavků vašich uživatelů.

Dalším častým problémem je tlak na „přesnější odhad" ze strany vedení nebo zákazníka. Čím více chcete uspokojit očekávání, tím více se přibližujete k optimistickému číslu. V tu chvíli přestáváte být odhadcem a stáváte se vyjednavačem. Vhodnou obranou je nabídnout rozsah, ne jediné číslo. Například „funkce bude hotová za 3 až 6 dní" je mnohem upřímnější než „bude to trvat 4 dny". Zákazník i vedení se naučí s rozptylem pracovat, pokud jim vysvětlíte, že nejistota je přirozená součást vývoje.

Jak vypadá zdravá testovací pyramida? Zdravá pyramida má tři vrstvy. Na základně stojí jednotkové testy, které testují jednu funkci, třídu nebo metodu bez závislosti na databázi, službách nebo uživatelském rozhraní. Tyto testy by měly tvořit 70–80 % celého souboru. Uprostřed jsou integrační testy, které ověřují spolupráci dvou a více modulů – typicky testování repozitáře s databází nebo komunikaci s externím API. Na vrcholu je jen 5–10 % end-to-end testů, které prochází celou aplikací přes uživatelské rozhraní.

Při výběru mezi REST API a GraphQL nejde o módní trend, ale o konkrétní dopady na výkon, údržbu a rychlost vývoje. Mnoho týmů sáhne po GraphQL jen proto, že je „moderní", a pak řeší problémy s cachováním nebo přetíženým serverem. Jiní zůstanou u RESTu a bojují s nadbytečnými daty v každé odpovědi. Klíčové je pochopit, jak obě technologie pracují s daty a kde leží jejich skutečné limity.

Pamatujte, že testy by měly být rychlé a deterministické. Vyhněte se přístupu k databázi, souborům nebo síti – to patří do integračních testů. Pokud potřebujete simulovat závislosti, použijte mockovací knihovny jako Moq nebo NSubstitute. Jednotkové testy mají běžet v řádu milisekund, jinak je budete spouštět čím dál méně. Častou chybou je také testování implementace místo chování. Například kontrola, že byla zavolána privátní metoda, je zbytečně křehká. Místo toho ověřujte výsledek – ať už návratovou hodnotu, nebo stav objektu.

Než začneš dělat víc požadavků za sebou, nauč se zpracovávat chyby. Server nemusí být vždy dostupný, API může změnit verzi nebo můžeš překročit limit požadavků. Začátečníci často zapomínají na to, že každé API má omezení – maximální počet požadavků za minutu nebo za den. Když limit překročíš, dostaneš chybu a můžeš být dočasně zablokován. Proto vždy čti dokumentaci API, kde jsou pravidla popsána. Dobrým zvykem je také přidat barvy stěn do obýváku kódu odstup mezi požadavky – třeba tři sekundy pauzy – aby ses choval ohleduplně k serveru.

Testování jednotek v C# s NUnit je dovednost, která se hodí každému vývojáři, ať pracujete na malém projektu nebo na rozsáhlém podnikovém systému. NUnit patří mezi nejrozšířenější testovací frameworky pro .NET a jeho API je natolik intuitivní, že první test zvládnete napsat během pár minut. Než ale začnete, ujasněte si, co od testů očekáváte: nejde o psaní kódu pro radost, ale o zachycení regresí, ověření hraničních případů a poskytnutí rychlé zpětné vazby při refaktoringu.