TestNG listener integration for Allure Java.

Use this module when your test suite runs on TestNG and you want TestNG suites, tests, configuration methods, parameters, and failures to appear in Allure Report.

• Allure Java 3.x requires Java 17 or newer.
• This module targets TestNG 7.x.
• The current build validates against TestNG 7.12.0.

Gradle:

dependencies {
    testImplementation(platform("io.qameta.allure:allure-bom:<allure-version>"))
    testImplementation("io.qameta.allure:allure-testng")
}

Maven, with allure-bom imported in dependency management:

<dependency>
    <groupId>io.qameta.allure</groupId>
    <artifactId>allure-testng</artifactId>
    <scope>test</scope>
</dependency>

The module exposes io.qameta.allure.testng.AllureTestNg as a TestNG listener through service loader metadata. You can also register it explicitly in testng.xml or with @Listeners.

import io.qameta.allure.testng.AllureTestNg;
import org.testng.annotations.Listeners;

@Listeners(AllureTestNg.class)
class MyTest {
}

• TestNG suites, tests, classes, methods, configuration methods, and data-provider invocations.
• Suite and test fixtures represented as Allure scopes.
• Labels, links, parameters, JavaDoc descriptions, status details, and test-plan filtering.
• Attachments and steps added in configuration success, failure, and skip listeners stay on the corresponding fixture. Automatic listener ordering uses TestNG 7.10 or newer; older versions retain their default configuration-listener order.