summaryrefslogtreecommitdiff
path: root/src/test/perl
diff options
context:
space:
mode:
authorPeter Eisentraut2016-11-14 17:00:00 +0000
committerPeter Eisentraut2016-11-14 15:00:41 +0000
commit9ca7b0bf016364c74d38f66c7050be915bfea908 (patch)
tree12354599e1c255e1d8fee369a1c4f301792c7b70 /src/test/perl
parent8ce4f597abc530b3b59bcf3a3964f31e50054bcd (diff)
Allow individual TAP tests to be run via PROVE_TESTS
Add a new optional Makefile variable PROVE_TESTS that, if passed as a space-separated list of paths relative to the Makefile invoking $(prove_check) or $(prove_installcheck), runs just those tests instead of t/*.pl . From: Craig Ringer <craig@2ndquadrant.com> Reviewed-by: Michael Paquier <michael.paquier@gmail.com>
Diffstat (limited to 'src/test/perl')
-rw-r--r--src/test/perl/README6
1 files changed, 6 insertions, 0 deletions
diff --git a/src/test/perl/README b/src/test/perl/README
index 710a0d8bc3..cfb45a1547 100644
--- a/src/test/perl/README
+++ b/src/test/perl/README
@@ -6,6 +6,12 @@ across the source tree, particularly tests in src/bin and src/test. It's used
to drive tests for backup and restore, replication, etc - anything that can't
really be expressed using pg_regress or the isolation test framework.
+The tests are invoked via perl's 'prove' command, wrapped in PostgreSQL
+makefiles to handle instance setup etc. See the $(prove_check) and
+$(prove_installcheck) targets in Makefile.global. By default every test in the
+t/ subdirectory is run. Individual test(s) can be run instead by passing
+something like PROVE_TESTS="t/001_testname.pl t/002_othertestname.pl" to make.
+
You should prefer to write tests using pg_regress in src/test/regress, or
isolation tester specs in src/test/isolation, if possible. If not, check to
see if your new tests make sense under an existing tree in src/test, like