2006-12-20 20:43:05 +00:00
|
|
|
How to add a regression test
|
|
|
|
|
----------------------------
|
|
|
|
|
|
|
|
|
|
1. Write a /regress/<testname>.sql file with data and sql queries for testing
|
2008-10-10 01:35:58 +00:00
|
|
|
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
|
2008-10-10 04:39:54 +00:00
|
|
|
|
|
|
|
|
cat file.sql | psql -F\| -t -A > file_expected
|
|
|
|
|
|
2006-12-20 20:43:05 +00:00
|
|
|
3. Edit regress/Makefile adding <testname> to the TESTS variable.
|
2008-10-10 01:35:58 +00:00
|
|
|
Any _expected.in files need to be added to the PREPROC variable.
|
2006-12-20 20:43:05 +00:00
|
|
|
|
2011-03-16 13:03:12 +00:00
|
|
|
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
|
|
|
|
|
|
2006-12-20 20:43:05 +00:00
|
|
|
Notes about changes in regression tests introduces with PostGIS 1.1.0
|
|
|
|
|
---------------------------------------------------------------------
|
|
|
|
|
|
2004-11-26 15:52:57 +00:00
|
|
|
- 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]
|
2008-10-10 01:35:58 +00:00
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
