always quote shell arguments to test -z/-n
[git] / 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