.github/workflows/python-nightly.yml

@@ -58,6 +58,7 @@ jobs:
           # https://launchpad.net/~deadsnakes/+archive/ubuntu/nightly/+packages
           - "3.12-dev"
           - "3.13-dev"
+          - "3.14-dev"
           # https://github.com/actions/setup-python#available-versions-of-pypy
           - "pypy-3.8-nightly"
           - "pypy-3.9-nightly"

CHANGES.rst

@@ -22,6 +22,36 @@ upgrading your version of coverage.py.
 
 .. scriv-start-here
 
+.. _changes_7-5-2:
+
+Version 7.5.2 — 2024-05-24
+--------------------------
+
+- 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 <pull 1776_>`_.
+
+- 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
+  <pull 1788_>`_. Closes `issue 1787`_.
+
+.. _pull 1776: https://github.com/nedbat/coveragepy/pull/1776
+.. _issue 1779: https://github.com/nedbat/coveragepy/issues/1779
+.. _issue 1787: https://github.com/nedbat/coveragepy/issues/1787
+.. _pull 1788: https://github.com/nedbat/coveragepy/pull/1788
+
+
 .. _changes_7-5-1:
 
 Version 7.5.1 — 2024-05-04

CONTRIBUTORS.txt

@@ -132,6 +132,7 @@ Latrice Wilgus
 Leonardo Pistone
 Lewis Gaul
 Lex Berezhny
+Liam DeVoe
 Loïc Dachary
 Lorenzo Micò
 Louis Heredero

README.rst

@@ -25,7 +25,7 @@ Coverage.py runs on these versions of Python:
 
 .. PYVERSIONS
 
-* Python 3.8 through 3.12, and 3.13.0a6 and up.
+* Python 3.8 through 3.12, and 3.13.0b1 and up.
 * PyPy3 versions 3.8 through 3.10.
 
 Documentation is on `Read the Docs`_.  Code repository and issue tracker are on

coverage/html.py

@@ -597,7 +597,7 @@ def write_index_page(self, index_page: IndexPage, **kwargs: str) -> str:
             "regions": index_page.summaries,
             "totals": index_page.totals,
             "noun": index_page.noun,
-            "column2": index_page.noun if index_page.noun != "file" else "",
+            "region_noun": index_page.noun if index_page.noun != "file" else "",
             "skip_covered": self.skip_covered,
             "skipped_covered_msg": skipped_covered_msg,
             "skipped_empty_msg": skipped_empty_msg,

coverage/htmlfiles/coverage_html.js

@@ -125,6 +125,16 @@ coverage.assign_shortkeys = function () {
 
 // Create the events for the filter box.
 coverage.wire_up_filter = function () {
+    // Populate the filter and hide100 inputs if there are saved values for them.
+    const saved_filter_value = localStorage.getItem(coverage.FILTER_STORAGE);
+    if (saved_filter_value) {
+        document.getElementById("filter").value = saved_filter_value;
+    }
+    const saved_hide100_value = localStorage.getItem(coverage.HIDE100_STORAGE);
+    if (saved_hide100_value) {
+        document.getElementById("hide100").checked = JSON.parse(saved_hide100_value);
+    }
+
     // Cache elements.
     const table = document.querySelector("table.index");
     const table_body_rows = table.querySelectorAll("tbody tr");
@@ -138,8 +148,12 @@ coverage.wire_up_filter = function () {
         totals[totals.length - 1] = { "numer": 0, "denom": 0 };  // nosemgrep: eslint.detect-object-injection
 
         var text = document.getElementById("filter").value;
+        // Store filter value
+        localStorage.setItem(coverage.FILTER_STORAGE, text);
         const casefold = (text === text.toLowerCase());
         const hide100 = document.getElementById("hide100").checked;
+        // Store hide value.
+        localStorage.setItem(coverage.HIDE100_STORAGE, JSON.stringify(hide100));
 
         // Hide / show elements.
         table_body_rows.forEach(row => {
@@ -240,6 +254,8 @@ coverage.wire_up_filter = function () {
     document.getElementById("filter").dispatchEvent(new Event("input"));
     document.getElementById("hide100").dispatchEvent(new Event("input"));
 };
+coverage.FILTER_STORAGE = "COVERAGE_FILTER_VALUE";
+coverage.HIDE100_STORAGE = "COVERAGE_HIDE100_VALUE";
 
 // Set up the click-to-sort columns.
 coverage.wire_up_sorting = function () {

coverage/htmlfiles/index.html

@@ -31,7 +31,7 @@ <h1>{{ title|escape }}:
                 <div class="keyhelp">
                     <p>
                         <kbd>f</kbd>
-                        {% if column2 %}
+                        {% if region_noun %}
                         <kbd>n</kbd>
                         {% endif %}
                         <kbd>s</kbd>
@@ -83,8 +83,8 @@ <h2>
             {# The title="" attr doesn't work in Safari. #}
             <tr class="tablehead" title="Click to sort">
                 <th id="file" class="name left" aria-sort="none" data-shortcut="f">File<span class="arrows"></span></th>
-                {% if column2 %}
-                <th id="region" class="name left" aria-sort="none" data-default-sort-order="ascending" data-shortcut="n">{{ column2 }}<span class="arrows"></span></th>
+                {% if region_noun %}
+                <th id="region" class="name left" aria-sort="none" data-default-sort-order="ascending" data-shortcut="n">{{ region_noun }}<span class="arrows"></span></th>
                 {% endif %}
                 <th id="statements" aria-sort="none" data-default-sort-order="descending" data-shortcut="s">statements<span class="arrows"></span></th>
                 <th id="missing" aria-sort="none" data-default-sort-order="descending" data-shortcut="m">missing<span class="arrows"></span></th>
@@ -100,7 +100,7 @@ <h2>
             {% for region in regions %}
             <tr class="region">
                 <td class="name left"><a href="{{region.url}}">{{region.file}}</a></td>
-                {% if column2 %}
+                {% if region_noun %}
                 <td class="name left"><a href="{{region.url}}">{{region.description}}</a></td>
                 {% endif %}
                 <td>{{region.nums.n_statements}}</td>
@@ -117,7 +117,7 @@ <h2>
         <tfoot>
             <tr class="total">
                 <td class="name left">Total</td>
-                {% if column2 %}
+                {% if region_noun %}
                 <td class="name left">&nbsp;</td>
                 {% endif %}
                 <td>{{totals.n_statements}}</td>

coverage/misc.py

@@ -13,7 +13,6 @@
 import importlib
 import importlib.util
 import inspect
-import locale
 import os
 import os.path
 import re
@@ -22,7 +21,7 @@
 
 from types import ModuleType
 from typing import (
-    Any, IO, Iterable, Iterator, Mapping, NoReturn, Sequence, TypeVar,
+    Any, Iterable, Iterator, Mapping, NoReturn, Sequence, TypeVar,
 )
 
 from coverage.exceptions import CoverageException
@@ -156,18 +155,6 @@ def ensure_dir_for_file(path: str) -> None:
     ensure_dir(os.path.dirname(path))
 
 
-def output_encoding(outfile: IO[str] | None = None) -> str:
-    """Determine the encoding to use for output written to `outfile` or stdout."""
-    if outfile is None:
-        outfile = sys.stdout
-    encoding = (
-        getattr(outfile, "encoding", None) or
-        getattr(sys.__stdout__, "encoding", None) or
-        locale.getpreferredencoding()
-    )
-    return encoding
-
-
 class Hasher:
     """Hashes Python data for fingerprinting."""
     def __init__(self) -> None: