magician79/php-coverage-tools

CLI tools for normalizing PHP coverage reports by removing non-executable files

v0.1.2 2025-12-26 22:38 UTC

Requires

• php: >=8.3
• ext-dom: *

Requires (Dev)

• magician79/coding-standard: ^2.0

MIT

• Souvik Mitra

• php
• testing
• ci
• coverage
• cobertura

README

Small CLI utilities for normalizing PHP coverage reports.

Why

Coverage tools like Cobertura correctly report interfaces and pure abstract contracts as having zero executable lines. However, many summary generators treat these files as 0% covered, producing misleading health metrics.

This repository contains small, explicit tools that enforce the rule:

Non-executable files must not affect coverage health.

Tools

filter-cobertura

Removes files with lines-valid="0" from a Cobertura XML report.

filter-cobertura input.xml output.xml

This ensures that coverage summaries and badges reflect real executable code.