Add python-releases.toml

.pre-commit-config.yaml

@@ -111,3 +111,11 @@ 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_engineering update-peps"
+        language: "python"
+        pass_filenames: false
+        require_serial: true

Makefile

@@ -107,6 +107,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_engineering update-peps
+
 .PHONY: help
 help : Makefile
 	@echo "Please use \`make <target>' where <target> is one of"

pep_sphinx_extensions/pep_zero_generator/pep_index_generator.py

@@ -19,13 +19,19 @@
 
 import json
 import os
+import sys
 from pathlib import Path
 from typing import TYPE_CHECKING
 
 from pep_sphinx_extensions.pep_zero_generator import parser
 from pep_sphinx_extensions.pep_zero_generator import subindices
 from pep_sphinx_extensions.pep_zero_generator import writer
 from pep_sphinx_extensions.pep_zero_generator.constants import SUBINDICES_BY_TOPIC
+if sys.version_info >= (3, 11):
+    from release_engineering.generate_release_cycle import create_release_cycle
+else:
+    def create_release_cycle():
+        return ''
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -73,3 +79,6 @@
     subindices.generate_subindices(SUBINDICES_BY_TOPIC, peps, docnames, env)
 
     write_peps_json(peps, Path(app.outdir))
+
+    release_cycle = create_release_cycle()
+    app.outdir.joinpath('release-cycle.json').write_text(release_cycle, encoding="utf-8")

peps/pep-0569.rst

@@ -51,58 +51,76 @@ Release Schedule
 3.8.0 schedule
 --------------
 
+.. feature release schedule
+
+Actual:
+
 - 3.8 development begins: Monday, 2018-01-29
 - 3.8.0 alpha 1: Sunday, 2019-02-03
 - 3.8.0 alpha 2: Monday, 2019-02-25
 - 3.8.0 alpha 3: Monday, 2019-03-25
 - 3.8.0 alpha 4: Monday, 2019-05-06
 - 3.8.0 beta 1: Tuesday, 2019-06-04
   (No new features beyond this point.)
-
 - 3.8.0 beta 2: Thursday, 2019-07-04
 - 3.8.0 beta 3: Monday, 2019-07-29
 - 3.8.0 beta 4: Friday, 2019-08-30
 - 3.8.0 candidate 1: Tuesday, 2019-10-01
 - 3.8.0 final: Monday, 2019-10-14
 
+.. end of schedule
+
 Bugfix releases
 ---------------
 
-- 3.8.1rc1: Tuesday, 2019-12-10
-- 3.8.1: Wednesday, 2019-12-18
-- 3.8.2rc1: Monday, 2020-02-10
-- 3.8.2rc2: Monday, 2020-02-17
-- 3.8.2: Monday, 2020-02-24
-- 3.8.3rc1: Wednesday, 2020-04-29
-- 3.8.3: Wednesday, 2020-05-13
-- 3.8.4rc1: Tuesday, 2020-06-30
-- 3.8.4: Monday, 2020-07-13
-- 3.8.5: Monday, 2020-07-20 (security hotfix)
-- 3.8.6rc1: Tuesday, 2020-09-08
-- 3.8.6: Thursday, 2020-09-24
-- 3.8.7rc1: Monday, 2020-12-07
-- 3.8.7: Monday, 2020-12-21
-- 3.8.8rc1: Tuesday, 2021-02-16
-- 3.8.8: Friday, 2021-02-19
-- 3.8.9: Friday, 2021-04-02 (security hotfix)
-- 3.8.10: Monday, 2021-05-03 (final regular bugfix release with binary
-  installers)
+.. bugfix release schedule
+
+Actual:
+
+- 3.8.1 candidate 1: Tuesday, 2019-12-10
+- 3.8.1 final: Wednesday, 2019-12-18
+- 3.8.2 candidate 1: Monday, 2020-02-10
+- 3.8.2 candidate 2: Monday, 2020-02-17
+- 3.8.2 final: Monday, 2020-02-24
+- 3.8.3 candidate 1: Wednesday, 2020-04-29
+- 3.8.3 final: Wednesday, 2020-05-13
+- 3.8.4 candidate 1: Tuesday, 2020-06-30
+- 3.8.4 final: Monday, 2020-07-13
+- 3.8.5 final: Monday, 2020-07-20
+  (security hotfix)
+- 3.8.6 candidate 1: Tuesday, 2020-09-08
+- 3.8.6 final: Thursday, 2020-09-24
+- 3.8.7 candidate 1: Monday, 2020-12-07
+- 3.8.7 final: Monday, 2020-12-21
+- 3.8.8 candidate 1: Tuesday, 2021-02-16
+- 3.8.8 final: Friday, 2021-02-19
+- 3.8.9 final: Friday, 2021-04-02
+  (security hotfix)
+- 3.8.10 final: Monday, 2021-05-03
+  (final regular bugfix release with binary installers)
+
+.. end of schedule
 
 Source-only security fix releases
 ---------------------------------
 
 Provided irregularly on an "as-needed" basis until October 7th 2024.
 
-- 3.8.11: Monday, 2021-06-28
-- 3.8.12: Monday, 2021-08-30
-- 3.8.13: Wednesday, 2022-03-16
-- 3.8.14: Tuesday, 2022-09-06
-- 3.8.15: Tuesday, 2022-10-11
-- 3.8.16: Tuesday, 2022-12-06
-- 3.8.17: Tuesday, 2023-06-06
-- 3.8.18: Thursday, 2023-08-24
-- 3.8.19: Tuesday, 2024-03-19
-- 3.8.20: Friday, 2024-09-06 (final security release)
+.. security release schedule
+
+- 3.8.11 final: Monday, 2021-06-28
+- 3.8.12 final: Monday, 2021-08-30
+- 3.8.13 final: Wednesday, 2022-03-16
+- 3.8.14 final: Tuesday, 2022-09-06
+- 3.8.15 final: Tuesday, 2022-10-11
+- 3.8.16 final: Tuesday, 2022-12-06
+- 3.8.17 final: Tuesday, 2023-06-06
+- 3.8.18 final: Thursday, 2023-08-24
+- 3.8.19 final: Tuesday, 2024-03-19
+- 3.8.20 final: Friday, 2024-09-06
+  (final security release)
+
+.. end of schedule
 
 
 Features for 3.8

peps/pep-0596.rst

@@ -40,6 +40,8 @@ Note: the dates below use a 17-month development period that results
 in a 12-month release cadence between feature versions, as defined by
 :pep:`602`.
 
+.. feature release schedule
+
 Actual:
 
 - 3.9 development begins: Tuesday, 2019-06-04
@@ -59,43 +61,56 @@ Actual:
 - 3.9.0 candidate 2: Thursday, 2020-09-17
 - 3.9.0 final: Monday, 2020-10-05
 
+.. end of schedule
+
 
 Bugfix releases
 ---------------
 
+.. bugfix release schedule
+
 Actual:
 
 - 3.9.1 candidate 1: Tuesday, 2020-11-24
 - 3.9.1 final: Monday, 2020-12-07
 - 3.9.2 candidate 1: Tuesday, 2021-02-16
 - 3.9.2 final: Friday, 2021-02-19
-- 3.9.3: Friday, 2021-04-02 (security hotfix; recalled due to bpo-43710)
-- 3.9.4: Sunday, 2021-04-04 (ABI compatibility hotfix)
-- 3.9.5: Monday, 2021-05-03
-- 3.9.6: Monday, 2021-06-28
-- 3.9.7: Monday, 2021-08-30
-- 3.9.8: Friday, 2021-11-05 (recalled due to bpo-45235)
-- 3.9.9: Monday, 2021-11-15
-- 3.9.10: Friday, 2022-01-14
-- 3.9.11: Wednesday, 2022-03-16
-- 3.9.12: Wednesday, 2022-03-23
-- 3.9.13: Tuesday, 2022-05-17 (final regular bugfix release with binary
-  installers)
+- 3.9.3 final: Friday, 2021-04-02
+  (security hotfix; recalled due to bpo-43710)
+- 3.9.4 final: Sunday, 2021-04-04
+  (ABI compatibility hotfix)
+- 3.9.5 final: Monday, 2021-05-03
+- 3.9.6 final: Monday, 2021-06-28
+- 3.9.7 final: Monday, 2021-08-30
+- 3.9.8 final: Friday, 2021-11-05
+  (recalled due to bpo-45235)
+- 3.9.9 final: Monday, 2021-11-15
+- 3.9.10 final: Friday, 2022-01-14
+- 3.9.11 final: Wednesday, 2022-03-16
+- 3.9.12 final: Wednesday, 2022-03-23
+- 3.9.13 final: Tuesday, 2022-05-17
+  (final regular bugfix release with binary installers)
+
+.. end of schedule
 
 
 Source-only security fix releases
 ---------------------------------
 
 Provided irregularly on an "as-needed" basis until October 2025.
 
-- 3.9.14: Tuesday, 2022-09-06
-- 3.9.15: Tuesday, 2022-10-11
-- 3.9.16: Tuesday, 2022-12-06
-- 3.9.17: Tuesday, 2023-06-06
-- 3.9.18: Thursday, 2023-08-24
-- 3.9.19: Tuesday, 2024-03-19
-- 3.9.20: Friday, 2024-09-06
-- 3.9.21: Tuesday, 2024-12-03
+.. security release schedule
+
+- 3.9.14 final: Tuesday, 2022-09-06
+- 3.9.15 final: Tuesday, 2022-10-11
+- 3.9.16 final: Tuesday, 2022-12-06
+- 3.9.17 final: Tuesday, 2023-06-06
+- 3.9.18 final: Thursday, 2023-08-24
+- 3.9.19 final: Tuesday, 2024-03-19
+- 3.9.20 final: Friday, 2024-09-06
+- 3.9.21 final: Tuesday, 2024-12-03
+
+.. end of schedule
 
 
 3.9 Lifespan

peps/pep-0619.rst

@@ -37,6 +37,8 @@ Note: the dates below use a 17-month development period that results
 in a 12-month release cadence between feature versions, as defined by
 :pep:`602`.
 
+.. feature release schedule
+
 Actual:
 
 - 3.10 development begins: Monday, 2020-05-18
@@ -56,34 +58,44 @@ Actual:
 - 3.10.0 candidate 2: Tuesday, 2021-09-07
 - 3.10.0 final: Monday, 2021-10-04
 
+.. end of schedule
+
 Bugfix releases
 ---------------
 
+.. bugfix release schedule
+
 Actual:
 
-- 3.10.1: Monday, 2021-12-06
-- 3.10.2: Friday, 2022-01-14
-- 3.10.3: Wednesday, 2022-03-16
-- 3.10.4: Thursday, 2022-03-24
-- 3.10.5: Monday, 2022-06-06
-- 3.10.6: Tuesday, 2022-08-02
-- 3.10.7: Tuesday, 2022-09-06
-- 3.10.8: Tuesday, 2022-10-11
-- 3.10.9: Tuesday, 2022-12-06
-- 3.10.10: Wednesday, 2023-02-08
-- 3.10.11: Wednesday, 2023-04-05 (final regular bugfix release with binary
-  installers)
+- 3.10.1 final: Monday, 2021-12-06
+- 3.10.2 final: Friday, 2022-01-14
+- 3.10.3 final: Wednesday, 2022-03-16
+- 3.10.4 final: Thursday, 2022-03-24
+- 3.10.5 final: Monday, 2022-06-06
+- 3.10.6 final: Tuesday, 2022-08-02
+- 3.10.7 final: Tuesday, 2022-09-06
+- 3.10.8 final: Tuesday, 2022-10-11
+- 3.10.9 final: Tuesday, 2022-12-06
+- 3.10.10 final: Wednesday, 2023-02-08
+- 3.10.11 final: Wednesday, 2023-04-05
+  (final regular bugfix release with binary installers)
+
+.. end of schedule
 
 Source-only security fix releases
 ---------------------------------
 
 Provided irregularly on an "as-needed" basis until October 2026.
 
-- 3.10.12: Tuesday, 2023-06-06
-- 3.10.13: Thursday, 2023-08-24
-- 3.10.14: Tuesday, 2024-03-19
-- 3.10.15: Saturday, 2024-09-07
-- 3.10.16: Tuesday, 2024-12-03
+.. security release schedule
+
+- 3.10.12 final: Tuesday, 2023-06-06
+- 3.10.13 final: Thursday, 2023-08-24
+- 3.10.14 final: Tuesday, 2024-03-19
+- 3.10.15 final: Saturday, 2024-09-07
+- 3.10.16 final: Tuesday, 2024-12-03
+
+.. end of schedule
 
 3.10 Lifespan
 -------------

peps/pep-0664.rst

@@ -38,6 +38,8 @@ Note: the dates below use a 17-month development period that results
 in a 12-month release cadence between feature versions, as defined by
 :pep:`602`.
 
+.. feature release schedule
+
 Actual:
 
 - 3.11 development begins: Monday, 2021-05-03
@@ -56,31 +58,41 @@ Actual:
 - 3.11.0 beta 5: Tuesday, 2022-07-26
 - 3.11.0 candidate 1: Monday, 2022-08-08
 - 3.11.0 candidate 2: Monday, 2022-09-12
-- 3.11.0 final:  Monday, 2022-10-24
+- 3.11.0 final: Monday, 2022-10-24
+
+.. end of schedule
 
 Bugfix releases
 ---------------
 
+.. bugfix release schedule
+
 Actual:
 
-- 3.11.1: Tuesday, 2022-12-06
-- 3.11.2: Wednesday, 2023-02-08
-- 3.11.3: Wednesday, 2023-04-05
-- 3.11.4: Tuesday, 2023-06-06
-- 3.11.5: Thursday, 2023-08-24
-- 3.11.6: Monday, 2023-10-02
-- 3.11.7: Monday, 2023-12-04
-- 3.11.8: Tuesday, 2024-02-06
-- 3.11.9: Tuesday, 2024-04-02 (final regular bugfix release with binary
-  installers)
+- 3.11.1 final: Tuesday, 2022-12-06
+- 3.11.2 final: Wednesday, 2023-02-08
+- 3.11.3 final: Wednesday, 2023-04-05
+- 3.11.4 final: Tuesday, 2023-06-06
+- 3.11.5 final: Thursday, 2023-08-24
+- 3.11.6 final: Monday, 2023-10-02
+- 3.11.7 final: Monday, 2023-12-04
+- 3.11.8 final: Tuesday, 2024-02-06
+- 3.11.9 final: Tuesday, 2024-04-02
+  (final regular bugfix release with binary installers)
+
+.. end of schedule
 
 Source-only security fix releases
 ---------------------------------
 
 Provided irregularly on an "as-needed" basis until October 2027.
 
-- 3.11.10: Saturday, 2024-09-07
-- 3.11.11: Tuesday, 2024-12-03
+.. security release schedule
+
+- 3.11.10 final: Saturday, 2024-09-07
+- 3.11.11 final: Tuesday, 2024-12-03
+
+.. end of schedule
 
 3.11 Lifespan
 -------------