Saltearse al contenido

CI y calidad

La integración continua es la única revisión que no se cansa. Un humano revisa tres cosas y aprueba; un CI comprueba cien en cada push y no negocia. El objetivo no es tener un pipeline: es que el pipeline impida que llegue a la rama principal lo que no cumple las reglas del equipo.

El CI no encuentra bugs: impide que los que ya sabes detectar lleguen a producción.

Capa Herramienta Qué detecta
Formato ruff format Nada funcional; elimina discusiones
Lint ruff check Imports muertos, variables sin usar, errores comunes
Tipos mypy / pyright Contratos incoherentes
Tests pytest Comportamiento roto

El orden importa: son de más rápido a más lento, y si falla el formato no tiene sentido ejecutar los tests. Un pipeline que tarda cuatro minutos en decir «falta un espacio» es un pipeline que se ignora.

name: calidad
on: [push, pull_request]
jobs:
comprobar:
runs-on: ubuntu-latest
strategy:
matrix:
python-version: ["3.11", "3.12", "3.13", "3.14"]
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: ${{ matrix.python-version }}
cache: pip
- run: pip install -e ".[dev]"
- run: ruff format --check .
- run: ruff check .
- run: mypy src
- run: pytest -q --maxfail=1
- run: pip install pip-audit && pip-audit # dependencias con vulnerabilidades conocidas

La matriz de versiones es lo que permite declarar requires-python = ">=3.11" con fundamento: si sólo pruebas 3.13, no sabes si funciona en 3.11.

pre-commit ejecuta lo rápido antes de cada commit: formato, lint, y comprobaciones de archivos grandes o credenciales accidentales. Lo lento (tests, tipos) se queda en CI.

repos:
- repo: https://github.com/astral-sh/ruff-pre-commit
rev: v0.5.0
hooks: [{ id: ruff }, { id: ruff-format }]

Un commit no debería fallar en CI por algo que se detecta en dos segundos en local.

  • Cobertura como puerta. Un umbral obliga a escribir tests vacíos para llegar al número.
  • Formato de mensajes de commit sin convención real detrás.
  • Rendimiento en CI compartido: los números varían con la máquina y producen falsos positivos.
  • Todo a la vez. Un pipeline de veinte pasos que nadie entiende no se mantiene.

Un equipo tiene un CI de 25 minutos y los developers empiezan a mergear sin esperarlo. Propón una reorganización en dos niveles y di qué se queda en cada uno.

Solución

Nivel 1 — rápido (< 3 minutos), bloquea el merge:

  • ruff format --check y ruff check: segundos.
  • mypy sólo en los paquetes modificados (o con --follow-imports=skip).
  • Tests unitarios: los que no tocan red ni base de datos.
  • Una sola versión de Python, la mínima soportada.

Nivel 2 — lento (< 15 minutos), informa pero no bloquea:

  • Matriz completa de versiones.
  • Tests de integración con base de datos y contenedores.
  • Build de la distribución y comprobación de que instala en un entorno limpio.

El criterio de reparto: lo que se ejecuta en cada push es lo que detecta errores que el developer puede arreglar en un minuto. Lo que requiere contenedores o diez minutos va al segundo nivel, y se bloquea el merge sólo si falla en la rama principal.

El resultado esperado: 25 minutos se convierten en 3 de espera bloqueante y unos 15 en paralelo; los 7 restantes desaparecen con la caché de dependencias.

  • Ramalho, L. Fluent Python, 2ª ed. Capítulo 8: tipado.
  • Lott, S. F. Modern Python Cookbook, 3ª ed. Capítulo 17: documentación y estilo.
  • Documentación de ruff, mypy, pytest y pre-commit.
  • 03 · Testing: qué se ejecuta en el pipeline.
  • 09 · Empaquetado: el build que valida el CI.
  • 02 · Configuración: el entorno que el CI simula.