Merge branch 'main' into pep-817-wheel-variants

Author: warsaw

.github/CODEOWNERS

@@ -673,6 +673,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
@@ -694,6 +695,10 @@ peps/pep-0816.rst  @brettcannon
 peps/pep-0817.rst  @warsaw @dstufft
 peps/pep-0817/     @warsaw @dstufft
 # ...
+peps/pep-0819.rst  @emmatyping
+peps/pep-0820.rst  @encukou
+peps/pep-0822.rst  @methane
+# ...
 peps/pep-2026.rst  @hugovk
 # ...
 peps/pep-3000.rst  @gvanrossum

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

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

@@ -152,7 +152,7 @@
 
     section#pep-page-section > article {
         float: none;
-        max-width: 17.5cm;
+        max-width: 100%;
         width: auto;
         margin: 0;
         padding: 0;

peps/api/index.rst

@@ -1,6 +1,9 @@
 PEPs API
 ========
 
+peps.json
+---------
+
 There is a read-only JSON document of every published PEP available at
 https://peps.python.org/api/peps.json.
 
@@ -102,3 +105,111 @@ illustrating some of the possible values for each field:
        "url": "https://peps.python.org/pep-3124/"
      }
    }
+
+release-cycle.json
+------------------
+
+There is a read-only JSON document of Python releases
+available at https://peps.python.org/api/release-cycle.json.
+
+Each feature version is represented as a JSON object,
+keyed by the minor version number ("X.Y").
+The structure of each JSON object is as follows:
+
+.. code-block:: typescript
+
+   {
+     "<language version number>": {
+       "branch": string,
+       "pep": integer,
+       "status": 'feature' | 'prerelease' | 'bugfix' | 'security' | 'end-of-life',
+       "first_release": string,  // Date formatted as YYYY-MM-DD
+       "end_of_life": string,  // Date formatted as YYYY-MM-DD
+       "release_manager": string
+     },
+   }
+
+For example:
+
+.. code-block:: json
+
+   {
+     "3.15": {
+       "branch": "main",
+       "pep": 790,
+       "status": "feature",
+       "first_release": "2026-10-01",
+       "end_of_life": "2031-10",
+       "release_manager": "Hugo van Kemenade"
+     },
+     "3.14": {
+       "branch": "3.14",
+       "pep": 745,
+       "status": "bugfix",
+       "first_release": "2025-10-07",
+       "end_of_life": "2030-10",
+       "release_manager": "Hugo van Kemenade"
+     }
+   }
+
+python-releases.json
+--------------------
+
+A more complete JSON document of all Python releases since version 1.6 is
+available at https://peps.python.org/api/python-releases.json and includes
+metadata about each feature release cycle, for example:
+
+.. code-block:: json
+
+   {
+     "metadata": {
+       "3.14": {
+         "pep": 745,
+         "status": "bugfix",
+         "branch": "3.14",
+         "release_manager": "Hugo van Kemenade",
+         "start_of_development": "2024-05-08",
+         "feature_freeze": "2025-05-07",
+         "first_release": "2025-10-07",
+         "end_of_bugfix": "2027-10-07",
+         "end_of_life": "2030-10-01"
+       }
+     }
+   }
+
+
+And also detailed information about each individual release within that cycle,
+for example:
+
+.. code-block:: json
+
+   {
+     "releases": {
+       "3.14": [
+         {
+           "stage": "3.14.0 candidate 3",
+           "state": "actual",
+           "date": "2025-09-18",
+           "note": ""
+         },
+         {
+           "stage": "3.14.0 final",
+           "state": "actual",
+           "date": "2025-10-07",
+           "note": ""
+         },
+         {
+           "stage": "3.14.1",
+           "state": "expected",
+           "date": "2025-12-02",
+           "note": ""
+         }
+       ]
+     }
+   }
+
+release-schedule.ics
+--------------------
+
+An iCalendar file of Python release dates is available at
+https://peps.python.org/api/release-schedule.ics.