Skip to content

Add python-releases.toml #4331

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 16 commits into
base: main
Choose a base branch
from
Draft

Add python-releases.toml #4331

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
13bf22c
Add python-releases.toml
AA-Turner Mar 29, 2025
813ac0d
Add initial scripts
AA-Turner Mar 29, 2025
1615b1d
Add release schedule markers
AA-Turner Mar 29, 2025
3414c2e
Integrate into the build process
AA-Turner Mar 29, 2025
d81a00d
Regenerate release schedules
AA-Turner Mar 29, 2025
27be901
Standardise versions
AA-Turner Mar 29, 2025
7836259
Regenerate release schedules
AA-Turner Mar 29, 2025
9a70c0a
Temporary workaround for tests on 3.9 & 3.10
AA-Turner Mar 29, 2025
2207db2
Add 1.6.1
AA-Turner Mar 29, 2025
674eba1
Standardise versions
AA-Turner Mar 29, 2025
3dc6277
Add explicit licence (Public Domain or CC0)
AA-Turner Mar 29, 2025
a72c1f9
Initial review notes
AA-Turner Apr 5, 2025
e4f42ac
Update for 3.15, from PEP 790
AA-Turner May 2, 2025
73cf41e
Merge remote-tracking branch 'upstream/main' into release-toml
AA-Turner May 2, 2025
7b18f8d
fixup! Update for 3.15, from PEP 790
AA-Turner May 2, 2025
1f1c73d
8/4/25 releases
AA-Turner May 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions .pre-commit-config.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -111,3 +111,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_engineering update-peps"
language: "python"
files: "^release_engineering/"
pass_filenames: false
require_serial: true
5 changes: 5 additions & 0 deletions Makefile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down
10 changes: 10 additions & 0 deletions pep_sphinx_extensions/pep_zero_generator/pep_index_generator.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,13 +19,20 @@

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:
# this function uses tomllib, which requires Python 3.11+
Copy link
Member

@merwok merwok May 3, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The comment would make more sense before line 31 or before line 30. This function here on lines 34-35 does not use tomllib!

But also, you could have a version-dependent dependency like tomli >= 1.1.0 ; python_version < "3.11" and a try/except import. But it’s up to you, I’m not well versed in release engineering to know when an older python would be used, and then whether a silent no-op is better than working or having a clear error 🙂

def create_release_cycle():
return ''

Check warning on line 35 in pep_sphinx_extensions/pep_zero_generator/pep_index_generator.py

View check run for this annotation

Codecov / codecov/patch

pep_sphinx_extensions/pep_zero_generator/pep_index_generator.py#L35 

Added line #L35 was not covered by tests

if TYPE_CHECKING:
from sphinx.application import Sphinx
Expand Down Expand Up @@ -73,3 +80,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")

Check warning on line 85 in pep_sphinx_extensions/pep_zero_generator/pep_index_generator.py

View check run for this annotation

Codecov / codecov/patch

pep_sphinx_extensions/pep_zero_generator/pep_index_generator.py#L84-L85 

Added lines #L84 - L85 were not covered by tests
78 changes: 48 additions & 30 deletions peps/pep-0569.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
57 changes: 36 additions & 21 deletions peps/pep-0596.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -59,44 +61,57 @@ 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
- 3.9.22: Tuesday, 2025-04-08
.. 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
- 3.9.22 final: Tuesday, 2025-04-08

.. end of schedule


3.9 Lifespan
Expand Down
48 changes: 30 additions & 18 deletions peps/pep-0619.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -56,35 +58,45 @@ 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
- 3.10.17: Tuesday, 2025-04-08
.. 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
- 3.10.17 final: Tuesday, 2025-04-08

.. end of schedule

3.10 Lifespan
-------------
Expand Down
40 changes: 26 additions & 14 deletions peps/pep-0664.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -56,32 +58,42 @@ 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
- 3.11.12: Tuesday, 2025-04-08
.. security release schedule

- 3.11.10 final: Saturday, 2024-09-07
- 3.11.11 final: Tuesday, 2024-12-03
- 3.11.12 final: Tuesday, 2025-04-08

.. end of schedule

3.11 Lifespan
-------------
Expand Down
Loading