t / t9902-completion.shon commit Merge branch 'ft/doc-git-transport' (43f25ae)
   1#!/bin/sh
   2#
   3# Copyright (c) 2012 Felipe Contreras
   4#
   5
   6test_description='test bash completion'
   7
   8. ./lib-bash.sh
   9
  10complete ()
  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
  33GIT_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
  61print_comp ()
  62{
  63        local IFS=$'\n'
  64        echo "${COMPREPLY[*]}" > out
  65}
  66
  67run_completion ()
  68{
  69        local -a COMPREPLY _words
  70        local _cword
  71        _words=( $1 )
  72        test "${1: -1}" == ' ' && _words+=('')
  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
  81test_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().
  97test_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
 112test_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
 123invalid_variable_name='${foo.bar}'
 124
 125actual="$TRASH_DIRECTORY/actual"
 126
 127test_expect_success 'setup for __gitdir tests' '
 128        mkdir -p subdir/subsubdir &&
 129        git init otherrepo
 130'
 131
 132test_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
 141test_expect_success '__gitdir - repo as argument' '
 142        echo "otherrepo/.git" >expected &&
 143        __gitdir "otherrepo" >"$actual" &&
 144        test_cmp expected "$actual"
 145'
 146
 147test_expect_success '__gitdir - remote as argument' '
 148        echo "remote" >expected &&
 149        __gitdir "remote" >"$actual" &&
 150        test_cmp expected "$actual"
 151'
 152
 153test_expect_success '__gitdir - .git directory in cwd' '
 154        echo ".git" >expected &&
 155        __gitdir >"$actual" &&
 156        test_cmp expected "$actual"
 157'
 158
 159test_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
 168test_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
 177test_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
 186test_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
 196test_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
 207test_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
 215test_expect_success '__gitdir - gitfile in cwd' '
 216        echo "$(pwd -P)/otherrepo/.git" >expected &&
 217        echo "gitdir: $TRASH_DIRECTORY/otherrepo/.git" >subdir/.git &&
 218        test_when_finished "rm -f subdir/.git" &&
 219        (
 220                cd subdir &&
 221                __gitdir >"$actual"
 222        ) &&
 223        test_cmp expected "$actual"
 224'
 225
 226test_expect_success '__gitdir - gitfile in parent' '
 227        echo "$(pwd -P)/otherrepo/.git" >expected &&
 228        echo "gitdir: $TRASH_DIRECTORY/otherrepo/.git" >subdir/.git &&
 229        test_when_finished "rm -f subdir/.git" &&
 230        (
 231                cd subdir/subsubdir &&
 232                __gitdir >"$actual"
 233        ) &&
 234        test_cmp expected "$actual"
 235'
 236
 237test_expect_success SYMLINKS '__gitdir - resulting path avoids symlinks' '
 238        echo "$(pwd -P)/otherrepo/.git" >expected &&
 239        mkdir otherrepo/dir &&
 240        test_when_finished "rm -rf otherrepo/dir" &&
 241        ln -s otherrepo/dir link &&
 242        test_when_finished "rm -f link" &&
 243        (
 244                cd link &&
 245                __gitdir >"$actual"
 246        ) &&
 247        test_cmp expected "$actual"
 248'
 249
 250test_expect_success '__gitdir - not a git repository' '
 251        (
 252                cd subdir/subsubdir &&
 253                GIT_CEILING_DIRECTORIES="$TRASH_DIRECTORY" &&
 254                export GIT_CEILING_DIRECTORIES &&
 255                test_must_fail __gitdir
 256        )
 257'
 258
 259test_expect_success '__gitcomp - trailing space - options' '
 260        test_gitcomp "--re" "--dry-run --reuse-message= --reedit-message=
 261                --reset-author" <<-EOF
 262        --reuse-message=Z
 263        --reedit-message=Z
 264        --reset-author Z
 265        EOF
 266'
 267
 268test_expect_success '__gitcomp - trailing space - config keys' '
 269        test_gitcomp "br" "branch. branch.autosetupmerge
 270                branch.autosetuprebase browser." <<-\EOF
 271        branch.Z
 272        branch.autosetupmerge Z
 273        branch.autosetuprebase Z
 274        browser.Z
 275        EOF
 276'
 277
 278test_expect_success '__gitcomp - option parameter' '
 279        test_gitcomp "--strategy=re" "octopus ours recursive resolve subtree" \
 280                "" "re" <<-\EOF
 281        recursive Z
 282        resolve Z
 283        EOF
 284'
 285
 286test_expect_success '__gitcomp - prefix' '
 287        test_gitcomp "branch.me" "remote merge mergeoptions rebase" \
 288                "branch.maint." "me" <<-\EOF
 289        branch.maint.merge Z
 290        branch.maint.mergeoptions Z
 291        EOF
 292'
 293
 294test_expect_success '__gitcomp - suffix' '
 295        test_gitcomp "branch.me" "master maint next pu" "branch." \
 296                "ma" "." <<-\EOF
 297        branch.master.Z
 298        branch.maint.Z
 299        EOF
 300'
 301
 302test_expect_success '__gitcomp - doesnt fail because of invalid variable name' '
 303        __gitcomp "$invalid_variable_name"
 304'
 305
 306read -r -d "" refs <<-\EOF
 307maint
 308master
 309next
 310pu
 311EOF
 312
 313test_expect_success '__gitcomp_nl - trailing space' '
 314        test_gitcomp_nl "m" "$refs" <<-EOF
 315        maint Z
 316        master Z
 317        EOF
 318'
 319
 320test_expect_success '__gitcomp_nl - prefix' '
 321        test_gitcomp_nl "--fixup=m" "$refs" "--fixup=" "m" <<-EOF
 322        --fixup=maint Z
 323        --fixup=master Z
 324        EOF
 325'
 326
 327test_expect_success '__gitcomp_nl - suffix' '
 328        test_gitcomp_nl "branch.ma" "$refs" "branch." "ma" "." <<-\EOF
 329        branch.maint.Z
 330        branch.master.Z
 331        EOF
 332'
 333
 334test_expect_success '__gitcomp_nl - no suffix' '
 335        test_gitcomp_nl "ma" "$refs" "" "ma" "" <<-\EOF
 336        maintZ
 337        masterZ
 338        EOF
 339'
 340
 341test_expect_success '__gitcomp_nl - doesnt fail because of invalid variable name' '
 342        __gitcomp_nl "$invalid_variable_name"
 343'
 344
 345test_expect_success 'basic' '
 346        run_completion "git " &&
 347        # built-in
 348        grep -q "^add \$" out &&
 349        # script
 350        grep -q "^filter-branch \$" out &&
 351        # plumbing
 352        ! grep -q "^ls-files \$" out &&
 353
 354        run_completion "git f" &&
 355        ! grep -q -v "^f" out
 356'
 357
 358test_expect_success 'double dash "git" itself' '
 359        test_completion "git --" <<-\EOF
 360        --paginate Z
 361        --no-pager Z
 362        --git-dir=
 363        --bare Z
 364        --version Z
 365        --exec-path Z
 366        --exec-path=
 367        --html-path Z
 368        --info-path Z
 369        --work-tree=
 370        --namespace=
 371        --no-replace-objects Z
 372        --help Z
 373        EOF
 374'
 375
 376test_expect_success 'double dash "git checkout"' '
 377        test_completion "git checkout --" <<-\EOF
 378        --quiet Z
 379        --ours Z
 380        --theirs Z
 381        --track Z
 382        --no-track Z
 383        --merge Z
 384        --conflict=
 385        --orphan Z
 386        --patch Z
 387        EOF
 388'
 389
 390test_expect_success 'general options' '
 391        test_completion "git --ver" "--version " &&
 392        test_completion "git --hel" "--help " &&
 393        test_completion "git --exe" <<-\EOF &&
 394        --exec-path Z
 395        --exec-path=
 396        EOF
 397        test_completion "git --htm" "--html-path " &&
 398        test_completion "git --pag" "--paginate " &&
 399        test_completion "git --no-p" "--no-pager " &&
 400        test_completion "git --git" "--git-dir=" &&
 401        test_completion "git --wor" "--work-tree=" &&
 402        test_completion "git --nam" "--namespace=" &&
 403        test_completion "git --bar" "--bare " &&
 404        test_completion "git --inf" "--info-path " &&
 405        test_completion "git --no-r" "--no-replace-objects "
 406'
 407
 408test_expect_success 'general options plus command' '
 409        test_completion "git --version check" "checkout " &&
 410        test_completion "git --paginate check" "checkout " &&
 411        test_completion "git --git-dir=foo check" "checkout " &&
 412        test_completion "git --bare check" "checkout " &&
 413        test_completion "git --exec-path=foo check" "checkout " &&
 414        test_completion "git --html-path check" "checkout " &&
 415        test_completion "git --no-pager check" "checkout " &&
 416        test_completion "git --work-tree=foo check" "checkout " &&
 417        test_completion "git --namespace=foo check" "checkout " &&
 418        test_completion "git --paginate check" "checkout " &&
 419        test_completion "git --info-path check" "checkout " &&
 420        test_completion "git --no-replace-objects check" "checkout "
 421'
 422
 423test_expect_success 'git --help completion' '
 424        test_completion "git --help ad" "add " &&
 425        test_completion "git --help core" "core-tutorial "
 426'
 427
 428test_expect_success 'setup for ref completion' '
 429        echo content >file1 &&
 430        echo more >file2 &&
 431        git add . &&
 432        git commit -m one &&
 433        git branch mybranch &&
 434        git tag mytag
 435'
 436
 437test_expect_success 'checkout completes ref names' '
 438        test_completion "git checkout m" <<-\EOF
 439        master Z
 440        mybranch Z
 441        mytag Z
 442        EOF
 443'
 444
 445test_expect_success 'show completes all refs' '
 446        test_completion "git show m" <<-\EOF
 447        master Z
 448        mybranch Z
 449        mytag Z
 450        EOF
 451'
 452
 453test_expect_success '<ref>: completes paths' '
 454        test_completion "git show mytag:f" <<-\EOF
 455        file1 Z
 456        file2 Z
 457        EOF
 458'
 459
 460test_expect_success 'complete tree filename with spaces' '
 461        echo content >"name with spaces" &&
 462        git add . &&
 463        git commit -m spaces &&
 464        test_completion "git show HEAD:nam" <<-\EOF
 465        name with spaces Z
 466        EOF
 467'
 468
 469test_expect_success 'complete tree filename with metacharacters' '
 470        echo content >"name with \${meta}" &&
 471        git add . &&
 472        git commit -m meta &&
 473        test_completion "git show HEAD:nam" <<-\EOF
 474        name with ${meta} Z
 475        name with spaces Z
 476        EOF
 477'
 478
 479test_expect_success 'send-email' '
 480        test_completion "git send-email --cov" "--cover-letter " &&
 481        test_completion "git send-email ma" "master "
 482'
 483
 484test_expect_success 'complete files' '
 485        git init tmp && cd tmp &&
 486        test_when_finished "cd .. && rm -rf tmp" &&
 487
 488        echo "expected" > .gitignore &&
 489        echo "out" >> .gitignore &&
 490
 491        git add .gitignore &&
 492        test_completion "git commit " ".gitignore" &&
 493
 494        git commit -m ignore &&
 495
 496        touch new &&
 497        test_completion "git add " "new" &&
 498
 499        git add new &&
 500        git commit -a -m new &&
 501        test_completion "git add " "" &&
 502
 503        git mv new modified &&
 504        echo modify > modified &&
 505        test_completion "git add " "modified" &&
 506
 507        touch untracked &&
 508
 509        : TODO .gitignore should not be here &&
 510        test_completion "git rm " <<-\EOF &&
 511        .gitignore
 512        modified
 513        EOF
 514
 515        test_completion "git clean " "untracked" &&
 516
 517        : TODO .gitignore should not be here &&
 518        test_completion "git mv " <<-\EOF &&
 519        .gitignore
 520        modified
 521        EOF
 522
 523        mkdir dir &&
 524        touch dir/file-in-dir &&
 525        git add dir/file-in-dir &&
 526        git commit -m dir &&
 527
 528        mkdir untracked-dir &&
 529
 530        : TODO .gitignore should not be here &&
 531        test_completion "git mv modified " <<-\EOF &&
 532        .gitignore
 533        dir
 534        modified
 535        untracked
 536        untracked-dir
 537        EOF
 538
 539        test_completion "git commit " "modified" &&
 540
 541        : TODO .gitignore should not be here &&
 542        test_completion "git ls-files " <<-\EOF
 543        .gitignore
 544        dir
 545        modified
 546        EOF
 547
 548        touch momified &&
 549        test_completion "git add mom" "momified"
 550'
 551
 552test_expect_failure 'complete with tilde expansion' '
 553        git init tmp && cd tmp &&
 554        test_when_finished "cd .. && rm -rf tmp" &&
 555
 556        touch ~/tmp/file &&
 557
 558        test_completion "git add ~/tmp/" "~/tmp/file"
 559'
 560
 561test_done