Repository files navigation

Code coverage measurement for Python.

Coverage.py measures code coverage, typically during test execution. It usesthe code analysis tools and tracing hooks provided in the Python standardlibrary to determine which lines are executable, and which have been executed.

Coverage.py runs on these versions of Python:

• Python 3.10 through 3.15 alpha, including free-threading.
• PyPy3 versions 3.10 and 3.11.

Documentation is onRead the Docs. Code repository and issue tracker are onGitHub.

New in 7.x:[run] patch setting;--save-signal option;[run] core setting;[run] source_dirs setting;Coverage.branch_stats();multi-line exclusion patterns;function/class reporting;experimental support for sys.monitoring;dropped support for Python up to 3.9;addedCoverage.collect() context manager;improved data combining;[run] exclude_also setting;report --format=;type annotations.

New in 6.x:dropped support for Python 2.7, 3.5, and 3.6;write data on SIGTERM;added support for 3.10 match/case statements.

Available as part of the Tidelift Subscription.Coverage and thousands of other packages are working withTidelift to deliver one enterprise subscription that covers all of the opensource you use. If you want the flexibility of open source and the confidenceof commercial-grade software, this is for you.Learn more.

Looking to runcoverage on your test suite? See theQuick Start sectionof the docs.

The complete history of changes is on thechange history page.

Everyone participating in the coverage.py project is expected to treat otherpeople with respect and to follow the guidelines articulated in thePythonCommunity Code of Conduct.

Found a bug? Want to help improve the code or documentation? See theContributing section of the docs.

To report a security vulnerability, please use theTidelift securitycontact. Tidelift will coordinate the fix and disclosure.

Licensed under theApache 2.0 License. For details, seeNOTICE.txt.