Analizador de Cobertura de Pruebas
Esta habilidad ayuda a identificar brechas en la cobertura de pruebas y sugiere casos de prueba específicos para mejorar la calidad del código.
Cuándo Usar Esta Habilidad
- El usuario solicita analizar la cobertura de pruebas
- El usuario desea mejorar la cobertura de pruebas
- El usuario pide sugerencias para pruebas faltantes
- Cuando se trabaja para aumentar el porcentaje de cobertura de código
- El usuario menciona "brechas de cobertura", "código no probado" o "sugerencias de pruebas"
Instrucciones
1. Detectar el Framework de Pruebas
Identifica el/los frameworks de pruebas usados en el proyecto:
JavaScript/TypeScript:
- Jest:
jesten package.json ojest.config.js - Mocha:
mochaen package.json o.mocharc - Vitest:
vitesten package.json ovitest.config.js - Jasmine:
jasmineen package.json
Python:
- pytest:
pytesten requirements.txt opytest.ini - unittest: Biblioteca estándar, verifica archivos de prueba
- coverage.py:
coverageen requirements.txt
Ruby:
- RSpec:
rspecen Gemfile - Minitest: Biblioteca estándar
Go:
- Integrado:
go test(cobertura mediantego test -cover)
Java:
- JUnit: Busca JUnit en pom.xml o build.gradle
- JaCoCo: Configuración de la herramienta de cobertura
Usa Glob y Grep para encontrar archivos de configuración.
2. Localizar Informes de Cobertura
Encuentra informes de cobertura existentes:
Ubicaciones comunes:
coverage/directorio.nyc_output/(NYC para Node.js)htmlcov/(coverage.py para Python)target/site/jacoco/(JaCoCo para Java)- Archivos de cobertura:
lcov.info,coverage.json,.coverage
Si no existe informe de cobertura:
- Guía al usuario para ejecutar cobertura:
npm test -- --coverage,pytest --cov, etc. - Espera a que se genere el informe antes de analizar
3. Analizar Datos de Cobertura
Extrae información de cobertura:
Desde lcov.info:
- Líneas cubiertas vs totales
- Funciones cubiertas vs totales
- Ramas cubiertas vs totales
- Números de línea no cubiertos por archivo
Desde coverage.json (Jest):
- Porcentaje de cobertura de sentencias
- Porcentaje de cobertura de ramas
- Porcentaje de cobertura de funciones
- Porcentaje de cobertura de líneas
- Líneas no cubiertas por archivo
Desde .coverage (Python):
- Usa
coverage reportocoverage json - Rangos de líneas faltantes
- Líneas excluidas
Desde informes HTML:
- Lee estadísticas resumidas
- Identifica archivos con baja cobertura
4. Identificar Brechas de Cobertura
Prioriza archivos/funciones que necesitan pruebas:
Alta prioridad:
- Lógica de negocio con 0% de cobertura
- APIs públicas y funciones exportadas
- Rutas de manejo de errores (bloques catch, callbacks de error)
- Casos límite y condiciones frontera
- Rutas críticas (autenticación, pago, validación de datos)
Prioridad media:
- Funciones utilitarias con cobertura parcial
- Funciones privadas llamadas por APIs públicas
- Código de configuración e inicialización
Prioridad baja:
- Getters/setters simples
- Definiciones de tipos
- Código generado automáticamente
- Código de terceros
5. Analizar Rutas de Código No Probadas
Para cada archivo con brechas de cobertura:
- Lee el archivo fuente para entender la estructura del código
- Identifica el código no probado:
- Líneas y rangos de líneas no cubiertas
- Ramas condicionales no probadas (if/else)
- Manejadores de errores no cubiertos
- Cobertura de funciones faltante
- Categoriza las pruebas faltantes:
- Pruebas de camino feliz
- Pruebas de error/excepción
- Pruebas de casos límite
- Pruebas de integración
6. Generar Sugerencias de Pruebas
Para cada brecha de cobertura, sugiere casos de prueba específicos:
Formato:
Archivo: src/utils/validator.js (42% cobertura)
Cobertura Faltante:
- Líneas 15-18: Ruta de error de validación de email
- Líneas 23-25: Manejo de entrada vacía
- Líneas 30-35: Caso límite para caracteres especiales
Pruebas Sugeridas:
1. Probar validación de email con formato inválido (cubre líneas 15-18)
2. Probar validador con entrada de cadena vacía (cubre líneas 23-25)
3. Probar manejo de caracteres especiales en nombres (cubre líneas 30-35)
Los detalles del caso de prueba deben incluir:
- Descripción de la prueba
- Datos de entrada
- Resultado/comportamiento esperado
- Líneas/ramas cubiertas
7. Crear Stubs de Prueba (Opcional)
Si el usuario lo desea, genera stubs de archivos de prueba:
- Usa la sintaxis apropiada del framework de pruebas
- Incluye bloques describe/test con comentarios TODO
- Añade estructura de ejemplo de prueba
- Referencia la plantilla en
templates/test-template.js(o extensión apropiada)
Ejemplo (Jest):
describe('Validator', () => {
describe('validateEmail', () => {
it('debería rechazar formato de email inválido', () => {
// TODO: Probar ruta de error de validación de email (líneas 15-18)
const result = validateEmail('email-inválido');
expect(result.valid).toBe(false);
});
it('debería manejar entrada de cadena vacía', () => {
// TODO: Probar manejo de entrada vacía (líneas 23-25)
});
});
});
8. Calcular Métricas de Cobertura
Proporciona estadísticas resumidas:
- Porcentaje de cobertura general
- Cobertura por archivo/directorio
- Funciones/métodos sin pruebas
- Archivos críticos con baja cobertura
- Tendencia de cobertura (si hay datos históricos disponibles)
9. Priorizar Recomendaciones
Ordena las sugerencias por:
- Impacto: Lógica de negocio crítica primero
- Riesgo: Áreas de alto riesgo (seguridad, integridad de datos)
- Complejidad: La lógica compleja necesita más pruebas
- Facilidad: Victorias rápidas (pruebas simples para una alta ganancia de cobertura)
10. Formato de Salida
Presenta los hallazgos en un formato claro y accionable:
Resumen del Análisis de Cobertura
==================================
Cobertura General: 67%
- Sentencias: 65%
- Ramas: 58%
- Funciones: 72%
- Líneas: 67%
Archivos que requieren atención (ordenados por prioridad):
1. src/payment/processor.js (23% cobertura) - ALTA PRIORIDAD
- Faltante: Manejo de errores en fallos de pago
- Faltante: Pruebas de lógica de reintento
- Faltante: Validación de transacciones
2. src/auth/validator.js (45% cobertura) - PRIORIDAD MEDIA
- Faltante: Manejo de token inválido
- Faltante: Pruebas de sesión expirada
Casos de Prueba Sugeridos:
[Sugerencias detalladas para cada archivo]
Mejores Prácticas
- Enfócate en cobertura significativa: No siempre es necesario el 100% de cobertura
- Prueba el comportamiento, no la implementación: Sugiere pruebas que verifiquen la funcionalidad
- Prioriza rutas críticas: Autenticación, pagos, validación de datos primero
- Considera tipos de prueba: Unitarias, integración y e2e cuando sea apropiado
- Revisa pruebas existentes: No sugieras pruebas que ya existen
- Datos de prueba realistas: Usa entradas plausibles en los ejemplos
- Umbrales de cobertura: Sugiere objetivos mínimos de cobertura (ej., 80%)
Ejecutar Informes de Cobertura
Proporciona comandos según el framework detectado:
Jest: npm test -- --coverage o jest --coverage
Vitest: npm test -- --coverage o vitest run --coverage
Mocha + NYC: nyc mocha
pytest: pytest --cov=src --cov-report=html
Go: go test -cover ./... o go test -coverprofile=coverage.out
JUnit + JaCoCo: mvn test jacoco:report
Archivos de Apoyo
scripts/parse-coverage.sh: Script auxiliar para extraer datos de coberturatemplates/test-template.js: Plantilla de archivo de prueba para JavaScripttemplates/test-template.py: Plantilla de archivo de prueba para Pythontemplates/test-template.go: Plantilla de archivo de prueba para Go