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=: 33VISUAL=: 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 VISUAL 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*) 118break;; 119esac 120done 121 122iftest -n"$color";then 123 say_color () { 124( 125 TERM=$ORIGINAL_TERM 126export TERM 127case"$1"in 128 error)tput bold;tput setaf 1;;# bold red 129 skip)tput bold;tput setaf 2;;# bold green 130 pass)tput setaf 2;;# green 131 info)tput setaf 3;;# brown 132*)test -n"$quiet"&&return;; 133esac 134shift 135printf"* %s""$*" 136tput sgr0 137echo 138) 139} 140else 141 say_color() { 142test -z"$1"&&test -n"$quiet"&&return 143shift 144echo"* $*" 145} 146fi 147 148error () { 149 say_color error "error: $*" 150trap- EXIT 151exit1 152} 153 154say () { 155 say_color info "$*" 156} 157 158test"${test_description}"!=""|| 159error "Test script did not set test_description." 160 161iftest"$help"="t" 162then 163echo"$test_description" 164exit0 165fi 166 167exec5>&1 168iftest"$verbose"="t" 169then 170exec4>&2 3>&1 171else 172exec4>/dev/null 3>/dev/null 173fi 174 175test_failure=0 176test_count=0 177test_fixed=0 178test_broken=0 179test_success=0 180 181die () { 182echo>&5"FATAL: Unexpected exit with code $?" 183exit1 184} 185 186trap'die' EXIT 187 188# The semantics of the editor variables are that of invoking 189# sh -c "$EDITOR \"$@\"" files ... 190# 191# If our trash directory contains shell metacharacters, they will be 192# interpreted if we just set $EDITOR directly, so do a little dance with 193# environment variables to work around this. 194# 195# In particular, quoting isn't enough, as the path may contain the same quote 196# that we're using. 197test_set_editor () { 198 FAKE_EDITOR="$1" 199export FAKE_EDITOR 200 VISUAL='"$FAKE_EDITOR"' 201export VISUAL 202} 203 204test_tick () { 205iftest -z"${test_tick+set}" 206then 207 test_tick=1112911993 208else 209 test_tick=$(($test_tick + 60)) 210fi 211 GIT_COMMITTER_DATE="$test_tick-0700" 212 GIT_AUTHOR_DATE="$test_tick-0700" 213export GIT_COMMITTER_DATE GIT_AUTHOR_DATE 214} 215 216# Call test_commit with the arguments "<message> [<file> [<contents>]]" 217# 218# This will commit a file with the given contents and the given commit 219# message. It will also add a tag with <message> as name. 220# 221# Both <file> and <contents> default to <message>. 222 223test_commit () { 224file=${2:-"$1.t"} 225echo"${3-$1}">"$file"&& 226 git add "$file"&& 227 test_tick && 228 git commit -m"$1"&& 229 git tag "$1" 230} 231 232# Call test_merge with the arguments "<message> <commit>", where <commit> 233# can be a tag pointing to the commit-to-merge. 234 235test_merge () { 236 test_tick && 237 git merge -m"$1""$2"&& 238 git tag "$1" 239} 240 241# You are not expected to call test_ok_ and test_failure_ directly, use 242# the text_expect_* functions instead. 243 244test_ok_ () { 245 test_count=$(($test_count + 1)) 246 test_success=$(($test_success + 1)) 247 say_color """ ok$test_count: $@" 248} 249 250test_failure_ () { 251 test_count=$(($test_count + 1)) 252 test_failure=$(($test_failure + 1)) 253 say_color error "FAIL$test_count:$1" 254shift 255echo"$@"|sed-e's/^/ /' 256test"$immediate"=""|| {trap- EXIT;exit1; } 257} 258 259test_known_broken_ok_ () { 260 test_count=$(($test_count+1)) 261 test_fixed=$(($test_fixed+1)) 262 say_color """ FIXED$test_count: $@" 263} 264 265test_known_broken_failure_ () { 266 test_count=$(($test_count+1)) 267 test_broken=$(($test_broken+1)) 268 say_color skip " still broken$test_count: $@" 269} 270 271test_debug () { 272test"$debug"=""||eval"$1" 273} 274 275test_run_ () { 276eval>&3 2>&4"$1" 277 eval_ret="$?" 278return0 279} 280 281test_skip () { 282 to_skip= 283for skp in$GIT_SKIP_TESTS 284do 285case$this_test.$(($test_count+1))in 286$skp) 287 to_skip=t 288esac 289done 290case"$to_skip"in 291 t) 292 say_color skip >&3"skipping test: $@" 293 test_count=$(($test_count+1)) 294 say_color skip "skip$test_count:$1" 295: true 296;; 297*) 298 false 299;; 300esac 301} 302 303test_expect_failure () { 304test"$#"=2|| 305 error "bug in the test script: not 2 parameters to test-expect-failure" 306if! test_skip "$@" 307then 308 say >&3"checking known breakage:$2" 309 test_run_ "$2" 310if["$?"=0-a"$eval_ret"=0] 311then 312 test_known_broken_ok_ "$1" 313else 314 test_known_broken_failure_ "$1" 315fi 316fi 317echo>&3"" 318} 319 320test_expect_success () { 321test"$#"=2|| 322 error "bug in the test script: not 2 parameters to test-expect-success" 323if! test_skip "$@" 324then 325 say >&3"expecting success:$2" 326 test_run_ "$2" 327if["$?"=0-a"$eval_ret"=0] 328then 329 test_ok_ "$1" 330else 331 test_failure_ "$@" 332fi 333fi 334echo>&3"" 335} 336 337test_expect_code () { 338test"$#"=3|| 339 error "bug in the test script: not 3 parameters to test-expect-code" 340if! test_skip "$@" 341then 342 say >&3"expecting exit code$1:$3" 343 test_run_ "$3" 344if["$?"=0-a"$eval_ret"="$1"] 345then 346 test_ok_ "$2" 347else 348 test_failure_ "$@" 349fi 350fi 351echo>&3"" 352} 353 354# test_external runs external test scripts that provide continuous 355# test output about their progress, and succeeds/fails on 356# zero/non-zero exit code. It outputs the test output on stdout even 357# in non-verbose mode, and announces the external script with "* run 358# <n>: ..." before running it. When providing relative paths, keep in 359# mind that all scripts run in "trash directory". 360# Usage: test_external description command arguments... 361# Example: test_external 'Perl API' perl ../path/to/test.pl 362test_external () { 363test"$#"-eq3|| 364 error >&5"bug in the test script: not 3 parameters to test_external" 365 descr="$1" 366shift 367if! test_skip "$descr""$@" 368then 369# Announce the script to reduce confusion about the 370# test output that follows. 371 say_color """ run$(($test_count+1)):$descr($*)" 372# Run command; redirect its stderr to &4 as in 373# test_run_, but keep its stdout on our stdout even in 374# non-verbose mode. 375"$@"2>&4 376if["$?"=0] 377then 378 test_ok_ "$descr" 379else 380 test_failure_ "$descr""$@" 381fi 382fi 383} 384 385# Like test_external, but in addition tests that the command generated 386# no output on stderr. 387test_external_without_stderr () { 388# The temporary file has no (and must have no) security 389# implications. 390 tmp="$TMPDIR";if[-z"$tmp"];then tmp=/tmp;fi 391 stderr="$tmp/git-external-stderr.$$.tmp" 392 test_external "$@"4>"$stderr" 393[-f"$stderr"] || error "Internal error:$stderrdisappeared." 394 descr="no stderr:$1" 395shift 396 say >&3"expecting no stderr from previous command" 397if[ !-s"$stderr"];then 398rm"$stderr" 399 test_ok_ "$descr" 400else 401if["$verbose"= t ];then 402 output=`echo; echo Stderr is:; cat "$stderr"` 403else 404 output= 405fi 406# rm first in case test_failure exits. 407rm"$stderr" 408 test_failure_ "$descr""$@""$output" 409fi 410} 411 412# This is not among top-level (test_expect_success | test_expect_failure) 413# but is a prefix that can be used in the test script, like: 414# 415# test_expect_success 'complain and die' ' 416# do something && 417# do something else && 418# test_must_fail git checkout ../outerspace 419# ' 420# 421# Writing this as "! git checkout ../outerspace" is wrong, because 422# the failure could be due to a segv. We want a controlled failure. 423 424test_must_fail () { 425"$@" 426test $? -gt0-a $? -le129-o $? -gt192 427} 428 429# test_cmp is a helper function to compare actual and expected output. 430# You can use it like: 431# 432# test_expect_success 'foo works' ' 433# echo expected >expected && 434# foo >actual && 435# test_cmp expected actual 436# ' 437# 438# This could be written as either "cmp" or "diff -u", but: 439# - cmp's output is not nearly as easy to read as diff -u 440# - not all diff versions understand "-u" 441 442test_cmp() { 443$GIT_TEST_CMP"$@" 444} 445 446# Most tests can use the created repository, but some may need to create more. 447# Usage: test_create_repo <directory> 448test_create_repo () { 449test"$#"=1|| 450 error "bug in the test script: not 1 parameter to test-create-repo" 451 owd=`pwd` 452 repo="$1" 453mkdir-p"$repo" 454cd"$repo"|| error "Cannot setup test environment" 455"$GIT_EXEC_PATH/git" init "--template=$owd/../templates/blt/">&3 2>&4|| 456 error "cannot run git init -- have you built things yet?" 457mv .git/hooks .git/hooks-disabled 458cd"$owd" 459} 460 461test_done () { 462trap- EXIT 463 test_results_dir="$TEST_DIRECTORY/test-results" 464mkdir-p"$test_results_dir" 465 test_results_path="$test_results_dir/${0%.sh}-$$" 466 467echo"total$test_count">>$test_results_path 468echo"success$test_success">>$test_results_path 469echo"fixed$test_fixed">>$test_results_path 470echo"broken$test_broken">>$test_results_path 471echo"failed$test_failure">>$test_results_path 472echo"">>$test_results_path 473 474iftest"$test_fixed"!=0 475then 476 say_color pass "fixed$test_fixedknown breakage(s)" 477fi 478iftest"$test_broken"!=0 479then 480 say_color error "still have$test_brokenknown breakage(s)" 481 msg="remaining$(($test_count-$test_broken)) test(s)" 482else 483 msg="$test_counttest(s)" 484fi 485case"$test_failure"in 4860) 487# We could: 488# cd .. && rm -fr 'trash directory' 489# but that means we forbid any tests that use their own 490# subdirectory from calling test_done without coming back 491# to where they started from. 492# The Makefile provided will clean this test area so 493# we will leave things as they are. 494 495 say_color pass "passed all$msg" 496 497test -d"$remove_trash"&& 498cd"$(dirname "$remove_trash")"&& 499rm-rf"$(basename "$remove_trash")" 500 501exit0;; 502 503*) 504 say_color error "failed$test_failureamong$msg" 505exit1;; 506 507esac 508} 509 510# Test the binaries we have just built. The tests are kept in 511# t/ subdirectory and are run in 'trash directory' subdirectory. 512TEST_DIRECTORY=$(pwd) 513iftest -z"$valgrind" 514then 515 PATH=$TEST_DIRECTORY/..:$PATH 516 GIT_EXEC_PATH=$TEST_DIRECTORY/.. 517else 518 make_symlink () { 519test -h"$2"&& 520test"$1"="$(readlink "$2")"|| { 521# be super paranoid 522ifmkdir"$2".lock 523then 524rm-f"$2"&& 525ln-s"$1""$2"&& 526rm-r"$2".lock 527else 528whiletest -d"$2".lock 529do 530 say "Waiting for lock on$2." 531sleep1 532done 533fi 534} 535} 536 537 make_valgrind_symlink () { 538# handle only executables 539test -x"$1"||return 540 541 base=$(basename "$1") 542 symlink_target=$TEST_DIRECTORY/../$base 543# do not override scripts 544iftest -x"$symlink_target"&& 545test!-d"$symlink_target"&& 546test"#!"!="$(head -c 2 < "$symlink_target")" 547then 548 symlink_target=../valgrind.sh 549fi 550case"$base"in 551*.sh|*.perl) 552 symlink_target=../unprocessed-script 553esac 554# create the link, or replace it if it is out of date 555 make_symlink "$symlink_target""$GIT_VALGRIND/bin/$base"||exit 556} 557 558# override all git executables in TEST_DIRECTORY/.. 559 GIT_VALGRIND=$TEST_DIRECTORY/valgrind 560mkdir-p"$GIT_VALGRIND"/bin 561forfilein$TEST_DIRECTORY/../git*$TEST_DIRECTORY/../test-* 562do 563 make_valgrind_symlink $file 564done 565 OLDIFS=$IFS 566 IFS=: 567for path in$PATH 568do 569ls"$path"/git-*2> /dev/null | 570whilereadfile 571do 572 make_valgrind_symlink "$file" 573done 574done 575 IFS=$OLDIFS 576 PATH=$GIT_VALGRIND/bin:$PATH 577 GIT_EXEC_PATH=$GIT_VALGRIND/bin 578export GIT_VALGRIND 579fi 580GIT_TEMPLATE_DIR=$(pwd)/../templates/blt 581unset GIT_CONFIG 582GIT_CONFIG_NOSYSTEM=1 583GIT_CONFIG_NOGLOBAL=1 584export PATH GIT_EXEC_PATH GIT_TEMPLATE_DIR GIT_CONFIG_NOSYSTEM GIT_CONFIG_NOGLOBAL 585 586GITPERLLIB=$(pwd)/../perl/blib/lib:$(pwd)/../perl/blib/arch/auto/Git 587export GITPERLLIB 588test -d ../templates/blt || { 589 error "You haven't built things yet, have you?" 590} 591 592if!test -x ../test-chmtime;then 593echo>&2'You need to build test-chmtime:' 594echo>&2'Run "make test-chmtime" in the source (toplevel) directory' 595exit1 596fi 597 598. ../GIT-BUILD-OPTIONS 599 600# Test repository 601test="trash directory.$(basename "$0" .sh)" 602test!-z"$debug"|| remove_trash="$TEST_DIRECTORY/$test" 603rm-fr"$test"|| { 604trap- EXIT 605echo>&5"FATAL: Cannot prepare test area" 606exit1 607} 608 609test_create_repo "$test" 610# Use -P to resolve symlinks in our working directory so that the cwd 611# in subprocesses like git equals our $PWD (for pathname comparisons). 612cd -P"$test"||exit1 613 614this_test=${0##*/} 615this_test=${this_test%%-*} 616for skp in$GIT_SKIP_TESTS 617do 618 to_skip= 619for skp in$GIT_SKIP_TESTS 620do 621case"$this_test"in 622$skp) 623 to_skip=t 624esac 625done 626case"$to_skip"in 627 t) 628 say_color skip >&3"skipping test$this_testaltogether" 629 say_color skip "skip all tests in$this_test" 630 test_done 631esac 632done