Gcovr provides a utility for managing the use of the GNU gcov utility and generating summarized code coverage results. This command is inspired by the Python coverage.py package, which provides a similar utility for Python.

The gcovr command can produce different kinds of coverage reports:

CLI Option

User Guide


default, --txt

Text Output

compact human-readable summaries


HTML Output

overview of all files


HTML Output

annotated source files


Cobertura XML Output

machine readable XML reports in Cobertura format


Sonarqube XML Output

machine readable XML reports in Sonarqube format


JSON Output

JSON report with source file structure and coverage


JSON Output

JSON summary coverage report


CSV Output

CSV report summarizing the coverage of each file


Coveralls JSON Output

machine readable JSON report in Coveralls format

Thus, gcovr can be viewed as a command-line alternative to the lcov utility, which runs gcov and generates an HTML-formatted report. The development of gcovr was motivated by the need for text summaries and XML reports.

This documentation (https://gcovr.com/) describes gcovr 6.0.