AI CodeOps

Servicio en Python: primero las pruebas, con un mínimo de cobertura en la CI

Última actualización

Escribe las pruebas de pytest que faltan con Quality-Gated Change, registra la cobertura de pytest-cov en el sandbox y haz que la CI deniegue la fusión por debajo de un 80% de cobertura.

Usar esta plantilla

El código de precios sin pruebas es de donde salen los reembolsos. Esta plantilla pide a los agentes que escriban primero las pruebas que faltan, las ejecuta sobre el código que se escribió de verdad y da a tu CI un mínimo de cobertura que imponer.

Qué agentes se ejecutan

Quality-Gated Change es el flujo de trabajo de código más corto, sin paso de planificación:

  1. Build, a cargo del Builder: el archivo de pruebas y cualquier corrección que pidan los casos.
  2. Test, a cargo del Tester: casos con nombre para el camino feliz, los casos límite y los modos de fallo, comprobados contra las pruebas que se escribieron y su resultado registrado.
  3. Review, a cargo del Reviewer: si las pruebas comprueban un comportamiento real o solo recorren líneas.

La pasada de código escribe el cambio justo después de Build. El paso verify lo reconstruye en un sandbox, instala las dependencias, corta la red y ejecuta tu comando de pruebas. Test y Review se ejecutan después, sobre el cambio escrito. El resumen de pytest se desglosa en superadas, fallidas y omitidas, y la línea TOTAL de cobertura de pytest-cov se registra como la cifra total de cobertura.

Configura el comando de pruebas

En el proyecto, configura:

Campo del proyectoValor de ejemplo
Test commandpytest -q --cov=app --cov-report=term

Sin un comando, AI CodeOps detecta pytest a partir de pyproject.toml, setup.cfg, pytest.ini o tox.ini, pero ejecuta pytest -q sin cobertura. Entonces la ejecución no informa de ninguna cobertura, y un mínimo de cobertura en la CI deniega el cambio porque no se puede comprobar. Así que configura el comando. Cada comando tiene un límite de dos minutos.

Controles que se aplican

  • Las pruebas fallidas bloquean el pull request, y solo cuenta un resultado de la versión actual del cambio.
  • Los hallazgos abiertos de gravedad alta o crítica bloquean hasta que se pasan por triaje.
  • Aprueba una persona distinta de la que empezó la sesión, cuando el espacio de trabajo tiene otro aprobador.

Impón el mínimo en la CI

La cobertura solo se controla cuando tu pipeline lo pide. Pasa la URL del pull request y un mínimo:

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pullRequestURL\":\"$PR_URL\",\"minCoveragePct\":80}" \
  | jq -e '.allowed == true'

La ejecución de pruebas más reciente que informó de cobertura tiene que llegar a 80, o la respuesta se deniega con un coverageShortfall, por ejemplo «Coverage 71% is below the required 80%». Si ninguna ejecución de pruebas del cambio informó de cobertura, la respuesta también se deniega: «Coverage wasn't reported, so the 80% floor can't be checked». El mínimo se aplica a lo que mida tu comando, así que --cov=app controla el paquete entero, no solo el archivo que cambiaste. Los detalles de los campos están en la referencia de la comprobación de publicación.

Para la parte de dependencias del mismo servicio, consulta la plantilla de control de SBOM y licencias.

Preguntas frecuentes

¿El control de calidad de cada ejecución comprueba la cobertura?

No. Los mínimos de cobertura son una opción de la CI. El control propio de la ejecución comprueba las pruebas, los hallazgos y la aprobación; minCoveragePct solo se aplica cuando tu CI lo pide.

¿Y si el sandbox no puede instalar pytest-cov?

El paso verify registra una omisión con el motivo, no un fallo ni una superación. Añade pytest-cov a las dependencias que instala tu proyecto.