1#!/bin/sh 2# 3# Copyright (c) 2005 Junio C Hamano 4# 5 6# if --tee was passed, write the output not only to the terminal, but 7# additionally to the file test-results/$BASENAME.out, too. 8case"$GIT_TEST_TEE_STARTED, $* "in 9done,*) 10# do not redirect again 11;; 12*' --tee '*|*' --va'*) 13mkdir-p test-results 14 BASE=test-results/$(basename "$0" .sh) 15(GIT_TEST_TEE_STARTED=done${SHELL-sh}"$0""$@"2>&1; 16echo $? >$BASE.exit) |tee$BASE.out 17test"$(cat $BASE.exit)"=0 18exit 19;; 20esac 21 22# Keep the original TERM for say_color 23ORIGINAL_TERM=$TERM 24 25# For repeatability, reset the environment to known value. 26LANG=C 27LC_ALL=C 28PAGER=cat 29TZ=UTC 30TERM=dumb 31export LANG LC_ALL PAGER TERM TZ 32EDITOR=: 33unset VISUAL 34unset GIT_EDITOR 35unset AUTHOR_DATE 36unset AUTHOR_EMAIL 37unset AUTHOR_NAME 38unset COMMIT_AUTHOR_EMAIL 39unset COMMIT_AUTHOR_NAME 40unset EMAIL 41unset GIT_ALTERNATE_OBJECT_DIRECTORIES 42unset GIT_AUTHOR_DATE 43GIT_AUTHOR_EMAIL=author@example.com 44GIT_AUTHOR_NAME='A U Thor' 45unset GIT_COMMITTER_DATE 46GIT_COMMITTER_EMAIL=committer@example.com 47GIT_COMMITTER_NAME='C O Mitter' 48unset GIT_DIFF_OPTS 49unset GIT_DIR 50unset GIT_WORK_TREE 51unset GIT_EXTERNAL_DIFF 52unset GIT_INDEX_FILE 53unset GIT_OBJECT_DIRECTORY 54unset GIT_CEILING_DIRECTORIES 55unset SHA1_FILE_DIRECTORIES 56unset SHA1_FILE_DIRECTORY 57unset GIT_NOTES_REF 58GIT_MERGE_VERBOSITY=5 59export GIT_MERGE_VERBOSITY 60export GIT_AUTHOR_EMAIL GIT_AUTHOR_NAME 61export GIT_COMMITTER_EMAIL GIT_COMMITTER_NAME 62export EDITOR 63GIT_TEST_CMP=${GIT_TEST_CMP:-diff -u} 64 65# Protect ourselves from common misconfiguration to export 66# CDPATH into the environment 67unset CDPATH 68 69case$(echo $GIT_TRACE |tr "[A-Z]" "[a-z]")in 701|2|true) 71echo"* warning: Some tests will not work if GIT_TRACE" \ 72"is set as to trace on STDERR ! *" 73echo"* warning: Please set GIT_TRACE to something" \ 74"other than 1, 2 or true ! *" 75;; 76esac 77 78# Each test should start with something like this, after copyright notices: 79# 80# test_description='Description of this test... 81# This test checks if command xyzzy does the right thing... 82# ' 83# . ./test-lib.sh 84["x$ORIGINAL_TERM"!="xdumb"] && ( 85 TERM=$ORIGINAL_TERM&& 86export TERM && 87[-t1] && 88tput bold >/dev/null 2>&1&& 89tput setaf 1>/dev/null 2>&1&& 90tput sgr0 >/dev/null 2>&1 91) && 92 color=t 93 94whiletest"$#"-ne0 95do 96case"$1"in 97-d|--d|--de|--deb|--debu|--debug) 98 debug=t;shift;; 99-i|--i|--im|--imm|--imme|--immed|--immedi|--immedia|--immediat|--immediate) 100 immediate=t;shift;; 101-l|--l|--lo|--lon|--long|--long-|--long-t|--long-te|--long-tes|--long-test|--long-tests) 102 GIT_TEST_LONG=t;export GIT_TEST_LONG;shift;; 103-h|--h|--he|--hel|--help) 104help=t;shift;; 105-v|--v|--ve|--ver|--verb|--verbo|--verbos|--verbose) 106 verbose=t;shift;; 107-q|--q|--qu|--qui|--quie|--quiet) 108 quiet=t;shift;; 109--with-dashes) 110 with_dashes=t;shift;; 111--no-color) 112 color=;shift;; 113--no-python) 114# noop now... 115shift;; 116--va|--val|--valg|--valgr|--valgri|--valgrin|--valgrind) 117 valgrind=t; verbose=t;shift;; 118--tee) 119shift;;# was handled already 120--root=*) 121 root=$(expr "z$1" : 'z[^=]*=\(.*\)') 122 shift ;; 123 *) 124 echo "error: unknown test option '$1'" >&2; exit 1 ;; 125 esac 126done 127 128if test -n "$color"; then 129 say_color () { 130 ( 131 TERM=$ORIGINAL_TERM 132 export TERM 133 case "$1" in 134 error) tput bold; tput setaf 1;; # bold red 135 skip) tput bold; tput setaf 2;; # bold green 136 pass) tput setaf 2;; # green 137 info) tput setaf 3;; # brown 138 *) test -n "$quiet" && return;; 139 esac 140 shift 141 printf "* %s" "$*" 142 tput sgr0 143 echo 144 ) 145 } 146else 147 say_color() { 148 test -z "$1" && test -n "$quiet" && return 149 shift 150 echo "* $*" 151 } 152fi 153 154error () { 155 say_color error "error: $*" 156 GIT_EXIT_OK=t 157 exit 1 158} 159 160say () { 161 say_color info "$*" 162} 163 164test "${test_description}" != "" || 165error "Test script did not set test_description." 166 167if test "$help" = "t" 168then 169 echo "$test_description" 170 exit 0 171fi 172 173exec 5>&1 174if test "$verbose" = "t" 175then 176 exec 4>&2 3>&1 177else 178 exec 4>/dev/null 3>/dev/null 179fi 180 181test_failure=0 182test_count=0 183test_fixed=0 184test_broken=0 185test_success=0 186 187die () { 188 code=$? 189 if test -n "$GIT_EXIT_OK" 190 then 191 exit$code 192 else 193 echo >&5 "FATAL: Unexpected exit with code$code" 194 exit 1 195 fi 196} 197 198GIT_EXIT_OK= 199trap 'die' EXIT 200 201# The semantics of the editor variables are that of invoking 202# sh -c "$EDITOR\"$@\"" files ... 203# 204# If our trash directory contains shell metacharacters, they will be 205# interpreted if we just set$EDITORdirectly, so do a little dance with 206# environment variables to work around this. 207# 208# In particular, quoting isn't enough, as the path may contain the same quote 209# that we're using. 210test_set_editor () { 211 FAKE_EDITOR="$1" 212export FAKE_EDITOR 213 EDITOR='"$FAKE_EDITOR"' 214export EDITOR 215} 216 217test_decode_color () { 218sed-e's/.\[1m/<WHITE>/g' \ 219-e's/.\[31m/<RED>/g' \ 220-e's/.\[32m/<GREEN>/g' \ 221-e's/.\[33m/<YELLOW>/g' \ 222-e's/.\[34m/<BLUE>/g' \ 223-e's/.\[35m/<MAGENTA>/g' \ 224-e's/.\[36m/<CYAN>/g' \ 225-e's/.\[m/<RESET>/g' 226} 227 228test_tick () { 229iftest -z"${test_tick+set}" 230then 231 test_tick=1112911993 232else 233 test_tick=$(($test_tick + 60)) 234fi 235 GIT_COMMITTER_DATE="$test_tick-0700" 236 GIT_AUTHOR_DATE="$test_tick-0700" 237export GIT_COMMITTER_DATE GIT_AUTHOR_DATE 238} 239 240# Call test_commit with the arguments "<message> [<file> [<contents>]]" 241# 242# This will commit a file with the given contents and the given commit 243# message. It will also add a tag with <message> as name. 244# 245# Both <file> and <contents> default to <message>. 246 247test_commit () { 248file=${2:-"$1.t"} 249echo"${3-$1}">"$file"&& 250 git add "$file"&& 251 test_tick && 252 git commit -m"$1"&& 253 git tag "$1" 254} 255 256# Call test_merge with the arguments "<message> <commit>", where <commit> 257# can be a tag pointing to the commit-to-merge. 258 259test_merge () { 260 test_tick && 261 git merge -m"$1""$2"&& 262 git tag "$1" 263} 264 265# This function helps systems where core.filemode=false is set. 266# Use it instead of plain 'chmod +x' to set or unset the executable bit 267# of a file in the working directory and add it to the index. 268 269test_chmod () { 270chmod"$@"&& 271 git update-index --add"--chmod=$@" 272} 273 274# Use test_set_prereq to tell that a particular prerequisite is available. 275# The prerequisite can later be checked for in two ways: 276# 277# - Explicitly using test_have_prereq. 278# 279# - Implicitly by specifying the prerequisite tag in the calls to 280# test_expect_{success,failure,code}. 281# 282# The single parameter is the prerequisite tag (a simple word, in all 283# capital letters by convention). 284 285test_set_prereq () { 286 satisfied="$satisfied$1" 287} 288satisfied=" " 289 290test_have_prereq () { 291case$satisfiedin 292*"$1"*) 293:yes, have it ;; 294*) 295! : nope ;; 296esac 297} 298 299# You are not expected to call test_ok_ and test_failure_ directly, use 300# the text_expect_* functions instead. 301 302test_ok_ () { 303 test_success=$(($test_success + 1)) 304 say_color """ ok$test_count: $@" 305} 306 307test_failure_ () { 308 test_failure=$(($test_failure + 1)) 309 say_color error "FAIL$test_count:$1" 310shift 311echo"$@"|sed-e's/^/ /' 312test"$immediate"=""|| { GIT_EXIT_OK=t;exit1; } 313} 314 315test_known_broken_ok_ () { 316 test_fixed=$(($test_fixed+1)) 317 say_color """ FIXED$test_count: $@" 318} 319 320test_known_broken_failure_ () { 321 test_broken=$(($test_broken+1)) 322 say_color skip " still broken$test_count: $@" 323} 324 325test_debug () { 326test"$debug"=""||eval"$1" 327} 328 329test_run_ () { 330eval>&3 2>&4"$1" 331 eval_ret="$?" 332return0 333} 334 335test_skip () { 336 test_count=$(($test_count+1)) 337 to_skip= 338for skp in$GIT_SKIP_TESTS 339do 340case$this_test.$test_countin 341$skp) 342 to_skip=t 343esac 344done 345iftest -z"$to_skip"&&test -n"$prereq"&& 346! test_have_prereq "$prereq" 347then 348 to_skip=t 349fi 350case"$to_skip"in 351 t) 352 say_color skip >&3"skipping test: $@" 353 say_color skip "skip$test_count:$1" 354: true 355;; 356*) 357 false 358;; 359esac 360} 361 362test_expect_failure () { 363test"$#"=3&& { prereq=$1;shift; } || prereq= 364test"$#"=2|| 365 error "bug in the test script: not 2 or 3 parameters to test-expect-failure" 366if! test_skip "$@" 367then 368 say >&3"checking known breakage:$2" 369 test_run_ "$2" 370if["$?"=0-a"$eval_ret"=0] 371then 372 test_known_broken_ok_ "$1" 373else 374 test_known_broken_failure_ "$1" 375fi 376fi 377echo>&3"" 378} 379 380test_expect_success () { 381test"$#"=3&& { prereq=$1;shift; } || prereq= 382test"$#"=2|| 383 error "bug in the test script: not 2 or 3 parameters to test-expect-success" 384if! test_skip "$@" 385then 386 say >&3"expecting success:$2" 387 test_run_ "$2" 388if["$?"=0-a"$eval_ret"=0] 389then 390 test_ok_ "$1" 391else 392 test_failure_ "$@" 393fi 394fi 395echo>&3"" 396} 397 398test_expect_code () { 399test"$#"=4&& { prereq=$1;shift; } || prereq= 400test"$#"=3|| 401 error "bug in the test script: not 3 or 4 parameters to test-expect-code" 402if! test_skip "$@" 403then 404 say >&3"expecting exit code$1:$3" 405 test_run_ "$3" 406if["$?"=0-a"$eval_ret"="$1"] 407then 408 test_ok_ "$2" 409else 410 test_failure_ "$@" 411fi 412fi 413echo>&3"" 414} 415 416# test_external runs external test scripts that provide continuous 417# test output about their progress, and succeeds/fails on 418# zero/non-zero exit code. It outputs the test output on stdout even 419# in non-verbose mode, and announces the external script with "* run 420# <n>: ..." before running it. When providing relative paths, keep in 421# mind that all scripts run in "trash directory". 422# Usage: test_external description command arguments... 423# Example: test_external 'Perl API' perl ../path/to/test.pl 424test_external () { 425test"$#"=4&& { prereq=$1;shift; } || prereq= 426test"$#"=3|| 427 error >&5"bug in the test script: not 3 or 4 parameters to test_external" 428 descr="$1" 429shift 430if! test_skip "$descr""$@" 431then 432# Announce the script to reduce confusion about the 433# test output that follows. 434 say_color """ run$test_count:$descr($*)" 435# Run command; redirect its stderr to &4 as in 436# test_run_, but keep its stdout on our stdout even in 437# non-verbose mode. 438"$@"2>&4 439if["$?"=0] 440then 441 test_ok_ "$descr" 442else 443 test_failure_ "$descr""$@" 444fi 445fi 446} 447 448# Like test_external, but in addition tests that the command generated 449# no output on stderr. 450test_external_without_stderr () { 451# The temporary file has no (and must have no) security 452# implications. 453 tmp="$TMPDIR";if[-z"$tmp"];then tmp=/tmp;fi 454 stderr="$tmp/git-external-stderr.$$.tmp" 455 test_external "$@"4>"$stderr" 456[-f"$stderr"] || error "Internal error:$stderrdisappeared." 457 descr="no stderr:$1" 458shift 459 say >&3"expecting no stderr from previous command" 460if[ !-s"$stderr"];then 461rm"$stderr" 462 test_ok_ "$descr" 463else 464if["$verbose"= t ];then 465 output=`echo; echo Stderr is:; cat "$stderr"` 466else 467 output= 468fi 469# rm first in case test_failure exits. 470rm"$stderr" 471 test_failure_ "$descr""$@""$output" 472fi 473} 474 475# This is not among top-level (test_expect_success | test_expect_failure) 476# but is a prefix that can be used in the test script, like: 477# 478# test_expect_success 'complain and die' ' 479# do something && 480# do something else && 481# test_must_fail git checkout ../outerspace 482# ' 483# 484# Writing this as "! git checkout ../outerspace" is wrong, because 485# the failure could be due to a segv. We want a controlled failure. 486 487test_must_fail () { 488"$@" 489test $? -gt0-a $? -le129-o $? -gt192 490} 491 492# test_cmp is a helper function to compare actual and expected output. 493# You can use it like: 494# 495# test_expect_success 'foo works' ' 496# echo expected >expected && 497# foo >actual && 498# test_cmp expected actual 499# ' 500# 501# This could be written as either "cmp" or "diff -u", but: 502# - cmp's output is not nearly as easy to read as diff -u 503# - not all diff versions understand "-u" 504 505test_cmp() { 506$GIT_TEST_CMP"$@" 507} 508 509# Most tests can use the created repository, but some may need to create more. 510# Usage: test_create_repo <directory> 511test_create_repo () { 512test"$#"=1|| 513 error "bug in the test script: not 1 parameter to test-create-repo" 514 owd=`pwd` 515 repo="$1" 516mkdir-p"$repo" 517cd"$repo"|| error "Cannot setup test environment" 518"$GIT_EXEC_PATH/git-init""--template=$TEST_DIRECTORY/../templates/blt/">&3 2>&4|| 519 error "cannot run git init -- have you built things yet?" 520mv .git/hooks .git/hooks-disabled 521cd"$owd" 522} 523 524test_done () { 525 GIT_EXIT_OK=t 526 test_results_dir="$TEST_DIRECTORY/test-results" 527mkdir-p"$test_results_dir" 528 test_results_path="$test_results_dir/${0%.sh}-$$" 529 530echo"total$test_count">>$test_results_path 531echo"success$test_success">>$test_results_path 532echo"fixed$test_fixed">>$test_results_path 533echo"broken$test_broken">>$test_results_path 534echo"failed$test_failure">>$test_results_path 535echo"">>$test_results_path 536 537iftest"$test_fixed"!=0 538then 539 say_color pass "fixed$test_fixedknown breakage(s)" 540fi 541iftest"$test_broken"!=0 542then 543 say_color error "still have$test_brokenknown breakage(s)" 544 msg="remaining$(($test_count-$test_broken)) test(s)" 545else 546 msg="$test_counttest(s)" 547fi 548case"$test_failure"in 5490) 550 say_color pass "passed all$msg" 551 552test -d"$remove_trash"&& 553cd"$(dirname "$remove_trash")"&& 554rm-rf"$(basename "$remove_trash")" 555 556exit0;; 557 558*) 559 say_color error "failed$test_failureamong$msg" 560exit1;; 561 562esac 563} 564 565# Test the binaries we have just built. The tests are kept in 566# t/ subdirectory and are run in 'trash directory' subdirectory. 567TEST_DIRECTORY=$(pwd) 568iftest -n"$valgrind" 569then 570 make_symlink () { 571test -h"$2"&& 572test"$1"="$(readlink "$2")"|| { 573# be super paranoid 574ifmkdir"$2".lock 575then 576rm-f"$2"&& 577ln-s"$1""$2"&& 578rm-r"$2".lock 579else 580whiletest -d"$2".lock 581do 582 say "Waiting for lock on$2." 583sleep1 584done 585fi 586} 587} 588 589 make_valgrind_symlink () { 590# handle only executables 591test -x"$1"||return 592 593 base=$(basename "$1") 594 symlink_target=$TEST_DIRECTORY/../$base 595# do not override scripts 596iftest -x"$symlink_target"&& 597test!-d"$symlink_target"&& 598test"#!"!="$(head -c 2 < "$symlink_target")" 599then 600 symlink_target=../valgrind.sh 601fi 602case"$base"in 603*.sh|*.perl) 604 symlink_target=../unprocessed-script 605esac 606# create the link, or replace it if it is out of date 607 make_symlink "$symlink_target""$GIT_VALGRIND/bin/$base"||exit 608} 609 610# override all git executables in TEST_DIRECTORY/.. 611 GIT_VALGRIND=$TEST_DIRECTORY/valgrind 612mkdir-p"$GIT_VALGRIND"/bin 613forfilein$TEST_DIRECTORY/../git*$TEST_DIRECTORY/../test-* 614do 615 make_valgrind_symlink $file 616done 617 OLDIFS=$IFS 618 IFS=: 619for path in$PATH 620do 621ls"$path"/git-*2> /dev/null | 622whilereadfile 623do 624 make_valgrind_symlink "$file" 625done 626done 627 IFS=$OLDIFS 628 PATH=$GIT_VALGRIND/bin:$PATH 629 GIT_EXEC_PATH=$GIT_VALGRIND/bin 630export GIT_VALGRIND 631eliftest -n"$GIT_TEST_INSTALLED";then 632 GIT_EXEC_PATH=$($GIT_TEST_INSTALLED/git --exec-path)|| 633 error "Cannot run git from$GIT_TEST_INSTALLED." 634 PATH=$GIT_TEST_INSTALLED:$TEST_DIRECTORY/..:$PATH 635 GIT_EXEC_PATH=${GIT_TEST_EXEC_PATH:-$GIT_EXEC_PATH} 636else# normal case, use ../bin-wrappers only unless $with_dashes: 637 git_bin_dir="$TEST_DIRECTORY/../bin-wrappers" 638if!test -x"$git_bin_dir/git";then 639iftest -z"$with_dashes";then 640 say "$git_bin_dir/git is not executable; using GIT_EXEC_PATH" 641fi 642 with_dashes=t 643fi 644 PATH="$git_bin_dir:$PATH" 645 GIT_EXEC_PATH=$TEST_DIRECTORY/.. 646iftest -n"$with_dashes";then 647 PATH="$TEST_DIRECTORY/..:$PATH" 648fi 649fi 650GIT_TEMPLATE_DIR=$(pwd)/../templates/blt 651unset GIT_CONFIG 652GIT_CONFIG_NOSYSTEM=1 653GIT_CONFIG_NOGLOBAL=1 654export PATH GIT_EXEC_PATH GIT_TEMPLATE_DIR GIT_CONFIG_NOSYSTEM GIT_CONFIG_NOGLOBAL 655 656. ../GIT-BUILD-OPTIONS 657 658GITPERLLIB=$(pwd)/../perl/blib/lib:$(pwd)/../perl/blib/arch/auto/Git 659export GITPERLLIB 660test -d ../templates/blt || { 661 error "You haven't built things yet, have you?" 662} 663 664iftest -z"$GIT_TEST_INSTALLED"&&test -z"$NO_PYTHON" 665then 666 GITPYTHONLIB="$(pwd)/../git_remote_helpers/build/lib" 667export GITPYTHONLIB 668test -d ../git_remote_helpers/build || { 669 error "You haven't built git_remote_helpers yet, have you?" 670} 671fi 672 673if!test -x ../test-chmtime;then 674echo>&2'You need to build test-chmtime:' 675echo>&2'Run "make test-chmtime" in the source (toplevel) directory' 676exit1 677fi 678 679# Test repository 680test="trash directory.$(basename "$0" .sh)" 681test -n"$root"&&test="$root/$test" 682case"$test"in 683/*) TRASH_DIRECTORY="$test";; 684*) TRASH_DIRECTORY="$TEST_DIRECTORY/$test";; 685esac 686test!-z"$debug"|| remove_trash=$TRASH_DIRECTORY 687rm-fr"$test"|| { 688 GIT_EXIT_OK=t 689echo>&5"FATAL: Cannot prepare test area" 690exit1 691} 692 693test_create_repo "$test" 694# Use -P to resolve symlinks in our working directory so that the cwd 695# in subprocesses like git equals our $PWD (for pathname comparisons). 696cd -P"$test"||exit1 697 698this_test=${0##*/} 699this_test=${this_test%%-*} 700for skp in$GIT_SKIP_TESTS 701do 702 to_skip= 703for skp in$GIT_SKIP_TESTS 704do 705case"$this_test"in 706$skp) 707 to_skip=t 708esac 709done 710case"$to_skip"in 711 t) 712 say_color skip >&3"skipping test$this_testaltogether" 713 say_color skip "skip all tests in$this_test" 714 test_done 715esac 716done 717 718# Provide an implementation of the 'yes' utility 719yes() { 720iftest$#=0 721then 722 y=y 723else 724 y="$*" 725fi 726 727whileecho"$y" 728do 729: 730done 731} 732 733# Fix some commands on Windows 734case$(uname -s)in 735*MINGW*) 736# Windows has its own (incompatible) sort and find 737sort() { 738/usr/bin/sort"$@" 739} 740find() { 741/usr/bin/find"$@" 742} 743sum() { 744md5sum"$@" 745} 746# git sees Windows-style pwd 747pwd() { 748builtin pwd -W 749} 750# no POSIX permissions 751# backslashes in pathspec are converted to '/' 752# exec does not inherit the PID 753;; 754*) 755 test_set_prereq POSIXPERM 756 test_set_prereq BSLASHPSPEC 757 test_set_prereq EXECKEEPSPID 758;; 759esac 760 761test -z"$NO_PERL"&& test_set_prereq PERL 762test -z"$NO_PYTHON"&& test_set_prereq PYTHON 763 764# test whether the filesystem supports symbolic links 765ln-s x y 2>/dev/null &&test -h y 2>/dev/null && test_set_prereq SYMLINKS 766rm-f y