# Pytest Asyncio

> Framework de testing con soporte completo para código async, fixtures y parametrización

- Skill: `davidcastagnetoa/pytest-asyncio` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add davidcastagnetoa/pytest-asyncio`
- Raw SKILL.md: https://api.skillmd.com/api/skills/davidcastagnetoa/pytest-asyncio/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: davidcastagnetoa (https://skillmd.com/u/davidcastagnetoa)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/davidcastagnetoa/pytest-asyncio

---


# pytest_asyncio

pytest es el framework de testing principal del sistema KYC. `pytest-asyncio` añade soporte para tests de funciones `async def`, indispensable dado que todos los agentes son async. `pytest-cov` mide la cobertura de tests.

## When to use

Usar para todos los tests: unitarios, de integración y de regresión. Ningún código nuevo debe llegar a main sin tests que cubran el happy path y los edge cases críticos.

## Instructions

1. Instalar: `pip install pytest pytest-asyncio pytest-cov httpx`
2. Configurar en `pyproject.toml`:
   ```toml
   [tool.pytest.ini_options]
   asyncio_mode = "auto"
   testpaths = ["backend/tests"]
   addopts = "--cov=backend --cov-report=xml --cov-fail-under=80"
   ```
3. Estructura de tests:
   ```
   backend/tests/
   ├── unit/
   │   ├── test_liveness_agent.py
   │   ├── test_ocr_agent.py
   │   └── test_face_match_agent.py
   ├── integration/
   │   ├── test_pipeline_e2e.py
   │   └── test_api_endpoints.py
   └── conftest.py
   ```
4. Test async example:
   ```python
   import pytest
   from httpx import AsyncClient
   from backend.main import app
   @pytest.mark.asyncio
   async def test_verify_endpoint_returns_200():
       async with AsyncClient(app=app, base_url="http://test") as client:
           response = await client.post("/v1/verify", json={"session_id": "test-123"})
       assert response.status_code == 200
   ```
5. Fixtures en `conftest.py`: mock de modelos ML (devolver scores fijos), conexión a Redis de test, factory de sesiones.
6. Tests críticos obligatorios: threshold de liveness, threshold de face match, rechazo de documento expirado, rate limiting.

## Notes

- `asyncio_mode = "auto"` hace que todos los tests async se ejecuten sin `@pytest.mark.asyncio` en cada función.
- Mockear los modelos ML con `pytest-mock` o `unittest.mock` para tests unitarios rápidos — los tests con modelos reales van en tests de integración.
- `httpx.AsyncClient` permite testear endpoints FastAPI sin levantar un servidor real.