Edgewall Software

Version 25 (modified by Chui Tey, 17 years ago) ( diff )

Trac with Python 2.5

Warning: the following imply that you'll use 0.11dev a.k.a trunk. It worksforme, but YMMV as one can say in this situation ;)

TracOnWindows/Rewrite focuses on installing 0.10 with Python 2.4, as this is currently the version for which all the required dependencies for 0.10 are easily available.

Using 0.10 with Python 2.5 should theoretically work if you manage to build ClearSilver for that version. This is quite problematic on Windows, and as this happens to be the case also for Unix, this page should probably be renamed simply TracForPython2.5

Fortunately, there's another option. For 0.11, we switched to another templating engine, namely Genshi, from fellow Trac developer Christopher Lenz.

If furthermore you don't need to interface with Subversion, then all you need besides Python 2.5 are a few Python packages. As some packages require the latest development version of the software, you'll nevertheless need a svn client to checkout the software from their repositories.

Installing Python 2.5 on Windows

Simply download and install the appropriate .msi for your Python platform:

Installing Genshi

Download the zip package:

Unzip to a folder and then from that folder run python setup.py install in a command window. (Make sure you have added the Python install path (e.g. C:\Program Files\Python25) to your system PATH variable. You can do this by right clicking on My Computer, clicking on Properties, selecting the Advanced tab, clicking the Environment Variables button, scrolling down the second list window until you see the 'Path' variable, then editing the string to add the Python install path. Then start command line for Genshi installation.)

Installing Trac

You simply need the latest trunk (0.11dev) - to get this type the following in the command window. (Make sure you have added the Python install path (e.g. C:\Program Files\Python25) to your system PATH variable. You can do this by right clicking on My Computer, clicking on Properties, selecting the Advanced tab, clicking the Environment Variables button, scrolling down the second list window until you see the 'Path' variable, then editing the string to add the Python install path). Make sure you have setuptools installed before proceed.

> cd C:\src
> svn checkout http://svn.edgewall.org/repos/trac/trunk
> cd trunk
> python setup.py install

Then, have a look at how to setup the TracEnvironment, use the TracStandalone web front-end and you're set.

More specifically, do this to get 0.11 with webadmin up and running:

Create an administrator user (uses a script described elsewhere in the wiki)
python trac-digest.py -u adm -p adm >> c:\digest.txt

Give that user all permissions
trac-admin c:\myproj permission add adm TRAC_ADMIN

Now…
tracd -p 8000 —auth=myproj,c:\digest.txt,trac c:\myproj

And you'll be able to see the Admin tab if you log in with 'adm'

Installing mod_python for use with the Apache HTTP server

If you are using an Apache server, you will need the latest mod_python for windows, built against Python v2.5. Currently version 3.3.1 is available at the Apache website (click on "Other Files" and surf to modpython/win/3.3.1/). However, you can also get other versions here, courtesy of a very kind and wise gentleman called Nicolas Lehuen.

Installing plugins

There's no need to install the WebAdmin plugin, as it has now been integrated in Trac proper. Quite to the contrary, you should remove it if you're upgrading.

See TracPlugins for details about plugin installation.

There are a some plugins that have been made compatible with 0.11dev:

You can grab them directly from the repository, and install it the same way you did for Trac:

> cd C:\src
> svn checkout http://svn.edgewall.org/repos/trac/sandbox/spam-filter 
> cd spam-filter
> python setup.py install

Note if you catch an error:"ImportError: No module named setuptools" please download http://peak.telecommunity.com/dist/ez_setup.py and install the setuptools.

If for some reason the above step fails, either because there's no package for the Windows platform you're using or the setuptools don't manage to read information from your svn working copy (if you used Subversion 1.4 for doing the checkout), you'll probably need to install first a recent setuptools package, itself available from http://svn.python.org/projects/sandbox/trunk/setuptools. Version 0.7a1 (r51948) from the repository worked for me.

Caveats

Of course, this is bleeding edge software, so you'll probably discover a few bugs when using Trac in this configuration. You will be more than welcomed to report these bugs, as we're currently actively developing 0.11.

If you're interested to help out, or if you have your own Clearsilver templates to migrate, you'll probably want to have a look at TracDev/ApiChanges/0.11.


See also: TracOnWindows

Note: See TracWiki for help on using the wiki.