Configuración de Allure NUnit

Esta página describe las opciones de configuración que afectan el comportamiento de Allure NUnit.

De forma predeterminada, Allure NUnit intenta leer el archivo allureConfig.json en el mismo directorio donde se encuentra el ensamblaje de prueba. Para asegurarte de que el archivo esté presente allí, edita las propiedades del archivo en tu IDE o manualmente en tu archivo *.csproj y configura el CopyToOutputDirectory del elemento correspondiente en Always o PreserveNewest. Por ejemplo:

<Project Sdk="Microsoft.NET.Sdk">
    <!-- ... -->
    <ItemGroup>
        <None Update="specflow.json">
            <CopyToOutputDirectory>Always</CopyToOutputDirectory>
        </None>
    </ItemGroup>
</Project>

Alternativamente, usa la variable de entorno ALLURE_CONFIG para especificar una ruta relativa o absoluta del archivo de configuración.

allure.directory

Ruta al directorio donde Allure NUnit guardará los resultados de las pruebas, consulta Cómo funciona. Si el directorio no existe, se creará. El valor predeterminado es allure-results.

Ten en cuenta que la ruta se trata como relativa al directorio de salida de la compilación del proyecto. Al construir y ejecutar pruebas desde un IDE, esto generalmente es diferente de la carpeta de la solución. Es posible que se necesiten varios elementos ../ si deseas poner los resultados de las pruebas en un directorio dentro de la carpeta de la solución.

{
  "allure": {
    "directory": "../../../../../allure-results"
  }
}

allure.links

Lista de patrones que se pueden usar para construir URL completas a partir de identificadores cortos.

Cada patrón debe ser una cadena que contenga un marcador de posición rodeado por llaves, por ejemplo: {issue}. Al procesar un enlace, Allure NUnit selecciona el patrón cuyo marcador de posición coincida con el tipo de enlace (según lo especificado mediante los argumentos Link o [AllureLink]). El marcador de posición luego se reemplaza por el identificador corto.

Por ejemplo, con la configuración a continuación, el enlace BUG-123 de tipo issue se traducirá a https://issues.example.com/BUG-123.

{
  "allure": {
    "links": [
      "https://issues.example.com/{issue}",
      "https://tms.example.com/{tms}",
      "https://jira.example.com/browse/{jira}"
    ]
  }
}

allure.failExceptions

Una lista de tipos de excepciones que, cuando se lanzan desde un paso, deben hacer que tenga el estado Fallido. En caso de cualquier otra excepción, se asigna el estado Roto al paso.

INFO

Actualmente, la configuración solo afecta los estados de pasos individuales de la prueba. Para el estado de la prueba en su totalidad, consulta Distinguir entre estados de prueba.

La lista predeterminada incluye las clases NUnit.Framework.Internal.NUnitException y NUnit.Framework.AssertionException. La configuración, si no está vacía, sobrescribe la lista predeterminada. Al buscar coincidencias, Allure NUnit usa no solo el nombre completo de la clase de excepción, sino también todas sus interfaces y clases base.

Con la configuración de ejemplo a continuación, un paso se considerará fallido si lanza NUnit.Framework.AssertionException, MyNamespace.MyCustomException, o cualquier cosa que derive de ellas. Al mismo tiempo, cualquier otra excepción hará que el paso se marque como roto.

{
  "allure": {
    "failExceptions": ["NUnit.Framework.AssertionException", "MyNamespace.MyCustomException"]
  }
}