testcontainers

Testcontainers levanta instancias reales de PostgreSQL, Redis y MinIO como contenedores Docker durante los tests de integración. Esto elimina los mocks frágiles y garantiza que el código funciona con las dependencias reales.

When to use

Usar en los tests de integración donde se necesita verificar comportamiento real: que los logs se persisten correctamente en PostgreSQL, que el rate limiter funciona con Redis real, que las imágenes se suben y se recuperan de MinIO.

Instructions

1. Instalar: pip install testcontainers[postgresql,redis]
2. Fixture de PostgreSQL en conftest.py:

   import pytest
   from testcontainers.postgres import PostgresContainer
   @pytest.fixture(scope="session")
   def postgres_container():
       with PostgresContainer("postgres:16-alpine") as pg:
           yield pg.get_connection_url().replace("postgresql://", "postgresql+asyncpg://")