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