jnclt / cucumber-reporting

standalone cucumber-reporting

Publish pretty cucumber reports

This is a Java report publisher primarily created to publish cucumber reports on the Jenkins build server.It publishes pretty html reports showing the results of cucumber runs. It has been split out into a standalone package so it can be used for Jenkins and maven command line as well as any other packaging that might be useful.

Background

Cucumber is a test automation tool following the principles of Behavioural Driven Design and living documentation. Specifications are written in a concise human readable form and executed in continuous integration.

This project allows you to publish the results of a cucumber run as pretty html reports. In order for this to work you must generate a cucumber json report. The project converts the json report into an overview html linking to separate feature file htmls with stats and results.

Install

1. Add a maven dependency to your pom

2. Or grab the jar file from the downloads page

Read this if you need further [detailed install and configuration] (https://github.com/masterthought/jenkins-cucumber-jvm-reports-plugin-java/wiki/Detailed-Configuration) instructions for using the Jenkins version of this project

Release Notes

Release notes are here

Use

File reportOutputDirectory = new File("/path/to/report/output/directory/e.g./cucumber-html-reports");
List<String> jsonReportFiles = new ArrayList<String>();
list.add("/path/to/a/cucumber/json/report/e.g./cucumber_1.json");
list.add("/path/to/another/cucumber/json/report/e.g./cucumber_2.json");

String buildNumber = "1";
String buildProjectName = "super_project";
Boolean skippedFails = false;
Boolean undefinedFails = false;
Boolean flashCharts = true;
Boolean runWithJenkins = true;
ReportBuilder reportBuilder = new ReportBuilder(list,rd,"","95","cucumber-jvm",false,false,true,true,false,"");
reportBuilder.generateReports();

skippedFails means the build will be failed if any steps are in skipped status and undefinedFails means the build will be failed if any steps are in undefined status. This only applies when running with Jenkins. flashCharts means either use the default flashcharts or use the D3 javascript charts. runWithJenkins means put in the links back to jenkins in the report.

There is a feature overview page:

![feature overview page] (https://github.com/masterthought/cucumber-reporting/raw/master/.README/feature-overview.png)

And there are also feature specific results pages:

![feature specific page passing] (https://github.com/masterthought/cucumber-reporting/raw/master/.README/feature-passed.png)

And useful information for failures:

![feature specific page passing] (https://github.com/masterthought/cucumber-reporting/raw/master/.README/feature-failed.png)

If you have tags in your cucumber features you can see a tag overview:

![Tag overview] (https://github.com/masterthought/cucumber-reporting/raw/master/.README/tag-overview.png)

And you can drill down into tag specific reports:

![Tag report] (https://github.com/masterthought/cucumber-reporting/raw/master/.README/tag-report.png)

Develop

Interested in contributing to the cucumber-reporting? Great! Start [here] (https://github.com/masterthought/cucumber-reporting).