Update the Python stack in Fedora from Python 3.10 to Python 3.11, the newest major release of the Python programming language.
- Targeted release: Fedora Linux 37
- Last updated: 2021-10-20
- FESCo issue: #2677
- Tracker bug: #2016048
- Release notes tracker: #746
We would like to upgrade Python to 3.11 in Fedora 37 thus we are proposing this plan early.
Important dates and plan
- 2021-05-03: Python 3.11 development begins
- 2021-10-04: Python 3.11.0 alpha 1
- 2021-11-02: Python 3.11.0 alpha 2
- 2021-12-06: Python 3.11.0 alpha 3
- 2022-01-03: Python 3.11.0 alpha 4
- 2022-02-02: Python 3.11.0 alpha 5
- [2022-02-09]: Branch Fedora 36, Rawhide becomes future Fedora 37
- The earliest point when we can start rebuilding in Koji side-tag
- 2022-02-28: Python 3.11.0 alpha 6
- 2022-04-05: Python 3.11.0 alpha 7
- 2022-05-06: Python 3.11.0 beta 1
- No new features beyond this point
- 2022-05-30: Python 3.11.0 beta 2
- The ideal point when we can start rebuilding in Koji
- 2022-06-06: Expected side tag-merge (optimistic)
- 2022-06-16: Python 3.11.0 beta 3
- 2022-06-24: Expected side tag-merge (realistic)
- 2022-07-09: Python 3.11.0 beta 4
- 2022-07-18: Expected side tag-merge (pessimistic)
- [2022-07-21]: Fedora 37 Mass Rebuild
- The mass rebuild happens with the fourth beta. We might need to rebuild Python packages later in exceptional case.
- If the Koji side-tag is not merged yet at this point, we defer the change to Fedora 38.
- 2022-08-01: Python 3.11.0 candidate 1
- This serves as "final" for our purposes.
- [2022-08-10]: Branch Fedora 37, Rawhide becomes future Fedora 38
- [2022-08-10]: Fedora 37 Change Checkpoint: Completion deadline (testable)
- [2022-08-24]: Fedora Beta Freeze
- If rebuild with 3.11.0rc1 is needed, we should strive to do it before the freeze - there is a window of 3 weeks.
- 2022-09-05: Python 3.11.0 candidate 2
- [2022-09-19]: Fedora 37 Beta Release (Preferred Target)
- Beta will likely be released with 3.11.0rc2.
- [2022-09-21]: Fedora 37 Beta Target date #1
- 2022-10-03: Python 3.11.0 final
- [2022-10-05]: Fedora 37 Final Freeze
- We'll update to 3.11.0 final using a freeze exception.
- [2022-10-19]: Fedora 37 Preferred Final Target date
- [2022-10-26]: Fedora 37 Final Target date #1
The schedule might appear somewhat tight for Fedora 37, but Python's annual release cycle was adapted for Fedora and this worked fine since Python 3.9 and Fedora 33. It is now common that Python is upgraded on a similar schedule in every odd-numbered Fedora release.
Note that upstream's "release candidates" are frozen except for blocker bugs. Since we can and will backport blocker fixes between Fedora and upstream, we essentially treat the Release Candidate as the final release.
Notes from the previous upgrade
There are notes from the previous upgrade available, so this upgrade may go smoother: SIGs/Python/UpgradingPython
Benefit to Fedora
Fedora aims to showcase the latest in free and open-source software - we should have the most recent release of Python 3. Packages in Fedora can use the new features from 3.11.
There's also a benefit to the larger Python ecosystem: by building Fedora's packages against 3.11 while it's still in development, we can catch critical bugs before the final 3.11.0 release.
We will coordinate the work in a side tag and merge when ready.
- Proposal owners:
- Other developers: Maintainers of packages that fail to rebuild during the rebuilds will be asked, using e-mail and bugzilla, to fix or remove their packages from the distribution. If any issues appear, they should be solvable either by communicating with the respective upstreams first and/or applying downstream patches. Also, the package maintainers should have a look at: Porting to Python 3.11. The python-maint team will be available to help with fixing issues.
- Release engineering: #10321 A targeted rebuild for all python packages will be required, before the mass rebuild.
- List of deliverables: nope
- Policies and guidelines: nope
- Trademark approval: nope
All the packages that depend on Python 3 must be rebuilt. User written Python 3 scripts/applications may require a small amount of porting, but mostly Python 3.10 is forward compatible with Python 3.11.
How To Test
Interested testers do not need special hardware. If you have a favourite Python 3 script, module, or application, please test it with Python 3.11 and verify that it still works as you would expect. If the application you are testing does not require any other modules, you can test it using
even before this change is implemented, in Fedora 34, 35 or 36.
In case your application requires other modules, or if you are testing an rpm package, it is necessary to install the 3.11 version of the python3 rpm. Right now that rpm is available in copr, along with all other python packages that build successfully with python 3.11. See https://copr.fedorainfracloud.org/coprs/g/python/python3.11/ for detailed instructions on how to enable Python 3.11 copr for mock.
Once the change is in place, test if your favourite Python apps are working as they were before. File bugs if they don't.
Regular distro users shouldn't notice any change in system behaviour other than the Python 3 interpreter will be in version 3.11.
4000+ packages depend on Python 3 and ~3800 packages need rebuilding when Python is upgraded. See scope section.
- Contingency mechanism: Do not merge the side tag with rawhide. If the side tag has been merged and issues arise, that will justify a downgrade, then use an epoch tag to revert to 3.10 version (never needed before)
- Contingency deadline: TBD
- Blocks release? Yes, we'd like to block Fedora 37 release on at least 3.11.0rc1
- Blocks product? See above
- Migrating user installed packages - https://pagure.io/fedora-docs/release-notes/issue/503