Configuración de Allure Pytest

El adaptador Allure Pytest proporciona algunas opciones de configuración adicionales que puedes pasar a pytest. Estas opciones afectan cómo Allure Pytest recopila los resultados de las pruebas y cómo pytest selecciona qué pruebas ejecutar.

Para pasar una opción, simplemente puedes agregarla al comando al ejecutar pytest. Por ejemplo:

python -m pytest --alluredir allure-results --clean-alluredir

Sin embargo, si deseas que algunas opciones se apliquen para todas las ejecuciones de pytest, agrégalas a la opción de configuración addopts de pytest. Debe declararse en el archivo de configuración del proyecto.

pyproject.toml

[tool.pytest.ini_options]
addopts = [
    "--alluredir", "allure-results",
    "--clean-alluredir"
]

pytest.ini

[pytest]
addopts = --alluredir allure-results
          --clean-alluredir

Opciones que afectan la recopilación de resultados

--alluredir ⟨DIRECTORIO⟩

Ruta al directorio donde Allure Pytest guardará los resultados de las pruebas, consulta Cómo funciona. Si el directorio no existe, se creará.

--clean-alluredir

Si se establece, el directorio especificado por --alluredir se limpiará antes de generar nuevos resultados de pruebas.

Por defecto, los datos existentes se mantienen intactos, lo que permite combinar los resultados de múltiples ejecuciones de pruebas en un solo informe de prueba.

--allure-no-capture

Si se establece, Allure Pytest no producirá automáticamente los archivos adjuntos stdout, stderr y log, descritos en Adjuntar capturas de pantalla y otros archivos.

--allure-link-pattern ⟨TIPO⟩:⟨PATRÓN⟩

Define un patrón de enlace — una plantilla que puede utilizarse para construir URLs completas a partir de identificadores cortos, consulta la referencia.

La opción acepta dos valores, separados por dos puntos.

• TIPO es un identificador de cadena arbitrario.
• PATRÓN es una cadena que contiene {} en la posición donde debe colocarse el identificador.

El PATRÓN dado se aplicará al procesar cualquier enlace del tipo dado. Puedes usar la opción varias veces, definiendo así múltiples patrones de enlace para diferentes tipos de enlace.

Por ejemplo, aquí tienes una forma de definir un patrón de enlace para problemas en un repositorio de GitHub:

python -m pytest --allure-link-pattern issue:https://github.com/allure-framework/allure-python/issues/{}

Opciones que afectan la selección de pruebas

Cada una de estas opciones, excepto --inversion, acepta una lista de valores separados por comas que limitan la selección de pruebas que pytest debe ejecutar. Cuando se usan dos o más de estas opciones juntas, pytest ejecutará las pruebas que coincidan con cualquiera de las condiciones.

WARNING

Las opciones no funcionan con los metadatos agregados dinámicamente dentro del código de las pruebas, consulta Especificar descripción, enlaces y otros metadatos.

--allure-severities ⟨SEVERIDAD1⟩,⟨SEVERIDAD2⟩,...

Ejecutar solo las pruebas que tengan uno de los valores de severidad especificados, consulta Especificar descripción, enlaces y otros metadatos.

--allure-epics ⟨EPICO1⟩,⟨EPICO2⟩,...

Ejecutar solo las pruebas que tengan uno de los valores de épico especificados, consulta Jerarquía basada en comportamiento.

--allure-features ⟨CARACTERÍSTICA1⟩,⟨CARACTERÍSTICA2⟩,...

Ejecutar solo las pruebas que tengan uno de los valores de característica especificados, consulta Jerarquía basada en comportamiento.

--allure-stories ⟨HISTORIA1⟩,⟨HISTORIA2⟩,...

Ejecutar solo las pruebas que tengan uno de los valores de historia especificados, consulta Jerarquía basada en comportamiento.

--allure-ids ⟨ID1⟩,⟨ID2⟩,...

Ejecutar solo las pruebas que tengan uno de los IDs especificados, consulta Especificar descripción, enlaces y otros metadatos.

--allure-label ⟨ETIQUETA1⟩=⟨VALOR1⟩,⟨ETIQUETA2⟩=⟨VALOR2⟩,...

Ejecutar solo las pruebas que tengan una de las etiquetas especificadas, consulta Especificar descripción, enlaces y otros metadatos.

--inversion

Si se establece, pytest solo ejecutará las pruebas que no coincidan con las condiciones especificadas por otros argumentos o el plan de pruebas.