1.1 Download and Install

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.

1.1.1 Requirements

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:

1.1.2 Install from Source

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.

1.1.3 Install for Windows

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

1.1.4 Check

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

  1. http://www.pythonware.com/products/pil/
  2. http://www.reportlab.org
  3. Reportlab Markup Language.