]>
Commit | Line | Data |
---|---|---|
1 | # Library of functions shared by all tests scripts, included by | |
2 | # test-lib.sh. | |
3 | # | |
4 | # Copyright (c) 2005 Junio C Hamano | |
5 | # | |
6 | # This program is free software: you can redistribute it and/or modify | |
7 | # it under the terms of the GNU General Public License as published by | |
8 | # the Free Software Foundation, either version 2 of the License, or | |
9 | # (at your option) any later version. | |
10 | # | |
11 | # This program is distributed in the hope that it will be useful, | |
12 | # but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 | # GNU General Public License for more details. | |
15 | # | |
16 | # You should have received a copy of the GNU General Public License | |
17 | # along with this program. If not, see http://www.gnu.org/licenses/ . | |
18 | ||
19 | # The semantics of the editor variables are that of invoking | |
20 | # sh -c "$EDITOR \"$@\"" files ... | |
21 | # | |
22 | # If our trash directory contains shell metacharacters, they will be | |
23 | # interpreted if we just set $EDITOR directly, so do a little dance with | |
24 | # environment variables to work around this. | |
25 | # | |
26 | # In particular, quoting isn't enough, as the path may contain the same quote | |
27 | # that we're using. | |
28 | test_set_editor () { | |
29 | FAKE_EDITOR="$1" | |
30 | export FAKE_EDITOR | |
31 | EDITOR='"$FAKE_EDITOR"' | |
32 | export EDITOR | |
33 | } | |
34 | ||
35 | test_set_index_version () { | |
36 | GIT_INDEX_VERSION="$1" | |
37 | export GIT_INDEX_VERSION | |
38 | } | |
39 | ||
40 | test_decode_color () { | |
41 | awk ' | |
42 | function name(n) { | |
43 | if (n == 0) return "RESET"; | |
44 | if (n == 1) return "BOLD"; | |
45 | if (n == 2) return "FAINT"; | |
46 | if (n == 3) return "ITALIC"; | |
47 | if (n == 7) return "REVERSE"; | |
48 | if (n == 30) return "BLACK"; | |
49 | if (n == 31) return "RED"; | |
50 | if (n == 32) return "GREEN"; | |
51 | if (n == 33) return "YELLOW"; | |
52 | if (n == 34) return "BLUE"; | |
53 | if (n == 35) return "MAGENTA"; | |
54 | if (n == 36) return "CYAN"; | |
55 | if (n == 37) return "WHITE"; | |
56 | if (n == 40) return "BLACK"; | |
57 | if (n == 41) return "BRED"; | |
58 | if (n == 42) return "BGREEN"; | |
59 | if (n == 43) return "BYELLOW"; | |
60 | if (n == 44) return "BBLUE"; | |
61 | if (n == 45) return "BMAGENTA"; | |
62 | if (n == 46) return "BCYAN"; | |
63 | if (n == 47) return "BWHITE"; | |
64 | } | |
65 | { | |
66 | while (match($0, /\033\[[0-9;]*m/) != 0) { | |
67 | printf "%s<", substr($0, 1, RSTART-1); | |
68 | codes = substr($0, RSTART+2, RLENGTH-3); | |
69 | if (length(codes) == 0) | |
70 | printf "%s", name(0) | |
71 | else { | |
72 | n = split(codes, ary, ";"); | |
73 | sep = ""; | |
74 | for (i = 1; i <= n; i++) { | |
75 | printf "%s%s", sep, name(ary[i]); | |
76 | sep = ";" | |
77 | } | |
78 | } | |
79 | printf ">"; | |
80 | $0 = substr($0, RSTART + RLENGTH, length($0) - RSTART - RLENGTH + 1); | |
81 | } | |
82 | ||
83 | } | |
84 | ' | |
85 | } | |
86 | ||
87 | lf_to_nul () { | |
88 | perl -pe 'y/\012/\000/' | |
89 | } | |
90 | ||
91 | nul_to_q () { | |
92 | perl -pe 'y/\000/Q/' | |
93 | } | |
94 | ||
95 | q_to_nul () { | |
96 | perl -pe 'y/Q/\000/' | |
97 | } | |
98 | ||
99 | q_to_cr () { | |
100 | tr Q '\015' | |
101 | } | |
102 | ||
103 | q_to_tab () { | |
104 | tr Q '\011' | |
105 | } | |
106 | ||
107 | qz_to_tab_space () { | |
108 | tr QZ '\011\040' | |
109 | } | |
110 | ||
111 | append_cr () { | |
112 | sed -e 's/$/Q/' | tr Q '\015' | |
113 | } | |
114 | ||
115 | remove_cr () { | |
116 | tr '\015' Q | sed -e 's/Q$//' | |
117 | } | |
118 | ||
119 | # Generate an output of $1 bytes of all zeroes (NULs, not ASCII zeroes). | |
120 | # If $1 is 'infinity', output forever or until the receiving pipe stops reading, | |
121 | # whichever comes first. | |
122 | generate_zero_bytes () { | |
123 | test-tool genzeros "$@" | |
124 | } | |
125 | ||
126 | # In some bourne shell implementations, the "unset" builtin returns | |
127 | # nonzero status when a variable to be unset was not set in the first | |
128 | # place. | |
129 | # | |
130 | # Use sane_unset when that should not be considered an error. | |
131 | ||
132 | sane_unset () { | |
133 | unset "$@" | |
134 | return 0 | |
135 | } | |
136 | ||
137 | test_tick () { | |
138 | if test -z "${test_tick+set}" | |
139 | then | |
140 | test_tick=1112911993 | |
141 | else | |
142 | test_tick=$(($test_tick + 60)) | |
143 | fi | |
144 | GIT_COMMITTER_DATE="$test_tick -0700" | |
145 | GIT_AUTHOR_DATE="$test_tick -0700" | |
146 | export GIT_COMMITTER_DATE GIT_AUTHOR_DATE | |
147 | } | |
148 | ||
149 | # Stop execution and start a shell. This is useful for debugging tests. | |
150 | # | |
151 | # Be sure to remove all invocations of this command before submitting. | |
152 | ||
153 | test_pause () { | |
154 | "$SHELL_PATH" <&6 >&5 2>&7 | |
155 | } | |
156 | ||
157 | # Wrap git with a debugger. Adding this to a command can make it easier | |
158 | # to understand what is going on in a failing test. | |
159 | # | |
160 | # Examples: | |
161 | # debug git checkout master | |
162 | # debug --debugger=nemiver git $ARGS | |
163 | # debug -d "valgrind --tool=memcheck --track-origins=yes" git $ARGS | |
164 | debug () { | |
165 | case "$1" in | |
166 | -d) | |
167 | GIT_DEBUGGER="$2" && | |
168 | shift 2 | |
169 | ;; | |
170 | --debugger=*) | |
171 | GIT_DEBUGGER="${1#*=}" && | |
172 | shift 1 | |
173 | ;; | |
174 | *) | |
175 | GIT_DEBUGGER=1 | |
176 | ;; | |
177 | esac && | |
178 | GIT_DEBUGGER="${GIT_DEBUGGER}" "$@" <&6 >&5 2>&7 | |
179 | } | |
180 | ||
181 | # Call test_commit with the arguments | |
182 | # [-C <directory>] <message> [<file> [<contents> [<tag>]]]" | |
183 | # | |
184 | # This will commit a file with the given contents and the given commit | |
185 | # message, and tag the resulting commit with the given tag name. | |
186 | # | |
187 | # <file>, <contents>, and <tag> all default to <message>. | |
188 | # | |
189 | # If the first argument is "-C", the second argument is used as a path for | |
190 | # the git invocations. | |
191 | ||
192 | test_commit () { | |
193 | notick= && | |
194 | signoff= && | |
195 | indir= && | |
196 | while test $# != 0 | |
197 | do | |
198 | case "$1" in | |
199 | --notick) | |
200 | notick=yes | |
201 | ;; | |
202 | --signoff) | |
203 | signoff="$1" | |
204 | ;; | |
205 | -C) | |
206 | indir="$2" | |
207 | shift | |
208 | ;; | |
209 | *) | |
210 | break | |
211 | ;; | |
212 | esac | |
213 | shift | |
214 | done && | |
215 | indir=${indir:+"$indir"/} && | |
216 | file=${2:-"$1.t"} && | |
217 | echo "${3-$1}" > "$indir$file" && | |
218 | git ${indir:+ -C "$indir"} add "$file" && | |
219 | if test -z "$notick" | |
220 | then | |
221 | test_tick | |
222 | fi && | |
223 | git ${indir:+ -C "$indir"} commit $signoff -m "$1" && | |
224 | git ${indir:+ -C "$indir"} tag "${4:-$1}" | |
225 | } | |
226 | ||
227 | # Call test_merge with the arguments "<message> <commit>", where <commit> | |
228 | # can be a tag pointing to the commit-to-merge. | |
229 | ||
230 | test_merge () { | |
231 | label="$1" && | |
232 | shift && | |
233 | test_tick && | |
234 | git merge -m "$label" "$@" && | |
235 | git tag "$label" | |
236 | } | |
237 | ||
238 | # Efficiently create <nr> commits, each with a unique number (from 1 to <nr> | |
239 | # by default) in the commit message. | |
240 | # | |
241 | # Usage: test_commit_bulk [options] <nr> | |
242 | # -C <dir>: | |
243 | # Run all git commands in directory <dir> | |
244 | # --ref=<n>: | |
245 | # ref on which to create commits (default: HEAD) | |
246 | # --start=<n>: | |
247 | # number commit messages from <n> (default: 1) | |
248 | # --message=<msg>: | |
249 | # use <msg> as the commit mesasge (default: "commit %s") | |
250 | # --filename=<fn>: | |
251 | # modify <fn> in each commit (default: %s.t) | |
252 | # --contents=<string>: | |
253 | # place <string> in each file (default: "content %s") | |
254 | # --id=<string>: | |
255 | # shorthand to use <string> and %s in message, filename, and contents | |
256 | # | |
257 | # The message, filename, and contents strings are evaluated by printf, with the | |
258 | # first "%s" replaced by the current commit number. So you can do: | |
259 | # | |
260 | # test_commit_bulk --filename=file --contents="modification %s" | |
261 | # | |
262 | # to have every commit touch the same file, but with unique content. | |
263 | # | |
264 | test_commit_bulk () { | |
265 | tmpfile=.bulk-commit.input | |
266 | indir=. | |
267 | ref=HEAD | |
268 | n=1 | |
269 | message='commit %s' | |
270 | filename='%s.t' | |
271 | contents='content %s' | |
272 | while test $# -gt 0 | |
273 | do | |
274 | case "$1" in | |
275 | -C) | |
276 | indir=$2 | |
277 | shift | |
278 | ;; | |
279 | --ref=*) | |
280 | ref=${1#--*=} | |
281 | ;; | |
282 | --start=*) | |
283 | n=${1#--*=} | |
284 | ;; | |
285 | --message=*) | |
286 | message=${1#--*=} | |
287 | ;; | |
288 | --filename=*) | |
289 | filename=${1#--*=} | |
290 | ;; | |
291 | --contents=*) | |
292 | contents=${1#--*=} | |
293 | ;; | |
294 | --id=*) | |
295 | message="${1#--*=} %s" | |
296 | filename="${1#--*=}-%s.t" | |
297 | contents="${1#--*=} %s" | |
298 | ;; | |
299 | -*) | |
300 | BUG "invalid test_commit_bulk option: $1" | |
301 | ;; | |
302 | *) | |
303 | break | |
304 | ;; | |
305 | esac | |
306 | shift | |
307 | done | |
308 | total=$1 | |
309 | ||
310 | add_from= | |
311 | if git -C "$indir" rev-parse --quiet --verify "$ref" | |
312 | then | |
313 | add_from=t | |
314 | fi | |
315 | ||
316 | while test "$total" -gt 0 | |
317 | do | |
318 | test_tick && | |
319 | echo "commit $ref" | |
320 | printf 'author %s <%s> %s\n' \ | |
321 | "$GIT_AUTHOR_NAME" \ | |
322 | "$GIT_AUTHOR_EMAIL" \ | |
323 | "$GIT_AUTHOR_DATE" | |
324 | printf 'committer %s <%s> %s\n' \ | |
325 | "$GIT_COMMITTER_NAME" \ | |
326 | "$GIT_COMMITTER_EMAIL" \ | |
327 | "$GIT_COMMITTER_DATE" | |
328 | echo "data <<EOF" | |
329 | printf "$message\n" $n | |
330 | echo "EOF" | |
331 | if test -n "$add_from" | |
332 | then | |
333 | echo "from $ref^0" | |
334 | add_from= | |
335 | fi | |
336 | printf "M 644 inline $filename\n" $n | |
337 | echo "data <<EOF" | |
338 | printf "$contents\n" $n | |
339 | echo "EOF" | |
340 | echo | |
341 | n=$((n + 1)) | |
342 | total=$((total - 1)) | |
343 | done >"$tmpfile" | |
344 | ||
345 | git -C "$indir" \ | |
346 | -c fastimport.unpacklimit=0 \ | |
347 | fast-import <"$tmpfile" || return 1 | |
348 | ||
349 | # This will be left in place on failure, which may aid debugging. | |
350 | rm -f "$tmpfile" | |
351 | ||
352 | # If we updated HEAD, then be nice and update the index and working | |
353 | # tree, too. | |
354 | if test "$ref" = "HEAD" | |
355 | then | |
356 | git -C "$indir" checkout -f HEAD || return 1 | |
357 | fi | |
358 | ||
359 | } | |
360 | ||
361 | # This function helps systems where core.filemode=false is set. | |
362 | # Use it instead of plain 'chmod +x' to set or unset the executable bit | |
363 | # of a file in the working directory and add it to the index. | |
364 | ||
365 | test_chmod () { | |
366 | chmod "$@" && | |
367 | git update-index --add "--chmod=$@" | |
368 | } | |
369 | ||
370 | # Get the modebits from a file. | |
371 | test_modebits () { | |
372 | ls -l "$1" | sed -e 's|^\(..........\).*|\1|' | |
373 | } | |
374 | ||
375 | # Unset a configuration variable, but don't fail if it doesn't exist. | |
376 | test_unconfig () { | |
377 | config_dir= | |
378 | if test "$1" = -C | |
379 | then | |
380 | shift | |
381 | config_dir=$1 | |
382 | shift | |
383 | fi | |
384 | git ${config_dir:+-C "$config_dir"} config --unset-all "$@" | |
385 | config_status=$? | |
386 | case "$config_status" in | |
387 | 5) # ok, nothing to unset | |
388 | config_status=0 | |
389 | ;; | |
390 | esac | |
391 | return $config_status | |
392 | } | |
393 | ||
394 | # Set git config, automatically unsetting it after the test is over. | |
395 | test_config () { | |
396 | config_dir= | |
397 | if test "$1" = -C | |
398 | then | |
399 | shift | |
400 | config_dir=$1 | |
401 | shift | |
402 | fi | |
403 | test_when_finished "test_unconfig ${config_dir:+-C '$config_dir'} '$1'" && | |
404 | git ${config_dir:+-C "$config_dir"} config "$@" | |
405 | } | |
406 | ||
407 | test_config_global () { | |
408 | test_when_finished "test_unconfig --global '$1'" && | |
409 | git config --global "$@" | |
410 | } | |
411 | ||
412 | write_script () { | |
413 | { | |
414 | echo "#!${2-"$SHELL_PATH"}" && | |
415 | cat | |
416 | } >"$1" && | |
417 | chmod +x "$1" | |
418 | } | |
419 | ||
420 | # Use test_set_prereq to tell that a particular prerequisite is available. | |
421 | # The prerequisite can later be checked for in two ways: | |
422 | # | |
423 | # - Explicitly using test_have_prereq. | |
424 | # | |
425 | # - Implicitly by specifying the prerequisite tag in the calls to | |
426 | # test_expect_{success,failure} and test_external{,_without_stderr}. | |
427 | # | |
428 | # The single parameter is the prerequisite tag (a simple word, in all | |
429 | # capital letters by convention). | |
430 | ||
431 | test_unset_prereq () { | |
432 | ! test_have_prereq "$1" || | |
433 | satisfied_prereq="${satisfied_prereq% $1 *} ${satisfied_prereq#* $1 }" | |
434 | } | |
435 | ||
436 | test_set_prereq () { | |
437 | if test -n "$GIT_TEST_FAIL_PREREQS_INTERNAL" | |
438 | then | |
439 | case "$1" in | |
440 | # The "!" case is handled below with | |
441 | # test_unset_prereq() | |
442 | !*) | |
443 | ;; | |
444 | # (Temporary?) whitelist of things we can't easily | |
445 | # pretend not to support | |
446 | SYMLINKS) | |
447 | ;; | |
448 | # Inspecting whether GIT_TEST_FAIL_PREREQS is on | |
449 | # should be unaffected. | |
450 | FAIL_PREREQS) | |
451 | ;; | |
452 | *) | |
453 | return | |
454 | esac | |
455 | fi | |
456 | ||
457 | case "$1" in | |
458 | !*) | |
459 | test_unset_prereq "${1#!}" | |
460 | ;; | |
461 | *) | |
462 | satisfied_prereq="$satisfied_prereq$1 " | |
463 | ;; | |
464 | esac | |
465 | } | |
466 | satisfied_prereq=" " | |
467 | lazily_testable_prereq= lazily_tested_prereq= | |
468 | ||
469 | # Usage: test_lazy_prereq PREREQ 'script' | |
470 | test_lazy_prereq () { | |
471 | lazily_testable_prereq="$lazily_testable_prereq$1 " | |
472 | eval test_prereq_lazily_$1=\$2 | |
473 | } | |
474 | ||
475 | test_run_lazy_prereq_ () { | |
476 | script=' | |
477 | mkdir -p "$TRASH_DIRECTORY/prereq-test-dir-'"$1"'" && | |
478 | ( | |
479 | cd "$TRASH_DIRECTORY/prereq-test-dir-'"$1"'" &&'"$2"' | |
480 | )' | |
481 | say >&3 "checking prerequisite: $1" | |
482 | say >&3 "$script" | |
483 | test_eval_ "$script" | |
484 | eval_ret=$? | |
485 | rm -rf "$TRASH_DIRECTORY/prereq-test-dir-$1" | |
486 | if test "$eval_ret" = 0; then | |
487 | say >&3 "prerequisite $1 ok" | |
488 | else | |
489 | say >&3 "prerequisite $1 not satisfied" | |
490 | fi | |
491 | return $eval_ret | |
492 | } | |
493 | ||
494 | test_have_prereq () { | |
495 | # prerequisites can be concatenated with ',' | |
496 | save_IFS=$IFS | |
497 | IFS=, | |
498 | set -- $* | |
499 | IFS=$save_IFS | |
500 | ||
501 | total_prereq=0 | |
502 | ok_prereq=0 | |
503 | missing_prereq= | |
504 | ||
505 | for prerequisite | |
506 | do | |
507 | case "$prerequisite" in | |
508 | !*) | |
509 | negative_prereq=t | |
510 | prerequisite=${prerequisite#!} | |
511 | ;; | |
512 | *) | |
513 | negative_prereq= | |
514 | esac | |
515 | ||
516 | case " $lazily_tested_prereq " in | |
517 | *" $prerequisite "*) | |
518 | ;; | |
519 | *) | |
520 | case " $lazily_testable_prereq " in | |
521 | *" $prerequisite "*) | |
522 | eval "script=\$test_prereq_lazily_$prerequisite" && | |
523 | if test_run_lazy_prereq_ "$prerequisite" "$script" | |
524 | then | |
525 | test_set_prereq $prerequisite | |
526 | fi | |
527 | lazily_tested_prereq="$lazily_tested_prereq$prerequisite " | |
528 | esac | |
529 | ;; | |
530 | esac | |
531 | ||
532 | total_prereq=$(($total_prereq + 1)) | |
533 | case "$satisfied_prereq" in | |
534 | *" $prerequisite "*) | |
535 | satisfied_this_prereq=t | |
536 | ;; | |
537 | *) | |
538 | satisfied_this_prereq= | |
539 | esac | |
540 | ||
541 | case "$satisfied_this_prereq,$negative_prereq" in | |
542 | t,|,t) | |
543 | ok_prereq=$(($ok_prereq + 1)) | |
544 | ;; | |
545 | *) | |
546 | # Keep a list of missing prerequisites; restore | |
547 | # the negative marker if necessary. | |
548 | prerequisite=${negative_prereq:+!}$prerequisite | |
549 | if test -z "$missing_prereq" | |
550 | then | |
551 | missing_prereq=$prerequisite | |
552 | else | |
553 | missing_prereq="$prerequisite,$missing_prereq" | |
554 | fi | |
555 | esac | |
556 | done | |
557 | ||
558 | test $total_prereq = $ok_prereq | |
559 | } | |
560 | ||
561 | test_declared_prereq () { | |
562 | case ",$test_prereq," in | |
563 | *,$1,*) | |
564 | return 0 | |
565 | ;; | |
566 | esac | |
567 | return 1 | |
568 | } | |
569 | ||
570 | test_verify_prereq () { | |
571 | test -z "$test_prereq" || | |
572 | expr >/dev/null "$test_prereq" : '[A-Z0-9_,!]*$' || | |
573 | BUG "'$test_prereq' does not look like a prereq" | |
574 | } | |
575 | ||
576 | test_expect_failure () { | |
577 | test_start_ | |
578 | test "$#" = 3 && { test_prereq=$1; shift; } || test_prereq= | |
579 | test "$#" = 2 || | |
580 | BUG "not 2 or 3 parameters to test-expect-failure" | |
581 | test_verify_prereq | |
582 | export test_prereq | |
583 | if ! test_skip "$@" | |
584 | then | |
585 | say >&3 "checking known breakage of $TEST_NUMBER.$test_count '$1': $2" | |
586 | if test_run_ "$2" expecting_failure | |
587 | then | |
588 | test_known_broken_ok_ "$1" | |
589 | else | |
590 | test_known_broken_failure_ "$1" | |
591 | fi | |
592 | fi | |
593 | test_finish_ | |
594 | } | |
595 | ||
596 | test_expect_success () { | |
597 | test_start_ | |
598 | test "$#" = 3 && { test_prereq=$1; shift; } || test_prereq= | |
599 | test "$#" = 2 || | |
600 | BUG "not 2 or 3 parameters to test-expect-success" | |
601 | test_verify_prereq | |
602 | export test_prereq | |
603 | if ! test_skip "$@" | |
604 | then | |
605 | say >&3 "expecting success of $TEST_NUMBER.$test_count '$1': $2" | |
606 | if test_run_ "$2" | |
607 | then | |
608 | test_ok_ "$1" | |
609 | else | |
610 | test_failure_ "$@" | |
611 | fi | |
612 | fi | |
613 | test_finish_ | |
614 | } | |
615 | ||
616 | # test_external runs external test scripts that provide continuous | |
617 | # test output about their progress, and succeeds/fails on | |
618 | # zero/non-zero exit code. It outputs the test output on stdout even | |
619 | # in non-verbose mode, and announces the external script with "# run | |
620 | # <n>: ..." before running it. When providing relative paths, keep in | |
621 | # mind that all scripts run in "trash directory". | |
622 | # Usage: test_external description command arguments... | |
623 | # Example: test_external 'Perl API' perl ../path/to/test.pl | |
624 | test_external () { | |
625 | test "$#" = 4 && { test_prereq=$1; shift; } || test_prereq= | |
626 | test "$#" = 3 || | |
627 | BUG "not 3 or 4 parameters to test_external" | |
628 | descr="$1" | |
629 | shift | |
630 | test_verify_prereq | |
631 | export test_prereq | |
632 | if ! test_skip "$descr" "$@" | |
633 | then | |
634 | # Announce the script to reduce confusion about the | |
635 | # test output that follows. | |
636 | say_color "" "# run $test_count: $descr ($*)" | |
637 | # Export TEST_DIRECTORY, TRASH_DIRECTORY and GIT_TEST_LONG | |
638 | # to be able to use them in script | |
639 | export TEST_DIRECTORY TRASH_DIRECTORY GIT_TEST_LONG | |
640 | # Run command; redirect its stderr to &4 as in | |
641 | # test_run_, but keep its stdout on our stdout even in | |
642 | # non-verbose mode. | |
643 | "$@" 2>&4 | |
644 | if test "$?" = 0 | |
645 | then | |
646 | if test $test_external_has_tap -eq 0; then | |
647 | test_ok_ "$descr" | |
648 | else | |
649 | say_color "" "# test_external test $descr was ok" | |
650 | test_success=$(($test_success + 1)) | |
651 | fi | |
652 | else | |
653 | if test $test_external_has_tap -eq 0; then | |
654 | test_failure_ "$descr" "$@" | |
655 | else | |
656 | say_color error "# test_external test $descr failed: $@" | |
657 | test_failure=$(($test_failure + 1)) | |
658 | fi | |
659 | fi | |
660 | fi | |
661 | } | |
662 | ||
663 | # Like test_external, but in addition tests that the command generated | |
664 | # no output on stderr. | |
665 | test_external_without_stderr () { | |
666 | # The temporary file has no (and must have no) security | |
667 | # implications. | |
668 | tmp=${TMPDIR:-/tmp} | |
669 | stderr="$tmp/git-external-stderr.$$.tmp" | |
670 | test_external "$@" 4> "$stderr" | |
671 | test -f "$stderr" || error "Internal error: $stderr disappeared." | |
672 | descr="no stderr: $1" | |
673 | shift | |
674 | say >&3 "# expecting no stderr from previous command" | |
675 | if test ! -s "$stderr" | |
676 | then | |
677 | rm "$stderr" | |
678 | ||
679 | if test $test_external_has_tap -eq 0; then | |
680 | test_ok_ "$descr" | |
681 | else | |
682 | say_color "" "# test_external_without_stderr test $descr was ok" | |
683 | test_success=$(($test_success + 1)) | |
684 | fi | |
685 | else | |
686 | if test "$verbose" = t | |
687 | then | |
688 | output=$(echo; echo "# Stderr is:"; cat "$stderr") | |
689 | else | |
690 | output= | |
691 | fi | |
692 | # rm first in case test_failure exits. | |
693 | rm "$stderr" | |
694 | if test $test_external_has_tap -eq 0; then | |
695 | test_failure_ "$descr" "$@" "$output" | |
696 | else | |
697 | say_color error "# test_external_without_stderr test $descr failed: $@: $output" | |
698 | test_failure=$(($test_failure + 1)) | |
699 | fi | |
700 | fi | |
701 | } | |
702 | ||
703 | # debugging-friendly alternatives to "test [-f|-d|-e]" | |
704 | # The commands test the existence or non-existence of $1. $2 can be | |
705 | # given to provide a more precise diagnosis. | |
706 | test_path_is_file () { | |
707 | if ! test -f "$1" | |
708 | then | |
709 | echo "File $1 doesn't exist. $2" | |
710 | false | |
711 | fi | |
712 | } | |
713 | ||
714 | test_path_is_dir () { | |
715 | if ! test -d "$1" | |
716 | then | |
717 | echo "Directory $1 doesn't exist. $2" | |
718 | false | |
719 | fi | |
720 | } | |
721 | ||
722 | test_path_exists () { | |
723 | if ! test -e "$1" | |
724 | then | |
725 | echo "Path $1 doesn't exist. $2" | |
726 | false | |
727 | fi | |
728 | } | |
729 | ||
730 | # Check if the directory exists and is empty as expected, barf otherwise. | |
731 | test_dir_is_empty () { | |
732 | test_path_is_dir "$1" && | |
733 | if test -n "$(ls -a1 "$1" | egrep -v '^\.\.?$')" | |
734 | then | |
735 | echo "Directory '$1' is not empty, it contains:" | |
736 | ls -la "$1" | |
737 | return 1 | |
738 | fi | |
739 | } | |
740 | ||
741 | # Check if the file exists and has a size greater than zero | |
742 | test_file_not_empty () { | |
743 | if ! test -s "$1" | |
744 | then | |
745 | echo "'$1' is not a non-empty file." | |
746 | false | |
747 | fi | |
748 | } | |
749 | ||
750 | test_path_is_missing () { | |
751 | if test -e "$1" | |
752 | then | |
753 | echo "Path exists:" | |
754 | ls -ld "$1" | |
755 | if test $# -ge 1 | |
756 | then | |
757 | echo "$*" | |
758 | fi | |
759 | false | |
760 | fi | |
761 | } | |
762 | ||
763 | # test_line_count checks that a file has the number of lines it | |
764 | # ought to. For example: | |
765 | # | |
766 | # test_expect_success 'produce exactly one line of output' ' | |
767 | # do something >output && | |
768 | # test_line_count = 1 output | |
769 | # ' | |
770 | # | |
771 | # is like "test $(wc -l <output) = 1" except that it passes the | |
772 | # output through when the number of lines is wrong. | |
773 | ||
774 | test_line_count () { | |
775 | if test $# != 3 | |
776 | then | |
777 | BUG "not 3 parameters to test_line_count" | |
778 | elif ! test $(wc -l <"$3") "$1" "$2" | |
779 | then | |
780 | echo "test_line_count: line count for $3 !$1 $2" | |
781 | cat "$3" | |
782 | return 1 | |
783 | fi | |
784 | } | |
785 | ||
786 | test_file_size () { | |
787 | test-tool path-utils file-size "$1" | |
788 | } | |
789 | ||
790 | # Returns success if a comma separated string of keywords ($1) contains a | |
791 | # given keyword ($2). | |
792 | # Examples: | |
793 | # `list_contains "foo,bar" bar` returns 0 | |
794 | # `list_contains "foo" bar` returns 1 | |
795 | ||
796 | list_contains () { | |
797 | case ",$1," in | |
798 | *,$2,*) | |
799 | return 0 | |
800 | ;; | |
801 | esac | |
802 | return 1 | |
803 | } | |
804 | ||
805 | # Returns success if the arguments indicate that a command should be | |
806 | # accepted by test_must_fail(). If the command is run with env, the env | |
807 | # and its corresponding variable settings will be stripped before we | |
808 | # test the command being run. | |
809 | test_must_fail_acceptable () { | |
810 | if test "$1" = "env" | |
811 | then | |
812 | shift | |
813 | while test $# -gt 0 | |
814 | do | |
815 | case "$1" in | |
816 | *?=*) | |
817 | shift | |
818 | ;; | |
819 | *) | |
820 | break | |
821 | ;; | |
822 | esac | |
823 | done | |
824 | fi | |
825 | ||
826 | case "$1" in | |
827 | git|__git*|test-tool|test_terminal) | |
828 | return 0 | |
829 | ;; | |
830 | *) | |
831 | return 1 | |
832 | ;; | |
833 | esac | |
834 | } | |
835 | ||
836 | # This is not among top-level (test_expect_success | test_expect_failure) | |
837 | # but is a prefix that can be used in the test script, like: | |
838 | # | |
839 | # test_expect_success 'complain and die' ' | |
840 | # do something && | |
841 | # do something else && | |
842 | # test_must_fail git checkout ../outerspace | |
843 | # ' | |
844 | # | |
845 | # Writing this as "! git checkout ../outerspace" is wrong, because | |
846 | # the failure could be due to a segv. We want a controlled failure. | |
847 | # | |
848 | # Accepts the following options: | |
849 | # | |
850 | # ok=<signal-name>[,<...>]: | |
851 | # Don't treat an exit caused by the given signal as error. | |
852 | # Multiple signals can be specified as a comma separated list. | |
853 | # Currently recognized signal names are: sigpipe, success. | |
854 | # (Don't use 'success', use 'test_might_fail' instead.) | |
855 | # | |
856 | # Do not use this to run anything but "git" and other specific testable | |
857 | # commands (see test_must_fail_acceptable()). We are not in the | |
858 | # business of vetting system supplied commands -- in other words, this | |
859 | # is wrong: | |
860 | # | |
861 | # test_must_fail grep pattern output | |
862 | # | |
863 | # Instead use '!': | |
864 | # | |
865 | # ! grep pattern output | |
866 | ||
867 | test_must_fail () { | |
868 | case "$1" in | |
869 | ok=*) | |
870 | _test_ok=${1#ok=} | |
871 | shift | |
872 | ;; | |
873 | *) | |
874 | _test_ok= | |
875 | ;; | |
876 | esac | |
877 | if ! test_must_fail_acceptable "$@" | |
878 | then | |
879 | echo >&7 "test_must_fail: only 'git' is allowed: $*" | |
880 | return 1 | |
881 | fi | |
882 | "$@" 2>&7 | |
883 | exit_code=$? | |
884 | if test $exit_code -eq 0 && ! list_contains "$_test_ok" success | |
885 | then | |
886 | echo >&4 "test_must_fail: command succeeded: $*" | |
887 | return 1 | |
888 | elif test_match_signal 13 $exit_code && list_contains "$_test_ok" sigpipe | |
889 | then | |
890 | return 0 | |
891 | elif test $exit_code -gt 129 && test $exit_code -le 192 | |
892 | then | |
893 | echo >&4 "test_must_fail: died by signal $(($exit_code - 128)): $*" | |
894 | return 1 | |
895 | elif test $exit_code -eq 127 | |
896 | then | |
897 | echo >&4 "test_must_fail: command not found: $*" | |
898 | return 1 | |
899 | elif test $exit_code -eq 126 | |
900 | then | |
901 | echo >&4 "test_must_fail: valgrind error: $*" | |
902 | return 1 | |
903 | fi | |
904 | return 0 | |
905 | } 7>&2 2>&4 | |
906 | ||
907 | # Similar to test_must_fail, but tolerates success, too. This is | |
908 | # meant to be used in contexts like: | |
909 | # | |
910 | # test_expect_success 'some command works without configuration' ' | |
911 | # test_might_fail git config --unset all.configuration && | |
912 | # do something | |
913 | # ' | |
914 | # | |
915 | # Writing "git config --unset all.configuration || :" would be wrong, | |
916 | # because we want to notice if it fails due to segv. | |
917 | # | |
918 | # Accepts the same options as test_must_fail. | |
919 | ||
920 | test_might_fail () { | |
921 | test_must_fail ok=success "$@" 2>&7 | |
922 | } 7>&2 2>&4 | |
923 | ||
924 | # Similar to test_must_fail and test_might_fail, but check that a | |
925 | # given command exited with a given exit code. Meant to be used as: | |
926 | # | |
927 | # test_expect_success 'Merge with d/f conflicts' ' | |
928 | # test_expect_code 1 git merge "merge msg" B master | |
929 | # ' | |
930 | ||
931 | test_expect_code () { | |
932 | want_code=$1 | |
933 | shift | |
934 | "$@" 2>&7 | |
935 | exit_code=$? | |
936 | if test $exit_code = $want_code | |
937 | then | |
938 | return 0 | |
939 | fi | |
940 | ||
941 | echo >&4 "test_expect_code: command exited with $exit_code, we wanted $want_code $*" | |
942 | return 1 | |
943 | } 7>&2 2>&4 | |
944 | ||
945 | # test_cmp is a helper function to compare actual and expected output. | |
946 | # You can use it like: | |
947 | # | |
948 | # test_expect_success 'foo works' ' | |
949 | # echo expected >expected && | |
950 | # foo >actual && | |
951 | # test_cmp expected actual | |
952 | # ' | |
953 | # | |
954 | # This could be written as either "cmp" or "diff -u", but: | |
955 | # - cmp's output is not nearly as easy to read as diff -u | |
956 | # - not all diff versions understand "-u" | |
957 | ||
958 | test_cmp() { | |
959 | eval "$GIT_TEST_CMP" '"$@"' | |
960 | } | |
961 | ||
962 | # Check that the given config key has the expected value. | |
963 | # | |
964 | # test_cmp_config [-C <dir>] <expected-value> | |
965 | # [<git-config-options>...] <config-key> | |
966 | # | |
967 | # for example to check that the value of core.bar is foo | |
968 | # | |
969 | # test_cmp_config foo core.bar | |
970 | # | |
971 | test_cmp_config() { | |
972 | local GD && | |
973 | if test "$1" = "-C" | |
974 | then | |
975 | shift && | |
976 | GD="-C $1" && | |
977 | shift | |
978 | fi && | |
979 | printf "%s\n" "$1" >expect.config && | |
980 | shift && | |
981 | git $GD config "$@" >actual.config && | |
982 | test_cmp expect.config actual.config | |
983 | } | |
984 | ||
985 | # test_cmp_bin - helper to compare binary files | |
986 | ||
987 | test_cmp_bin() { | |
988 | cmp "$@" | |
989 | } | |
990 | ||
991 | # Use this instead of test_cmp to compare files that contain expected and | |
992 | # actual output from git commands that can be translated. When running | |
993 | # under GIT_TEST_GETTEXT_POISON this pretends that the command produced expected | |
994 | # results. | |
995 | test_i18ncmp () { | |
996 | ! test_have_prereq C_LOCALE_OUTPUT || test_cmp "$@" | |
997 | } | |
998 | ||
999 | # Use this instead of "grep expected-string actual" to see if the | |
1000 | # output from a git command that can be translated either contains an | |
1001 | # expected string, or does not contain an unwanted one. When running | |
1002 | # under GIT_TEST_GETTEXT_POISON this pretends that the command produced expected | |
1003 | # results. | |
1004 | test_i18ngrep () { | |
1005 | eval "last_arg=\${$#}" | |
1006 | ||
1007 | test -f "$last_arg" || | |
1008 | BUG "test_i18ngrep requires a file to read as the last parameter" | |
1009 | ||
1010 | if test $# -lt 2 || | |
1011 | { test "x!" = "x$1" && test $# -lt 3 ; } | |
1012 | then | |
1013 | BUG "too few parameters to test_i18ngrep" | |
1014 | fi | |
1015 | ||
1016 | if test_have_prereq !C_LOCALE_OUTPUT | |
1017 | then | |
1018 | # pretend success | |
1019 | return 0 | |
1020 | fi | |
1021 | ||
1022 | if test "x!" = "x$1" | |
1023 | then | |
1024 | shift | |
1025 | ! grep "$@" && return 0 | |
1026 | ||
1027 | echo >&4 "error: '! grep $@' did find a match in:" | |
1028 | else | |
1029 | grep "$@" && return 0 | |
1030 | ||
1031 | echo >&4 "error: 'grep $@' didn't find a match in:" | |
1032 | fi | |
1033 | ||
1034 | if test -s "$last_arg" | |
1035 | then | |
1036 | cat >&4 "$last_arg" | |
1037 | else | |
1038 | echo >&4 "<File '$last_arg' is empty>" | |
1039 | fi | |
1040 | ||
1041 | return 1 | |
1042 | } | |
1043 | ||
1044 | # Call any command "$@" but be more verbose about its | |
1045 | # failure. This is handy for commands like "test" which do | |
1046 | # not output anything when they fail. | |
1047 | verbose () { | |
1048 | "$@" && return 0 | |
1049 | echo >&4 "command failed: $(git rev-parse --sq-quote "$@")" | |
1050 | return 1 | |
1051 | } | |
1052 | ||
1053 | # Check if the file expected to be empty is indeed empty, and barfs | |
1054 | # otherwise. | |
1055 | ||
1056 | test_must_be_empty () { | |
1057 | test_path_is_file "$1" && | |
1058 | if test -s "$1" | |
1059 | then | |
1060 | echo "'$1' is not empty, it contains:" | |
1061 | cat "$1" | |
1062 | return 1 | |
1063 | fi | |
1064 | } | |
1065 | ||
1066 | # Tests that its two parameters refer to the same revision, or if '!' is | |
1067 | # provided first, that its other two parameters refer to different | |
1068 | # revisions. | |
1069 | test_cmp_rev () { | |
1070 | local op='=' wrong_result=different | |
1071 | ||
1072 | if test $# -ge 1 && test "x$1" = 'x!' | |
1073 | then | |
1074 | op='!=' | |
1075 | wrong_result='the same' | |
1076 | shift | |
1077 | fi | |
1078 | if test $# != 2 | |
1079 | then | |
1080 | error "bug in the test script: test_cmp_rev requires two revisions, but got $#" | |
1081 | else | |
1082 | local r1 r2 | |
1083 | r1=$(git rev-parse --verify "$1") && | |
1084 | r2=$(git rev-parse --verify "$2") || return 1 | |
1085 | ||
1086 | if ! test "$r1" "$op" "$r2" | |
1087 | then | |
1088 | cat >&4 <<-EOF | |
1089 | error: two revisions point to $wrong_result objects: | |
1090 | '$1': $r1 | |
1091 | '$2': $r2 | |
1092 | EOF | |
1093 | return 1 | |
1094 | fi | |
1095 | fi | |
1096 | } | |
1097 | ||
1098 | # Compare paths respecting core.ignoreCase | |
1099 | test_cmp_fspath () { | |
1100 | if test "x$1" = "x$2" | |
1101 | then | |
1102 | return 0 | |
1103 | fi | |
1104 | ||
1105 | if test true != "$(git config --get --type=bool core.ignorecase)" | |
1106 | then | |
1107 | return 1 | |
1108 | fi | |
1109 | ||
1110 | test "x$(echo "$1" | tr A-Z a-z)" = "x$(echo "$2" | tr A-Z a-z)" | |
1111 | } | |
1112 | ||
1113 | # Print a sequence of integers in increasing order, either with | |
1114 | # two arguments (start and end): | |
1115 | # | |
1116 | # test_seq 1 5 -- outputs 1 2 3 4 5 one line at a time | |
1117 | # | |
1118 | # or with one argument (end), in which case it starts counting | |
1119 | # from 1. | |
1120 | ||
1121 | test_seq () { | |
1122 | case $# in | |
1123 | 1) set 1 "$@" ;; | |
1124 | 2) ;; | |
1125 | *) BUG "not 1 or 2 parameters to test_seq" ;; | |
1126 | esac | |
1127 | test_seq_counter__=$1 | |
1128 | while test "$test_seq_counter__" -le "$2" | |
1129 | do | |
1130 | echo "$test_seq_counter__" | |
1131 | test_seq_counter__=$(( $test_seq_counter__ + 1 )) | |
1132 | done | |
1133 | } | |
1134 | ||
1135 | # This function can be used to schedule some commands to be run | |
1136 | # unconditionally at the end of the test to restore sanity: | |
1137 | # | |
1138 | # test_expect_success 'test core.capslock' ' | |
1139 | # git config core.capslock true && | |
1140 | # test_when_finished "git config --unset core.capslock" && | |
1141 | # hello world | |
1142 | # ' | |
1143 | # | |
1144 | # That would be roughly equivalent to | |
1145 | # | |
1146 | # test_expect_success 'test core.capslock' ' | |
1147 | # git config core.capslock true && | |
1148 | # hello world | |
1149 | # git config --unset core.capslock | |
1150 | # ' | |
1151 | # | |
1152 | # except that the greeting and config --unset must both succeed for | |
1153 | # the test to pass. | |
1154 | # | |
1155 | # Note that under --immediate mode, no clean-up is done to help diagnose | |
1156 | # what went wrong. | |
1157 | ||
1158 | test_when_finished () { | |
1159 | # We cannot detect when we are in a subshell in general, but by | |
1160 | # doing so on Bash is better than nothing (the test will | |
1161 | # silently pass on other shells). | |
1162 | test "${BASH_SUBSHELL-0}" = 0 || | |
1163 | BUG "test_when_finished does nothing in a subshell" | |
1164 | test_cleanup="{ $* | |
1165 | } && (exit \"\$eval_ret\"); eval_ret=\$?; $test_cleanup" | |
1166 | } | |
1167 | ||
1168 | # This function can be used to schedule some commands to be run | |
1169 | # unconditionally at the end of the test script, e.g. to stop a daemon: | |
1170 | # | |
1171 | # test_expect_success 'test git daemon' ' | |
1172 | # git daemon & | |
1173 | # daemon_pid=$! && | |
1174 | # test_atexit 'kill $daemon_pid' && | |
1175 | # hello world | |
1176 | # ' | |
1177 | # | |
1178 | # The commands will be executed before the trash directory is removed, | |
1179 | # i.e. the atexit commands will still be able to access any pidfiles or | |
1180 | # socket files. | |
1181 | # | |
1182 | # Note that these commands will be run even when a test script run | |
1183 | # with '--immediate' fails. Be careful with your atexit commands to | |
1184 | # minimize any changes to the failed state. | |
1185 | ||
1186 | test_atexit () { | |
1187 | # We cannot detect when we are in a subshell in general, but by | |
1188 | # doing so on Bash is better than nothing (the test will | |
1189 | # silently pass on other shells). | |
1190 | test "${BASH_SUBSHELL-0}" = 0 || | |
1191 | error "bug in test script: test_atexit does nothing in a subshell" | |
1192 | test_atexit_cleanup="{ $* | |
1193 | } && (exit \"\$eval_ret\"); eval_ret=\$?; $test_atexit_cleanup" | |
1194 | } | |
1195 | ||
1196 | # Most tests can use the created repository, but some may need to create more. | |
1197 | # Usage: test_create_repo <directory> | |
1198 | test_create_repo () { | |
1199 | test "$#" = 1 || | |
1200 | BUG "not 1 parameter to test-create-repo" | |
1201 | repo="$1" | |
1202 | mkdir -p "$repo" | |
1203 | ( | |
1204 | cd "$repo" || error "Cannot setup test environment" | |
1205 | "${GIT_TEST_INSTALLED:-$GIT_EXEC_PATH}/git$X" init \ | |
1206 | "--template=$GIT_BUILD_DIR/templates/blt/" >&3 2>&4 || | |
1207 | error "cannot run git init -- have you built things yet?" | |
1208 | mv .git/hooks .git/hooks-disabled | |
1209 | ) || exit | |
1210 | } | |
1211 | ||
1212 | # This function helps on symlink challenged file systems when it is not | |
1213 | # important that the file system entry is a symbolic link. | |
1214 | # Use test_ln_s_add instead of "ln -s x y && git add y" to add a | |
1215 | # symbolic link entry y to the index. | |
1216 | ||
1217 | test_ln_s_add () { | |
1218 | if test_have_prereq SYMLINKS | |
1219 | then | |
1220 | ln -s "$1" "$2" && | |
1221 | git update-index --add "$2" | |
1222 | else | |
1223 | printf '%s' "$1" >"$2" && | |
1224 | ln_s_obj=$(git hash-object -w "$2") && | |
1225 | git update-index --add --cacheinfo 120000 $ln_s_obj "$2" && | |
1226 | # pick up stat info from the file | |
1227 | git update-index "$2" | |
1228 | fi | |
1229 | } | |
1230 | ||
1231 | # This function writes out its parameters, one per line | |
1232 | test_write_lines () { | |
1233 | printf "%s\n" "$@" | |
1234 | } | |
1235 | ||
1236 | perl () { | |
1237 | command "$PERL_PATH" "$@" 2>&7 | |
1238 | } 7>&2 2>&4 | |
1239 | ||
1240 | # Given the name of an environment variable with a bool value, normalize | |
1241 | # its value to a 0 (true) or 1 (false or empty string) return code. | |
1242 | # | |
1243 | # test_bool_env GIT_TEST_HTTPD <default-value> | |
1244 | # | |
1245 | # Return with code corresponding to the given default value if the variable | |
1246 | # is unset. | |
1247 | # Abort the test script if either the value of the variable or the default | |
1248 | # are not valid bool values. | |
1249 | ||
1250 | test_bool_env () { | |
1251 | if test $# != 2 | |
1252 | then | |
1253 | BUG "test_bool_env requires two parameters (variable name and default value)" | |
1254 | fi | |
1255 | ||
1256 | git env--helper --type=bool --default="$2" --exit-code "$1" | |
1257 | ret=$? | |
1258 | case $ret in | |
1259 | 0|1) # unset or valid bool value | |
1260 | ;; | |
1261 | *) # invalid bool value or something unexpected | |
1262 | error >&7 "test_bool_env requires bool values both for \$$1 and for the default fallback" | |
1263 | ;; | |
1264 | esac | |
1265 | return $ret | |
1266 | } | |
1267 | ||
1268 | # Exit the test suite, either by skipping all remaining tests or by | |
1269 | # exiting with an error. If our prerequisite variable $1 falls back | |
1270 | # on a default assume we were opportunistically trying to set up some | |
1271 | # tests and we skip. If it is explicitly "true", then we report a failure. | |
1272 | # | |
1273 | # The error/skip message should be given by $2. | |
1274 | # | |
1275 | test_skip_or_die () { | |
1276 | if ! test_bool_env "$1" false | |
1277 | then | |
1278 | skip_all=$2 | |
1279 | test_done | |
1280 | fi | |
1281 | error "$2" | |
1282 | } | |
1283 | ||
1284 | # The following mingw_* functions obey POSIX shell syntax, but are actually | |
1285 | # bash scripts, and are meant to be used only with bash on Windows. | |
1286 | ||
1287 | # A test_cmp function that treats LF and CRLF equal and avoids to fork | |
1288 | # diff when possible. | |
1289 | mingw_test_cmp () { | |
1290 | # Read text into shell variables and compare them. If the results | |
1291 | # are different, use regular diff to report the difference. | |
1292 | local test_cmp_a= test_cmp_b= | |
1293 | ||
1294 | # When text came from stdin (one argument is '-') we must feed it | |
1295 | # to diff. | |
1296 | local stdin_for_diff= | |
1297 | ||
1298 | # Since it is difficult to detect the difference between an | |
1299 | # empty input file and a failure to read the files, we go straight | |
1300 | # to diff if one of the inputs is empty. | |
1301 | if test -s "$1" && test -s "$2" | |
1302 | then | |
1303 | # regular case: both files non-empty | |
1304 | mingw_read_file_strip_cr_ test_cmp_a <"$1" | |
1305 | mingw_read_file_strip_cr_ test_cmp_b <"$2" | |
1306 | elif test -s "$1" && test "$2" = - | |
1307 | then | |
1308 | # read 2nd file from stdin | |
1309 | mingw_read_file_strip_cr_ test_cmp_a <"$1" | |
1310 | mingw_read_file_strip_cr_ test_cmp_b | |
1311 | stdin_for_diff='<<<"$test_cmp_b"' | |
1312 | elif test "$1" = - && test -s "$2" | |
1313 | then | |
1314 | # read 1st file from stdin | |
1315 | mingw_read_file_strip_cr_ test_cmp_a | |
1316 | mingw_read_file_strip_cr_ test_cmp_b <"$2" | |
1317 | stdin_for_diff='<<<"$test_cmp_a"' | |
1318 | fi | |
1319 | test -n "$test_cmp_a" && | |
1320 | test -n "$test_cmp_b" && | |
1321 | test "$test_cmp_a" = "$test_cmp_b" || | |
1322 | eval "diff -u \"\$@\" $stdin_for_diff" | |
1323 | } | |
1324 | ||
1325 | # $1 is the name of the shell variable to fill in | |
1326 | mingw_read_file_strip_cr_ () { | |
1327 | # Read line-wise using LF as the line separator | |
1328 | # and use IFS to strip CR. | |
1329 | local line | |
1330 | while : | |
1331 | do | |
1332 | if IFS=$'\r' read -r -d $'\n' line | |
1333 | then | |
1334 | # good | |
1335 | line=$line$'\n' | |
1336 | else | |
1337 | # we get here at EOF, but also if the last line | |
1338 | # was not terminated by LF; in the latter case, | |
1339 | # some text was read | |
1340 | if test -z "$line" | |
1341 | then | |
1342 | # EOF, really | |
1343 | break | |
1344 | fi | |
1345 | fi | |
1346 | eval "$1=\$$1\$line" | |
1347 | done | |
1348 | } | |
1349 | ||
1350 | # Like "env FOO=BAR some-program", but run inside a subshell, which means | |
1351 | # it also works for shell functions (though those functions cannot impact | |
1352 | # the environment outside of the test_env invocation). | |
1353 | test_env () { | |
1354 | ( | |
1355 | while test $# -gt 0 | |
1356 | do | |
1357 | case "$1" in | |
1358 | *=*) | |
1359 | eval "${1%%=*}=\${1#*=}" | |
1360 | eval "export ${1%%=*}" | |
1361 | shift | |
1362 | ;; | |
1363 | *) | |
1364 | "$@" 2>&7 | |
1365 | exit | |
1366 | ;; | |
1367 | esac | |
1368 | done | |
1369 | ) | |
1370 | } 7>&2 2>&4 | |
1371 | ||
1372 | # Returns true if the numeric exit code in "$2" represents the expected signal | |
1373 | # in "$1". Signals should be given numerically. | |
1374 | test_match_signal () { | |
1375 | if test "$2" = "$((128 + $1))" | |
1376 | then | |
1377 | # POSIX | |
1378 | return 0 | |
1379 | elif test "$2" = "$((256 + $1))" | |
1380 | then | |
1381 | # ksh | |
1382 | return 0 | |
1383 | fi | |
1384 | return 1 | |
1385 | } | |
1386 | ||
1387 | # Read up to "$1" bytes (or to EOF) from stdin and write them to stdout. | |
1388 | test_copy_bytes () { | |
1389 | perl -e ' | |
1390 | my $len = $ARGV[1]; | |
1391 | while ($len > 0) { | |
1392 | my $s; | |
1393 | my $nread = sysread(STDIN, $s, $len); | |
1394 | die "cannot read: $!" unless defined($nread); | |
1395 | last unless $nread; | |
1396 | print $s; | |
1397 | $len -= $nread; | |
1398 | } | |
1399 | ' - "$1" | |
1400 | } | |
1401 | ||
1402 | # run "$@" inside a non-git directory | |
1403 | nongit () { | |
1404 | test -d non-repo || | |
1405 | mkdir non-repo || | |
1406 | return 1 | |
1407 | ||
1408 | ( | |
1409 | GIT_CEILING_DIRECTORIES=$(pwd) && | |
1410 | export GIT_CEILING_DIRECTORIES && | |
1411 | cd non-repo && | |
1412 | "$@" 2>&7 | |
1413 | ) | |
1414 | } 7>&2 2>&4 | |
1415 | ||
1416 | # convert function arguments or stdin (if not arguments given) to pktline | |
1417 | # representation. If multiple arguments are given, they are separated by | |
1418 | # whitespace and put in a single packet. Note that data containing NULs must be | |
1419 | # given on stdin, and that empty input becomes an empty packet, not a flush | |
1420 | # packet (for that you can just print 0000 yourself). | |
1421 | packetize() { | |
1422 | if test $# -gt 0 | |
1423 | then | |
1424 | packet="$*" | |
1425 | printf '%04x%s' "$((4 + ${#packet}))" "$packet" | |
1426 | else | |
1427 | perl -e ' | |
1428 | my $packet = do { local $/; <STDIN> }; | |
1429 | printf "%04x%s", 4 + length($packet), $packet; | |
1430 | ' | |
1431 | fi | |
1432 | } | |
1433 | ||
1434 | # Parse the input as a series of pktlines, writing the result to stdout. | |
1435 | # Sideband markers are removed automatically, and the output is routed to | |
1436 | # stderr if appropriate. | |
1437 | # | |
1438 | # NUL bytes are converted to "\\0" for ease of parsing with text tools. | |
1439 | depacketize () { | |
1440 | perl -e ' | |
1441 | while (read(STDIN, $len, 4) == 4) { | |
1442 | if ($len eq "0000") { | |
1443 | print "FLUSH\n"; | |
1444 | } else { | |
1445 | read(STDIN, $buf, hex($len) - 4); | |
1446 | $buf =~ s/\0/\\0/g; | |
1447 | if ($buf =~ s/^[\x2\x3]//) { | |
1448 | print STDERR $buf; | |
1449 | } else { | |
1450 | $buf =~ s/^\x1//; | |
1451 | print $buf; | |
1452 | } | |
1453 | } | |
1454 | } | |
1455 | ' | |
1456 | } | |
1457 | ||
1458 | # Converts base-16 data into base-8. The output is given as a sequence of | |
1459 | # escaped octals, suitable for consumption by 'printf'. | |
1460 | hex2oct () { | |
1461 | perl -ne 'printf "\\%03o", hex for /../g' | |
1462 | } | |
1463 | ||
1464 | # Set the hash algorithm in use to $1. Only useful when testing the testsuite. | |
1465 | test_set_hash () { | |
1466 | test_hash_algo="$1" | |
1467 | } | |
1468 | ||
1469 | # Detect the hash algorithm in use. | |
1470 | test_detect_hash () { | |
1471 | test_hash_algo="${GIT_TEST_DEFAULT_HASH:-sha1}" | |
1472 | } | |
1473 | ||
1474 | # Load common hash metadata and common placeholder object IDs for use with | |
1475 | # test_oid. | |
1476 | test_oid_init () { | |
1477 | test -n "$test_hash_algo" || test_detect_hash && | |
1478 | test_oid_cache <"$TEST_DIRECTORY/oid-info/hash-info" && | |
1479 | test_oid_cache <"$TEST_DIRECTORY/oid-info/oid" | |
1480 | } | |
1481 | ||
1482 | # Load key-value pairs from stdin suitable for use with test_oid. Blank lines | |
1483 | # and lines starting with "#" are ignored. Keys must be shell identifier | |
1484 | # characters. | |
1485 | # | |
1486 | # Examples: | |
1487 | # rawsz sha1:20 | |
1488 | # rawsz sha256:32 | |
1489 | test_oid_cache () { | |
1490 | local tag rest k v && | |
1491 | ||
1492 | { test -n "$test_hash_algo" || test_detect_hash; } && | |
1493 | while read tag rest | |
1494 | do | |
1495 | case $tag in | |
1496 | \#*) | |
1497 | continue;; | |
1498 | ?*) | |
1499 | # non-empty | |
1500 | ;; | |
1501 | *) | |
1502 | # blank line | |
1503 | continue;; | |
1504 | esac && | |
1505 | ||
1506 | k="${rest%:*}" && | |
1507 | v="${rest#*:}" && | |
1508 | ||
1509 | if ! expr "$k" : '[a-z0-9][a-z0-9]*$' >/dev/null | |
1510 | then | |
1511 | BUG 'bad hash algorithm' | |
1512 | fi && | |
1513 | eval "test_oid_${k}_$tag=\"\$v\"" | |
1514 | done | |
1515 | } | |
1516 | ||
1517 | # Look up a per-hash value based on a key ($1). The value must have been loaded | |
1518 | # by test_oid_init or test_oid_cache. | |
1519 | test_oid () { | |
1520 | local algo="${test_hash_algo}" && | |
1521 | ||
1522 | case "$1" in | |
1523 | --hash=*) | |
1524 | algo="${1#--hash=}" && | |
1525 | shift;; | |
1526 | *) | |
1527 | ;; | |
1528 | esac && | |
1529 | ||
1530 | local var="test_oid_${algo}_$1" && | |
1531 | ||
1532 | # If the variable is unset, we must be missing an entry for this | |
1533 | # key-hash pair, so exit with an error. | |
1534 | if eval "test -z \"\${$var+set}\"" | |
1535 | then | |
1536 | BUG "undefined key '$1'" | |
1537 | fi && | |
1538 | eval "printf '%s' \"\${$var}\"" | |
1539 | } | |
1540 | ||
1541 | # Insert a slash into an object ID so it can be used to reference a location | |
1542 | # under ".git/objects". For example, "deadbeef..." becomes "de/adbeef..". | |
1543 | test_oid_to_path () { | |
1544 | local basename=${1#??} | |
1545 | echo "${1%$basename}/$basename" | |
1546 | } | |
1547 | ||
1548 | # Choose a port number based on the test script's number and store it in | |
1549 | # the given variable name, unless that variable already contains a number. | |
1550 | test_set_port () { | |
1551 | local var=$1 port | |
1552 | ||
1553 | if test $# -ne 1 || test -z "$var" | |
1554 | then | |
1555 | BUG "test_set_port requires a variable name" | |
1556 | fi | |
1557 | ||
1558 | eval port=\$$var | |
1559 | case "$port" in | |
1560 | "") | |
1561 | # No port is set in the given env var, use the test | |
1562 | # number as port number instead. | |
1563 | # Remove not only the leading 't', but all leading zeros | |
1564 | # as well, so the arithmetic below won't (mis)interpret | |
1565 | # a test number like '0123' as an octal value. | |
1566 | port=${this_test#${this_test%%[1-9]*}} | |
1567 | if test "${port:-0}" -lt 1024 | |
1568 | then | |
1569 | # root-only port, use a larger one instead. | |
1570 | port=$(($port + 10000)) | |
1571 | fi | |
1572 | ;; | |
1573 | *[!0-9]*|0*) | |
1574 | error >&7 "invalid port number: $port" | |
1575 | ;; | |
1576 | *) | |
1577 | # The user has specified the port. | |
1578 | ;; | |
1579 | esac | |
1580 | ||
1581 | # Make sure that parallel '--stress' test jobs get different | |
1582 | # ports. | |
1583 | port=$(($port + ${GIT_TEST_STRESS_JOB_NR:-0})) | |
1584 | eval $var=$port | |
1585 | } | |
1586 | ||
1587 | # Compare a file containing rev-list bitmap traversal output to its non-bitmap | |
1588 | # counterpart. You can't just use test_cmp for this, because the two produce | |
1589 | # subtly different output: | |
1590 | # | |
1591 | # - regular output is in traversal order, whereas bitmap is split by type, | |
1592 | # with non-packed objects at the end | |
1593 | # | |
1594 | # - regular output has a space and the pathname appended to non-commit | |
1595 | # objects; bitmap output omits this | |
1596 | # | |
1597 | # This function normalizes and compares the two. The second file should | |
1598 | # always be the bitmap output. | |
1599 | test_bitmap_traversal () { | |
1600 | if test "$1" = "--no-confirm-bitmaps" | |
1601 | then | |
1602 | shift | |
1603 | elif cmp "$1" "$2" | |
1604 | then | |
1605 | echo >&2 "identical raw outputs; are you sure bitmaps were used?" | |
1606 | return 1 | |
1607 | fi && | |
1608 | cut -d' ' -f1 "$1" | sort >"$1.normalized" && | |
1609 | sort "$2" >"$2.normalized" && | |
1610 | test_cmp "$1.normalized" "$2.normalized" && | |
1611 | rm -f "$1.normalized" "$2.normalized" | |
1612 | } | |
1613 | ||
1614 | # Tests for the hidden file attribute on Windows | |
1615 | test_path_is_hidden () { | |
1616 | test_have_prereq MINGW || | |
1617 | BUG "test_path_is_hidden can only be used on Windows" | |
1618 | ||
1619 | # Use the output of `attrib`, ignore the absolute path | |
1620 | case "$("$SYSTEMROOT"/system32/attrib "$1")" in *H*?:*) return 0;; esac | |
1621 | return 1 | |
1622 | } | |
1623 | ||
1624 | # Check that the given command was invoked as part of the | |
1625 | # trace2-format trace on stdin. | |
1626 | # | |
1627 | # test_subcommand [!] <command> <args>... < <trace> | |
1628 | # | |
1629 | # For example, to look for an invocation of "git upload-pack | |
1630 | # /path/to/repo" | |
1631 | # | |
1632 | # GIT_TRACE2_EVENT=event.log git fetch ... && | |
1633 | # test_subcommand git upload-pack "$PATH" <event.log | |
1634 | # | |
1635 | # If the first parameter passed is !, this instead checks that | |
1636 | # the given command was not called. | |
1637 | # | |
1638 | test_subcommand () { | |
1639 | local negate= | |
1640 | if test "$1" = "!" | |
1641 | then | |
1642 | negate=t | |
1643 | shift | |
1644 | fi | |
1645 | ||
1646 | local expr=$(printf '"%s",' "$@") | |
1647 | expr="${expr%,}" | |
1648 | ||
1649 | if test -n "$negate" | |
1650 | then | |
1651 | ! grep "\[$expr\]" | |
1652 | else | |
1653 | grep "\[$expr\]" | |
1654 | fi | |
1655 | } |