(Rename) |
(Rephrase summary) |
||
Line 19: | Line 19: | ||
<!-- The actual name of your proposed change page should look something like: Changes/Your_Change_Proposal_Name. This keeps all change proposals in the same namespace --> | <!-- The actual name of your proposed change page should look something like: Changes/Your_Change_Proposal_Name. This keeps all change proposals in the same namespace --> | ||
= | = Use explicit version of Python 2/3 throughout Fedora= | ||
== Summary == | == Summary == | ||
With Python 2 approaching it's EOL, we are trying to prepare Fedora for a transition to Python 3 | With Python 2 approaching it's EOL, we are trying to prepare Fedora for a transition to Python 3 and thus make <code>python</code> without a version number mean Python 3. This Fedora change is to track the progress of the [[FinalizingFedoraSwitchtoPython3#Phase_1:_Eliminate_the_python-_prefix_from_the_Python_2_package_names_and_.2Fusr.2Fbin.2Fpython_from_shebangs|Phase 1]] in the [[FinalizingFedoraSwitchtoPython3|Finalizing Fedora's Switch to Python 3]] transition plan. | ||
== Owner == | == Owner == |
Revision as of 15:57, 2 January 2018
Use explicit version of Python 2/3 throughout Fedora
Summary
With Python 2 approaching it's EOL, we are trying to prepare Fedora for a transition to Python 3 and thus make python
without a version number mean Python 3. This Fedora change is to track the progress of the Phase 1 in the Finalizing Fedora's Switch to Python 3 transition plan.
Owner
- Name: Iryna Shcherbina
- Email: ishcherb@redhat.com
- Release notes owner:
Current status
- Targeted release: Fedora 28
- Last updated: 2018-01-02
- Tracker bug: <will be assigned by the Wrangler>
Detailed Description
Finalizing Fedora's Switch to Python 3 document provides detailed information on the matter. This Fedora change covers only Phase 1 of the transition steps, and aims to clean up Fedora packages in accordance with the recent changes to Python packaging guidelines regarding the usage of python
without a version number in package names, requirements, shebangs, etc. The clean up involves:
- Renaming Python 2 binary RPMs from
python-foo
topython2-foo
This is already partially done by applying automated patches as announced in Mass package change (python2- binary package renaming). The packages which still need to be fixed are tracked in PortingDB.
- Fixing ambiguous Python 2 dependency declarations, i.e using
python2-foo
instead ofpython-foo
in requirements
We have started opening automatic Pull Requests with patches as announced in Mass Pull Request filing for ambiguous Python 2 requirements. The packages which will be targeted are tracked in PortingDB.
- Ensuring that
/usr/bin/python
or/usr/bin/env python
shebangs are replaced with either/usr/bin/python2
or/usr/bin/python3
Each of the above conforms to the Python packaging guidelines and was approved by FPC. The work on the change is already in progress and will be tracked by this Fedora change.
Benefit to Fedora
See Benefit to Fedora section in the Finalizing Fedora's Switch to Python 3 document.
Scope
- Proposal owners:
Proposal owners are to communicate the idea to the packagers and fix all affected packages via Mass_package_changes procedure.
- Other developers:
Package maintainers will be asked to review Pagure PRs.
- Release engineering: #Releng issue number (a check of an impact with Release Engineering is needed)
- List of deliverables: N/A (not a System Wide Change)
- Policies and guidelines:
- Using python2/python3 instead of python in binary RPM package name guidelines, fpc
- Using python2/python3 instead of python in (Build)Requires, guidelines, fpc
- Using
/usr/bin/python2
instead of/usr/bin/python
in shebangs and Requires, guidelines, fpc
How To Test
See How To Test section in the Finalizing Fedora's Switch to Python 3 document.
Dependencies
TBD
Contingency Plan
- Contingency mechanism: (What to do? Who will do it?) In case the change is not completed in time, it will be moved to the next Fedora release.
- Contingency deadline: beta freeze
- Blocks release? No
- Blocks product? No
Documentation
- FinalizingFedoraSwitchtoPython3
- Discussion on Fedora devel mailing list
- Mass package change (python2- binary package renaming), part 1
- MASS CHANGE announcement: python2- prefix renaming, part 2
- Mass Pull Request filing for ambiguous Python 2 requirements.
Release Notes
TBD