deprecate in favor of a plugin about peridot-code-coverage-reporters

[shadowhand]

Yes please. The current state of code coverage with peridot is this:

• this package requires the usage of phpdbg
• this package doesn't actually generate any coverage itself
• phpdbg is not available as a homebrew package (at least not in core + php sources)
• conclusion: this is not usable by most php developers

All I want is a peridot plugin I can install and enable to get code coverage, like PHPUnit has been doing for ages.

Refs #12

[ezzatron]

@shadowhand I hear your frustration, and I know this package, and particularly the docs, are not perfect. But to be fair:

• This package doesn't require phpdbg, it simply uses sebastianbergmann/php-code-coverage, which can use either phpdbg or xdebug.
• It doesn't generate coverage, but it does handle the required glue to add information such as which tests cover which lines to the HTML coverage report generated by sebastianbergmann/php-code-coverage.
• phpdbg can be installed via brew using the --with-phpdbg flag when installing PHP. See my dotfiles for an example. It's slow because it requires compilation, but it works fine.
• There's not a lot of difference here to how PHPUnit coverage works. As far as I know, you need either phpdbg or xdebug to generate coverage there too. It is the same coverage library after all.

I think this particular GitHub issue was more about the fact that you couldn't (at the time), run coverage and see dot/spec output at the same time. This has since been addressed by adding support for multiple reporters.