Merge branch 'main' into pep-813-pprint

Author: warsaw

.github/CODEOWNERS

@@ -656,7 +656,6 @@ peps/pep-0775.rst  @encukou
 peps/pep-0776.rst  @hoodmane @ambv
 peps/pep-0777.rst  @warsaw @emmatyping
 peps/pep-0778.rst  @warsaw @emmatyping
-# ...
 peps/pep-0779.rst  @Yhg1s @colesbury @mpage
 peps/pep-0780.rst  @lysnikolaou
 peps/pep-0781.rst  @methane
@@ -673,6 +672,7 @@ peps/pep-0791.rst  @vstinner
 peps/pep-0792.rst  @dstufft
 peps/pep-0793.rst  @encukou
 peps/pep-0794.rst  @brettcannon
+peps/pep-0797.rst  @ZeroIntensity
 peps/pep-0798.rst  @JelleZijlstra
 peps/pep-0799.rst  @pablogsal
 peps/pep-0800.rst  @JelleZijlstra
@@ -691,9 +691,13 @@ peps/pep-0813.rst  @warsaw @ericvsmith
 peps/pep-0814.rst  @vstinner @corona10
 peps/pep-0815.rst  @emmatyping
 peps/pep-0816.rst  @brettcannon
-# ...
+peps/pep-0817.rst  @warsaw @dstufft
+peps/pep-0817/     @warsaw @dstufft
+peps/pep-0818.rst  @hoodmane @ambv
 peps/pep-0819.rst  @emmatyping
 peps/pep-0820.rst  @encukou
+peps/pep-0821.rst  @JelleZijlstra
+peps/pep-0822.rst  @methane
 # ...
 peps/pep-2026.rst  @hugovk
 # ...

.github/PULL_REQUEST_TEMPLATE/Add a new PEP.md

@@ -37,6 +37,9 @@ If your PEP is not Standards Track, remove the corresponding section.
     * [ ] Reference Implementation
     * [ ] Rejected Ideas
     * [ ] Open Issues
+    * [ ] Acknowledgements
+    * [ ] Footnotes
+    * [ ] Change History
 * [ ] ``Python-Version`` set to valid (pre-beta) future Python version, if relevant
 * [ ] Any project stated in the PEP as supporting/endorsing/benefiting from the PEP formally confirmed such
 * [ ] Right before or after initial merging, [PEP discussion thread](https://peps.python.org/pep-0001/#discussing-a-pep) created and linked to in ``Discussions-To`` and ``Post-History``

Makefile

@@ -22,6 +22,7 @@ ALLSPHINXOPTS = --builder $(BUILDER) \
 .PHONY: html
 html: venv
 	$(SPHINXBUILD) $(ALLSPHINXOPTS)
+	$(VENVDIR)/bin/python3 -m pagefind --site $(BUILDDIR) --verbose
 
 ## htmlview       to open the index page built by the html target in your browser
 .PHONY: htmlview

README.rst

@@ -20,6 +20,12 @@ Shortcut redirects are also available.
 For example, ``https://peps.python.org/8`` redirects to the canonical link.
 
 
+API
+===
+
+Several data files are available at https://peps.python.org/api/
+
+
 Contributing to PEPs
 ====================
 

pep_sphinx_extensions/pep_processor/html/pep_html_builder.py

@@ -33,7 +33,8 @@ def get_doc_context(self, docname: str, body: str, _metatags: str) -> dict:
         toc_tree = self.env.tocs[docname].deepcopy()
         if len(toc_tree) and len(toc_tree[0]) > 1:
             toc_tree = toc_tree[0][1]  # don't include document title
-            del toc_tree[0]  # remove contents node
+            if docname.startswith("pep-"):
+                del toc_tree[0]  # remove contents node from PEPs
             for node in toc_tree.findall(nodes.reference):
                 node["refuri"] = node["anchorname"] or '#'  # fix targets
             toc = self.render_partial(toc_tree)["fragment"]

pep_sphinx_extensions/pep_theme/static/mq.css

@@ -17,6 +17,10 @@
     nav#pep-sidebar {
         display: none;
     }
+    /* Show mobile search container on small screens */
+    .mobile-search-container {
+        display: block;
+    }
     pre {
         font-size: 0.8175rem;
     }
@@ -46,6 +50,10 @@
         float: left;
         margin-right: 2%;
     }
+    /* Hide mobile search container on larger screens */
+    .mobile-search-container {
+        display: none;
+    }
   /* Make less prominent when sidebar ToC is available */
   details > summary {
       font-size: 1rem;

pep_sphinx_extensions/pep_theme/static/style.css

@@ -236,7 +236,6 @@ div.table-wrapper {
 table {
     width: 100%;
     border-collapse: collapse;
-    border: 1px solid var(--colour-background-accent-strong);
 }
 table caption {
     margin: 1rem 0 .75rem;
@@ -245,22 +244,16 @@ table thead tr {
     background-color: var(--colour-background-accent-medium);
     color: var(--colour-text-strong);
 }
-table tbody tr {
-    border-top: 1px solid var(--colour-background-accent-strong);
-}
 table th,
 table td {
     text-align: left;
     padding: 0.25rem 0.5rem 0.2rem;
+    border: 1px solid var(--colour-background-accent-strong);
 }
 table.pep-zero-table tr td:nth-child(1),
 table.pep-zero-table tr td:nth-child(2) {
     white-space: nowrap;
 }
-table th + th,
-table td + td {
-    border-left: 1px solid var(--colour-background-accent-strong);
-}
 /* Common column widths for PEP status tables  */
 table.pep-zero-table tr td:nth-child(1) {
     width: 5%;
@@ -427,6 +420,182 @@ 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

@@ -33,7 +33,7 @@
     </script>
     <section id="pep-page-section">
         <header>
-            <h1>Python Enhancement Proposals</h1>
+            <h1 data-pagefind-ignore>Python Enhancement Proposals</h1>
             <ul class="breadcrumbs">
                 <li><a href="https://www.python.org/" title="The Python Programming Language">Python</a> &raquo; </li>
                 <li><a href="{{ pathto("pep-0000") }}">PEP Index</a> &raquo; </li>
@@ -46,11 +46,21 @@ <h1>Python Enhancement Proposals</h1>
                 <span class="visually-hidden">Toggle light / dark / auto colour theme</span>
             </button>
         </header>
+        {# Mobile search box - visible only on small screens #}
+        <div id="mobile-search" class="mobile-search-container"></div>
+        {# Exclude noisy non-PEP pages from Pagefind indexing #}
+        {%- if pagename.startswith(("404", "numerical", "pep-0000", "topic")) %}
         <article>
+        {%- else %}
+        <article data-pagefind-body>
+        {%- endif %}
+            {# Add pagefind meta for the title to improve search result display #}
+            <span data-pagefind-meta="title:{{ title }}" data-pagefind-weight="10" class="visually-hidden">{{ title }}</span>
             {{ body }}
         </article>
         {%- if not pagename.startswith(("404", "numerical")) %}
         <nav id="pep-sidebar">
+            <div id="search"></div>
             <h2>Contents</h2>
             {{ toc }}
             <br>
@@ -65,5 +75,25 @@ <h2>Contents</h2>
     <script src="{{ pathto('_static/sticky_banner.js', resource=True) }}"></script>
     <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>
 </body>
 </html>

peps/api/index.rst

@@ -207,3 +207,9 @@ for example:
        ]
      }
    }
+
+release-schedule.ics
+--------------------
+
+An iCalendar file of Python release dates is available at
+https://peps.python.org/api/release-schedule.ics.