Jak rozchodit první REST API bez zbytečných chyb

Každý merge commit, který se objeví v historii, přináší do logu šum. Místo jasné linky vývoje vidíte zbytečné větvení, které vzniklo jen tím, že dva lidé pracovali ve stejnou chvíli. Pokud chcete, aby historie vyprávěla příběh změn, ne příběh spolupráce, vyplatí se ji udržovat lineární. Nejde o dogma, ale o praktickou úsporu času při review, hledání chyb i při samotném čtení logu.

Základem je především šablony. Většina e-mailových klientů umožňuje uložit text, který používáte opakovaně – ať už jde o potvrzení objednávky, odpověď na častý dotaz nebo žádost o zaslání podkladů. Místo psaní od začátku jen vyberete šablonu a upravíte několik polí. Důležité je šablony průběžně aktualizovat, aby odpovídaly aktuálním procesům. Častou chybou je vytvoření šablony jednou a pak její používání bez kontroly, což vede k zasílání zastaralých informací. Pravidelná revize jednou za měsíc zabere pět minut a vyhnete se tak nedorozuměním.

Pozor na to, abyste rebase nepoužívali na větvích, které jsou součástí dlouhodobého vývoje, jako je main nebo release. Ty by měly zůstat stabilní a jejich historie by se neměla měnit. Pro feature větve je rebase standard. Pokud váš tým používá GitHub, zapněte v nastavení repozitáře možnost „merge squashe" nebo „rebase merge" jako výchozí. Tím zabráníte tomu, aby se do hlavní větve dostaly merge commity omylem.

Jak si uspořit čas při psaní odpovědí? Třetí nástroj, který výrazně zrychlí práci, je textový expandér. Tento program nahrazuje zkratky za celé věty – stačí napsat krátký kód, třeba „pd" pro „přílohu naleznete v přiloženém souboru", a program text sám rozbalí. Své využití najde nejen v e-mailu, ale i v jiných aplikacích. Při nastavování mějte na paměti, že zkratky by měly být snadno zapamatovatelné a neměly by se překrývat s běžnými slovy. Častým problémem je, že si lidé vytvoří příliš mnoho zkratek a pak si je nepamatují. Vyberte si deset nejčastějších frází a postupně přidávejte další.

Když chcete mít historii opravdu čistou, využijte git rebase -i (interaktivní rebase). Umožní vám sloučit drobné commity do jednoho, přejmenovat je nebo změnit jejich pořadí. Typický workflow: pracujete na funkci, děláte menší commity jako „oprava překlepu", „přidání testu", „úprava stylu". Před začleněním je sloučíte do jednoho logického celku. Tím se historie stává srozumitelnější a každý commit představuje jednu dokončenou změnu.

Nejdříve si připravte všechny suroviny. Na 250 ml vody použijte 80 g másla nebo oleje, špetku soli a 150 g hladké mouky. Vodu s tukem a solí přiveďte k varu, poté vsypte mouku najednou a důkladně míchejte, dokud se těsto nezačne oddělovat od stěny hrnce a nevytvoří hladkou kouli. Tento okamžik je zásadní – pokud těsto nedostatečně zapaříte, bude málo pružné a věnečky se při pečení roztečou. Vařte ho ještě asi dvě minuty, dokud se na dně neobjeví tenký povlak.

Dalším krokem je určení hmotnosti a spánkových návyků. Podle toho se rozhodnete pro počet lamel. Levnější rošty mají 13 až 17 lamel, což stačí pro menší hmotnost do zhruba 70 kilogramů. Pokud vážíte více, volte rošt s minimálně 22 lamelami, ideálně 28. Více lamel znamená lepší rozložení tlaku a menší prohýbání v oblasti pánve. U těžších osob navíc hrozí, že příliš měkký rošt ohne matraci do tvaru písmene V, což vede k přetížení bederní páteře. Pro páry je důležité zkontrolovat nosnost roštu – udává se obvykle na štítku, ale pozor na to, že se jedná o maximální hodnotu pro celou plochu, ne pro každou polovinu zvlášť.

Při psaní prvního API se také vyplatí používat nástroj na testování, než začnete psát frontend. Pošlete si jednoduchý požadavek na váš endpoint a podívejte se, co vám server vrátí. Tím odhalíte chyby v kódu rychleji, než kdybyste ladili přes prohlížeč. A když něco nefunguje, začněte od konce – zkontrolujte, jestli server vůbec běží, jestli je adresa správně, jestli máte správnou metodu a jestli jste nezapomněli na autorizaci. Tahle jednoduchá kontrola vám ušetří hodiny hledání.

Při zařizování myslete na to, co dělá předsíň „malou" – obvykle jsou to přeplněné věšáky, boty na zemi a nábytek, který blokuje průchod. Zavěste věšák ve výši očí, ideálně s policí nad ním, a boty umístěte do uzavřené skříňky s posuvnými dveřmi. Vyhněte se hlubokému nábytku – úzká konzola nebo plovoucí police zabere méně místa než masivní skříň. Pokud potřebujete sedátko, volte úzkou lavici s úložným prostorem, kterou lze zasunout pod konzoli. Cirkulace vzduchu a volná podlaha jsou důležitější než dekorace.