Allure 2

Allure is a framework/tool which generates comprehensive reports for your test executions. This happens in two steps:

1. The test results are captured and written to json files
2. The json files are transformed into beautiful reports

Please consult the Allure website to obtain further information about Allure.

The Allure module acts as an adapter between tapir’s Notification API and Allure’s Reporting API. If the optional module is in the classpath at test runtime, the corresponding xml files are generated. These xml files are picked up by Allure and transformed into a good-looking report.

Dependency

<dependency>
  <groupId>io.tapir-test</groupId>
  <artifactId>tapir-extensions-allure2</artifactId>
  <version>1.3.0</version>
</dependency>

Example

The screenshot below displays a sample test execution report.

Maven

Allure integrates seamlessly into Maven by providing a dedicated plugin. If you use JUnit 4 or JUnit 5, consult the corresponding documentation.

In general you can just use this command:

> mvn clean test allure:serve

Maven fires up a web server and starts the browser which renders the Allure report.

Jenkins

Allure provides a plugin for Jenkins. Please consult the documentation on their website, but in general the defaults are fine to work with tapir. 

The Allure Report is stored for every build and you can switch from the Jenkins UI to the Allure report and vice versa.