gcovr

Overview

For C and C++ teams already building with GCC coverage flags, gcovr provides a compact command-line step between running tests and reviewing coverage. Its broad report output is useful in automated pipelines; the important caveat is that its branch numbers reflect GCC’s low-level control-flow arcs, not only source-level decisions.

Users compile with coverage flags, run their test suite, then invoke gcovr to collect and summarize the results. It is a coverage reporting tool, not a test runner, and it is positioned as a command-line alternative to lcov. The BSD 3-Clause license permits use and redistribution of source and binary forms subject to its conditions.

Key features

Report-format choice is gcovr’s strongest practical advantage. It produces text, HTML, CSV, JSON and Markdown, as well as Clover XML, Cobertura XML, Coveralls JSON, JaCoCo XML, LCOV and SonarQube-compatible output. That lets teams generate a local summary and files for downstream tools from the same coverage workflow.

HTML output supports overview and annotated-source views, nested reports, self-contained files, themes and customizable templates. Configuration files, exclusion markers and reproducible timestamps help teams make report generation more consistent. Filters can narrow coverage-data searches and filter symlinks, which is useful when a project’s data tree is larger or more complicated than the code a team wants to measure.

Coverage gates are supported, but branch coverage needs careful interpretation: gcovr reports GCC’s -fprofile-arcs control-flow graph arcs, which can include compiler-generated branches. As a result, 100% branch coverage is impossible for most programs. The --decisions option parses source to provide a decision-coverage metric, a useful distinction when arc counts are not a good proxy for source-level decisions.

For CI, Cobertura XML can be imported into Jenkins and Hudson through coverage plugins. SonarQube-compatible XML can carry line, branch, condition or decision metrics; JaCoCo XML includes line, branch and method counters. These formats make gcovr useful as a report producer in existing pipelines, rather than a replacement for their dashboards.

Pricing

gcovr is free, with no paid plan described. It is distributed as a Python package installable with pip; development versions can be installed from GitHub. The current release supports Python 3.10 and newer, so older Python environments are a practical compatibility constraint.

Platforms

gcovr supports Linux, Windows and macOS. Its documented runtime context is Python 3.10 or newer alongside GCC or Clang; development testing covers both compilers. Pull requests are automatically tested on Windows and Linux, and project code coverage is collected.

Who it's for

gcovr suits C and C++ developers who need coverage summaries or want to feed report files into Jenkins, Hudson, SonarQube or other workflows that consume its supported formats. Its command-line approach and configuration options favor teams comfortable adding a reporting step to a build-and-test process. Readers seeking a graphical standalone coverage environment or coverage collection independent of GCC-style data should look elsewhere.

Help is directed through GitHub tickets, Stack Overflow and Gitter. The project lists Lukas Atkinson and Michael Förderer as maintainers.

Pros and cons

• Pro: A wide selection of report formats lets one tool serve terminal summaries, HTML review and multiple CI or analysis integrations.
• Pro: HTML views, templates, filters and exclusion markers provide useful control over how reports are presented and which data they include.
• Con: Branch results can count compiler-generated arcs, making raw percentages less intuitive and a 100% target unattainable for most programs.
• Con: The workflow depends on GCC coverage data and Python 3.10 or newer, so it is not a general-purpose fit for every language or runtime.

Alternatives

For a broader comparison, see the Test Coverage Tools category. Choose Coveralls instead when its hosted coverage service and stated free access for open-source and public repositories better fit the workflow. OpenClover is another free option, with no usage limits stated for its free plan.

ReportGenerator offers a free basic plan and a 10-day full-access trial; its listed Individual plan is priced at 79. SimpleCov is the free, MIT-licensed option specifically for Ruby coverage. Coverage.py is a free open-source choice for Python coverage, with an enterprise subscription available through Tidelift.

For modern .NET SDK-style projects, Coverlet is free and specifically supports that project type. gofmt is a free command-line executable included with Go installations. Codecov is a freemium option with a Developer plan that allows one user for open-source projects or unlimited users for private projects, alongside 250 private-repository uploads and unlimited public repositories.

Verdict

Choose gcovr if you maintain C or C++ projects using GCC coverage data and want one free command-line tool to create reports for people and CI systems. Its format range and configuration options make it adaptable, but teams that depend on straightforward source-level branch percentages should account for GCC arc semantics—or choose a tool aligned with their preferred coverage model.