See here for complete docs.
See the Listeners section for usage instructions.
An example project is available here to understand the usage.
Note: when using this adapter, you are not required to add any code in your project. The adapter works for you to generate the report, perform auto-configuration through the configuration file, and you can also enable/disable reporters from the properties file.
See this example of how a test is created, marked with the listener. Note: a good approach is to mark a common base class with the @Listener only once.
import com.aventstack.extentreports.testng.listener.ExtentITestListenerClassAdapter;
@Listeners({ExtentITestListenerClassAdapter.class})
public class SimpleAssertTests {
@Test
public void passTest() {
Assert.assertTrue(true);
}
@Test
public void failTest() {
Assert.assertTrue(false);
}
}
Configuration can be added under src/test/resources as shown here. Note the contents of extent.properties which can be used to enable/disable reporters, set path to the configuration file, and also to output to a desired location.
# spark-reporter
extent.reporter.spark.start=true
extent.reporter.spark.config=
extent.reporter.spark.out=test-output/SparkReport/Index.html
# klov-reporter
extent.reporter.klov.start=false
extent.reporter.klov.config=src/test/resources/klov.properties
# json-reporter
extent.reporter.json.start=false
extent.reporter.json.out=test-output/JsonReport/Extent.json
If you are using Klov (version 1.0+), extra configuration would be required, which can be loaded from extent.reporter.klov.config above.
mongodb.host=127.0.0.1
mongodb.port=27017
mongodb.uri=
klov.host=http://127.0.0.1
klov.port=80
klov.project.name=ProjectName
klov.report.name=
TestNG plugin for ExtentReports is open-source software and licensed under Apache-2.