Mínimo de cobertura (coverage floor)
Última actualización
Un mínimo de cobertura es la cobertura de pruebas más baja con la que se puede entregar un cambio. Cómo se fija, sus trampas y cómo funciona minCoveragePct en la comprobación de CI de AI CodeOps.
Un mínimo de cobertura es el porcentaje mínimo de cobertura de pruebas que una base de código o un cambio debe alcanzar para superar una comprobación de calidad. Si la cobertura medida está por debajo del mínimo, la comprobación falla.
Qué es
Las herramientas de cobertura miden cuánto código ejecutaron las pruebas, normalmente como porcentaje de líneas, sentencias o ramas. Un mínimo fija un valor mínimo para esa cifra, por ejemplo un 80% de cobertura de líneas, y un paso de CI falla cuando la ejecución queda por debajo. Algunos equipos aplican el mínimo a todo el proyecto; otros, solo a las líneas que tocó un cambio.
Un mínimo mide cuánto código se ejecutó durante las pruebas, no si las pruebas comprobaron algo. Una prueba sin aserciones también suma cobertura.
Por qué importa
La cobertura tiende a bajar cuando nadie la vigila, y un mínimo frena esa caída. Es más útil como trinquete: fíjalo cerca de la cifra actual y súbelo a medida que mejore la cobertura. En los cambios escritos por IA es una señal barata de que la sesión escribió pruebas junto con el código, y no en su lugar.
En AI CodeOps
El mínimo de cobertura es la opción minCoveragePct de la comprobación de publicación a la que llama tu CI, POST /api/release/check:
{ "pullRequestURL": "https://github.com/acme/checkout/pull/42", "minCoveragePct": 80 }
Cuando una sesión ejecuta tus pruebas en su sandbox, AI CodeOps extrae la cifra de cobertura de la salida de las pruebas cuando esta incluye un resumen: una línea TOTAL de pytest-cov, una fila All files de Istanbul (Jest, Vitest; la primera columna, que corresponde a las sentencias) o una línea etiquetada como coverage: 85.3%. Guarda la cifra con la ejecución de pruebas como un número entero, redondeado hacia abajo.
Con minCoveragePct definido, la ejecución de pruebas más reciente que informó de cobertura debe alcanzarlo. Si no llega, la publicación se deniega:
{
"allowed": false,
"reasons": ["Coverage 71% is below the required 80%"],
"coverageShortfall": { "coveragePct": 71, "required": 80 },
"coverageNotReported": null
}
Dos detalles importan:
- Sin cobertura informada, no se supera. Si ninguna ejecución de pruebas del cambio informó de cobertura, el mínimo no se puede comprobar, así que la publicación se deniega: "Coverage wasn't reported, so the 80% floor can't be checked". La respuesta incluye entonces
"coverageNotReported": { "required": 80 }. Haz que el comando de pruebas de tu proyecto imprima un resumen de cobertura, por ejemplopytest --covovitest run --coverage, antes de fijar un mínimo. - Solo en CI. El control de calidad de la consola bloquea las pruebas fallidas, pero no comprueba la cobertura, y la página Release gate no tiene ningún campo de cobertura. Fija el mínimo en la llamada a la API.
Las pruebas fallidas son una comprobación aparte: cualquier ejecución de pruebas registrada con una prueba fallida o un código de salida distinto de cero deniega la publicación, sea cual sea la cobertura. La lista completa de opciones está en la página de la API, y cómo se ejecutan las pruebas, en la página de pruebas.
Términos relacionados
- Control de calidad: las comprobaciones a las que se suma un mínimo de cobertura.
- Política de licencias: otra opción de la misma comprobación de CI.
- Control de despliegue: comprobaciones de publicación por entorno.
Preguntas frecuentes
¿AI CodeOps deniega un cambio cuando no se informó de ninguna cobertura?
Sí, cuando fijas un mínimo. Con minCoveragePct definido, la ejecución de pruebas más reciente que informó de cobertura debe alcanzarlo. Si ninguna informó de cobertura, la comprobación deniega, porque el mínimo no se puede comprobar.
¿El mínimo de cobertura está activado por defecto?
No. Solo se aplica cuando tu CI pasa minCoveragePct a la comprobación de publicación. El control por sesión de la consola no comprueba la cobertura.
¿Qué cifra de cobertura usa AI CodeOps?
La cifra total de cobertura, leída de la salida de las pruebas cuando incluye un resumen, como una línea TOTAL de pytest-cov o una fila All files de Istanbul (su columna de sentencias).