sixer 0.7

Add Python 3 support to Python 2 applications using the six module.

sixer is a tool adding Python 3 support to a Python 2 project.

sixer was written to produces patches to port OpenStack to Python 3.

It uses basic regular expressions to find code which needs to be modified. It emits warnings when code was not patched or looks suspicious.

• sixer project at Github

• sixer in the Python Cheeseshop (PyPI)

Usage

sixer.py <operation> <directories or filenames>

sixer.py displays the name of patched files. It displays warnings for code unchanged but which looks suspicious.

If you pass a directory, sixer.py searchs for .py files in all subdirectories.

<operation> can be a list of operations separated by commas

Warning: sixer.py modifies files inplace without asking for confirmation. It’s better to use it in a project managed by a source control manager (ex: git).

Available operations:

• all

• basestring

• dict0

• dict_add

• except

• iteritems

• iterkeys

• itertools

• itervalues

• long

• next

• raise

• six_moves

• stringio

• unicode

• urllib

• xrange

Installation

To install sixer, type:

pip3 install sixer

sixer requires Python 3, it doesn’t work on Python 2.

Operations

• all:

  • combine all operations all together

• basestring:

  • replace basestring with six.string_types

• dict0:

  • replace dict.keys()[0] with list(dict.keys())[0]

  • same for dict.values()[0] and dict.items()[0]

• dict_add:

  • replace dict.keys() + list2 with list(dict.keys()) + list2

  • same for dict.values() + list2 and dict.items() + list2

• except:

  • Replace except ValueError, exc: with except ValueError as exc:

  • Replace except (TypeError, ValueError), exc: with except (TypeError, ValueError) as exc:

• iteritems:

  • replace dict.iteritems() with six.iteritems(dict)

• itervalues:

  • replace dict.itervalues() with six.itervalues(dict)

• iterkeys:

  • replace dict.iterkeys() with six.iterkeys(dict)

  • note: for key in dict.iterkeys(): can usually be simplified to for key in dict:

• itertools:

  • replace itertools.ifilter with six.moves.filter

  • replace itertools.imap with six.moves.map

• long:

  • replace 123L with 123

  • octal number are unchanged (ex: 010L)

• next:

  • replace iter.next() with next(iter)

• raise:

  • replace raise exc[0], exc[1], exc[2] with six.reraise(*exc)

  • replace raise exc_type, exc_value, exc_tb with six.reraise(exc_type, exc_value, exc_tb)

  • replace raise exc, msg with raise exc(msg)

• six_moves:

  • replace Python 2 imports with imports from six.moves

  • Python 2 modules:

    • BaseHTTPServer

    • ConfigParser

    • Cookie

    • HTMLParser

    • Queue

    • SimpleHTTPServer

    • SimpleXMLRPCServer

    • __builtin__

    • cPickle

    • cookielib

    • htmlentitydefs

    • httplib

    • repr

    • xmlrpclib

• urllib:

  • replace Python 2 urllib and urllib2 with six.moves.urllib

• stringio:

  • replace StringIO.StringIO with six.StringIO

  • replace cStringIO.StringIO with moves.cStringIO

  • replace from StringIO import StringIO with from six import StringIO

  • replace from cStringIO import StringIO with from six.moves import cStringIO as StringIO

  • later you may have to replace it with six.BytesIO (or io.BytesIO if you don’t support Python 2.6) when bytes are expected on Python 3

• unicode:

  • replace unicode with six.text_type

• xrange:

  • replace xrange() with range() and add from six.moves import range

  • don’t add the import if all ranges have 1024 items or less

Adding the six import

When an operation uses six, import six may be added. sixer repects OpenStack coding style rules to add the import: imports grouped by standard library, third party and local imports; and imports must be are sorted.

The sixer tool was initially written to produce patches for OpenStack which respects OpenStack coding style, especially the complex rule to group and sort imports.

Limitations

The project is based on regular expressions, it produces false positives (invalid changes). For example, some operations replace patterns in strings, comments or function names even if it doesn’t make sense.

Try also the 2to6 project which may be more reliable.

Tests

To run tests, type tox. Type pip install tox to install the tox program.

Or run tests manually: type python3 tests.py.

Changelog

• Version 0.7 (2015-09-29)

• Add new dict0, dict_add and except operations

• Add –app command line option to specify the Python module of the application, to help sorting imports

• Code adding new imports respect better OpenStack coding style on imports. For example, it adds two empty lines after imports, instead of a single line.

• Display the name of the operation which modified files

• Display also the name of the operation in warnings

• six_moves now also patches reduce() and reload(). For example, reduce() is replaced with six.moves.reduce().

• six_moves now also patches mock.patch(). For example, with mock.patch('__builtin__.open'): ... is replaced with with mock.patch('six.moves.builtin.open'): ...

• urllib now also replaces from ... import ... imports. For example, from urllib import quote is replaced with from six.moves.urllib.parse import quote.

• Version 0.6 (2015-09-11)

• Add “itertools” operation

• Fix xrange() regex to not modify “from six.moves import xrange” and “moves.xrange(n)”

• Fix urllib for urllib or urlparse module get from the urllib2 module. For example, urllib2.urlparse.urlparse (import urllib2) is now replaced with urllib.parse.urlparse (from six.moves import urllib).

• Version 0.5 (2015-07-08)

  • six_moves: support “import module as name” syntax and add cPickle module

  • Add –to-stdout, –quiet and –max-range command line options

  • Emit a warning if the directory does not contain any .py file or if the path does not exist

  • Test also directly the sixer.py program

• Version 0.4 (2015-06-09)

  • sixer.py now accepts multiple filenames on the command line, but operations becomes the first command line parameter

  • the stringio operation now also replaces cStringIO and from StringIO import StringIO

  • urllib: replace also urlparse.symbol

  • six_moves: support more modules: Cookie, HTMLParser, SimpleHTTPServer, cookielib, xmlrpclib, etc.

  • Refactor operations as classes to cleanup the code

• Version 0.3.1 (2015-05-27)

  • Fix the “all” operation

  • six_moves knows more modules

  • urllib: add pathname2url, don’t touch urllib2.parse_http_list()

• Version 0.3 (2015-05-27)

  • First command line parameter can now be a filename

  • Add “all”, “basestring”, “iterkeys”, “six_moves”, “stringio” and “urllib” operations

  • Enhance the knownledge tables for modules (stdlib, third parties, applications)

  • Ignore unparsable import lines when adding an import

• Version 0.2 (2015-05-12):

  • First public release

See also

• Six documentation

• 2to6

• Python 3 porting book: Language differences and workarounds

• getpython3