From 824484d2cd22ecf91f51fea44092fdee0186dee9 Mon Sep 17 00:00:00 2001 From: itamarst <> Date: Fri, 11 Sep 2020 18:13:28 +0000 Subject: [PATCH] [Imported from Trac: page Python3, version 17] --- Python3.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/Python3.md b/Python3.md index 4b8b78b..ad759fc 100644 --- a/Python3.md +++ b/Python3.md @@ -17,9 +17,14 @@ We use [tox](https://tox.readthedocs.io/en/latest/) to standardize environments ## How to choose a module to port -TBD, something involving core abstractions first, then dependency graph topological traversal. +* We started by porting `allmydata.util`, since it's necessary for other packages. That's mostly done. +* Itamar is currently porting `allmydata.storage`. -At the moment we're focusing on just porting `allmydata.util`, since it's necessary for other packages. +Some things you can take on: + +* `allmydata.node` is pretty standalone. +* Start the more complex process (see below re spaghetti dependencies) on `allmydata.immutable`. +* Some other standalone module if you can find one. ## The porting process, big picture @@ -40,6 +45,8 @@ Then: ### Porting a specific Python file +**Zeroth**, file a new ticket in milestone "Python 3", assign it to yourself. + **First**, add explicit byte or unicode annotations for strings where needed. **Second**, run `futurize --write --both-stages --all-imports path/to/file.py`.