Python 2to3

From Sugar Labs
Jump to navigation Jump to search

Project Introduction

Sugar currently uses Python 2. Since support for python 2 is being drawn, we are porting our code to Python 3.

It is one of the goals for Sugar Labs for 2018, with a suggested timeframe of ~12-16 months for completing the project.

The project was taken up by Sugar Labs in Google Summer of Code 2018

Project Summary

The project progress can be tracked here.

Sugar
Target: Port entirely to Python 3
WIP: https://github.com/Pro-Panda/sugar/tree/python3
Status: While some critical issues still persist, most of the functionality is running and tested.
Sugar-Toolkit-Gtk3
Target: Should be compatible with both Python 2 and Python 3, to support the large number of activities currently in Python 2
WIP: https://github.com/Pro-Panda/sugar-toolkit-gtk3/tree/python3-port
Status: Mostly Complete; what remains is an entire project in itself of porting the Telepathy Bindings.
Critical changes implelmented:
  • Python 3 activities must be instantiated with sugar-activity3 instead of sugar-activity
  • sugar-activity-web will call the Python 3 version of the toolkit and will be installed only with the same
  • warning logged if activity is not ported to Python 3

Note: To test the toolkit without porting the telepathy bindings, please use the Python 3 bindings (not for release), https://github.com/pro-panda/telepathy3


Sugar-Datastore
Target: Port entirely to Python 3
WIP: https://github.com/Pro-Panda/sugar-datastore/tree/python3-port
Status: Complete(possible fix patches do come up while porting sugar); Fedora packaging and testing remains
Sugar-Artwork
Target: Port entirely to Python 3 (use system empy bindings for Python 3)
WIP: https://github.com/Pro-Panda/sugar-artwork/tree/python3-port
Status: Complete; Fedora packaging and testing remains
Sugar Desktop Activities
Guide to porting activities to Python 3 is here
Activity Status [WIP/Ported] Pull Request
Log Ported PR link
JukeBox Ported PR link
Abacus Ported PR link
Calculate Ported PR link
Chat Ported PR link
CowBulls Ported PR link
Finance Ported PR link
Hello-world Ported PR link
Imageviewer Ported PR link
Read Ported PR link
Spirolaterals Ported PR link
Terminal Ported PR link
Write Ported PR link
Nutrition Ported PR link

Contributing to the Project

There are several ways of contributing to the project

Port Telepathy bindings
Telepathy does not have python 3 bindings and needs to be ported to its PyGObject bindings as a prerequisite for porting to Python 3
See https://github.com/orgs/sugarlabs/projects/4
Test Debian Packages
Debian packages for core modules here: https://github.com/Pro-Panda/sugar-packages
Please install, test and report bugs, (or better, submit fix patches)
Fedora Packaging
Make Fedora packages of core modules (WIP links above) and test them
Port Sugar Desktop Activities to Python 3
See the guide to port activities to Python 3: https://github.com/sugarlabs/sugar-docs/blob/master/src/python-porting-guide.md
Improve test coverage
Sugar and the components lack in testing mechanisms and scripts. Our current test coverage is very basic and minimal. Improving the same is critical and the best time would be to so while Porting and testing the components
Some test scripts are here - https://github.com/Pro-Panda/sugar-python3-tests


Notes

  • httplib.HTTP is not available in Python 3; use http.client.HTTPConnection instead
  • cmp function does not exist in Python 3, use the cmp_to_key function; see https://docs.python.org/3/howto/sorting.html#sortinghowto
  • list.sort function requires named parameters in Python 3
  • hashlib.md5 requires bytes as an argument in Python 3
  • sha_hash.update requires bytes as an argument in Python 3
  • statvfs does not exist in Python 3, verify the Python 2 constant values and use them instead