CycleMantle
Pracovní postupy

Průvodce generátorem dat pro váš první testovací soubor

03
Fixtura za minutu

Od prázdné složky k zelenému běhu testů

Máte PHP funkci, která formátuje celkovou částku objednávky, a chcete ji otestovat na několika vstupech. CycleMantle funguje jako generátor dat: napíše JSON soubor s vymyšlenými objednávkami a následně vytvoří kontroly, které ho čtou. Nic se nekopíruje ze skutečných zákazníků. Při použití cloudového modelu se váš prompt a text souboru, které agent čte, odesílají poskytovateli; při lokálním modelu nic neopustí váš počítač. Počítejte s přibližně čtyřmi krátkými zprávami v chatu: otevřete složku, požádejte o záznamy, požádejte o kontroly a spusťte je. Každá zpráva vygeneruje karty, které můžete přečíst, přijmout nebo zamítnout před zahájením dalšího kroku. Čtěte karty shora dolů: každá uvádí nástroj, soubor nebo příkaz, který použila, a dosažený výsledek. Pokud preferujete čtení před spuštěním čehokoli, začněte chat v režimu Plan only a přepněte na Ask first po přečtení plánu.

01

Otevřete složku projektu

Spusťte aplikaci, vyberte složku s vaším PHP kódem a jako režim schvalování zvolte Ask first, aby každá změna čekala na vaše potvrzení. Režim můžete kdykoli později přepnout, například na Auto-run, jakmile budete mít důvěru v kroky.

02

Požádejte o vymyšlené záznamy

Popište pole, která potřebujete, například jméno, datum a částku, a požádejte o JSON soubor s vymyšlenými řádky. Uveďte, kolik řádků chcete. Udržujte každé jméno, adresu a částku zjevně fiktivní, aby si nikdo nemyslel, že jde o skutečnou osobu.

03

Požádejte o kontroly

Požádejte o malý testovací skript, který načte JSON soubor a porovná známé vstupy s očekávanými výstupy. Uveďte funkci, kterou má otestovat. Požádejte agenta, aby každou kontrolu vysvětlil v jedné větě, abyste věděli, co má zachytit.

04

Zkontrolujte a spusťte

Přečtěte si diff, přijměte ho a nechte Shell spustit příkaz testu. Poté si přečtěte exit code a rozbalte kartu pro zobrazení výstupu. Pokud kontrola selže, požádejte agenta o vysvětlení selhání předtím, než cokoliv změní.

Malý testovací skript, od kterého můžete začít

tests.php
<?php
function discount(int $cents, int $percent): int {
    return intdiv($cents * (100 - $percent), 100);
}
assert(discount(1000, 0) === 1000);
assert(discount(1000, 10) === 900);
assert(discount(0, 50) === 0);
assert(discount(999, 100) === 0);
echo 'All checks ran';

Jedna jednoduchá funkce a čtyři assert kontroly se známými vstupy a výsledky. Nepoužívá databázi, síť ani tajná data. Později může agent nahradit pevná čísla řádky z vašeho JSON souboru a kontroly zůstanou stejné. Záměrně změňte jednu očekávanou hodnotu, abyste viděli selhání. Uložte ji jako tests.php ve složce projektu, spusťte ji svým testovacím příkazem a přečtěte exit code v kartě, než požádáte o cokoliv dalšího. Poté záměrně změňte jednu očekávanou hodnotu a sledujte, jak karta zčervená.

Čtyři úkoly pro nástroje generování testovacích dat

Napište ukázkové záznamy

Mnoho lidí se ptá, jak generovat testovací data rychleji než ručně. Popište požadovaný tvar a nechte agenta, aby ho napsal: JSON soubor se 3 vymyšlenými zákazníky, každý s jménem, datem registrace a částkou objednávky. Mezi nástroji pro generování testovacích dat je běžný soubor ve vašem projektu nejjednodušší na čtení a pozdější úpravy, protože diff ukazuje každou hodnotu. glob a list_dir ukazují, kde fixtury již existují, takže nový soubor vznikne vedle ostatních. Otevřete kartu, zkontrolujte, zda jsou všechny hodnoty zjevně vymyšlené, a upravte podezřelé řádky ručně před přijetím. Pro e-maily používejte vyhrazené domény pro příklady. Požádejte o několik řádků, ne o stovky, abyste mohli přečíst každý jeden. Pište data ve stejném pevném formátu, aby každý řádek vypadal stejně.

Napište kontroly, které čtou soubor

Požádejte o skript, který načte JSON a zkontroluje jeden výsledek na řádek. Agent otevře váš zdroj pomocí read_file, najde funkci pomocí grep a navrhne testovací soubor jako diff. Mockování statických metod v php je složité, takže požádejte agenta, aby před psaním vyjmenoval statické volání, a ponechte tato volání za malou funkcí, kterou test může nahradit. Ask first pozastaví změnu, dokud ji nepřijmete. Přečtěte si každou assertaci a zeptejte se, zda by selhala, kdyby byla funkce špatná. Zamítněte jakoukoli kontrolu, která pouze opakuje kód, který testuje. Poté přidejte jeden řádek, který by měl záměrně selhat. Pokud agent nemůže určit, kterou funkci myslíte, uveďte ji v promptu a zmíněte soubor. Udržujte jeden koncept v každém testu.

Spusťte testy a přečtěte exit code

Shell spustí váš testovací příkaz v prostředí, které jste vybrali, například lokální Windows, WSL nebo SSH na server, který vlastníte. Karta zobrazuje skutečný exit code a nula znamená, že všechny kontroly prošly, zatímco jakákoli jiná hodnota znamená selhání. Rozbalte kartu a čtěte výstup řádek po řádku. Pokud něco selže, agent přečte zprávu a navrhne opravu jako diff. Neacceptujte opravu jen proto, že běh zelená. Nejprve zkontrolujte očekávanou hodnotu v testu. Pokud následuje druhé selhání, požádejte agenta o vysvětlení prvního selhání před další úpravou. Plan only je dobrý první průchod, pokud je příkaz pro vás nový, protože agent pak napíše plán a nic nespustí.

Rozhodněte, který kód potřebuje test

Jakmile testy projdou, spusťte příkaz pro pokrytí kódu a nechte agenta přečíst zprávu. Týmy se přou, zda zahrnout infrastrukturní kód do pokrytí kódu, a rozumnou odpovědí je dohodnout se na tom, než se číslo stane cílem. Některé týmy také vyžadují povinné pokrytí testy pro kritické metody, jako jsou kontroly ceny nebo oprávnění. Požádejte agenta, aby tyto metody vyjmenoval pomocí grep a navrhl testy pro první z nich. Zkontrolujte diff, spusťte testy znovu a zastavte se, když jsou pokryty kritické cesty. Zapište si, které složky jste započítali, aby číslo v příštím měsíci znamenalo totéž. Požádejte agenta, aby seznam započítaných složek uložil do obyčejného textového souboru ve vašem projektu, a přečtěte diff před jeho přijetím.

CycleMantle pro Windows

Vygenerujte svou první fixuru ještě dnes

Stáhnout CycleMantle ↗