This directory contains the Thuban test suite.

To run all tests run runtests.py:

   $ python runtests.py

To run individual tests, run one of the test_*.py scripts, e.g.:

   $ python test_table.py -v


The tests use the unittest module of the python standard library.

Some of the tests expect the iceland sample data to be present in
../Data and so may fail if you are working from a source archive
unless you also add the data.

Test for optional features should be automatically skipped when run on
an installation where the feature is not available or the test can't be
run for some other reason as may be the case with the postgis interface
tests (see below). Skipped tests are marked with an S in the default
brief output and are listed after all test have been run.

The PostGIS tests require a PostGIS installation on the machine where
the tests are run even though Thuban can use PostGIS database as long as
psycopg is installed. The test will create their own database cluster in
temp/postgis and start their own postmaster process, so the only
requirement is that the software is installed and the various postgresql
command line programs are on the PATH because they're executed as
subprocesses to build the database cluster, start the postmaster, etc.

E.g. Debian 4.0 (Etch) can have several PostGIS installations
in parallel. So you can give the PATH to the one you want to test
on the command line:

    $ PATH=$PATH:/usr/lib/postgresql/8.1/bin/ python runtests.py


$Revision: 2723 $
$Source$
$Id: README 2723 2007-02-20 10:22:54Z bernhard $
