TAP::Harness::JUnit

TAP::Harness::JUnit provides a test harness that runs TAP tests and outputs JUnit-compatible XML.

It is useful for integrating Perl test suites with software that expects JUnit output, for example Jenkins.

Use

To generate JUnit output using prove, supply TAP::Harness::JUnit for the --harness argument to prove:

prove --harness TAP::Harness::JUnit

Environment variables

JUNIT_OUTPUT_FILE - specify the name of the JUnit XML output file. Defaults to junit_output.xml.

JUNIT_PACKAGE - specify a package name for the results.

Installation

Before building it yourself, you may prefer to fetch the package from your Operating System distribution, if one exists. Here's how would you install it in Fedora:

yum -y install 'perl(TAP::Harness::JUnit)'

Otherwise, follow the usual Module::Build convention:

perl Build.pl
./Build
./Build install

The build script will issue a warning when any of required modules is missing or wrong version.

See the POD documentation for more information (on how to use the module, licensing, copyright, etc.):

perldoc TAP::Harness::JUnit

Before installing the module, you can do:

perldoc lib/TAP/Harness/JUnit.pm