summaryrefslogtreecommitdiff
path: root/t
diff options
context:
space:
mode:
authorLibravatar Junio C Hamano <gitster@pobox.com>2015-11-03 15:13:05 -0800
committerLibravatar Junio C Hamano <gitster@pobox.com>2015-11-03 15:13:05 -0800
commit4b571eb0c2149a3a45d7fe8bf2e93e67eab4a4c9 (patch)
tree71ba036af639a33c0c3da5cfc975ae4bd1a10034 /t
parentMerge branch 'jk/initialization-fix-to-add-submodule-odb' (diff)
parenttest: facilitate debugging Git executables in tests with gdb (diff)
downloadtgif-4b571eb0c2149a3a45d7fe8bf2e93e67eab4a4c9.tar.xz
Merge branch 'js/git-gdb'
Allow easier debugging of a single "git" invocation in our test scripts. * js/git-gdb: test: facilitate debugging Git executables in tests with gdb
Diffstat (limited to 't')
-rw-r--r--t/README5
-rw-r--r--t/test-lib-functions.sh8
2 files changed, 13 insertions, 0 deletions
diff --git a/t/README b/t/README
index 35438bca48..1dc908e43a 100644
--- a/t/README
+++ b/t/README
@@ -563,6 +563,11 @@ library for your script to use.
argument. This is primarily meant for use during the
development of a new test script.
+ - debug <git-command>
+
+ Run a git command inside a debugger. This is primarily meant for
+ use when debugging a failing test script.
+
- test_done
Your test script must have test_done at the end. Its purpose
diff --git a/t/test-lib-functions.sh b/t/test-lib-functions.sh
index 6dffb8bcde..73e37a1f6c 100644
--- a/t/test-lib-functions.sh
+++ b/t/test-lib-functions.sh
@@ -145,6 +145,14 @@ test_pause () {
fi
}
+# Wrap git in gdb. Adding this to a command can make it easier to
+# understand what is going on in a failing test.
+#
+# Example: "debug git checkout master".
+debug () {
+ GIT_TEST_GDB=1 "$@"
+}
+
# Call test_commit with the arguments "<message> [<file> [<contents> [<tag>]]]"
#
# This will commit a file with the given contents and the given commit