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 reporte que luego se utilizan para crear el informe HTML final. Podríamos considerarlo como el informe tradicional de JUnit 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 de 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 compilación, 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 generará informes 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 complemento de Gradle para Allure. Para usar el complemento de Gradle, primero añádelo en el bloque de plugins de tu compilación.

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

A continuación, 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 manualmente el directorio de resultados

Si no usas el complemento de Gradle, deberás indicar a Allure dónde está el directorio de resultados configurando la propiedad de sistema allure.results.directory en la configuración de tu tarea de pruebas. Si usas el complemento de Gradle, puedes omitir este paso porque el complemento 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: