Download the latest itools release from http://www.ikaaro.org/itools. There are available two binary releases for the Windows platform, one for Python 2.4 and another for Python 2.5; and the source release for any other platform.
The itools library requires Python 2.4 or later, though version 2.5 is recommended. It should work on any system able to run the Python interpreter.
Some packages have special requirements:
The image file handler, from itools.handlers, requires the Python Imaging Library1 to do anything useful.
The package itools.pdf requires the command line tool pdftotext to be able to extract the text from a PDF document. The reportlab2 package is needed for the RML3 implementation to work.
The package itools.xml requires some command line tools to extract the text from some file types: xlhtml for Excel files, ppthtml for PowerPoint files, wvText for Word files, and unrtf for RTF files.
The itools library uses the standard Python Distribution Utilities, as do most other Python packages. So to install it just type:
$ tar xzf itools-X.Y.Z.tar.gz
$ cd itools-X.Y.Z
$ python setup.py install
Note that you will need a C compiler to install from the source tarball.
When installing in a Windows system, it is recommended to use one of the two Windows installers available (for Python 2.4 or 2.5). This way you won’t need a C compiler. Just run the right installer, depending on your Python version:
itools-X.Y.Z.win32-py2.4.exe
itools-X.Y.Z.win32-py2.5.exe
At this point it is recommended to verify that itools was properly installed. First you can check the itools version:
$ python
...
>>> import itools
X.Y.Z
>>> print itools.__version__
Then you can run the unit tests to check everything works:
$ cd itools itools-X.Y.Z
$ cd test
$ python test.py
Footnotes