nimut/phpunit-merger

Merge multiple PHPUnit reports into one file

Merge multiple PHPUnit reports into one file

, _(*1)

Sometimes it is necessary to run multiple PHPUnit instances to execute all tests of a project. Unfortunately each run writes its own coverage and log reports. There is no support in PHPUnit to merge the reports of multiple runs., _(*2)

This project provides two commands to merge coverage files as well as log files. It was designed to provide merged reports to e.g. SonarQube Scanner for further processing., _(*3)

Installation

Use Composer to install the testing framework., _(*4)

$ composer require --dev nimut/phpunit-merger

Composer will add the package as a dev requirement to your composer.json and install the package with its dependencies., _(*5)

Usage

Coverage

The coverage command merges files containing PHP_CodeCoverage objects into one file in Clover XML format., _(*6)

$ vendor/bin/phpunit-merger coverage <directory> [--html=<directory>] [<file>]

Arguments, _(*7)

• directory: Directory containing one or multiple files with PHP_CodeCoverage objects
• file: File where the merged result should be stored. Default: Standard output

Options, _(*8)

• html: Directory where the HTML report should be stored
• lowUpperBound: (optional) The lowUpperBound value to be used for HTML format
• highLowerBound: (optional) The highLowerBound value to be used for HTML format

Log

The log command merges files in JUnit XML format into one file in JUnit XML format., _(*9)

$ vendor/bin/phpunit-merger log <directory> <file>

Arguments, _(*10)

• directory: Provides the directory containing one or multiple files in JUnit XML format
• file: File where the merged result should be stored