Tests uitvoeren
Shell voert je testcommando uit, en de kaart toont de echte exitcode en de volledige uitvoer.
Een mock API is een vervanger voor een echte service: deze geeft vaste antwoorden uit een bestand, zodat je tests bij elke run hetzelfde gedrag vertonen. CycleMantle schrijft dat bestand, maakt nep-voorbeeldrecords en voert je testcommando uit vanuit de chat terwijl je elke stap volgt. Jij beslist welke voorstellen van de agent naar je project gaan.
Shell voert je testcommando uit, en de kaart toont de echte exitcode en de volledige uitvoer.
write_file en edit_file stellen tests en fixtures voor als een diff die je accepteert of afwijst.
read_file en grep openen rapporten en logs, zodat de agent de nog niet geteste regels kan aanwijzen.
Je beschrijft de taak in de chat. De agent leest je code, voert commando's uit en toont elk resultaat als een kaart, en wacht daarna op je beslissing voordat er iets verandert in Ask first. Plan only komt eerst als je de stappen wilt lezen voordat ze worden uitgevoerd. Elke kaart blijft in de chat, zodat je terug kunt scrollen en ziet wat er is uitgevoerd.
src/RateClient.phploadedtests/fixtures/rates.jsonsavedtests/RateClientTest.phpsavedyour test commandexit 0rates.json2 matchestests/RateClientTest.phpdiff shownJe klasse vraagt een wisselkoersservice om een getal, en de test mag niet afhankelijk zijn van een live server. Vraag de agent om een mock API: read_file laadt de clientklasse, write_file slaat tests/fixtures/rates.json op met vaste antwoorden, en edit_file wijzigt de test zodat deze dat bestand leest in plaats van externe calls te doen. Het aanroepen van echte functies in de setup van een unit test maakt een test afhankelijk van code die je niet bedoelde te controleren, dus houd de fixture klein en noem deze naar de call die hij vervangt. Ask first toont de diff voordat er iets wordt opgeslagen. Accepteer het, laat Shell je testcommando uitvoeren en lees de exitcode. Vouw de kaart daarna uit om te bevestigen dat de antwoorden in de uitvoer de nep-antwoorden zijn. Als de uitvoer een echt serveradres toont, stop dan en corrigeer de test.
Voor een rapportklasse heb je misschien 3 gebruikers nodig met namen, data en bedragen. Testgegevensgeneratie betekent hier dat de agent een JSON-bestand van verzonnen mensen schrijft; het kopieert nooit rijen uit een echte klantenlijst. Onder de hulpmiddelen die testers gebruiken om testgegevens te genereren, is een gewoon bestand dat de agent schrijft makkelijk te controleren in een diff en makkelijk later te wijzigen. Gebruik glob om eerst bestaande fixtures te vinden, zodat het nieuwe bestand niet in conflict raakt met een naam die al in gebruik is. Open het bestand in de chat, corrigeer een vreemde waarde met de hand, voeg een rij toe met een lege naam om een randgeval te dekken, en voer de tests opnieuw uit. Houd namen duidelijk nep. Commit het bestand met je code, zodat collega's dezelfde rijen delen.
Voer je coverage-commando uit via Shell, en vraag de agent dan om het rapport te lezen met read_file. Het wijst de functies aan waarvan de regels nooit zijn uitgevoerd en stelt tests voor voor deze functies als een diff. Mensen vragen vaak wat ze moeten testen in een unit test, en het antwoord begint klein: één normale invoer, één randgeval zoals een lege lijst, en één ongeldige waarde. Accepteer de tests één voor één in plaats van allemaal tegelijk, zodat je de zwakke ones opmerkt. Een hoger cijfer bewijst nog niet dat de code correct is. Blijf sceptisch. Lees elke assertie zelf, en vraag je af of deze zou falen als de functie fout was. Voer na de laatste geaccepteerde test het commando een laatste keer uit. Herhaal dit totdat de belangrijkste bestanden tests hebben die je vertrouwt.
Wanneer een test faalt, toont de kaart de echte uitvoer van je testcommando. Vraag de agent om de test en de klasse onder test te lezen met read_file, en leg vervolgens de mismatch uit. Het kan grep gebruiken om te vinden waar een waarde wordt gebouwd en een fix voorstellen als een diff. Mensen vragen waarom mocking problemen veroorzaakt, en een antwoord is dat een nep-antwoord kan afwijken van de echte service. Vergelijk de fixture met de service die je eigen bent, accepteer de diff alleen als deze overeenkomt, en voer het commando opnieuw uit. Als dezelfde test twee keer faalt, schakel dan over naar Plan only en vraag om een uitleg voordat er verder wordt bewerkt. Houd de mislukte uitvoer aan totdat de fix is geaccepteerd.
CycleMantle is geen gehoste service of een plugin. Het is bedoeld voor je eigen bestanden, je eigen pc en servers die je mag gebruiken, en jij beslist welke mappen, commando's en servers de agent mag aanraken, omdat Shell, web en SSH niet beperkt zijn tot de werkmap. Geslaagde tests garanderen niet dat code correct is.