Nezapomeňte na verzování API. Pokud
plánujete měnit rozhraní, zaveďte od začátku cestu s verzí, například /api/v1/. Ušetříte si budoucí bolesti hlavy, protože stávající klienti budou moci dál používat starou verzi, zatímco vy budete vyvíjet novou. Tento jednoduchý návyk je často opomíjený, ale v dlouhodobém horizontu má zásadní vliv na udržitelnost projektu. Když se vrátíte k původní otázce Express versus čistý Node: pro většinu projektů vyberte Express a zaměřte se na čistou architekturu a konzistenci, ne na boj s frameworkem.
Při návrhu REST API
úložné prostory v malém bytě prostředí Node.js stojíte před zásadním rozhodnutím: sáhnout po frameworku Express, nebo vystačit s čistým Node.js. Express je de facto standardem pro tvorbu API, ale jeho použití s sebou nese určité návyky, které mohou vést k nepřehlednému kódu. Na druhou stranu, čistý Node.js dává naprostou kontrolu, ale za cenu vyššího úsilí při implementaci běžných funkcí, jako je parsování těla požadavku nebo směrování.
Nejčastější chyby, které tě potkají u prvního testu První chybou bývá testování více vě
cí najednou. Jeden test by měl ověřovat jednu konkrétní vlastnost. Když test selže, chceš okamžitě vědět, co se pokazilo, ne prohledávat tři různé scénáře v jednom bloku. Druhou častou chybou je testování implementace místo chování. Nepiš test, který kontroluje, jaké interní proměnné metoda používá. Testuj výstup a vstup, ne vnitřní fungování. To ti umožní později refaktorovat kód bez toho, abys musel měnit testy. Třetí chybou je opomíjení okrajových případů. Zkus testovat také prázdný vstup, nulový vstup nebo extrémně velké hodnoty. Tyto případy často odhalí chyby, které běžné použití neodhalí.
Pro lepší přehlednost organizujte testy do složek a používejte soubory conftest.py, kam můžete umístit fixtures sdílené napříč testy. Když pak spustíte pytest z příkazové řádky, můžete použít přepínače jako -k pro filtrování názvů nebo -x pro zastavení při prvním selhání. Nezapomeňte také na parametrizaci – pomocí @pytest.mark.parametrize můžete spustit stejný test s různými vstupy, což výrazně rozšíří pokrytí bez psaní nového kódu
Na závěr si osvojte čtení výstupu pytestu. Chybové hlášky obsahují podrobný diff, který ukazuje, co se očekávalo a co bylo ve skutečnosti. Nenechte se zmást neprošlými testy – nejprve opravte chybu v testovacím kódu, pokud je zjevná, jinak analyzujte produkční kód. Testy by měly být rychlé, deterministické a měly by běžet kdykoliv bez ohledu na pořadí. S těmito základy budete schopni psát spolehlivé testy, které vám ušetří hodiny ladění a zvýší důvěru v kód
Začni s něčím malým. Vyber metodu, která nemá žádné vedlejší účinky, ideálně čistou funkci. Čistá funkce vrací výsledek pouze na základě svých argumentů a nemění žádný stav. Typicky to je matematická operace, formátování textu nebo dat. Dej si pozor na metody, které čtou čas, generují náhodná čísla nebo přistupují k souborům. Tyto metody vyžadují mockování a injektování závislostí, což je pro první test zbytečně složité. Tvůj cíl je jednoduchý: ověřit, že funkce vrací očekávanou hodnotu pro konkrétní vstup.
Při psaní testu se řiď vzorem Arrange-Act-Assert, česky uspořádej-proveď-ověř. Nejdřív připrav testovací data, pak zavolej testovanou metodu a nakonec porovnej výsledek s očekávanou hodnotou. Například u funkce pro výpočet obvodu kruhu bys mohl použít vstup poloměr 5 a očekávat výsledek přibližně 31,4159. Nezapomeň na zaokrouhlení, protože práce s desetinnými čísly může způsobit malé odchylky. Raději porovnávej s tolerancí, než abys spoléhal na přesnou shodu. Tento vzor udržuje test čitelný a každý řádek má jasný účel.
Pro většinu projektů je Express rozumnou volbou. Jeho hlavní výhodou je bohatý ekosystém
middleware a jednoduchá definice cest. Začněte s minimálním nastavením: vytvořte instanci aplikace a nadefinujte základní trasy. Kolem každé trasy byste měli mít jasnou strukturu – rozdělte kód na kontrolery, služby a modely. Častou chybou začátečníků je psát veškerou logiku přímo do obsluhy trasy, což vede k obřímu souboru, který se špatně testuje a udržuje.
Častou chybou je odhadovat pouze podle „čistého" času, který byste potřebovali, kdyby vše proběhlo hladce. Realita ale vypadá jinak. Přidejte rezervu na hledání chyb, na nejasné požadavky a na komunikaci. Zkušení vývojáři často používají pravidlo, že k hrubému odhadu přidají 30–50 % času na skryté činnosti. Není to univerzální vzorec, ale dobrý startovní bod, který pak upravíte podle konkrétního projektu.
Nakonec si ověřte své odhady na minulých úkolech. Když dokončíte práci, porovnejte odhad se skutečností a zapište si, co způsobilo rozdíl. Po pár iteracích získáte data, která vám umožní odhadovat přesněji. Skryté činnosti nezmizí, ale naučíte se je předvídat – a to je klíč k tomu, aby vaše odhady byly konečně realistické.
