674a117ccc
git-svn-id: http://svn.osgeo.org/postgis/trunk@15360 b70326c6-7e19-0410-871a-916f4a2858ee
90 lines
3.0 KiB
Plaintext
90 lines
3.0 KiB
Plaintext
Requirements for run_test.pl
|
|
----------------------------
|
|
|
|
run_test.pl requires the following Perl modules to be installed
|
|
|
|
Text::Diff;
|
|
File::Which;
|
|
File::Basename;
|
|
File::Temp 'tempdir';
|
|
File::Copy;
|
|
File::Path 'make_path';
|
|
File::Path 'remove_tree';
|
|
Cwd 'abs_path';
|
|
Getopt::Long;
|
|
|
|
Most distributions of Perl will have everything except Text::Diff and File::Which.
|
|
To install them from the command-line, as root run
|
|
|
|
cpan Text::Diff
|
|
cpan File::Which
|
|
|
|
|
|
How to add a regression test
|
|
----------------------------
|
|
|
|
1. Write a /regress/<testname>.sql file with data and sql queries for testing
|
|
2. Write a /regress/<testname>_expected or <testname>_expected.in file with
|
|
expected results per query
|
|
The expected results provided in the <testname>_expected file must be
|
|
formatted using the following psql options:
|
|
-a -- unaligned columns
|
|
-f | -- use | (pipe) as the field separator between columns
|
|
-t -- output rows only, ie. no table header
|
|
|
|
cat file.sql | psql -F\| -t -A > file_expected
|
|
|
|
3. Edit regress/Makefile adding <testname> to the TESTS variable.
|
|
Any _expected.in files need to be added to the PREPROC variable.
|
|
|
|
Optional:
|
|
If your test has unusual setup or teardown requirements, you may create
|
|
any of the following optional files (they will run in this order):
|
|
/regress/<testname>-pre.sh
|
|
/regress/<testname>-pre.sql (run via psql)
|
|
(The test itself is run here.)
|
|
/regress/<testname>-post.sql (run via psql)
|
|
/regress/<testname>-post.sh
|
|
|
|
Notes about changes in regression tests introduces with PostGIS 1.1.0
|
|
---------------------------------------------------------------------
|
|
|
|
- Mixed-dimensioned geometries are no longer supported
|
|
(previous behaviour was to fill Z with a 0 value)
|
|
[ updated to use new behaviour ]
|
|
|
|
- geometry_same operator (=~) now requires all dimensions equality
|
|
Previously only x/y were checked
|
|
|
|
- geometry_same operator (=~) now requires geom type equality
|
|
Previous behaviour:
|
|
GEOMETRYCOLLECTION(POINT(0 1), POINT(2 3)) =~ MULTIPOINT(0 1,2 3)
|
|
|
|
- numb_sub_geometries does not exist anymore
|
|
[updated to use numgeometries]
|
|
|
|
- truly_inside does not exist anymore
|
|
[updated to use within]
|
|
|
|
Notes about <testname>_expected.in
|
|
----------------------------------
|
|
|
|
The first line of the <testname>_expected.in should include the postgis
|
|
configuration header.
|
|
|
|
#include "../postgis_config.h"
|
|
|
|
The ability to run a c preprocessor over the expected results prior to
|
|
regression testing was needed for testing curved string functionality that
|
|
would elicit different responses from JTS vs GEOS compilations. Since
|
|
JTS is no longer supported, this may not be required anymore.
|
|
|
|
Notes about running individual regression tests
|
|
-----------------------------------------------
|
|
|
|
The script run_test.pl can be called directly to run individual
|
|
regression tests. Run it without parameters for info about its usage.
|
|
|
|
Note that tests run in a staged install which is created by running
|
|
make staged-install. This step is a part of the complete make check.
|