gcovr

generate GCC code coverage reports

website and documentation • bugtracker • GitHub

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
`--html-template-dir`	HTML Output	use custom set of Jinja2 templates
`--csv`	CSV Output	CSV report summarizing the coverage of each file
`--json`	JSON Output	JSON report with source file structure and coverage
`--json-summary`	JSON Output	JSON summary coverage report
`--markdown`	Markdown Output	Markdown coverage report
`--markdown-summary`	Markdown Output	Markdown summary coverage report
`--clover`	Clover XML Output	machine readable XML reports in Clover format
`--cobertura`	Cobertura XML Output	machine readable XML reports in Cobertura format
`--coveralls`	Coveralls JSON Output	machine readable JSON report in Coveralls format
`--jacoco`	JaCoCo XML Output	machine readable XML reports in JaCoCo format
`--lcov`	LCOV info Output	machine readable report in LCOV info format
`--sonarqube`	SonarQube XML Output	machine readable XML reports in SonarQube 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.

Example HTML summary:

Example HTML details:

Installation

Gcovr is available as a Python package that can be installed via pip.

Install newest stable gcovr release from PyPI:

pip install gcovr

Install development version from GitHub (needs at least version 21.3 of pip):

pip install git+https://github.com/gcovr/gcovr.git

Quickstart

GCC can instrument the executables to emit coverage data. You need to recompile your code with the following flags:

--coverage -g -O0

Next, run your test suite. This will generate raw coverage files.

Finally, invoke gcovr. This will print a tabular report on the console.

gcovr

You can also generate detailed or nested HTML reports:

gcovr --html-details coverage.html
gcovr --html-nested coverage.html

Gcovr will create one HTML report per source file and for --html-nested also per directory next to the coverage.html summary.

You should run gcovr from the build directory. The -r option should point to the root of your project. This only matters if you have a separate build directory. For example:

cd build; gcovr -r ..

For complete documentation, read the manual.

Contributing

If you want to report a bug or contribute to gcovr development, please read our contributing guidelines first: https://gcovr.com/en/latest/contributing.html

License

This software is distributed under the 3-clause BSD License. See https://gcovr.com/en/latest/license.html#license-terms for details. See https://gcovr.com/en/latest/license.html#acknowledgements for the full list of contributors.

License

omeos-fork/gcovr.gcovr

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages