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