aboutsummaryrefslogtreecommitdiff
path: root/t/README
diff options
context:
space:
mode:
authorJeff King <peff@peff.net>2014-10-10 02:47:27 -0400
committerJunio C Hamano <gitster@pobox.com>2014-10-13 15:39:57 -0700
commita136f6d8ff290ab486c85cd12d1a9a47d53b432d (patch)
treeec181965b1cd4eb9098ede39b290fd6101e60037 /t/README
parent8ad16524183baf196d1db82b99ef52d05ca438e9 (diff)
downloadgit-a136f6d8ff290ab486c85cd12d1a9a47d53b432d.tar.gz
git-a136f6d8ff290ab486c85cd12d1a9a47d53b432d.tar.xz
test-lib.sh: support -x option for shell-tracing
Usually running a test under "-v" makes it clear which command is failing. However, sometimes it can be useful to also see a complete trace of the shell commands being run in the test. You can do so without any support from the test suite by running "sh -x tXXXX-foo.sh". However, this produces quite a large bit of output, as we see a trace of the entire test suite. This patch instead introduces a "-x" option to the test scripts (i.e., "./tXXXX-foo.sh -x"). When enabled, this turns on "set -x" only for the tests themselves. This can still be a bit verbose, but should keep things to a more manageable level. You can even use "--verbose-only" to see the trace only for a specific test. The implementation is a little invasive. We turn on the "set -x" inside the "eval" of the test code. This lets the eval itself avoid being reported in the trace (which would be long, and redundant with the verbose listing we already showed). And then after the eval runs, we do some trickery with stderr to avoid showing the "set +x" to the user. We also show traces for test_cleanup functions (since they can impact the test outcome, too). However, we do avoid running the noop ":" cleanup (the default if the test does not use test_cleanup at all), as it creates unnecessary noise in the "set -x" output. Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 't/README')
-rw-r--r--t/README6
1 files changed, 6 insertions, 0 deletions
diff --git a/t/README b/t/README
index 52c77ae93..995226129 100644
--- a/t/README
+++ b/t/README
@@ -82,6 +82,12 @@ appropriately before running "make".
numbers matching <pattern>. The number matched against is
simply the running count of the test within the file.
+-x::
+ Turn on shell tracing (i.e., `set -x`) during the tests
+ themselves. Implies `--verbose`. Note that this can cause
+ failures in some tests which redirect and test the
+ output of shell functions. Use with caution.
+
-d::
--debug::
This may help the person who is developing a new test.