.github/workflows/coverage.yml

@@ -30,7 +30,7 @@ concurrency:
 jobs:
   coverage:
     name: "${{ matrix.python-version }} on ${{ matrix.os }}"
-    runs-on: "${{ matrix.os }}-latest"
+    runs-on: "${{ matrix.os }}-${{ matrix.os-version || 'latest' }}"
     env:
       MATRIX_ID: "${{ matrix.python-version }}.${{ matrix.os }}"
 
@@ -69,13 +69,15 @@ jobs:
             python-version: "pypy-3.9"
           - os: windows
             python-version: "pypy-3.10"
-          # Skip 3.13.0a4 and pin to 3.13.0a3 for Windows due to build error.
-          # Undo when 3.13.0a5 is released.
-          - os: windows
-            python-version: "3.13"
+        # GitHub is rolling out macos 14, but it doesn't have Python 3.8 or 3.9.
+        # https://mastodon.social/@hugovk/112320493602782374
         include:
-          - os: windows
-            python-version: "3.13.0-alpha.3"
+          - python-version: "3.8"
+            os: "macos"
+            os-version: "13"
+          - python-version: "3.9"
+            os: "macos"
+            os-version: "13"
       # If one job fails, stop the whole thing.
       fail-fast: true
 

.github/workflows/kit.yml

@@ -48,7 +48,7 @@ concurrency:
 jobs:
   wheels:
     name: "${{ matrix.py }} ${{ matrix.os }} ${{ matrix.arch }} wheels"
-    runs-on: ${{ matrix.os }}-latest
+    runs-on: "${{ matrix.os }}-${{ matrix.os-version || 'latest' }}"
     env:
       MATRIX_ID: "${{ matrix.py }}-${{ matrix.os }}-${{ matrix.arch }}"
     strategy:
@@ -84,7 +84,7 @@ jobs:
           #
           #   # Some OS/arch combinations need overrides for the Python versions:
           #   os_arch_pys = {
-          #     ("macos", "arm64"): ["cp38", "cp39", "cp310", "cp311", "cp312"],
+          #     # ("macos", "arm64"): ["cp38", "cp39", "cp310", "cp311", "cp312"],
           #   }
           #
           #   #----- ^^^ ---------------------- ^^^ -----
@@ -98,6 +98,8 @@ jobs:
           #                   "py": the_py,
           #                   "arch": the_arch,
           #               }
+          #               if the_os == "macos":
+          #                   them["os-version"] = "13"
           #               print(f"- {json.dumps(them)}")
           # ]]]
           - {"os": "ubuntu", "py": "cp38", "arch": "x86_64"}
@@ -115,16 +117,16 @@ jobs:
           - {"os": "ubuntu", "py": "cp310", "arch": "aarch64"}
           - {"os": "ubuntu", "py": "cp311", "arch": "aarch64"}
           - {"os": "ubuntu", "py": "cp312", "arch": "aarch64"}
-          - {"os": "macos", "py": "cp38", "arch": "arm64"}
-          - {"os": "macos", "py": "cp39", "arch": "arm64"}
-          - {"os": "macos", "py": "cp310", "arch": "arm64"}
-          - {"os": "macos", "py": "cp311", "arch": "arm64"}
-          - {"os": "macos", "py": "cp312", "arch": "arm64"}
-          - {"os": "macos", "py": "cp38", "arch": "x86_64"}
-          - {"os": "macos", "py": "cp39", "arch": "x86_64"}
-          - {"os": "macos", "py": "cp310", "arch": "x86_64"}
-          - {"os": "macos", "py": "cp311", "arch": "x86_64"}
-          - {"os": "macos", "py": "cp312", "arch": "x86_64"}
+          - {"os": "macos", "py": "cp38", "arch": "arm64", "os-version": "13"}
+          - {"os": "macos", "py": "cp39", "arch": "arm64", "os-version": "13"}
+          - {"os": "macos", "py": "cp310", "arch": "arm64", "os-version": "13"}
+          - {"os": "macos", "py": "cp311", "arch": "arm64", "os-version": "13"}
+          - {"os": "macos", "py": "cp312", "arch": "arm64", "os-version": "13"}
+          - {"os": "macos", "py": "cp38", "arch": "x86_64", "os-version": "13"}
+          - {"os": "macos", "py": "cp39", "arch": "x86_64", "os-version": "13"}
+          - {"os": "macos", "py": "cp310", "arch": "x86_64", "os-version": "13"}
+          - {"os": "macos", "py": "cp311", "arch": "x86_64", "os-version": "13"}
+          - {"os": "macos", "py": "cp312", "arch": "x86_64", "os-version": "13"}
           - {"os": "windows", "py": "cp38", "arch": "x86"}
           - {"os": "windows", "py": "cp39", "arch": "x86"}
           - {"os": "windows", "py": "cp310", "arch": "x86"}
@@ -135,7 +137,7 @@ jobs:
           - {"os": "windows", "py": "cp310", "arch": "AMD64"}
           - {"os": "windows", "py": "cp311", "arch": "AMD64"}
           - {"os": "windows", "py": "cp312", "arch": "AMD64"}
-        # [[[end]]] (checksum: a6ca53e9c620c9e5ca85e7322122056c)
+        # [[[end]]] (checksum: 16ed28c185d540b2d9972a0217864472)
       fail-fast: false
 
     steps:

.github/workflows/python-nightly.yml

@@ -37,8 +37,10 @@ jobs:
     # because jammy ships 3.10, and deadsnakes doesn't want to clobber it.
     # https://launchpad.net/~deadsnakes/+archive/ubuntu/nightly/+packages
     # https://github.com/deadsnakes/issues/issues/234
-    # bionic: 18, focal: 20, jammy: 22
-    runs-on: ubuntu-20.04
+    # See https://github.com/deadsnakes/nightly for the source of the nightly
+    # builds.
+    # bionic: 18, focal: 20, jammy: 22, noble: 24
+    runs-on: ubuntu-22.04
     # If it doesn't finish in an hour, it's not going to. Don't spin for six
     # hours needlessly.
     timeout-minutes: 60
@@ -50,7 +52,6 @@ jobs:
           # tox.ini so that tox will run properly. PYVERSIONS
           # Available versions:
           # https://launchpad.net/~deadsnakes/+archive/ubuntu/nightly/+packages
-          - "3.11-dev"
           - "3.12-dev"
           - "3.13-dev"
           # https://github.com/actions/setup-python#available-versions-of-pypy

.github/workflows/quality.yml

@@ -31,7 +31,9 @@ jobs:
     # Because pylint can report different things on different OS's (!)
     # (https://github.com/PyCQA/pylint/issues/3489), run this on Mac where local
     # pylint gets run.
-    runs-on: macos-latest
+    # GitHub is rolling out macos 14, but it doesn't have Python 3.8 or 3.9.
+    # https://mastodon.social/@hugovk/112320493602782374
+    runs-on: macos-13
 
     steps:
       - name: "Check out the repo"
@@ -69,8 +71,6 @@ jobs:
 
       - name: "Install dependencies"
         run: |
-          # We run on 3.8, but the pins were made on 3.7, so don't insist on
-          # hashes, which won't match.
           python -m pip install -r requirements/tox.pip
 
       - name: "Tox mypy"

.github/workflows/testsuite.yml

@@ -30,7 +30,7 @@ concurrency:
 jobs:
   tests:
     name: "${{ matrix.python-version }} on ${{ matrix.os }}"
-    runs-on: "${{ matrix.os }}-latest"
+    runs-on: "${{ matrix.os }}-${{ matrix.os-version || 'latest' }}"
     # Don't run tests if the branch name includes "-notests"
     if: "!contains(github.ref, '-notests')"
     strategy:
@@ -62,13 +62,16 @@ jobs:
             python-version: "pypy-3.9"
           - os: windows
             python-version: "pypy-3.10"
-          # Skip 3.13.0a4 and pin to 3.13.0a3 for Windows due to build error.
-          # Undo when 3.13.0a5 is released.
-          - os: windows
-            python-version: "3.13"
+        # GitHub is rolling out macos 14, but it doesn't have Python 3.8 or 3.9.
+        # https://mastodon.social/@hugovk/112320493602782374
         include:
-          - os: windows
-            python-version: "3.13.0-alpha.3"
+          - python-version: "3.8"
+            os: "macos"
+            os-version: "13"
+          - python-version: "3.9"
+            os: "macos"
+            os-version: "13"
+
       fail-fast: false
 
     steps:

CHANGES.rst

@@ -22,6 +22,38 @@ upgrading your version of coverage.py.
 
 .. scriv-start-here
 
+.. _changes_7-5-0:
+
+Version 7.5.0 — 2024-04-23
+--------------------------
+
+- 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!
+
+- 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 1384: https://github.com/nedbat/coveragepy/issues/1384
+.. _issue 1765: https://github.com/nedbat/coveragepy/issues/1765
+
+
 .. _changes_7-4-4:
 
 Version 7.4.4 — 2024-03-14

CONTRIBUTORS.txt

@@ -102,6 +102,7 @@ J. M. F. Tsang
 JT Olds
 Jacqueline Lee
 Jakub Wilk
+James Valleroy
 Jan Rusak
 Janakarajan Natarajan
 Jerin Peter George

Makefile

@@ -198,10 +198,10 @@ kit:					## Make the source distribution.
 	python -m build
 
 kit_upload:				## Upload the built distributions to PyPI.
-	twine upload --verbose dist/*
+	twine upload dist/*
 
 test_upload:				## Upload the distributions to PyPI's testing server.
-	twine upload --verbose --repository testpypi --password $$TWINE_TEST_PASSWORD dist/*
+	twine upload --repository testpypi --password $$TWINE_TEST_PASSWORD dist/*
 
 kit_local:
 	# pip.conf looks like this:

README.rst

@@ -5,7 +5,7 @@
 Coverage.py
 ===========
 
-Code coverage testing for Python.
+Code coverage measurement for Python.
 
 .. image:: https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg
     :target: https://vshymanskyy.github.io/StandWithUkraine
@@ -25,7 +25,7 @@ Coverage.py runs on these versions of Python:
 
 .. PYVERSIONS
 
-* Python 3.8 through 3.12, and 3.13.0a3 and up.
+* Python 3.8 through 3.12, and 3.13.0a6 and up.
 * PyPy3 versions 3.8 through 3.10.
 
 Documentation is on `Read the Docs`_.  Code repository and issue tracker are on
@@ -35,6 +35,7 @@ Documentation is on `Read the Docs`_.  Code repository and issue tracker are on
 .. _GitHub: https://github.com/nedbat/coveragepy
 
 **New in 7.x:**
+initial function/class reporting;
 experimental support for sys.monitoring;
 dropped support for Python 3.7;
 added ``Coverage.collect()`` context manager;

coverage/__init__.py

@@ -28,14 +28,11 @@
 from coverage.data import CoverageData as CoverageData
 from coverage.exceptions import CoverageException as CoverageException
 from coverage.plugin import (
+    CodeRegion as CodeRegion,
     CoveragePlugin as CoveragePlugin,
     FileReporter as FileReporter,
     FileTracer as FileTracer,
 )
 
 # Backward compatibility.
 coverage = Coverage
-
-# On Windows, we encode and decode deep enough that something goes wrong and
-# the encodings.utf_8 module is loaded and then unloaded, I don't know why.
-# Adding a reference here prevents it from being unloaded.  Yuk.

coverage/cmdline.py

@@ -26,7 +26,7 @@
 from coverage.debug import info_header, short_stack, write_formatted_info
 from coverage.exceptions import _BaseCoverageException, _ExceptionDuringRun, NoSource
 from coverage.execfile import PyRunner
-from coverage.results import Numbers, should_fail_under
+from coverage.results import display_covered, should_fail_under
 from coverage.version import __url__
 
 # When adding to this file, alphabetization is important.  Look for
@@ -760,7 +760,7 @@ def command_line(self, argv: list[str]) -> int:
             precision = cast(int, self.coverage.get_option("report:precision"))
             if should_fail_under(total, fail_under, precision):
                 msg = "total of {total} is less than fail-under={fail_under:.{p}f}".format(
-                    total=Numbers(precision=precision).display_covered(total),
+                    total=display_covered(total, precision),
                     fail_under=fail_under,
                     p=precision,
                 )

coverage/config.py

@@ -180,7 +180,7 @@ def __init__(self) -> None:
         """Initialize the configuration attributes to their defaults."""
         # Metadata about the config.
         # We tried to read these config files.
-        self.attempted_config_files: list[str] = []
+        self.config_files_attempted: list[str] = []
         # We did read these config files, but maybe didn't find any content for us.
         self.config_files_read: list[str] = []
         # The file that gave us our configuration.
@@ -291,7 +291,7 @@ def from_file(self, filename: str, warn: Callable[[str], None], our_file: bool)
         else:
             cp = HandyConfigParser(our_file)
 
-        self.attempted_config_files.append(filename)
+        self.config_files_attempted.append(os.path.abspath(filename))
 
         try:
             files_read = cp.read(filename)

coverage/control.py

@@ -8,6 +8,7 @@
 import atexit
 import collections
 import contextlib
+import functools
 import os
 import os.path
 import platform
@@ -47,7 +48,7 @@
 from coverage.python import PythonFileReporter
 from coverage.report import SummaryReporter
 from coverage.report_core import render_report
-from coverage.results import Analysis
+from coverage.results import Analysis, analysis_from_file_reporter
 from coverage.types import (
     FilePath, TConfigurable, TConfigSectionIn, TConfigValueIn, TConfigValueOut,
     TFileDisposition, TLineNo, TMorf,
@@ -930,24 +931,17 @@ def analysis2(
             analysis.missing_formatted(),
         )
 
-    def _analyze(self, it: FileReporter | TMorf) -> Analysis:
-        """Analyze a single morf or code unit.
-
-        Returns an `Analysis` object.
-
-        """
-        # All reporting comes through here, so do reporting initialization.
+    def _analyze(self, morf: TMorf) -> Analysis:
+        """Analyze a module or file.  Private for now."""
         self._init()
         self._post_init()
 
         data = self.get_data()
-        if isinstance(it, FileReporter):
-            fr = it
-        else:
-            fr = self._get_file_reporter(it)
-
-        return Analysis(data, self.config.precision, fr, self._file_mapper)
+        file_reporter = self._get_file_reporter(morf)
+        filename = self._file_mapper(file_reporter.filename)
+        return analysis_from_file_reporter(data, self.config.precision, file_reporter, filename)
 
+    @functools.lru_cache(maxsize=1)
     def _get_file_reporter(self, morf: TMorf) -> FileReporter:
         """Get a FileReporter for a module or file name."""
         assert self._data is not None
@@ -975,11 +969,14 @@ def _get_file_reporter(self, morf: TMorf) -> FileReporter:
         assert isinstance(file_reporter, FileReporter)
         return file_reporter
 
-    def _get_file_reporters(self, morfs: Iterable[TMorf] | None = None) -> list[FileReporter]:
-        """Get a list of FileReporters for a list of modules or file names.
+    def _get_file_reporters(
+        self,
+        morfs: Iterable[TMorf] | None = None,
+    ) -> list[tuple[FileReporter, TMorf]]:
+        """Get FileReporters for a list of modules or file names.
 
         For each module or file name in `morfs`, find a FileReporter.  Return
-        the list of FileReporters.
+        a list pairing FileReporters with the morfs.
 
         If `morfs` is a single module or file name, this returns a list of one
         FileReporter.  If `morfs` is empty or None, then the list of all files
@@ -994,8 +991,7 @@ def _get_file_reporters(self, morfs: Iterable[TMorf] | None = None) -> list[File
         if not isinstance(morfs, (list, tuple, set)):
             morfs = [morfs]     # type: ignore[list-item]
 
-        file_reporters = [self._get_file_reporter(morf) for morf in morfs]
-        return file_reporters
+        return [(self._get_file_reporter(morf), morf) for morf in morfs]
 
     def _prepare_data_for_reporting(self) -> None:
         """Re-map data before reporting, to get implicit "combine" behavior."""
@@ -1302,7 +1298,7 @@ def plugin_info(plugins: list[Any]) -> list[str]:
             ("plugins.file_tracers", plugin_info(self._plugins.file_tracers)),
             ("plugins.configurers", plugin_info(self._plugins.configurers)),
             ("plugins.context_switchers", plugin_info(self._plugins.context_switchers)),
-            ("configs_attempted", self.config.attempted_config_files),
+            ("configs_attempted", self.config.config_files_attempted),
             ("configs_read", self.config.config_files_read),
             ("config_file", self.config.config_file),
             ("config_contents",