nedbat/coveragepy (coverage)
### [`v7.6.1`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-761--2024-08-04)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.6.0...7.6.1)
- Fix: coverage used to fail when measuring code using :func:`runpy.run_path ` with a :class:`Path ` argument.
This is now fixed, thanks to `Ask Hjorth Larsen `\_.
- Fix: backslashes preceding a multi-line backslashed string could confuse the
HTML report. This is now fixed, thanks to `LiuYinCarl `\_.
- Now we publish wheels for Python 3.13, both regular and free-threaded.
.. \_pull 1819:[https://github.com/nedbat/coveragepy/pull/1819](https://togithub.com/nedbat/coveragepy/pull/1819)9
.. \_pull 1828[https://github.com/nedbat/coveragepy/pull/1828](https://togithub.com/nedbat/coveragepy/pull/1828)28
.. \_changes\_7-6-0:
### [`v7.6.0`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-760--2024-07-11)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.5.4...7.6.0)
- Exclusion patterns can now be multi-line, thanks to `Daniel Diniz `*. This enables many interesting exclusion use-cases, including those
requested in issues `118 `* (entire files), `996 `\_ (multiple lines only when appearing together), `1741 `\_ (remainder of a function), and `1803 `\_
(arbitrary sequence of marked lines). See the :ref:`multi_line_exclude`
section of the docs for more details and examples.
- The JSON report now includes per-function and per-class coverage information.
Thanks to `Daniel Diniz `\_ for getting the work started. This
closes `issue 1793`\_ and `issue 1532`\_.
- Fixed an incorrect calculation of "(no class)" lines in the HTML classes
report.
- Python 3.13.0b3 is supported.
.. \_issue 118:[https://github.com/nedbat/coveragepy/issues/118](https://togithub.com/nedbat/coveragepy/issues/118)8
.. \_issue 996[https://github.com/nedbat/coveragepy/issues/996](https://togithub.com/nedbat/coveragepy/issues/996)96
.. \_issue 153[https://github.com/nedbat/coveragepy/issues/1532](https://togithub.com/nedbat/coveragepy/issues/1532)532
.. \_issue 17[https://github.com/nedbat/coveragepy/issues/1741](https://togithub.com/nedbat/coveragepy/issues/1741)1741
.. \_issue 1[https://github.com/nedbat/coveragepy/issues/1793](https://togithub.com/nedbat/coveragepy/issues/1793)/1793
.. \_issue [https://github.com/nedbat/coveragepy/issues/1803](https://togithub.com/nedbat/coveragepy/issues/1803)s/1803
.. \_pull[https://github.com/nedbat/coveragepy/pull/1807](https://togithub.com/nedbat/coveragepy/pull/1807)ll/1807
.. \_pul[https://github.com/nedbat/coveragepy/pull/1809](https://togithub.com/nedbat/coveragepy/pull/1809)ull/1809
.. \_changes\_7-5-4:
### [`v7.5.4`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-754--2024-06-22)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.5.3...7.5.4)
- If you attempt to combine statement coverage data with branch coverage data,
coverage.py used to fail with the message "Can't combine arc data with line
data" or its reverse, "Can't combine line data with arc data." These
messages used internal terminology, making it hard for people to understand
the problem. They are now changed to mention "branch coverage data" and
"statement coverage data."
- Fixed a minor branch coverage problem with wildcard match/case cases using
names or guard clauses.
- Started testing on 3.13 free-threading (nogil) builds of Python. I'm not
claiming full support yet. Closes `issue 1799`\_.
.. \_issue 1799:[https://github.com/nedbat/coveragepy/issues/1799](https://togithub.com/nedbat/coveragepy/issues/1799)9
.. \_changes\_7-5-3:
### [`v7.5.3`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-753--2024-05-28)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.5.2...7.5.3)
- Performance improvements for combining data files, especially when measuring
line coverage. A few different quadratic behaviors were eliminated. In one
extreme case of combining 700+ data files, the time dropped from more than
three hours to seven minutes. Thanks for Kraken Tech for funding the fix.
- Performance improvements for generating HTML reports, with a side benefit of
reducing memory use, closing `issue 1791`\_. Thanks to Daniel Diniz for
helping to diagnose the problem.
.. \_issue 1791:[https://github.com/nedbat/coveragepy/issues/1791](https://togithub.com/nedbat/coveragepy/issues/1791)1
.. \_changes\_7-5-2:
### [`v7.5.2`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-752--2024-05-24)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.5.1...7.5.2)
- Fix: nested matches of exclude patterns could exclude too much code, as
reported in `issue 1779`\_. This is now fixed.
- Changed: previously, coverage.py would consider a module docstring to be an
executable statement if it appeared after line 1 in the file, but not
executable if it was the first line. Now module docstrings are never counted
as executable statements. This can change coverage.py's count of the number
of statements in a file, which can slightly change the coverage percentage
reported.
- In the HTML report, the filter term and "hide covered" checkbox settings are
remembered between viewings, thanks to `Daniel Diniz `\_.
- Python 3.13.0b1 is supported.
- Fix: parsing error handling is improved to ensure bizarre source files are
handled gracefully, and to unblock oss-fuzz fuzzing, thanks to `Liam DeVoe `*. Closes `issue 1787`*.
.. \_pull 1776:[https://github.com/nedbat/coveragepy/pull/1776](https://togithub.com/nedbat/coveragepy/pull/1776)6
.. \_issue 1779[https://github.com/nedbat/coveragepy/issues/1779](https://togithub.com/nedbat/coveragepy/issues/1779)79
.. \_issue 178[https://github.com/nedbat/coveragepy/issues/1787](https://togithub.com/nedbat/coveragepy/issues/1787)787
.. \_pull 17[https://github.com/nedbat/coveragepy/pull/1788](https://togithub.com/nedbat/coveragepy/pull/1788)1788
.. \_changes\_7-5-1:
### [`v7.5.1`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-751--2024-05-04)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.5.0...7.5.1)
- Fix: a pragma comment on the continuation lines of a multi-line statement
now excludes the statement and its body, the same as if the pragma is
on the first line. This closes `issue 754`*. The fix was contributed by
`Daniel Diniz `*.
- Fix: very complex source files like `this one `\_ could
cause a maximum recursion error when creating an HTML report. This is now
fixed, closing `issue 1774`\_.
- HTML report improvements:
- Support files (JavaScript and CSS) referenced by the HTML report now have
hashes added to their names to ensure updated files are used instead of
stale cached copies.
- Missing branch coverage explanations that said "the condition was never
false" now read "the condition was always true" because it's easier to
understand.
- Column sort order is remembered better as you move between the index pages,
fixing `issue 1766`*. Thanks, `Daniel Diniz `*.
.. \_resolvent_lookup: https://github.com/sympy/sympy/blob/130950f3e6b3f97fcc17f4599ac08f70fdd2e9d4/sympy/polys/numberfields/resolvent_lookup.py
.. \_issue 754[https://github.com/nedbat/coveragepy/issues/754](https://togithub.com/nedbat/coveragepy/issues/754)54
.. \_issue 176[https://github.com/nedbat/coveragepy/issues/1766](https://togithub.com/nedbat/coveragepy/issues/1766)766
.. \_pull 17[https://github.com/nedbat/coveragepy/pull/1768](https://togithub.com/nedbat/coveragepy/pull/1768)1768
.. \_pull 1[https://github.com/nedbat/coveragepy/pull/1773](https://togithub.com/nedbat/coveragepy/pull/1773)/1773
.. \_issue [https://github.com/nedbat/coveragepy/issues/1774](https://togithub.com/nedbat/coveragepy/issues/1774)s/1774
.. \_changes\_7-5-0:
### [`v7.5.0`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-750--2024-04-23)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.4.4...7.5.0)
- Added initial support for function and class reporting in the HTML report.
There are now three index pages which link to each other: files, functions,
and classes. Other reports don't yet have this information, but it will be
added in the future where it makes sense. Feedback gladly accepted!
Finishes `issue 780`\_.
- Other HTML report improvements:
- There is now a "hide covered" checkbox to filter out 100% files, finishing
`issue 1384`\_.
- The index page is always sorted by one of its columns, with clearer
indications of the sorting.
- The "previous file" shortcut key didn't work on the index page, but now it
does, fixing `issue 1765`\_.
- The debug output showing which configuration files were tried now shows
absolute paths to help diagnose problems where settings aren't taking effect,
and is renamed from "attempted_config_files" to the more logical
"config_files_attempted."
- Python 3.13.0a6 is supported.
.. \_issue 780:[https://github.com/nedbat/coveragepy/issues/780](https://togithub.com/nedbat/coveragepy/issues/780)0
.. \_issue 1384[https://github.com/nedbat/coveragepy/issues/1384](https://togithub.com/nedbat/coveragepy/issues/1384)84
.. \_issue 176[https://github.com/nedbat/coveragepy/issues/1765](https://togithub.com/nedbat/coveragepy/issues/1765)765
.. \_changes\_7-4-4:
### [`v7.4.4`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-744--2024-03-14)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.4.3...7.4.4)
- Fix: in some cases, even with `[run] relative_files=True`, a data file
could be created with absolute path names. When combined with other relative
data files, it was random whether the absolute file names would be made
relative or not. If they weren't, then a file would be listed twice in
reports, as detailed in `issue 1752`\_. This is now fixed: absolute file
names are always made relative when combining. Thanks to Bruno Rodrigues dos
Santos for support.
- Fix: the last case of a match/case statement had an incorrect message if the
branch was missed. It said the pattern never matched, when actually the
branch is missed if the last case always matched.
- Fix: clicking a line number in the HTML report now positions more accurately.
- Fix: the `report:format` setting was defined as a boolean, but should be a
string. Thanks, `Tanaydin Sirin `\_. It is also now documented
on the :ref:`configuration page `.
.. \_issue 1752:[https://github.com/nedbat/coveragepy/issues/1752](https://togithub.com/nedbat/coveragepy/issues/1752)2
.. \_pull 1754[https://github.com/nedbat/coveragepy/pull/1754](https://togithub.com/nedbat/coveragepy/pull/1754)54
.. \_changes\_7-4-3:
### [`v7.4.3`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-743--2024-02-23)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.4.2...7.4.3)
- Fix: in some cases, coverage could fail with a RuntimeError: "Set changed
size during iteration." This is now fixed, closing `issue 1733`\_.
.. \_issue 1733:[https://github.com/nedbat/coveragepy/issues/1733](https://togithub.com/nedbat/coveragepy/issues/1733)3
.. \_changes\_7-4-2:
### [`v7.4.2`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-742--2024-02-20)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.4.1...7.4.2)
- Fix: setting `COVERAGE_CORE=sysmon` no longer errors on 3.11 and lower,
thanks `Hugo van Kemenade `\_. It now issues a warning that
sys.monitoring is not available and falls back to the default core instead.
.. \_pull 1747:[https://github.com/nedbat/coveragepy/pull/1747](https://togithub.com/nedbat/coveragepy/pull/1747)7
.. \_changes\_7-4-1:
### [`v7.4.1`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-741--2024-01-26)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.4.0...7.4.1)
- Python 3.13.0a3 is supported.
- Fix: the JSON report now includes an explicit format version number, closing
`issue 1732`\_.
.. \_issue 1732:[https://github.com/nedbat/coveragepy/issues/1732](https://togithub.com/nedbat/coveragepy/issues/1732)2
.. \_changes\_7-4-0:
### [`v7.4.0`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-740--2023-12-27)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.3.4...7.4.0)
- In Python 3.12 and above, you can try an experimental core based on the new
:mod:`sys.monitoring ` module by defining a
`COVERAGE_CORE=sysmon` environment variable. This should be faster for
line coverage, but not for branch coverage, and plugins and dynamic contexts
are not yet supported with it. I am very interested to hear how it works (or
doesn't!) for you.
.. \_changes\_7-3-4:
### [`v7.3.4`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-734--2023-12-20)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.3.3...7.3.4)
- Fix: the change for multi-line signature exclusions in 7.3.3 broke other
forms of nested clauses being excluded properly. This is now fixed, closing
`issue 1713`\_.
- Fix: in the HTML report, selecting code for copying won't select the line
numbers also. Thanks, `Robert Harris `\_.
.. \_issue 1713:[https://github.com/nedbat/coveragepy/issues/1713](https://togithub.com/nedbat/coveragepy/issues/1713)3
.. \_pull 1717[https://github.com/nedbat/coveragepy/pull/1717](https://togithub.com/nedbat/coveragepy/pull/1717)17
.. \_changes\_7-3-3:
### [`v7.3.3`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-733--2023-12-14)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.3.2...7.3.3)
- Fix: function definitions with multi-line signatures can now be excluded by
matching any of the lines, closing `issue 684`*. Thanks, `Jan Rusak,
Maciej Kowalczyk and Joanna Ejzel `*.
- Fix: XML reports could fail with a TypeError if files had numeric components
that were duplicates except for leading zeroes, like `file1.py` and
`file001.py`. Fixes `issue 1709`\_.
- The `coverage annotate` command used to announce that it would be removed
in a future version. Enough people got in touch to say that they use it, so
it will stay. Don't expect it to keep up with other new features though.
- Added new :ref:`debug options `:
- `pytest` writes the pytest test name into the debug output.
- `dataop2` writes the full data being added to CoverageData objects.
.. \_issue 684:[https://github.com/nedbat/coveragepy/issues/684](https://togithub.com/nedbat/coveragepy/issues/684)4
.. \_pull 1705[https://github.com/nedbat/coveragepy/pull/1705](https://togithub.com/nedbat/coveragepy/pull/1705)05
.. \_issue 170[https://github.com/nedbat/coveragepy/issues/1709](https://togithub.com/nedbat/coveragepy/issues/1709)709
.. \_changes\_7-3-2:
### [`v7.3.2`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-732--2023-10-02)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.3.1...7.3.2)
- The `coverage lcov` command ignored the `[report] exclude_lines` and
`[report] exclude_also` settings (`issue 1684`*). This is now fixed,
thanks `Jacqueline Lee `*.
- Sometimes SQLite will create journal files alongside the coverage.py database
files. These are ephemeral, but could be mistakenly included when combining
data files. Now they are always ignored, fixing `issue 1605`\_. Thanks to
Brad Smith for suggesting fixes and providing detailed debugging.
- On Python 3.12+, we now disable SQLite writing journal files, which should be
a little faster.
- The new 3.12 soft keyword `type` is properly bolded in HTML reports.
- Removed the "fullcoverage" feature used by CPython to measure the coverage of
early-imported standard library modules. CPython `stopped using it
<88054_>`\_ in 2021, and it stopped working completely in Python 3.13.
.. \_issue 1605:[https://github.com/nedbat/coveragepy/issues/1605](https://togithub.com/nedbat/coveragepy/issues/1605)5
.. \_issue 1684[https://github.com/nedbat/coveragepy/issues/1684](https://togithub.com/nedbat/coveragepy/issues/1684)84
.. \_pull 168[https://github.com/nedbat/coveragepy/pull/1685](https://togithub.com/nedbat/coveragepy/pull/1685)685
.. \_880[https://github.com/python/cpython/issues/88054](https://togithub.com/python/cpython/issues/88054)8054
.. \_changes\_7-3-1:
### [`v7.3.1`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-731--2023-09-06)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.3.0...7.3.1)
- The semantics of stars in file patterns has been clarified in the docs. A
leading or trailing star matches any number of path components, like a double
star would. This is different than the behavior of a star in the middle of a
pattern. This discrepancy was `identified by Sviatoslav Sydorenko `*, who `provided patient detailed diagnosis `* and
graciously agreed to a pragmatic resolution.
- The API docs were missing from the last version. They are now `restored `\_.
.. \_apidocs: https://coverage.readthedocs.io/en/latest/api_coverage.html
.. \_starbad[https://github.com/nedbat/coveragepy/issues/1407#issuecomment-1631085209](https://togithub.com/nedbat/coveragepy/issues/1407#issuecomment-1631085209)09
.. \_pull 165[https://github.com/nedbat/coveragepy/pull/1650](https://togithub.com/nedbat/coveragepy/pull/1650)650
.. \_changes\_7-3-0:
### [`v7.3.0`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-730--2023-08-12)
[Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.2.7...7.3.0)
- Added a :meth:`.Coverage.collect` context manager to start and stop coverage
data collection.
- Dropped support for Python 3.7.
- Fix: in unusual circumstances, SQLite cannot be set to asynchronous mode.
Coverage.py would fail with the error `Safety level may not be changed
inside a transaction.` This is now avoided, closing `issue 1646`\_. Thanks
to Michael Bell for the detailed bug report.
- Docs: examples of configuration files now include separate examples for the
different syntaxes: .coveragerc, pyproject.toml, setup.cfg, and tox.ini.
- Fix: added `nosemgrep` comments to our JavaScript code so that
semgrep-based SAST security checks won't raise false alarms about security
problems that aren't problems.
- Added a CITATION.cff file, thanks to `Ken Schackart `\_.
.. \_pull 1641:[https://github.com/nedbat/coveragepy/pull/1641](https://togithub.com/nedbat/coveragepy/pull/1641)1
.. \_issue 1646[https://github.com/nedbat/coveragepy/issues/1646](https://togithub.com/nedbat/coveragepy/issues/1646)46
.. \_changes\_7-2-7:
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR contains the following updates:
==7.2.7->==7.6.1Release Notes
nedbat/coveragepy (coverage)
### [`v7.6.1`](https://togithub.com/nedbat/coveragepy/blob/HEAD/CHANGES.rst#Version-761--2024-08-04) [Compare Source](https://togithub.com/nedbat/coveragepy/compare/7.6.0...7.6.1) - Fix: coverage used to fail when measuring code using :func:`runpy.run_pathConfiguration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.