misiuziu/phpunit-coverage-check

Check the code coverage using the clover report of phpunit

0.2.0 2019-10-21 12:47 UTC

Requires

• php: >=5.5.0

MIT

• Richard Regeer
• Tomasz Sierżański

• php
• testing
• phpunit
• ci
• unittest
• code coverage

README

phpunit-coverage-check

This php script will read the clover xml report from phpunit and calculates the coverage score. Based on the given threshold the script will exit ok of the coverage is higher then the threshold or exit with code 1 if the coverage is lower then the threshold. This script can be used in your continuous deployment environment or for example added to a pre-commit hook.

Installation

The script can be installed using composer. Add this repository as a dependency to the composer.json file.

composer require --dev rregeer/phpunit-coverage-check
composer install

Usage

The script has requires 2 parameters that are mandatory to return the code coverage.

1. The location of the clover xml file, that's generated by phpunit.
2. The coverage threshold that is acceptable. Min = 1, Max = 100

Generate the clover xml by using phpunit and run the coverage check script: Run the script:

vendor/bin/phpunit --coverage-clover clover.xml
vendor/bin/coverage-check clover.xml 80

It's also possible to add the coverage report generation to the phpunit.xml.dist add to following line to the xml file:

<logging>
    <log type="coverage-clover" target="clover.xml"/>
</logging>

For more information see the phpunit documentation. Information about the configuration file and commandline options.