CycleMantle
Werkstromen

Stappenplan voor datagenerator: je eerste fixturebestand

03
Fixture in een minuut

Van een lege map naar een groene testrun

Je hebt een PHP-functie die een besteltotaal formatteert en je wilt deze controleren op verschillende invoeren. CycleMantle fungeert als datagenerator: het schrijft een JSON-bestand met verzonnen bestellingen en vervolgens de checks die dit bestand lezen. Er wordt niets gekopieerd van echte klanten. Met een cloudmodel gaan je prompt en de tekst van het bestand die de agent leest naar die provider; met een lokaal model blijft alles op je pc. Reken op ongeveer vier korte chatberichten: map openen, vragen om records, vragen om checks en ze uitvoeren. Elk bericht produceert kaarten die je kunt lezen, accepteren of afwijzen voordat de volgende begint. Lees de kaarten van boven naar beneden: elke kaart noemt een tool, het bestand of commando dat is gebruikt, en het resultaat. Als je liever eerst leest voordat er iets wordt uitgevoerd, start je de chat in Plan only en schakel je over naar Ask first nadat je het plan hebt gelezen.

01

Open de projectmap

Start de app, kies de map met je PHP-code en kies Ask first als goedkeuringsmodus, zodat elke wijziging op jou wacht. Je kunt de modus later altijd wijzigen, bijvoorbeeld naar Auto-run zodra je de stappen vertrouwt.

02

Vraag om verzonnen records

Beschrijf de velden die je nodig hebt, zoals naam, datum en bedrag, en vraag om een JSON-bestand met verzonnen rijen. Geef aan hoeveel rijen je wilt. Zorg dat elke naam, adres en bedrag duidelijk nep is, zodat niemand een rij verwarst met een echt persoon.

03

Vraag om de checks

Vraag om een klein testscripth dat het JSON-bestand leest en bekende invoeren vergelijkt met verwachte uitvoeren. Noem de functie die moet worden getest. Vraag de agent om elke check in één regel uit te leggen, zodat je weet wat het moet vangen.

04

Beoordeel en voer uit

Lees de diff, accepteer hem en laat Shell je testcommando uitvoeren. Lees vervolgens de exitcode en vouw de kaart uit om de uitvoer te zien. Als een check faalt, vraag de agent dan om de fout te verklaren voordat hij iets bewerkt.

Een klein testscripth om mee te beginnen

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';

Een eenvoudige functie en vier assert-checks met bekende invoeren en resultaten. Er wordt geen database, netwerk of geheimen gebruikt. Later kan de agent de vaste cijfers vervangen door rijen uit je JSON-bestand, en behouden de checks dezelfde structuur. Verander opzettelijk één verwachte waarde om een fout te zien. Sla het op als tests.php in je projectmap, voer het uit met je testcommando en lees de exitcode in de kaart voordat je meer vraagt. Verander vervolgens opzettelijk één verwachte waarde en kijk hoe de kaart rood wordt.

Vier taken voor hulpmiddelen voor testgegevensgeneratie

Schrijf de voorbeeldrecords

Veel mensen vragen zich af hoe ze sneller testgegevens kunnen genereren dan met de hand. Beschrijf de gewenste structuur en laat de agent deze schrijven: een JSON-bestand met 3 verzonnen klanten, elk met een naam, een registratiedatum en een bestelbedrag. Onder hulpmiddelen voor testgegevensgeneratie is een plat bestand in je project het makkelijkst om te lezen en later te wijzigen, omdat de diff elke waarde laat zien. glob en list_dir tonen waar fixtures al leven, zodat het nieuwe bestand naast de anderen komt. Open de kaart, controleer of elke waarde duidelijk verzonnen is en bewerk rare rijen met de hand voordat je accepteert. Gebruik gereserveerde voorbeelddomeinen voor e-mailadressen. Vraag om een handvol rijen, niet honderden, zodat je er elke kunt lezen. Schrijf datums in één vast formaat zodat elke rij hetzelfde leest.

Schrijf checks die het bestand lezen

Vraag om een script dat de JSON laadt en één resultaat per rij controleert. De agent opent je broncode met read_file, zoekt de functie met grep en stelt het testsbestand voor als een diff. Het mocken van statische methoden in php is lastig, dus vraag de agent om statische aanroepen op te sommen voordat hij iets schrijft, en houd die aanroepen achter een kleine functie die een test kan vervangen. Ask first houdt de wijziging vast tot je hem accepteert. Lees elke assertie en vraag of deze zou falen als de functie fout was. Wijs elke check af die alleen de code herhaalt die hij test. Voeg vervolgens één rij toe die opzettelijk zou moeten falen. Als de agent niet kan zeggen welke functie je bedoelt, noem deze dan in de prompt en vermeld het bestand. Houd één concept per test.

Voer de tests uit en lees de exitcode

Shell voert je testcommando uit in de omgeving die je hebt gekozen, zoals lokaal Windows, WSL of SSH naar een server die je bezit. De kaart toont de echte exitcode, en een nul exitcode betekent dat elke check is geslaagd, terwijl elke andere waarde een fout betekent. Vouw de kaart uit om de uitvoer regel voor regel te lezen. Als er iets faalt, leest de agent het bericht en stelt hij een oplossing voor als een diff. Accepteer een oplossing niet alleen omdat de run groen wordt. Controleer eerst de verwachte waarde in de test. Als er een tweede fout volgt, vraag de agent dan om de eerste te verklaren voordat hij opnieuw bewerkt. Plan only is een goede eerste pass als het commando nieuw voor je is, omdat de agent dan een plan schrijft en niets uitvoert.

Bespreek welke code een test nodig heeft

Zodra de tests slagen, voer je je coverage-commando uit en laat de agent het rapport lezen. Teams discussiëren erover of infrastructuurcode moet worden opgenomen in code coverage, en het verstandige antwoord is om hierover afspraken te maken voordat het cijfer een doel wordt. Sommige teams eisen ook verplichte testcoverage voor kritieke methoden, zoals prijs- of toegangscontroles. Vraag de agent om deze methoden op te sommen met grep en tests voor de eerste voor te stellen. Beoordeel de diff, voer de tests opnieuw uit en stop wanneer de kritieke paden gedekt zijn. Noteer welke mappen je hebt meegeteld, zodat het cijfer volgende maand hetzelfde betekent. Vraag de agent om de lijst van meegetelde mappen in een plat tekstbestand in je project te zetten en lees de diff voordat je hem accepteert.

CycleMantle voor Windows

Genereer vandaag je eerste fixture

CycleMantle downloaden ↗