Typickou chybou je také nesprávné používání HTTP metod. Často vidím, že se pro mazání zdroje používá POST nebo že se stav mění přes GET. Držte se konvencí: GET na čtení, POST na vytváření, PUT nebo PATCH na úpravu a DELETE na smazání. To není jen formalita – správné metody usnadňují práci klientům i nástrojům pro testování. Navíc si usnadníte implementaci cache a automatické dokumentace.

Testování je nedílnou součástí vývoje, a pokud pracujete v Pythonu, pytest je jedním z nejpoužívanějších nástrojů. Na rozdíl od standardního unittestu nabízí jednodušší syntaxi, méně kódu a bohaté možnosti rozšíření. V tomto článku se zaměříme na praktické základy – od psaní prvních testů až po typické chyby, kterým se vyhnout.

Nejčastější chybou je vybrat licenci podle popularity, ne podle skutečného použití. Když váš projekt používá knihovny s konkrétní licencí, musíte zkontrolovat, jestli jsou navzájem slučitelné. Například kód pod GNU GPL nelze bez dalších opatření kombinovat s kódem pod licencí, která obsahuje další omezení. Před publikováním si projděte závislosti a jejich licence – ideálně pomocí automatického nástroje, který prohledá celý strom závislostí. Pokud některou knihovnu používáte jen interně, neznamená to, že na ni licence nemá vliv.

Častou chybou bývá nevyužívání datových souborů. Pokud potřebujete testovat stejný endpoint s různými vstupy, nemusíte kopírovat požadavek desetkrát. Místo toho si připravte soubor s daty ve formátu JSON nebo CSV a spusťte kolekci s tímto datovým zdrojem. Postman pak iteruje přes jednotlivé řádky a vy máte přehled o tom, který případ selhal. To je mnohem efektivnější než ruční spouštění a zároveň to pokrývá větší množství scénářů.

Nakonec si rozmyslete, jestli chcete projekt spravovat sám, nebo s komunitou. Licence neřeší jen právní rámec, ale i to, jak snadno lidé přispějí. Pokud máte jasno, přidejte do souborů hlavičky, vytvořte soubor s licencí a do readme napište, že je projekt otevřený. Tím se vyhnete budoucím sporům a usnadníte ostatním orientaci. Nejste první, kdo si touto otázkou prochází – podívejte se na podobné projekty a zjistěte, jakou licenci zvolily a proč. Teprve pak uděláte rozhodnutí, které bude odpovídat vašim cílům.

Začněte instalací pytestu přes správce balíčků. Poté vytvořte soubor s názvem test_*.py nebo *_test.py, aby pytest testy automaticky našel. Jednotlivé testy jsou obyčejné funkce začínající slovem test_. Příklad:

Při návrhu API se vyplatí myslet na verzování. I když to na začátku vypadá jako zbytečná práce, později vám to ušetří spoustu bolesti. Nastavte verzi v URL, například /api/v1/uzivatele, nebo použijte hlavičky. Změny v API pak můžete zavádět postupně, aniž byste rozbili aplikace, které na vašem API běží. Starší verze můžete po čase odstranit, ale mějte vždy dostatečně dlouhou dobu na migraci.

Častou chybou začátečníků je zapomenout na konverzi typů nebo na to, že konzolové okno se po dokončení programu okamžitě zavře. Řešení je jednoduché – na konec metody přidejte Console.ReadKey() nebo Console.ReadLine(), aby program počkal, než zmáčknete klávesu. Tento detail vám ušetří frustraci, když se vám zdá, že se aplikace spustí a hned zmizí.

Než začnete psát první test, vytvořte si v Postmanu prostředí. Bez něj budete neustále přepisovat adresy a přihlašovací údaje, což vede k chybám. Prostředí vám umožní definovat proměnné, na které se pak odkazujete pomocí dvojitých složených závorek. Typicky tam patří základní URL, klíče, identifikátory nebo tokeny. Díky tomu stačí změnit jednu hodnotu a celá kolekce testů začne běžet proti jinému serveru.

Když narazíte na test, který potřebuje data z předchozího požadavku, uložte si je do proměnné. Například po přihlášení si z odpovědi vytáhnete token a uložíte ho do prostředí. Pak ho použijete v autorizační hlavičce dalších požadavků. Tento postup je standardní a ušetří vám ruční kopírování. Pozor ale na to, že proměnná může být prázdná, pokud předchozí požadavek selže. Proto si v testech ověřte, že se hodnota skutečně nastavila, než ji začnete používat.

Pokud se budete držet těchto zásad, zjistíte, že testování API přestane být chaotické. Přestanete lovit chyby v adresách a začnete se věnovat skutečné logice rozhraní. Až narazíte na problém, budete vědět, kde ho hledat a jak ho opravit. To je hlavní přínos, který vám Postman nabídne, pokud ho používáte systematicky.

Praktickým přístupem je kombinovat měření pokrytí s analýzou mutací, která do kódu záměrně vnáší chyby a kontroluje, jestli je testy odhalí. Taková zpětná vazba je mnohem cennější než samotné procento. Udržujte pokrytí jako orientační ukazatel, ne jako dogma. Pro nový kód si nastavte rozumný minimální limit, ale u staršího kódu ho nezvyšujte násilně. Místo toho postupně doplňujte testy tam, kde dochází k nejčastějším chybám nebo kde je složitá logika. A nezapomeňte, že pokrytí nic neříká o tom, zda testy běží rychle a spolehlivě. Pomalé a flaky testy, které občas selžou bez zjevné příčiny, snižují důvěru v celou sadu, i když pokrytí ukazuje vysoká čísla.