Analyseur de couverture de tests
Cette compétence aide à identifier les lacunes dans la couverture de tests et suggère des cas de test spécifiques pour améliorer la qualité du code.
Quand utiliser cette compétence
- L'utilisateur demande d'analyser la couverture de tests
- L'utilisateur souhaite améliorer la couverture de tests
- L'utilisateur demande des suggestions de tests manquants
- Travail sur l'augmentation du pourcentage de couverture de code
- L'utilisateur mentionne « lacunes de couverture », « code non testé » ou « suggestions de tests »
Instructions
1. Détection du framework de test
Identifier le(s) framework(s) de test utilisés dans le projet :
JavaScript/TypeScript :
- Jest :
jestdans package.json oujest.config.js - Mocha :
mochadans package.json ou.mocharc - Vitest :
vitestdans package.json ouvitest.config.js - Jasmine :
jasminedans package.json
Python :
- pytest :
pytestdans requirements.txt oupytest.ini - unittest : Bibliothèque standard, rechercher les fichiers de test
- coverage.py :
coveragedans requirements.txt
Ruby :
- RSpec :
rspecdans Gemfile - Minitest : Bibliothèque standard
Go :
- Intégré :
go test(couverture viago test -cover)
Java :
- JUnit : Rechercher JUnit dans pom.xml ou build.gradle
- JaCoCo : Configuration de l'outil de couverture
Utiliser Glob et Grep pour trouver les fichiers de configuration.
2. Localiser les rapports de couverture
Trouver les rapports de couverture existants :
Emplacements courants :
- Répertoire
coverage/ .nyc_output/(NYC pour Node.js)htmlcov/(coverage.py pour Python)target/site/jacoco/(JaCoCo pour Java)- Fichiers de couverture :
lcov.info,coverage.json,.coverage
Si aucun rapport de couverture n'existe :
- Guider l'utilisateur pour exécuter la couverture :
npm test -- --coverage,pytest --cov, etc. - Attendre la génération du rapport avant d'analyser
3. Analyser les données de couverture
Extraire les informations de couverture :
À partir de lcov.info :
- Lignes couvertes vs total
- Fonctions couvertes vs total
- Branches couvertes vs total
- Numéros de lignes non couvertes par fichier
À partir de coverage.json (Jest) :
- Pourcentage de couverture des instructions
- Pourcentage de couverture des branches
- Pourcentage de couverture des fonctions
- Pourcentage de couverture des lignes
- Lignes non couvertes par fichier
À partir de .coverage (Python) :
- Utiliser
coverage reportoucoverage json - Plages de lignes manquantes
- Lignes exclues
À partir des rapports HTML :
- Lire les statistiques récapitulatives
- Identifier les fichiers avec une faible couverture
4. Identifier les lacunes de couverture
Prioriser les fichiers/fonctions nécessitant des tests :
Haute priorité :
- Logique métier avec 0 % de couverture
- API publiques et fonctions exportées
- Chemins de gestion d'erreurs (blocs catch, callbacks d'erreur)
- Cas limites et conditions aux frontières
- Chemins critiques (authentification, paiement, validation de données)
Priorité moyenne :
- Fonctions utilitaires avec couverture partielle
- Fonctions privées appelées par des API publiques
- Code de configuration et d'initialisation
Priorité basse :
- Getters/setters simples
- Définitions de types
- Code généré automatiquement
- Code tiers
5. Analyser les chemins de code non testés
Pour chaque fichier avec des lacunes de couverture :
- Lire le fichier source pour comprendre la structure du code
- Identifier le code non testé :
- Lignes non couvertes et plages de lignes
- Branches conditionnelles non testées (if/else)
- Gestionnaires d'erreurs non couverts
- Couverture de fonction manquante
- Catégoriser les tests manquants :
- Tests de chemin nominal
- Tests d'erreurs/exceptions
- Tests de cas limites
- Tests d'intégration
6. Générer des suggestions de tests
Pour chaque lacune de couverture, suggérer des cas de test spécifiques :
Format :
Fichier : src/utils/validator.js (42 % de couverture)
Couverture manquante :
- Lignes 15-18 : Chemin d'erreur de validation d'email
- Lignes 23-25 : Gestion d'entrée vide
- Lignes 30-35 : Cas limite pour les caractères spéciaux
Tests suggérés :
1. Tester la validation d'email avec un format invalide (couvre les lignes 15-18)
2. Tester le validateur avec une chaîne vide en entrée (couvre les lignes 23-25)
3. Tester la gestion des caractères spéciaux dans les noms (couvre les lignes 30-35)
Les détails du cas de test doivent inclure :
- Description du test
- Données d'entrée
- Comportement/résultat attendu
- Lignes/branches couvertes
7. Créer des squelettes de test (optionnel)
Si l'utilisateur le souhaite, générer des squelettes de fichiers de test :
- Utiliser la syntaxe du framework de test approprié
- Inclure des blocs describe/test avec des commentaires TODO
- Ajouter une structure d'exemple de test
- Référencer le modèle dans
templates/test-template.js(ou extension appropriée)
Exemple (Jest) :
describe('Validator', () => {
describe('validateEmail', () => {
it('should reject invalid email format', () => {
// TODO : Tester le chemin d'erreur de validation d'email (lignes 15-18)
const result = validateEmail('invalid-email');
expect(result.valid).toBe(false);
});
it('should handle empty string input', () => {
// TODO : Tester la gestion d'entrée vide (lignes 23-25)
});
});
});
8. Calculer les métriques de couverture
Fournir des statistiques récapitulatives :
- Pourcentage de couverture global
- Couverture par fichier/répertoire
- Fonctions/méthodes sans tests
- Fichiers critiques avec faible couverture
- Tendance de couverture (si des données historiques sont disponibles)
9. Prioriser les recommandations
Ordonner les suggestions par :
- Impact : Logique métier critique en premier
- Risque : Zones à haut risque (sécurité, intégrité des données)
- Complexité : La logique complexe nécessite plus de tests
- Facilité : Victoires rapides (tests simples pour un gain de couverture important)
10. Format de sortie
Présenter les résultats dans un format clair et actionnable :
Résumé de l'analyse de couverture
==================================
Couverture globale : 67 %
- Instructions : 65 %
- Branches : 58 %
- Fonctions : 72 %
- Lignes : 67 %
Fichiers nécessitant une attention (triés par priorité) :
1. src/payment/processor.js (23 % de couverture) - HAUTE PRIORITÉ
- Manquant : Gestion d'erreurs pour les échecs de paiement
- Manquant : Tests de logique de réessai
- Manquant : Validation de transaction
2. src/auth/validator.js (45 % de couverture) - PRIORITÉ MOYENNE
- Manquant : Gestion de jeton invalide
- Manquant : Tests de session expirée
Cas de test suggérés :
[Suggestions détaillées pour chaque fichier]
Bonnes pratiques
- Se concentrer sur une couverture significative : 100 % de couverture n'est pas toujours nécessaire
- Tester le comportement, pas l'implémentation : Suggérer des tests qui vérifient la fonctionnalité
- Prioriser les chemins critiques : Authentification, paiements, validation de données en premier
- Considérer les types de tests : Tests unitaires, d'intégration et e2e selon le cas
- Vérifier les tests existants : Ne pas suggérer des tests qui existent déjà
- Données de test réalistes : Utiliser des entrées plausibles dans les exemples
- Seuils de couverture : Suggérer des cibles de couverture minimales (par ex., 80 %)
Exécution des rapports de couverture
Fournir des commandes en fonction du framework détecté :
Jest : npm test -- --coverage ou jest --coverage
Vitest : npm test -- --coverage ou vitest run --coverage
Mocha + NYC : nyc mocha
pytest : pytest --cov=src --cov-report=html
Go : go test -cover ./... ou go test -coverprofile=coverage.out
JUnit + JaCoCo : mvn test jacoco:report
Fichiers de support
scripts/parse-coverage.sh: Script d'aide pour extraire les données de couverturetemplates/test-template.js: Modèle de fichier de test pour JavaScripttemplates/test-template.py: Modèle de fichier de test pour Pythontemplates/test-template.go: Modèle de fichier de test pour Go