b3kn/clover-merge-with-psr

Merge two or more clover XML files.

1.0.6 2023-11-29 18:20 UTC

Requires

• captainhook/captainhook: ^3.1
• php-ds/php-ds: ^1.2
• vanilla/garden-cli: ^4.0

Requires (Dev)

• b3kn/php-coveralls-with-psr: ^2.7.2
• kahlan/kahlan: ^4.2
• phan/phan: ^5.4.2
• squizlabs/php_codesniffer: ^3.3

Suggests

• ext-ds: to improve performance and reduce memory usage

MIT

• Dylan McGannon

README

PHP utility to merge two or more clover files into a single document.

Intended to be used in a build pipeline to merge clover output from multiple testing frameworks.

I spent a weekend writing this so you don't have to.

Standalone

Install

Requires composer.

$ git clone https://github.com/d0x2f/CloverMerge.git
$ composer install

Run

$ ./clover-merge -o combined.xml input1.xml input2.xml
Files Discovered: 332
Final Coverage: 14534/14558 (99.84%)

As a Composer Dependency

Install

In your project root directory:

$ composer require d0x2f/clover-merge

Run

$ ./vendor/bin/clover-merge -o combined.xml input1.xml input2.xml
Files Discovered: 332
Final Coverage: 14534/14558 (99.84%)

As a Docker Image

Install

$ docker pull d0x2f/clover-merge

Run

$ docker run --rm -v $(pwd):/build clover-merge -o /build/combined.xml /build/input1.xml /build/input2.xml
Files Discovered: 332
Final Coverage: 14534/14558 (99.84%)

Usage

usage: clover-merge [<options>] [<args>]

OPTIONS
  --enforce, -e   Exit with failure if final coverage is below the given
                  threshold
  --help, -?      Display this help.
  --mode, -m      merge mode: additive, exclusive or inclusive (default)
  --output, -o    output file path

ARGUMENTS
  paths   input file paths

Modes

• Additive - Lines must be present in the first input file for them to be included.
• Exclusive - Lines must be present in all input files for them to be included.
• Inclusive - Lines from all files are included.