robiningelbrecht / phpunit-coverage-tools
PHPUnit coverage tools
Installs: 12 339
Dependents: 2
Suggesters: 0
Security: 0
Stars: 17
Watchers: 4
Forks: 2
Open Issues: 0
Requires
- php: ^8.1
- ext-simplexml: *
- ext-xmlreader: *
- phpunit/phpunit: ^10.3||^11.0
- symfony/console: ^5.4||^6.2||^7.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.9
- phpstan/phpstan: ^1.10
- spatie/phpunit-snapshot-assertions: ^5.0
This package is auto-updated.
Last update: 2024-10-27 11:46:36 UTC
README
This extension allows you to enforce minimum code coverage by using the clover xml report from PHPUnit. Based on the given threshold the testsuite will exit ok if the coverage is higher than the threshold or exit with code 1 if the coverage is lower than the threshold. This can be used in your continuous deployment environment or can be added to a pre-commit hook.
Installation
> composer require robiningelbrecht/phpunit-coverage-tools --dev
Configuration
Navigate to your phpunit.xml.dist
file and add following config to set default options:
<extensions> <bootstrap class="RobinIngelbrecht\PHPUnitCoverageTools\PhpUnitExtension"> <parameter name="exitOnLowCoverage" value="0|1"/> <parameter name="cleanUpCloverXml" value="0|1"/> </bootstrap> </extensions>
Usage
Just run your testsuite like you normally would, but add following arguments:
--min-coverage=[INTEGER]
> vendor/bin/phpunit --coverage-clover=path/to/clover.xml -d --min-coverage=100
When assigning an integer between 0 - 100, you enforce a minimum code coverage for all your classes. In other words, the total coverage of your project has to be higher than this threshold.
--min-coverage=[path/to/min-coverage-rules.php]
> vendor/bin/phpunit --coverage-clover=path/to/clover.xml -d --min-coverage="path/to/min-coverage-rules.php"
When referencing a PHP config file, you can configure more complex rules. This allows you to be stricter for critical parts of your application and less strict for parts of your app that are not that critical.
For example:
<?php use RobinIngelbrecht\PHPUnitCoverageTools\MinCoverage\MinCoverageRule; return [ new MinCoverageRule( pattern: MinCoverageRule::TOTAL, minCoverage: 20, exitOnLowCoverage: true ), new MinCoverageRule( pattern: 'RobinIngelbrecht\PHPUnitCoverageTools\*', minCoverage: 80, exitOnLowCoverage: false ), new MinCoverageRule( pattern: 'RobinIngelbrecht\PHPUnitCoverageTools\Subscriber\Application\ApplicationFinishedSubscriber', minCoverage: 100, exitOnLowCoverage: true ), new MinCoverageRule( pattern: 'RobinIngelbrecht\PHPUnitCoverageTools\*CommandHandler', minCoverage: 100, exitOnLowCoverage: true ), ];
This example will enforce:
- A minimum total coverage of 20%
- A minimum coverage of 80% for all classes in namespace
RobinIngelbrecht\PHPUnitCoverageTools
, but will NOTexit = 1
if it fails - 100% code coverage for the class
ApplicationFinishedSubscriber
- 100% code coverage for the classes ending with
CommandHandler
--clean-up-clover-xml
Adding this argument will clean up the generated clover file after the application has finished running.