Skip to content

Upgrading phpunit/php-code-coverage 8 to 9

Breaking8.0.2 → 9.2.32Breaking21Platform1Deprecated1New12Changed28Fixed41

Full comparisonBack to phpunit/php-code-coverage
BreakingUpgrade verdict

21 breaking changes and a platform requirement change.

In plain terms
  • Renames Filter::addDirectoryToWhitelist() to Filter::includeDirectory().
  • Renames Filter::addFilesToWhitelist() to Filter::includeFiles().
  • Renames Filter::addFileToWhitelist() to Filter::includeFile().
  • Renames Filter::removeDirectoryFromWhitelist() to Filter::excludeDirectory().
Must act Top 5 of 23 that need code or config changes

PHP requirement changed in 9.1.9: ^7.3 → >=7.3.

Adds nikic/php-parser ^4.19.1 || ^5.1.0, sebastian/complexity ^2.0.3, sebastian/lines-of-code ^1.0.4.

Drops phpunit/php-token-stream.

Moves phpunit/php-file-iterator ^3.0 → ^3.0.6, phpunit/php-text-template ^2.0 → ^2.0.4, sebastian/code-unit-reverse-lookup ^2.0 → ^2.0.3, sebastian/environment ^5.0 → ^5.1.5, sebastian/version ^3.0 → ^3.0.2, theseer/tokenizer ^1.1.3 → ^1.2.3. Your build may pick other versions.

What you must change

Breaking21
Renames Filter::addDirectoryToWhitelist() to Filter::includeDirectory().
SebastianBergmann\CodeCoverage\Filter::addDirectoryToWhitelist()SebastianBergmann\CodeCoverage\Filter::includeDirectory()
9.0.0ChangeLog.mdSummarizedView source
Renames Filter::addFilesToWhitelist() to Filter::includeFiles().
SebastianBergmann\CodeCoverage\Filter::addFilesToWhitelist()SebastianBergmann\CodeCoverage\Filter::includeFiles()
9.0.0ChangeLog.mdSummarizedView source
Renames Filter::addFileToWhitelist() to Filter::includeFile().
SebastianBergmann\CodeCoverage\Filter::addFileToWhitelist()SebastianBergmann\CodeCoverage\Filter::includeFile()
9.0.0ChangeLog.mdSummarizedView source
Renames Filter::removeDirectoryFromWhitelist() to Filter::excludeDirectory().
SebastianBergmann\CodeCoverage\Filter::removeDirectoryFromWhitelist()SebastianBergmann\CodeCoverage\Filter::excludeDirectory()
9.0.0ChangeLog.mdSummarizedView source
Renames Filter::removeFileFromWhitelist() to Filter::excludeFile().
SebastianBergmann\CodeCoverage\Filter::removeFileFromWhitelist()SebastianBergmann\CodeCoverage\Filter::excludeFile()
9.0.0ChangeLog.mdSummarizedView source
Renames Filter::isFiltered() to Filter::isExcluded().
SebastianBergmann\CodeCoverage\Filter::isFiltered()SebastianBergmann\CodeCoverage\Filter::isExcluded()
9.0.0ChangeLog.mdSummarizedView source
Renames Filter::getWhitelist() to Filter::files().
SebastianBergmann\CodeCoverage\Filter::getWhitelist()SebastianBergmann\CodeCoverage\Filter::files()
9.0.0ChangeLog.mdSummarizedView source
The arguments for CodeCoverage::__construct() are no longer optional.
CodeCoverage::__construct()
9.0.0ChangeLog.mdSummarizedView source
Removes CodeCoverage::setCacheTokens() and CodeCoverage::getCacheTokens().
CodeCoverage::setCacheTokens()CodeCoverage::getCacheTokens()
9.0.0ChangeLog.mdSummarizedView source
Removes CodeCoverage::setCheckForUnintentionallyCoveredCode(), replaced by enable/disableCheckForUnintentionallyCoveredCode().
CodeCoverage::setCheckForUnintentionallyCoveredCode()CodeCoverage::enableCheckForUnintentionallyCoveredCode()CodeCoverage::disableCheckForUnintentionallyCoveredCode()
9.0.0ChangeLog.mdSummarizedView source
Removes CodeCoverage::setSubclassesExcludedFromUnintentionallyCoveredCodeCheck(), replaced by excludeSubclassesOfThisClassFromUnintentionallyCoveredCodeCheck().
CodeCoverage::setSubclassesExcludedFromUnintentionallyCoveredCodeCheck()CodeCoverage::excludeSubclassesOfThisClassFromUnintentionallyCoveredCodeCheck()
9.0.0ChangeLog.mdSummarizedView source
Removes CodeCoverage::setAddUncoveredFilesFromWhitelist(), replaced by includeUncoveredFiles() or excludeUncoveredFiles().
CodeCoverage::setAddUncoveredFilesFromWhitelist()CodeCoverage::includeUncoveredFiles()CodeCoverage::excludeUncoveredFiles()
9.0.0ChangeLog.mdSummarizedView source
Removes CodeCoverage::setProcessUncoveredFiles(), replaced by processUncoveredFiles() or doNotProcessUncoveredFiles().
CodeCoverage::setProcessUncoveredFiles()CodeCoverage::processUncoveredFiles()CodeCoverage::doNotProcessUncoveredFiles()
9.0.0ChangeLog.mdSummarizedView source
Removes CodeCoverage::setIgnoreDeprecatedCode(), replaced by ignoreDeprecatedCode() or doNotIgnoreDeprecatedCode().
CodeCoverage::setIgnoreDeprecatedCode()CodeCoverage::ignoreDeprecatedCode()CodeCoverage::doNotIgnoreDeprecatedCode()
9.0.0ChangeLog.mdSummarizedView source
Removes CodeCoverage::setDisableIgnoredLines(), replaced by enableAnnotationsForIgnoringCode() or disableAnnotationsForIgnoringCode().
CodeCoverage::setDisableIgnoredLines()CodeCoverage::enableAnnotationsForIgnoringCode()CodeCoverage::disableAnnotationsForIgnoringCode()
9.0.0ChangeLog.mdSummarizedView source
Removes CodeCoverage::setCheckForMissingCoversAnnotation().
CodeCoverage::setCheckForMissingCoversAnnotation()
9.0.0ChangeLog.mdSummarizedView source
Removes CodeCoverage::setCheckForUnexecutedCoveredCode().
CodeCoverage::setCheckForUnexecutedCoveredCode()
9.0.0ChangeLog.mdSummarizedView source
Removes CodeCoverage::setForceCoversAnnotation().
CodeCoverage::setForceCoversAnnotation()
9.0.0ChangeLog.mdSummarizedView source
Removes Filter::hasWhitelist(), replaced by Filter::isEmpty().
Filter::hasWhitelist()Filter::isEmpty()
9.0.0ChangeLog.mdSummarizedView source
Removes Filter::getWhitelistedFiles().
Filter::getWhitelistedFiles()
9.0.0ChangeLog.mdSummarizedView source
Removes Filter::setWhitelistedFiles().
Filter::setWhitelistedFiles()
9.0.0ChangeLog.mdSummarizedView source
Platform1
Adds support for PHP 8.
9.0.0ChangeLog.mdSummarizedView source

Deprecations to plan for

Deprecated1
Deprecates Driver::forLineCoverage() and Driver::forLineAndPathCoverage().
SebastianBergmann\CodeCoverage\Driver\Driver::forLineCoverage()SebastianBergmann\CodeCoverage\Driver\Driver::forLineAndPathCoverage()
9.1.10ChangeLog.mdSummarizedView source