GEPS 031: Python 3 support - Revision history

Patsyblefebre: /* Related Gramps Bugs */ GEPS_032:_Python_3_support/Python_3_Deprecated

2013-02-06T02:39:07Z

‎Related Gramps Bugs: GEPS_032:_Python_3_support/Python_3_Deprecated

Bmcage at 08:44, 17 November 2012

2012-11-17T08:44:06Z

Bmcage: /* Ubuntu 12.10 */

2012-11-14T23:16:08Z

‎Ubuntu 12.10

Bmcage at 18:18, 7 November 2012

2012-11-07T18:18:31Z

Bmcage: Created page with "Gramps was written with python 2. Slowly the default python is becoming python 3. Gramps 4.0 will require python 2.7+. Ideally we also support python 3. Then in 2014-15 we can..."

2012-11-07T15:53:19Z

Created page with "Gramps was written with python 2. Slowly the default python is becoming python 3. Gramps 4.0 will require python 2.7+. Ideally we also support python 3. Then in 2014-15 we can..."

New page

Gramps was written with python 2. Slowly the default python is becoming python 3. Gramps 4.0 will require python 2.7+. Ideally we also support python 3. Then in 2014-15 we can drop python 2.7 support. For convenience, we aim for python 3.2+

== Guideline ==
No python 2.7 only constructs should be present, and no python 3.2 only constructs should be present.

== How? ==

See patchset in [http://www.gramps-project.org/bugs/view.php?id=2620].

Main attention points:

* we should not use unicode anymore. Instead, import from ''gramps.gen.constfunc'' the cuni or friends functions to convert to unicode
* we should not compare to basestring or unicode type. Instead use UNITYPE and STRTYPE from ''gramps.gen.constfunc''
* in python 3 many functions became iterators. Remove the old 2.7 names and replace with the 3.2 names as much as possible. Only when performance is really an issue, use an if construct on python version so that python 2.7 also uses an iterator.
* you will see a lot of list(map ...) or list(range...) after conversion. Only remove this if you studied the code and know it will work in python 2 and 3
* If special unicode symbols are needed, then use ''from __future__ import unicode_literals'' '''and''' ''# -*- coding: utf-8 -*-'' and adapt the 2.7 code to have it working with this.
* to test on python version, use ''if sys.version_info[0] < 3:'' for consistency with the other patches.

== Related Gramps Bugs ==
* #{{bug|2620}}: GEPS 031: Python 3 support - 3.2

See also [[Python 3 Deprecated]]
[[Category:GEPS|P]]

← Older revision		Revision as of 08:44, 17 November 2012
Line 9:		Line 9:

	So, once you open a family tree with python3, you will not be allowed to open it with python 2.7. The only way to open it with python 2.7 is using the bsddb3 option of Gramps, and installing from source the bsddb3 package for python 2.7 that is as current as the one given in python3		So, once you open a family tree with python3, you will not be allowed to open it with python 2.7. The only way to open it with python 2.7 is using the bsddb3 option of Gramps, and installing from source the bsddb3 package for python 2.7 that is as current as the one given in python3
		+
		+	== Tips ==
		+	# If you work with python3, edit the ~/.subversion/config files, and add the section
		+	global-ignores = __pycache__
		+	# Give a family tree a name that contains 32 if you use python 3, and 27 if you use python 2. Once you open a python 2 family tree, the database is upgrade and you canot open it again in python 2 (you could export to xml and import in python 2 though)

	== How? ==		== How? ==

@@ Line 27: / Line 27: @@
 Python 3.2.3 ships with Ubuntu 12.10. To run Gramps, you will also need the packages:
 # python3-gi: gobject introspection
 # python3-cairo : This is needed to have ''import cairo'' work
 # python3-bsddb3: This is needed to have ''import bsddb3'' work

@@ Line 39: / Line 39: @@
 * #{{bug|2620}}: GEPS 031: Python 3 support - 3.2
-See also [[Python 3 Deprecated]]
+See also [[GEPS_032:_Python_3_support/Python_3_Deprecated|Python 3 Deprecated]]
 [[Category:GEPS|P]]

@@ Line 4: / Line 4: @@
 == Guideline ==
 No python 2.7 only constructs should be present, and no python 3.2 only constructs should be present.
 == How? ==
@@ Line 18: / Line 23: @@
 * to test on python version, use ''if sys.version_info[0] < 3:'' for consistency with the other patches.
 == Related Gramps Bugs ==