TextUI frontend for PHP_CodeCoverage
PHP
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
build
src Prepare release Nov 18, 2017
tests
.gitattributes Make the output of git-diff and git-grep more useful for PHP sourcefi… Jan 24, 2012
.gitignore Cleanup Feb 3, 2017
.php_cs
LICENSE
README.md
build.xml
composer.json
phpcov
phpunit.xml

README.md

phpcov

phpcov is a command-line frontend for the PHP_CodeCoverage library.

Installation

PHP Archive (PHAR)

The easiest way to obtain phpcov is to download a PHP Archive (PHAR) that has all required dependencies of phpcov bundled in a single file:

$ wget https://phar.phpunit.de/phpcov.phar
$ chmod +x phpcov.phar
$ mv phpcov.phar /usr/local/bin/phpcov

You can also immediately use the PHAR after you have downloaded it, of course:

$ wget https://phar.phpunit.de/phpcov.phar
$ php phpcov.phar

Composer

You can add this tool as a local, per-project, development-time dependency to your project using Composer:

$ composer require --dev phpunit/phpcov

You can then invoke it using the vendor/bin/phpcov executable.

Usage

Patch Coverage

$ git diff HEAD^1 > /tmp/patch.txt

$ phpunit --coverage-php /tmp/coverage.cov

$ phpcov patch-coverage /tmp/coverage.cov              \
                        --patch /tmp/patch.txt         \
                        --path-prefix /path/to/project
phpcov 2.0.0 by Sebastian Bergmann.

1 / 2 changed executable lines covered (50.00%)

Changed executable lines that are not covered:

  Example.php:11

Merging exported PHP_CodeCoverage objects stored in *.cov files

$ parallel --gnu :::                                                 \
    'phpunit --coverage-php /tmp/coverage/FooTest.cov tests/FooTest' \
    'phpunit --coverage-php /tmp/coverage/BarTest.cov tests/BarTest'

$ phpcov merge /tmp/coverage --clover /tmp/clover.xml
phpcov 2.0.0 by Sebastian Bergmann.

Generating code coverage report in Clover XML format ... done

Executing a PHP script and generating code coverage in Clover XML format

$ phpcov execute script.php --clover coverage.xml
phpcov 2.0.0 by Sebastian Bergmann.

Generating code coverage report in Clover XML format ... done