Fixtures, parametrización y marcadores en pytest: cómo mantener una suite rápida y legible

Qué es

Un fixture es una función decorada con @pytest.fixture cuyo valor, devuelto o producido con yield, se inyecta en cualquier test que lo nombre como parámetro; el código posterior a yield se ejecuta como limpieza (teardown). Los fixtures pueden solicitar otros fixtures, tienen un alcance (function por defecto, o class, module, package, session), pueden ser autouse y se comparten entre archivos mediante conftest.py. @pytest.mark.parametrize("a,expected", [...]) ejecuta una misma función una vez por cada caso, y cada uno se reporta por separado; pytest.param(..., marks=pytest.mark.xfail) marca un único caso. Los marcadores como slow etiquetan tests para seleccionarlos con -m "not slow"; se registran en el archivo de configuración, y --strict-markers hace que un marcador no registrado sea un error.

Por qué importa

Los fixtures sustituyen el código de preparación copiado y la herencia de setUp por dependencias visibles en la firma del test. La parametrización convierte un bucle dentro de un test, que se detiene en el primer fallo, en casos independientes. Los marcadores permiten que una ejecución en un pull request omita las suites lentas sin modificar el código.

Cómo aplicarlo

• Mantén por defecto el alcance de función; amplíalo a module o session solo para recursos costosos e inmutables (un contenedor de base de datos, un modelo compilado). El ejemplo de la documentación es una conexión SMTP reutilizada dentro de un módulo. No modifiques nunca dentro de un test un fixture de alcance ampliado.
• Coloca cada fixture en el conftest.py más cercano que abarque a todos sus usuarios; un conftest.py en la raíz que lo contenga todo oculta qué tests necesitan qué.
• Usa fixtures con yield para la limpieza, que es la forma recomendada en la documentación, de modo que la limpieza se ejecute incluso cuando el test falla.
• Asigna ids legibles a los casos parametrizados para que la selección con -k y la salida de los fallos identifiquen el caso por su nombre; es preferible una única tabla de entradas y salidas esperadas a muchas funciones casi idénticas.
• Registra cada marcador con una descripción y añade --strict-markers a addopts, de modo que @pytest.mark.slwo haga fallar la recolección en lugar de ejecutarse sin avisar.
• Usa los fixtures integrados tmp_path y monkeypatch en lugar de directorios temporales y parcheo de atributos escritos a mano.

Trampas

Los fixtures autouse ocultan dependencias; resérvalos para asuntos realmente globales, como un reloj fijo. Construir las listas de parametrización a partir de la red o de una base de datos en el momento de la importación vuelve la recolección lenta e inestable. Un fixture de alcance más amplio no puede depender de uno de alcance más estrecho. La documentación indica que los marcadores se aplican solo a los tests y no tienen efecto sobre los fixtures.