================= PYTHON 3 SUPPORT ================= Python 3 support in Mako is provided by the Python 2to3 script. Installing Distribute --------------------- Distribute should be installed with the Python3 installation. The distribute bootloader is included. Running as a user with permission to modify the Python distribution, install Distribute: python3 distribute_setup.py Installing Mako in Python 3 --------------------------------- Once Distribute is installed, Mako can be installed directly. The 2to3 process will kick in which takes several minutes: python3 setup.py install Converting Tests, Examples, Source to Python 3 ---------------------------------------------- To convert all files in the source distribution, run the 2to3 script: 2to3 -w mako test If using 3.1's 2to3 tool, the --no-diffs flag might help with unicode issues: 2to3-3.1 -w --no-diffs mako test The above will rewrite all files in-place in Python 3 format. Running Tests ------------- To run the unit tests, ensure Distribute is installed as above, and also that at least the ./mako/ and ./test/ directories have been converted to Python 3 using the source tool above. A Python 3 version of Nose can be acquired from Bitbucket using Mercurial: hg clone http://bitbucket.org/jpellerin/nose3/ cd nose3 python3 setup.py install The tests can then be run using the "nosetests3" script installed by the above (python3 setup.py test doesn't seem to be working with nose3).