Contents of /branches/WIP-pyshapelib-bramz/test/README

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$
$Source$
$Id$
1	This directory contains the Thuban test suite.
2
3	To run all tests run runtests.py:
4
5	$ python runtests.py
6
7	To run individual tests, run one of the test_*.py scripts, e.g.:
8
9	$ python test_table.py -v
10
11
12	The tests use the unittest module of the python standard library.
13
14	Some of the tests expect the iceland sample data to be present in
15	../Data and so may fail if you are working from a source archive
16	unless you also add the data.
17
18	Test for optional features should be automatically skipped when run on
19	an installation where the feature is not available or the test can't be
20	run for some other reason as may be the case with the postgis interface
21	tests (see below). Skipped tests are marked with an S in the default
22	brief output and are listed after all test have been run.
23
24	The PostGIS tests require a PostGIS installation on the machine where
25	the tests are run even though Thuban can use PostGIS database as long as
26	psycopg is installed. The test will create their own database cluster in
27	temp/postgis and start their own postmaster process, so the only
28	requirement is that the software is installed and the various postgresql
29	command line programs are on the PATH because they're executed as
30	subprocesses to build the database cluster, start the postmaster, etc.
31
32	E.g. Debian 4.0 (Etch) can have several PostGIS installations
33	in parallel. So you can give the PATH to the one you want to test
34	on the command line:
35
36	$ PATH=$PATH:/usr/lib/postgresql/8.1/bin/ python runtests.py
37
38
39	$Revision$
40	$Source$
41	$Id$
Name	Value
svn:eol-style	native
svn:keywords	Author Date Id Revision