Allure

[Traducción Beta No Oficial]

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Allure es un framework de código abierto diseñado para generar informes de pruebas detallados e interactivos. Funciona generando archivos de reportes que luego se utilizan para crear el informe HTML final. Puedes considerarlo como un informe junit tradicional pero más avanzado y detallado.

consejo

Si prefieres ver un ejemplo en lugar de leer documentación, hay un proyecto de muestra aquí

Allure consta de dos pasos. El primero es generar los datos brutos durante la ejecución de pruebas; el segundo es compilar esos datos en el informe HTML interactivo.

Este módulo proporciona la integración para usar Allure con Kotest. Para comenzar, añade la siguiente dependencia en tu archivo de compilación Gradle.

io.kotest.extensions:kotest-extensions-allure:${kotest.version}

Nota: El group id es diferente (io.kotest.extensions) respecto a las dependencias principales de Kotest (io.kotest).

Recopilar datos

Allure tiene recolectores de datos para la mayoría de frameworks de pruebas, y este módulo proporciona la integración para Kotest. Una vez añadido el módulo a tu build, configura globalmente la clase AllureTestReporter usando la configuración de proyecto.

class MyConfig : AbstractProjectConfig {
    override fun listeners() = listOf(AllureTestReporter())
}

Ahora, cada vez que se ejecuten pruebas, Kotest escribirá los datos de prueba en formato JSON de Allure.

Plugin de Gradle

Una vez completadas las pruebas, podemos compilarlas en el informe final.

Esto puede hacerse manualmente usando el binario de Allure, o podemos usar el plugin de Gradle para Allure. Para usar el plugin de Gradle, primero añádelo en el bloque de plugins de tu build.

plugins {
  ...
  id("io.qameta.allure") version "2.8.1"
}

Luego, añade una sección de configuración de Allure para establecer la versión y desactivar la autocofiguración (porque Allure solo puede autoconfigurar JUnit y Kotest ya se encarga de esto por ti).

allure {
  autoconfigure = false
  version = "2.13.1"
}

Finalmente, ejecuta la tarea de Gradle allureReport y el informe se generará en ./build/reports/allure-report, donde encontrarás el punto de entrada index.html del informe.

Configurar el directorio de compilación

Si no estás usando el plugin de Gradle, deberás indicar a Allure dónde está el directorio de compilación configurando la propiedad de sistema allure.results.directory en tu configuración de pruebas. Si usas el plugin de Gradle, puedes omitir este paso porque el plugin lo gestiona automáticamente.

Por ejemplo:

tasks.named<Test>("test") { // or "jvmTest" etc
   useJUnitPlatform()
   systemProperty("allure.results.directory", project.buildDir.toString() + "/allure-results")
}

Informe final

Si todo ha ido bien, tras la ejecución de pruebas y generación del informe, verás algo similar a esto: