From Fedora Project Wiki
m (Say 29 in important dates)
(Add note about PEP 552 – Deterministic pycs)
Line 73: Line 73:
  
 
(From [https://www.python.org/dev/peps/pep-0537/#schedule Python 3.7 Release Schedule] and [[Releases/29/Schedule|Fedora 29 Release Schedule]].)
 
(From [https://www.python.org/dev/peps/pep-0537/#schedule Python 3.7 Release Schedule] and [[Releases/29/Schedule|Fedora 29 Release Schedule]].)
 +
 +
=== PEP 552 – Deterministic pycs ===
 +
 +
One change is notable from the packaging viewpoint: [https://www.python.org/dev/peps/pep-0552/ PEP 552] – “Deterministic pycs”. We may decide to use the new <code>UNCHECKED_HASH</code> mode, which would mean that bytecode cache is not validated on import, i.e. changing a RPM-installed <code>*.py</code> file manually will have no effect (unless the corresponding <code>__pycache__/*.pyc</code> is updated or removed).
 +
  
 
== Benefit to Fedora ==
 
== Benefit to Fedora ==
Line 112: Line 117:
  
 
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
All the packages that depends on Python 3 must be rebuilt. User written Python 3 scripts/applications may require a small amount of porting, but mostly Python 3.6 is forward compatible with Python 3.7.
+
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.6 is forward compatible with Python 3.7.
  
 
== How To Test ==
 
== How To Test ==

Revision as of 12:59, 15 March 2018


Python 3.7

Summary

Update the Python 3 stack in Fedora from Python 3.6 to Python 3.7.

Owner

  • Email: python-maint@redhat.com
  • Release notes owner:

Current status

  • Targeted release: Fedora 29
  • Last updated: 2018-03-15
  • Tracker bug: <will be assigned by the Wrangler>

Detailed Description

Python 3.7 adds numerous features and optimizations. See the upstream notes at Features for 3.7 and What's new in 3.7.

Important dates

  • 2018-05-21 Python 3.7.0 candidate 1
  • 2018-06-04 Python 3.7.0 candidate 2 (if necessary)
  • 2018-06-15 Python 3.7.0 final
  • 2018-07-11 Fedora 29 Mass Rebuild
  • 2018-08-14 Fedora 29 Change Checkpoint: Completion deadline (testable)

(From Python 3.7 Release Schedule and Fedora 29 Release Schedule.)

PEP 552 – Deterministic pycs

One change is notable from the packaging viewpoint: PEP 552 – “Deterministic pycs”. We may decide to use the new UNCHECKED_HASH mode, which would mean that bytecode cache is not validated on import, i.e. changing a RPM-installed *.py file manually will have no effect (unless the corresponding __pycache__/*.pyc is updated or removed).


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.7.

Scope

We will coordinate the work in a side tag and merge when ready.

  • Other developers: Maintainers of packages that fail to rebuild during the mass rebuild will be asked, using bugzilla, to fix or remove their packages from the distribution. If any issues appear, they should be solvable either by communicating with upstreams first and/or applying downstream patches. Also the package maintainers should have a look at: Porting to Python 3.7. And python-maint team will be available to help with fixing issues.
  • Fedora QA: Based on some troubles with the change to 3.6, we'd like to have an ack from QA before we merge the side tag.
  • Release engineering: #7390 A targeted rebuild for all python packages will be required, before the mass rebuild.
  • Policies and guidelines: nope
  • Trademark approval: nope

Upgrade/compatibility impact

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.6 is forward compatible with Python 3.7.

How To Test

Interested testers do not need special hardware. If you have a favorite Python 3 script, module, or application, please test it with Python 3.7 and verify that it still works as you expect. You can test it using Package-x-generic-16.pngpython37 even before this change is implemented, in Fedora 27 or 28.

Once the change is in place, test if you favorite Python apps are working as they were before. File bugzillas if they don't.

User Experience

Regular distro users shouldn't notice any change in system behavior other than the Python 3 interpreter will be in version 3.7.

Dependencies

~2300 packages depends on Package-x-generic-16.pngpython3. See scope section.

Contingency Plan

  • 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.6 version (never needed before)
  • Contingency deadline: TBD
  • Blocks release? No
  • Blocks product? No

Documentation

Python 3.7 Release Schedule

Features for 3.7

What's new in 3.7

Porting to Python 3.7

Release Notes