coverage 7.16.1__tar.gz → 7.16.2__tar.gz

{coverage-7.16.1 → coverage-7.16.2}/.github/workflows/codeql-analysis.yml

@@ -55,7 +55,7 @@ jobs:
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4.37.9
+        uses: github/codeql-action/init@b96794f015dfd88f77b49b1c93e0fa7110f94c63 # v4.38.0
         with:
           languages: ${{ matrix.language }}
           # If you wish to specify custom queries, you can do so here or in a config file.
@@ -66,7 +66,7 @@ jobs:
       # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
       # If this step fails, then you should remove it and run the build manually (see below)
       - name: Autobuild
-        uses: github/codeql-action/autobuild@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4.37.9
+        uses: github/codeql-action/autobuild@b96794f015dfd88f77b49b1c93e0fa7110f94c63 # v4.38.0
 
       # ℹ️ Command-line programs to run using the OS shell.
       # 📚 https://git.io/JvXDl
@@ -80,4 +80,4 @@ jobs:
       #   make release
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4.37.9
+        uses: github/codeql-action/analyze@b96794f015dfd88f77b49b1c93e0fa7110f94c63 # v4.38.0

{coverage-7.16.1 → coverage-7.16.2}/.github/workflows/quality.yml

@@ -185,7 +185,7 @@ jobs:
           persist-credentials: false
 
       - name: "Install uv"
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
         with:
           enable-cache: false
 

{coverage-7.16.1 → coverage-7.16.2}/.github/workflows/testsuite.yml

@@ -168,9 +168,14 @@ jobs:
     name: "Tests successful"
     needs:
       - tests
+    # Without this, GitHub skips this job when `tests` doesn't succeed, so the
+    # gate reports "skipped" instead of failing.  `allowed-skips` keeps the
+    # deliberate skips (-notests branches, no test-relevant files) passing.
+    if: always()
     runs-on: ubuntu-latest
     steps:
       - name: "Decide success or failure"
         uses: re-actors/alls-green@b5b5b37504aa4183270bd3d855c52a67f212be35 # v1.3.0
         with:
           jobs: ${{ toJSON(needs) }}
+          allowed-skips: tests

{coverage-7.16.1 → coverage-7.16.2}/.pre-commit-config.yaml

@@ -16,7 +16,7 @@ repos:
         exclude: "stress_phystoken|\\.py,cover$"
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.16.7
+    rev: v0.16.8
     hooks:
       - id: ruff-format
 

{coverage-7.16.1 → coverage-7.16.2}/CHANGES.rst

@@ -22,6 +22,28 @@ upgrading your version of coverage.py.
 
 .. start-releases
 
+.. _changes_7-16-2:
+
+Version 7.16.2 — 2026-09-27
+---------------------------
+
+- Fix: on Python 3.14 and later, a ``for`` loop completing immediately before a
+  function return could mistakenly report an uncovered branch. This is now
+  fixed, closing `issue 2168`_.
+
+- Fix: on Python 3.14 and later, the ``else`` clause of a ``try`` whose body is
+  a ``with`` statement could incorrectly be reported as covered when the
+  ``with`` raised.  This is now fixed, closing `issue 2289`_.
+
+- Fix: with ``dynamic_context = test_function``, test methods written as
+  ``@staticmethod`` or ``@classmethod`` were not given a context of their own.
+  Now they are, on Python 3.11 and later.  Closes `issue 1923`_.
+
+.. _issue 1923: https://github.com/coveragepy/coveragepy/issues/1923
+.. _issue 2168: https://github.com/coveragepy/coveragepy/issues/2168
+.. _issue 2289: https://github.com/coveragepy/coveragepy/issues/2289
+
+
 .. _changes_7-16-1:
 
 Version 7.16.1 — 2026-09-13

{coverage-7.16.1 → coverage-7.16.2}/Makefile

@@ -208,7 +208,7 @@ sample_html_beta: _sample_cog_html	#- Generate sample HTML report for a beta rel
 
 ### Kitting: making releases
 
-.PHONY: release_version edit_for_release cheats relbranch relcommit1
+.PHONY: release_version edit_for_release cheats relbranch relcommit
 .PHONY: kit pypi_upload test_upload build_kits update_rtd
 .PHONY: _check_github_auth download_kits
 .PHONY: tag bump_version
@@ -228,7 +228,7 @@ cheats:					#- Create some useful snippets for releasing.
 relbranch:				# Create the branch for releasing (see howto.txt).
 	git switch -c nedbat/release-$$(date +%Y%m%d-%H%M%S)
 
-relcommit1:				# Commit the first release changes (see howto.txt).
+relcommit:				# Commit the release changes (see howto.txt).
 	git commit -am "docs: prep for $$(python setup.py --version)"
 
 kit:					#- Make a source distribution and some wheels.

{coverage-7.16.1 → coverage-7.16.2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: coverage
-Version: 7.16.1
+Version: 7.16.2
 Summary: Code coverage measurement for Python
 Home-page: https://github.com/coveragepy/coveragepy
 Author: Ned Batchelder and 263 others
 Author-email: ned@nedbatchelder.com
 License: Apache-2.0
-Project-URL: Documentation, https://coverage.readthedocs.io/en/7.16.1
+Project-URL: Documentation, https://coverage.readthedocs.io/en/7.16.2
 Project-URL: Funding, https://tidelift.com/subscription/pkg/pypi-coverage?utm_source=pypi-coverage&utm_medium=referral&utm_campaign=pypi
 Project-URL: Issues, https://github.com/coveragepy/coveragepy/issues
 Project-URL: Mastodon, https://hachyderm.io/@coveragepy
@@ -83,7 +83,7 @@ Coverage.py runs on these versions of Python:
 Documentation is on `Read the Docs`_.  Code repository and issue tracker are on
 `GitHub`_.
 
-.. _Read the Docs: https://coverage.readthedocs.io/en/7.16.1/
+.. _Read the Docs: https://coverage.readthedocs.io/en/7.16.2/
 .. _GitHub: https://github.com/coveragepy/coveragepy
 
 
@@ -112,7 +112,7 @@ Getting Started
 Looking to run ``coverage`` on your test suite? See the `Quick Start section`_
 of the docs.
 
-.. _Quick Start section: https://coverage.readthedocs.io/en/7.16.1/#quick-start
+.. _Quick Start section: https://coverage.readthedocs.io/en/7.16.2/#quick-start
 
 
 Change history
@@ -120,7 +120,7 @@ Change history
 
 The complete history of changes is on the `change history page`_.
 
-.. _change history page: https://coverage.readthedocs.io/en/7.16.1/changes.html
+.. _change history page: https://coverage.readthedocs.io/en/7.16.2/changes.html
 
 
 Code of Conduct
@@ -139,7 +139,7 @@ Contributing
 Found a bug? Want to help improve the code or documentation? See the
 `Contributing section`_ of the docs.
 
-.. _Contributing section: https://coverage.readthedocs.io/en/7.16.1/contributing.html
+.. _Contributing section: https://coverage.readthedocs.io/en/7.16.2/contributing.html
 
 
 Security
@@ -167,7 +167,7 @@ Licensed under the `Apache 2.0 License`_.  For details, see `NOTICE.txt`_.
     :target: https://github.com/coveragepy/coveragepy/actions/workflows/quality.yml
     :alt: Quality check status
 .. |docs| image:: https://readthedocs.org/projects/coverage/badge/?version=latest&style=flat
-    :target: https://coverage.readthedocs.io/en/7.16.1/
+    :target: https://coverage.readthedocs.io/en/7.16.2/
     :alt: Documentation
 .. |kit| image:: https://img.shields.io/pypi/v/coverage
     :target: https://pypi.org/project/coverage/

{coverage-7.16.1 → coverage-7.16.2}/coverage/bytecode.py

@@ -106,6 +106,10 @@ RETURNS = op_set(
     "RETURN_GENERATOR",
 )
 
+# Opcodes that do not fall through. The bytecode after them belongs to
+# another path (for example the swallowed-exception side of a with).
+NO_FALL_THROUGH = op_set("RERAISE")
+
 
 # CACHE doesn't exist in Python 3.10, but the branch resolver is only used
 # on 3.14+, so a placeholder value is fine.
@@ -203,6 +207,8 @@ class BranchArcResolver:
                 return None
             if op in RETURNS:
                 return (from_line, -self.code.co_firstlineno)
+            if op in NO_FALL_THROUGH:
+                return None
             ext_arg = 0
             offset += 2
         return None

{coverage-7.16.1 → coverage-7.16.2}/coverage/context.py

@@ -6,6 +6,7 @@
 from __future__ import annotations
 
 from collections.abc import Sequence
+from inspect import CO_OPTIMIZED  # pylint: disable=no-name-in-module
 from types import FrameType
 
 from coverage.types import TShouldStartContextFn
@@ -63,6 +64,12 @@ def qualname_from_frame(frame: FrameType) -> str | None:
     if method is None:
         func = frame.f_globals.get(fname)
         if func is None:
+            # Static and class methods have no `self` and aren't in the module
+            # globals, but the code object knows its own qualified name.
+            # PYVERSIONS: co_qualname is 3.11+
+            qualname = getattr(co, "co_qualname", None)
+            if qualname and co.co_flags & CO_OPTIMIZED and "<locals>" not in qualname:
+                return f"{frame.f_globals.get('__name__')}.{qualname}"
             return None
         return f"{func.__module__}.{fname}"
 

{coverage-7.16.1 → coverage-7.16.2}/coverage/ctracer/tracer.c

@@ -771,6 +771,19 @@ CTracer_handle_return(CTracer *self, PyFrameObject *frame)
             real_return = !(is_yield || is_yield_from);
 #endif
             if (real_return) {
+#if PY_VERSION_HEX >= 0x030E0000
+                /* Python 3.14 can report a new line only on the return event. */
+                int return_line = PyFrame_GetLineNumber(frame);
+                if (
+                    self->pcur_entry->file_tracer == Py_None &&
+                    return_line != self->pcur_entry->last_line
+                ) {
+                    if (CTracer_record_pair(self, self->pcur_entry->last_line, return_line) < 0) {
+                        goto error;
+                    }
+                    self->pcur_entry->last_line = return_line;
+                }
+#endif
                 int first = MyFrame_BorrowCode(frame)->co_firstlineno;
                 if (CTracer_record_pair(self, self->pcur_entry->last_line, -first) < 0) {
                     goto error;

{coverage-7.16.1 → coverage-7.16.2}/coverage/debug.py

@@ -373,15 +373,12 @@ def filter_text(text: str, filters: Iterable[Callable[[str], str]]) -> str:
     run.
 
     """
-    clean_text = text.rstrip()
-    ending = text[len(clean_text) :]
-    text = clean_text
     for filter_fn in filters:
         lines = []
-        for line in text.splitlines():
-            lines.extend(filter_fn(line).splitlines())
-        text = "\n".join(lines)
-    return text + ending
+        for line in text.splitlines(keepends=True):
+            lines.extend(filter_fn(line).splitlines(keepends=True))
+        text = "".join(lines)
+    return text
 
 
 class CwdTracker:

{coverage-7.16.1 → coverage-7.16.2}/coverage/files.py

@@ -237,7 +237,7 @@ class Matcher(abc.ABC):
         return f"<{self.__class__.__name__} {self.name} {self.strs!r}>"
 
     @abc.abstractmethod
-    def match(self, s: str) -> bool:
+    def match(self, s: str, /) -> bool:
         """Does this string match?"""
 
     def info(self) -> list[str]:
@@ -270,7 +270,7 @@ class TreeMatcher(Matcher):
                 debug(f"        Normalized {p!r} to {ap!r}")
             self.paths.append(ap)
 
-    def match(self, fpath: str) -> bool:  # pylint: disable=arguments-renamed
+    def match(self, fpath: str, /) -> bool:
         """Does `fpath` indicate a file in one of our trees?"""
         fpath = abs_file(fpath)
         for p in self.paths:
@@ -297,7 +297,7 @@ class ModuleMatcher(Matcher):
         self.modules = list(module_names)
         super().__init__(self.modules, name=name, caption=caption, debug=debug)
 
-    def match(self, module_name: str) -> bool:  # pylint: disable=arguments-renamed
+    def match(self, module_name: str, /) -> bool:
         """Does `module_name` indicate a module in one of our packages?"""
         if not module_name:
             return False
@@ -327,7 +327,7 @@ class GlobMatcher(Matcher):
         super().__init__(self.pats, name=name, caption=caption, debug=debug)
         self.re = globs_to_regex(self.pats, case_insensitive=env.WINDOWS)
 
-    def match(self, fpath: str) -> bool:  # pylint: disable=arguments-renamed
+    def match(self, fpath: str, /) -> bool:
         """Does `fpath` match one of our file name patterns?"""
         return self.re.match(fpath) is not None
 

{coverage-7.16.1 → coverage-7.16.2}/coverage/parser.py

@@ -529,6 +529,7 @@ class TAddArcFn(Protocol):
         10" or "exit from function 'fooey'."
 
         """
+        ...
 
 
 TArcFragments = dict[TArc, list[tuple[str | None, str | None]]]

{coverage-7.16.1 → coverage-7.16.2}/coverage/pytracer.py

@@ -40,6 +40,9 @@ set_TArc = set[TArc]
 # PYVERSIONS: RESUME is new in Python3.11
 RESUME = dis.opmap.get("RESUME")
 RETURN_VALUE = dis.opmap["RETURN_VALUE"]
+# PyPy attributes the exception-handler PUSH_EXC_INFO to the try/else line.
+# That instruction is not the else body. Skip it so the else line stays missing.
+PUSH_EXC_INFO = dis.opmap.get("PUSH_EXC_INFO")
 if RESUME is None:
     YIELD_VALUE = dis.opmap["YIELD_VALUE"]
     YIELD_FROM = dis.opmap["YIELD_FROM"]
@@ -257,6 +260,15 @@ class PyTracer(Tracer):
         elif event == "line":
             # Record an executed line.
             if self.cur_file_data is not None:
+                if PUSH_EXC_INFO is not None:
+                    lasti = frame.f_lasti
+                    code = frame.f_code.co_code
+                    if (
+                        isinstance(lasti, int)
+                        and 0 <= lasti < len(code)
+                        and code[lasti] == PUSH_EXC_INFO
+                    ):
+                        return self._cached_bound_method_trace
                 flineno: TLineNo = frame.f_lineno
 
                 if self.trace_arcs:
@@ -292,6 +304,10 @@ class PyTracer(Tracer):
                     else:
                         real_return = True
                 if real_return:
+                    # Python 3.14 can report a new line only on the return event.
+                    if env.PYVERSION >= (3, 14) and frame.f_lineno != self.last_line:
+                        cast(set_TArc, self.cur_file_data).add((self.last_line, frame.f_lineno))
+                        self.last_line = frame.f_lineno
                     first = frame.f_code.co_firstlineno
                     cast(set_TArc, self.cur_file_data).add((self.last_line, -first))
 

{coverage-7.16.1 → coverage-7.16.2}/coverage/report_core.py

@@ -27,6 +27,7 @@ class Reporter(Protocol):
 
     def report(self, morfs: TMorfs, outfile: IO[str]) -> float:
         """Generate a report of `morfs`, written to `outfile`."""
+        ...
 
 
 def render_report(

{coverage-7.16.1 → coverage-7.16.2}/coverage/types.py

@@ -100,18 +100,23 @@ class Tracer(Protocol):
 
     def start(self) -> TTraceFn | None:
         """Start this tracer, return a trace function if based on sys.settrace."""
+        ...
 
     def stop(self) -> None:
         """Stop this tracer."""
+        ...
 
     def activity(self) -> bool:
         """Has there been any activity?"""
+        ...
 
     def reset_activity(self) -> None:
         """Reset the activity() flag."""
+        ...
 
     def get_stats(self) -> dict[str, int] | None:
         """Return a dictionary of statistics, or None."""
+        ...
 
 
 ## Coverage
@@ -143,6 +148,7 @@ class TConfigurable(Protocol):
         Returns the value of the option.
 
         """
+        ...
 
     def set_option(self, option_name: str, value: TConfigValueIn | TConfigSectionIn) -> None:
         """Set an option in the configuration.
@@ -154,6 +160,7 @@ class TConfigurable(Protocol):
         `value` is the new value for the option.
 
         """
+        ...
 
 
 class TPluginConfig(Protocol):
@@ -161,6 +168,7 @@ class TPluginConfig(Protocol):
 
     def get_plugin_options(self, plugin: str) -> TConfigSectionOut:
         """Get the options for a plugin."""
+        ...
 
 
 ## Parsing
@@ -185,9 +193,11 @@ class TDebugCtl(Protocol):
 
     def should(self, option: str) -> bool:
         """Decide whether to output debug information in category `option`."""
+        ...
 
     def write(self, msg: str) -> None:
         """Write a line of debug output."""
+        ...
 
 
 class TWritable(Protocol):
@@ -195,3 +205,4 @@ class TWritable(Protocol):
 
     def write(self, msg: str) -> None:
         """Write a message."""
+        ...

{coverage-7.16.1 → coverage-7.16.2}/coverage/version.py

@@ -8,7 +8,7 @@ from __future__ import annotations
 
 # version_info: same semantics as sys.version_info.
 # _dev: the .devN suffix if any.
-version_info = (7, 16, 1, "final", 0)
+version_info = (7, 16, 2, "final", 0)
 _dev = 0
 
 

{coverage-7.16.1 → coverage-7.16.2}/coverage.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: coverage
-Version: 7.16.1
+Version: 7.16.2
 Summary: Code coverage measurement for Python
 Home-page: https://github.com/coveragepy/coveragepy
 Author: Ned Batchelder and 263 others
 Author-email: ned@nedbatchelder.com
 License: Apache-2.0
-Project-URL: Documentation, https://coverage.readthedocs.io/en/7.16.1
+Project-URL: Documentation, https://coverage.readthedocs.io/en/7.16.2
 Project-URL: Funding, https://tidelift.com/subscription/pkg/pypi-coverage?utm_source=pypi-coverage&utm_medium=referral&utm_campaign=pypi
 Project-URL: Issues, https://github.com/coveragepy/coveragepy/issues
 Project-URL: Mastodon, https://hachyderm.io/@coveragepy
@@ -83,7 +83,7 @@ Coverage.py runs on these versions of Python:
 Documentation is on `Read the Docs`_.  Code repository and issue tracker are on
 `GitHub`_.
 
-.. _Read the Docs: https://coverage.readthedocs.io/en/7.16.1/
+.. _Read the Docs: https://coverage.readthedocs.io/en/7.16.2/
 .. _GitHub: https://github.com/coveragepy/coveragepy
 
 
@@ -112,7 +112,7 @@ Getting Started
 Looking to run ``coverage`` on your test suite? See the `Quick Start section`_
 of the docs.
 
-.. _Quick Start section: https://coverage.readthedocs.io/en/7.16.1/#quick-start
+.. _Quick Start section: https://coverage.readthedocs.io/en/7.16.2/#quick-start
 
 
 Change history
@@ -120,7 +120,7 @@ Change history
 
 The complete history of changes is on the `change history page`_.
 
-.. _change history page: https://coverage.readthedocs.io/en/7.16.1/changes.html
+.. _change history page: https://coverage.readthedocs.io/en/7.16.2/changes.html
 
 
 Code of Conduct
@@ -139,7 +139,7 @@ Contributing
 Found a bug? Want to help improve the code or documentation? See the
 `Contributing section`_ of the docs.
 
-.. _Contributing section: https://coverage.readthedocs.io/en/7.16.1/contributing.html
+.. _Contributing section: https://coverage.readthedocs.io/en/7.16.2/contributing.html
 
 
 Security
@@ -167,7 +167,7 @@ Licensed under the `Apache 2.0 License`_.  For details, see `NOTICE.txt`_.
     :target: https://github.com/coveragepy/coveragepy/actions/workflows/quality.yml
     :alt: Quality check status
 .. |docs| image:: https://readthedocs.org/projects/coverage/badge/?version=latest&style=flat
-    :target: https://coverage.readthedocs.io/en/7.16.1/
+    :target: https://coverage.readthedocs.io/en/7.16.2/
     :alt: Documentation
 .. |kit| image:: https://img.shields.io/pypi/v/coverage
     :target: https://pypi.org/project/coverage/

{coverage-7.16.1 → coverage-7.16.2}/doc/commands/cmd_combine.rst

@@ -37,9 +37,9 @@ so that every data file is distinct::
 
 You can also define a new data file name with the ``[run] data_file`` option.
 
-Once you have created a number of these files, you can copy them all to a
-single directory, and use the **combine** command to combine them into one
-.coverage data file::
+Once you have created a number of separate data files, you can also copy them
+all to a single directory, and use the **combine** command to combine them into
+one .coverage data file::
 
     $ coverage combine
 
@@ -99,6 +99,28 @@ want to keep those files, use the ``--keep`` command-line option.
 .. [[[end]]] (sum: ARyg8KB1fE)
 
 
+Parallel test runners
+.....................
+
+If independent test runners use coverage.py concurrently in the same working
+directory, give each runner a different *base* data file name.  This is
+important with tools such as ``tox --parallel``: coverage's parallel mode makes
+the individual measurement files unique, but separate tox environments can
+still combine or erase files using the same base name at the same time.
+
+You can use tox settings to give each tox environment a distinct base coverage
+data file name so their combine steps won't collide::
+
+    [testenv]
+    setenv =
+        COVERAGE_FILE = {toxinidir}/.coverage.{envname}
+
+Each environment can run coverage in parallel, and combine their data files
+into a distinct data file. After the test-running tox environments have
+finished, a final second-level combining environment can combine those files
+using their common ``.coverage`` prefix, as described above.
+
+
 .. _cmd_combine_remapping:
 
 Re-mapping paths

{coverage-7.16.1 → coverage-7.16.2}/doc/conf.py

@@ -69,11 +69,11 @@ project = "Coverage.py"
 # @@@ editable
 copyright = "2009–2026, Ned Batchelder"  # pylint: disable=redefined-builtin
 # The short X.Y.Z version.
-version = "7.16.1"
+version = "7.16.2"
 # The full version, including alpha/beta/rc tags.
-release = "7.16.1"
+release = "7.16.2"
 # The date of release, in "monthname day, year" format.
-release_date = "September 13, 2026"
+release_date = "September 27, 2026"
 # @@@ end
 
 rst_epilog = f"""