Code coverage measurement for Python
Project Links
Meta
Author: Ned Batchelder and 240 others
Requires Python: >=3.9
Classifiers
Environment
- Console
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
- Python
- Python :: 3
- Python :: 3.9
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
- Python :: 3.14
- Python :: Implementation :: CPython
- Python :: Implementation :: PyPy
Topic
- Software Development :: Quality Assurance
- Software Development :: Testing
Development Status
- 5 - Production/Stable
Code coverage measurement for Python.
Coverage.py measures code coverage, typically during test execution. It uses the code analysis tools and tracing hooks provided in the Python standard library to determine which lines are executable, and which have been executed.
Coverage.py runs on these versions of Python:
Python 3.9 through 3.14 beta 1, including free-threading.
PyPy3 versions 3.9, 3.10, and 3.11.
Documentation is on Read the Docs. Code repository and issue tracker are on GitHub.
New in 7.x: [run] source_dirs setting; Coverage.branch_stats(); multi-line exclusion patterns; function/class reporting; experimental support for sys.monitoring; dropped support for Python 3.7 and 3.8; added Coverage.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.
For Enterprise
|
Available as part of the Tidelift Subscription. Coverage and thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. If you want the flexibility of open source and the confidence of commercial-grade software, this is for you. Learn more. |
Getting Started
Looking to run coverage on your test suite? See the Quick Start section of the docs.
Change history
The complete history of changes is on the change history page.
Code of Conduct
Everyone participating in the coverage.py project is expected to treat other people with respect and to follow the guidelines articulated in the Python Community Code of Conduct.
Contributing
Found a bug? Want to help improve the code or documentation? See the Contributing section of the docs.
Security
To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.
License
Licensed under the Apache 2.0 License. For details, see NOTICE.txt.
7.8.2
May 23, 2025
7.8.1
May 21, 2025
7.8.0
Mar 30, 2025
7.7.1
Mar 21, 2025
7.7.0
Mar 16, 2025
7.6.12
Feb 11, 2025
7.6.11
Feb 08, 2025
7.6.10
Dec 26, 2024
7.6.9
Dec 06, 2024
7.6.8
Nov 24, 2024
7.6.7
Nov 15, 2024
7.6.6
Nov 15, 2024
7.6.5
Nov 14, 2024
7.6.4
Oct 20, 2024
7.6.3
Oct 13, 2024
7.6.2
Oct 09, 2024
7.6.1
Aug 04, 2024
7.6.0
Jul 11, 2024
7.5.4
Jun 22, 2024
7.5.3
May 28, 2024
7.5.2
May 26, 2024
7.5.1
May 04, 2024
7.5.0
Apr 23, 2024
7.4.4
Mar 14, 2024
7.4.3
Feb 23, 2024
7.4.2
Feb 20, 2024
7.4.1
Jan 26, 2024
7.4.0
Dec 27, 2023
7.3.4
Dec 20, 2023
7.3.3
Dec 14, 2023
7.3.2
Oct 02, 2023
7.3.1
Sep 06, 2023
7.3.0
Aug 12, 2023
7.2.7
May 29, 2023
7.2.6
May 24, 2023
7.2.5
Apr 30, 2023
7.2.4
Apr 28, 2023
7.2.3
Apr 06, 2023
7.2.2
Mar 16, 2023
7.2.1
Feb 26, 2023
7.2.0
Feb 23, 2023
7.1.0
Jan 25, 2023
7.0.5
Jan 10, 2023
7.0.4
Jan 07, 2023
7.0.3
Jan 04, 2023
7.0.2
Jan 02, 2023
7.0.1
Dec 23, 2022
7.0.0
Dec 18, 2022
7.0.0b1
Dec 03, 2022
6.6.0b1
Oct 31, 2022
6.5.0
Sep 29, 2022
6.4.4
Aug 16, 2022
6.4.3
Aug 06, 2022
6.4.2
Jul 12, 2022
6.4.1
Jun 02, 2022
6.4
May 22, 2022
6.3.3
May 12, 2022
6.3.2
Feb 20, 2022
6.3.1
Feb 02, 2022
6.3
Jan 25, 2022
6.2
Nov 27, 2021
6.1.2
Nov 11, 2021
6.1.1
Oct 31, 2021
6.1
Oct 30, 2021
6.0.2
Oct 11, 2021
6.0.1
Oct 07, 2021
6.0
Oct 03, 2021
6.0b1
Jul 18, 2021
5.6b1
Apr 13, 2021
5.5
Feb 28, 2021
5.4
Jan 26, 2021
5.3.1
Dec 19, 2020
5.3
Sep 13, 2020
5.2.1
Jul 24, 2020
5.2
Jul 06, 2020
5.1
Apr 12, 2020
5.0.4
Mar 16, 2020
5.0.3
Jan 12, 2020
5.0.2
Jan 05, 2020
5.0.1
Dec 22, 2019
5.0
Dec 14, 2019
5.0b2
Dec 08, 2019
5.0b1
Nov 11, 2019
5.0a8
Oct 03, 2019
5.0a7
Sep 21, 2019
5.0a6
Jul 16, 2019
5.0a5
May 07, 2019
5.0a4
Nov 25, 2018
5.0a3
Oct 06, 2018
5.0a2
Sep 03, 2018
5.0a1
Jun 05, 2018
4.5.4
Jul 29, 2019
4.5.3
Mar 10, 2019
4.5.2
Nov 12, 2018
4.5.1
Feb 10, 2018
4.5
Feb 03, 2018
4.4.2
Nov 05, 2017
4.4.1
May 15, 2017
4.4
May 07, 2017
4.4b1
Apr 04, 2017
4.3.4
Jan 17, 2017
4.3.3
Jan 17, 2017
4.3.2
Jan 17, 2017
4.3.1
Dec 28, 2016
4.3
Dec 27, 2016
4.2
Jul 26, 2016
4.2b1
Jul 04, 2016
4.1
May 21, 2016
4.1b3
May 10, 2016
4.1b2
Jan 23, 2016
4.1b1
Jan 11, 2016
4.0.3
Nov 24, 2015
4.0.2
Nov 04, 2015
4.0.1
Oct 13, 2015
4.0
Sep 20, 2015
4.0b3
Sep 07, 2015
4.0b2
Aug 22, 2015
4.0b1
Aug 03, 2015
4.0a6
Jun 21, 2015
4.0a5
Feb 17, 2015
4.0a4
Jan 26, 2015
4.0a3
Jan 21, 2015
4.0a2
Jan 15, 2015
4.0a1
Sep 27, 2014
3.7.1
Dec 13, 2013
3.7
Oct 06, 2013
3.6
Jan 06, 2013
3.6b3
Dec 29, 2012
3.6b2
Dec 24, 2012
3.6b1
Nov 29, 2012
3.5.3
Sep 30, 2012
3.5.2
May 04, 2012
3.5.2b1
Apr 29, 2012
3.5.1
Sep 23, 2011
3.5.1b1
Aug 31, 2011
3.5
Jun 29, 2011
3.5b1
Jun 05, 2011
3.4
Sep 19, 2010
3.4b2
Sep 06, 2010
3.4b1
Aug 21, 2010
3.3.1
Mar 07, 2010
3.3
Feb 25, 2010
3.2
Dec 05, 2009
3.2b4
Dec 01, 2009
3.2b3
Nov 23, 2009
3.2b2
Nov 20, 2009
3.2b1
Nov 11, 2009
3.1
Oct 05, 2009
3.1b1
Sep 27, 2009
3.0.1
Aug 30, 2009
3.0
Jun 14, 2009
3.0b3
May 16, 2009
0.0rc0
May 16, 2009
Wheel compatibility matrix
Files in release
coverage-7.8.2-cp310-cp310-macosx_10_9_x86_64.whl (206.6KiB)
coverage-7.8.2-cp310-cp310-macosx_11_0_arm64.whl (207.0KiB)
coverage-7.8.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (235.5KiB)
coverage-7.8.2-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (233.4KiB)
coverage-7.8.2-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (234.5KiB)
coverage-7.8.2-cp310-cp310-musllinux_1_2_aarch64.whl (234.5KiB)
coverage-7.8.2-cp310-cp310-musllinux_1_2_i686.whl (233.2KiB)
coverage-7.8.2-cp310-cp310-musllinux_1_2_x86_64.whl (233.5KiB)
coverage-7.8.2-cp310-cp310-win32.whl (209.1KiB)
coverage-7.8.2-cp310-cp310-win_amd64.whl (210.0KiB)
coverage-7.8.2-cp311-cp311-macosx_10_9_x86_64.whl (206.7KiB)
coverage-7.8.2-cp311-cp311-macosx_11_0_arm64.whl (207.1KiB)
coverage-7.8.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (239.0KiB)
coverage-7.8.2-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (236.7KiB)
coverage-7.8.2-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (238.5KiB)
coverage-7.8.2-cp311-cp311-musllinux_1_2_aarch64.whl (238.1KiB)
coverage-7.8.2-cp311-cp311-musllinux_1_2_i686.whl (236.4KiB)
coverage-7.8.2-cp311-cp311-musllinux_1_2_x86_64.whl (236.9KiB)
coverage-7.8.2-cp311-cp311-win32.whl (209.2KiB)
coverage-7.8.2-cp311-cp311-win_amd64.whl (210.1KiB)
coverage-7.8.2-cp311-cp311-win_arm64.whl (208.5KiB)
coverage-7.8.2-cp312-cp312-macosx_10_13_x86_64.whl (206.9KiB)
coverage-7.8.2-cp312-cp312-macosx_11_0_arm64.whl (207.2KiB)
coverage-7.8.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (240.4KiB)
coverage-7.8.2-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (237.4KiB)
coverage-7.8.2-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (239.6KiB)
coverage-7.8.2-cp312-cp312-musllinux_1_2_aarch64.whl (239.4KiB)
coverage-7.8.2-cp312-cp312-musllinux_1_2_i686.whl (237.6KiB)
coverage-7.8.2-cp312-cp312-musllinux_1_2_x86_64.whl (238.8KiB)
coverage-7.8.2-cp312-cp312-win32.whl (209.3KiB)
coverage-7.8.2-cp312-cp312-win_amd64.whl (210.1KiB)
coverage-7.8.2-cp312-cp312-win_arm64.whl (208.5KiB)
coverage-7.8.2-cp313-cp313-macosx_10_13_x86_64.whl (206.9KiB)
coverage-7.8.2-cp313-cp313-macosx_11_0_arm64.whl (207.2KiB)
coverage-7.8.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (239.8KiB)
coverage-7.8.2-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (237.0KiB)
coverage-7.8.2-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (238.9KiB)
coverage-7.8.2-cp313-cp313-musllinux_1_2_aarch64.whl (239.1KiB)
coverage-7.8.2-cp313-cp313-musllinux_1_2_i686.whl (237.2KiB)
coverage-7.8.2-cp313-cp313-musllinux_1_2_x86_64.whl (238.5KiB)
coverage-7.8.2-cp313-cp313-win32.whl (209.4KiB)
coverage-7.8.2-cp313-cp313-win_amd64.whl (210.2KiB)
coverage-7.8.2-cp313-cp313-win_arm64.whl (208.6KiB)
coverage-7.8.2-cp313-cp313t-macosx_10_13_x86_64.whl (207.7KiB)
coverage-7.8.2-cp313-cp313t-macosx_11_0_arm64.whl (208.0KiB)
coverage-7.8.2-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (251.0KiB)
coverage-7.8.2-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (246.9KiB)
coverage-7.8.2-cp313-cp313t-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (249.1KiB)
coverage-7.8.2-cp313-cp313t-musllinux_1_2_aarch64.whl (250.3KiB)
coverage-7.8.2-cp313-cp313t-musllinux_1_2_i686.whl (248.5KiB)
coverage-7.8.2-cp313-cp313t-musllinux_1_2_x86_64.whl (249.3KiB)
coverage-7.8.2-cp313-cp313t-win32.whl (210.1KiB)
coverage-7.8.2-cp313-cp313t-win_amd64.whl (211.2KiB)
coverage-7.8.2-cp313-cp313t-win_arm64.whl (209.1KiB)
coverage-7.8.2-cp39-cp39-macosx_10_9_x86_64.whl (206.6KiB)
coverage-7.8.2-cp39-cp39-macosx_11_0_arm64.whl (207.0KiB)
coverage-7.8.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (235.1KiB)
coverage-7.8.2-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (233.1KiB)
coverage-7.8.2-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (234.1KiB)
coverage-7.8.2-cp39-cp39-musllinux_1_2_aarch64.whl (233.9KiB)
coverage-7.8.2-cp39-cp39-musllinux_1_2_i686.whl (232.2KiB)
coverage-7.8.2-cp39-cp39-musllinux_1_2_x86_64.whl (233.2KiB)
coverage-7.8.2-cp39-cp39-win32.whl (209.1KiB)
coverage-7.8.2-cp39-cp39-win_amd64.whl (210.0KiB)
coverage-7.8.2-pp39.pp310.pp311-none-any.whl (198.9KiB)
coverage-7.8.2-py3-none-any.whl (198.9KiB)
coverage-7.8.2.tar.gz (793.7KiB)
