CycleMantle
Workflows

Schritt-für-Schritt: Deine erste Testdaten-Datei erstellen

03
Fixture in einer Minute

Vom leeren Ordner zum grünen Testlauf

Du hast eine PHP-Funktion zur Berechnung von Bestellsummen und möchtest sie mit verschiedenen Eingaben prüfen. CycleMantle fungiert als Daten-Generator: Er erstellt eine JSON-Datei mit erfundenen Bestellungen und schreibt anschließend die Prüfungen, die diese Datei lesen. Es werden keine echten Kundendaten kopiert. Bei einem Cloud-Modell werden deine Eingabeaufforderung und der Text der Datei an den Anbieter gesendet; bei einem lokalen Modell bleibt alles auf deinem PC. Plane mit etwa vier kurzen Chat-Nachrichten: Ordner öffnen, nach den Datensätzen fragen, nach den Prüfungen fragen und diese ausführen. Jede Nachricht erzeugt Karten, die du lesen, akzeptieren oder ablehnen kannst, bevor die nächste beginnt. Lies die Karten von oben nach unten: Jede nennt ein Tool, die verwendete Datei oder den Befehl sowie das erzielte Ergebnis. Wenn du lieber erst lesen möchtest, bevor etwas ausgeführt wird, starte den Chat im Modus Plan only und wechsle nach dem Lesen des Plans zu Ask first.

01

Projektordner öffnen

Starte die App, wähle den Ordner mit deinem PHP-Code und wähle Ask first als Genehmigungsmodus, damit jede Änderung auf deine Freigabe wartet. Du kannst den Modus jederzeit später ändern, zum Beispiel zu Auto-run, sobald du den Schritten vertraust.

02

Nach erfundenen Datensätzen fragen

Beschreibe die benötigten Felder, wie Name, Datum und Betrag, und fordere eine JSON-Datei mit erfundenen Zeilen an. Gib an, wie viele Zeilen du möchtest. Halte jeden Namen, jede Adresse und jeden Betrag eindeutig fiktiv, damit niemand eine Zeile mit einer echten Person verwechselt.

03

Nach den Prüfungen fragen

Fordere ein kleines Skript an, das die JSON-Datei liest und bekannte Eingaben mit erwarteten Ausgaben vergleicht. Nenne die Funktion, die getestet werden soll. Bitte den Agenten, jede Prüfung in einem Satz zu erklären, damit du weißt, was er damit erfassen möchte.

04

Überprüfen und ausführen

Lies den Diff, akzeptiere ihn und lass Shell deinen Testbefehl ausführen. Lies dann den Exit-Code und erweitere die Karte, um die Ausgabe zu sehen. Wenn eine Prüfung fehlschlägt, bitte den Agenten, den Fehler zu erklären, bevor er etwas ändert.

Ein kleines Testskript zum Starten

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

Eine einfache Funktion und vier Assert-Prüfungen mit bekannten Eingaben und Ergebnissen. Es wird keine Datenbank, kein Netzwerk und keine Geheimnisse verwendet. Später kann der Agent die festen Zahlen durch Zeilen aus deiner JSON-Datei ersetzen, und die Prüfungen behalten dieselbe Struktur. Ändere bewusst einen erwarteten Wert, um einen Fehler zu sehen. Speichere es als tests.php in deinem Projektordner, führe es mit deinem Testbefehl aus und lies den Exit-Code in der Karte, bevor du weitere Änderungen anforderst. Ändere dann einen erwarteten Wert bewusst und beobachte, wie die Karte rot wird.

Vier Aufgaben für Testdaten-Generierungstools

Die Beispieldatensätze schreiben

Viele fragen, wie man Testdaten schneller generiert als von Hand. Beschreibe die gewünschte Struktur und lass den Agenten sie schreiben: eine JSON-Datei mit 3 erfundenen Kunden, jeweils mit Name, Registrierungsdatum und Bestellbetrag. Unter den Tools zur Testdatengenerierung ist eine einfache Datei in deinem Projekt am einfachsten zu lesen und später zu ändern, da der Diff jeden Wert zeigt. glob und list_dir zeigen, wo bereits Fixtures liegen, damit die neue Datei neben den anderen landet. Öffne die Karte, prüfe, dass jeder Wert eindeutig erfunden ist, und korrigiere ungewöhnliche Zeilen manuell, bevor du akzeptierst. Verwende reservierte Beispiel-Domains für E-Mails. Bitte um eine Handvoll Zeilen, nicht um Hunderte, damit du jede lesen kannst. Schreibe Daten in einem festen Format, damit jede Zeile gleich aussieht.

Prüfungen schreiben, die die Datei lesen

Fordere ein Skript an, das die JSON lädt und pro Zeile ein Ergebnis prüft. Der Agent öffnet deine Quelle mit read_file, findet die Funktion mit grep und schlägt die Testdatei als Diff vor. Das Mocken statischer Methoden in php ist umständlich, also bitte den Agenten, statische Aufrufe aufzulisten, bevor er etwas schreibt, und halte diese Aufrufe hinter einer kleinen Funktion, die ein Test ersetzen kann. Ask first hält die Änderung an, bis du sie akzeptierst. Lies jede Assertion und frage, ob sie fehlschlagen würde, wenn die Funktion falsch wäre. Lehne jede Prüfung ab, die nur den zu testenden Code wiederholt. Füge dann eine Zeile hinzu, die bewusst fehlschlagen soll. Wenn der Agent nicht weiß, welche Funktion du meinst, nenne sie in der Eingabeaufforderung und erwähne die Datei. Halte ein Konzept pro Test.

Tests ausführen und den Exit-Code lesen

Shell führt deinen Testbefehl in der gewählten Umgebung aus, z. B. lokales Windows, WSL oder SSH zu einem eigenen Server. Die Karte zeigt den tatsächlichen Exit-Code, und ein Null-Exit-Code bedeutet, dass alle Prüfungen bestanden wurden, während jeder andere Wert einen Fehler bedeutet. Erweitere die Karte, um die Ausgabe zeilenweise zu lesen. Wenn etwas fehlschlägt, liest der Agent die Meldung und schlägt eine Korrektur als Diff vor. Akzeptiere eine Korrektur nicht nur, weil der Lauf grün wird. Prüfe zuerst den erwarteten Wert im Test. Wenn ein zweiter Fehler folgt, bitte den Agenten, den ersten zu erklären, bevor er erneut editiert. Plan only ist ein guter erster Durchlauf, wenn der Befehl für dich neu ist, da der Agent dann einen Plan schreibt und nichts ausführt.

Entscheiden, welcher Code getestet werden muss

Wenn die Tests bestanden sind, führe deinen Coverage-Befehl aus und lass den Agenten den Bericht lesen. Teams diskutieren, ob Infrastrukturcode in die Code-Coverage einbezogen werden soll, und die sinnvolle Antwort ist, sich vorher darauf zu einigen, bevor die Zahl zum Ziel wird. Einige Teams verlangen auch eine obligatorische Testabdeckung für kritische Methoden, wie Preis- oder Berechtigungsprüfungen. Bitte den Agenten, diese Methoden mit grep aufzulisten und Tests für die erste vorzuschlagen. Überprüfe den Diff, führe die Tests erneut aus und stoppe, wenn die kritischen Pfade abgedeckt sind. Schreibe auf, welche Ordner du gezählt hast, damit die Zahl nächsten Monat dasselbe bedeutet. Bitte den Agenten, die Liste der gezählten Ordner in eine Textdatei in deinem Projekt zu schreiben, und lies den Diff, bevor du ihn akzeptierst.

CycleMantle für Windows

Erstelle heute deine erste Fixture

CycleMantle herunterladen ↗