Merge remote-tracking branch 'origin/main' into pep-exception-timestamps

Author: gpshead

.github/CODEOWNERS

@@ -559,7 +559,7 @@ peps/pep-0675.rst  @jellezijlstra
 peps/pep-0676.rst  @AA-Turner @Mariatta
 peps/pep-0677.rst  @gvanrossum
 peps/pep-0678.rst  @iritkatriel
-peps/pep-0679.rst  @pablogsal
+peps/pep-0679.rst  @pablogsal @StanFromIreland
 peps/pep-0680.rst  @encukou
 peps/pep-0681.rst  @jellezijlstra
 peps/pep-0682.rst
@@ -652,7 +652,7 @@ peps/pep-0771.rst  @pradyunsg
 peps/pep-0772.rst  @warsaw @pradyunsg
 peps/pep-0773.rst  @zooba
 peps/pep-0774.rst  @savannahostrowski
-peps/pep-0775.rst  @encukou
+peps/pep-0775.rst  @encukou @StanFromIreland
 peps/pep-0776.rst  @hoodmane @ambv
 peps/pep-0777.rst  @warsaw @emmatyping
 peps/pep-0778.rst  @warsaw @emmatyping
@@ -663,7 +663,7 @@ peps/pep-0782.rst  @vstinner
 peps/pep-0783.rst  @hoodmane @ambv
 peps/pep-0784.rst  @gpshead @emmatyping
 peps/pep-0785.rst  @gpshead
-# ...
+peps/pep-0786.rst  @ncoghlan
 peps/pep-0787.rst  @ncoghlan
 peps/pep-0788.rst  @ZeroIntensity @vstinner
 peps/pep-0789.rst  @njsmith
@@ -702,6 +702,7 @@ peps/pep-0825.rst  @warsaw @dstufft
 peps/pep-0826.rst  @savannahostrowski
 peps/pep-0827.rst  @1st1
 peps/pep-0828.rst  @ZeroIntensity
+peps/pep-0829.rst  @warsaw
 peps/pep-0830.rst  @gpshead
 # ...
 peps/pep-2026.rst  @hugovk

.github/workflows/lint.yml

@@ -23,10 +23,10 @@ jobs:
           persist-credentials: false
 
       - name: Run pre-commit hooks
-        uses: j178/prek-action@v1
+        uses: j178/prek-action@v2
 
       - name: Check spelling
-        uses: j178/prek-action@v1
+        uses: j178/prek-action@v2
         continue-on-error: true
         with:
           extra_args: --all-files --hook-stage manual codespell

pep_sphinx_extensions/pep_theme/static/colour_scheme.js

@@ -9,6 +9,7 @@ const setColourScheme = (colourScheme = getColourScheme()) => {
     document.documentElement.dataset.colour_scheme = colourScheme
     localStorage.setItem("colour_scheme", colourScheme)
     setPygments(colourScheme)
+    setPfTheme(colourScheme)
 }
 
 // Map system theme to a cycle of steps
@@ -31,5 +32,10 @@ const setPygments = (colourScheme = getColourScheme()) => {
     pygmentsLight.media = colourScheme === "auto" ? "(prefers-color-scheme: light)" : ""
 }
 
+const setPfTheme = (colourScheme = getColourScheme()) => {
+    const isDark = colourScheme === "dark" || (colourScheme === "auto" && prefersDark.matches)
+    document.documentElement.dataset.pfTheme = isDark ? "dark" : ""
+}
+
 // Update Pygments state (the page theme is initialised inline, see page.html)
 document.addEventListener("DOMContentLoaded", () => setColourScheme())

pep_sphinx_extensions/pep_theme/static/style.css

@@ -50,6 +50,19 @@
     --colour-caution: var(--light, #ffa) var(--dark, #550);
     --colour-attention: var(--light, #bdf) var(--dark, #045);
     --colour-tip: var(--light, #bfc) var(--dark, #041);
+
+    /* Pagefind component UI — theme variable overrides */
+    --pf-text: var(--colour-text);
+    --pf-text-muted: var(--colour-rule-strong);
+    --pf-background: var(--colour-background);
+    --pf-border: var(--colour-background-accent-strong);
+    --pf-border-focus: var(--colour-links);
+    --pf-hover: var(--colour-background-accent-light);
+    --pf-mark: var(--colour-text-strong);
+    --pf-outline-width: 0px;
+    --pf-input-height: 30px;
+    --pf-border-radius: 3px;
+    --pf-searchbox-max-width: 100%;
 }
 
 img.invert-in-dark-mode {
@@ -420,182 +433,6 @@ dl.footnote > dd {
     padding-bottom: 2rem;
     font-weight: bold;
 }
-/* Pagefind search styling (custom, no default CSS) */
-.pagefind-ui {
-    --pagefind-ui-primary: var(--colour-links);
-    --pagefind-ui-text: var(--colour-text);
-    --pagefind-ui-background: var(--colour-background);
-    --pagefind-ui-border: var(--colour-background-accent-strong);
-    font-family: inherit;
-    width: 100%;
-}
-
-/* Search form */
-.pagefind-ui__form {
-    position: relative;
-}
-
-/* Search icon */
-.pagefind-ui__form::before {
-    background-color: var(--pagefind-ui-text);
-    width: 14px;
-    height: 14px;
-    top: 8px;
-    left: 8px;
-    content: "";
-    position: absolute;
-    display: block;
-    opacity: 0.5;
-    -webkit-mask-image: url("data:image/svg+xml,%3Csvg width='18' height='18' viewBox='0 0 18 18' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12.7549 11.255H11.9649L11.6849 10.985C12.6649 9.845 13.2549 8.365 13.2549 6.755C13.2549 3.165 10.3449 0.255005 6.75488 0.255005C3.16488 0.255005 0.254883 3.165 0.254883 6.755C0.254883 10.345 3.16488 13.255 6.75488 13.255C8.36488 13.255 9.84488 12.665 10.9849 11.685L11.2549 11.965V12.755L16.2549 17.745L17.7449 16.255L12.7549 11.255ZM6.75488 11.255C4.26488 11.255 2.25488 9.245 2.25488 6.755C2.25488 4.26501 4.26488 2.255 6.75488 2.255C9.24488 2.255 11.2549 4.26501 11.2549 6.755C11.2549 9.245 9.24488 11.255 6.75488 11.255Z' fill='%23000000'/%3E%3C/svg%3E%0A");
-    mask-image: url("data:image/svg+xml,%3Csvg width='18' height='18' viewBox='0 0 18 18' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12.7549 11.255H11.9649L11.6849 10.985C12.6649 9.845 13.2549 8.365 13.2549 6.755C13.2549 3.165 10.3449 0.255005 6.75488 0.255005C3.16488 0.255005 0.254883 3.165 0.254883 6.755C0.254883 10.345 3.16488 13.255 6.75488 13.255C8.36488 13.255 9.84488 12.665 10.9849 11.685L11.2549 11.965V12.755L16.2549 17.745L17.7449 16.255L12.7549 11.255ZM6.75488 11.255C4.26488 11.255 2.25488 9.245 2.25488 6.755C2.25488 4.26501 4.26488 2.255 6.75488 2.255C9.24488 2.255 11.2549 4.26501 11.2549 6.755C11.2549 9.245 9.24488 11.255 6.75488 11.255Z' fill='%23000000'/%3E%3C/svg%3E%0A");
-    -webkit-mask-size: 100%;
-    mask-size: 100%;
-    z-index: 9;
-    pointer-events: none;
-}
-
-/* Search input */
-.pagefind-ui__search-input {
-    height: 30px;
-    padding: 4px 28px 4px 28px;
-    background-color: var(--pagefind-ui-background);
-    border: 1px solid var(--pagefind-ui-border);
-    border-radius: 3px;
-    font-size: 0.875rem;
-    font-family: inherit;
-    appearance: none;
-    -webkit-appearance: none;
-    width: 100%;
-    box-sizing: border-box;
-    color: var(--pagefind-ui-text);
-}
-.pagefind-ui__search-input:focus {
-    outline: none;
-    border-color: var(--pagefind-ui-primary);
-}
-.pagefind-ui__search-input::placeholder {
-    color: var(--pagefind-ui-text);
-    opacity: 0.5;
-}
-
-/* Clear button - fixed position relative to input (30px height, center button) */
-.pagefind-ui__search-clear {
-    position: absolute;
-    top: 5px;
-    right: 4px;
-    padding: 2px 6px;
-    color: var(--pagefind-ui-text);
-    font-size: 0.75rem;
-    cursor: pointer;
-    background-color: var(--pagefind-ui-background);
-    border: none;
-    opacity: 0.6;
-}
-.pagefind-ui__search-clear:hover {
-    opacity: 1;
-}
-
-/* Results container */
-.pagefind-ui__results-area {
-    margin-top: 0.5rem;
-}
-
-/* Results list */
-#pep-sidebar .pagefind-ui__results {
-    list-style: none;
-    padding: 0;
-    margin: 0;
-}
-
-/* Individual result */
-.pagefind-ui__result {
-    padding: 0.5rem 0 0.5rem 0.5rem;
-    border-bottom: 1px solid var(--colour-rule-light);
-}
-.pagefind-ui__result:last-child {
-    border-bottom: none;
-}
-
-/* Result link */
-.pagefind-ui__result-link {
-    font-weight: bold;
-    font-size: 0.9rem;
-    text-decoration: none;
-    color: var(--colour-links);
-}
-.pagefind-ui__result-link:hover {
-    text-decoration: underline;
-}
-
-/* Result title */
-.pagefind-ui__result-title {
-    margin: 0;
-}
-
-/* Result excerpt/snippet */
-.pagefind-ui__result-excerpt {
-    font-size: 0.8rem;
-    color: var(--colour-text);
-    margin: 0.25rem 0 0;
-    line-height: 1.4;
-}
-
-/* Highlight matches in results */
-.pagefind-ui__result-excerpt mark,
-mark.pagefind-ui__highlight {
-    background-color: var(--colour-caution);
-    color: inherit;
-    padding: 0 2px;
-}
-
-/* Message when no results */
-.pagefind-ui__message {
-    font-size: 0.85rem;
-    color: var(--colour-text);
-    padding: 0.5rem 0;
-}
-
-/* Loading state */
-.pagefind-ui__loading {
-    font-size: 0.85rem;
-    color: var(--colour-text);
-    opacity: 0.7;
-}
-
-/* Sub-results (nested) */
-.pagefind-ui__result-nested {
-    margin-left: 1rem;
-    padding: 0.25rem 0;
-}
-.pagefind-ui__result-nested .pagefind-ui__result-link {
-    font-weight: normal;
-    font-size: 0.85rem;
-}
-
-/* Button styling */
-.pagefind-ui__button {
-    background: var(--colour-background-accent-light);
-    border: 1px solid var(--colour-background-accent-strong);
-    padding: 0.4rem 0.8rem;
-    border-radius: 4px;
-    cursor: pointer;
-    font-size: 0.85rem;
-    color: var(--colour-text);
-    margin-top: 0.5rem;
-}
-.pagefind-ui__button:hover {
-    background: var(--colour-background-accent-medium);
-}
-
-/* Drawer (expandable results container) */
-.pagefind-ui__drawer {
-    overflow: hidden;
-}
-
-/* Suppress unused pagefind elements */
-.pagefind-ui__suppressed {
-    display: none;
-}
 
 .reference.external > strong {
     font-weight: normal;  /* Fix strong links for :pep: and :rfc: roles */

pep_sphinx_extensions/pep_theme/templates/page.html

@@ -8,6 +8,7 @@
     <title>{{ title + " | peps.python.org"|safe }}</title>
     <link rel="shortcut icon" href="{{ pathto('_static/py.png', resource=True) }}">
     <link rel="canonical" href="https://peps.python.org/{{ pagename }}/">
+    <link rel="stylesheet" href="/pagefind/pagefind-component-ui.css" type="text/css">
     <link rel="stylesheet" href="{{ pathto('_static/style.css', resource=True) }}" type="text/css">
     <link rel="stylesheet" href="{{ pathto('_static/mq.css', resource=True) }}" type="text/css">
     <link rel="stylesheet" href="{{ pathto('_static/pygments.css', resource=True) }}" type="text/css" media="(prefers-color-scheme: light)" id="pyg-light">
@@ -47,7 +48,9 @@ <h1 data-pagefind-ignore>Python Enhancement Proposals</h1>
             </button>
         </header>
         {# Mobile search box - visible only on small screens #}
-        <div id="mobile-search" class="mobile-search-container"></div>
+        <div id="mobile-search" class="mobile-search-container">
+            <pagefind-searchbox hide-shortcut style="font-family: inherit"></pagefind-searchbox>
+        </div>
         {# Exclude noisy non-PEP pages from Pagefind indexing #}
         {%- if pagename.startswith(("404", "numerical", "pep-0000", "topic")) %}
         <article>
@@ -60,7 +63,7 @@ <h1 data-pagefind-ignore>Python Enhancement Proposals</h1>
         </article>
         {%- if not pagename.startswith(("404", "numerical")) %}
         <nav id="pep-sidebar">
-            <div id="search"></div>
+            <pagefind-searchbox shortcut="/" style="font-family: inherit"></pagefind-searchbox>
             <h2>Contents</h2>
             {{ toc }}
             <br>
@@ -79,25 +82,6 @@ <h2>Contents</h2>
     {%- endif %}
     <script src="https://analytics.python.org/js/script.outbound-links.js"
             data-domain="peps.python.org" defer></script>
-    <script src="/pagefind/pagefind-ui.js"></script>
-    <script>
-        window.addEventListener('DOMContentLoaded', (event) => {
-            // Ranking configuration to boost exact title matches
-            const searchOptions = {
-                ranking: {
-                    termSimilarity: 9.0, // Higher values favor exact matches
-                    termFrequency: 0.5, // Lower values reduce penalty for low term frequency
-                    pageLength: 0.2, // Lower values reduce the impact of page length
-                }
-            };
-
-            // Initialize pagefind for either mobile or desktop, not both
-            if (window.innerWidth <= 640) {
-                new PagefindUI({ element: "#mobile-search", ...searchOptions, showSubResults: false });
-            } else {
-                new PagefindUI({ element: "#search", ...searchOptions, showSubResults: true });
-            }
-        });
-    </script>
+    <script src="/pagefind/pagefind-component-ui.js" type="module"></script>
 </body>
 </html>

peps/api/index.rst

@@ -212,4 +212,4 @@ release-schedule.ics
 --------------------
 
 An iCalendar file of Python release dates is available at
-https://peps.python.org/api/release-schedule.ics.
+https://peps.python.org/release-schedule.ics.

peps/conf.py

@@ -69,17 +69,17 @@
 
 # Intersphinx configuration (keep this in alphabetical order)
 intersphinx_mapping = {
-    "devguide": ("https://devguide.python.org/", None),
-    "mypy": ("https://mypy.readthedocs.io/en/latest/", None),
-    "packaging": ("https://packaging.python.org/en/latest/", None),
-    "py3.11": ("https://docs.python.org/3.11/", None),
-    "py3.12": ("https://docs.python.org/3.12/", None),
-    "py3.13": ("https://docs.python.org/3.13/", None),
-    "py3.14": ("https://docs.python.org/3.14/", None),
-    "py3.15": ("https://docs.python.org/3.15/", None),
-    "python": ("https://docs.python.org/3/", None),
-    "trio": ("https://trio.readthedocs.io/en/latest/", None),
-    "typing": ("https://typing.python.org/en/latest/", None),
+    "devguide": ("https://devguide.python.org", None),
+    "mypy": ("https://mypy.readthedocs.io/en/latest", None),
+    "packaging": ("https://packaging.python.org/en/latest", None),
+    "py3.11": ("https://docs.python.org/3.11", None),
+    "py3.12": ("https://docs.python.org/3.12", None),
+    "py3.13": ("https://docs.python.org/3.13", None),
+    "py3.14": ("https://docs.python.org/3.14", None),
+    "py3.15": ("https://docs.python.org/3.15", None),
+    "python": ("https://docs.python.org/3", None),
+    "trio": ("https://trio.readthedocs.io/en/latest", None),
+    "typing": ("https://typing.python.org/en/latest", None),
 }
 intersphinx_disabled_reftypes = []
 

peps/pep-0011.rst

@@ -130,7 +130,7 @@ aarch64-pc-windows-msvc                                      Steve Dower
 arm64-apple-ios                  iOS on device               Russell Keith-Magee, Ned Deily
 arm64-apple-ios-simulator        iOS on M1 macOS simulator   Russell Keith-Magee, Ned Deily
 armv7l-unknown-linux-gnueabihf   32-bit Raspberry Pi OS, gcc Gregory P. Smith
-aarch64-unknown-linux-gnu        64-bit Raspberry Pi OS, gcc Savannah Ostrowski
+aarch64-unknown-linux-gnu        64-bit Raspberry Pi OS, gcc Savannah Ostrowski, Stan Ulbrych
 powerpc64le-unknown-linux-gnu    glibc, clang                Victor Stinner
 
                                  glibc, gcc                  Victor Stinner

peps/pep-0013.rst

@@ -19,19 +19,19 @@ to exercise as rarely as possible.
 Current steering council
 ========================
 
-The 2025 term steering council consists of:
+The 2026 term steering council consists of:
 
 * Barry Warsaw
 * Donghee Na
-* Emily Morehouse
-* Gregory P. Smith
 * Pablo Galindo Salgado
+* Savannah Ostrowski
+* Thomas Wouters
 
-Per the results of the vote tracked in :pep:`8106`.
+Per the results of the vote tracked in :pep:`8107`.
 
 The core team consists of those listed in the private
 https://github.com/python/voters/ repository which is publicly
-shared via https://devguide.python.org/developers/.
+shared via https://devguide.python.org/core-team/team-log/.
 
 
 Specification