Guide pas à pas pour votre premier fichier de fixtures
03
Fixture en une minute
D'un dossier vide à un test vert
Vous avez une fonction PHP qui formate le total d'une commande et vous voulez la tester avec plusieurs entrées. CycleMantle agit comme générateur de données : il écrit un fichier JSON de commandes inventées, puis génère les vérifications qui le lisent. Rien n'est copié depuis de vrais clients. Avec un modèle cloud, votre invite et le texte du fichier lus par l'agent sont envoyés à ce fournisseur ; avec un modèle local, rien ne quitte votre PC. Prévoyez environ quatre courts messages : ouvrez le dossier, demandez les données, demandez les vérifications, et lancez-les. Chaque message produit des cartes que vous pouvez lire, accepter ou rejeter avant le prochain. Lisez les cartes de haut en bas : chacune nomme un outil, le fichier ou la commande utilisée, et le résultat obtenu. Si vous préférez lire avant toute exécution, lancez le chat en Plan only et passez à Ask first après avoir lu le plan.
01
Ouvrez le dossier du projet
Lancez l'application, choisissez le dossier contenant votre code PHP et sélectionnez Ask first comme mode d'approbation, afin que chaque modification attende votre validation. Vous pouvez changer de mode plus tard, par exemple en Auto-run une fois que vous avez confiance dans les étapes.
02
Demandez des données fictives
Décrivez les champs dont vous avez besoin, comme le nom, la date et le montant, et demandez un fichier JSON de lignes inventées. Précisez le nombre de lignes souhaité. Gardez chaque nom, adresse et montant clairement fictifs, pour qu'on ne confonde pas une ligne avec une vraie personne.
03
Demandez les vérifications
Demandez un petit script de test qui lit le fichier JSON et compare des entrées connues avec des sorties attendues. Nommez la fonction à tester. Demandez à l'agent d'expliquer chaque vérification en une ligne, pour que vous sachiez ce qu'il doit détecter.
04
Examinez et lancez
Lisez le diff, acceptez-le, et laissez Shell exécuter votre commande de test. Lisez ensuite le code de sortie et développez la carte pour voir le résultat. Si une vérification échoue, demandez à l'agent d'expliquer l'échec avant qu'il ne modifie quoi que ce soit.
Un petit script de test pour commencer
CycleMantle · Fixture et vérifications● Ask first
Écrivez tests/orders.json avec 3 commandes fictives et un script qui vérifie la fonction de remise.
write_filetests/orders.jsonsaved
write_filetests.phpsaved
Shellyour test commandexit 0
read_filetests.phploaded
en attente de votre validation avant l’étape suivanteRejeterAccepter
Une fonction simple et quatre assertions avec des entrées et des résultats connus. Il n'utilise ni base de données, ni réseau, ni secrets. Plus tard, l'agent pourra remplacer les nombres fixes par des lignes de votre fichier JSON, et les vérifications garderont la même structure. Modifiez volontairement une valeur attendue pour voir un échec. Enregistrez-le sous tests.php dans votre dossier de projet, exécutez-le avec votre commande de test, et lisez le code de sortie dans la carte avant de demander quoi que ce soit d'autre. Ensuite, modifiez volontairement une valeur attendue et regardez la carte devenir rouge.
Quatre tâches pour les outils de génération de données de test
Écrivez les données d'exemple
Beaucoup se demandent comment générer des données de test plus vite qu'à la main. Décrivez la structure souhaitée et laissez l'agent les écrire : un fichier JSON avec 3 clients inventés, chacun avec un nom, une date d'inscription et un montant de commande. Parmi les outils de génération de données de test, un fichier simple dans votre projet est le plus facile à lire et à modifier plus tard, car le diff montre chaque valeur. glob et list_dir montrent où les fixtures existent déjà, pour que le nouveau fichier se place à côté des autres. Ouvrez la carte, vérifiez que chaque valeur est clairement inventée, et modifiez les lignes étranges à la main avant d'accepter. Utilisez des domaines réservés pour les exemples d'emails. Demandez une poignée de lignes, pas des centaines, pour pouvoir tout lire. Écrivez les dates dans un format fixe pour que chaque ligne soit lisible de la même manière.
Écrivez des vérifications qui lisent le fichier
Demandez un script qui charge le JSON et vérifie un résultat par ligne. L'agent ouvre votre source avec read_file, trouve la fonction avec grep, et propose le fichier de test en diff. Le mock de méthodes statiques en php est délicat, alors demandez à l'agent de lister les appels statiques avant qu'il n'écrive quoi que ce soit, et gardez ces appels derrière une petite fonction qu'un test peut remplacer. Ask first retient le changement jusqu'à votre acceptation. Lisez chaque assertion et demandez si elle échouerait si la fonction était fausse. Rejetez toute vérification qui ne fait que répéter le code qu'elle teste. Ajoutez ensuite une ligne qui devrait échouer volontairement. Si l'agent ne peut pas dire quelle fonction vous voulez dire, nommez-la dans l'invite et mentionnez le fichier. Gardez un concept par test.
Lancez les tests et lisez le code de sortie
Shell exécute votre commande de test dans l'environnement que vous avez choisi, comme Windows local, WSL ou SSH vers un serveur que vous possédez. La carte affiche le vrai code de sortie, et un code de sortie zéro signifie que toutes les vérifications ont réussi tandis que toute autre valeur signifie un échec. Développez la carte pour lire le résultat ligne par ligne. Si quelque chose échoue, l'agent lit le message et propose une correction en diff. N'acceptez pas une correction juste parce qu'elle rend le run vert. Vérifiez d'abord la valeur attendue dans le test. Si un deuxième échec suit, demandez à l'agent d'expliquer le premier avant qu'il ne modifie à nouveau. Plan only est un bon premier passage si la commande est nouvelle pour vous, car l'agent écrit alors un plan et n'exécute rien.
Décidez quel code a besoin d'un test
Une fois les tests passés, exécutez votre commande de couverture et laissez l'agent lire le rapport. Les équipes débattent s'il faut inclure le code d'infrastructure dans la couverture de code, et la réponse sensée est de s'y accorder avant que le chiffre ne devienne un objectif. Certaines équipes exigent aussi une couverture de test obligatoire pour les méthodes critiques, comme les vérifications de prix ou de permissions. Demandez à l'agent de lister ces méthodes avec grep et proposez des tests pour la première. Examinez le diff, lancez les tests à nouveau, et arrêtez quand les chemins critiques sont couverts. Notez les dossiers que vous avez comptés, pour que le chiffre du mois prochain signifie la même chose. Demandez à l'agent de mettre la liste des dossiers comptés dans un fichier texte simple dans votre projet, et lisez le diff avant d'accepter.