README

This extension is a modification of the JUnitFormatter that is included in Behat. This version will generate XML files that are compatible with the Jenkins xUnit plugin.

The initial version of this library was based on the JUnit implementation of Behat 3.17.0.

1. Installation

Require the package as a dev dependency via Composer.

composer require --dev cevinio/behat-jenkins-junit

2. Configuration

This extension adds a new formatter called jjunit.

Add the extension to your behat.yml configuration file:

default:
    extensions:
        Cevinio\BehatJenkinsJUnit\JJUnitFormatterExtension: ~
    formatters:
        jjunit:
            enabled: false

The available settings for the formatter:

3. Usage

Use the --format option to start generating the JUnit XML files:

vendor/bin/behat --format jjunit --out <path/to/dir>

Note that the output destination must be a directory, as Behat will generate an XML file per suite. This is identical to how the native JUnit formatter works.