Merge branch 'main' into pep795

Author: hugovk

.github/CODEOWNERS

@@ -50,7 +50,7 @@ peps/pep-0020.rst  @tim-one
 peps/pep-0042.rst  @jeremyhylton
 # ...
 peps/pep-0100.rst  @malemburg
-peps/pep-0101.rst  @hugovk @Yhg1s @pablogsal @ambv @ned-deily
+peps/pep-0101.rst  @savannahostrowski @hugovk @Yhg1s @pablogsal @ambv @ned-deily
 peps/pep-0102.rst  @warsaw @gvanrossum
 # peps/pep-0103.rst
 # ...
@@ -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
@@ -675,6 +674,7 @@ peps/pep-0793.rst  @encukou
 peps/pep-0794.rst  @brettcannon
 peps/pep-0795.rst  @mdboom
 # ...
+peps/pep-0797.rst  @ZeroIntensity
 peps/pep-0798.rst  @JelleZijlstra
 peps/pep-0799.rst  @pablogsal
 peps/pep-0800.rst  @JelleZijlstra
@@ -689,10 +689,20 @@ peps/pep-0808.rst  @FFY00
 peps/pep-0809.rst  @zooba
 peps/pep-0810.rst  @pablogsal @DinoV @Yhg1s
 peps/pep-0811.rst  @sethmlarson @gpshead
-# ...
+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-0825.rst  @warsaw @dstufft
+peps/pep-0826.rst  @savannahostrowski
+peps/pep-0827.rst  @1st1
 # ...
 peps/pep-2026.rst  @hugovk
 # ...

.github/PULL_REQUEST_TEMPLATE/Add a new PEP.md

@@ -29,14 +29,17 @@ If your PEP is not Standards Track, remove the corresponding section.
 * [ ] PEP topic [discussed in a suitable venue](https://peps.python.org/pep-0001/#start-with-an-idea-for-python) with general agreement that a PEP is appropriate
 * [ ] [Suggested sections](https://peps.python.org/pep-0012/#suggested-sections) included (unless not applicable)
     * [ ] Motivation
-    * [ ] Rationale
     * [ ] Specification
+    * [ ] Rationale
     * [ ] Backwards Compatibility
     * [ ] Security Implications
     * [ ] How to Teach This
     * [ ] 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``

.github/dependabot.yml

@@ -4,7 +4,11 @@ updates:
     directory: "/"
     schedule:
       interval: monthly
+    assignees:
+      - "ezio-melotti"
     groups:
       actions:
         patterns:
           - "*"
+    cooldown:
+      default-days: 7

.github/workflows/lint.yml

@@ -2,19 +2,18 @@ name: Lint PEPs
 
 on: [push, pull_request, workflow_dispatch]
 
-permissions:
-  contents: read
+permissions: {}
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
 
 env:
   FORCE_COLOR: 1
-  RUFF_FORMAT: github
+  RUFF_OUTPUT_FORMAT: github
 
 jobs:
-  pre-commit:
+  lint:
     name: Run pre-commit
     runs-on: ubuntu-latest
 
@@ -23,15 +22,11 @@ jobs:
         with:
           persist-credentials: false
 
-      - name: Set up Python 3
-        uses: actions/setup-python@v6
-        with:
-          python-version: "3.x"
-
       - name: Run pre-commit hooks
-        uses: tox-dev/action-pre-commit-uv@v1
+        uses: j178/prek-action@v1
 
       - name: Check spelling
-        uses: tox-dev/action-pre-commit-uv@v1
+        uses: j178/prek-action@v1
+        continue-on-error: true
         with:
-          extra_args: --all-files --hook-stage manual codespell || true
+          extra_args: --all-files --hook-stage manual codespell

.github/workflows/render.yml

@@ -23,7 +23,7 @@ jobs:
       matrix:
         python-version:
         - "3.x"
-        - "3.14-dev"
+        - "3.15-dev"
 
     steps:
       - name: Checkout

.github/workflows/test.yml

@@ -35,6 +35,7 @@ jobs:
         - "3.12"
         - "3.13"
         - "3.14"
+        - "3.15"
         os:
         - "windows-latest"
         - "macos-latest"

.pre-commit-config.yaml

@@ -12,7 +12,7 @@ default_stages: [pre-commit]
 repos:
   # General file checks and fixers
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: end-of-file-fixer
         name: "Ensure files end with a single newline"
@@ -48,7 +48,7 @@ repos:
         name: "Check YAML"
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.10.0
+    rev: 25.12.0
     hooks:
       - id: black
         name: "Format with Black"
@@ -58,9 +58,9 @@ repos:
         files: '^(peps/conf\.py|pep_sphinx_extensions/tests/.*)$'
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.7.0
+    rev: v0.14.10
     hooks:
-      - id: ruff
+      - id: ruff-check
         name: "Lint with Ruff"
         args:
           - '--exit-non-zero-on-fix'
@@ -72,13 +72,13 @@ repos:
         files: '^release_management/'
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: 1.4.1
+    rev: 1.7.1
     hooks:
       - id: tox-ini-fmt
         name: "Format tox.ini"
 
   - repo: https://github.com/sphinx-contrib/sphinx-lint
-    rev: v1.0.0
+    rev: v1.0.2
     hooks:
       - id: sphinx-lint
         name: "Sphinx lint"
@@ -99,7 +99,7 @@ repos:
 
   # Manual codespell check
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.3.0
+    rev: v2.4.1
     hooks:
       - id: codespell
         name: "Check for common misspellings in text files"

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"]