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

Author: gpshead

.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
@@ -673,12 +672,36 @@ 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
 peps/pep-0801.rst  @warsaw
 peps/pep-0802.rst  @AA-Turner
 peps/pep-0803.rst  @encukou
+peps/pep-0804.rst  @pradyunsg
+# ...
+peps/pep-0806.rst  @JelleZijlstra
+peps/pep-0807.rst  @dstufft
+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-0828.rst  @ZeroIntensity
 # ...
 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,36 +2,31 @@ 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
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           persist-credentials: false
 
-      - name: Set up Python 3
-        uses: actions/setup-python@v5
-        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,16 +23,16 @@ jobs:
       matrix:
         python-version:
         - "3.x"
-        - "3.14-dev"
+        - "3.15-dev"
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0  # fetch all history so that last modified date-times are accurate
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           cache: pip
@@ -42,7 +42,7 @@ jobs:
           python -m pip install --upgrade pip
 
       - name: Render PEPs
-        run: make dirhtml JOBS=$(nproc)
+        run: make dirhtml search JOBS=$(nproc)
 
         # remove the .doctrees folder when building for deployment as it takes two thirds of disk space
       - name: Clean up files

.github/workflows/test.yml

@@ -35,18 +35,19 @@ jobs:
         - "3.12"
         - "3.13"
         - "3.14"
+        - "3.15"
         os:
         - "windows-latest"
         - "macos-latest"
         - "ubuntu-latest"
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           persist-credentials: false
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           allow-prereleases: true

.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,22 +58,27 @@ 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'
         files: '^pep_sphinx_extensions/tests/'
+      - id: ruff-format
+        name: "Format with Ruff"
+        args:
+          - '--check'
+        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"
@@ -94,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"
@@ -111,3 +116,12 @@ repos:
         language: "python"
         files: '^peps/pep-\d{4}\.rst$'
         require_serial: true
+
+      # Hook to regenerate release schedules
+      - id: "regen-schedules"
+        name: "Regenerate release schedules from python-releases.toml"
+        entry: "python -m release_management update-peps"
+        language: "python"
+        files: "^release_management/"
+        pass_filenames: false
+        require_serial: true

.pytest.toml

@@ -0,0 +1,37 @@
+# https://docs.pytest.org/en/stable/reference/customize.html
+
+[pytest]
+minversion = "9.0"
+
+# https://docs.pytest.org/en/stable/reference/reference.html#command-line-flags
+addopts = [
+    # Show extra summary information for all non-passing tests
+    "-r a",
+    # https://docs.pytest.org/en/stable/explanation/pythonpath.html#import-modes
+    "--import-mode=importlib",
+    # https://pytest-cov.readthedocs.io/en/latest/config.html#reference
+    "--cov=check_peps",
+    "--cov=pep_sphinx_extensions",
+    "--cov=release_management",
+    "--cov-report=html",
+    "--cov-report=xml",
+]
+
+# Fail if pytest.mark.parametrize() has no parameters
+empty_parameter_set_mark = "fail_at_collect"
+
+filterwarnings = ["error"]
+
+testpaths = [
+    "pep_sphinx_extensions",
+    "release_management",
+]
+
+# https://docs.pytest.org/en/stable/reference/reference.html#confval-strict
+strict_config = true
+strict_markers = true
+strict_parametrization_ids = true
+strict_xfail = true
+
+# Various tests use Unicode in pytest.mark.parametrize().
+disable_test_id_escaping_and_forfeit_all_rights_to_community_support = true

.readthedocs.yaml

@@ -13,7 +13,7 @@ build:
     - asdf plugin add uv
     - asdf install uv latest
     - asdf global uv latest
-    - make dirhtml JOBS=$(nproc) BUILDDIR=_readthedocs/html
+    - make dirhtml search JOBS=$(nproc) BUILDDIR=_readthedocs/html
 
 sphinx:
   builder: dirhtml

Makefile

@@ -42,6 +42,11 @@ dirhtml: BUILDER = dirhtml
 dirhtml: html
 	mv $(BUILDDIR)/404/index.html $(BUILDDIR)/404.html
 
+## search         to rebuild the search index
+.PHONY: search
+search: venv
+	$(VENVDIR)/bin/python3 -m pagefind --site $(BUILDDIR) --verbose
+
 ## linkcheck      to check validity of links within PEP sources
 .PHONY: linkcheck
 linkcheck: BUILDER = linkcheck
@@ -108,6 +113,11 @@ test: venv
 spellcheck: _ensure-pre-commit
 	$(VENVDIR)/bin/python3 -m pre_commit run --all-files --hook-stage manual codespell
 
+## regen-all      to regenerate generated source files
+.PHONY: regen-all
+regen-all:
+	$(PYTHON) -m release_management update-peps
+
 .PHONY: help
 help : Makefile
 	@echo "Please use \`make <target>' where <target> is one of"