summary refs log tree commit diff
path: root/doc/languages-frameworks/python.section.md
diff options
context:
space:
mode:
authorgithub-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>2021-12-10 00:01:53 +0000
committerGitHub <noreply@github.com>2021-12-10 00:01:53 +0000
commit92aabc6576eead6b544354f10ccb865e180173f4 (patch)
tree4a0df408a18c940a8e2f078bc472e40716fd5d94 /doc/languages-frameworks/python.section.md
parent28ce39388c80ecb81ca84eab723923872f20792c (diff)
parent9fb7d91888fa24a7f96fd1915da2d4bc5e9b834e (diff)
downloadnixpkgs-92aabc6576eead6b544354f10ccb865e180173f4.tar
nixpkgs-92aabc6576eead6b544354f10ccb865e180173f4.tar.gz
nixpkgs-92aabc6576eead6b544354f10ccb865e180173f4.tar.bz2
nixpkgs-92aabc6576eead6b544354f10ccb865e180173f4.tar.lz
nixpkgs-92aabc6576eead6b544354f10ccb865e180173f4.tar.xz
nixpkgs-92aabc6576eead6b544354f10ccb865e180173f4.tar.zst
nixpkgs-92aabc6576eead6b544354f10ccb865e180173f4.zip
Merge master into staging-next
Diffstat (limited to 'doc/languages-frameworks/python.section.md')
-rw-r--r--doc/languages-frameworks/python.section.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/languages-frameworks/python.section.md b/doc/languages-frameworks/python.section.md
index 9fd475261c0..84721daa28f 100644
--- a/doc/languages-frameworks/python.section.md
+++ b/doc/languages-frameworks/python.section.md
@@ -1633,3 +1633,25 @@ would be:
 ```ShellSession
 $ maintainers/scripts/update-python-libraries --target minor --commit --use-pkgs-prefix pkgs/development/python-modules/**/default.nix
 ```
+
+## CPython Update Schedule
+
+With [PEP 602](https://www.python.org/dev/peps/pep-0602/), CPython now
+follows a yearly release cadence. In nixpkgs, all supported interpreters
+are made available, but only the most recent two
+interpreters package sets are built; this is a compromise between being
+the latest interpreter, and what the majority of the Python packages support.
+
+New CPython interpreters are released in October. Generally, it takes some
+time for the majority of active Python projects to support the latest stable
+interpreter. To help ease the migration for Nixpkgs users
+between Python interpreters the schedule below will be used:
+
+| When | Event |
+| --- | --- |
+| After YY.11 Release | Bump CPython package set window. The latest and previous latest stable should now be built. |
+| After YY.05 Release | Bump default CPython interpreter to latest stable. |
+
+In practice, this means that the Python community will have had a stable interpreter
+for ~2 months before attempting to update the package set. And this will
+allow for ~7 months for Python applications to support the latest interpreter.