¿Es este el uso correcto de conftest.py?
Sí lo es. Los accesorios son un uso potencial y común de conftest.py. Los accesorios que definirá se compartirán entre todas las pruebas en su conjunto de pruebas. Sin embargo, la definición de accesorios en la raíz conftest.pypodría ser inútil y ralentizaría las pruebas si dichos dispositivos no son utilizados por todas las pruebas.
¿Tiene otros usos?
Si lo hace
Aparatos : defina aparatos para datos estáticos utilizados por las pruebas. Todas las pruebas de la suite pueden acceder a estos datos a menos que se especifique lo contrario. Estos podrían ser datos, así como ayudantes de módulos que se pasarán a todas las pruebas.
Carga de complementos externos : conftest.pyse utiliza para importar complementos o módulos externos. Al definir la siguiente variable global, pytest cargará el módulo y lo pondrá a disposición para su prueba. Los complementos son generalmente archivos definidos en su proyecto u otros módulos que pueden ser necesarios en sus pruebas. También puede cargar un conjunto de complementos predefinidos como se explica aquí .
pytest_plugins = "someapp.someplugin"
Ganchos : puede especificar ganchos como los métodos de configuración y desmontaje y mucho más para mejorar sus pruebas. Para un conjunto de ganchos disponibles, lea aquí . Ejemplo:
def pytest_runtest_setup(item):
""" called before ``pytest_runtest_call(item). """
#do some stuff`
Probar ruta raíz : esta es una característica oculta. Al definir conftest.pyen su ruta raíz, tendrá que pytestreconocer sus módulos de aplicación sin especificar PYTHONPATH. En segundo plano, py.test modifica tu sys.pathmediante la inclusión de todos los submódulos que se encuentran desde la ruta raíz.
¿Puedo tener más de un archivo conftest.py?
Sí, puede hacerlo y es muy recomendable si su estructura de prueba es algo compleja. conftest.pylos archivos tienen alcance de directorio. Por lo tanto, crear accesorios y ayudantes específicos es una buena práctica.
¿Cuándo querría hacer eso? Se apreciarán ejemplos.
Varios casos podrían caber:
Crear un conjunto de herramientas o ganchos para un grupo particular de pruebas.
root / mod / conftest.py
def pytest_runtest_setup(item):
print("I am mod")
#do some stuff
test root/mod2/test.py will NOT produce "I am mod"
Cargando un conjunto de accesorios para algunas pruebas pero no para otras.
root / mod / conftest.py
@pytest.fixture()
def fixture():
return "some stuff"
root / mod2 / conftest.py
@pytest.fixture()
def fixture():
return "some other stuff"
root / mod2 / test.py
def test(fixture):
print(fixture)
Imprimirá "algunas otras cosas".
Anulando ganchos heredados de la raíz conftest.py.
root / mod / conftest.py
def pytest_runtest_setup(item):
print("I am mod")
#do some stuff
root / conftest.py
def pytest_runtest_setup(item):
print("I am root")
#do some stuff
Al ejecutar cualquier prueba dentro root/mod, solo se imprime "I am mod".
Puedes leer más sobre conftest.py aquí .
EDITAR:
¿Qué sucede si necesito que se invoquen funciones auxiliares antiguas desde varias pruebas en diferentes módulos? ¿Estarán disponibles para mí si las pongo en un archivo conftest.py? ¿O debería simplemente ponerlos en un módulo helpers.py e importarlo y usarlo en mis módulos de prueba?
Puede usar conftest.pypara definir sus ayudantes. Sin embargo, debes seguir la práctica común. Los ayudantes se pueden usar como accesorios al menos enpytest . Por ejemplo, en mis pruebas tengo un simulador de ayuda de redis que inyecto en mis pruebas de esta manera.
root / helper / redis / redis.py
@pytest.fixture
def mock_redis():
return MockRedis()
root / tests / stuff / conftest.py
pytest_plugin="helper.redis.redis"
root / tests / stuff / test.py
def test(mock_redis):
print(mock_redis.get('stuff'))
Este será un módulo de prueba que puede importar libremente en sus pruebas. NOTA que potencialmente podría nombrar redis.pycomo conftest.pysi su módulo rediscontiene más pruebas. Sin embargo, esa práctica se desaconseja debido a la ambigüedad.
Si desea usar conftest.py, simplemente puede poner ese ayudante en su raíz conftest.pye inyectarlo cuando sea necesario.
root / tests / conftest.py
@pytest.fixture
def mock_redis():
return MockRedis()
root / tests / stuff / test.py
def test(mock_redis):
print(mock_redis.get(stuff))
Otra cosa que puedes hacer es escribir un complemento instalable. En ese caso, su asistente puede escribirse en cualquier lugar, pero debe definir un punto de entrada para instalarlo en su y otros marcos de prueba potenciales. Ver esto .
Si no desea usar accesorios, por supuesto, podría definir un simple ayudante y simplemente usar la importación antigua simple donde sea necesario.
root / tests / helper / redis.py
class MockRedis():
# stuff
root / tests / stuff / test.py
from helper.redis import MockRedis
def test():
print(MockRedis().get(stuff))
Sin embargo, aquí puede tener problemas con la ruta ya que el módulo no está en una carpeta secundaria de la prueba. Debería poder superar esto (no probado) agregando un __init__.pya su ayudante
root / tests / helper / __ init__.py
from .redis import MockRedis
O simplemente agregando el módulo auxiliar a su PYTHONPATH.
It seems great. However, I feel the documentation could be better.