t/t9902-completion.sh

   1 #!/bin/sh
   2 #
   3 # Copyright (c) 2012 Felipe Contreras
   4 #
   5
   6 test_description='test bash completion'
   7
   8 . ./lib-bash.sh
   9
  10 complete ()
  11 {
  12         # do nothing
  13         return 0
  14 }
  15
  16 # Be careful when updating this list:
  17 #
  18 # (1) The build tree may have build artifact from different branch, or
  19 #     the user's $PATH may have a random executable that may begin
  20 #     with "git-check" that are not part of the subcommands this build
  21 #     will ship, e.g.  "check-ignore".  The tests for completion for
  22 #     subcommand names tests how "check" is expanded; we limit the
  23 #     possible candidates to "checkout" and "check-attr" to make sure
  24 #     "check-attr", which is known by the filter function as a
  25 #     subcommand to be thrown out, while excluding other random files
  26 #     that happen to begin with "check" to avoid letting them get in
  27 #     the way.
  28 #
  29 # (2) A test makes sure that common subcommands are included in the
  30 #     completion for "git <TAB>", and a plumbing is excluded.  "add",
  31 #     "filter-branch" and "ls-files" are listed for this.
  32
  33 GIT_TESTING_COMMAND_COMPLETION='add checkout check-attr filter-branch ls-files'
  34
  35 . "$GIT_BUILD_DIR/contrib/completion/git-completion.bash"
  36
  37 # We don't need this function to actually join words or do anything special.
  38 # Also, it's cleaner to avoid touching bash's internal completion variables.
  39 # So let's override it with a minimal version for testing purposes.
  40 _get_comp_words_by_ref ()
  41 {
  42         while [ $# -gt 0 ]; do
  43                 case "$1" in
  44                 cur)
  45                         cur=${_words[_cword]}
  46                         ;;
  47                 prev)
  48                         prev=${_words[_cword-1]}
  49                         ;;
  50                 words)
  51                         words=("${_words[@]}")
  52                         ;;
  53                 cword)
  54                         cword=$_cword
  55                         ;;
  56                 esac
  57                 shift
  58         done
  59 }
  60
  61 print_comp ()
  62 {
  63         local IFS=$'\n'
  64         echo "${COMPREPLY[*]}" > out
  65 }
  66
  67 run_completion ()
  68 {
  69         local -a COMPREPLY _words
  70         local _cword
  71         _words=( $1 )
  72         test "${1: -1}" = ' ' && _words[${#_words[@]}+1]=''
  73         (( _cword = ${#_words[@]} - 1 ))
  74         __git_wrap__git_main && print_comp
  75 }
  76
  77 # Test high-level completion
  78 # Arguments are:
  79 # 1: typed text so far (cur)
  80 # 2: expected completion
  81 test_completion ()
  82 {
  83         if test $# -gt 1
  84         then
  85                 printf '%s\n' "$2" >expected
  86         else
  87                 sed -e 's/Z$//' >expected
  88         fi &&
  89         run_completion "$1" &&
  90         test_cmp expected out
  91 }
  92
  93 # Test __gitcomp.
  94 # The first argument is the typed text so far (cur); the rest are
  95 # passed to __gitcomp.  Expected output comes is read from the
  96 # standard input, like test_completion().
  97 test_gitcomp ()
  98 {
  99         local -a COMPREPLY &&
 100         sed -e 's/Z$//' >expected &&
 101         cur="$1" &&
 102         shift &&
 103         __gitcomp "$@" &&
 104         print_comp &&
 105         test_cmp expected out
 106 }
 107
 108 # Test __gitcomp_nl
 109 # Arguments are:
 110 # 1: current word (cur)
 111 # -: the rest are passed to __gitcomp_nl
 112 test_gitcomp_nl ()
 113 {
 114         local -a COMPREPLY &&
 115         sed -e 's/Z$//' >expected &&
 116         cur="$1" &&
 117         shift &&
 118         __gitcomp_nl "$@" &&
 119         print_comp &&
 120         test_cmp expected out
 121 }
 122
 123 invalid_variable_name='${foo.bar}'
 124
 125 actual="$TRASH_DIRECTORY/actual"
 126
 127 test_expect_success 'setup for __gitdir tests' '
 128         mkdir -p subdir/subsubdir &&
 129         git init otherrepo
 130 '
 131
 132 test_expect_success '__gitdir - from command line (through $__git_dir)' '
 133         echo "$TRASH_DIRECTORY/otherrepo/.git" >expected &&
 134         (
 135                 __git_dir="$TRASH_DIRECTORY/otherrepo/.git" &&
 136                 __gitdir >"$actual"
 137         ) &&
 138         test_cmp expected "$actual"
 139 '
 140
 141 test_expect_success '__gitdir - repo as argument' '
 142         echo "otherrepo/.git" >expected &&
 143         __gitdir "otherrepo" >"$actual" &&
 144         test_cmp expected "$actual"
 145 '
 146
 147 test_expect_success '__gitdir - remote as argument' '
 148         echo "remote" >expected &&
 149         __gitdir "remote" >"$actual" &&
 150         test_cmp expected "$actual"
 151 '
 152
 153 test_expect_success '__gitdir - .git directory in cwd' '
 154         echo ".git" >expected &&
 155         __gitdir >"$actual" &&
 156         test_cmp expected "$actual"
 157 '
 158
 159 test_expect_success '__gitdir - .git directory in parent' '
 160         echo "$(pwd -P)/.git" >expected &&
 161         (
 162                 cd subdir/subsubdir &&
 163                 __gitdir >"$actual"
 164         ) &&
 165         test_cmp expected "$actual"
 166 '
 167
 168 test_expect_success '__gitdir - cwd is a .git directory' '
 169         echo "." >expected &&
 170         (
 171                 cd .git &&
 172                 __gitdir >"$actual"
 173         ) &&
 174         test_cmp expected "$actual"
 175 '
 176
 177 test_expect_success '__gitdir - parent is a .git directory' '
 178         echo "$(pwd -P)/.git" >expected &&
 179         (
 180                 cd .git/refs/heads &&
 181                 __gitdir >"$actual"
 182         ) &&
 183         test_cmp expected "$actual"
 184 '
 185
 186 test_expect_success '__gitdir - $GIT_DIR set while .git directory in cwd' '
 187         echo "$TRASH_DIRECTORY/otherrepo/.git" >expected &&
 188         (
 189                 GIT_DIR="$TRASH_DIRECTORY/otherrepo/.git" &&
 190                 export GIT_DIR &&
 191                 __gitdir >"$actual"
 192         ) &&
 193         test_cmp expected "$actual"
 194 '
 195
 196 test_expect_success '__gitdir - $GIT_DIR set while .git directory in parent' '
 197         echo "$TRASH_DIRECTORY/otherrepo/.git" >expected &&
 198         (
 199                 GIT_DIR="$TRASH_DIRECTORY/otherrepo/.git" &&
 200                 export GIT_DIR &&
 201                 cd subdir &&
 202                 __gitdir >"$actual"
 203         ) &&
 204         test_cmp expected "$actual"
 205 '
 206
 207 test_expect_success '__gitdir - non-existing $GIT_DIR' '
 208         (
 209                 GIT_DIR="$TRASH_DIRECTORY/non-existing" &&
 210                 export GIT_DIR &&
 211                 test_must_fail __gitdir
 212         )
 213 '
 214
 215 function pwd_P_W () {
 216         if test_have_prereq MINGW
 217         then
 218                 pwd -W
 219         else
 220                 pwd -P
 221         fi
 222 }
 223
 224 test_expect_success '__gitdir - gitfile in cwd' '
 225         echo "$(pwd_P_W)/otherrepo/.git" >expected &&
 226         echo "gitdir: $(pwd_P_W)/otherrepo/.git" >subdir/.git &&
 227         test_when_finished "rm -f subdir/.git" &&
 228         (
 229                 cd subdir &&
 230                 __gitdir >"$actual"
 231         ) &&
 232         test_cmp expected "$actual"
 233 '
 234
 235 test_expect_success '__gitdir - gitfile in parent' '
 236         echo "$(pwd_P_W)/otherrepo/.git" >expected &&
 237         echo "gitdir: $(pwd_P_W)/otherrepo/.git" >subdir/.git &&
 238         test_when_finished "rm -f subdir/.git" &&
 239         (
 240                 cd subdir/subsubdir &&
 241                 __gitdir >"$actual"
 242         ) &&
 243         test_cmp expected "$actual"
 244 '
 245
 246 test_expect_success SYMLINKS '__gitdir - resulting path avoids symlinks' '
 247         echo "$(pwd -P)/otherrepo/.git" >expected &&
 248         mkdir otherrepo/dir &&
 249         test_when_finished "rm -rf otherrepo/dir" &&
 250         ln -s otherrepo/dir link &&
 251         test_when_finished "rm -f link" &&
 252         (
 253                 cd link &&
 254                 __gitdir >"$actual"
 255         ) &&
 256         test_cmp expected "$actual"
 257 '
 258
 259 test_expect_success '__gitdir - not a git repository' '
 260         (
 261                 cd subdir/subsubdir &&
 262                 GIT_CEILING_DIRECTORIES="$TRASH_DIRECTORY" &&
 263                 export GIT_CEILING_DIRECTORIES &&
 264                 test_must_fail __gitdir
 265         )
 266 '
 267
 268 test_expect_success '__gitcomp - trailing space - options' '
 269         test_gitcomp "--re" "--dry-run --reuse-message= --reedit-message=
 270                 --reset-author" <<-EOF
 271         --reuse-message=Z
 272         --reedit-message=Z
 273         --reset-author Z
 274         EOF
 275 '
 276
 277 test_expect_success '__gitcomp - trailing space - config keys' '
 278         test_gitcomp "br" "branch. branch.autosetupmerge
 279                 branch.autosetuprebase browser." <<-\EOF
 280         branch.Z
 281         branch.autosetupmerge Z
 282         branch.autosetuprebase Z
 283         browser.Z
 284         EOF
 285 '
 286
 287 test_expect_success '__gitcomp - option parameter' '
 288         test_gitcomp "--strategy=re" "octopus ours recursive resolve subtree" \
 289                 "" "re" <<-\EOF
 290         recursive Z
 291         resolve Z
 292         EOF
 293 '
 294
 295 test_expect_success '__gitcomp - prefix' '
 296         test_gitcomp "branch.me" "remote merge mergeoptions rebase" \
 297                 "branch.maint." "me" <<-\EOF
 298         branch.maint.merge Z
 299         branch.maint.mergeoptions Z
 300         EOF
 301 '
 302
 303 test_expect_success '__gitcomp - suffix' '
 304         test_gitcomp "branch.me" "master maint next pu" "branch." \
 305                 "ma" "." <<-\EOF
 306         branch.master.Z
 307         branch.maint.Z
 308         EOF
 309 '
 310
 311 test_expect_success '__gitcomp - doesnt fail because of invalid variable name' '
 312         __gitcomp "$invalid_variable_name"
 313 '
 314
 315 read -r -d "" refs <<-\EOF
 316 maint
 317 master
 318 next
 319 pu
 320 EOF
 321
 322 test_expect_success '__gitcomp_nl - trailing space' '
 323         test_gitcomp_nl "m" "$refs" <<-EOF
 324         maint Z
 325         master Z
 326         EOF
 327 '
 328
 329 test_expect_success '__gitcomp_nl - prefix' '
 330         test_gitcomp_nl "--fixup=m" "$refs" "--fixup=" "m" <<-EOF
 331         --fixup=maint Z
 332         --fixup=master Z
 333         EOF
 334 '
 335
 336 test_expect_success '__gitcomp_nl - suffix' '
 337         test_gitcomp_nl "branch.ma" "$refs" "branch." "ma" "." <<-\EOF
 338         branch.maint.Z
 339         branch.master.Z
 340         EOF
 341 '
 342
 343 test_expect_success '__gitcomp_nl - no suffix' '
 344         test_gitcomp_nl "ma" "$refs" "" "ma" "" <<-\EOF
 345         maintZ
 346         masterZ
 347         EOF
 348 '
 349
 350 test_expect_success '__gitcomp_nl - doesnt fail because of invalid variable name' '
 351         __gitcomp_nl "$invalid_variable_name"
 352 '
 353
 354 test_expect_success '__git_remotes - list remotes from $GIT_DIR/remotes and from config file' '
 355         cat >expect <<-EOF &&
 356         remote_from_file_1
 357         remote_from_file_2
 358         remote_in_config_1
 359         remote_in_config_2
 360         EOF
 361         test_when_finished "rm -rf .git/remotes" &&
 362         mkdir -p .git/remotes &&
 363         >.git/remotes/remote_from_file_1 &&
 364         >.git/remotes/remote_from_file_2 &&
 365         test_when_finished "git remote remove remote_in_config_1" &&
 366         git remote add remote_in_config_1 git://remote_1 &&
 367         test_when_finished "git remote remove remote_in_config_2" &&
 368         git remote add remote_in_config_2 git://remote_2 &&
 369         __git_remotes >actual &&
 370         test_cmp expect actual
 371 '
 372
 373 test_expect_success '__git_get_config_variables' '
 374         cat >expect <<-EOF &&
 375         name-1
 376         name-2
 377         EOF
 378         test_config interesting.name-1 good &&
 379         test_config interesting.name-2 good &&
 380         test_config subsection.interesting.name-3 bad &&
 381         __git_get_config_variables interesting >actual &&
 382         test_cmp expect actual
 383 '
 384
 385 test_expect_success '__git_pretty_aliases' '
 386         cat >expect <<-EOF &&
 387         author
 388         hash
 389         EOF
 390         test_config pretty.author "%an %ae" &&
 391         test_config pretty.hash %H &&
 392         __git_pretty_aliases >actual &&
 393         test_cmp expect actual
 394 '
 395
 396 test_expect_success '__git_aliases' '
 397         cat >expect <<-EOF &&
 398         ci
 399         co
 400         EOF
 401         test_config alias.ci commit &&
 402         test_config alias.co checkout &&
 403         __git_aliases >actual &&
 404         test_cmp expect actual
 405 '
 406
 407 test_expect_success 'basic' '
 408         run_completion "git " &&
 409         # built-in
 410         grep -q "^add \$" out &&
 411         # script
 412         grep -q "^filter-branch \$" out &&
 413         # plumbing
 414         ! grep -q "^ls-files \$" out &&
 415
 416         run_completion "git f" &&
 417         ! grep -q -v "^f" out
 418 '
 419
 420 test_expect_success 'double dash "git" itself' '
 421         test_completion "git --" <<-\EOF
 422         --paginate Z
 423         --no-pager Z
 424         --git-dir=
 425         --bare Z
 426         --version Z
 427         --exec-path Z
 428         --exec-path=
 429         --html-path Z
 430         --man-path Z
 431         --info-path Z
 432         --work-tree=
 433         --namespace=
 434         --no-replace-objects Z
 435         --help Z
 436         EOF
 437 '
 438
 439 test_expect_success 'double dash "git checkout"' '
 440         test_completion "git checkout --" <<-\EOF
 441         --quiet Z
 442         --ours Z
 443         --theirs Z
 444         --track Z
 445         --no-track Z
 446         --merge Z
 447         --conflict=
 448         --orphan Z
 449         --patch Z
 450         EOF
 451 '
 452
 453 test_expect_success 'general options' '
 454         test_completion "git --ver" "--version " &&
 455         test_completion "git --hel" "--help " &&
 456         test_completion "git --exe" <<-\EOF &&
 457         --exec-path Z
 458         --exec-path=
 459         EOF
 460         test_completion "git --htm" "--html-path " &&
 461         test_completion "git --pag" "--paginate " &&
 462         test_completion "git --no-p" "--no-pager " &&
 463         test_completion "git --git" "--git-dir=" &&
 464         test_completion "git --wor" "--work-tree=" &&
 465         test_completion "git --nam" "--namespace=" &&
 466         test_completion "git --bar" "--bare " &&
 467         test_completion "git --inf" "--info-path " &&
 468         test_completion "git --no-r" "--no-replace-objects "
 469 '
 470
 471 test_expect_success 'general options plus command' '
 472         test_completion "git --version check" "checkout " &&
 473         test_completion "git --paginate check" "checkout " &&
 474         test_completion "git --git-dir=foo check" "checkout " &&
 475         test_completion "git --bare check" "checkout " &&
 476         test_completion "git --exec-path=foo check" "checkout " &&
 477         test_completion "git --html-path check" "checkout " &&
 478         test_completion "git --no-pager check" "checkout " &&
 479         test_completion "git --work-tree=foo check" "checkout " &&
 480         test_completion "git --namespace=foo check" "checkout " &&
 481         test_completion "git --paginate check" "checkout " &&
 482         test_completion "git --info-path check" "checkout " &&
 483         test_completion "git --no-replace-objects check" "checkout "
 484 '
 485
 486 test_expect_success 'git --help completion' '
 487         test_completion "git --help ad" "add " &&
 488         test_completion "git --help core" "core-tutorial "
 489 '
 490
 491 test_expect_success 'setup for ref completion' '
 492         echo content >file1 &&
 493         echo more >file2 &&
 494         git add . &&
 495         git commit -m one &&
 496         git branch mybranch &&
 497         git tag mytag
 498 '
 499
 500 test_expect_success 'checkout completes ref names' '
 501         test_completion "git checkout m" <<-\EOF
 502         master Z
 503         mybranch Z
 504         mytag Z
 505         EOF
 506 '
 507
 508 test_expect_success 'show completes all refs' '
 509         test_completion "git show m" <<-\EOF
 510         master Z
 511         mybranch Z
 512         mytag Z
 513         EOF
 514 '
 515
 516 test_expect_success '<ref>: completes paths' '
 517         test_completion "git show mytag:f" <<-\EOF
 518         file1 Z
 519         file2 Z
 520         EOF
 521 '
 522
 523 test_expect_success 'complete tree filename with spaces' '
 524         echo content >"name with spaces" &&
 525         git add . &&
 526         git commit -m spaces &&
 527         test_completion "git show HEAD:nam" <<-\EOF
 528         name with spaces Z
 529         EOF
 530 '
 531
 532 test_expect_success 'complete tree filename with metacharacters' '
 533         echo content >"name with \${meta}" &&
 534         git add . &&
 535         git commit -m meta &&
 536         test_completion "git show HEAD:nam" <<-\EOF
 537         name with ${meta} Z
 538         name with spaces Z
 539         EOF
 540 '
 541
 542 test_expect_success 'send-email' '
 543         test_completion "git send-email --cov" "--cover-letter " &&
 544         test_completion "git send-email ma" "master "
 545 '
 546
 547 test_expect_success 'complete files' '
 548         git init tmp && cd tmp &&
 549         test_when_finished "cd .. && rm -rf tmp" &&
 550
 551         echo "expected" > .gitignore &&
 552         echo "out" >> .gitignore &&
 553
 554         git add .gitignore &&
 555         test_completion "git commit " ".gitignore" &&
 556
 557         git commit -m ignore &&
 558
 559         touch new &&
 560         test_completion "git add " "new" &&
 561
 562         git add new &&
 563         git commit -a -m new &&
 564         test_completion "git add " "" &&
 565
 566         git mv new modified &&
 567         echo modify > modified &&
 568         test_completion "git add " "modified" &&
 569
 570         touch untracked &&
 571
 572         : TODO .gitignore should not be here &&
 573         test_completion "git rm " <<-\EOF &&
 574         .gitignore
 575         modified
 576         EOF
 577
 578         test_completion "git clean " "untracked" &&
 579
 580         : TODO .gitignore should not be here &&
 581         test_completion "git mv " <<-\EOF &&
 582         .gitignore
 583         modified
 584         EOF
 585
 586         mkdir dir &&
 587         touch dir/file-in-dir &&
 588         git add dir/file-in-dir &&
 589         git commit -m dir &&
 590
 591         mkdir untracked-dir &&
 592
 593         : TODO .gitignore should not be here &&
 594         test_completion "git mv modified " <<-\EOF &&
 595         .gitignore
 596         dir
 597         modified
 598         untracked
 599         untracked-dir
 600         EOF
 601
 602         test_completion "git commit " "modified" &&
 603
 604         : TODO .gitignore should not be here &&
 605         test_completion "git ls-files " <<-\EOF &&
 606         .gitignore
 607         dir
 608         modified
 609         EOF
 610
 611         touch momified &&
 612         test_completion "git add mom" "momified"
 613 '
 614
 615 test_expect_success "completion uses <cmd> completion for alias: !sh -c 'git <cmd> ...'" '
 616         test_config alias.co "!sh -c '"'"'git checkout ...'"'"'" &&
 617         test_completion "git co m" <<-\EOF
 618         master Z
 619         mybranch Z
 620         mytag Z
 621         EOF
 622 '
 623
 624 test_expect_success 'completion uses <cmd> completion for alias: !f () { VAR=val git <cmd> ... }' '
 625         test_config alias.co "!f () { VAR=val git checkout ... ; } f" &&
 626         test_completion "git co m" <<-\EOF
 627         master Z
 628         mybranch Z
 629         mytag Z
 630         EOF
 631 '
 632
 633 test_expect_success 'completion used <cmd> completion for alias: !f() { : git <cmd> ; ... }' '
 634         test_config alias.co "!f() { : git checkout ; if ... } f" &&
 635         test_completion "git co m" <<-\EOF
 636         master Z
 637         mybranch Z
 638         mytag Z
 639         EOF
 640 '
 641
 642 test_expect_failure 'complete with tilde expansion' '
 643         git init tmp && cd tmp &&
 644         test_when_finished "cd .. && rm -rf tmp" &&
 645
 646         touch ~/tmp/file &&
 647
 648         test_completion "git add ~/tmp/" "~/tmp/file"
 649 '
 650
 651 test_done