gcovr

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

Description

default, --txt

Text Output

compact human-readable summaries

--html

HTML Output

overview of all files

--html-details

HTML Output

annotated source files

--cobertura

Cobertura XML Output

machine readable XML reports in Cobertura format

--sonarqube

Sonarqube XML Output

machine readable XML reports in Sonarqube format

--json

JSON Output

JSON report with source file structure and coverage

--json-summary

JSON Output

JSON summary coverage report

--csv

CSV Output

CSV report summarizing the coverage of each file

--coveralls

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.

Quick Links

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

Contents: