]>
Commit | Line | Data |
---|---|---|
e1970ce4 JH |
1 | #!/bin/sh |
2 | # | |
3 | # Copyright (c) 2005 Junio C Hamano | |
4 | # | |
64b90323 MS |
5 | # This program is free software: you can redistribute it and/or modify |
6 | # it under the terms of the GNU General Public License as published by | |
7 | # the Free Software Foundation, either version 2 of the License, or | |
8 | # (at your option) any later version. | |
9 | # | |
10 | # This program is distributed in the hope that it will be useful, | |
11 | # but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
13 | # GNU General Public License for more details. | |
14 | # | |
15 | # You should have received a copy of the GNU General Public License | |
16 | # along with this program. If not, see http://www.gnu.org/licenses/ . | |
e1970ce4 | 17 | |
44138559 JS |
18 | # if --tee was passed, write the output not only to the terminal, but |
19 | # additionally to the file test-results/$BASENAME.out, too. | |
20 | case "$GIT_TEST_TEE_STARTED, $* " in | |
21 | done,*) | |
22 | # do not redirect again | |
23 | ;; | |
3da93652 | 24 | *' --tee '*|*' --va'*) |
44138559 JS |
25 | mkdir -p test-results |
26 | BASE=test-results/$(basename "$0" .sh) | |
27 | (GIT_TEST_TEE_STARTED=done ${SHELL-sh} "$0" "$@" 2>&1; | |
28 | echo $? > $BASE.exit) | tee $BASE.out | |
29 | test "$(cat $BASE.exit)" = 0 | |
30 | exit | |
31 | ;; | |
32 | esac | |
33 | ||
c2116a17 JH |
34 | # Keep the original TERM for say_color |
35 | ORIGINAL_TERM=$TERM | |
36 | ||
e1970ce4 JH |
37 | # For repeatability, reset the environment to known value. |
38 | LANG=C | |
899460f3 | 39 | LC_ALL=C |
d9bdd39e | 40 | PAGER=cat |
e1970ce4 | 41 | TZ=UTC |
c2116a17 JH |
42 | TERM=dumb |
43 | export LANG LC_ALL PAGER TERM TZ | |
8ff99e74 | 44 | EDITOR=: |
d33738d7 | 45 | unset VISUAL |
18508c39 | 46 | unset GIT_EDITOR |
e1970ce4 JH |
47 | unset AUTHOR_DATE |
48 | unset AUTHOR_EMAIL | |
49 | unset AUTHOR_NAME | |
50 | unset COMMIT_AUTHOR_EMAIL | |
51 | unset COMMIT_AUTHOR_NAME | |
28a94f88 | 52 | unset EMAIL |
e1970ce4 JH |
53 | unset GIT_ALTERNATE_OBJECT_DIRECTORIES |
54 | unset GIT_AUTHOR_DATE | |
29e55cd5 JH |
55 | GIT_AUTHOR_EMAIL=author@example.com |
56 | GIT_AUTHOR_NAME='A U Thor' | |
6677c466 | 57 | unset GIT_COMMITTER_DATE |
29e55cd5 JH |
58 | GIT_COMMITTER_EMAIL=committer@example.com |
59 | GIT_COMMITTER_NAME='C O Mitter' | |
e1970ce4 JH |
60 | unset GIT_DIFF_OPTS |
61 | unset GIT_DIR | |
892c41b9 | 62 | unset GIT_WORK_TREE |
e1970ce4 JH |
63 | unset GIT_EXTERNAL_DIFF |
64 | unset GIT_INDEX_FILE | |
65 | unset GIT_OBJECT_DIRECTORY | |
0454dd93 | 66 | unset GIT_CEILING_DIRECTORIES |
e1970ce4 JH |
67 | unset SHA1_FILE_DIRECTORIES |
68 | unset SHA1_FILE_DIRECTORY | |
6ceeaee7 | 69 | unset GIT_NOTES_REF |
894a9d33 | 70 | unset GIT_NOTES_DISPLAY_REF |
6956f858 TR |
71 | unset GIT_NOTES_REWRITE_REF |
72 | unset GIT_NOTES_REWRITE_MODE | |
8d0fc48f SP |
73 | GIT_MERGE_VERBOSITY=5 |
74 | export GIT_MERGE_VERBOSITY | |
29e55cd5 JH |
75 | export GIT_AUTHOR_EMAIL GIT_AUTHOR_NAME |
76 | export GIT_COMMITTER_EMAIL GIT_COMMITTER_NAME | |
d33738d7 | 77 | export EDITOR |
e1970ce4 | 78 | |
886a3907 JH |
79 | # Protect ourselves from common misconfiguration to export |
80 | # CDPATH into the environment | |
81 | unset CDPATH | |
82 | ||
5565f47c BW |
83 | unset GREP_OPTIONS |
84 | ||
3d5c0cc9 | 85 | case $(echo $GIT_TRACE |tr "[A-Z]" "[a-z]") in |
6ce4e61f CC |
86 | 1|2|true) |
87 | echo "* warning: Some tests will not work if GIT_TRACE" \ | |
88 | "is set as to trace on STDERR ! *" | |
89 | echo "* warning: Please set GIT_TRACE to something" \ | |
90 | "other than 1, 2 or true ! *" | |
91 | ;; | |
92 | esac | |
93 | ||
cd3c095c JH |
94 | # Convenience |
95 | # | |
96 | # A regexp to match 5 and 40 hexdigits | |
97 | _x05='[0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f]' | |
98 | _x40="$_x05$_x05$_x05$_x05$_x05$_x05$_x05$_x05" | |
99 | ||
e1970ce4 JH |
100 | # Each test should start with something like this, after copyright notices: |
101 | # | |
102 | # test_description='Description of this test... | |
103 | # This test checks if command xyzzy does the right thing... | |
104 | # ' | |
105 | # . ./test-lib.sh | |
c2116a17 JH |
106 | [ "x$ORIGINAL_TERM" != "xdumb" ] && ( |
107 | TERM=$ORIGINAL_TERM && | |
108 | export TERM && | |
109 | [ -t 1 ] && | |
110 | tput bold >/dev/null 2>&1 && | |
111 | tput setaf 1 >/dev/null 2>&1 && | |
112 | tput sgr0 >/dev/null 2>&1 | |
113 | ) && | |
55db1df0 | 114 | color=t |
e1970ce4 | 115 | |
e1970ce4 JH |
116 | while test "$#" -ne 0 |
117 | do | |
118 | case "$1" in | |
119 | -d|--d|--de|--deb|--debu|--debug) | |
120 | debug=t; shift ;; | |
886856ab JH |
121 | -i|--i|--im|--imm|--imme|--immed|--immedi|--immedia|--immediat|--immediate) |
122 | immediate=t; shift ;; | |
5e2c08c6 | 123 | -l|--l|--lo|--lon|--long|--long-|--long-t|--long-te|--long-tes|--long-test|--long-tests) |
91e80b98 | 124 | GIT_TEST_LONG=t; export GIT_TEST_LONG; shift ;; |
e1970ce4 | 125 | -h|--h|--he|--hel|--help) |
570f3226 | 126 | help=t; shift ;; |
e1970ce4 JH |
127 | -v|--v|--ve|--ver|--verb|--verbo|--verbos|--verbose) |
128 | verbose=t; shift ;; | |
1ece1274 | 129 | -q|--q|--qu|--qui|--quie|--quiet) |
092c4334 ÆAB |
130 | # Ignore --quiet under a TAP::Harness. Saying how many tests |
131 | # passed without the ok/not ok details is always an error. | |
132 | test -z "$HARNESS_ACTIVE" && quiet=t; shift ;; | |
e4597aae MO |
133 | --with-dashes) |
134 | with_dashes=t; shift ;; | |
55db1df0 | 135 | --no-color) |
faa4bc35 | 136 | color=; shift ;; |
4e1be63c | 137 | --va|--val|--valg|--valgr|--valgri|--valgrin|--valgrind) |
3da93652 | 138 | valgrind=t; verbose=t; shift ;; |
44138559 JS |
139 | --tee) |
140 | shift ;; # was handled already | |
f423ef5f JK |
141 | --root=*) |
142 | root=$(expr "z$1" : 'z[^=]*=\(.*\)') | |
143 | shift ;; | |
e1970ce4 | 144 | *) |
1f729dca | 145 | echo "error: unknown test option '$1'" >&2; exit 1 ;; |
e1970ce4 JH |
146 | esac |
147 | done | |
148 | ||
55db1df0 PH |
149 | if test -n "$color"; then |
150 | say_color () { | |
c2116a17 JH |
151 | ( |
152 | TERM=$ORIGINAL_TERM | |
153 | export TERM | |
55db1df0 PH |
154 | case "$1" in |
155 | error) tput bold; tput setaf 1;; # bold red | |
156 | skip) tput bold; tput setaf 2;; # bold green | |
157 | pass) tput setaf 2;; # green | |
158 | info) tput setaf 3;; # brown | |
1ece1274 | 159 | *) test -n "$quiet" && return;; |
55db1df0 PH |
160 | esac |
161 | shift | |
5099b99d | 162 | printf "%s" "$*" |
55db1df0 | 163 | tput sgr0 |
b8eecafd | 164 | echo |
c2116a17 | 165 | ) |
55db1df0 PH |
166 | } |
167 | else | |
168 | say_color() { | |
1ece1274 | 169 | test -z "$1" && test -n "$quiet" && return |
55db1df0 | 170 | shift |
5099b99d | 171 | echo "$*" |
55db1df0 PH |
172 | } |
173 | fi | |
174 | ||
175 | error () { | |
176 | say_color error "error: $*" | |
6e7b5aaf | 177 | GIT_EXIT_OK=t |
55db1df0 PH |
178 | exit 1 |
179 | } | |
180 | ||
181 | say () { | |
182 | say_color info "$*" | |
183 | } | |
184 | ||
570f3226 MB |
185 | test "${test_description}" != "" || |
186 | error "Test script did not set test_description." | |
187 | ||
188 | if test "$help" = "t" | |
189 | then | |
190 | echo "$test_description" | |
191 | exit 0 | |
192 | fi | |
193 | ||
4d9d62fa | 194 | exec 5>&1 |
e1970ce4 JH |
195 | if test "$verbose" = "t" |
196 | then | |
197 | exec 4>&2 3>&1 | |
198 | else | |
199 | exec 4>/dev/null 3>/dev/null | |
200 | fi | |
201 | ||
202 | test_failure=0 | |
203 | test_count=0 | |
41ac414e JH |
204 | test_fixed=0 |
205 | test_broken=0 | |
2d84e9fb | 206 | test_success=0 |
e1970ce4 | 207 | |
d998bd4a ÆAB |
208 | test_external_has_tap=0 |
209 | ||
faa4bc35 | 210 | die () { |
6e7b5aaf CB |
211 | code=$? |
212 | if test -n "$GIT_EXIT_OK" | |
213 | then | |
214 | exit $code | |
215 | else | |
216 | echo >&5 "FATAL: Unexpected exit with code $code" | |
217 | exit 1 | |
218 | fi | |
faa4bc35 CB |
219 | } |
220 | ||
6e7b5aaf | 221 | GIT_EXIT_OK= |
35641310 | 222 | trap 'die' EXIT |
41184273 | 223 | |
02b35660 BD |
224 | # The semantics of the editor variables are that of invoking |
225 | # sh -c "$EDITOR \"$@\"" files ... | |
226 | # | |
227 | # If our trash directory contains shell metacharacters, they will be | |
228 | # interpreted if we just set $EDITOR directly, so do a little dance with | |
229 | # environment variables to work around this. | |
230 | # | |
231 | # In particular, quoting isn't enough, as the path may contain the same quote | |
7b7b4516 | 232 | # that we're using. |
02b35660 BD |
233 | test_set_editor () { |
234 | FAKE_EDITOR="$1" | |
235 | export FAKE_EDITOR | |
d33738d7 JN |
236 | EDITOR='"$FAKE_EDITOR"' |
237 | export EDITOR | |
02b35660 BD |
238 | } |
239 | ||
68cfc6f5 MG |
240 | test_decode_color () { |
241 | sed -e 's/.\[1m/<WHITE>/g' \ | |
242 | -e 's/.\[31m/<RED>/g' \ | |
243 | -e 's/.\[32m/<GREEN>/g' \ | |
244 | -e 's/.\[33m/<YELLOW>/g' \ | |
245 | -e 's/.\[34m/<BLUE>/g' \ | |
246 | -e 's/.\[35m/<MAGENTA>/g' \ | |
247 | -e 's/.\[36m/<CYAN>/g' \ | |
248 | -e 's/.\[m/<RESET>/g' | |
249 | } | |
250 | ||
c4f3f551 SB |
251 | q_to_nul () { |
252 | perl -pe 'y/Q/\000/' | |
253 | } | |
254 | ||
255 | q_to_cr () { | |
256 | tr Q '\015' | |
257 | } | |
258 | ||
800f1104 JN |
259 | q_to_tab () { |
260 | tr Q '\011' | |
261 | } | |
262 | ||
c4f3f551 SB |
263 | append_cr () { |
264 | sed -e 's/$/Q/' | tr Q '\015' | |
265 | } | |
266 | ||
267 | remove_cr () { | |
268 | tr '\015' Q | sed -e 's/Q$//' | |
269 | } | |
270 | ||
00648ba0 EN |
271 | # In some bourne shell implementations, the "unset" builtin returns |
272 | # nonzero status when a variable to be unset was not set in the first | |
273 | # place. | |
274 | # | |
275 | # Use sane_unset when that should not be considered an error. | |
276 | ||
277 | sane_unset () { | |
278 | unset "$@" | |
279 | return 0 | |
280 | } | |
281 | ||
04509738 JH |
282 | test_tick () { |
283 | if test -z "${test_tick+set}" | |
284 | then | |
21afc41c | 285 | test_tick=1112911993 |
04509738 JH |
286 | else |
287 | test_tick=$(($test_tick + 60)) | |
288 | fi | |
21afc41c JH |
289 | GIT_COMMITTER_DATE="$test_tick -0700" |
290 | GIT_AUTHOR_DATE="$test_tick -0700" | |
04509738 JH |
291 | export GIT_COMMITTER_DATE GIT_AUTHOR_DATE |
292 | } | |
e1970ce4 | 293 | |
00884968 JS |
294 | # Call test_commit with the arguments "<message> [<file> [<contents>]]" |
295 | # | |
296 | # This will commit a file with the given contents and the given commit | |
297 | # message. It will also add a tag with <message> as name. | |
298 | # | |
299 | # Both <file> and <contents> default to <message>. | |
300 | ||
301 | test_commit () { | |
e656fc97 | 302 | file=${2:-"$1.t"} |
00884968 JS |
303 | echo "${3-$1}" > "$file" && |
304 | git add "$file" && | |
305 | test_tick && | |
306 | git commit -m "$1" && | |
307 | git tag "$1" | |
308 | } | |
309 | ||
310 | # Call test_merge with the arguments "<message> <commit>", where <commit> | |
311 | # can be a tag pointing to the commit-to-merge. | |
312 | ||
313 | test_merge () { | |
314 | test_tick && | |
315 | git merge -m "$1" "$2" && | |
316 | git tag "$1" | |
317 | } | |
318 | ||
1f553918 JS |
319 | # This function helps systems where core.filemode=false is set. |
320 | # Use it instead of plain 'chmod +x' to set or unset the executable bit | |
321 | # of a file in the working directory and add it to the index. | |
322 | ||
323 | test_chmod () { | |
324 | chmod "$@" && | |
325 | git update-index --add "--chmod=$@" | |
326 | } | |
327 | ||
a7bb3940 JS |
328 | # Use test_set_prereq to tell that a particular prerequisite is available. |
329 | # The prerequisite can later be checked for in two ways: | |
330 | # | |
331 | # - Explicitly using test_have_prereq. | |
332 | # | |
333 | # - Implicitly by specifying the prerequisite tag in the calls to | |
334 | # test_expect_{success,failure,code}. | |
335 | # | |
336 | # The single parameter is the prerequisite tag (a simple word, in all | |
337 | # capital letters by convention). | |
338 | ||
339 | test_set_prereq () { | |
340 | satisfied="$satisfied$1 " | |
341 | } | |
342 | satisfied=" " | |
343 | ||
344 | test_have_prereq () { | |
93a57246 ÆAB |
345 | # prerequisites can be concatenated with ',' |
346 | save_IFS=$IFS | |
347 | IFS=, | |
348 | set -- $* | |
349 | IFS=$save_IFS | |
ce60653e ÆAB |
350 | |
351 | total_prereq=0 | |
352 | ok_prereq=0 | |
353 | missing_prereq= | |
354 | ||
93a57246 ÆAB |
355 | for prerequisite |
356 | do | |
ce60653e | 357 | total_prereq=$(($total_prereq + 1)) |
93a57246 ÆAB |
358 | case $satisfied in |
359 | *" $prerequisite "*) | |
ce60653e ÆAB |
360 | ok_prereq=$(($ok_prereq + 1)) |
361 | ;; | |
93a57246 | 362 | *) |
ce60653e ÆAB |
363 | # Keep a list of missing prerequisites |
364 | if test -z "$missing_prereq" | |
365 | then | |
366 | missing_prereq=$prerequisite | |
367 | else | |
368 | missing_prereq="$prerequisite,$missing_prereq" | |
369 | fi | |
93a57246 ÆAB |
370 | esac |
371 | done | |
ce60653e ÆAB |
372 | |
373 | test $total_prereq = $ok_prereq | |
a7bb3940 JS |
374 | } |
375 | ||
886856ab JH |
376 | # You are not expected to call test_ok_ and test_failure_ directly, use |
377 | # the text_expect_* functions instead. | |
378 | ||
379 | test_ok_ () { | |
d5d9de1b | 380 | test_success=$(($test_success + 1)) |
5099b99d | 381 | say_color "" "ok $test_count - $@" |
e1970ce4 JH |
382 | } |
383 | ||
886856ab | 384 | test_failure_ () { |
d5d9de1b | 385 | test_failure=$(($test_failure + 1)) |
5099b99d | 386 | say_color error "not ok - $test_count $1" |
bf0dd8a8 | 387 | shift |
5099b99d | 388 | echo "$@" | sed -e 's/^/# /' |
6e7b5aaf | 389 | test "$immediate" = "" || { GIT_EXIT_OK=t; exit 1; } |
886856ab JH |
390 | } |
391 | ||
41ac414e | 392 | test_known_broken_ok_ () { |
41ac414e | 393 | test_fixed=$(($test_fixed+1)) |
5099b99d | 394 | say_color "" "ok $test_count - $@ # TODO known breakage" |
41ac414e JH |
395 | } |
396 | ||
397 | test_known_broken_failure_ () { | |
41ac414e | 398 | test_broken=$(($test_broken+1)) |
5099b99d | 399 | say_color skip "not ok $test_count - $@ # TODO known breakage" |
41ac414e | 400 | } |
886856ab JH |
401 | |
402 | test_debug () { | |
8e832ebc | 403 | test "$debug" = "" || eval "$1" |
e1970ce4 JH |
404 | } |
405 | ||
4d9d62fa | 406 | test_run_ () { |
b6b0afdc | 407 | test_cleanup=: |
4d9d62fa | 408 | eval >&3 2>&4 "$1" |
b6b0afdc | 409 | eval_ret=$? |
3bf78867 | 410 | eval >&3 2>&4 "$test_cleanup" |
57e1538a ÆAB |
411 | if test "$verbose" = "t" && test -n "$HARNESS_ACTIVE"; then |
412 | echo "" | |
413 | fi | |
4d9d62fa PR |
414 | return 0 |
415 | } | |
416 | ||
04ece593 | 417 | test_skip () { |
8586f98b | 418 | test_count=$(($test_count+1)) |
04ece593 JH |
419 | to_skip= |
420 | for skp in $GIT_SKIP_TESTS | |
421 | do | |
8586f98b | 422 | case $this_test.$test_count in |
04ece593 JH |
423 | $skp) |
424 | to_skip=t | |
47e67d47 | 425 | break |
04ece593 JH |
426 | esac |
427 | done | |
a7bb3940 JS |
428 | if test -z "$to_skip" && test -n "$prereq" && |
429 | ! test_have_prereq "$prereq" | |
430 | then | |
431 | to_skip=t | |
432 | fi | |
04ece593 JH |
433 | case "$to_skip" in |
434 | t) | |
07431fc8 JN |
435 | of_prereq= |
436 | if test "$missing_prereq" != "$prereq" | |
437 | then | |
438 | of_prereq=" of $prereq" | |
439 | fi | |
440 | ||
55db1df0 | 441 | say_color skip >&3 "skipping test: $@" |
07431fc8 | 442 | say_color skip "ok $test_count # skip $1 (missing $missing_prereq${of_prereq})" |
04ece593 JH |
443 | : true |
444 | ;; | |
445 | *) | |
446 | false | |
447 | ;; | |
448 | esac | |
449 | } | |
450 | ||
e1970ce4 | 451 | test_expect_failure () { |
a7bb3940 | 452 | test "$#" = 3 && { prereq=$1; shift; } || prereq= |
8e832ebc | 453 | test "$#" = 2 || |
a7bb3940 | 454 | error "bug in the test script: not 2 or 3 parameters to test-expect-failure" |
04ece593 | 455 | if ! test_skip "$@" |
e1970ce4 | 456 | then |
41ac414e | 457 | say >&3 "checking known breakage: $2" |
04ece593 | 458 | test_run_ "$2" |
41ac414e | 459 | if [ "$?" = 0 -a "$eval_ret" = 0 ] |
04ece593 | 460 | then |
41ac414e | 461 | test_known_broken_ok_ "$1" |
04ece593 | 462 | else |
6e7b5aaf | 463 | test_known_broken_failure_ "$1" |
04ece593 | 464 | fi |
e1970ce4 | 465 | fi |
7a0cf2d0 | 466 | echo >&3 "" |
e1970ce4 JH |
467 | } |
468 | ||
469 | test_expect_success () { | |
a7bb3940 | 470 | test "$#" = 3 && { prereq=$1; shift; } || prereq= |
8e832ebc | 471 | test "$#" = 2 || |
a7bb3940 | 472 | error "bug in the test script: not 2 or 3 parameters to test-expect-success" |
04ece593 | 473 | if ! test_skip "$@" |
e1970ce4 | 474 | then |
04ece593 JH |
475 | say >&3 "expecting success: $2" |
476 | test_run_ "$2" | |
477 | if [ "$?" = 0 -a "$eval_ret" = 0 ] | |
478 | then | |
479 | test_ok_ "$1" | |
480 | else | |
481 | test_failure_ "$@" | |
482 | fi | |
e1970ce4 | 483 | fi |
7a0cf2d0 | 484 | echo >&3 "" |
e1970ce4 JH |
485 | } |
486 | ||
fb32c410 LW |
487 | # test_external runs external test scripts that provide continuous |
488 | # test output about their progress, and succeeds/fails on | |
489 | # zero/non-zero exit code. It outputs the test output on stdout even | |
d998bd4a | 490 | # in non-verbose mode, and announces the external script with "# run |
fb32c410 LW |
491 | # <n>: ..." before running it. When providing relative paths, keep in |
492 | # mind that all scripts run in "trash directory". | |
493 | # Usage: test_external description command arguments... | |
494 | # Example: test_external 'Perl API' perl ../path/to/test.pl | |
495 | test_external () { | |
a7bb3940 JS |
496 | test "$#" = 4 && { prereq=$1; shift; } || prereq= |
497 | test "$#" = 3 || | |
498 | error >&5 "bug in the test script: not 3 or 4 parameters to test_external" | |
fb32c410 LW |
499 | descr="$1" |
500 | shift | |
501 | if ! test_skip "$descr" "$@" | |
502 | then | |
503 | # Announce the script to reduce confusion about the | |
504 | # test output that follows. | |
d998bd4a | 505 | say_color "" "# run $test_count: $descr ($*)" |
5ae8030f JN |
506 | # Export TEST_DIRECTORY, TRASH_DIRECTORY and GIT_TEST_LONG |
507 | # to be able to use them in script | |
508 | export TEST_DIRECTORY TRASH_DIRECTORY GIT_TEST_LONG | |
fb32c410 LW |
509 | # Run command; redirect its stderr to &4 as in |
510 | # test_run_, but keep its stdout on our stdout even in | |
511 | # non-verbose mode. | |
512 | "$@" 2>&4 | |
513 | if [ "$?" = 0 ] | |
514 | then | |
d998bd4a ÆAB |
515 | if test $test_external_has_tap -eq 0; then |
516 | test_ok_ "$descr" | |
517 | else | |
518 | say_color "" "# test_external test $descr was ok" | |
519 | test_success=$(($test_success + 1)) | |
520 | fi | |
fb32c410 | 521 | else |
d998bd4a ÆAB |
522 | if test $test_external_has_tap -eq 0; then |
523 | test_failure_ "$descr" "$@" | |
524 | else | |
525 | say_color error "# test_external test $descr failed: $@" | |
526 | test_failure=$(($test_failure + 1)) | |
527 | fi | |
fb32c410 LW |
528 | fi |
529 | fi | |
530 | } | |
531 | ||
532 | # Like test_external, but in addition tests that the command generated | |
533 | # no output on stderr. | |
534 | test_external_without_stderr () { | |
535 | # The temporary file has no (and must have no) security | |
536 | # implications. | |
537 | tmp="$TMPDIR"; if [ -z "$tmp" ]; then tmp=/tmp; fi | |
538 | stderr="$tmp/git-external-stderr.$$.tmp" | |
539 | test_external "$@" 4> "$stderr" | |
540 | [ -f "$stderr" ] || error "Internal error: $stderr disappeared." | |
541 | descr="no stderr: $1" | |
542 | shift | |
d998bd4a | 543 | say >&3 "# expecting no stderr from previous command" |
fb32c410 LW |
544 | if [ ! -s "$stderr" ]; then |
545 | rm "$stderr" | |
d998bd4a ÆAB |
546 | |
547 | if test $test_external_has_tap -eq 0; then | |
548 | test_ok_ "$descr" | |
549 | else | |
550 | say_color "" "# test_external_without_stderr test $descr was ok" | |
551 | test_success=$(($test_success + 1)) | |
552 | fi | |
fb32c410 LW |
553 | else |
554 | if [ "$verbose" = t ]; then | |
d998bd4a | 555 | output=`echo; echo "# Stderr is:"; cat "$stderr"` |
fb32c410 LW |
556 | else |
557 | output= | |
558 | fi | |
559 | # rm first in case test_failure exits. | |
560 | rm "$stderr" | |
d998bd4a ÆAB |
561 | if test $test_external_has_tap -eq 0; then |
562 | test_failure_ "$descr" "$@" "$output" | |
563 | else | |
564 | say_color error "# test_external_without_stderr test $descr failed: $@: $output" | |
565 | test_failure=$(($test_failure + 1)) | |
566 | fi | |
fb32c410 LW |
567 | fi |
568 | } | |
569 | ||
2caf20c5 MM |
570 | # debugging-friendly alternatives to "test [-f|-d|-e]" |
571 | # The commands test the existence or non-existence of $1. $2 can be | |
572 | # given to provide a more precise diagnosis. | |
573 | test_path_is_file () { | |
574 | if ! [ -f "$1" ] | |
575 | then | |
576 | echo "File $1 doesn't exist. $*" | |
577 | false | |
578 | fi | |
579 | } | |
580 | ||
581 | test_path_is_dir () { | |
582 | if ! [ -d "$1" ] | |
583 | then | |
584 | echo "Directory $1 doesn't exist. $*" | |
585 | false | |
586 | fi | |
587 | } | |
588 | ||
589 | test_path_is_missing () { | |
590 | if [ -e "$1" ] | |
591 | then | |
592 | echo "Path exists:" | |
593 | ls -ld "$1" | |
594 | if [ $# -ge 1 ]; then | |
595 | echo "$*" | |
596 | fi | |
597 | false | |
598 | fi | |
599 | } | |
600 | ||
601 | ||
74359821 JH |
602 | # This is not among top-level (test_expect_success | test_expect_failure) |
603 | # but is a prefix that can be used in the test script, like: | |
604 | # | |
605 | # test_expect_success 'complain and die' ' | |
606 | # do something && | |
607 | # do something else && | |
608 | # test_must_fail git checkout ../outerspace | |
609 | # ' | |
610 | # | |
611 | # Writing this as "! git checkout ../outerspace" is wrong, because | |
612 | # the failure could be due to a segv. We want a controlled failure. | |
613 | ||
614 | test_must_fail () { | |
615 | "$@" | |
16034fbe JK |
616 | exit_code=$? |
617 | if test $exit_code = 0; then | |
618 | echo >&2 "test_must_fail: command succeeded: $*" | |
619 | return 1 | |
620 | elif test $exit_code -gt 129 -a $exit_code -le 192; then | |
621 | echo >&2 "test_must_fail: died by signal: $*" | |
622 | return 1 | |
a54ce3ca JK |
623 | elif test $exit_code = 127; then |
624 | echo >&2 "test_must_fail: command not found: $*" | |
625 | return 1 | |
16034fbe JK |
626 | fi |
627 | return 0 | |
74359821 JH |
628 | } |
629 | ||
fdf1bc48 JN |
630 | # Similar to test_must_fail, but tolerates success, too. This is |
631 | # meant to be used in contexts like: | |
632 | # | |
633 | # test_expect_success 'some command works without configuration' ' | |
634 | # test_might_fail git config --unset all.configuration && | |
635 | # do something | |
636 | # ' | |
637 | # | |
638 | # Writing "git config --unset all.configuration || :" would be wrong, | |
639 | # because we want to notice if it fails due to segv. | |
640 | ||
641 | test_might_fail () { | |
642 | "$@" | |
5c8e1414 JN |
643 | exit_code=$? |
644 | if test $exit_code -gt 129 -a $exit_code -le 192; then | |
645 | echo >&2 "test_might_fail: died by signal: $*" | |
646 | return 1 | |
d0b8a617 JN |
647 | elif test $exit_code = 127; then |
648 | echo >&2 "test_might_fail: command not found: $*" | |
649 | return 1 | |
5c8e1414 JN |
650 | fi |
651 | return 0 | |
fdf1bc48 JN |
652 | } |
653 | ||
892e6f7e ÆAB |
654 | # Similar to test_must_fail and test_might_fail, but check that a |
655 | # given command exited with a given exit code. Meant to be used as: | |
656 | # | |
657 | # test_expect_success 'Merge with d/f conflicts' ' | |
658 | # test_expect_code 1 git merge "merge msg" B master | |
659 | # ' | |
660 | ||
661 | test_expect_code () { | |
662 | want_code=$1 | |
663 | shift | |
664 | "$@" | |
665 | exit_code=$? | |
666 | if test $exit_code = $want_code | |
667 | then | |
668 | echo >&2 "test_expect_code: command exited with $exit_code: $*" | |
669 | return 0 | |
670 | else | |
671 | echo >&2 "test_expect_code: command exited with $exit_code, we wanted $want_code $*" | |
672 | return 1 | |
673 | fi | |
674 | } | |
675 | ||
82ebb0b6 JK |
676 | # test_cmp is a helper function to compare actual and expected output. |
677 | # You can use it like: | |
678 | # | |
679 | # test_expect_success 'foo works' ' | |
680 | # echo expected >expected && | |
681 | # foo >actual && | |
682 | # test_cmp expected actual | |
683 | # ' | |
684 | # | |
685 | # This could be written as either "cmp" or "diff -u", but: | |
686 | # - cmp's output is not nearly as easy to read as diff -u | |
687 | # - not all diff versions understand "-u" | |
688 | ||
689 | test_cmp() { | |
690 | $GIT_TEST_CMP "$@" | |
691 | } | |
692 | ||
3bf78867 JN |
693 | # This function can be used to schedule some commands to be run |
694 | # unconditionally at the end of the test to restore sanity: | |
695 | # | |
696 | # test_expect_success 'test core.capslock' ' | |
697 | # git config core.capslock true && | |
698 | # test_when_finished "git config --unset core.capslock" && | |
699 | # hello world | |
700 | # ' | |
701 | # | |
702 | # That would be roughly equivalent to | |
703 | # | |
704 | # test_expect_success 'test core.capslock' ' | |
705 | # git config core.capslock true && | |
706 | # hello world | |
707 | # git config --unset core.capslock | |
708 | # ' | |
709 | # | |
710 | # except that the greeting and config --unset must both succeed for | |
711 | # the test to pass. | |
712 | ||
713 | test_when_finished () { | |
b6b0afdc JN |
714 | test_cleanup="{ $* |
715 | } && (exit \"\$eval_ret\"); eval_ret=\$?; $test_cleanup" | |
3bf78867 JN |
716 | } |
717 | ||
0509eb21 | 718 | # Most tests can use the created repository, but some may need to create more. |
eedf8f97 CW |
719 | # Usage: test_create_repo <directory> |
720 | test_create_repo () { | |
721 | test "$#" = 1 || | |
722 | error "bug in the test script: not 1 parameter to test-create-repo" | |
eedf8f97 | 723 | repo="$1" |
bfdbee98 | 724 | mkdir -p "$repo" |
0d314ce8 ÆAB |
725 | ( |
726 | cd "$repo" || error "Cannot setup test environment" | |
727 | "$GIT_EXEC_PATH/git-init" "--template=$GIT_BUILD_DIR/templates/blt/" >&3 2>&4 || | |
728 | error "cannot run git init -- have you built things yet?" | |
729 | mv .git/hooks .git/hooks-disabled | |
730 | ) || exit | |
eedf8f97 | 731 | } |
a6080a0a | 732 | |
e1970ce4 | 733 | test_done () { |
6e7b5aaf | 734 | GIT_EXIT_OK=t |
2d84e9fb | 735 | |
8ef1abe5 ÆAB |
736 | if test -z "$HARNESS_ACTIVE"; then |
737 | test_results_dir="$TEST_DIRECTORY/test-results" | |
738 | mkdir -p "$test_results_dir" | |
739 | test_results_path="$test_results_dir/${0%.sh}-$$.counts" | |
740 | ||
741 | echo "total $test_count" >> $test_results_path | |
742 | echo "success $test_success" >> $test_results_path | |
743 | echo "fixed $test_fixed" >> $test_results_path | |
744 | echo "broken $test_broken" >> $test_results_path | |
745 | echo "failed $test_failure" >> $test_results_path | |
746 | echo "" >> $test_results_path | |
747 | fi | |
41ac414e JH |
748 | |
749 | if test "$test_fixed" != 0 | |
750 | then | |
5099b99d | 751 | say_color pass "# fixed $test_fixed known breakage(s)" |
41ac414e JH |
752 | fi |
753 | if test "$test_broken" != 0 | |
754 | then | |
5099b99d | 755 | say_color error "# still have $test_broken known breakage(s)" |
11d54b8b JH |
756 | msg="remaining $(($test_count-$test_broken)) test(s)" |
757 | else | |
758 | msg="$test_count test(s)" | |
41ac414e | 759 | fi |
e1970ce4 | 760 | case "$test_failure" in |
10b94e28 | 761 | 0) |
5099b99d ÆAB |
762 | # Maybe print SKIP message |
763 | [ -z "$skip_all" ] || skip_all=" # SKIP $skip_all" | |
764 | ||
d998bd4a ÆAB |
765 | if test $test_external_has_tap -eq 0; then |
766 | say_color pass "# passed all $msg" | |
767 | say "1..$test_count$skip_all" | |
768 | fi | |
abc5d372 JS |
769 | |
770 | test -d "$remove_trash" && | |
771 | cd "$(dirname "$remove_trash")" && | |
772 | rm -rf "$(basename "$remove_trash")" | |
773 | ||
e1970ce4 JH |
774 | exit 0 ;; |
775 | ||
776 | *) | |
d998bd4a ÆAB |
777 | if test $test_external_has_tap -eq 0; then |
778 | say_color error "# failed $test_failure among $msg" | |
779 | say "1..$test_count" | |
780 | fi | |
5099b99d | 781 | |
e1970ce4 JH |
782 | exit 1 ;; |
783 | ||
784 | esac | |
785 | } | |
786 | ||
787 | # Test the binaries we have just built. The tests are kept in | |
9adefee5 | 788 | # t/ subdirectory and are run in 'trash directory' subdirectory. |
62f53904 ÆAB |
789 | if test -z "$TEST_DIRECTORY" |
790 | then | |
791 | # We allow tests to override this, in case they want to run tests | |
792 | # outside of t/, e.g. for running tests on the test library | |
793 | # itself. | |
794 | TEST_DIRECTORY=$(pwd) | |
795 | fi | |
6cec5c68 ÆAB |
796 | GIT_BUILD_DIR="$TEST_DIRECTORY"/.. |
797 | ||
e4597aae | 798 | if test -n "$valgrind" |
4e1be63c | 799 | then |
4e1be63c JS |
800 | make_symlink () { |
801 | test -h "$2" && | |
802 | test "$1" = "$(readlink "$2")" || { | |
803 | # be super paranoid | |
804 | if mkdir "$2".lock | |
805 | then | |
806 | rm -f "$2" && | |
807 | ln -s "$1" "$2" && | |
808 | rm -r "$2".lock | |
809 | else | |
810 | while test -d "$2".lock | |
811 | do | |
812 | say "Waiting for lock on $2." | |
813 | sleep 1 | |
814 | done | |
815 | fi | |
816 | } | |
817 | } | |
818 | ||
819 | make_valgrind_symlink () { | |
820 | # handle only executables | |
821 | test -x "$1" || return | |
822 | ||
823 | base=$(basename "$1") | |
6cec5c68 | 824 | symlink_target=$GIT_BUILD_DIR/$base |
4e1be63c JS |
825 | # do not override scripts |
826 | if test -x "$symlink_target" && | |
827 | test ! -d "$symlink_target" && | |
828 | test "#!" != "$(head -c 2 < "$symlink_target")" | |
829 | then | |
830 | symlink_target=../valgrind.sh | |
831 | fi | |
efd92ffd JS |
832 | case "$base" in |
833 | *.sh|*.perl) | |
834 | symlink_target=../unprocessed-script | |
835 | esac | |
4e1be63c JS |
836 | # create the link, or replace it if it is out of date |
837 | make_symlink "$symlink_target" "$GIT_VALGRIND/bin/$base" || exit | |
838 | } | |
839 | ||
840 | # override all git executables in TEST_DIRECTORY/.. | |
841 | GIT_VALGRIND=$TEST_DIRECTORY/valgrind | |
842 | mkdir -p "$GIT_VALGRIND"/bin | |
6cec5c68 | 843 | for file in $GIT_BUILD_DIR/git* $GIT_BUILD_DIR/test-* |
4e1be63c JS |
844 | do |
845 | make_valgrind_symlink $file | |
846 | done | |
efd92ffd JS |
847 | OLDIFS=$IFS |
848 | IFS=: | |
849 | for path in $PATH | |
850 | do | |
851 | ls "$path"/git-* 2> /dev/null | | |
852 | while read file | |
853 | do | |
854 | make_valgrind_symlink "$file" | |
855 | done | |
856 | done | |
857 | IFS=$OLDIFS | |
4e1be63c JS |
858 | PATH=$GIT_VALGRIND/bin:$PATH |
859 | GIT_EXEC_PATH=$GIT_VALGRIND/bin | |
860 | export GIT_VALGRIND | |
e4597aae MO |
861 | elif test -n "$GIT_TEST_INSTALLED" ; then |
862 | GIT_EXEC_PATH=$($GIT_TEST_INSTALLED/git --exec-path) || | |
863 | error "Cannot run git from $GIT_TEST_INSTALLED." | |
6cec5c68 | 864 | PATH=$GIT_TEST_INSTALLED:$GIT_BUILD_DIR:$PATH |
e4597aae MO |
865 | GIT_EXEC_PATH=${GIT_TEST_EXEC_PATH:-$GIT_EXEC_PATH} |
866 | else # normal case, use ../bin-wrappers only unless $with_dashes: | |
6cec5c68 | 867 | git_bin_dir="$GIT_BUILD_DIR/bin-wrappers" |
e4597aae MO |
868 | if ! test -x "$git_bin_dir/git" ; then |
869 | if test -z "$with_dashes" ; then | |
870 | say "$git_bin_dir/git is not executable; using GIT_EXEC_PATH" | |
871 | fi | |
872 | with_dashes=t | |
873 | fi | |
874 | PATH="$git_bin_dir:$PATH" | |
6cec5c68 | 875 | GIT_EXEC_PATH=$GIT_BUILD_DIR |
e4597aae | 876 | if test -n "$with_dashes" ; then |
6cec5c68 | 877 | PATH="$GIT_BUILD_DIR:$PATH" |
e4597aae | 878 | fi |
4e1be63c | 879 | fi |
6cec5c68 | 880 | GIT_TEMPLATE_DIR="$GIT_BUILD_DIR"/templates/blt |
8bfa6bd6 | 881 | unset GIT_CONFIG |
8bfa6bd6 JK |
882 | GIT_CONFIG_NOSYSTEM=1 |
883 | GIT_CONFIG_NOGLOBAL=1 | |
884 | export PATH GIT_EXEC_PATH GIT_TEMPLATE_DIR GIT_CONFIG_NOSYSTEM GIT_CONFIG_NOGLOBAL | |
49ccb087 | 885 | |
aed604c7 | 886 | . "$GIT_BUILD_DIR"/GIT-BUILD-OPTIONS |
ac10a857 | 887 | |
5e87eae9 JH |
888 | if test -z "$GIT_TEST_CMP" |
889 | then | |
890 | if test -n "$GIT_TEST_CMP_USE_COPIED_CONTEXT" | |
891 | then | |
892 | GIT_TEST_CMP="$DIFF -c" | |
893 | else | |
894 | GIT_TEST_CMP="$DIFF -u" | |
895 | fi | |
896 | fi | |
897 | ||
6cec5c68 | 898 | GITPERLLIB="$GIT_BUILD_DIR"/perl/blib/lib:"$GIT_BUILD_DIR"/perl/blib/arch/auto/Git |
6fcca938 | 899 | export GITPERLLIB |
6cec5c68 | 900 | test -d "$GIT_BUILD_DIR"/templates/blt || { |
eea42069 JH |
901 | error "You haven't built things yet, have you?" |
902 | } | |
e1970ce4 | 903 | |
ac10a857 | 904 | if test -z "$GIT_TEST_INSTALLED" && test -z "$NO_PYTHON" |
2fe40b63 | 905 | then |
6cec5c68 | 906 | GITPYTHONLIB="$GIT_BUILD_DIR/git_remote_helpers/build/lib" |
2fe40b63 | 907 | export GITPYTHONLIB |
6cec5c68 | 908 | test -d "$GIT_BUILD_DIR"/git_remote_helpers/build || { |
2fe40b63 SR |
909 | error "You haven't built git_remote_helpers yet, have you?" |
910 | } | |
911 | fi | |
912 | ||
6cec5c68 | 913 | if ! test -x "$GIT_BUILD_DIR"/test-chmtime; then |
56cf9806 EW |
914 | echo >&2 'You need to build test-chmtime:' |
915 | echo >&2 'Run "make test-chmtime" in the source (toplevel) directory' | |
916 | exit 1 | |
917 | fi | |
918 | ||
e1970ce4 | 919 | # Test repository |
abc5d372 | 920 | test="trash directory.$(basename "$0" .sh)" |
f423ef5f JK |
921 | test -n "$root" && test="$root/$test" |
922 | case "$test" in | |
923 | /*) TRASH_DIRECTORY="$test" ;; | |
924 | *) TRASH_DIRECTORY="$TEST_DIRECTORY/$test" ;; | |
925 | esac | |
91c8b825 | 926 | test ! -z "$debug" || remove_trash=$TRASH_DIRECTORY |
8d14ac94 | 927 | rm -fr "$test" || { |
6e7b5aaf | 928 | GIT_EXIT_OK=t |
8d14ac94 JH |
929 | echo >&5 "FATAL: Cannot prepare test area" |
930 | exit 1 | |
931 | } | |
932 | ||
4a7aaccd | 933 | test_create_repo "$test" |
1bd9c648 LW |
934 | # Use -P to resolve symlinks in our working directory so that the cwd |
935 | # in subprocesses like git equals our $PWD (for pathname comparisons). | |
936 | cd -P "$test" || exit 1 | |
04ece593 | 937 | |
e4c62e64 MM |
938 | HOME=$(pwd) |
939 | export HOME | |
940 | ||
d5d9de1b JS |
941 | this_test=${0##*/} |
942 | this_test=${this_test%%-*} | |
04ece593 JH |
943 | for skp in $GIT_SKIP_TESTS |
944 | do | |
47e67d47 MG |
945 | case "$this_test" in |
946 | $skp) | |
55db1df0 | 947 | say_color skip >&3 "skipping test $this_test altogether" |
637ab29b | 948 | skip_all="skip all tests in $this_test" |
04ece593 JH |
949 | test_done |
950 | esac | |
951 | done | |
f17e9fbb | 952 | |
8648732e BC |
953 | # Provide an implementation of the 'yes' utility |
954 | yes () { | |
955 | if test $# = 0 | |
956 | then | |
957 | y=y | |
958 | else | |
959 | y="$*" | |
960 | fi | |
961 | ||
962 | while echo "$y" | |
963 | do | |
964 | : | |
965 | done | |
966 | } | |
967 | ||
f17e9fbb JS |
968 | # Fix some commands on Windows |
969 | case $(uname -s) in | |
970 | *MINGW*) | |
971 | # Windows has its own (incompatible) sort and find | |
972 | sort () { | |
973 | /usr/bin/sort "$@" | |
974 | } | |
975 | find () { | |
976 | /usr/bin/find "$@" | |
977 | } | |
5397ea31 JS |
978 | sum () { |
979 | md5sum "$@" | |
980 | } | |
4114156a JS |
981 | # git sees Windows-style pwd |
982 | pwd () { | |
983 | builtin pwd -W | |
984 | } | |
ee9fb68c | 985 | # no POSIX permissions |
6fd1106a | 986 | # backslashes in pathspec are converted to '/' |
fb9a2bea | 987 | # exec does not inherit the PID |
ee9fb68c JS |
988 | ;; |
989 | *) | |
990 | test_set_prereq POSIXPERM | |
6fd1106a | 991 | test_set_prereq BSLASHPSPEC |
fb9a2bea | 992 | test_set_prereq EXECKEEPSPID |
f17e9fbb JS |
993 | ;; |
994 | esac | |
704a3143 | 995 | |
1b19ccd2 | 996 | test -z "$NO_PERL" && test_set_prereq PERL |
d4e1b47a | 997 | test -z "$NO_PYTHON" && test_set_prereq PYTHON |
1b19ccd2 | 998 | |
704a3143 JS |
999 | # test whether the filesystem supports symbolic links |
1000 | ln -s x y 2>/dev/null && test -h y 2>/dev/null && test_set_prereq SYMLINKS | |
1001 | rm -f y | |
c91cfd19 ÆAB |
1002 | |
1003 | # When the tests are run as root, permission tests will report that | |
1004 | # things are writable when they shouldn't be. | |
1005 | test -w / || test_set_prereq SANITY |