Coverage.py

Coverage.py is a free coverage measurement tool for Python developers who want to see which executable code their tests reach. It is a strong fit for teams that need flexible reports or test-specific coverage without changing how they run test suites. Its faster sysmon core is best for straightforward line and branch measurement, not workflows that depend on contexts or plugins.

Overview

Coverage.py records which parts of a Python program run and identifies executable code that did not run. Statement coverage is the default; branch coverage adds a view of whether alternative paths have been exercised. These measures can expose gaps in test reach, but coverage alone does not show whether tests verify behavior effectively.

The tool can run a test suite through its usual command, making it suitable for existing Python test workflows. The pytest-cov plugin is available, though the project says most users do not need it. Coverage data is stored in SQLite, and the API supports more advanced uses. Coverage.py is licensed under Apache 2.0.

Key features

Measurement, contexts, and reports

Coverage.py produces text, HTML, XML, LCOV, and JSON reports. That range suits both direct inspection and workflows that consume structured output. Dynamic contexts can identify which test function ran particular lines, helping teams investigate coverage at test level instead of relying only on an aggregate result.

There are three measurement cores: ctrace, pytrace, and sysmon. Sysmon is faster for basic line and branch coverage, but it does not support dynamic contexts or plugins. Teams that need to associate lines with tests or extend measurement to other file types should use a compatible core rather than trade those capabilities for sysmon's speed.

Extensibility and compatibility

Third-party plugins can extend measurement to non-Python files, including mapping executed Python back to Django HTML templates. This is useful when a Python application renders templates and teams want coverage beyond Python source; it also means plugin-dependent workflows cannot use sysmon.

The current documentation lists Python 3.10 through 3.15 rc2, including free-threading, and PyPy3 versions 3.10 and 3.11. That interpreter range gives teams options across standard Python and PyPy environments, including a release candidate. Coverage.py supports Python, and its stated platforms include API, Linux, macOS, self-hosted deployments, and Windows.

Pricing

The free plan is the tool itself, making it a suitable choice for individual developers and teams seeking Python coverage without a software charge. Enterprise support is available through a Tidelift Subscription; it is a separate route for organizations that want professional support rather than a different core coverage feature set.

Platforms

Coverage.py is listed for Linux, macOS, and Windows, and supports self-hosted use. The API is also a supported platform category. This suits teams running coverage in their own development or test environments rather than requiring a hosted service.

Who it's for

Coverage.py is for Python developers and teams evaluating which code their tests exercise. It is particularly well suited to projects that benefit from branch coverage, multiple report formats, test-specific contexts, or plugins for non-Python files. Teams focused on simple line and branch reports may prefer sysmon's speed; those requiring contexts or plugins should avoid that core.

Pros and cons

Pros

• Statement and optional branch coverage help teams examine both executed lines and conditional paths.
• Five report formats accommodate readable output and structured downstream use.
• Dynamic contexts connect executed lines to test functions, making test-level investigation possible.
• Third-party plugins can extend measurement to files such as Django templates.
• The free, Apache 2.0-licensed tool stores data in SQLite and offers an API for advanced use.

Cons

• Sysmon does not support dynamic contexts or plugins, so speed comes at a cost for those workflows.
• Coverage measures code execution, not whether tests meaningfully check the behavior they exercise.
• Professional support is a separate Tidelift Subscription rather than part of the free tool.

Alternatives

For other options, see the Test Coverage Tools directory.

• OpenClover is another free option, with Linux, macOS, web, and Windows platforms and no license tiers, keys, or usage limits stated for its free plan.
• SimpleCov is a free, MIT-licensed Ruby code coverage tool, making it the relevant choice for Ruby rather than Python projects.
• Coveralls offers a free option for open-source and public repositories, so it may suit teams seeking coverage reporting for those projects.
• Coverlet is a free option for modern .NET SDK-style projects, rather than Python codebases.
• EclEmma is a free Eclipse plug-in for Java code coverage.
• gcov is a free alternative for code compiled with GCC; it requires coverage instrumentation to generate data.
• gofmt is a free executable included in Go installations and used from the command line.
• LLVM llvm-cov is a free open-source LLVM tool with no paid plans or usage limits stated.

Verdict

Choose Coverage.py if you need a free, flexible way to measure Python test coverage, especially when branch reports, test-specific contexts, or plugins matter. Its strongest case is the combination of broad reporting and integration with existing test commands; look elsewhere if you need coverage for another language, and avoid sysmon when your workflow depends on contexts or plugins.