TextUI frontend for PHP_CodeCoverage
PHP
Permalink
Failed to load latest commit information.
build
src Change to make colocar disabled by default Feb 15, 2017
tests Cleanup Feb 3, 2017
.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 Do not apply fixes to build/ directory May 25, 2016
LICENSE Update license and copyright in all files Jan 2, 2015
README.md Update README.md Feb 15, 2017
build.xml Cleanup Feb 3, 2017
composer.json Cleanup Feb 3, 2017
phpcov Update license and copyright in all files Jan 2, 2015
phpunit.xml Cleanup Feb 3, 2017

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