test-lib.sh: set prerequisite SANITY by testing what we really need
[git] / t / test-lib.sh
1 # Test framework for git.  See t/README for usage.
2 #
3 # Copyright (c) 2005 Junio C Hamano
4 #
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/ .
17
18 # Keep the original TERM for say_color
19 ORIGINAL_TERM=$TERM
20
21 # Test the binaries we have just built.  The tests are kept in
22 # t/ subdirectory and are run in 'trash directory' subdirectory.
23 if test -z "$TEST_DIRECTORY"
24 then
25         # We allow tests to override this, in case they want to run tests
26         # outside of t/, e.g. for running tests on the test library
27         # itself.
28         TEST_DIRECTORY=$(pwd)
29 else
30         # ensure that TEST_DIRECTORY is an absolute path so that it
31         # is valid even if the current working directory is changed
32         TEST_DIRECTORY=$(cd "$TEST_DIRECTORY" && pwd) || exit 1
33 fi
34 if test -z "$TEST_OUTPUT_DIRECTORY"
35 then
36         # Similarly, override this to store the test-results subdir
37         # elsewhere
38         TEST_OUTPUT_DIRECTORY=$TEST_DIRECTORY
39 fi
40 GIT_BUILD_DIR="$TEST_DIRECTORY"/..
41
42 ################################################################
43 # It appears that people try to run tests without building...
44 "$GIT_BUILD_DIR/git" >/dev/null
45 if test $? != 1
46 then
47         echo >&2 'error: you do not seem to have built git yet.'
48         exit 1
49 fi
50
51 . "$GIT_BUILD_DIR"/GIT-BUILD-OPTIONS
52 export PERL_PATH SHELL_PATH
53
54 # if --tee was passed, write the output not only to the terminal, but
55 # additionally to the file test-results/$BASENAME.out, too.
56 case "$GIT_TEST_TEE_STARTED, $* " in
57 done,*)
58         # do not redirect again
59         ;;
60 *' --tee '*|*' --va'*)
61         mkdir -p "$TEST_OUTPUT_DIRECTORY/test-results"
62         BASE="$TEST_OUTPUT_DIRECTORY/test-results/$(basename "$0" .sh)"
63         (GIT_TEST_TEE_STARTED=done ${SHELL_PATH} "$0" "$@" 2>&1;
64          echo $? > $BASE.exit) | tee $BASE.out
65         test "$(cat $BASE.exit)" = 0
66         exit
67         ;;
68 esac
69
70 # For repeatability, reset the environment to known value.
71 LANG=C
72 LC_ALL=C
73 PAGER=cat
74 TZ=UTC
75 TERM=dumb
76 export LANG LC_ALL PAGER TERM TZ
77 EDITOR=:
78 # A call to "unset" with no arguments causes at least Solaris 10
79 # /usr/xpg4/bin/sh and /bin/ksh to bail out.  So keep the unsets
80 # deriving from the command substitution clustered with the other
81 # ones.
82 unset VISUAL EMAIL LANGUAGE COLUMNS $("$PERL_PATH" -e '
83         my @env = keys %ENV;
84         my $ok = join("|", qw(
85                 TRACE
86                 DEBUG
87                 USE_LOOKUP
88                 TEST
89                 .*_TEST
90                 PROVE
91                 VALGRIND
92                 UNZIP
93                 PERF_
94                 CURL_VERBOSE
95         ));
96         my @vars = grep(/^GIT_/ && !/^GIT_($ok)/o, @env);
97         print join("\n", @vars);
98 ')
99 unset XDG_CONFIG_HOME
100 unset GITPERLLIB
101 GIT_AUTHOR_EMAIL=author@example.com
102 GIT_AUTHOR_NAME='A U Thor'
103 GIT_COMMITTER_EMAIL=committer@example.com
104 GIT_COMMITTER_NAME='C O Mitter'
105 GIT_MERGE_VERBOSITY=5
106 GIT_MERGE_AUTOEDIT=no
107 export GIT_MERGE_VERBOSITY GIT_MERGE_AUTOEDIT
108 export GIT_AUTHOR_EMAIL GIT_AUTHOR_NAME
109 export GIT_COMMITTER_EMAIL GIT_COMMITTER_NAME
110 export EDITOR
111
112 # Tests using GIT_TRACE typically don't want <timestamp> <file>:<line> output
113 GIT_TRACE_BARE=1
114 export GIT_TRACE_BARE
115
116 if test -n "${TEST_GIT_INDEX_VERSION:+isset}"
117 then
118         GIT_INDEX_VERSION="$TEST_GIT_INDEX_VERSION"
119         export GIT_INDEX_VERSION
120 fi
121
122 # Add libc MALLOC and MALLOC_PERTURB test
123 # only if we are not executing the test with valgrind
124 if expr " $GIT_TEST_OPTS " : ".* --valgrind " >/dev/null ||
125    test -n "$TEST_NO_MALLOC_CHECK"
126 then
127         setup_malloc_check () {
128                 : nothing
129         }
130         teardown_malloc_check () {
131                 : nothing
132         }
133 else
134         setup_malloc_check () {
135                 MALLOC_CHECK_=3 MALLOC_PERTURB_=165
136                 export MALLOC_CHECK_ MALLOC_PERTURB_
137         }
138         teardown_malloc_check () {
139                 unset MALLOC_CHECK_ MALLOC_PERTURB_
140         }
141 fi
142
143 # Protect ourselves from common misconfiguration to export
144 # CDPATH into the environment
145 unset CDPATH
146
147 unset GREP_OPTIONS
148 unset UNZIP
149
150 case $(echo $GIT_TRACE |tr "[A-Z]" "[a-z]") in
151 1|2|true)
152         echo "* warning: Some tests will not work if GIT_TRACE" \
153                 "is set as to trace on STDERR ! *"
154         echo "* warning: Please set GIT_TRACE to something" \
155                 "other than 1, 2 or true ! *"
156         ;;
157 esac
158
159 # Convenience
160 #
161 # A regexp to match 5 and 40 hexdigits
162 _x05='[0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f]'
163 _x40="$_x05$_x05$_x05$_x05$_x05$_x05$_x05$_x05"
164
165 # Zero SHA-1
166 _z40=0000000000000000000000000000000000000000
167
168 # Line feed
169 LF='
170 '
171
172 # UTF-8 ZERO WIDTH NON-JOINER, which HFS+ ignores
173 # when case-folding filenames
174 u200c=$(printf '\342\200\214')
175
176 export _x05 _x40 _z40 LF u200c
177
178 # Each test should start with something like this, after copyright notices:
179 #
180 # test_description='Description of this test...
181 # This test checks if command xyzzy does the right thing...
182 # '
183 # . ./test-lib.sh
184 [ "x$ORIGINAL_TERM" != "xdumb" ] && (
185                 TERM=$ORIGINAL_TERM &&
186                 export TERM &&
187                 [ -t 1 ] &&
188                 tput bold >/dev/null 2>&1 &&
189                 tput setaf 1 >/dev/null 2>&1 &&
190                 tput sgr0 >/dev/null 2>&1
191         ) &&
192         color=t
193
194 while test "$#" -ne 0
195 do
196         case "$1" in
197         -d|--d|--de|--deb|--debu|--debug)
198                 debug=t; shift ;;
199         -i|--i|--im|--imm|--imme|--immed|--immedi|--immedia|--immediat|--immediate)
200                 immediate=t; shift ;;
201         -l|--l|--lo|--lon|--long|--long-|--long-t|--long-te|--long-tes|--long-test|--long-tests)
202                 GIT_TEST_LONG=t; export GIT_TEST_LONG; shift ;;
203         -r)
204                 shift; test "$#" -ne 0 || {
205                         echo 'error: -r requires an argument' >&2;
206                         exit 1;
207                 }
208                 run_list=$1; shift ;;
209         --run=*)
210                 run_list=$(expr "z$1" : 'z[^=]*=\(.*\)'); shift ;;
211         -h|--h|--he|--hel|--help)
212                 help=t; shift ;;
213         -v|--v|--ve|--ver|--verb|--verbo|--verbos|--verbose)
214                 verbose=t; shift ;;
215         --verbose-only=*)
216                 verbose_only=$(expr "z$1" : 'z[^=]*=\(.*\)')
217                 shift ;;
218         -q|--q|--qu|--qui|--quie|--quiet)
219                 # Ignore --quiet under a TAP::Harness. Saying how many tests
220                 # passed without the ok/not ok details is always an error.
221                 test -z "$HARNESS_ACTIVE" && quiet=t; shift ;;
222         --with-dashes)
223                 with_dashes=t; shift ;;
224         --no-color)
225                 color=; shift ;;
226         --va|--val|--valg|--valgr|--valgri|--valgrin|--valgrind)
227                 valgrind=memcheck
228                 shift ;;
229         --valgrind=*)
230                 valgrind=$(expr "z$1" : 'z[^=]*=\(.*\)')
231                 shift ;;
232         --valgrind-only=*)
233                 valgrind_only=$(expr "z$1" : 'z[^=]*=\(.*\)')
234                 shift ;;
235         --tee)
236                 shift ;; # was handled already
237         --root=*)
238                 root=$(expr "z$1" : 'z[^=]*=\(.*\)')
239                 shift ;;
240         *)
241                 echo "error: unknown test option '$1'" >&2; exit 1 ;;
242         esac
243 done
244
245 if test -n "$valgrind_only"
246 then
247         test -z "$valgrind" && valgrind=memcheck
248         test -z "$verbose" && verbose_only="$valgrind_only"
249 elif test -n "$valgrind"
250 then
251         verbose=t
252 fi
253
254 if test -n "$color"
255 then
256         say_color () {
257                 (
258                 TERM=$ORIGINAL_TERM
259                 export TERM
260                 case "$1" in
261                 error)
262                         tput bold; tput setaf 1;; # bold red
263                 skip)
264                         tput setaf 4;; # blue
265                 warn)
266                         tput setaf 3;; # brown/yellow
267                 pass)
268                         tput setaf 2;; # green
269                 info)
270                         tput setaf 6;; # cyan
271                 *)
272                         test -n "$quiet" && return;;
273                 esac
274                 shift
275                 printf "%s" "$*"
276                 tput sgr0
277                 echo
278                 )
279         }
280 else
281         say_color() {
282                 test -z "$1" && test -n "$quiet" && return
283                 shift
284                 printf "%s\n" "$*"
285         }
286 fi
287
288 error () {
289         say_color error "error: $*"
290         GIT_EXIT_OK=t
291         exit 1
292 }
293
294 say () {
295         say_color info "$*"
296 }
297
298 test "${test_description}" != "" ||
299 error "Test script did not set test_description."
300
301 if test "$help" = "t"
302 then
303         printf '%s\n' "$test_description"
304         exit 0
305 fi
306
307 exec 5>&1
308 exec 6<&0
309 if test "$verbose" = "t"
310 then
311         exec 4>&2 3>&1
312 else
313         exec 4>/dev/null 3>/dev/null
314 fi
315
316 test_failure=0
317 test_count=0
318 test_fixed=0
319 test_broken=0
320 test_success=0
321
322 test_external_has_tap=0
323
324 die () {
325         code=$?
326         if test -n "$GIT_EXIT_OK"
327         then
328                 exit $code
329         else
330                 echo >&5 "FATAL: Unexpected exit with code $code"
331                 exit 1
332         fi
333 }
334
335 GIT_EXIT_OK=
336 trap 'die' EXIT
337
338 # The user-facing functions are loaded from a separate file so that
339 # test_perf subshells can have them too
340 . "$TEST_DIRECTORY/test-lib-functions.sh"
341
342 # You are not expected to call test_ok_ and test_failure_ directly, use
343 # the test_expect_* functions instead.
344
345 test_ok_ () {
346         test_success=$(($test_success + 1))
347         say_color "" "ok $test_count - $@"
348 }
349
350 test_failure_ () {
351         test_failure=$(($test_failure + 1))
352         say_color error "not ok $test_count - $1"
353         shift
354         printf '%s\n' "$*" | sed -e 's/^/#      /'
355         test "$immediate" = "" || { GIT_EXIT_OK=t; exit 1; }
356 }
357
358 test_known_broken_ok_ () {
359         test_fixed=$(($test_fixed+1))
360         say_color error "ok $test_count - $@ # TODO known breakage vanished"
361 }
362
363 test_known_broken_failure_ () {
364         test_broken=$(($test_broken+1))
365         say_color warn "not ok $test_count - $@ # TODO known breakage"
366 }
367
368 test_debug () {
369         test "$debug" = "" || eval "$1"
370 }
371
372 match_pattern_list () {
373         arg="$1"
374         shift
375         test -z "$*" && return 1
376         for pattern_
377         do
378                 case "$arg" in
379                 $pattern_)
380                         return 0
381                 esac
382         done
383         return 1
384 }
385
386 match_test_selector_list () {
387         title="$1"
388         shift
389         arg="$1"
390         shift
391         test -z "$1" && return 0
392
393         # Both commas and whitespace are accepted as separators.
394         OLDIFS=$IFS
395         IFS='   ,'
396         set -- $1
397         IFS=$OLDIFS
398
399         # If the first selector is negative we include by default.
400         include=
401         case "$1" in
402                 !*) include=t ;;
403         esac
404
405         for selector
406         do
407                 orig_selector=$selector
408
409                 positive=t
410                 case "$selector" in
411                         !*)
412                                 positive=
413                                 selector=${selector##?}
414                                 ;;
415                 esac
416
417                 test -z "$selector" && continue
418
419                 case "$selector" in
420                         *-*)
421                                 if expr "z${selector%%-*}" : "z[0-9]*[^0-9]" >/dev/null
422                                 then
423                                         echo "error: $title: invalid non-numeric in range" \
424                                                 "start: '$orig_selector'" >&2
425                                         exit 1
426                                 fi
427                                 if expr "z${selector#*-}" : "z[0-9]*[^0-9]" >/dev/null
428                                 then
429                                         echo "error: $title: invalid non-numeric in range" \
430                                                 "end: '$orig_selector'" >&2
431                                         exit 1
432                                 fi
433                                 ;;
434                         *)
435                                 if expr "z$selector" : "z[0-9]*[^0-9]" >/dev/null
436                                 then
437                                         echo "error: $title: invalid non-numeric in test" \
438                                                 "selector: '$orig_selector'" >&2
439                                         exit 1
440                                 fi
441                 esac
442
443                 # Short cut for "obvious" cases
444                 test -z "$include" && test -z "$positive" && continue
445                 test -n "$include" && test -n "$positive" && continue
446
447                 case "$selector" in
448                         -*)
449                                 if test $arg -le ${selector#-}
450                                 then
451                                         include=$positive
452                                 fi
453                                 ;;
454                         *-)
455                                 if test $arg -ge ${selector%-}
456                                 then
457                                         include=$positive
458                                 fi
459                                 ;;
460                         *-*)
461                                 if test ${selector%%-*} -le $arg \
462                                         && test $arg -le ${selector#*-}
463                                 then
464                                         include=$positive
465                                 fi
466                                 ;;
467                         *)
468                                 if test $arg -eq $selector
469                                 then
470                                         include=$positive
471                                 fi
472                                 ;;
473                 esac
474         done
475
476         test -n "$include"
477 }
478
479 maybe_teardown_verbose () {
480         test -z "$verbose_only" && return
481         exec 4>/dev/null 3>/dev/null
482         verbose=
483 }
484
485 last_verbose=t
486 maybe_setup_verbose () {
487         test -z "$verbose_only" && return
488         if match_pattern_list $test_count $verbose_only
489         then
490                 exec 4>&2 3>&1
491                 # Emit a delimiting blank line when going from
492                 # non-verbose to verbose.  Within verbose mode the
493                 # delimiter is printed by test_expect_*.  The choice
494                 # of the initial $last_verbose is such that before
495                 # test 1, we do not print it.
496                 test -z "$last_verbose" && echo >&3 ""
497                 verbose=t
498         else
499                 exec 4>/dev/null 3>/dev/null
500                 verbose=
501         fi
502         last_verbose=$verbose
503 }
504
505 maybe_teardown_valgrind () {
506         test -z "$GIT_VALGRIND" && return
507         GIT_VALGRIND_ENABLED=
508 }
509
510 maybe_setup_valgrind () {
511         test -z "$GIT_VALGRIND" && return
512         if test -z "$valgrind_only"
513         then
514                 GIT_VALGRIND_ENABLED=t
515                 return
516         fi
517         GIT_VALGRIND_ENABLED=
518         if match_pattern_list $test_count $valgrind_only
519         then
520                 GIT_VALGRIND_ENABLED=t
521         fi
522 }
523
524 test_eval_ () {
525         # This is a separate function because some tests use
526         # "return" to end a test_expect_success block early.
527         eval </dev/null >&3 2>&4 "$*"
528 }
529
530 test_run_ () {
531         test_cleanup=:
532         expecting_failure=$2
533         setup_malloc_check
534         test_eval_ "$1"
535         eval_ret=$?
536         teardown_malloc_check
537
538         if test -z "$immediate" || test $eval_ret = 0 || test -n "$expecting_failure"
539         then
540                 setup_malloc_check
541                 test_eval_ "$test_cleanup"
542                 teardown_malloc_check
543         fi
544         if test "$verbose" = "t" && test -n "$HARNESS_ACTIVE"
545         then
546                 echo ""
547         fi
548         return "$eval_ret"
549 }
550
551 test_start_ () {
552         test_count=$(($test_count+1))
553         maybe_setup_verbose
554         maybe_setup_valgrind
555 }
556
557 test_finish_ () {
558         echo >&3 ""
559         maybe_teardown_valgrind
560         maybe_teardown_verbose
561 }
562
563 test_skip () {
564         to_skip=
565         skipped_reason=
566         if match_pattern_list $this_test.$test_count $GIT_SKIP_TESTS
567         then
568                 to_skip=t
569                 skipped_reason="GIT_SKIP_TESTS"
570         fi
571         if test -z "$to_skip" && test -n "$test_prereq" &&
572            ! test_have_prereq "$test_prereq"
573         then
574                 to_skip=t
575
576                 of_prereq=
577                 if test "$missing_prereq" != "$test_prereq"
578                 then
579                         of_prereq=" of $test_prereq"
580                 fi
581                 skipped_reason="missing $missing_prereq${of_prereq}"
582         fi
583         if test -z "$to_skip" && test -n "$run_list" &&
584                 ! match_test_selector_list '--run' $test_count "$run_list"
585         then
586                 to_skip=t
587                 skipped_reason="--run"
588         fi
589
590         case "$to_skip" in
591         t)
592                 say_color skip >&3 "skipping test: $@"
593                 say_color skip "ok $test_count # skip $1 ($skipped_reason)"
594                 : true
595                 ;;
596         *)
597                 false
598                 ;;
599         esac
600 }
601
602 # stub; perf-lib overrides it
603 test_at_end_hook_ () {
604         :
605 }
606
607 test_done () {
608         GIT_EXIT_OK=t
609
610         if test -z "$HARNESS_ACTIVE"
611         then
612                 test_results_dir="$TEST_OUTPUT_DIRECTORY/test-results"
613                 mkdir -p "$test_results_dir"
614                 base=${0##*/}
615                 test_results_path="$test_results_dir/${base%.sh}-$$.counts"
616
617                 cat >>"$test_results_path" <<-EOF
618                 total $test_count
619                 success $test_success
620                 fixed $test_fixed
621                 broken $test_broken
622                 failed $test_failure
623
624                 EOF
625         fi
626
627         if test "$test_fixed" != 0
628         then
629                 say_color error "# $test_fixed known breakage(s) vanished; please update test(s)"
630         fi
631         if test "$test_broken" != 0
632         then
633                 say_color warn "# still have $test_broken known breakage(s)"
634         fi
635         if test "$test_broken" != 0 || test "$test_fixed" != 0
636         then
637                 test_remaining=$(( $test_count - $test_broken - $test_fixed ))
638                 msg="remaining $test_remaining test(s)"
639         else
640                 test_remaining=$test_count
641                 msg="$test_count test(s)"
642         fi
643         case "$test_failure" in
644         0)
645                 # Maybe print SKIP message
646                 if test -n "$skip_all" && test $test_count -gt 0
647                 then
648                         error "Can't use skip_all after running some tests"
649                 fi
650                 [ -z "$skip_all" ] || skip_all=" # SKIP $skip_all"
651
652                 if test $test_external_has_tap -eq 0
653                 then
654                         if test $test_remaining -gt 0
655                         then
656                                 say_color pass "# passed all $msg"
657                         fi
658                         say "1..$test_count$skip_all"
659                 fi
660
661                 test -d "$remove_trash" &&
662                 cd "$(dirname "$remove_trash")" &&
663                 rm -rf "$(basename "$remove_trash")"
664
665                 test_at_end_hook_
666
667                 exit 0 ;;
668
669         *)
670                 if test $test_external_has_tap -eq 0
671                 then
672                         say_color error "# failed $test_failure among $msg"
673                         say "1..$test_count"
674                 fi
675
676                 exit 1 ;;
677
678         esac
679 }
680
681 if test -n "$valgrind"
682 then
683         make_symlink () {
684                 test -h "$2" &&
685                 test "$1" = "$(readlink "$2")" || {
686                         # be super paranoid
687                         if mkdir "$2".lock
688                         then
689                                 rm -f "$2" &&
690                                 ln -s "$1" "$2" &&
691                                 rm -r "$2".lock
692                         else
693                                 while test -d "$2".lock
694                                 do
695                                         say "Waiting for lock on $2."
696                                         sleep 1
697                                 done
698                         fi
699                 }
700         }
701
702         make_valgrind_symlink () {
703                 # handle only executables, unless they are shell libraries that
704                 # need to be in the exec-path.
705                 test -x "$1" ||
706                 test "# " = "$(head -c 2 <"$1")" ||
707                 return;
708
709                 base=$(basename "$1")
710                 symlink_target=$GIT_BUILD_DIR/$base
711                 # do not override scripts
712                 if test -x "$symlink_target" &&
713                     test ! -d "$symlink_target" &&
714                     test "#!" != "$(head -c 2 < "$symlink_target")"
715                 then
716                         symlink_target=../valgrind.sh
717                 fi
718                 case "$base" in
719                 *.sh|*.perl)
720                         symlink_target=../unprocessed-script
721                 esac
722                 # create the link, or replace it if it is out of date
723                 make_symlink "$symlink_target" "$GIT_VALGRIND/bin/$base" || exit
724         }
725
726         # override all git executables in TEST_DIRECTORY/..
727         GIT_VALGRIND=$TEST_DIRECTORY/valgrind
728         mkdir -p "$GIT_VALGRIND"/bin
729         for file in $GIT_BUILD_DIR/git* $GIT_BUILD_DIR/test-*
730         do
731                 make_valgrind_symlink $file
732         done
733         # special-case the mergetools loadables
734         make_symlink "$GIT_BUILD_DIR"/mergetools "$GIT_VALGRIND/bin/mergetools"
735         OLDIFS=$IFS
736         IFS=:
737         for path in $PATH
738         do
739                 ls "$path"/git-* 2> /dev/null |
740                 while read file
741                 do
742                         make_valgrind_symlink "$file"
743                 done
744         done
745         IFS=$OLDIFS
746         PATH=$GIT_VALGRIND/bin:$PATH
747         GIT_EXEC_PATH=$GIT_VALGRIND/bin
748         export GIT_VALGRIND
749         GIT_VALGRIND_MODE="$valgrind"
750         export GIT_VALGRIND_MODE
751         GIT_VALGRIND_ENABLED=t
752         test -n "$valgrind_only" && GIT_VALGRIND_ENABLED=
753         export GIT_VALGRIND_ENABLED
754 elif test -n "$GIT_TEST_INSTALLED"
755 then
756         GIT_EXEC_PATH=$($GIT_TEST_INSTALLED/git --exec-path)  ||
757         error "Cannot run git from $GIT_TEST_INSTALLED."
758         PATH=$GIT_TEST_INSTALLED:$GIT_BUILD_DIR:$PATH
759         GIT_EXEC_PATH=${GIT_TEST_EXEC_PATH:-$GIT_EXEC_PATH}
760 else # normal case, use ../bin-wrappers only unless $with_dashes:
761         git_bin_dir="$GIT_BUILD_DIR/bin-wrappers"
762         if ! test -x "$git_bin_dir/git"
763         then
764                 if test -z "$with_dashes"
765                 then
766                         say "$git_bin_dir/git is not executable; using GIT_EXEC_PATH"
767                 fi
768                 with_dashes=t
769         fi
770         PATH="$git_bin_dir:$PATH"
771         GIT_EXEC_PATH=$GIT_BUILD_DIR
772         if test -n "$with_dashes"
773         then
774                 PATH="$GIT_BUILD_DIR:$PATH"
775         fi
776 fi
777 GIT_TEMPLATE_DIR="$GIT_BUILD_DIR"/templates/blt
778 GIT_CONFIG_NOSYSTEM=1
779 GIT_ATTR_NOSYSTEM=1
780 export PATH GIT_EXEC_PATH GIT_TEMPLATE_DIR GIT_CONFIG_NOSYSTEM GIT_ATTR_NOSYSTEM
781
782 if test -z "$GIT_TEST_CMP"
783 then
784         if test -n "$GIT_TEST_CMP_USE_COPIED_CONTEXT"
785         then
786                 GIT_TEST_CMP="$DIFF -c"
787         else
788                 GIT_TEST_CMP="$DIFF -u"
789         fi
790 fi
791
792 GITPERLLIB="$GIT_BUILD_DIR"/perl/blib/lib:"$GIT_BUILD_DIR"/perl/blib/arch/auto/Git
793 export GITPERLLIB
794 test -d "$GIT_BUILD_DIR"/templates/blt || {
795         error "You haven't built things yet, have you?"
796 }
797
798 if ! test -x "$GIT_BUILD_DIR"/test-chmtime
799 then
800         echo >&2 'You need to build test-chmtime:'
801         echo >&2 'Run "make test-chmtime" in the source (toplevel) directory'
802         exit 1
803 fi
804
805 # Test repository
806 TRASH_DIRECTORY="trash directory.$(basename "$0" .sh)"
807 test -n "$root" && TRASH_DIRECTORY="$root/$TRASH_DIRECTORY"
808 case "$TRASH_DIRECTORY" in
809 /*) ;; # absolute path is good
810  *) TRASH_DIRECTORY="$TEST_OUTPUT_DIRECTORY/$TRASH_DIRECTORY" ;;
811 esac
812 test ! -z "$debug" || remove_trash=$TRASH_DIRECTORY
813 rm -fr "$TRASH_DIRECTORY" || {
814         GIT_EXIT_OK=t
815         echo >&5 "FATAL: Cannot prepare test area"
816         exit 1
817 }
818
819 HOME="$TRASH_DIRECTORY"
820 export HOME
821
822 if test -z "$TEST_NO_CREATE_REPO"
823 then
824         test_create_repo "$TRASH_DIRECTORY"
825 else
826         mkdir -p "$TRASH_DIRECTORY"
827 fi
828 # Use -P to resolve symlinks in our working directory so that the cwd
829 # in subprocesses like git equals our $PWD (for pathname comparisons).
830 cd -P "$TRASH_DIRECTORY" || exit 1
831
832 this_test=${0##*/}
833 this_test=${this_test%%-*}
834 if match_pattern_list "$this_test" $GIT_SKIP_TESTS
835 then
836         say_color info >&3 "skipping test $this_test altogether"
837         skip_all="skip all tests in $this_test"
838         test_done
839 fi
840
841 # Provide an implementation of the 'yes' utility
842 yes () {
843         if test $# = 0
844         then
845                 y=y
846         else
847                 y="$*"
848         fi
849
850         while echo "$y"
851         do
852                 :
853         done
854 }
855
856 # Fix some commands on Windows
857 case $(uname -s) in
858 *MINGW*)
859         # Windows has its own (incompatible) sort and find
860         sort () {
861                 /usr/bin/sort "$@"
862         }
863         find () {
864                 /usr/bin/find "$@"
865         }
866         sum () {
867                 md5sum "$@"
868         }
869         # git sees Windows-style pwd
870         pwd () {
871                 builtin pwd -W
872         }
873         # no POSIX permissions
874         # backslashes in pathspec are converted to '/'
875         # exec does not inherit the PID
876         test_set_prereq MINGW
877         test_set_prereq NOT_CYGWIN
878         test_set_prereq SED_STRIPS_CR
879         test_set_prereq GREP_STRIPS_CR
880         GIT_TEST_CMP=mingw_test_cmp
881         ;;
882 *CYGWIN*)
883         test_set_prereq POSIXPERM
884         test_set_prereq EXECKEEPSPID
885         test_set_prereq NOT_MINGW
886         test_set_prereq CYGWIN
887         test_set_prereq SED_STRIPS_CR
888         test_set_prereq GREP_STRIPS_CR
889         ;;
890 *)
891         test_set_prereq POSIXPERM
892         test_set_prereq BSLASHPSPEC
893         test_set_prereq EXECKEEPSPID
894         test_set_prereq NOT_MINGW
895         test_set_prereq NOT_CYGWIN
896         ;;
897 esac
898
899 ( COLUMNS=1 && test $COLUMNS = 1 ) && test_set_prereq COLUMNS_CAN_BE_1
900 test -z "$NO_PERL" && test_set_prereq PERL
901 test -z "$NO_PYTHON" && test_set_prereq PYTHON
902 test -n "$USE_LIBPCRE" && test_set_prereq LIBPCRE
903 test -z "$NO_GETTEXT" && test_set_prereq GETTEXT
904
905 # Can we rely on git's output in the C locale?
906 if test -n "$GETTEXT_POISON"
907 then
908         GIT_GETTEXT_POISON=YesPlease
909         export GIT_GETTEXT_POISON
910         test_set_prereq GETTEXT_POISON
911 else
912         test_set_prereq C_LOCALE_OUTPUT
913 fi
914
915 # Use this instead of test_cmp to compare files that contain expected and
916 # actual output from git commands that can be translated.  When running
917 # under GETTEXT_POISON this pretends that the command produced expected
918 # results.
919 test_i18ncmp () {
920         test -n "$GETTEXT_POISON" || test_cmp "$@"
921 }
922
923 # Use this instead of "grep expected-string actual" to see if the
924 # output from a git command that can be translated either contains an
925 # expected string, or does not contain an unwanted one.  When running
926 # under GETTEXT_POISON this pretends that the command produced expected
927 # results.
928 test_i18ngrep () {
929         if test -n "$GETTEXT_POISON"
930         then
931             : # pretend success
932         elif test "x!" = "x$1"
933         then
934                 shift
935                 ! grep "$@"
936         else
937                 grep "$@"
938         fi
939 }
940
941 test_lazy_prereq PIPE '
942         # test whether the filesystem supports FIFOs
943         case $(uname -s) in
944         CYGWIN*)
945                 false
946                 ;;
947         *)
948                 rm -f testfifo && mkfifo testfifo
949                 ;;
950         esac
951 '
952
953 test_lazy_prereq SYMLINKS '
954         # test whether the filesystem supports symbolic links
955         ln -s x y && test -h y
956 '
957
958 test_lazy_prereq FILEMODE '
959         test "$(git config --bool core.filemode)" = true
960 '
961
962 test_lazy_prereq CASE_INSENSITIVE_FS '
963         echo good >CamelCase &&
964         echo bad >camelcase &&
965         test "$(cat CamelCase)" != good
966 '
967
968 test_lazy_prereq UTF8_NFD_TO_NFC '
969         # check whether FS converts nfd unicode to nfc
970         auml=$(printf "\303\244")
971         aumlcdiar=$(printf "\141\314\210")
972         >"$auml" &&
973         case "$(echo *)" in
974         "$aumlcdiar")
975                 true ;;
976         *)
977                 false ;;
978         esac
979 '
980
981 test_lazy_prereq AUTOIDENT '
982         sane_unset GIT_AUTHOR_NAME &&
983         sane_unset GIT_AUTHOR_EMAIL &&
984         git var GIT_AUTHOR_IDENT
985 '
986
987 test_lazy_prereq EXPENSIVE '
988         test -n "$GIT_TEST_LONG"
989 '
990
991 test_lazy_prereq USR_BIN_TIME '
992         test -x /usr/bin/time
993 '
994
995 test_lazy_prereq NOT_ROOT '
996         uid=$(id -u) &&
997         test "$uid" != 0
998 '
999
1000 # On a filesystem that lacks SANITY, a file can be deleted even if
1001 # the containing directory doesn't have write permissions, or a file
1002 # can be accessed even if the containing directory doesn't have read
1003 # or execute permissions, causing our tests that validate that Git
1004 # works sensibly in such situations.
1005 test_lazy_prereq SANITY '
1006         mkdir SANETESTD.1 SANETESTD.2 &&
1007
1008         chmod +w SANETESTD.1 SANETESTD.2 &&
1009         >SANETESTD.1/x 2>SANETESTD.2/x &&
1010         chmod -w SANETESTD.1 &&
1011         chmod -rx SANETESTD.2 ||
1012         error "bug in test sript: cannot prepare SANETESTD"
1013
1014         ! rm SANETESTD.1/x && ! test -f SANETESTD.2/x
1015         status=$?
1016
1017         chmod +rwx SANETESTD.1 SANETESTD.2 &&
1018         rm -rf SANETESTD.1 SANETESTD.2 ||
1019         error "bug in test sript: cannot clean SANETESTD"
1020         return $status
1021 '
1022
1023 GIT_UNZIP=${GIT_UNZIP:-unzip}
1024 test_lazy_prereq UNZIP '
1025         "$GIT_UNZIP" -v
1026         test $? -ne 127
1027 '