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.
En una línea
Sección titulada «En una línea»El CI no encuentra bugs: impide que los que ya sabes detectar lleguen a producción.
Las cuatro capas
Sección titulada «Las cuatro capas»| 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.
El archivo que lo define
Sección titulada «El archivo que lo define»name: calidadon: [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 conocidasLa 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.
Local, antes del push
Sección titulada «Local, antes del push»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.
La trampa
Sección titulada «La trampa»Qué no automatizar
Sección titulada «Qué no automatizar»- 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.
Ejercicio
Sección titulada «Ejercicio»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 --checkyruff check: segundos.mypysó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.
Referencias
Sección titulada «Referencias»- 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,pytestypre-commit.
Capítulos relacionados
Sección titulada «Capítulos relacionados»- 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.