Fourth batch
[git/raj.git] / contrib / completion / git-completion.bash
blob0fdb5da83bed06a4c0b9bbb7cb8876fd54774b4f
1 # bash/zsh completion support for core Git.
3 # Copyright (C) 2006,2007 Shawn O. Pearce <spearce@spearce.org>
4 # Conceptually based on gitcompletion (http://gitweb.hawaga.org.uk/).
5 # Distributed under the GNU General Public License, version 2.0.
7 # The contained completion routines provide support for completing:
9 # *) local and remote branch names
10 # *) local and remote tag names
11 # *) .git/remotes file names
12 # *) git 'subcommands'
13 # *) git email aliases for git-send-email
14 # *) tree paths within 'ref:path/to/file' expressions
15 # *) file paths within current working directory and index
16 # *) common --long-options
18 # To use these routines:
20 # 1) Copy this file to somewhere (e.g. ~/.git-completion.bash).
21 # 2) Add the following line to your .bashrc/.zshrc:
22 # source ~/.git-completion.bash
23 # 3) Consider changing your PS1 to also show the current branch,
24 # see git-prompt.sh for details.
26 # If you use complex aliases of form '!f() { ... }; f', you can use the null
27 # command ':' as the first command in the function body to declare the desired
28 # completion style. For example '!f() { : git commit ; ... }; f' will
29 # tell the completion to use commit completion. This also works with aliases
30 # of form "!sh -c '...'". For example, "!sh -c ': git commit ; ... '".
32 # Compatible with bash 3.2.57.
34 # You can set the following environment variables to influence the behavior of
35 # the completion routines:
37 # GIT_COMPLETION_CHECKOUT_NO_GUESS
39 # When set to "1", do not include "DWIM" suggestions in git-checkout
40 # and git-switch completion (e.g., completing "foo" when "origin/foo"
41 # exists).
43 case "$COMP_WORDBREAKS" in
44 *:*) : great ;;
45 *) COMP_WORDBREAKS="$COMP_WORDBREAKS:"
46 esac
48 # Discovers the path to the git repository taking any '--git-dir=<path>' and
49 # '-C <path>' options into account and stores it in the $__git_repo_path
50 # variable.
51 __git_find_repo_path ()
53 if [ -n "${__git_repo_path-}" ]; then
54 # we already know where it is
55 return
58 if [ -n "${__git_C_args-}" ]; then
59 __git_repo_path="$(git "${__git_C_args[@]}" \
60 ${__git_dir:+--git-dir="$__git_dir"} \
61 rev-parse --absolute-git-dir 2>/dev/null)"
62 elif [ -n "${__git_dir-}" ]; then
63 test -d "$__git_dir" &&
64 __git_repo_path="$__git_dir"
65 elif [ -n "${GIT_DIR-}" ]; then
66 test -d "${GIT_DIR-}" &&
67 __git_repo_path="$GIT_DIR"
68 elif [ -d .git ]; then
69 __git_repo_path=.git
70 else
71 __git_repo_path="$(git rev-parse --git-dir 2>/dev/null)"
75 # Deprecated: use __git_find_repo_path() and $__git_repo_path instead
76 # __gitdir accepts 0 or 1 arguments (i.e., location)
77 # returns location of .git repo
78 __gitdir ()
80 if [ -z "${1-}" ]; then
81 __git_find_repo_path || return 1
82 echo "$__git_repo_path"
83 elif [ -d "$1/.git" ]; then
84 echo "$1/.git"
85 else
86 echo "$1"
90 # Runs git with all the options given as argument, respecting any
91 # '--git-dir=<path>' and '-C <path>' options present on the command line
92 __git ()
94 git ${__git_C_args:+"${__git_C_args[@]}"} \
95 ${__git_dir:+--git-dir="$__git_dir"} "$@" 2>/dev/null
98 # Removes backslash escaping, single quotes and double quotes from a word,
99 # stores the result in the variable $dequoted_word.
100 # 1: The word to dequote.
101 __git_dequote ()
103 local rest="$1" len ch
105 dequoted_word=""
107 while test -n "$rest"; do
108 len=${#dequoted_word}
109 dequoted_word="$dequoted_word${rest%%[\\\'\"]*}"
110 rest="${rest:$((${#dequoted_word}-$len))}"
112 case "${rest:0:1}" in
114 ch="${rest:1:1}"
115 case "$ch" in
116 $'\n')
119 dequoted_word="$dequoted_word$ch"
121 esac
122 rest="${rest:2}"
125 rest="${rest:1}"
126 len=${#dequoted_word}
127 dequoted_word="$dequoted_word${rest%%\'*}"
128 rest="${rest:$((${#dequoted_word}-$len+1))}"
131 rest="${rest:1}"
132 while test -n "$rest" ; do
133 len=${#dequoted_word}
134 dequoted_word="$dequoted_word${rest%%[\\\"]*}"
135 rest="${rest:$((${#dequoted_word}-$len))}"
136 case "${rest:0:1}" in
138 ch="${rest:1:1}"
139 case "$ch" in
140 \"|\\|\$|\`)
141 dequoted_word="$dequoted_word$ch"
143 $'\n')
146 dequoted_word="$dequoted_word\\$ch"
148 esac
149 rest="${rest:2}"
152 rest="${rest:1}"
153 break
155 esac
156 done
158 esac
159 done
162 # The following function is based on code from:
164 # bash_completion - programmable completion functions for bash 3.2+
166 # Copyright © 2006-2008, Ian Macdonald <ian@caliban.org>
167 # © 2009-2010, Bash Completion Maintainers
168 # <bash-completion-devel@lists.alioth.debian.org>
170 # This program is free software; you can redistribute it and/or modify
171 # it under the terms of the GNU General Public License as published by
172 # the Free Software Foundation; either version 2, or (at your option)
173 # any later version.
175 # This program is distributed in the hope that it will be useful,
176 # but WITHOUT ANY WARRANTY; without even the implied warranty of
177 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
178 # GNU General Public License for more details.
180 # You should have received a copy of the GNU General Public License
181 # along with this program; if not, see <http://www.gnu.org/licenses/>.
183 # The latest version of this software can be obtained here:
185 # http://bash-completion.alioth.debian.org/
187 # RELEASE: 2.x
189 # This function can be used to access a tokenized list of words
190 # on the command line:
192 # __git_reassemble_comp_words_by_ref '=:'
193 # if test "${words_[cword_-1]}" = -w
194 # then
195 # ...
196 # fi
198 # The argument should be a collection of characters from the list of
199 # word completion separators (COMP_WORDBREAKS) to treat as ordinary
200 # characters.
202 # This is roughly equivalent to going back in time and setting
203 # COMP_WORDBREAKS to exclude those characters. The intent is to
204 # make option types like --date=<type> and <rev>:<path> easy to
205 # recognize by treating each shell word as a single token.
207 # It is best not to set COMP_WORDBREAKS directly because the value is
208 # shared with other completion scripts. By the time the completion
209 # function gets called, COMP_WORDS has already been populated so local
210 # changes to COMP_WORDBREAKS have no effect.
212 # Output: words_, cword_, cur_.
214 __git_reassemble_comp_words_by_ref()
216 local exclude i j first
217 # Which word separators to exclude?
218 exclude="${1//[^$COMP_WORDBREAKS]}"
219 cword_=$COMP_CWORD
220 if [ -z "$exclude" ]; then
221 words_=("${COMP_WORDS[@]}")
222 return
224 # List of word completion separators has shrunk;
225 # re-assemble words to complete.
226 for ((i=0, j=0; i < ${#COMP_WORDS[@]}; i++, j++)); do
227 # Append each nonempty word consisting of just
228 # word separator characters to the current word.
229 first=t
230 while
231 [ $i -gt 0 ] &&
232 [ -n "${COMP_WORDS[$i]}" ] &&
233 # word consists of excluded word separators
234 [ "${COMP_WORDS[$i]//[^$exclude]}" = "${COMP_WORDS[$i]}" ]
236 # Attach to the previous token,
237 # unless the previous token is the command name.
238 if [ $j -ge 2 ] && [ -n "$first" ]; then
239 ((j--))
241 first=
242 words_[$j]=${words_[j]}${COMP_WORDS[i]}
243 if [ $i = $COMP_CWORD ]; then
244 cword_=$j
246 if (($i < ${#COMP_WORDS[@]} - 1)); then
247 ((i++))
248 else
249 # Done.
250 return
252 done
253 words_[$j]=${words_[j]}${COMP_WORDS[i]}
254 if [ $i = $COMP_CWORD ]; then
255 cword_=$j
257 done
260 if ! type _get_comp_words_by_ref >/dev/null 2>&1; then
261 _get_comp_words_by_ref ()
263 local exclude cur_ words_ cword_
264 if [ "$1" = "-n" ]; then
265 exclude=$2
266 shift 2
268 __git_reassemble_comp_words_by_ref "$exclude"
269 cur_=${words_[cword_]}
270 while [ $# -gt 0 ]; do
271 case "$1" in
272 cur)
273 cur=$cur_
275 prev)
276 prev=${words_[$cword_-1]}
278 words)
279 words=("${words_[@]}")
281 cword)
282 cword=$cword_
284 esac
285 shift
286 done
290 # Fills the COMPREPLY array with prefiltered words without any additional
291 # processing.
292 # Callers must take care of providing only words that match the current word
293 # to be completed and adding any prefix and/or suffix (trailing space!), if
294 # necessary.
295 # 1: List of newline-separated matching completion words, complete with
296 # prefix and suffix.
297 __gitcomp_direct ()
299 local IFS=$'\n'
301 COMPREPLY=($1)
304 # Similar to __gitcomp_direct, but appends to COMPREPLY instead.
305 # Callers must take care of providing only words that match the current word
306 # to be completed and adding any prefix and/or suffix (trailing space!), if
307 # necessary.
308 # 1: List of newline-separated matching completion words, complete with
309 # prefix and suffix.
310 __gitcomp_direct_append ()
312 local IFS=$'\n'
314 COMPREPLY+=($1)
317 __gitcompappend ()
319 local x i=${#COMPREPLY[@]}
320 for x in $1; do
321 if [[ "$x" == "$3"* ]]; then
322 COMPREPLY[i++]="$2$x$4"
324 done
327 __gitcompadd ()
329 COMPREPLY=()
330 __gitcompappend "$@"
333 # Generates completion reply, appending a space to possible completion words,
334 # if necessary.
335 # It accepts 1 to 4 arguments:
336 # 1: List of possible completion words.
337 # 2: A prefix to be added to each possible completion word (optional).
338 # 3: Generate possible completion matches for this word (optional).
339 # 4: A suffix to be appended to each possible completion word (optional).
340 __gitcomp ()
342 local cur_="${3-$cur}"
344 case "$cur_" in
345 --*=)
347 --no-*)
348 local c i=0 IFS=$' \t\n'
349 for c in $1; do
350 if [[ $c == "--" ]]; then
351 continue
353 c="$c${4-}"
354 if [[ $c == "$cur_"* ]]; then
355 case $c in
356 --*=|*.) ;;
357 *) c="$c " ;;
358 esac
359 COMPREPLY[i++]="${2-}$c"
361 done
364 local c i=0 IFS=$' \t\n'
365 for c in $1; do
366 if [[ $c == "--" ]]; then
367 c="--no-...${4-}"
368 if [[ $c == "$cur_"* ]]; then
369 COMPREPLY[i++]="${2-}$c "
371 break
373 c="$c${4-}"
374 if [[ $c == "$cur_"* ]]; then
375 case $c in
376 *=|*.) ;;
377 *) c="$c " ;;
378 esac
379 COMPREPLY[i++]="${2-}$c"
381 done
383 esac
386 # Clear the variables caching builtins' options when (re-)sourcing
387 # the completion script.
388 if [[ -n ${ZSH_VERSION-} ]]; then
389 unset ${(M)${(k)parameters[@]}:#__gitcomp_builtin_*} 2>/dev/null
390 else
391 unset $(compgen -v __gitcomp_builtin_)
394 # This function is equivalent to
396 # __gitcomp "$(git xxx --git-completion-helper) ..."
398 # except that the output is cached. Accept 1-3 arguments:
399 # 1: the git command to execute, this is also the cache key
400 # 2: extra options to be added on top (e.g. negative forms)
401 # 3: options to be excluded
402 __gitcomp_builtin ()
404 # spaces must be replaced with underscore for multi-word
405 # commands, e.g. "git remote add" becomes remote_add.
406 local cmd="$1"
407 local incl="${2-}"
408 local excl="${3-}"
410 local var=__gitcomp_builtin_"${cmd/-/_}"
411 local options
412 eval "options=\${$var-}"
414 if [ -z "$options" ]; then
415 # leading and trailing spaces are significant to make
416 # option removal work correctly.
417 options=" $incl $(__git ${cmd/_/ } --git-completion-helper) " || return
419 for i in $excl; do
420 options="${options/ $i / }"
421 done
422 eval "$var=\"$options\""
425 __gitcomp "$options"
428 # Variation of __gitcomp_nl () that appends to the existing list of
429 # completion candidates, COMPREPLY.
430 __gitcomp_nl_append ()
432 local IFS=$'\n'
433 __gitcompappend "$1" "${2-}" "${3-$cur}" "${4- }"
436 # Generates completion reply from newline-separated possible completion words
437 # by appending a space to all of them.
438 # It accepts 1 to 4 arguments:
439 # 1: List of possible completion words, separated by a single newline.
440 # 2: A prefix to be added to each possible completion word (optional).
441 # 3: Generate possible completion matches for this word (optional).
442 # 4: A suffix to be appended to each possible completion word instead of
443 # the default space (optional). If specified but empty, nothing is
444 # appended.
445 __gitcomp_nl ()
447 COMPREPLY=()
448 __gitcomp_nl_append "$@"
451 # Fills the COMPREPLY array with prefiltered paths without any additional
452 # processing.
453 # Callers must take care of providing only paths that match the current path
454 # to be completed and adding any prefix path components, if necessary.
455 # 1: List of newline-separated matching paths, complete with all prefix
456 # path components.
457 __gitcomp_file_direct ()
459 local IFS=$'\n'
461 COMPREPLY=($1)
463 # use a hack to enable file mode in bash < 4
464 compopt -o filenames +o nospace 2>/dev/null ||
465 compgen -f /non-existing-dir/ >/dev/null ||
466 true
469 # Generates completion reply with compgen from newline-separated possible
470 # completion filenames.
471 # It accepts 1 to 3 arguments:
472 # 1: List of possible completion filenames, separated by a single newline.
473 # 2: A directory prefix to be added to each possible completion filename
474 # (optional).
475 # 3: Generate possible completion matches for this word (optional).
476 __gitcomp_file ()
478 local IFS=$'\n'
480 # XXX does not work when the directory prefix contains a tilde,
481 # since tilde expansion is not applied.
482 # This means that COMPREPLY will be empty and Bash default
483 # completion will be used.
484 __gitcompadd "$1" "${2-}" "${3-$cur}" ""
486 # use a hack to enable file mode in bash < 4
487 compopt -o filenames +o nospace 2>/dev/null ||
488 compgen -f /non-existing-dir/ >/dev/null ||
489 true
492 # Execute 'git ls-files', unless the --committable option is specified, in
493 # which case it runs 'git diff-index' to find out the files that can be
494 # committed. It return paths relative to the directory specified in the first
495 # argument, and using the options specified in the second argument.
496 __git_ls_files_helper ()
498 if [ "$2" == "--committable" ]; then
499 __git -C "$1" -c core.quotePath=false diff-index \
500 --name-only --relative HEAD -- "${3//\\/\\\\}*"
501 else
502 # NOTE: $2 is not quoted in order to support multiple options
503 __git -C "$1" -c core.quotePath=false ls-files \
504 --exclude-standard $2 -- "${3//\\/\\\\}*"
509 # __git_index_files accepts 1 or 2 arguments:
510 # 1: Options to pass to ls-files (required).
511 # 2: A directory path (optional).
512 # If provided, only files within the specified directory are listed.
513 # Sub directories are never recursed. Path must have a trailing
514 # slash.
515 # 3: List only paths matching this path component (optional).
516 __git_index_files ()
518 local root="$2" match="$3"
520 __git_ls_files_helper "$root" "$1" "${match:-?}" |
521 awk -F / -v pfx="${2//\\/\\\\}" '{
522 paths[$1] = 1
524 END {
525 for (p in paths) {
526 if (substr(p, 1, 1) != "\"") {
527 # No special characters, easy!
528 print pfx p
529 continue
532 # The path is quoted.
533 p = dequote(p)
534 if (p == "")
535 continue
537 # Even when a directory name itself does not contain
538 # any special characters, it will still be quoted if
539 # any of its (stripped) trailing path components do.
540 # Because of this we may have seen the same directory
541 # both quoted and unquoted.
542 if (p in paths)
543 # We have seen the same directory unquoted,
544 # skip it.
545 continue
546 else
547 print pfx p
550 function dequote(p, bs_idx, out, esc, esc_idx, dec) {
551 # Skip opening double quote.
552 p = substr(p, 2)
554 # Interpret backslash escape sequences.
555 while ((bs_idx = index(p, "\\")) != 0) {
556 out = out substr(p, 1, bs_idx - 1)
557 esc = substr(p, bs_idx + 1, 1)
558 p = substr(p, bs_idx + 2)
560 if ((esc_idx = index("abtvfr\"\\", esc)) != 0) {
561 # C-style one-character escape sequence.
562 out = out substr("\a\b\t\v\f\r\"\\",
563 esc_idx, 1)
564 } else if (esc == "n") {
565 # Uh-oh, a newline character.
566 # We cannot reliably put a pathname
567 # containing a newline into COMPREPLY,
568 # and the newline would create a mess.
569 # Skip this path.
570 return ""
571 } else {
572 # Must be a \nnn octal value, then.
573 dec = esc * 64 + \
574 substr(p, 1, 1) * 8 + \
575 substr(p, 2, 1)
576 out = out sprintf("%c", dec)
577 p = substr(p, 3)
580 # Drop closing double quote, if there is one.
581 # (There is not any if this is a directory, as it was
582 # already stripped with the trailing path components.)
583 if (substr(p, length(p), 1) == "\"")
584 out = out substr(p, 1, length(p) - 1)
585 else
586 out = out p
588 return out
592 # __git_complete_index_file requires 1 argument:
593 # 1: the options to pass to ls-file
595 # The exception is --committable, which finds the files appropriate commit.
596 __git_complete_index_file ()
598 local dequoted_word pfx="" cur_
600 __git_dequote "$cur"
602 case "$dequoted_word" in
603 ?*/*)
604 pfx="${dequoted_word%/*}/"
605 cur_="${dequoted_word##*/}"
608 cur_="$dequoted_word"
609 esac
611 __gitcomp_file_direct "$(__git_index_files "$1" "$pfx" "$cur_")"
614 # Lists branches from the local repository.
615 # 1: A prefix to be added to each listed branch (optional).
616 # 2: List only branches matching this word (optional; list all branches if
617 # unset or empty).
618 # 3: A suffix to be appended to each listed branch (optional).
619 __git_heads ()
621 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
623 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
624 "refs/heads/$cur_*" "refs/heads/$cur_*/**"
627 # Lists branches from remote repositories.
628 # 1: A prefix to be added to each listed branch (optional).
629 # 2: List only branches matching this word (optional; list all branches if
630 # unset or empty).
631 # 3: A suffix to be appended to each listed branch (optional).
632 __git_remote_heads ()
634 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
636 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
637 "refs/remotes/$cur_*" "refs/remotes/$cur_*/**"
640 # Lists tags from the local repository.
641 # Accepts the same positional parameters as __git_heads() above.
642 __git_tags ()
644 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
646 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
647 "refs/tags/$cur_*" "refs/tags/$cur_*/**"
650 # List unique branches from refs/remotes used for 'git checkout' and 'git
651 # switch' tracking DWIMery.
652 # 1: A prefix to be added to each listed branch (optional)
653 # 2: List only branches matching this word (optional; list all branches if
654 # unset or empty).
655 # 3: A suffix to be appended to each listed branch (optional).
656 __git_dwim_remote_heads ()
658 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
659 local fer_pfx="${pfx//\%/%%}" # "escape" for-each-ref format specifiers
661 # employ the heuristic used by git checkout and git switch
662 # Try to find a remote branch that cur_es the completion word
663 # but only output if the branch name is unique
664 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
665 --sort="refname:strip=3" \
666 "refs/remotes/*/$cur_*" "refs/remotes/*/$cur_*/**" | \
667 uniq -u
670 # Lists refs from the local (by default) or from a remote repository.
671 # It accepts 0, 1 or 2 arguments:
672 # 1: The remote to list refs from (optional; ignored, if set but empty).
673 # Can be the name of a configured remote, a path, or a URL.
674 # 2: In addition to local refs, list unique branches from refs/remotes/ for
675 # 'git checkout's tracking DWIMery (optional; ignored, if set but empty).
676 # 3: A prefix to be added to each listed ref (optional).
677 # 4: List only refs matching this word (optional; list all refs if unset or
678 # empty).
679 # 5: A suffix to be appended to each listed ref (optional; ignored, if set
680 # but empty).
682 # Use __git_complete_refs() instead.
683 __git_refs ()
685 local i hash dir track="${2-}"
686 local list_refs_from=path remote="${1-}"
687 local format refs
688 local pfx="${3-}" cur_="${4-$cur}" sfx="${5-}"
689 local match="${4-}"
690 local fer_pfx="${pfx//\%/%%}" # "escape" for-each-ref format specifiers
692 __git_find_repo_path
693 dir="$__git_repo_path"
695 if [ -z "$remote" ]; then
696 if [ -z "$dir" ]; then
697 return
699 else
700 if __git_is_configured_remote "$remote"; then
701 # configured remote takes precedence over a
702 # local directory with the same name
703 list_refs_from=remote
704 elif [ -d "$remote/.git" ]; then
705 dir="$remote/.git"
706 elif [ -d "$remote" ]; then
707 dir="$remote"
708 else
709 list_refs_from=url
713 if [ "$list_refs_from" = path ]; then
714 if [[ "$cur_" == ^* ]]; then
715 pfx="$pfx^"
716 fer_pfx="$fer_pfx^"
717 cur_=${cur_#^}
718 match=${match#^}
720 case "$cur_" in
721 refs|refs/*)
722 format="refname"
723 refs=("$match*" "$match*/**")
724 track=""
727 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD REBASE_HEAD; do
728 case "$i" in
729 $match*)
730 if [ -e "$dir/$i" ]; then
731 echo "$pfx$i$sfx"
734 esac
735 done
736 format="refname:strip=2"
737 refs=("refs/tags/$match*" "refs/tags/$match*/**"
738 "refs/heads/$match*" "refs/heads/$match*/**"
739 "refs/remotes/$match*" "refs/remotes/$match*/**")
741 esac
742 __git_dir="$dir" __git for-each-ref --format="$fer_pfx%($format)$sfx" \
743 "${refs[@]}"
744 if [ -n "$track" ]; then
745 __git_dwim_remote_heads "$pfx" "$match" "$sfx"
747 return
749 case "$cur_" in
750 refs|refs/*)
751 __git ls-remote "$remote" "$match*" | \
752 while read -r hash i; do
753 case "$i" in
754 *^{}) ;;
755 *) echo "$pfx$i$sfx" ;;
756 esac
757 done
760 if [ "$list_refs_from" = remote ]; then
761 case "HEAD" in
762 $match*) echo "${pfx}HEAD$sfx" ;;
763 esac
764 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
765 "refs/remotes/$remote/$match*" \
766 "refs/remotes/$remote/$match*/**"
767 else
768 local query_symref
769 case "HEAD" in
770 $match*) query_symref="HEAD" ;;
771 esac
772 __git ls-remote "$remote" $query_symref \
773 "refs/tags/$match*" "refs/heads/$match*" \
774 "refs/remotes/$match*" |
775 while read -r hash i; do
776 case "$i" in
777 *^{}) ;;
778 refs/*) echo "$pfx${i#refs/*/}$sfx" ;;
779 *) echo "$pfx$i$sfx" ;; # symbolic refs
780 esac
781 done
784 esac
787 # Completes refs, short and long, local and remote, symbolic and pseudo.
789 # Usage: __git_complete_refs [<option>]...
790 # --remote=<remote>: The remote to list refs from, can be the name of a
791 # configured remote, a path, or a URL.
792 # --dwim: List unique remote branches for 'git switch's tracking DWIMery.
793 # --pfx=<prefix>: A prefix to be added to each ref.
794 # --cur=<word>: The current ref to be completed. Defaults to the current
795 # word to be completed.
796 # --sfx=<suffix>: A suffix to be appended to each ref instead of the default
797 # space.
798 # --mode=<mode>: What set of refs to complete, one of 'refs' (the default) to
799 # complete all refs, 'heads' to complete only branches, or
800 # 'remote-heads' to complete only remote branches. Note that
801 # --remote is only compatible with --mode=refs.
802 __git_complete_refs ()
804 local remote= dwim= pfx= cur_="$cur" sfx=" " mode="refs"
806 while test $# != 0; do
807 case "$1" in
808 --remote=*) remote="${1##--remote=}" ;;
809 --dwim) dwim="yes" ;;
810 # --track is an old spelling of --dwim
811 --track) dwim="yes" ;;
812 --pfx=*) pfx="${1##--pfx=}" ;;
813 --cur=*) cur_="${1##--cur=}" ;;
814 --sfx=*) sfx="${1##--sfx=}" ;;
815 --mode=*) mode="${1##--mode=}" ;;
816 *) return 1 ;;
817 esac
818 shift
819 done
821 # complete references based on the specified mode
822 case "$mode" in
823 refs)
824 __gitcomp_direct "$(__git_refs "$remote" "" "$pfx" "$cur_" "$sfx")" ;;
825 heads)
826 __gitcomp_direct "$(__git_heads "$pfx" "$cur_" "$sfx")" ;;
827 remote-heads)
828 __gitcomp_direct "$(__git_remote_heads "$pfx" "$cur_" "$sfx")" ;;
830 return 1 ;;
831 esac
833 # Append DWIM remote branch names if requested
834 if [ "$dwim" = "yes" ]; then
835 __gitcomp_direct_append "$(__git_dwim_remote_heads "$pfx" "$cur_" "$sfx")"
839 # __git_refs2 requires 1 argument (to pass to __git_refs)
840 # Deprecated: use __git_complete_fetch_refspecs() instead.
841 __git_refs2 ()
843 local i
844 for i in $(__git_refs "$1"); do
845 echo "$i:$i"
846 done
849 # Completes refspecs for fetching from a remote repository.
850 # 1: The remote repository.
851 # 2: A prefix to be added to each listed refspec (optional).
852 # 3: The ref to be completed as a refspec instead of the current word to be
853 # completed (optional)
854 # 4: A suffix to be appended to each listed refspec instead of the default
855 # space (optional).
856 __git_complete_fetch_refspecs ()
858 local i remote="$1" pfx="${2-}" cur_="${3-$cur}" sfx="${4- }"
860 __gitcomp_direct "$(
861 for i in $(__git_refs "$remote" "" "" "$cur_") ; do
862 echo "$pfx$i:$i$sfx"
863 done
867 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
868 __git_refs_remotes ()
870 local i hash
871 __git ls-remote "$1" 'refs/heads/*' | \
872 while read -r hash i; do
873 echo "$i:refs/remotes/$1/${i#refs/heads/}"
874 done
877 __git_remotes ()
879 __git_find_repo_path
880 test -d "$__git_repo_path/remotes" && ls -1 "$__git_repo_path/remotes"
881 __git remote
884 # Returns true if $1 matches the name of a configured remote, false otherwise.
885 __git_is_configured_remote ()
887 local remote
888 for remote in $(__git_remotes); do
889 if [ "$remote" = "$1" ]; then
890 return 0
892 done
893 return 1
896 __git_list_merge_strategies ()
898 LANG=C LC_ALL=C git merge -s help 2>&1 |
899 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
900 s/\.$//
901 s/.*://
902 s/^[ ]*//
903 s/[ ]*$//
908 __git_merge_strategies=
909 # 'git merge -s help' (and thus detection of the merge strategy
910 # list) fails, unfortunately, if run outside of any git working
911 # tree. __git_merge_strategies is set to the empty string in
912 # that case, and the detection will be repeated the next time it
913 # is needed.
914 __git_compute_merge_strategies ()
916 test -n "$__git_merge_strategies" ||
917 __git_merge_strategies=$(__git_list_merge_strategies)
920 __git_merge_strategy_options="ours theirs subtree subtree= patience
921 histogram diff-algorithm= ignore-space-change ignore-all-space
922 ignore-space-at-eol renormalize no-renormalize no-renames
923 find-renames find-renames= rename-threshold="
925 __git_complete_revlist_file ()
927 local dequoted_word pfx ls ref cur_="$cur"
928 case "$cur_" in
929 *..?*:*)
930 return
932 ?*:*)
933 ref="${cur_%%:*}"
934 cur_="${cur_#*:}"
936 __git_dequote "$cur_"
938 case "$dequoted_word" in
939 ?*/*)
940 pfx="${dequoted_word%/*}"
941 cur_="${dequoted_word##*/}"
942 ls="$ref:$pfx"
943 pfx="$pfx/"
946 cur_="$dequoted_word"
947 ls="$ref"
949 esac
951 case "$COMP_WORDBREAKS" in
952 *:*) : great ;;
953 *) pfx="$ref:$pfx" ;;
954 esac
956 __gitcomp_file "$(__git ls-tree "$ls" \
957 | sed 's/^.* //
958 s/$//')" \
959 "$pfx" "$cur_"
961 *...*)
962 pfx="${cur_%...*}..."
963 cur_="${cur_#*...}"
964 __git_complete_refs --pfx="$pfx" --cur="$cur_"
966 *..*)
967 pfx="${cur_%..*}.."
968 cur_="${cur_#*..}"
969 __git_complete_refs --pfx="$pfx" --cur="$cur_"
972 __git_complete_refs
974 esac
977 __git_complete_file ()
979 __git_complete_revlist_file
982 __git_complete_revlist ()
984 __git_complete_revlist_file
987 __git_complete_remote_or_refspec ()
989 local cur_="$cur" cmd="${words[1]}"
990 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
991 if [ "$cmd" = "remote" ]; then
992 ((c++))
994 while [ $c -lt $cword ]; do
995 i="${words[c]}"
996 case "$i" in
997 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
998 -d|--delete) [ "$cmd" = "push" ] && lhs=0 ;;
999 --all)
1000 case "$cmd" in
1001 push) no_complete_refspec=1 ;;
1002 fetch)
1003 return
1005 *) ;;
1006 esac
1008 --multiple) no_complete_refspec=1; break ;;
1009 -*) ;;
1010 *) remote="$i"; break ;;
1011 esac
1012 ((c++))
1013 done
1014 if [ -z "$remote" ]; then
1015 __gitcomp_nl "$(__git_remotes)"
1016 return
1018 if [ $no_complete_refspec = 1 ]; then
1019 return
1021 [ "$remote" = "." ] && remote=
1022 case "$cur_" in
1023 *:*)
1024 case "$COMP_WORDBREAKS" in
1025 *:*) : great ;;
1026 *) pfx="${cur_%%:*}:" ;;
1027 esac
1028 cur_="${cur_#*:}"
1029 lhs=0
1032 pfx="+"
1033 cur_="${cur_#+}"
1035 esac
1036 case "$cmd" in
1037 fetch)
1038 if [ $lhs = 1 ]; then
1039 __git_complete_fetch_refspecs "$remote" "$pfx" "$cur_"
1040 else
1041 __git_complete_refs --pfx="$pfx" --cur="$cur_"
1044 pull|remote)
1045 if [ $lhs = 1 ]; then
1046 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
1047 else
1048 __git_complete_refs --pfx="$pfx" --cur="$cur_"
1051 push)
1052 if [ $lhs = 1 ]; then
1053 __git_complete_refs --pfx="$pfx" --cur="$cur_"
1054 else
1055 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
1058 esac
1061 __git_complete_strategy ()
1063 __git_compute_merge_strategies
1064 case "$prev" in
1065 -s|--strategy)
1066 __gitcomp "$__git_merge_strategies"
1067 return 0
1070 __gitcomp "$__git_merge_strategy_options"
1071 return 0
1073 esac
1074 case "$cur" in
1075 --strategy=*)
1076 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
1077 return 0
1079 --strategy-option=*)
1080 __gitcomp "$__git_merge_strategy_options" "" "${cur##--strategy-option=}"
1081 return 0
1083 esac
1084 return 1
1087 __git_all_commands=
1088 __git_compute_all_commands ()
1090 test -n "$__git_all_commands" ||
1091 __git_all_commands=$(__git --list-cmds=main,others,alias,nohelpers)
1094 # Lists all set config variables starting with the given section prefix,
1095 # with the prefix removed.
1096 __git_get_config_variables ()
1098 local section="$1" i IFS=$'\n'
1099 for i in $(__git config --name-only --get-regexp "^$section\..*"); do
1100 echo "${i#$section.}"
1101 done
1104 __git_pretty_aliases ()
1106 __git_get_config_variables "pretty"
1109 # __git_aliased_command requires 1 argument
1110 __git_aliased_command ()
1112 local word cmdline=$(__git config --get "alias.$1")
1113 for word in $cmdline; do
1114 case "$word" in
1115 \!gitk|gitk)
1116 echo "gitk"
1117 return
1119 \!*) : shell command alias ;;
1120 -*) : option ;;
1121 *=*) : setting env ;;
1122 git) : git itself ;;
1123 \(\)) : skip parens of shell function definition ;;
1124 {) : skip start of shell helper function ;;
1125 :) : skip null command ;;
1126 \'*) : skip opening quote after sh -c ;;
1128 echo "$word"
1129 return
1130 esac
1131 done
1134 # Check whether one of the given words is present on the command line,
1135 # and print the first word found.
1137 # Usage: __git_find_on_cmdline [<option>]... "<wordlist>"
1138 # --show-idx: Optionally show the index of the found word in the $words array.
1139 __git_find_on_cmdline ()
1141 local word c=1 show_idx
1143 while test $# -gt 1; do
1144 case "$1" in
1145 --show-idx) show_idx=y ;;
1146 *) return 1 ;;
1147 esac
1148 shift
1149 done
1150 local wordlist="$1"
1152 while [ $c -lt $cword ]; do
1153 for word in $wordlist; do
1154 if [ "$word" = "${words[c]}" ]; then
1155 if [ -n "${show_idx-}" ]; then
1156 echo "$c $word"
1157 else
1158 echo "$word"
1160 return
1162 done
1163 ((c++))
1164 done
1167 # Similar to __git_find_on_cmdline, except that it loops backwards and thus
1168 # prints the *last* word found. Useful for finding which of two options that
1169 # supersede each other came last, such as "--guess" and "--no-guess".
1171 # Usage: __git_find_last_on_cmdline [<option>]... "<wordlist>"
1172 # --show-idx: Optionally show the index of the found word in the $words array.
1173 __git_find_last_on_cmdline ()
1175 local word c=$cword show_idx
1177 while test $# -gt 1; do
1178 case "$1" in
1179 --show-idx) show_idx=y ;;
1180 *) return 1 ;;
1181 esac
1182 shift
1183 done
1184 local wordlist="$1"
1186 while [ $c -gt 1 ]; do
1187 ((c--))
1188 for word in $wordlist; do
1189 if [ "$word" = "${words[c]}" ]; then
1190 if [ -n "$show_idx" ]; then
1191 echo "$c $word"
1192 else
1193 echo "$word"
1195 return
1197 done
1198 done
1201 # Echo the value of an option set on the command line or config
1203 # $1: short option name
1204 # $2: long option name including =
1205 # $3: list of possible values
1206 # $4: config string (optional)
1208 # example:
1209 # result="$(__git_get_option_value "-d" "--do-something=" \
1210 # "yes no" "core.doSomething")"
1212 # result is then either empty (no option set) or "yes" or "no"
1214 # __git_get_option_value requires 3 arguments
1215 __git_get_option_value ()
1217 local c short_opt long_opt val
1218 local result= values config_key word
1220 short_opt="$1"
1221 long_opt="$2"
1222 values="$3"
1223 config_key="$4"
1225 ((c = $cword - 1))
1226 while [ $c -ge 0 ]; do
1227 word="${words[c]}"
1228 for val in $values; do
1229 if [ "$short_opt$val" = "$word" ] ||
1230 [ "$long_opt$val" = "$word" ]; then
1231 result="$val"
1232 break 2
1234 done
1235 ((c--))
1236 done
1238 if [ -n "$config_key" ] && [ -z "$result" ]; then
1239 result="$(__git config "$config_key")"
1242 echo "$result"
1245 __git_has_doubledash ()
1247 local c=1
1248 while [ $c -lt $cword ]; do
1249 if [ "--" = "${words[c]}" ]; then
1250 return 0
1252 ((c++))
1253 done
1254 return 1
1257 # Try to count non option arguments passed on the command line for the
1258 # specified git command.
1259 # When options are used, it is necessary to use the special -- option to
1260 # tell the implementation were non option arguments begin.
1261 # XXX this can not be improved, since options can appear everywhere, as
1262 # an example:
1263 # git mv x -n y
1265 # __git_count_arguments requires 1 argument: the git command executed.
1266 __git_count_arguments ()
1268 local word i c=0
1270 # Skip "git" (first argument)
1271 for ((i=1; i < ${#words[@]}; i++)); do
1272 word="${words[i]}"
1274 case "$word" in
1276 # Good; we can assume that the following are only non
1277 # option arguments.
1278 ((c = 0))
1280 "$1")
1281 # Skip the specified git command and discard git
1282 # main options
1283 ((c = 0))
1286 ((c++))
1288 esac
1289 done
1291 printf "%d" $c
1294 __git_whitespacelist="nowarn warn error error-all fix"
1295 __git_patchformat="mbox stgit stgit-series hg mboxrd"
1296 __git_showcurrentpatch="diff raw"
1297 __git_am_inprogress_options="--skip --continue --resolved --abort --quit --show-current-patch"
1299 _git_am ()
1301 __git_find_repo_path
1302 if [ -d "$__git_repo_path"/rebase-apply ]; then
1303 __gitcomp "$__git_am_inprogress_options"
1304 return
1306 case "$cur" in
1307 --whitespace=*)
1308 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1309 return
1311 --patch-format=*)
1312 __gitcomp "$__git_patchformat" "" "${cur##--patch-format=}"
1313 return
1315 --show-current-patch=*)
1316 __gitcomp "$__git_showcurrentpatch" "" "${cur##--show-current-patch=}"
1317 return
1319 --*)
1320 __gitcomp_builtin am "" \
1321 "$__git_am_inprogress_options"
1322 return
1323 esac
1326 _git_apply ()
1328 case "$cur" in
1329 --whitespace=*)
1330 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1331 return
1333 --*)
1334 __gitcomp_builtin apply
1335 return
1336 esac
1339 _git_add ()
1341 case "$cur" in
1342 --chmod=*)
1343 __gitcomp "+x -x" "" "${cur##--chmod=}"
1344 return
1346 --*)
1347 __gitcomp_builtin add
1348 return
1349 esac
1351 local complete_opt="--others --modified --directory --no-empty-directory"
1352 if test -n "$(__git_find_on_cmdline "-u --update")"
1353 then
1354 complete_opt="--modified"
1356 __git_complete_index_file "$complete_opt"
1359 _git_archive ()
1361 case "$cur" in
1362 --format=*)
1363 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
1364 return
1366 --remote=*)
1367 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
1368 return
1370 --*)
1371 __gitcomp_builtin archive "--format= --list --verbose --prefix= --worktree-attributes"
1372 return
1374 esac
1375 __git_complete_file
1378 _git_bisect ()
1380 __git_has_doubledash && return
1382 local subcommands="start bad good skip reset visualize replay log run"
1383 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1384 if [ -z "$subcommand" ]; then
1385 __git_find_repo_path
1386 if [ -f "$__git_repo_path"/BISECT_START ]; then
1387 __gitcomp "$subcommands"
1388 else
1389 __gitcomp "replay start"
1391 return
1394 case "$subcommand" in
1395 bad|good|reset|skip|start)
1396 __git_complete_refs
1400 esac
1403 __git_ref_fieldlist="refname objecttype objectsize objectname upstream push HEAD symref"
1405 _git_branch ()
1407 local i c=1 only_local_ref="n" has_r="n"
1409 while [ $c -lt $cword ]; do
1410 i="${words[c]}"
1411 case "$i" in
1412 -d|--delete|-m|--move) only_local_ref="y" ;;
1413 -r|--remotes) has_r="y" ;;
1414 esac
1415 ((c++))
1416 done
1418 case "$cur" in
1419 --set-upstream-to=*)
1420 __git_complete_refs --cur="${cur##--set-upstream-to=}"
1422 --*)
1423 __gitcomp_builtin branch
1426 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
1427 __gitcomp_direct "$(__git_heads "" "$cur" " ")"
1428 else
1429 __git_complete_refs
1432 esac
1435 _git_bundle ()
1437 local cmd="${words[2]}"
1438 case "$cword" in
1440 __gitcomp "create list-heads verify unbundle"
1443 # looking for a file
1446 case "$cmd" in
1447 create)
1448 __git_complete_revlist
1450 esac
1452 esac
1455 # Helper function to decide whether or not we should enable DWIM logic for
1456 # git-switch and git-checkout.
1458 # To decide between the following rules in priority order
1459 # 1) the last provided of "--guess" or "--no-guess" explicitly enable or
1460 # disable completion of DWIM logic respectively.
1461 # 2) If the --no-track option is provided, take this as a hint to disable the
1462 # DWIM completion logic
1463 # 3) If GIT_COMPLETION_CHECKOUT_NO_GUESS is set, disable the DWIM completion
1464 # logic, as requested by the user.
1465 # 4) Enable DWIM logic otherwise.
1467 __git_checkout_default_dwim_mode ()
1469 local last_option dwim_opt="--dwim"
1471 if [ "${GIT_COMPLETION_CHECKOUT_NO_GUESS-}" = "1" ]; then
1472 dwim_opt=""
1475 # --no-track disables DWIM, but with lower priority than
1476 # --guess/--no-guess
1477 if [ -n "$(__git_find_on_cmdline "--no-track")" ]; then
1478 dwim_opt=""
1481 # Find the last provided --guess or --no-guess
1482 last_option="$(__git_find_last_on_cmdline "--guess --no-guess")"
1483 case "$last_option" in
1484 --guess)
1485 dwim_opt="--dwim"
1487 --no-guess)
1488 dwim_opt=""
1490 esac
1492 echo "$dwim_opt"
1495 _git_checkout ()
1497 __git_has_doubledash && return
1499 case "$cur" in
1500 --conflict=*)
1501 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1503 --*)
1504 __gitcomp_builtin checkout
1507 local dwim_opt="$(__git_checkout_default_dwim_mode)"
1508 local prevword prevword="${words[cword-1]}"
1510 case "$prevword" in
1511 -b|-B|--orphan)
1512 # Complete local branches (and DWIM branch
1513 # remote branch names) for an option argument
1514 # specifying a new branch name. This is for
1515 # convenience, assuming new branches are
1516 # possibly based on pre-existing branch names.
1517 __git_complete_refs $dwim_opt --mode="heads"
1518 return
1522 esac
1524 # At this point, we've already handled special completion for
1525 # the arguments to -b/-B, and --orphan. There are 3 main
1526 # things left we can possibly complete:
1527 # 1) a start-point for -b/-B, -d/--detach, or --orphan
1528 # 2) a remote head, for --track
1529 # 3) an arbitrary reference, possibly including DWIM names
1532 if [ -n "$(__git_find_on_cmdline "-b -B -d --detach --orphan")" ]; then
1533 __git_complete_refs --mode="refs"
1534 elif [ -n "$(__git_find_on_cmdline "--track")" ]; then
1535 __git_complete_refs --mode="remote-heads"
1536 else
1537 __git_complete_refs $dwim_opt --mode="refs"
1540 esac
1543 __git_sequencer_inprogress_options="--continue --quit --abort --skip"
1545 __git_cherry_pick_inprogress_options=$__git_sequencer_inprogress_options
1547 _git_cherry_pick ()
1549 __git_find_repo_path
1550 if [ -f "$__git_repo_path"/CHERRY_PICK_HEAD ]; then
1551 __gitcomp "$__git_cherry_pick_inprogress_options"
1552 return
1555 __git_complete_strategy && return
1557 case "$cur" in
1558 --*)
1559 __gitcomp_builtin cherry-pick "" \
1560 "$__git_cherry_pick_inprogress_options"
1563 __git_complete_refs
1565 esac
1568 _git_clean ()
1570 case "$cur" in
1571 --*)
1572 __gitcomp_builtin clean
1573 return
1575 esac
1577 # XXX should we check for -x option ?
1578 __git_complete_index_file "--others --directory"
1581 _git_clone ()
1583 case "$prev" in
1584 -c|--config)
1585 __git_complete_config_variable_name_and_value
1586 return
1588 esac
1589 case "$cur" in
1590 --config=*)
1591 __git_complete_config_variable_name_and_value \
1592 --cur="${cur##--config=}"
1593 return
1595 --*)
1596 __gitcomp_builtin clone
1597 return
1599 esac
1602 __git_untracked_file_modes="all no normal"
1604 _git_commit ()
1606 case "$prev" in
1607 -c|-C)
1608 __git_complete_refs
1609 return
1611 esac
1613 case "$cur" in
1614 --cleanup=*)
1615 __gitcomp "default scissors strip verbatim whitespace
1616 " "" "${cur##--cleanup=}"
1617 return
1619 --reuse-message=*|--reedit-message=*|\
1620 --fixup=*|--squash=*)
1621 __git_complete_refs --cur="${cur#*=}"
1622 return
1624 --untracked-files=*)
1625 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
1626 return
1628 --*)
1629 __gitcomp_builtin commit
1630 return
1631 esac
1633 if __git rev-parse --verify --quiet HEAD >/dev/null; then
1634 __git_complete_index_file "--committable"
1635 else
1636 # This is the first commit
1637 __git_complete_index_file "--cached"
1641 _git_describe ()
1643 case "$cur" in
1644 --*)
1645 __gitcomp_builtin describe
1646 return
1647 esac
1648 __git_complete_refs
1651 __git_diff_algorithms="myers minimal patience histogram"
1653 __git_diff_submodule_formats="diff log short"
1655 __git_color_moved_opts="no default plain blocks zebra dimmed-zebra"
1657 __git_color_moved_ws_opts="no ignore-space-at-eol ignore-space-change
1658 ignore-all-space allow-indentation-change"
1660 __git_diff_common_options="--stat --numstat --shortstat --summary
1661 --patch-with-stat --name-only --name-status --color
1662 --no-color --color-words --no-renames --check
1663 --color-moved --color-moved= --no-color-moved
1664 --color-moved-ws= --no-color-moved-ws
1665 --full-index --binary --abbrev --diff-filter=
1666 --find-copies-harder --ignore-cr-at-eol
1667 --text --ignore-space-at-eol --ignore-space-change
1668 --ignore-all-space --ignore-blank-lines --exit-code
1669 --quiet --ext-diff --no-ext-diff
1670 --no-prefix --src-prefix= --dst-prefix=
1671 --inter-hunk-context=
1672 --patience --histogram --minimal
1673 --raw --word-diff --word-diff-regex=
1674 --dirstat --dirstat= --dirstat-by-file
1675 --dirstat-by-file= --cumulative
1676 --diff-algorithm=
1677 --submodule --submodule= --ignore-submodules
1678 --indent-heuristic --no-indent-heuristic
1679 --textconv --no-textconv
1682 _git_diff ()
1684 __git_has_doubledash && return
1686 case "$cur" in
1687 --diff-algorithm=*)
1688 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1689 return
1691 --submodule=*)
1692 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1693 return
1695 --color-moved=*)
1696 __gitcomp "$__git_color_moved_opts" "" "${cur##--color-moved=}"
1697 return
1699 --color-moved-ws=*)
1700 __gitcomp "$__git_color_moved_ws_opts" "" "${cur##--color-moved-ws=}"
1701 return
1703 --*)
1704 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1705 --base --ours --theirs --no-index
1706 $__git_diff_common_options
1708 return
1710 esac
1711 __git_complete_revlist_file
1714 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1715 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc
1716 codecompare smerge
1719 _git_difftool ()
1721 __git_has_doubledash && return
1723 case "$cur" in
1724 --tool=*)
1725 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1726 return
1728 --*)
1729 __gitcomp_builtin difftool "$__git_diff_common_options
1730 --base --cached --ours --theirs
1731 --pickaxe-all --pickaxe-regex
1732 --relative --staged
1734 return
1736 esac
1737 __git_complete_revlist_file
1740 __git_fetch_recurse_submodules="yes on-demand no"
1742 _git_fetch ()
1744 case "$cur" in
1745 --recurse-submodules=*)
1746 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1747 return
1749 --filter=*)
1750 __gitcomp "blob:none blob:limit= sparse:oid=" "" "${cur##--filter=}"
1751 return
1753 --*)
1754 __gitcomp_builtin fetch
1755 return
1757 esac
1758 __git_complete_remote_or_refspec
1761 __git_format_patch_extra_options="
1762 --full-index --not --all --no-prefix --src-prefix=
1763 --dst-prefix= --notes
1766 _git_format_patch ()
1768 case "$cur" in
1769 --thread=*)
1770 __gitcomp "
1771 deep shallow
1772 " "" "${cur##--thread=}"
1773 return
1775 --*)
1776 __gitcomp_builtin format-patch "$__git_format_patch_extra_options"
1777 return
1779 esac
1780 __git_complete_revlist
1783 _git_fsck ()
1785 case "$cur" in
1786 --*)
1787 __gitcomp_builtin fsck
1788 return
1790 esac
1793 _git_gitk ()
1795 _gitk
1798 # Lists matching symbol names from a tag (as in ctags) file.
1799 # 1: List symbol names matching this word.
1800 # 2: The tag file to list symbol names from.
1801 # 3: A prefix to be added to each listed symbol name (optional).
1802 # 4: A suffix to be appended to each listed symbol name (optional).
1803 __git_match_ctag () {
1804 awk -v pfx="${3-}" -v sfx="${4-}" "
1805 /^${1//\//\\/}/ { print pfx \$1 sfx }
1806 " "$2"
1809 # Complete symbol names from a tag file.
1810 # Usage: __git_complete_symbol [<option>]...
1811 # --tags=<file>: The tag file to list symbol names from instead of the
1812 # default "tags".
1813 # --pfx=<prefix>: A prefix to be added to each symbol name.
1814 # --cur=<word>: The current symbol name to be completed. Defaults to
1815 # the current word to be completed.
1816 # --sfx=<suffix>: A suffix to be appended to each symbol name instead
1817 # of the default space.
1818 __git_complete_symbol () {
1819 local tags=tags pfx="" cur_="${cur-}" sfx=" "
1821 while test $# != 0; do
1822 case "$1" in
1823 --tags=*) tags="${1##--tags=}" ;;
1824 --pfx=*) pfx="${1##--pfx=}" ;;
1825 --cur=*) cur_="${1##--cur=}" ;;
1826 --sfx=*) sfx="${1##--sfx=}" ;;
1827 *) return 1 ;;
1828 esac
1829 shift
1830 done
1832 if test -r "$tags"; then
1833 __gitcomp_direct "$(__git_match_ctag "$cur_" "$tags" "$pfx" "$sfx")"
1837 _git_grep ()
1839 __git_has_doubledash && return
1841 case "$cur" in
1842 --*)
1843 __gitcomp_builtin grep
1844 return
1846 esac
1848 case "$cword,$prev" in
1849 2,*|*,-*)
1850 __git_complete_symbol && return
1852 esac
1854 __git_complete_refs
1857 _git_help ()
1859 case "$cur" in
1860 --*)
1861 __gitcomp_builtin help
1862 return
1864 esac
1865 if test -n "$GIT_TESTING_ALL_COMMAND_LIST"
1866 then
1867 __gitcomp "$GIT_TESTING_ALL_COMMAND_LIST $(__git --list-cmds=alias,list-guide) gitk"
1868 else
1869 __gitcomp "$(__git --list-cmds=main,nohelpers,alias,list-guide) gitk"
1873 _git_init ()
1875 case "$cur" in
1876 --shared=*)
1877 __gitcomp "
1878 false true umask group all world everybody
1879 " "" "${cur##--shared=}"
1880 return
1882 --*)
1883 __gitcomp_builtin init
1884 return
1886 esac
1889 _git_ls_files ()
1891 case "$cur" in
1892 --*)
1893 __gitcomp_builtin ls-files
1894 return
1896 esac
1898 # XXX ignore options like --modified and always suggest all cached
1899 # files.
1900 __git_complete_index_file "--cached"
1903 _git_ls_remote ()
1905 case "$cur" in
1906 --*)
1907 __gitcomp_builtin ls-remote
1908 return
1910 esac
1911 __gitcomp_nl "$(__git_remotes)"
1914 _git_ls_tree ()
1916 case "$cur" in
1917 --*)
1918 __gitcomp_builtin ls-tree
1919 return
1921 esac
1923 __git_complete_file
1926 # Options that go well for log, shortlog and gitk
1927 __git_log_common_options="
1928 --not --all
1929 --branches --tags --remotes
1930 --first-parent --merges --no-merges
1931 --max-count=
1932 --max-age= --since= --after=
1933 --min-age= --until= --before=
1934 --min-parents= --max-parents=
1935 --no-min-parents --no-max-parents
1937 # Options that go well for log and gitk (not shortlog)
1938 __git_log_gitk_options="
1939 --dense --sparse --full-history
1940 --simplify-merges --simplify-by-decoration
1941 --left-right --notes --no-notes
1943 # Options that go well for log and shortlog (not gitk)
1944 __git_log_shortlog_options="
1945 --author= --committer= --grep=
1946 --all-match --invert-grep
1949 __git_log_pretty_formats="oneline short medium full fuller reference email raw format: tformat: mboxrd"
1950 __git_log_date_formats="relative iso8601 iso8601-strict rfc2822 short local default raw unix format:"
1952 _git_log ()
1954 __git_has_doubledash && return
1955 __git_find_repo_path
1957 local merge=""
1958 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
1959 merge="--merge"
1961 case "$prev,$cur" in
1962 -L,:*:*)
1963 return # fall back to Bash filename completion
1965 -L,:*)
1966 __git_complete_symbol --cur="${cur#:}" --sfx=":"
1967 return
1969 -G,*|-S,*)
1970 __git_complete_symbol
1971 return
1973 esac
1974 case "$cur" in
1975 --pretty=*|--format=*)
1976 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1977 " "" "${cur#*=}"
1978 return
1980 --date=*)
1981 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1982 return
1984 --decorate=*)
1985 __gitcomp "full short no" "" "${cur##--decorate=}"
1986 return
1988 --diff-algorithm=*)
1989 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1990 return
1992 --submodule=*)
1993 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1994 return
1996 --no-walk=*)
1997 __gitcomp "sorted unsorted" "" "${cur##--no-walk=}"
1998 return
2000 --*)
2001 __gitcomp "
2002 $__git_log_common_options
2003 $__git_log_shortlog_options
2004 $__git_log_gitk_options
2005 --root --topo-order --date-order --reverse
2006 --follow --full-diff
2007 --abbrev-commit --no-abbrev-commit --abbrev=
2008 --relative-date --date=
2009 --pretty= --format= --oneline
2010 --show-signature
2011 --cherry-mark
2012 --cherry-pick
2013 --graph
2014 --decorate --decorate= --no-decorate
2015 --walk-reflogs
2016 --no-walk --no-walk= --do-walk
2017 --parents --children
2018 --expand-tabs --expand-tabs= --no-expand-tabs
2019 --patch
2020 $merge
2021 $__git_diff_common_options
2022 --pickaxe-all --pickaxe-regex
2023 --patch --no-patch
2025 return
2027 -L:*:*)
2028 return # fall back to Bash filename completion
2030 -L:*)
2031 __git_complete_symbol --cur="${cur#-L:}" --sfx=":"
2032 return
2034 -G*)
2035 __git_complete_symbol --pfx="-G" --cur="${cur#-G}"
2036 return
2038 -S*)
2039 __git_complete_symbol --pfx="-S" --cur="${cur#-S}"
2040 return
2042 esac
2043 __git_complete_revlist
2046 _git_merge ()
2048 __git_complete_strategy && return
2050 case "$cur" in
2051 --*)
2052 __gitcomp_builtin merge
2053 return
2054 esac
2055 __git_complete_refs
2058 _git_mergetool ()
2060 case "$cur" in
2061 --tool=*)
2062 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
2063 return
2065 --*)
2066 __gitcomp "--tool= --prompt --no-prompt --gui --no-gui"
2067 return
2069 esac
2072 _git_merge_base ()
2074 case "$cur" in
2075 --*)
2076 __gitcomp_builtin merge-base
2077 return
2079 esac
2080 __git_complete_refs
2083 _git_mv ()
2085 case "$cur" in
2086 --*)
2087 __gitcomp_builtin mv
2088 return
2090 esac
2092 if [ $(__git_count_arguments "mv") -gt 0 ]; then
2093 # We need to show both cached and untracked files (including
2094 # empty directories) since this may not be the last argument.
2095 __git_complete_index_file "--cached --others --directory"
2096 else
2097 __git_complete_index_file "--cached"
2101 _git_notes ()
2103 local subcommands='add append copy edit get-ref list merge prune remove show'
2104 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2106 case "$subcommand,$cur" in
2107 ,--*)
2108 __gitcomp_builtin notes
2111 case "$prev" in
2112 --ref)
2113 __git_complete_refs
2116 __gitcomp "$subcommands --ref"
2118 esac
2120 *,--reuse-message=*|*,--reedit-message=*)
2121 __git_complete_refs --cur="${cur#*=}"
2123 *,--*)
2124 __gitcomp_builtin notes_$subcommand
2126 prune,*|get-ref,*)
2127 # this command does not take a ref, do not complete it
2130 case "$prev" in
2131 -m|-F)
2134 __git_complete_refs
2136 esac
2138 esac
2141 _git_pull ()
2143 __git_complete_strategy && return
2145 case "$cur" in
2146 --recurse-submodules=*)
2147 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
2148 return
2150 --*)
2151 __gitcomp_builtin pull
2153 return
2155 esac
2156 __git_complete_remote_or_refspec
2159 __git_push_recurse_submodules="check on-demand only"
2161 __git_complete_force_with_lease ()
2163 local cur_=$1
2165 case "$cur_" in
2166 --*=)
2168 *:*)
2169 __git_complete_refs --cur="${cur_#*:}"
2172 __git_complete_refs --cur="$cur_"
2174 esac
2177 _git_push ()
2179 case "$prev" in
2180 --repo)
2181 __gitcomp_nl "$(__git_remotes)"
2182 return
2184 --recurse-submodules)
2185 __gitcomp "$__git_push_recurse_submodules"
2186 return
2188 esac
2189 case "$cur" in
2190 --repo=*)
2191 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
2192 return
2194 --recurse-submodules=*)
2195 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
2196 return
2198 --force-with-lease=*)
2199 __git_complete_force_with_lease "${cur##--force-with-lease=}"
2200 return
2202 --*)
2203 __gitcomp_builtin push
2204 return
2206 esac
2207 __git_complete_remote_or_refspec
2210 _git_range_diff ()
2212 case "$cur" in
2213 --*)
2214 __gitcomp "
2215 --creation-factor= --no-dual-color
2216 $__git_diff_common_options
2218 return
2220 esac
2221 __git_complete_revlist
2224 __git_rebase_inprogress_options="--continue --skip --abort --quit --show-current-patch"
2225 __git_rebase_interactive_inprogress_options="$__git_rebase_inprogress_options --edit-todo"
2227 _git_rebase ()
2229 __git_find_repo_path
2230 if [ -f "$__git_repo_path"/rebase-merge/interactive ]; then
2231 __gitcomp "$__git_rebase_interactive_inprogress_options"
2232 return
2233 elif [ -d "$__git_repo_path"/rebase-apply ] || \
2234 [ -d "$__git_repo_path"/rebase-merge ]; then
2235 __gitcomp "$__git_rebase_inprogress_options"
2236 return
2238 __git_complete_strategy && return
2239 case "$cur" in
2240 --whitespace=*)
2241 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
2242 return
2244 --onto=*)
2245 __git_complete_refs --cur="${cur##--onto=}"
2246 return
2248 --*)
2249 __gitcomp_builtin rebase "" \
2250 "$__git_rebase_interactive_inprogress_options"
2252 return
2253 esac
2254 __git_complete_refs
2257 _git_reflog ()
2259 local subcommands="show delete expire"
2260 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2262 if [ -z "$subcommand" ]; then
2263 __gitcomp "$subcommands"
2264 else
2265 __git_complete_refs
2269 __git_send_email_confirm_options="always never auto cc compose"
2270 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
2272 _git_send_email ()
2274 case "$prev" in
2275 --to|--cc|--bcc|--from)
2276 __gitcomp "$(__git send-email --dump-aliases)"
2277 return
2279 esac
2281 case "$cur" in
2282 --confirm=*)
2283 __gitcomp "
2284 $__git_send_email_confirm_options
2285 " "" "${cur##--confirm=}"
2286 return
2288 --suppress-cc=*)
2289 __gitcomp "
2290 $__git_send_email_suppresscc_options
2291 " "" "${cur##--suppress-cc=}"
2293 return
2295 --smtp-encryption=*)
2296 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
2297 return
2299 --thread=*)
2300 __gitcomp "
2301 deep shallow
2302 " "" "${cur##--thread=}"
2303 return
2305 --to=*|--cc=*|--bcc=*|--from=*)
2306 __gitcomp "$(__git send-email --dump-aliases)" "" "${cur#--*=}"
2307 return
2309 --*)
2310 __gitcomp_builtin send-email "--annotate --bcc --cc --cc-cmd --chain-reply-to
2311 --compose --confirm= --dry-run --envelope-sender
2312 --from --identity
2313 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
2314 --no-suppress-from --no-thread --quiet --reply-to
2315 --signed-off-by-cc --smtp-pass --smtp-server
2316 --smtp-server-port --smtp-encryption= --smtp-user
2317 --subject --suppress-cc= --suppress-from --thread --to
2318 --validate --no-validate
2319 $__git_format_patch_extra_options"
2320 return
2322 esac
2323 __git_complete_revlist
2326 _git_stage ()
2328 _git_add
2331 _git_status ()
2333 local complete_opt
2334 local untracked_state
2336 case "$cur" in
2337 --ignore-submodules=*)
2338 __gitcomp "none untracked dirty all" "" "${cur##--ignore-submodules=}"
2339 return
2341 --untracked-files=*)
2342 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
2343 return
2345 --column=*)
2346 __gitcomp "
2347 always never auto column row plain dense nodense
2348 " "" "${cur##--column=}"
2349 return
2351 --*)
2352 __gitcomp_builtin status
2353 return
2355 esac
2357 untracked_state="$(__git_get_option_value "-u" "--untracked-files=" \
2358 "$__git_untracked_file_modes" "status.showUntrackedFiles")"
2360 case "$untracked_state" in
2362 # --ignored option does not matter
2363 complete_opt=
2365 all|normal|*)
2366 complete_opt="--cached --directory --no-empty-directory --others"
2368 if [ -n "$(__git_find_on_cmdline "--ignored")" ]; then
2369 complete_opt="$complete_opt --ignored --exclude=*"
2372 esac
2374 __git_complete_index_file "$complete_opt"
2377 _git_switch ()
2379 case "$cur" in
2380 --conflict=*)
2381 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
2383 --*)
2384 __gitcomp_builtin switch
2387 local dwim_opt="$(__git_checkout_default_dwim_mode)"
2388 local prevword prevword="${words[cword-1]}"
2390 case "$prevword" in
2391 -c|-C|--orphan)
2392 # Complete local branches (and DWIM branch
2393 # remote branch names) for an option argument
2394 # specifying a new branch name. This is for
2395 # convenience, assuming new branches are
2396 # possibly based on pre-existing branch names.
2397 __git_complete_refs $dwim_opt --mode="heads"
2398 return
2402 esac
2404 # Unlike in git checkout, git switch --orphan does not take
2405 # a start point. Thus we really have nothing to complete after
2406 # the branch name.
2407 if [ -n "$(__git_find_on_cmdline "--orphan")" ]; then
2408 return
2411 # At this point, we've already handled special completion for
2412 # -c/-C, and --orphan. There are 3 main things left to
2413 # complete:
2414 # 1) a start-point for -c/-C or -d/--detach
2415 # 2) a remote head, for --track
2416 # 3) a branch name, possibly including DWIM remote branches
2418 if [ -n "$(__git_find_on_cmdline "-c -C -d --detach")" ]; then
2419 __git_complete_refs --mode="refs"
2420 elif [ -n "$(__git_find_on_cmdline "--track")" ]; then
2421 __git_complete_refs --mode="remote-heads"
2422 else
2423 __git_complete_refs $dwim_opt --mode="heads"
2426 esac
2429 __git_config_get_set_variables ()
2431 local prevword word config_file= c=$cword
2432 while [ $c -gt 1 ]; do
2433 word="${words[c]}"
2434 case "$word" in
2435 --system|--global|--local|--file=*)
2436 config_file="$word"
2437 break
2439 -f|--file)
2440 config_file="$word $prevword"
2441 break
2443 esac
2444 prevword=$word
2445 c=$((--c))
2446 done
2448 __git config $config_file --name-only --list
2451 __git_config_vars=
2452 __git_compute_config_vars ()
2454 test -n "$__git_config_vars" ||
2455 __git_config_vars="$(git help --config-for-completion | sort -u)"
2458 # Completes possible values of various configuration variables.
2460 # Usage: __git_complete_config_variable_value [<option>]...
2461 # --varname=<word>: The name of the configuration variable whose value is
2462 # to be completed. Defaults to the previous word on the
2463 # command line.
2464 # --cur=<word>: The current value to be completed. Defaults to the current
2465 # word to be completed.
2466 __git_complete_config_variable_value ()
2468 local varname="$prev" cur_="$cur"
2470 while test $# != 0; do
2471 case "$1" in
2472 --varname=*) varname="${1##--varname=}" ;;
2473 --cur=*) cur_="${1##--cur=}" ;;
2474 *) return 1 ;;
2475 esac
2476 shift
2477 done
2479 if [ "${BASH_VERSINFO[0]:-0}" -ge 4 ]; then
2480 varname="${varname,,}"
2481 else
2482 varname="$(echo "$varname" |tr A-Z a-z)"
2485 case "$varname" in
2486 branch.*.remote|branch.*.pushremote)
2487 __gitcomp_nl "$(__git_remotes)" "" "$cur_"
2488 return
2490 branch.*.merge)
2491 __git_complete_refs --cur="$cur_"
2492 return
2494 branch.*.rebase)
2495 __gitcomp "false true merges preserve interactive" "" "$cur_"
2496 return
2498 remote.pushdefault)
2499 __gitcomp_nl "$(__git_remotes)" "" "$cur_"
2500 return
2502 remote.*.fetch)
2503 local remote="${varname#remote.}"
2504 remote="${remote%.fetch}"
2505 if [ -z "$cur_" ]; then
2506 __gitcomp_nl "refs/heads/" "" "" ""
2507 return
2509 __gitcomp_nl "$(__git_refs_remotes "$remote")" "" "$cur_"
2510 return
2512 remote.*.push)
2513 local remote="${varname#remote.}"
2514 remote="${remote%.push}"
2515 __gitcomp_nl "$(__git for-each-ref \
2516 --format='%(refname):%(refname)' refs/heads)" "" "$cur_"
2517 return
2519 pull.twohead|pull.octopus)
2520 __git_compute_merge_strategies
2521 __gitcomp "$__git_merge_strategies" "" "$cur_"
2522 return
2524 color.pager)
2525 __gitcomp "false true" "" "$cur_"
2526 return
2528 color.*.*)
2529 __gitcomp "
2530 normal black red green yellow blue magenta cyan white
2531 bold dim ul blink reverse
2532 " "" "$cur_"
2533 return
2535 color.*)
2536 __gitcomp "false true always never auto" "" "$cur_"
2537 return
2539 diff.submodule)
2540 __gitcomp "$__git_diff_submodule_formats" "" "$cur_"
2541 return
2543 help.format)
2544 __gitcomp "man info web html" "" "$cur_"
2545 return
2547 log.date)
2548 __gitcomp "$__git_log_date_formats" "" "$cur_"
2549 return
2551 sendemail.aliasfiletype)
2552 __gitcomp "mutt mailrc pine elm gnus" "" "$cur_"
2553 return
2555 sendemail.confirm)
2556 __gitcomp "$__git_send_email_confirm_options" "" "$cur_"
2557 return
2559 sendemail.suppresscc)
2560 __gitcomp "$__git_send_email_suppresscc_options" "" "$cur_"
2561 return
2563 sendemail.transferencoding)
2564 __gitcomp "7bit 8bit quoted-printable base64" "" "$cur_"
2565 return
2567 *.*)
2568 return
2570 esac
2573 # Completes configuration sections, subsections, variable names.
2575 # Usage: __git_complete_config_variable_name [<option>]...
2576 # --cur=<word>: The current configuration section/variable name to be
2577 # completed. Defaults to the current word to be completed.
2578 # --sfx=<suffix>: A suffix to be appended to each fully completed
2579 # configuration variable name (but not to sections or
2580 # subsections) instead of the default space.
2581 __git_complete_config_variable_name ()
2583 local cur_="$cur" sfx
2585 while test $# != 0; do
2586 case "$1" in
2587 --cur=*) cur_="${1##--cur=}" ;;
2588 --sfx=*) sfx="${1##--sfx=}" ;;
2589 *) return 1 ;;
2590 esac
2591 shift
2592 done
2594 case "$cur_" in
2595 branch.*.*)
2596 local pfx="${cur_%.*}."
2597 cur_="${cur_##*.}"
2598 __gitcomp "remote pushRemote merge mergeOptions rebase" "$pfx" "$cur_" "$sfx"
2599 return
2601 branch.*)
2602 local pfx="${cur%.*}."
2603 cur_="${cur#*.}"
2604 __gitcomp_direct "$(__git_heads "$pfx" "$cur_" ".")"
2605 __gitcomp_nl_append $'autoSetupMerge\nautoSetupRebase\n' "$pfx" "$cur_" "$sfx"
2606 return
2608 guitool.*.*)
2609 local pfx="${cur_%.*}."
2610 cur_="${cur_##*.}"
2611 __gitcomp "
2612 argPrompt cmd confirm needsFile noConsole noRescan
2613 prompt revPrompt revUnmerged title
2614 " "$pfx" "$cur_" "$sfx"
2615 return
2617 difftool.*.*)
2618 local pfx="${cur_%.*}."
2619 cur_="${cur_##*.}"
2620 __gitcomp "cmd path" "$pfx" "$cur_" "$sfx"
2621 return
2623 man.*.*)
2624 local pfx="${cur_%.*}."
2625 cur_="${cur_##*.}"
2626 __gitcomp "cmd path" "$pfx" "$cur_" "$sfx"
2627 return
2629 mergetool.*.*)
2630 local pfx="${cur_%.*}."
2631 cur_="${cur_##*.}"
2632 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_" "$sfx"
2633 return
2635 pager.*)
2636 local pfx="${cur_%.*}."
2637 cur_="${cur_#*.}"
2638 __git_compute_all_commands
2639 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_" "$sfx"
2640 return
2642 remote.*.*)
2643 local pfx="${cur_%.*}."
2644 cur_="${cur_##*.}"
2645 __gitcomp "
2646 url proxy fetch push mirror skipDefaultUpdate
2647 receivepack uploadpack tagOpt pushurl
2648 " "$pfx" "$cur_" "$sfx"
2649 return
2651 remote.*)
2652 local pfx="${cur_%.*}."
2653 cur_="${cur_#*.}"
2654 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
2655 __gitcomp_nl_append "pushDefault" "$pfx" "$cur_" "$sfx"
2656 return
2658 url.*.*)
2659 local pfx="${cur_%.*}."
2660 cur_="${cur_##*.}"
2661 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_" "$sfx"
2662 return
2664 *.*)
2665 __git_compute_config_vars
2666 __gitcomp "$__git_config_vars" "" "$cur_" "$sfx"
2669 __git_compute_config_vars
2670 __gitcomp "$(echo "$__git_config_vars" |
2671 awk -F . '{
2672 sections[$1] = 1
2674 END {
2675 for (s in sections)
2676 print s "."
2678 ')" "" "$cur_"
2680 esac
2683 # Completes '='-separated configuration sections/variable names and values
2684 # for 'git -c section.name=value'.
2686 # Usage: __git_complete_config_variable_name_and_value [<option>]...
2687 # --cur=<word>: The current configuration section/variable name/value to be
2688 # completed. Defaults to the current word to be completed.
2689 __git_complete_config_variable_name_and_value ()
2691 local cur_="$cur"
2693 while test $# != 0; do
2694 case "$1" in
2695 --cur=*) cur_="${1##--cur=}" ;;
2696 *) return 1 ;;
2697 esac
2698 shift
2699 done
2701 case "$cur_" in
2702 *=*)
2703 __git_complete_config_variable_value \
2704 --varname="${cur_%%=*}" --cur="${cur_#*=}"
2707 __git_complete_config_variable_name --cur="$cur_" --sfx='='
2709 esac
2712 _git_config ()
2714 case "$prev" in
2715 --get|--get-all|--unset|--unset-all)
2716 __gitcomp_nl "$(__git_config_get_set_variables)"
2717 return
2719 *.*)
2720 __git_complete_config_variable_value
2721 return
2723 esac
2724 case "$cur" in
2725 --*)
2726 __gitcomp_builtin config
2729 __git_complete_config_variable_name
2731 esac
2734 _git_remote ()
2736 local subcommands="
2737 add rename remove set-head set-branches
2738 get-url set-url show prune update
2740 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2741 if [ -z "$subcommand" ]; then
2742 case "$cur" in
2743 --*)
2744 __gitcomp_builtin remote
2747 __gitcomp "$subcommands"
2749 esac
2750 return
2753 case "$subcommand,$cur" in
2754 add,--*)
2755 __gitcomp_builtin remote_add
2757 add,*)
2759 set-head,--*)
2760 __gitcomp_builtin remote_set-head
2762 set-branches,--*)
2763 __gitcomp_builtin remote_set-branches
2765 set-head,*|set-branches,*)
2766 __git_complete_remote_or_refspec
2768 update,--*)
2769 __gitcomp_builtin remote_update
2771 update,*)
2772 __gitcomp "$(__git_remotes) $(__git_get_config_variables "remotes")"
2774 set-url,--*)
2775 __gitcomp_builtin remote_set-url
2777 get-url,--*)
2778 __gitcomp_builtin remote_get-url
2780 prune,--*)
2781 __gitcomp_builtin remote_prune
2784 __gitcomp_nl "$(__git_remotes)"
2786 esac
2789 _git_replace ()
2791 case "$cur" in
2792 --format=*)
2793 __gitcomp "short medium long" "" "${cur##--format=}"
2794 return
2796 --*)
2797 __gitcomp_builtin replace
2798 return
2800 esac
2801 __git_complete_refs
2804 _git_rerere ()
2806 local subcommands="clear forget diff remaining status gc"
2807 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2808 if test -z "$subcommand"
2809 then
2810 __gitcomp "$subcommands"
2811 return
2815 _git_reset ()
2817 __git_has_doubledash && return
2819 case "$cur" in
2820 --*)
2821 __gitcomp_builtin reset
2822 return
2824 esac
2825 __git_complete_refs
2828 _git_restore ()
2830 case "$cur" in
2831 --conflict=*)
2832 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
2834 --source=*)
2835 __git_complete_refs --cur="${cur##--source=}"
2837 --*)
2838 __gitcomp_builtin restore
2840 esac
2843 __git_revert_inprogress_options=$__git_sequencer_inprogress_options
2845 _git_revert ()
2847 __git_find_repo_path
2848 if [ -f "$__git_repo_path"/REVERT_HEAD ]; then
2849 __gitcomp "$__git_revert_inprogress_options"
2850 return
2852 __git_complete_strategy && return
2853 case "$cur" in
2854 --*)
2855 __gitcomp_builtin revert "" \
2856 "$__git_revert_inprogress_options"
2857 return
2859 esac
2860 __git_complete_refs
2863 _git_rm ()
2865 case "$cur" in
2866 --*)
2867 __gitcomp_builtin rm
2868 return
2870 esac
2872 __git_complete_index_file "--cached"
2875 _git_shortlog ()
2877 __git_has_doubledash && return
2879 case "$cur" in
2880 --*)
2881 __gitcomp "
2882 $__git_log_common_options
2883 $__git_log_shortlog_options
2884 --numbered --summary --email
2886 return
2888 esac
2889 __git_complete_revlist
2892 _git_show ()
2894 __git_has_doubledash && return
2896 case "$cur" in
2897 --pretty=*|--format=*)
2898 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2899 " "" "${cur#*=}"
2900 return
2902 --diff-algorithm=*)
2903 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2904 return
2906 --submodule=*)
2907 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
2908 return
2910 --color-moved=*)
2911 __gitcomp "$__git_color_moved_opts" "" "${cur##--color-moved=}"
2912 return
2914 --color-moved-ws=*)
2915 __gitcomp "$__git_color_moved_ws_opts" "" "${cur##--color-moved-ws=}"
2916 return
2918 --*)
2919 __gitcomp "--pretty= --format= --abbrev-commit --no-abbrev-commit
2920 --oneline --show-signature --patch
2921 --expand-tabs --expand-tabs= --no-expand-tabs
2922 $__git_diff_common_options
2924 return
2926 esac
2927 __git_complete_revlist_file
2930 _git_show_branch ()
2932 case "$cur" in
2933 --*)
2934 __gitcomp_builtin show-branch
2935 return
2937 esac
2938 __git_complete_revlist
2941 _git_sparse_checkout ()
2943 local subcommands="list init set disable"
2944 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2945 if [ -z "$subcommand" ]; then
2946 __gitcomp "$subcommands"
2947 return
2950 case "$subcommand,$cur" in
2951 init,--*)
2952 __gitcomp "--cone"
2954 set,--*)
2955 __gitcomp "--stdin"
2959 esac
2962 _git_stash ()
2964 local save_opts='--all --keep-index --no-keep-index --quiet --patch --include-untracked'
2965 local subcommands='push list show apply clear drop pop create branch'
2966 local subcommand="$(__git_find_on_cmdline "$subcommands save")"
2967 if [ -z "$subcommand" -a -n "$(__git_find_on_cmdline "-p")" ]; then
2968 subcommand="push"
2970 if [ -z "$subcommand" ]; then
2971 case "$cur" in
2972 --*)
2973 __gitcomp "$save_opts"
2975 sa*)
2976 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2977 __gitcomp "save"
2981 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2982 __gitcomp "$subcommands"
2985 esac
2986 else
2987 case "$subcommand,$cur" in
2988 push,--*)
2989 __gitcomp "$save_opts --message"
2991 save,--*)
2992 __gitcomp "$save_opts"
2994 apply,--*|pop,--*)
2995 __gitcomp "--index --quiet"
2997 drop,--*)
2998 __gitcomp "--quiet"
3000 list,--*)
3001 __gitcomp "--name-status --oneline --patch-with-stat"
3003 show,--*|branch,--*)
3005 branch,*)
3006 if [ $cword -eq 3 ]; then
3007 __git_complete_refs
3008 else
3009 __gitcomp_nl "$(__git stash list \
3010 | sed -n -e 's/:.*//p')"
3013 show,*|apply,*|drop,*|pop,*)
3014 __gitcomp_nl "$(__git stash list \
3015 | sed -n -e 's/:.*//p')"
3019 esac
3023 _git_submodule ()
3025 __git_has_doubledash && return
3027 local subcommands="add status init deinit update set-branch set-url summary foreach sync absorbgitdirs"
3028 local subcommand="$(__git_find_on_cmdline "$subcommands")"
3029 if [ -z "$subcommand" ]; then
3030 case "$cur" in
3031 --*)
3032 __gitcomp "--quiet"
3035 __gitcomp "$subcommands"
3037 esac
3038 return
3041 case "$subcommand,$cur" in
3042 add,--*)
3043 __gitcomp "--branch --force --name --reference --depth"
3045 status,--*)
3046 __gitcomp "--cached --recursive"
3048 deinit,--*)
3049 __gitcomp "--force --all"
3051 update,--*)
3052 __gitcomp "
3053 --init --remote --no-fetch
3054 --recommend-shallow --no-recommend-shallow
3055 --force --rebase --merge --reference --depth --recursive --jobs
3058 set-branch,--*)
3059 __gitcomp "--default --branch"
3061 summary,--*)
3062 __gitcomp "--cached --files --summary-limit"
3064 foreach,--*|sync,--*)
3065 __gitcomp "--recursive"
3069 esac
3072 _git_svn ()
3074 local subcommands="
3075 init fetch clone rebase dcommit log find-rev
3076 set-tree commit-diff info create-ignore propget
3077 proplist show-ignore show-externals branch tag blame
3078 migrate mkdirs reset gc
3080 local subcommand="$(__git_find_on_cmdline "$subcommands")"
3081 if [ -z "$subcommand" ]; then
3082 __gitcomp "$subcommands"
3083 else
3084 local remote_opts="--username= --config-dir= --no-auth-cache"
3085 local fc_opts="
3086 --follow-parent --authors-file= --repack=
3087 --no-metadata --use-svm-props --use-svnsync-props
3088 --log-window-size= --no-checkout --quiet
3089 --repack-flags --use-log-author --localtime
3090 --add-author-from
3091 --recursive
3092 --ignore-paths= --include-paths= $remote_opts
3094 local init_opts="
3095 --template= --shared= --trunk= --tags=
3096 --branches= --stdlayout --minimize-url
3097 --no-metadata --use-svm-props --use-svnsync-props
3098 --rewrite-root= --prefix= $remote_opts
3100 local cmt_opts="
3101 --edit --rmdir --find-copies-harder --copy-similarity=
3104 case "$subcommand,$cur" in
3105 fetch,--*)
3106 __gitcomp "--revision= --fetch-all $fc_opts"
3108 clone,--*)
3109 __gitcomp "--revision= $fc_opts $init_opts"
3111 init,--*)
3112 __gitcomp "$init_opts"
3114 dcommit,--*)
3115 __gitcomp "
3116 --merge --strategy= --verbose --dry-run
3117 --fetch-all --no-rebase --commit-url
3118 --revision --interactive $cmt_opts $fc_opts
3121 set-tree,--*)
3122 __gitcomp "--stdin $cmt_opts $fc_opts"
3124 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
3125 show-externals,--*|mkdirs,--*)
3126 __gitcomp "--revision="
3128 log,--*)
3129 __gitcomp "
3130 --limit= --revision= --verbose --incremental
3131 --oneline --show-commit --non-recursive
3132 --authors-file= --color
3135 rebase,--*)
3136 __gitcomp "
3137 --merge --verbose --strategy= --local
3138 --fetch-all --dry-run $fc_opts
3141 commit-diff,--*)
3142 __gitcomp "--message= --file= --revision= $cmt_opts"
3144 info,--*)
3145 __gitcomp "--url"
3147 branch,--*)
3148 __gitcomp "--dry-run --message --tag"
3150 tag,--*)
3151 __gitcomp "--dry-run --message"
3153 blame,--*)
3154 __gitcomp "--git-format"
3156 migrate,--*)
3157 __gitcomp "
3158 --config-dir= --ignore-paths= --minimize
3159 --no-auth-cache --username=
3162 reset,--*)
3163 __gitcomp "--revision= --parent"
3167 esac
3171 _git_tag ()
3173 local i c=1 f=0
3174 while [ $c -lt $cword ]; do
3175 i="${words[c]}"
3176 case "$i" in
3177 -d|--delete|-v|--verify)
3178 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
3179 return
3184 esac
3185 ((c++))
3186 done
3188 case "$prev" in
3189 -m|-F)
3191 -*|tag)
3192 if [ $f = 1 ]; then
3193 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
3197 __git_complete_refs
3199 esac
3201 case "$cur" in
3202 --*)
3203 __gitcomp_builtin tag
3205 esac
3208 _git_whatchanged ()
3210 _git_log
3213 __git_complete_worktree_paths ()
3215 local IFS=$'\n'
3216 __gitcomp_nl "$(git worktree list --porcelain |
3217 # Skip the first entry: it's the path of the main worktree,
3218 # which can't be moved, removed, locked, etc.
3219 sed -n -e '2,$ s/^worktree //p')"
3222 _git_worktree ()
3224 local subcommands="add list lock move prune remove unlock"
3225 local subcommand subcommand_idx
3227 subcommand="$(__git_find_on_cmdline --show-idx "$subcommands")"
3228 subcommand_idx="${subcommand% *}"
3229 subcommand="${subcommand#* }"
3231 case "$subcommand,$cur" in
3233 __gitcomp "$subcommands"
3235 *,--*)
3236 __gitcomp_builtin worktree_$subcommand
3238 add,*) # usage: git worktree add [<options>] <path> [<commit-ish>]
3239 # Here we are not completing an --option, it's either the
3240 # path or a ref.
3241 case "$prev" in
3242 -b|-B) # Complete refs for branch to be created/reseted.
3243 __git_complete_refs
3245 -*) # The previous word is an -o|--option without an
3246 # unstuck argument: have to complete the path for
3247 # the new worktree, so don't list anything, but let
3248 # Bash fall back to filename completion.
3250 *) # The previous word is not an --option, so it must
3251 # be either the 'add' subcommand, the unstuck
3252 # argument of an option (e.g. branch for -b|-B), or
3253 # the path for the new worktree.
3254 if [ $cword -eq $((subcommand_idx+1)) ]; then
3255 # Right after the 'add' subcommand: have to
3256 # complete the path, so fall back to Bash
3257 # filename completion.
3259 else
3260 case "${words[cword-2]}" in
3261 -b|-B) # After '-b <branch>': have to
3262 # complete the path, so fall back
3263 # to Bash filename completion.
3265 *) # After the path: have to complete
3266 # the ref to be checked out.
3267 __git_complete_refs
3269 esac
3272 esac
3274 lock,*|remove,*|unlock,*)
3275 __git_complete_worktree_paths
3277 move,*)
3278 if [ $cword -eq $((subcommand_idx+1)) ]; then
3279 # The first parameter must be an existing working
3280 # tree to be moved.
3281 __git_complete_worktree_paths
3282 else
3283 # The second parameter is the destination: it could
3284 # be any path, so don't list anything, but let Bash
3285 # fall back to filename completion.
3289 esac
3292 __git_complete_common () {
3293 local command="$1"
3295 case "$cur" in
3296 --*)
3297 __gitcomp_builtin "$command"
3299 esac
3302 __git_cmds_with_parseopt_helper=
3303 __git_support_parseopt_helper () {
3304 test -n "$__git_cmds_with_parseopt_helper" ||
3305 __git_cmds_with_parseopt_helper="$(__git --list-cmds=parseopt)"
3307 case " $__git_cmds_with_parseopt_helper " in
3308 *" $1 "*)
3309 return 0
3312 return 1
3314 esac
3317 __git_complete_command () {
3318 local command="$1"
3319 local completion_func="_git_${command//-/_}"
3320 if ! declare -f $completion_func >/dev/null 2>/dev/null &&
3321 declare -f _completion_loader >/dev/null 2>/dev/null
3322 then
3323 _completion_loader "git-$command"
3325 if declare -f $completion_func >/dev/null 2>/dev/null
3326 then
3327 $completion_func
3328 return 0
3329 elif __git_support_parseopt_helper "$command"
3330 then
3331 __git_complete_common "$command"
3332 return 0
3333 else
3334 return 1
3338 __git_main ()
3340 local i c=1 command __git_dir __git_repo_path
3341 local __git_C_args C_args_count=0
3343 while [ $c -lt $cword ]; do
3344 i="${words[c]}"
3345 case "$i" in
3346 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
3347 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
3348 --bare) __git_dir="." ;;
3349 --help) command="help"; break ;;
3350 -c|--work-tree|--namespace) ((c++)) ;;
3351 -C) __git_C_args[C_args_count++]=-C
3352 ((c++))
3353 __git_C_args[C_args_count++]="${words[c]}"
3355 -*) ;;
3356 *) command="$i"; break ;;
3357 esac
3358 ((c++))
3359 done
3361 if [ -z "${command-}" ]; then
3362 case "$prev" in
3363 --git-dir|-C|--work-tree)
3364 # these need a path argument, let's fall back to
3365 # Bash filename completion
3366 return
3369 __git_complete_config_variable_name_and_value
3370 return
3372 --namespace)
3373 # we don't support completing these options' arguments
3374 return
3376 esac
3377 case "$cur" in
3378 --*) __gitcomp "
3379 --paginate
3380 --no-pager
3381 --git-dir=
3382 --bare
3383 --version
3384 --exec-path
3385 --exec-path=
3386 --html-path
3387 --man-path
3388 --info-path
3389 --work-tree=
3390 --namespace=
3391 --no-replace-objects
3392 --help
3396 if test -n "${GIT_TESTING_PORCELAIN_COMMAND_LIST-}"
3397 then
3398 __gitcomp "$GIT_TESTING_PORCELAIN_COMMAND_LIST"
3399 else
3400 __gitcomp "$(__git --list-cmds=list-mainporcelain,others,nohelpers,alias,list-complete,config)"
3403 esac
3404 return
3407 __git_complete_command "$command" && return
3409 local expansion=$(__git_aliased_command "$command")
3410 if [ -n "$expansion" ]; then
3411 words[1]=$expansion
3412 __git_complete_command "$expansion"
3416 __gitk_main ()
3418 __git_has_doubledash && return
3420 local __git_repo_path
3421 __git_find_repo_path
3423 local merge=""
3424 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
3425 merge="--merge"
3427 case "$cur" in
3428 --*)
3429 __gitcomp "
3430 $__git_log_common_options
3431 $__git_log_gitk_options
3432 $merge
3434 return
3436 esac
3437 __git_complete_revlist
3440 if [[ -n ${ZSH_VERSION-} ]] &&
3441 # Don't define these functions when sourced from 'git-completion.zsh',
3442 # it has its own implementations.
3443 [[ -z ${GIT_SOURCING_ZSH_COMPLETION-} ]]; then
3444 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
3446 autoload -U +X compinit && compinit
3448 __gitcomp ()
3450 emulate -L zsh
3452 local cur_="${3-$cur}"
3454 case "$cur_" in
3455 --*=)
3458 local c IFS=$' \t\n'
3459 local -a array
3460 for c in ${=1}; do
3461 c="$c${4-}"
3462 case $c in
3463 --*=*|*.) ;;
3464 *) c="$c " ;;
3465 esac
3466 array[${#array[@]}+1]="$c"
3467 done
3468 compset -P '*[=:]'
3469 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
3471 esac
3474 __gitcomp_direct ()
3476 emulate -L zsh
3478 local IFS=$'\n'
3479 compset -P '*[=:]'
3480 compadd -Q -- ${=1} && _ret=0
3483 __gitcomp_nl ()
3485 emulate -L zsh
3487 local IFS=$'\n'
3488 compset -P '*[=:]'
3489 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
3492 __gitcomp_file_direct ()
3494 emulate -L zsh
3496 local IFS=$'\n'
3497 compset -P '*[=:]'
3498 compadd -f -- ${=1} && _ret=0
3501 __gitcomp_file ()
3503 emulate -L zsh
3505 local IFS=$'\n'
3506 compset -P '*[=:]'
3507 compadd -p "${2-}" -f -- ${=1} && _ret=0
3510 _git ()
3512 local _ret=1 cur cword prev
3513 cur=${words[CURRENT]}
3514 prev=${words[CURRENT-1]}
3515 let cword=CURRENT-1
3516 emulate ksh -c __${service}_main
3517 let _ret && _default && _ret=0
3518 return _ret
3521 compdef _git git gitk
3522 return
3525 __git_func_wrap ()
3527 local cur words cword prev
3528 _get_comp_words_by_ref -n =: cur words cword prev
3532 # Setup completion for certain functions defined above by setting common
3533 # variables and workarounds.
3534 # This is NOT a public function; use at your own risk.
3535 __git_complete ()
3537 local wrapper="__git_wrap${2}"
3538 eval "$wrapper () { __git_func_wrap $2 ; }"
3539 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
3540 || complete -o default -o nospace -F $wrapper $1
3543 # wrapper for backwards compatibility
3544 _git ()
3546 __git_wrap__git_main
3549 # wrapper for backwards compatibility
3550 _gitk ()
3552 __git_wrap__gitk_main
3555 __git_complete git __git_main
3556 __git_complete gitk __gitk_main
3558 # The following are necessary only for Cygwin, and only are needed
3559 # when the user has tab-completed the executable name and consequently
3560 # included the '.exe' suffix.
3562 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
3563 __git_complete git.exe __git_main