API gratuite pour les tests, les fixtures et l'application CycleMantle
Les bases du test
Qu'est-ce qu'une API gratuite pour les tests ?
Une API gratuite pour les tests est un service web public qui renvoie des données d'exemple, et ceux qui la recherchent veulent généralement un bac à sable pour s'entraîner. CycleMantle n'en est pas une. Il écrit des réponses fixes dans un fichier JSON que vous possédez, afin que vos tests ne dépendent jamais du serveur de quelqu'un d'autre ou de sa disponibilité aujourd'hui. Utilisez un service public uniquement si son propriétaire l'autorise.
Qu'est-ce qu'une API factice ?
Une API factice est un service de remplacement qui renvoie des données fixes et inventées au lieu de sorties réelles. Dans un projet de test, il s'agit souvent simplement d'un fichier JSON. CycleMantle peut écrire ce fichier pour vous, avec des noms, des dates et des montants inventés, et vous en montrer la différence avant toute sauvegarde dans votre dossier. Gardez-le petit. Ajoutez des lignes uniquement lorsqu'un test en a besoin.
Comment obtenir des données de test réalistes pour le développement frontend ?
La méthode la plus simple consiste à demander à l'agent un fichier JSON avec des lignes inventées qui correspondent aux champs affichés par votre page. Décrivez les colonnes, le nombre de lignes et quelques cas particuliers comme un nom vide. Lisez la différence. Modifiez toute valeur qui ne vous convient pas, et conservez le fichier dans votre projet afin que le prochain test puisse le réutiliser.
Que doit me dire un rapport de couverture ?
Un rapport de couverture est une liste des lignes ou des branches qui ont été exécutées pendant vos tests, ce qui indique le code qu'aucun test n'a touché. Les chiffres peuvent induire en erreur. Il ne peut pas dire si les vérifications étaient pertinentes, alors lisez-le comme une liste de tâches et non comme une note, et ouvrez d'abord les fonctions avec des lignes non testées. Demandez à l'agent un test à la fois.
Comment tester du code qui dépend d'un backend tardif ?
La méthode la plus simple est un fichier de fixture qui contient des réponses fixes pour chaque appel. Si vous devez simuler des points de terminaison lorsque le backend est en retard, demandez à l'agent d'écrire ce fichier et un test qui le lit. Restez honnête. Plus tard, comparez la fixture avec les réponses réelles d'un service que vous possédez, et mettez-la à jour chaque fois qu'elles changent.
Utilisation de CycleMantle
phptest.org est-il le site officiel de CycleMantle ?
Oui. Il s'agit du site officiel de CycleMantle, et le bouton de téléchargement donne la version originale de l'application, dont la somme de contrôle SHA-256 doit être comparée au manifeste publié avant de l'exécuter. Les questions et les rapports de bug passent par le bouton Send feedback dans l'application, et l'application est indépendante du projet PHP. Vous pouvez également lire le numéro de version sur la page de téléchargement, qui indique 2.9.30.
Les résultats sont-ils toujours justes ?
Non. L'agent peut mal lire le code, manquer un cas limite ou écrire un test faible, alors vous révisez chaque différence et exécutez votre commande de test vous-même en cas de doute. Les tests réussis et un taux de couverture élevé sont une preuve, pas une certitude. Ask first fait attendre chaque changement votre accord jusqu'à ce que vous l'ayez lu. Conservez votre historique de contrôle de version comme filet de sécurité.
CycleMantle peut-il exécuter ma commande de test ?
Oui. Shell exécute la commande que vous lui donnez dans l'environnement que vous avez choisi, qui peut être Windows local, WSL ou SSH vers un serveur que vous possédez. La carte affiche le code de sortie réel, et la sortie complète apparaît lorsque vous la développez. Les commandes dangereuses sont bloquées, et vous pouvez passer à Plan only à tout moment. Rien d'autre ne s'exécute à moins que vous ne le demandiez.
Comment vérifier une fonction dont la sortie change ?
La méthode la plus simple consiste à donner à la fonction une entrée connue, afin que sa sortie cesse de changer. Pour tester unitairement une fonction avec des résultats variables, comme celle qui renvoie la date actuelle ou un nombre aléatoire, demandez à l'agent de passer cette valeur en paramètre et d'écrire le test autour de celle-ci. Révisez la différence. Puis exécutez à nouveau votre commande de test.
Quelle est la différence entre Ask first et Plan only ?
Ask first est le mode qui fait une pause avant les actions qui modifient quelque chose, comme l'écriture d'un fichier, et il montre la différence à accepter. Plan only est le mode qui écrit un plan et n'exécute rien, donc aucune commande ne s'exécute et aucun fichier ne change. Les plans survivent aux redémarrages. Changez de mode lorsque vous voulez que l'agent exécute le plan.
Modèles, vie privée et téléchargement
Mes fichiers quittent-ils l'ordinateur ?
Oui, avec un modèle cloud : votre invite et le texte du fichier que lit l'agent vont à ce fournisseur. Avec un modèle local, rien ne quitte votre ordinateur. Les chats, les dossiers de travail et les clés API restent sur votre ordinateur, et l'application n'a pas de télémétrie. Vous choisissez le point de terminaison. Ce choix décide où va le texte de votre code. Les secrets dans la sortie des outils sont masqués avant d'atteindre le modèle.
Quels modèles puis-je connecter ?
Un modèle dans CycleMantle est l'IA derrière le chat, et vous pouvez connecter 3 types : un fournisseur d'IA cloud via un point de terminaison API standard, un modèle s'exécutant localement sur votre ordinateur, ou le modèle intégré, qui est prêt à l'emploi sans votre propre point de terminaison. Appuyez sur le bouton Test après avoir entré un point de terminaison pour voir le temps de réponse et la fenêtre de contexte.
Comment télécharger et vérifier l'installateur ?
La méthode la plus simple consiste à appuyer sur le bouton de téléchargement, qui donne le programme d'installation d'environ 34 Mo, puis à comparer sa somme de contrôle SHA-256 avec le manifeste publié. La page de téléchargement affiche une commande Windows pour cela. L'installateur n'est pas encore signé numériquement. Windows SmartScreen peut vous avertir, et vous continuez uniquement après que la somme de contrôle correspond. Gardez la page du manifeste ouverte pendant que vous comparez.
Ai-je besoin d'un compte pour utiliser l'application ?
Non. CycleMantle fonctionne sans compte, et son interface est disponible en 13 langues. Un fournisseur d'IA cloud peut nécessiter son propre compte et peut facturer l'utilisation, mais cela vous concerne vous et le fournisseur. Le modèle intégré est prêt à l'emploi sans votre propre point de terminaison, donc un premier test ne nécessite aucune inscription.