1# bash/zsh completion support for core Git.
2#
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.
6#
7# The contained completion routines provide support for completing:
8#
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
17#
18# To use these routines:
19#
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.
25#
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 ; ... '".
31#
32# Compatible with bash 3.2.57.
33#
34# You can set the following environment variables to influence the behavior of
35# the completion routines:
36#
37# GIT_COMPLETION_CHECKOUT_NO_GUESS
38#
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).
42
43case "$COMP_WORDBREAKS" in
44*:*) : great ;;
45*) COMP_WORDBREAKS="$COMP_WORDBREAKS:"
46esac
47
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 ()
52{
53 if [ -n "$__git_repo_path" ]; then
54 # we already know where it is
55 return
56 fi
57
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)"
72 fi
73}
74
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 ()
79{
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"
87 fi
88}
89
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 ()
93{
94 git ${__git_C_args:+"${__git_C_args[@]}"} \
95 ${__git_dir:+--git-dir="$__git_dir"} "$@" 2>/dev/null
96}
97
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 ()
102{
103 local rest="$1" len ch
104
105 dequoted_word=""
106
107 while test -n "$rest"; do
108 len=${#dequoted_word}
109 dequoted_word="$dequoted_word${rest%%[\\\'\"]*}"
110 rest="${rest:$((${#dequoted_word}-$len))}"
111
112 case "${rest:0:1}" in
113 \\)
114 ch="${rest:1:1}"
115 case "$ch" in
116 $'\n')
117 ;;
118 *)
119 dequoted_word="$dequoted_word$ch"
120 ;;
121 esac
122 rest="${rest:2}"
123 ;;
124 \')
125 rest="${rest:1}"
126 len=${#dequoted_word}
127 dequoted_word="$dequoted_word${rest%%\'*}"
128 rest="${rest:$((${#dequoted_word}-$len+1))}"
129 ;;
130 \")
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
137 \\)
138 ch="${rest:1:1}"
139 case "$ch" in
140 \"|\\|\$|\`)
141 dequoted_word="$dequoted_word$ch"
142 ;;
143 $'\n')
144 ;;
145 *)
146 dequoted_word="$dequoted_word\\$ch"
147 ;;
148 esac
149 rest="${rest:2}"
150 ;;
151 \")
152 rest="${rest:1}"
153 break
154 ;;
155 esac
156 done
157 ;;
158 esac
159 done
160}
161
162# The following function is based on code from:
163#
164# bash_completion - programmable completion functions for bash 3.2+
165#
166# Copyright © 2006-2008, Ian Macdonald <ian@caliban.org>
167# © 2009-2010, Bash Completion Maintainers
168# <bash-completion-devel@lists.alioth.debian.org>
169#
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.
174#
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.
179#
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/>.
182#
183# The latest version of this software can be obtained here:
184#
185# http://bash-completion.alioth.debian.org/
186#
187# RELEASE: 2.x
188
189# This function can be used to access a tokenized list of words
190# on the command line:
191#
192# __git_reassemble_comp_words_by_ref '=:'
193# if test "${words_[cword_-1]}" = -w
194# then
195# ...
196# fi
197#
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.
201#
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.
206#
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.
211#
212# Output: words_, cword_, cur_.
213
214__git_reassemble_comp_words_by_ref()
215{
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
223 fi
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]}" ]
235 do
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--))
240 fi
241 first=
242 words_[$j]=${words_[j]}${COMP_WORDS[i]}
243 if [ $i = $COMP_CWORD ]; then
244 cword_=$j
245 fi
246 if (($i < ${#COMP_WORDS[@]} - 1)); then
247 ((i++))
248 else
249 # Done.
250 return
251 fi
252 done
253 words_[$j]=${words_[j]}${COMP_WORDS[i]}
254 if [ $i = $COMP_CWORD ]; then
255 cword_=$j
256 fi
257 done
258}
259
260if ! type _get_comp_words_by_ref >/dev/null 2>&1; then
261_get_comp_words_by_ref ()
262{
263 local exclude cur_ words_ cword_
264 if [ "$1" = "-n" ]; then
265 exclude=$2
266 shift 2
267 fi
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_
274 ;;
275 prev)
276 prev=${words_[$cword_-1]}
277 ;;
278 words)
279 words=("${words_[@]}")
280 ;;
281 cword)
282 cword=$cword_
283 ;;
284 esac
285 shift
286 done
287}
288fi
289
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 ()
298{
299 local IFS=$'\n'
300
301 COMPREPLY=($1)
302}
303
304__gitcompappend ()
305{
306 local x i=${#COMPREPLY[@]}
307 for x in $1; do
308 if [[ "$x" == "$3"* ]]; then
309 COMPREPLY[i++]="$2$x$4"
310 fi
311 done
312}
313
314__gitcompadd ()
315{
316 COMPREPLY=()
317 __gitcompappend "$@"
318}
319
320# Generates completion reply, appending a space to possible completion words,
321# if necessary.
322# It accepts 1 to 4 arguments:
323# 1: List of possible completion words.
324# 2: A prefix to be added to each possible completion word (optional).
325# 3: Generate possible completion matches for this word (optional).
326# 4: A suffix to be appended to each possible completion word (optional).
327__gitcomp ()
328{
329 local cur_="${3-$cur}"
330
331 case "$cur_" in
332 --*=)
333 ;;
334 --no-*)
335 local c i=0 IFS=$' \t\n'
336 for c in $1; do
337 if [[ $c == "--" ]]; then
338 continue
339 fi
340 c="$c${4-}"
341 if [[ $c == "$cur_"* ]]; then
342 case $c in
343 --*=*|*.) ;;
344 *) c="$c " ;;
345 esac
346 COMPREPLY[i++]="${2-}$c"
347 fi
348 done
349 ;;
350 *)
351 local c i=0 IFS=$' \t\n'
352 for c in $1; do
353 if [[ $c == "--" ]]; then
354 c="--no-...${4-}"
355 if [[ $c == "$cur_"* ]]; then
356 COMPREPLY[i++]="${2-}$c "
357 fi
358 break
359 fi
360 c="$c${4-}"
361 if [[ $c == "$cur_"* ]]; then
362 case $c in
363 --*=*|*.) ;;
364 *) c="$c " ;;
365 esac
366 COMPREPLY[i++]="${2-}$c"
367 fi
368 done
369 ;;
370 esac
371}
372
373# Clear the variables caching builtins' options when (re-)sourcing
374# the completion script.
375if [[ -n ${ZSH_VERSION-} ]]; then
376 unset $(set |sed -ne 's/^\(__gitcomp_builtin_[a-zA-Z0-9_][a-zA-Z0-9_]*\)=.*/\1/p') 2>/dev/null
377else
378 unset $(compgen -v __gitcomp_builtin_)
379fi
380
381# This function is equivalent to
382#
383# __gitcomp "$(git xxx --git-completion-helper) ..."
384#
385# except that the output is cached. Accept 1-3 arguments:
386# 1: the git command to execute, this is also the cache key
387# 2: extra options to be added on top (e.g. negative forms)
388# 3: options to be excluded
389__gitcomp_builtin ()
390{
391 # spaces must be replaced with underscore for multi-word
392 # commands, e.g. "git remote add" becomes remote_add.
393 local cmd="$1"
394 local incl="$2"
395 local excl="$3"
396
397 local var=__gitcomp_builtin_"${cmd/-/_}"
398 local options
399 eval "options=\$$var"
400
401 if [ -z "$options" ]; then
402 # leading and trailing spaces are significant to make
403 # option removal work correctly.
404 options=" $incl $(__git ${cmd/_/ } --git-completion-helper) " || return
405
406 for i in $excl; do
407 options="${options/ $i / }"
408 done
409 eval "$var=\"$options\""
410 fi
411
412 __gitcomp "$options"
413}
414
415# Variation of __gitcomp_nl () that appends to the existing list of
416# completion candidates, COMPREPLY.
417__gitcomp_nl_append ()
418{
419 local IFS=$'\n'
420 __gitcompappend "$1" "${2-}" "${3-$cur}" "${4- }"
421}
422
423# Generates completion reply from newline-separated possible completion words
424# by appending a space to all of them.
425# It accepts 1 to 4 arguments:
426# 1: List of possible completion words, separated by a single newline.
427# 2: A prefix to be added to each possible completion word (optional).
428# 3: Generate possible completion matches for this word (optional).
429# 4: A suffix to be appended to each possible completion word instead of
430# the default space (optional). If specified but empty, nothing is
431# appended.
432__gitcomp_nl ()
433{
434 COMPREPLY=()
435 __gitcomp_nl_append "$@"
436}
437
438# Fills the COMPREPLY array with prefiltered paths without any additional
439# processing.
440# Callers must take care of providing only paths that match the current path
441# to be completed and adding any prefix path components, if necessary.
442# 1: List of newline-separated matching paths, complete with all prefix
443# path components.
444__gitcomp_file_direct ()
445{
446 local IFS=$'\n'
447
448 COMPREPLY=($1)
449
450 # use a hack to enable file mode in bash < 4
451 compopt -o filenames +o nospace 2>/dev/null ||
452 compgen -f /non-existing-dir/ >/dev/null ||
453 true
454}
455
456# Generates completion reply with compgen from newline-separated possible
457# completion filenames.
458# It accepts 1 to 3 arguments:
459# 1: List of possible completion filenames, separated by a single newline.
460# 2: A directory prefix to be added to each possible completion filename
461# (optional).
462# 3: Generate possible completion matches for this word (optional).
463__gitcomp_file ()
464{
465 local IFS=$'\n'
466
467 # XXX does not work when the directory prefix contains a tilde,
468 # since tilde expansion is not applied.
469 # This means that COMPREPLY will be empty and Bash default
470 # completion will be used.
471 __gitcompadd "$1" "${2-}" "${3-$cur}" ""
472
473 # use a hack to enable file mode in bash < 4
474 compopt -o filenames +o nospace 2>/dev/null ||
475 compgen -f /non-existing-dir/ >/dev/null ||
476 true
477}
478
479# Execute 'git ls-files', unless the --committable option is specified, in
480# which case it runs 'git diff-index' to find out the files that can be
481# committed. It return paths relative to the directory specified in the first
482# argument, and using the options specified in the second argument.
483__git_ls_files_helper ()
484{
485 if [ "$2" == "--committable" ]; then
486 __git -C "$1" -c core.quotePath=false diff-index \
487 --name-only --relative HEAD -- "${3//\\/\\\\}*"
488 else
489 # NOTE: $2 is not quoted in order to support multiple options
490 __git -C "$1" -c core.quotePath=false ls-files \
491 --exclude-standard $2 -- "${3//\\/\\\\}*"
492 fi
493}
494
495
496# __git_index_files accepts 1 or 2 arguments:
497# 1: Options to pass to ls-files (required).
498# 2: A directory path (optional).
499# If provided, only files within the specified directory are listed.
500# Sub directories are never recursed. Path must have a trailing
501# slash.
502# 3: List only paths matching this path component (optional).
503__git_index_files ()
504{
505 local root="$2" match="$3"
506
507 __git_ls_files_helper "$root" "$1" "$match" |
508 awk -F / -v pfx="${2//\\/\\\\}" '{
509 paths[$1] = 1
510 }
511 END {
512 for (p in paths) {
513 if (substr(p, 1, 1) != "\"") {
514 # No special characters, easy!
515 print pfx p
516 continue
517 }
518
519 # The path is quoted.
520 p = dequote(p)
521 if (p == "")
522 continue
523
524 # Even when a directory name itself does not contain
525 # any special characters, it will still be quoted if
526 # any of its (stripped) trailing path components do.
527 # Because of this we may have seen the same direcory
528 # both quoted and unquoted.
529 if (p in paths)
530 # We have seen the same directory unquoted,
531 # skip it.
532 continue
533 else
534 print pfx p
535 }
536 }
537 function dequote(p, bs_idx, out, esc, esc_idx, dec) {
538 # Skip opening double quote.
539 p = substr(p, 2)
540
541 # Interpret backslash escape sequences.
542 while ((bs_idx = index(p, "\\")) != 0) {
543 out = out substr(p, 1, bs_idx - 1)
544 esc = substr(p, bs_idx + 1, 1)
545 p = substr(p, bs_idx + 2)
546
547 if ((esc_idx = index("abtvfr\"\\", esc)) != 0) {
548 # C-style one-character escape sequence.
549 out = out substr("\a\b\t\v\f\r\"\\",
550 esc_idx, 1)
551 } else if (esc == "n") {
552 # Uh-oh, a newline character.
553 # We cant reliably put a pathname
554 # containing a newline into COMPREPLY,
555 # and the newline would create a mess.
556 # Skip this path.
557 return ""
558 } else {
559 # Must be a \nnn octal value, then.
560 dec = esc * 64 + \
561 substr(p, 1, 1) * 8 + \
562 substr(p, 2, 1)
563 out = out sprintf("%c", dec)
564 p = substr(p, 3)
565 }
566 }
567 # Drop closing double quote, if there is one.
568 # (There isnt any if this is a directory, as it was
569 # already stripped with the trailing path components.)
570 if (substr(p, length(p), 1) == "\"")
571 out = out substr(p, 1, length(p) - 1)
572 else
573 out = out p
574
575 return out
576 }'
577}
578
579# __git_complete_index_file requires 1 argument:
580# 1: the options to pass to ls-file
581#
582# The exception is --committable, which finds the files appropriate commit.
583__git_complete_index_file ()
584{
585 local dequoted_word pfx="" cur_
586
587 __git_dequote "$cur"
588
589 case "$dequoted_word" in
590 ?*/*)
591 pfx="${dequoted_word%/*}/"
592 cur_="${dequoted_word##*/}"
593 ;;
594 *)
595 cur_="$dequoted_word"
596 esac
597
598 __gitcomp_file_direct "$(__git_index_files "$1" "$pfx" "$cur_")"
599}
600
601# Lists branches from the local repository.
602# 1: A prefix to be added to each listed branch (optional).
603# 2: List only branches matching this word (optional; list all branches if
604# unset or empty).
605# 3: A suffix to be appended to each listed branch (optional).
606__git_heads ()
607{
608 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
609
610 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
611 "refs/heads/$cur_*" "refs/heads/$cur_*/**"
612}
613
614# Lists tags from the local repository.
615# Accepts the same positional parameters as __git_heads() above.
616__git_tags ()
617{
618 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
619
620 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
621 "refs/tags/$cur_*" "refs/tags/$cur_*/**"
622}
623
624# Lists refs from the local (by default) or from a remote repository.
625# It accepts 0, 1 or 2 arguments:
626# 1: The remote to list refs from (optional; ignored, if set but empty).
627# Can be the name of a configured remote, a path, or a URL.
628# 2: In addition to local refs, list unique branches from refs/remotes/ for
629# 'git checkout's tracking DWIMery (optional; ignored, if set but empty).
630# 3: A prefix to be added to each listed ref (optional).
631# 4: List only refs matching this word (optional; list all refs if unset or
632# empty).
633# 5: A suffix to be appended to each listed ref (optional; ignored, if set
634# but empty).
635#
636# Use __git_complete_refs() instead.
637__git_refs ()
638{
639 local i hash dir track="${2-}"
640 local list_refs_from=path remote="${1-}"
641 local format refs
642 local pfx="${3-}" cur_="${4-$cur}" sfx="${5-}"
643 local match="${4-}"
644 local fer_pfx="${pfx//\%/%%}" # "escape" for-each-ref format specifiers
645
646 __git_find_repo_path
647 dir="$__git_repo_path"
648
649 if [ -z "$remote" ]; then
650 if [ -z "$dir" ]; then
651 return
652 fi
653 else
654 if __git_is_configured_remote "$remote"; then
655 # configured remote takes precedence over a
656 # local directory with the same name
657 list_refs_from=remote
658 elif [ -d "$remote/.git" ]; then
659 dir="$remote/.git"
660 elif [ -d "$remote" ]; then
661 dir="$remote"
662 else
663 list_refs_from=url
664 fi
665 fi
666
667 if [ "$list_refs_from" = path ]; then
668 if [[ "$cur_" == ^* ]]; then
669 pfx="$pfx^"
670 fer_pfx="$fer_pfx^"
671 cur_=${cur_#^}
672 match=${match#^}
673 fi
674 case "$cur_" in
675 refs|refs/*)
676 format="refname"
677 refs=("$match*" "$match*/**")
678 track=""
679 ;;
680 *)
681 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD REBASE_HEAD; do
682 case "$i" in
683 $match*)
684 if [ -e "$dir/$i" ]; then
685 echo "$pfx$i$sfx"
686 fi
687 ;;
688 esac
689 done
690 format="refname:strip=2"
691 refs=("refs/tags/$match*" "refs/tags/$match*/**"
692 "refs/heads/$match*" "refs/heads/$match*/**"
693 "refs/remotes/$match*" "refs/remotes/$match*/**")
694 ;;
695 esac
696 __git_dir="$dir" __git for-each-ref --format="$fer_pfx%($format)$sfx" \
697 "${refs[@]}"
698 if [ -n "$track" ]; then
699 # employ the heuristic used by git checkout
700 # Try to find a remote branch that matches the completion word
701 # but only output if the branch name is unique
702 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
703 --sort="refname:strip=3" \
704 "refs/remotes/*/$match*" "refs/remotes/*/$match*/**" | \
705 uniq -u
706 fi
707 return
708 fi
709 case "$cur_" in
710 refs|refs/*)
711 __git ls-remote "$remote" "$match*" | \
712 while read -r hash i; do
713 case "$i" in
714 *^{}) ;;
715 *) echo "$pfx$i$sfx" ;;
716 esac
717 done
718 ;;
719 *)
720 if [ "$list_refs_from" = remote ]; then
721 case "HEAD" in
722 $match*) echo "${pfx}HEAD$sfx" ;;
723 esac
724 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
725 "refs/remotes/$remote/$match*" \
726 "refs/remotes/$remote/$match*/**"
727 else
728 local query_symref
729 case "HEAD" in
730 $match*) query_symref="HEAD" ;;
731 esac
732 __git ls-remote "$remote" $query_symref \
733 "refs/tags/$match*" "refs/heads/$match*" \
734 "refs/remotes/$match*" |
735 while read -r hash i; do
736 case "$i" in
737 *^{}) ;;
738 refs/*) echo "$pfx${i#refs/*/}$sfx" ;;
739 *) echo "$pfx$i$sfx" ;; # symbolic refs
740 esac
741 done
742 fi
743 ;;
744 esac
745}
746
747# Completes refs, short and long, local and remote, symbolic and pseudo.
748#
749# Usage: __git_complete_refs [<option>]...
750# --remote=<remote>: The remote to list refs from, can be the name of a
751# configured remote, a path, or a URL.
752# --track: List unique remote branches for 'git checkout's tracking DWIMery.
753# --pfx=<prefix>: A prefix to be added to each ref.
754# --cur=<word>: The current ref to be completed. Defaults to the current
755# word to be completed.
756# --sfx=<suffix>: A suffix to be appended to each ref instead of the default
757# space.
758__git_complete_refs ()
759{
760 local remote track pfx cur_="$cur" sfx=" "
761
762 while test $# != 0; do
763 case "$1" in
764 --remote=*) remote="${1##--remote=}" ;;
765 --track) track="yes" ;;
766 --pfx=*) pfx="${1##--pfx=}" ;;
767 --cur=*) cur_="${1##--cur=}" ;;
768 --sfx=*) sfx="${1##--sfx=}" ;;
769 *) return 1 ;;
770 esac
771 shift
772 done
773
774 __gitcomp_direct "$(__git_refs "$remote" "$track" "$pfx" "$cur_" "$sfx")"
775}
776
777# __git_refs2 requires 1 argument (to pass to __git_refs)
778# Deprecated: use __git_complete_fetch_refspecs() instead.
779__git_refs2 ()
780{
781 local i
782 for i in $(__git_refs "$1"); do
783 echo "$i:$i"
784 done
785}
786
787# Completes refspecs for fetching from a remote repository.
788# 1: The remote repository.
789# 2: A prefix to be added to each listed refspec (optional).
790# 3: The ref to be completed as a refspec instead of the current word to be
791# completed (optional)
792# 4: A suffix to be appended to each listed refspec instead of the default
793# space (optional).
794__git_complete_fetch_refspecs ()
795{
796 local i remote="$1" pfx="${2-}" cur_="${3-$cur}" sfx="${4- }"
797
798 __gitcomp_direct "$(
799 for i in $(__git_refs "$remote" "" "" "$cur_") ; do
800 echo "$pfx$i:$i$sfx"
801 done
802 )"
803}
804
805# __git_refs_remotes requires 1 argument (to pass to ls-remote)
806__git_refs_remotes ()
807{
808 local i hash
809 __git ls-remote "$1" 'refs/heads/*' | \
810 while read -r hash i; do
811 echo "$i:refs/remotes/$1/${i#refs/heads/}"
812 done
813}
814
815__git_remotes ()
816{
817 __git_find_repo_path
818 test -d "$__git_repo_path/remotes" && ls -1 "$__git_repo_path/remotes"
819 __git remote
820}
821
822# Returns true if $1 matches the name of a configured remote, false otherwise.
823__git_is_configured_remote ()
824{
825 local remote
826 for remote in $(__git_remotes); do
827 if [ "$remote" = "$1" ]; then
828 return 0
829 fi
830 done
831 return 1
832}
833
834__git_list_merge_strategies ()
835{
836 LANG=C LC_ALL=C git merge -s help 2>&1 |
837 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
838 s/\.$//
839 s/.*://
840 s/^[ ]*//
841 s/[ ]*$//
842 p
843 }'
844}
845
846__git_merge_strategies=
847# 'git merge -s help' (and thus detection of the merge strategy
848# list) fails, unfortunately, if run outside of any git working
849# tree. __git_merge_strategies is set to the empty string in
850# that case, and the detection will be repeated the next time it
851# is needed.
852__git_compute_merge_strategies ()
853{
854 test -n "$__git_merge_strategies" ||
855 __git_merge_strategies=$(__git_list_merge_strategies)
856}
857
858__git_merge_strategy_options="ours theirs subtree subtree= patience
859 histogram diff-algorithm= ignore-space-change ignore-all-space
860 ignore-space-at-eol renormalize no-renormalize no-renames
861 find-renames find-renames= rename-threshold="
862
863__git_complete_revlist_file ()
864{
865 local dequoted_word pfx ls ref cur_="$cur"
866 case "$cur_" in
867 *..?*:*)
868 return
869 ;;
870 ?*:*)
871 ref="${cur_%%:*}"
872 cur_="${cur_#*:}"
873
874 __git_dequote "$cur_"
875
876 case "$dequoted_word" in
877 ?*/*)
878 pfx="${dequoted_word%/*}"
879 cur_="${dequoted_word##*/}"
880 ls="$ref:$pfx"
881 pfx="$pfx/"
882 ;;
883 *)
884 cur_="$dequoted_word"
885 ls="$ref"
886 ;;
887 esac
888
889 case "$COMP_WORDBREAKS" in
890 *:*) : great ;;
891 *) pfx="$ref:$pfx" ;;
892 esac
893
894 __gitcomp_file "$(__git ls-tree "$ls" \
895 | sed 's/^.* //
896 s/$//')" \
897 "$pfx" "$cur_"
898 ;;
899 *...*)
900 pfx="${cur_%...*}..."
901 cur_="${cur_#*...}"
902 __git_complete_refs --pfx="$pfx" --cur="$cur_"
903 ;;
904 *..*)
905 pfx="${cur_%..*}.."
906 cur_="${cur_#*..}"
907 __git_complete_refs --pfx="$pfx" --cur="$cur_"
908 ;;
909 *)
910 __git_complete_refs
911 ;;
912 esac
913}
914
915__git_complete_file ()
916{
917 __git_complete_revlist_file
918}
919
920__git_complete_revlist ()
921{
922 __git_complete_revlist_file
923}
924
925__git_complete_remote_or_refspec ()
926{
927 local cur_="$cur" cmd="${words[1]}"
928 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
929 if [ "$cmd" = "remote" ]; then
930 ((c++))
931 fi
932 while [ $c -lt $cword ]; do
933 i="${words[c]}"
934 case "$i" in
935 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
936 -d|--delete) [ "$cmd" = "push" ] && lhs=0 ;;
937 --all)
938 case "$cmd" in
939 push) no_complete_refspec=1 ;;
940 fetch)
941 return
942 ;;
943 *) ;;
944 esac
945 ;;
946 --multiple) no_complete_refspec=1; break ;;
947 -*) ;;
948 *) remote="$i"; break ;;
949 esac
950 ((c++))
951 done
952 if [ -z "$remote" ]; then
953 __gitcomp_nl "$(__git_remotes)"
954 return
955 fi
956 if [ $no_complete_refspec = 1 ]; then
957 return
958 fi
959 [ "$remote" = "." ] && remote=
960 case "$cur_" in
961 *:*)
962 case "$COMP_WORDBREAKS" in
963 *:*) : great ;;
964 *) pfx="${cur_%%:*}:" ;;
965 esac
966 cur_="${cur_#*:}"
967 lhs=0
968 ;;
969 +*)
970 pfx="+"
971 cur_="${cur_#+}"
972 ;;
973 esac
974 case "$cmd" in
975 fetch)
976 if [ $lhs = 1 ]; then
977 __git_complete_fetch_refspecs "$remote" "$pfx" "$cur_"
978 else
979 __git_complete_refs --pfx="$pfx" --cur="$cur_"
980 fi
981 ;;
982 pull|remote)
983 if [ $lhs = 1 ]; then
984 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
985 else
986 __git_complete_refs --pfx="$pfx" --cur="$cur_"
987 fi
988 ;;
989 push)
990 if [ $lhs = 1 ]; then
991 __git_complete_refs --pfx="$pfx" --cur="$cur_"
992 else
993 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
994 fi
995 ;;
996 esac
997}
998
999__git_complete_strategy ()
1000{
1001 __git_compute_merge_strategies
1002 case "$prev" in
1003 -s|--strategy)
1004 __gitcomp "$__git_merge_strategies"
1005 return 0
1006 ;;
1007 -X)
1008 __gitcomp "$__git_merge_strategy_options"
1009 return 0
1010 ;;
1011 esac
1012 case "$cur" in
1013 --strategy=*)
1014 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
1015 return 0
1016 ;;
1017 --strategy-option=*)
1018 __gitcomp "$__git_merge_strategy_options" "" "${cur##--strategy-option=}"
1019 return 0
1020 ;;
1021 esac
1022 return 1
1023}
1024
1025__git_all_commands=
1026__git_compute_all_commands ()
1027{
1028 test -n "$__git_all_commands" ||
1029 __git_all_commands=$(__git --list-cmds=main,others,alias,nohelpers)
1030}
1031
1032# Lists all set config variables starting with the given section prefix,
1033# with the prefix removed.
1034__git_get_config_variables ()
1035{
1036 local section="$1" i IFS=$'\n'
1037 for i in $(__git config --name-only --get-regexp "^$section\..*"); do
1038 echo "${i#$section.}"
1039 done
1040}
1041
1042__git_pretty_aliases ()
1043{
1044 __git_get_config_variables "pretty"
1045}
1046
1047# __git_aliased_command requires 1 argument
1048__git_aliased_command ()
1049{
1050 local word cmdline=$(__git config --get "alias.$1")
1051 for word in $cmdline; do
1052 case "$word" in
1053 \!gitk|gitk)
1054 echo "gitk"
1055 return
1056 ;;
1057 \!*) : shell command alias ;;
1058 -*) : option ;;
1059 *=*) : setting env ;;
1060 git) : git itself ;;
1061 \(\)) : skip parens of shell function definition ;;
1062 {) : skip start of shell helper function ;;
1063 :) : skip null command ;;
1064 \'*) : skip opening quote after sh -c ;;
1065 *)
1066 echo "$word"
1067 return
1068 esac
1069 done
1070}
1071
1072# __git_find_on_cmdline requires 1 argument
1073__git_find_on_cmdline ()
1074{
1075 local word subcommand c=1
1076 while [ $c -lt $cword ]; do
1077 word="${words[c]}"
1078 for subcommand in $1; do
1079 if [ "$subcommand" = "$word" ]; then
1080 echo "$subcommand"
1081 return
1082 fi
1083 done
1084 ((c++))
1085 done
1086}
1087
1088# Echo the value of an option set on the command line or config
1089#
1090# $1: short option name
1091# $2: long option name including =
1092# $3: list of possible values
1093# $4: config string (optional)
1094#
1095# example:
1096# result="$(__git_get_option_value "-d" "--do-something=" \
1097# "yes no" "core.doSomething")"
1098#
1099# result is then either empty (no option set) or "yes" or "no"
1100#
1101# __git_get_option_value requires 3 arguments
1102__git_get_option_value ()
1103{
1104 local c short_opt long_opt val
1105 local result= values config_key word
1106
1107 short_opt="$1"
1108 long_opt="$2"
1109 values="$3"
1110 config_key="$4"
1111
1112 ((c = $cword - 1))
1113 while [ $c -ge 0 ]; do
1114 word="${words[c]}"
1115 for val in $values; do
1116 if [ "$short_opt$val" = "$word" ] ||
1117 [ "$long_opt$val" = "$word" ]; then
1118 result="$val"
1119 break 2
1120 fi
1121 done
1122 ((c--))
1123 done
1124
1125 if [ -n "$config_key" ] && [ -z "$result" ]; then
1126 result="$(__git config "$config_key")"
1127 fi
1128
1129 echo "$result"
1130}
1131
1132__git_has_doubledash ()
1133{
1134 local c=1
1135 while [ $c -lt $cword ]; do
1136 if [ "--" = "${words[c]}" ]; then
1137 return 0
1138 fi
1139 ((c++))
1140 done
1141 return 1
1142}
1143
1144# Try to count non option arguments passed on the command line for the
1145# specified git command.
1146# When options are used, it is necessary to use the special -- option to
1147# tell the implementation were non option arguments begin.
1148# XXX this can not be improved, since options can appear everywhere, as
1149# an example:
1150# git mv x -n y
1151#
1152# __git_count_arguments requires 1 argument: the git command executed.
1153__git_count_arguments ()
1154{
1155 local word i c=0
1156
1157 # Skip "git" (first argument)
1158 for ((i=1; i < ${#words[@]}; i++)); do
1159 word="${words[i]}"
1160
1161 case "$word" in
1162 --)
1163 # Good; we can assume that the following are only non
1164 # option arguments.
1165 ((c = 0))
1166 ;;
1167 "$1")
1168 # Skip the specified git command and discard git
1169 # main options
1170 ((c = 0))
1171 ;;
1172 ?*)
1173 ((c++))
1174 ;;
1175 esac
1176 done
1177
1178 printf "%d" $c
1179}
1180
1181__git_whitespacelist="nowarn warn error error-all fix"
1182__git_patchformat="mbox stgit stgit-series hg mboxrd"
1183__git_am_inprogress_options="--skip --continue --resolved --abort --quit --show-current-patch"
1184
1185_git_am ()
1186{
1187 __git_find_repo_path
1188 if [ -d "$__git_repo_path"/rebase-apply ]; then
1189 __gitcomp "$__git_am_inprogress_options"
1190 return
1191 fi
1192 case "$cur" in
1193 --whitespace=*)
1194 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1195 return
1196 ;;
1197 --patch-format=*)
1198 __gitcomp "$__git_patchformat" "" "${cur##--patch-format=}"
1199 return
1200 ;;
1201 --*)
1202 __gitcomp_builtin am "" \
1203 "$__git_am_inprogress_options"
1204 return
1205 esac
1206}
1207
1208_git_apply ()
1209{
1210 case "$cur" in
1211 --whitespace=*)
1212 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1213 return
1214 ;;
1215 --*)
1216 __gitcomp_builtin apply
1217 return
1218 esac
1219}
1220
1221_git_add ()
1222{
1223 case "$cur" in
1224 --chmod=*)
1225 __gitcomp "+x -x" "" "${cur##--chmod=}"
1226 return
1227 ;;
1228 --*)
1229 __gitcomp_builtin add
1230 return
1231 esac
1232
1233 local complete_opt="--others --modified --directory --no-empty-directory"
1234 if test -n "$(__git_find_on_cmdline "-u --update")"
1235 then
1236 complete_opt="--modified"
1237 fi
1238 __git_complete_index_file "$complete_opt"
1239}
1240
1241_git_archive ()
1242{
1243 case "$cur" in
1244 --format=*)
1245 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
1246 return
1247 ;;
1248 --remote=*)
1249 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
1250 return
1251 ;;
1252 --*)
1253 __gitcomp "
1254 --format= --list --verbose
1255 --prefix= --remote= --exec= --output
1256 "
1257 return
1258 ;;
1259 esac
1260 __git_complete_file
1261}
1262
1263_git_bisect ()
1264{
1265 __git_has_doubledash && return
1266
1267 local subcommands="start bad good skip reset visualize replay log run"
1268 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1269 if [ -z "$subcommand" ]; then
1270 __git_find_repo_path
1271 if [ -f "$__git_repo_path"/BISECT_START ]; then
1272 __gitcomp "$subcommands"
1273 else
1274 __gitcomp "replay start"
1275 fi
1276 return
1277 fi
1278
1279 case "$subcommand" in
1280 bad|good|reset|skip|start)
1281 __git_complete_refs
1282 ;;
1283 *)
1284 ;;
1285 esac
1286}
1287
1288__git_ref_fieldlist="refname objecttype objectsize objectname upstream push HEAD symref"
1289
1290_git_branch ()
1291{
1292 local i c=1 only_local_ref="n" has_r="n"
1293
1294 while [ $c -lt $cword ]; do
1295 i="${words[c]}"
1296 case "$i" in
1297 -d|--delete|-m|--move) only_local_ref="y" ;;
1298 -r|--remotes) has_r="y" ;;
1299 esac
1300 ((c++))
1301 done
1302
1303 case "$cur" in
1304 --set-upstream-to=*)
1305 __git_complete_refs --cur="${cur##--set-upstream-to=}"
1306 ;;
1307 --*)
1308 __gitcomp_builtin branch
1309 ;;
1310 *)
1311 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
1312 __gitcomp_direct "$(__git_heads "" "$cur" " ")"
1313 else
1314 __git_complete_refs
1315 fi
1316 ;;
1317 esac
1318}
1319
1320_git_bundle ()
1321{
1322 local cmd="${words[2]}"
1323 case "$cword" in
1324 2)
1325 __gitcomp "create list-heads verify unbundle"
1326 ;;
1327 3)
1328 # looking for a file
1329 ;;
1330 *)
1331 case "$cmd" in
1332 create)
1333 __git_complete_revlist
1334 ;;
1335 esac
1336 ;;
1337 esac
1338}
1339
1340_git_checkout ()
1341{
1342 __git_has_doubledash && return
1343
1344 case "$cur" in
1345 --conflict=*)
1346 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1347 ;;
1348 --*)
1349 __gitcomp_builtin checkout
1350 ;;
1351 *)
1352 # check if --track, --no-track, or --no-guess was specified
1353 # if so, disable DWIM mode
1354 local flags="--track --no-track --no-guess" track_opt="--track"
1355 if [ "$GIT_COMPLETION_CHECKOUT_NO_GUESS" = "1" ] ||
1356 [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1357 track_opt=''
1358 fi
1359 __git_complete_refs $track_opt
1360 ;;
1361 esac
1362}
1363
1364__git_sequencer_inprogress_options="--continue --quit --abort --skip"
1365
1366__git_cherry_pick_inprogress_options=$__git_sequencer_inprogress_options
1367
1368_git_cherry_pick ()
1369{
1370 __git_find_repo_path
1371 if [ -f "$__git_repo_path"/CHERRY_PICK_HEAD ]; then
1372 __gitcomp "$__git_cherry_pick_inprogress_options"
1373 return
1374 fi
1375
1376 __git_complete_strategy && return
1377
1378 case "$cur" in
1379 --*)
1380 __gitcomp_builtin cherry-pick "" \
1381 "$__git_cherry_pick_inprogress_options"
1382 ;;
1383 *)
1384 __git_complete_refs
1385 ;;
1386 esac
1387}
1388
1389_git_clean ()
1390{
1391 case "$cur" in
1392 --*)
1393 __gitcomp_builtin clean
1394 return
1395 ;;
1396 esac
1397
1398 # XXX should we check for -x option ?
1399 __git_complete_index_file "--others --directory"
1400}
1401
1402_git_clone ()
1403{
1404 case "$cur" in
1405 --*)
1406 __gitcomp_builtin clone
1407 return
1408 ;;
1409 esac
1410}
1411
1412__git_untracked_file_modes="all no normal"
1413
1414_git_commit ()
1415{
1416 case "$prev" in
1417 -c|-C)
1418 __git_complete_refs
1419 return
1420 ;;
1421 esac
1422
1423 case "$cur" in
1424 --cleanup=*)
1425 __gitcomp "default scissors strip verbatim whitespace
1426 " "" "${cur##--cleanup=}"
1427 return
1428 ;;
1429 --reuse-message=*|--reedit-message=*|\
1430 --fixup=*|--squash=*)
1431 __git_complete_refs --cur="${cur#*=}"
1432 return
1433 ;;
1434 --untracked-files=*)
1435 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
1436 return
1437 ;;
1438 --*)
1439 __gitcomp_builtin commit
1440 return
1441 esac
1442
1443 if __git rev-parse --verify --quiet HEAD >/dev/null; then
1444 __git_complete_index_file "--committable"
1445 else
1446 # This is the first commit
1447 __git_complete_index_file "--cached"
1448 fi
1449}
1450
1451_git_describe ()
1452{
1453 case "$cur" in
1454 --*)
1455 __gitcomp_builtin describe
1456 return
1457 esac
1458 __git_complete_refs
1459}
1460
1461__git_diff_algorithms="myers minimal patience histogram"
1462
1463__git_diff_submodule_formats="diff log short"
1464
1465__git_diff_common_options="--stat --numstat --shortstat --summary
1466 --patch-with-stat --name-only --name-status --color
1467 --no-color --color-words --no-renames --check
1468 --full-index --binary --abbrev --diff-filter=
1469 --find-copies-harder --ignore-cr-at-eol
1470 --text --ignore-space-at-eol --ignore-space-change
1471 --ignore-all-space --ignore-blank-lines --exit-code
1472 --quiet --ext-diff --no-ext-diff
1473 --no-prefix --src-prefix= --dst-prefix=
1474 --inter-hunk-context=
1475 --patience --histogram --minimal
1476 --raw --word-diff --word-diff-regex=
1477 --dirstat --dirstat= --dirstat-by-file
1478 --dirstat-by-file= --cumulative
1479 --diff-algorithm=
1480 --submodule --submodule= --ignore-submodules
1481"
1482
1483_git_diff ()
1484{
1485 __git_has_doubledash && return
1486
1487 case "$cur" in
1488 --diff-algorithm=*)
1489 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1490 return
1491 ;;
1492 --submodule=*)
1493 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1494 return
1495 ;;
1496 --*)
1497 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1498 --base --ours --theirs --no-index
1499 $__git_diff_common_options
1500 "
1501 return
1502 ;;
1503 esac
1504 __git_complete_revlist_file
1505}
1506
1507__git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1508 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc
1509 codecompare smerge
1510"
1511
1512_git_difftool ()
1513{
1514 __git_has_doubledash && return
1515
1516 case "$cur" in
1517 --tool=*)
1518 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1519 return
1520 ;;
1521 --*)
1522 __gitcomp_builtin difftool "$__git_diff_common_options
1523 --base --cached --ours --theirs
1524 --pickaxe-all --pickaxe-regex
1525 --relative --staged
1526 "
1527 return
1528 ;;
1529 esac
1530 __git_complete_revlist_file
1531}
1532
1533__git_fetch_recurse_submodules="yes on-demand no"
1534
1535_git_fetch ()
1536{
1537 case "$cur" in
1538 --recurse-submodules=*)
1539 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1540 return
1541 ;;
1542 --filter=*)
1543 __gitcomp "blob:none blob:limit= sparse:oid=" "" "${cur##--filter=}"
1544 return
1545 ;;
1546 --*)
1547 __gitcomp_builtin fetch
1548 return
1549 ;;
1550 esac
1551 __git_complete_remote_or_refspec
1552}
1553
1554__git_format_patch_extra_options="
1555 --full-index --not --all --no-prefix --src-prefix=
1556 --dst-prefix= --notes
1557"
1558
1559_git_format_patch ()
1560{
1561 case "$cur" in
1562 --thread=*)
1563 __gitcomp "
1564 deep shallow
1565 " "" "${cur##--thread=}"
1566 return
1567 ;;
1568 --*)
1569 __gitcomp_builtin format-patch "$__git_format_patch_extra_options"
1570 return
1571 ;;
1572 esac
1573 __git_complete_revlist
1574}
1575
1576_git_fsck ()
1577{
1578 case "$cur" in
1579 --*)
1580 __gitcomp_builtin fsck
1581 return
1582 ;;
1583 esac
1584}
1585
1586_git_gitk ()
1587{
1588 _gitk
1589}
1590
1591# Lists matching symbol names from a tag (as in ctags) file.
1592# 1: List symbol names matching this word.
1593# 2: The tag file to list symbol names from.
1594# 3: A prefix to be added to each listed symbol name (optional).
1595# 4: A suffix to be appended to each listed symbol name (optional).
1596__git_match_ctag () {
1597 awk -v pfx="${3-}" -v sfx="${4-}" "
1598 /^${1//\//\\/}/ { print pfx \$1 sfx }
1599 " "$2"
1600}
1601
1602# Complete symbol names from a tag file.
1603# Usage: __git_complete_symbol [<option>]...
1604# --tags=<file>: The tag file to list symbol names from instead of the
1605# default "tags".
1606# --pfx=<prefix>: A prefix to be added to each symbol name.
1607# --cur=<word>: The current symbol name to be completed. Defaults to
1608# the current word to be completed.
1609# --sfx=<suffix>: A suffix to be appended to each symbol name instead
1610# of the default space.
1611__git_complete_symbol () {
1612 local tags=tags pfx="" cur_="${cur-}" sfx=" "
1613
1614 while test $# != 0; do
1615 case "$1" in
1616 --tags=*) tags="${1##--tags=}" ;;
1617 --pfx=*) pfx="${1##--pfx=}" ;;
1618 --cur=*) cur_="${1##--cur=}" ;;
1619 --sfx=*) sfx="${1##--sfx=}" ;;
1620 *) return 1 ;;
1621 esac
1622 shift
1623 done
1624
1625 if test -r "$tags"; then
1626 __gitcomp_direct "$(__git_match_ctag "$cur_" "$tags" "$pfx" "$sfx")"
1627 fi
1628}
1629
1630_git_grep ()
1631{
1632 __git_has_doubledash && return
1633
1634 case "$cur" in
1635 --*)
1636 __gitcomp_builtin grep
1637 return
1638 ;;
1639 esac
1640
1641 case "$cword,$prev" in
1642 2,*|*,-*)
1643 __git_complete_symbol && return
1644 ;;
1645 esac
1646
1647 __git_complete_refs
1648}
1649
1650_git_help ()
1651{
1652 case "$cur" in
1653 --*)
1654 __gitcomp_builtin help
1655 return
1656 ;;
1657 esac
1658 if test -n "$GIT_TESTING_ALL_COMMAND_LIST"
1659 then
1660 __gitcomp "$GIT_TESTING_ALL_COMMAND_LIST $(__git --list-cmds=alias,list-guide) gitk"
1661 else
1662 __gitcomp "$(__git --list-cmds=main,nohelpers,alias,list-guide) gitk"
1663 fi
1664}
1665
1666_git_init ()
1667{
1668 case "$cur" in
1669 --shared=*)
1670 __gitcomp "
1671 false true umask group all world everybody
1672 " "" "${cur##--shared=}"
1673 return
1674 ;;
1675 --*)
1676 __gitcomp_builtin init
1677 return
1678 ;;
1679 esac
1680}
1681
1682_git_ls_files ()
1683{
1684 case "$cur" in
1685 --*)
1686 __gitcomp_builtin ls-files
1687 return
1688 ;;
1689 esac
1690
1691 # XXX ignore options like --modified and always suggest all cached
1692 # files.
1693 __git_complete_index_file "--cached"
1694}
1695
1696_git_ls_remote ()
1697{
1698 case "$cur" in
1699 --*)
1700 __gitcomp_builtin ls-remote
1701 return
1702 ;;
1703 esac
1704 __gitcomp_nl "$(__git_remotes)"
1705}
1706
1707_git_ls_tree ()
1708{
1709 case "$cur" in
1710 --*)
1711 __gitcomp_builtin ls-tree
1712 return
1713 ;;
1714 esac
1715
1716 __git_complete_file
1717}
1718
1719# Options that go well for log, shortlog and gitk
1720__git_log_common_options="
1721 --not --all
1722 --branches --tags --remotes
1723 --first-parent --merges --no-merges
1724 --max-count=
1725 --max-age= --since= --after=
1726 --min-age= --until= --before=
1727 --min-parents= --max-parents=
1728 --no-min-parents --no-max-parents
1729"
1730# Options that go well for log and gitk (not shortlog)
1731__git_log_gitk_options="
1732 --dense --sparse --full-history
1733 --simplify-merges --simplify-by-decoration
1734 --left-right --notes --no-notes
1735"
1736# Options that go well for log and shortlog (not gitk)
1737__git_log_shortlog_options="
1738 --author= --committer= --grep=
1739 --all-match --invert-grep
1740"
1741
1742__git_log_pretty_formats="oneline short medium full fuller email raw format: mboxrd"
1743__git_log_date_formats="relative iso8601 iso8601-strict rfc2822 short local default raw unix format:"
1744
1745_git_log ()
1746{
1747 __git_has_doubledash && return
1748 __git_find_repo_path
1749
1750 local merge=""
1751 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
1752 merge="--merge"
1753 fi
1754 case "$prev,$cur" in
1755 -L,:*:*)
1756 return # fall back to Bash filename completion
1757 ;;
1758 -L,:*)
1759 __git_complete_symbol --cur="${cur#:}" --sfx=":"
1760 return
1761 ;;
1762 -G,*|-S,*)
1763 __git_complete_symbol
1764 return
1765 ;;
1766 esac
1767 case "$cur" in
1768 --pretty=*|--format=*)
1769 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1770 " "" "${cur#*=}"
1771 return
1772 ;;
1773 --date=*)
1774 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1775 return
1776 ;;
1777 --decorate=*)
1778 __gitcomp "full short no" "" "${cur##--decorate=}"
1779 return
1780 ;;
1781 --diff-algorithm=*)
1782 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1783 return
1784 ;;
1785 --submodule=*)
1786 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1787 return
1788 ;;
1789 --*)
1790 __gitcomp "
1791 $__git_log_common_options
1792 $__git_log_shortlog_options
1793 $__git_log_gitk_options
1794 --root --topo-order --date-order --reverse
1795 --follow --full-diff
1796 --abbrev-commit --abbrev=
1797 --relative-date --date=
1798 --pretty= --format= --oneline
1799 --show-signature
1800 --cherry-mark
1801 --cherry-pick
1802 --graph
1803 --decorate --decorate=
1804 --walk-reflogs
1805 --parents --children
1806 $merge
1807 $__git_diff_common_options
1808 --pickaxe-all --pickaxe-regex
1809 "
1810 return
1811 ;;
1812 -L:*:*)
1813 return # fall back to Bash filename completion
1814 ;;
1815 -L:*)
1816 __git_complete_symbol --cur="${cur#-L:}" --sfx=":"
1817 return
1818 ;;
1819 -G*)
1820 __git_complete_symbol --pfx="-G" --cur="${cur#-G}"
1821 return
1822 ;;
1823 -S*)
1824 __git_complete_symbol --pfx="-S" --cur="${cur#-S}"
1825 return
1826 ;;
1827 esac
1828 __git_complete_revlist
1829}
1830
1831_git_merge ()
1832{
1833 __git_complete_strategy && return
1834
1835 case "$cur" in
1836 --*)
1837 __gitcomp_builtin merge
1838 return
1839 esac
1840 __git_complete_refs
1841}
1842
1843_git_mergetool ()
1844{
1845 case "$cur" in
1846 --tool=*)
1847 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1848 return
1849 ;;
1850 --*)
1851 __gitcomp "--tool= --prompt --no-prompt --gui --no-gui"
1852 return
1853 ;;
1854 esac
1855}
1856
1857_git_merge_base ()
1858{
1859 case "$cur" in
1860 --*)
1861 __gitcomp_builtin merge-base
1862 return
1863 ;;
1864 esac
1865 __git_complete_refs
1866}
1867
1868_git_mv ()
1869{
1870 case "$cur" in
1871 --*)
1872 __gitcomp_builtin mv
1873 return
1874 ;;
1875 esac
1876
1877 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1878 # We need to show both cached and untracked files (including
1879 # empty directories) since this may not be the last argument.
1880 __git_complete_index_file "--cached --others --directory"
1881 else
1882 __git_complete_index_file "--cached"
1883 fi
1884}
1885
1886_git_notes ()
1887{
1888 local subcommands='add append copy edit get-ref list merge prune remove show'
1889 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1890
1891 case "$subcommand,$cur" in
1892 ,--*)
1893 __gitcomp_builtin notes
1894 ;;
1895 ,*)
1896 case "$prev" in
1897 --ref)
1898 __git_complete_refs
1899 ;;
1900 *)
1901 __gitcomp "$subcommands --ref"
1902 ;;
1903 esac
1904 ;;
1905 *,--reuse-message=*|*,--reedit-message=*)
1906 __git_complete_refs --cur="${cur#*=}"
1907 ;;
1908 *,--*)
1909 __gitcomp_builtin notes_$subcommand
1910 ;;
1911 prune,*|get-ref,*)
1912 # this command does not take a ref, do not complete it
1913 ;;
1914 *)
1915 case "$prev" in
1916 -m|-F)
1917 ;;
1918 *)
1919 __git_complete_refs
1920 ;;
1921 esac
1922 ;;
1923 esac
1924}
1925
1926_git_pull ()
1927{
1928 __git_complete_strategy && return
1929
1930 case "$cur" in
1931 --recurse-submodules=*)
1932 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1933 return
1934 ;;
1935 --*)
1936 __gitcomp_builtin pull
1937
1938 return
1939 ;;
1940 esac
1941 __git_complete_remote_or_refspec
1942}
1943
1944__git_push_recurse_submodules="check on-demand only"
1945
1946__git_complete_force_with_lease ()
1947{
1948 local cur_=$1
1949
1950 case "$cur_" in
1951 --*=)
1952 ;;
1953 *:*)
1954 __git_complete_refs --cur="${cur_#*:}"
1955 ;;
1956 *)
1957 __git_complete_refs --cur="$cur_"
1958 ;;
1959 esac
1960}
1961
1962_git_push ()
1963{
1964 case "$prev" in
1965 --repo)
1966 __gitcomp_nl "$(__git_remotes)"
1967 return
1968 ;;
1969 --recurse-submodules)
1970 __gitcomp "$__git_push_recurse_submodules"
1971 return
1972 ;;
1973 esac
1974 case "$cur" in
1975 --repo=*)
1976 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1977 return
1978 ;;
1979 --recurse-submodules=*)
1980 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1981 return
1982 ;;
1983 --force-with-lease=*)
1984 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1985 return
1986 ;;
1987 --*)
1988 __gitcomp_builtin push
1989 return
1990 ;;
1991 esac
1992 __git_complete_remote_or_refspec
1993}
1994
1995_git_range_diff ()
1996{
1997 case "$cur" in
1998 --*)
1999 __gitcomp "
2000 --creation-factor= --no-dual-color
2001 $__git_diff_common_options
2002 "
2003 return
2004 ;;
2005 esac
2006 __git_complete_revlist
2007}
2008
2009_git_rebase ()
2010{
2011 __git_find_repo_path
2012 if [ -f "$__git_repo_path"/rebase-merge/interactive ]; then
2013 __gitcomp "--continue --skip --abort --quit --edit-todo --show-current-patch"
2014 return
2015 elif [ -d "$__git_repo_path"/rebase-apply ] || \
2016 [ -d "$__git_repo_path"/rebase-merge ]; then
2017 __gitcomp "--continue --skip --abort --quit --show-current-patch"
2018 return
2019 fi
2020 __git_complete_strategy && return
2021 case "$cur" in
2022 --whitespace=*)
2023 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
2024 return
2025 ;;
2026 --*)
2027 __gitcomp "
2028 --onto --merge --strategy --interactive
2029 --rebase-merges --preserve-merges --stat --no-stat
2030 --committer-date-is-author-date --ignore-date
2031 --ignore-whitespace --whitespace=
2032 --autosquash --no-autosquash
2033 --fork-point --no-fork-point
2034 --autostash --no-autostash
2035 --verify --no-verify
2036 --keep-empty --root --force-rebase --no-ff
2037 --rerere-autoupdate
2038 --exec
2039 "
2040
2041 return
2042 esac
2043 __git_complete_refs
2044}
2045
2046_git_reflog ()
2047{
2048 local subcommands="show delete expire"
2049 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2050
2051 if [ -z "$subcommand" ]; then
2052 __gitcomp "$subcommands"
2053 else
2054 __git_complete_refs
2055 fi
2056}
2057
2058__git_send_email_confirm_options="always never auto cc compose"
2059__git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
2060
2061_git_send_email ()
2062{
2063 case "$prev" in
2064 --to|--cc|--bcc|--from)
2065 __gitcomp "$(__git send-email --dump-aliases)"
2066 return
2067 ;;
2068 esac
2069
2070 case "$cur" in
2071 --confirm=*)
2072 __gitcomp "
2073 $__git_send_email_confirm_options
2074 " "" "${cur##--confirm=}"
2075 return
2076 ;;
2077 --suppress-cc=*)
2078 __gitcomp "
2079 $__git_send_email_suppresscc_options
2080 " "" "${cur##--suppress-cc=}"
2081
2082 return
2083 ;;
2084 --smtp-encryption=*)
2085 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
2086 return
2087 ;;
2088 --thread=*)
2089 __gitcomp "
2090 deep shallow
2091 " "" "${cur##--thread=}"
2092 return
2093 ;;
2094 --to=*|--cc=*|--bcc=*|--from=*)
2095 __gitcomp "$(__git send-email --dump-aliases)" "" "${cur#--*=}"
2096 return
2097 ;;
2098 --*)
2099 __gitcomp_builtin send-email "--annotate --bcc --cc --cc-cmd --chain-reply-to
2100 --compose --confirm= --dry-run --envelope-sender
2101 --from --identity
2102 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
2103 --no-suppress-from --no-thread --quiet --reply-to
2104 --signed-off-by-cc --smtp-pass --smtp-server
2105 --smtp-server-port --smtp-encryption= --smtp-user
2106 --subject --suppress-cc= --suppress-from --thread --to
2107 --validate --no-validate
2108 $__git_format_patch_extra_options"
2109 return
2110 ;;
2111 esac
2112 __git_complete_revlist
2113}
2114
2115_git_stage ()
2116{
2117 _git_add
2118}
2119
2120_git_status ()
2121{
2122 local complete_opt
2123 local untracked_state
2124
2125 case "$cur" in
2126 --ignore-submodules=*)
2127 __gitcomp "none untracked dirty all" "" "${cur##--ignore-submodules=}"
2128 return
2129 ;;
2130 --untracked-files=*)
2131 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
2132 return
2133 ;;
2134 --column=*)
2135 __gitcomp "
2136 always never auto column row plain dense nodense
2137 " "" "${cur##--column=}"
2138 return
2139 ;;
2140 --*)
2141 __gitcomp_builtin status
2142 return
2143 ;;
2144 esac
2145
2146 untracked_state="$(__git_get_option_value "-u" "--untracked-files=" \
2147 "$__git_untracked_file_modes" "status.showUntrackedFiles")"
2148
2149 case "$untracked_state" in
2150 no)
2151 # --ignored option does not matter
2152 complete_opt=
2153 ;;
2154 all|normal|*)
2155 complete_opt="--cached --directory --no-empty-directory --others"
2156
2157 if [ -n "$(__git_find_on_cmdline "--ignored")" ]; then
2158 complete_opt="$complete_opt --ignored --exclude=*"
2159 fi
2160 ;;
2161 esac
2162
2163 __git_complete_index_file "$complete_opt"
2164}
2165
2166_git_switch ()
2167{
2168 case "$cur" in
2169 --conflict=*)
2170 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
2171 ;;
2172 --*)
2173 __gitcomp_builtin switch
2174 ;;
2175 *)
2176 # check if --track, --no-track, or --no-guess was specified
2177 # if so, disable DWIM mode
2178 local track_opt="--track" only_local_ref=n
2179 if [ "$GIT_COMPLETION_CHECKOUT_NO_GUESS" = "1" ] ||
2180 [ -n "$(__git_find_on_cmdline "--track --no-track --no-guess")" ]; then
2181 track_opt=''
2182 fi
2183 # explicit --guess enables DWIM mode regardless of
2184 # $GIT_COMPLETION_CHECKOUT_NO_GUESS
2185 if [ -n "$(__git_find_on_cmdline "--guess")" ]; then
2186 track_opt='--track'
2187 fi
2188 if [ -z "$(__git_find_on_cmdline "-d --detach")" ]; then
2189 only_local_ref=y
2190 else
2191 # --guess --detach is invalid combination, no
2192 # dwim will be done when --detach is specified
2193 track_opt=
2194 fi
2195 if [ $only_local_ref = y -a -z "$track_opt" ]; then
2196 __gitcomp_direct "$(__git_heads "" "$cur" " ")"
2197 else
2198 __git_complete_refs $track_opt
2199 fi
2200 ;;
2201 esac
2202}
2203
2204__git_config_get_set_variables ()
2205{
2206 local prevword word config_file= c=$cword
2207 while [ $c -gt 1 ]; do
2208 word="${words[c]}"
2209 case "$word" in
2210 --system|--global|--local|--file=*)
2211 config_file="$word"
2212 break
2213 ;;
2214 -f|--file)
2215 config_file="$word $prevword"
2216 break
2217 ;;
2218 esac
2219 prevword=$word
2220 c=$((--c))
2221 done
2222
2223 __git config $config_file --name-only --list
2224}
2225
2226__git_config_vars=
2227__git_compute_config_vars ()
2228{
2229 test -n "$__git_config_vars" ||
2230 __git_config_vars="$(git help --config-for-completion | sort | uniq)"
2231}
2232
2233_git_config ()
2234{
2235 local varname
2236
2237 if [ "${BASH_VERSINFO[0]:-0}" -ge 4 ]; then
2238 varname="${prev,,}"
2239 else
2240 varname="$(echo "$prev" |tr A-Z a-z)"
2241 fi
2242
2243 case "$varname" in
2244 branch.*.remote|branch.*.pushremote)
2245 __gitcomp_nl "$(__git_remotes)"
2246 return
2247 ;;
2248 branch.*.merge)
2249 __git_complete_refs
2250 return
2251 ;;
2252 branch.*.rebase)
2253 __gitcomp "false true merges preserve interactive"
2254 return
2255 ;;
2256 remote.pushdefault)
2257 __gitcomp_nl "$(__git_remotes)"
2258 return
2259 ;;
2260 remote.*.fetch)
2261 local remote="${prev#remote.}"
2262 remote="${remote%.fetch}"
2263 if [ -z "$cur" ]; then
2264 __gitcomp_nl "refs/heads/" "" "" ""
2265 return
2266 fi
2267 __gitcomp_nl "$(__git_refs_remotes "$remote")"
2268 return
2269 ;;
2270 remote.*.push)
2271 local remote="${prev#remote.}"
2272 remote="${remote%.push}"
2273 __gitcomp_nl "$(__git for-each-ref \
2274 --format='%(refname):%(refname)' refs/heads)"
2275 return
2276 ;;
2277 pull.twohead|pull.octopus)
2278 __git_compute_merge_strategies
2279 __gitcomp "$__git_merge_strategies"
2280 return
2281 ;;
2282 color.branch|color.diff|color.interactive|\
2283 color.showbranch|color.status|color.ui)
2284 __gitcomp "always never auto"
2285 return
2286 ;;
2287 color.pager)
2288 __gitcomp "false true"
2289 return
2290 ;;
2291 color.*.*)
2292 __gitcomp "
2293 normal black red green yellow blue magenta cyan white
2294 bold dim ul blink reverse
2295 "
2296 return
2297 ;;
2298 diff.submodule)
2299 __gitcomp "$__git_diff_submodule_formats"
2300 return
2301 ;;
2302 help.format)
2303 __gitcomp "man info web html"
2304 return
2305 ;;
2306 log.date)
2307 __gitcomp "$__git_log_date_formats"
2308 return
2309 ;;
2310 sendemail.aliasfiletype)
2311 __gitcomp "mutt mailrc pine elm gnus"
2312 return
2313 ;;
2314 sendemail.confirm)
2315 __gitcomp "$__git_send_email_confirm_options"
2316 return
2317 ;;
2318 sendemail.suppresscc)
2319 __gitcomp "$__git_send_email_suppresscc_options"
2320 return
2321 ;;
2322 sendemail.transferencoding)
2323 __gitcomp "7bit 8bit quoted-printable base64"
2324 return
2325 ;;
2326 --get|--get-all|--unset|--unset-all)
2327 __gitcomp_nl "$(__git_config_get_set_variables)"
2328 return
2329 ;;
2330 *.*)
2331 return
2332 ;;
2333 esac
2334 case "$cur" in
2335 --*)
2336 __gitcomp_builtin config
2337 return
2338 ;;
2339 branch.*.*)
2340 local pfx="${cur%.*}." cur_="${cur##*.}"
2341 __gitcomp "remote pushRemote merge mergeOptions rebase" "$pfx" "$cur_"
2342 return
2343 ;;
2344 branch.*)
2345 local pfx="${cur%.*}." cur_="${cur#*.}"
2346 __gitcomp_direct "$(__git_heads "$pfx" "$cur_" ".")"
2347 __gitcomp_nl_append $'autoSetupMerge\nautoSetupRebase\n' "$pfx" "$cur_"
2348 return
2349 ;;
2350 guitool.*.*)
2351 local pfx="${cur%.*}." cur_="${cur##*.}"
2352 __gitcomp "
2353 argPrompt cmd confirm needsFile noConsole noRescan
2354 prompt revPrompt revUnmerged title
2355 " "$pfx" "$cur_"
2356 return
2357 ;;
2358 difftool.*.*)
2359 local pfx="${cur%.*}." cur_="${cur##*.}"
2360 __gitcomp "cmd path" "$pfx" "$cur_"
2361 return
2362 ;;
2363 man.*.*)
2364 local pfx="${cur%.*}." cur_="${cur##*.}"
2365 __gitcomp "cmd path" "$pfx" "$cur_"
2366 return
2367 ;;
2368 mergetool.*.*)
2369 local pfx="${cur%.*}." cur_="${cur##*.}"
2370 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
2371 return
2372 ;;
2373 pager.*)
2374 local pfx="${cur%.*}." cur_="${cur#*.}"
2375 __git_compute_all_commands
2376 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
2377 return
2378 ;;
2379 remote.*.*)
2380 local pfx="${cur%.*}." cur_="${cur##*.}"
2381 __gitcomp "
2382 url proxy fetch push mirror skipDefaultUpdate
2383 receivepack uploadpack tagOpt pushurl
2384 " "$pfx" "$cur_"
2385 return
2386 ;;
2387 remote.*)
2388 local pfx="${cur%.*}." cur_="${cur#*.}"
2389 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
2390 __gitcomp_nl_append "pushDefault" "$pfx" "$cur_"
2391 return
2392 ;;
2393 url.*.*)
2394 local pfx="${cur%.*}." cur_="${cur##*.}"
2395 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
2396 return
2397 ;;
2398 *.*)
2399 __git_compute_config_vars
2400 __gitcomp "$__git_config_vars"
2401 ;;
2402 *)
2403 __git_compute_config_vars
2404 __gitcomp "$(echo "$__git_config_vars" | sed 's/\.[^ ]*/./g')"
2405 esac
2406}
2407
2408_git_remote ()
2409{
2410 local subcommands="
2411 add rename remove set-head set-branches
2412 get-url set-url show prune update
2413 "
2414 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2415 if [ -z "$subcommand" ]; then
2416 case "$cur" in
2417 --*)
2418 __gitcomp_builtin remote
2419 ;;
2420 *)
2421 __gitcomp "$subcommands"
2422 ;;
2423 esac
2424 return
2425 fi
2426
2427 case "$subcommand,$cur" in
2428 add,--*)
2429 __gitcomp_builtin remote_add
2430 ;;
2431 add,*)
2432 ;;
2433 set-head,--*)
2434 __gitcomp_builtin remote_set-head
2435 ;;
2436 set-branches,--*)
2437 __gitcomp_builtin remote_set-branches
2438 ;;
2439 set-head,*|set-branches,*)
2440 __git_complete_remote_or_refspec
2441 ;;
2442 update,--*)
2443 __gitcomp_builtin remote_update
2444 ;;
2445 update,*)
2446 __gitcomp "$(__git_remotes) $(__git_get_config_variables "remotes")"
2447 ;;
2448 set-url,--*)
2449 __gitcomp_builtin remote_set-url
2450 ;;
2451 get-url,--*)
2452 __gitcomp_builtin remote_get-url
2453 ;;
2454 prune,--*)
2455 __gitcomp_builtin remote_prune
2456 ;;
2457 *)
2458 __gitcomp_nl "$(__git_remotes)"
2459 ;;
2460 esac
2461}
2462
2463_git_replace ()
2464{
2465 case "$cur" in
2466 --format=*)
2467 __gitcomp "short medium long" "" "${cur##--format=}"
2468 return
2469 ;;
2470 --*)
2471 __gitcomp_builtin replace
2472 return
2473 ;;
2474 esac
2475 __git_complete_refs
2476}
2477
2478_git_rerere ()
2479{
2480 local subcommands="clear forget diff remaining status gc"
2481 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2482 if test -z "$subcommand"
2483 then
2484 __gitcomp "$subcommands"
2485 return
2486 fi
2487}
2488
2489_git_reset ()
2490{
2491 __git_has_doubledash && return
2492
2493 case "$cur" in
2494 --*)
2495 __gitcomp_builtin reset
2496 return
2497 ;;
2498 esac
2499 __git_complete_refs
2500}
2501
2502_git_restore ()
2503{
2504 case "$cur" in
2505 --conflict=*)
2506 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
2507 ;;
2508 --source=*)
2509 __git_complete_refs --cur="${cur##--source=}"
2510 ;;
2511 --*)
2512 __gitcomp_builtin restore
2513 ;;
2514 esac
2515}
2516
2517__git_revert_inprogress_options=$__git_sequencer_inprogress_options
2518
2519_git_revert ()
2520{
2521 __git_find_repo_path
2522 if [ -f "$__git_repo_path"/REVERT_HEAD ]; then
2523 __gitcomp "$__git_revert_inprogress_options"
2524 return
2525 fi
2526 __git_complete_strategy && return
2527 case "$cur" in
2528 --*)
2529 __gitcomp_builtin revert "" \
2530 "$__git_revert_inprogress_options"
2531 return
2532 ;;
2533 esac
2534 __git_complete_refs
2535}
2536
2537_git_rm ()
2538{
2539 case "$cur" in
2540 --*)
2541 __gitcomp_builtin rm
2542 return
2543 ;;
2544 esac
2545
2546 __git_complete_index_file "--cached"
2547}
2548
2549_git_shortlog ()
2550{
2551 __git_has_doubledash && return
2552
2553 case "$cur" in
2554 --*)
2555 __gitcomp "
2556 $__git_log_common_options
2557 $__git_log_shortlog_options
2558 --numbered --summary --email
2559 "
2560 return
2561 ;;
2562 esac
2563 __git_complete_revlist
2564}
2565
2566_git_show ()
2567{
2568 __git_has_doubledash && return
2569
2570 case "$cur" in
2571 --pretty=*|--format=*)
2572 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2573 " "" "${cur#*=}"
2574 return
2575 ;;
2576 --diff-algorithm=*)
2577 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2578 return
2579 ;;
2580 --submodule=*)
2581 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
2582 return
2583 ;;
2584 --*)
2585 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2586 --show-signature
2587 $__git_diff_common_options
2588 "
2589 return
2590 ;;
2591 esac
2592 __git_complete_revlist_file
2593}
2594
2595_git_show_branch ()
2596{
2597 case "$cur" in
2598 --*)
2599 __gitcomp_builtin show-branch
2600 return
2601 ;;
2602 esac
2603 __git_complete_revlist
2604}
2605
2606_git_stash ()
2607{
2608 local save_opts='--all --keep-index --no-keep-index --quiet --patch --include-untracked'
2609 local subcommands='push list show apply clear drop pop create branch'
2610 local subcommand="$(__git_find_on_cmdline "$subcommands save")"
2611 if [ -n "$(__git_find_on_cmdline "-p")" ]; then
2612 subcommand="push"
2613 fi
2614 if [ -z "$subcommand" ]; then
2615 case "$cur" in
2616 --*)
2617 __gitcomp "$save_opts"
2618 ;;
2619 sa*)
2620 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2621 __gitcomp "save"
2622 fi
2623 ;;
2624 *)
2625 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2626 __gitcomp "$subcommands"
2627 fi
2628 ;;
2629 esac
2630 else
2631 case "$subcommand,$cur" in
2632 push,--*)
2633 __gitcomp "$save_opts --message"
2634 ;;
2635 save,--*)
2636 __gitcomp "$save_opts"
2637 ;;
2638 apply,--*|pop,--*)
2639 __gitcomp "--index --quiet"
2640 ;;
2641 drop,--*)
2642 __gitcomp "--quiet"
2643 ;;
2644 list,--*)
2645 __gitcomp "--name-status --oneline --patch-with-stat"
2646 ;;
2647 show,--*|branch,--*)
2648 ;;
2649 branch,*)
2650 if [ $cword -eq 3 ]; then
2651 __git_complete_refs
2652 else
2653 __gitcomp_nl "$(__git stash list \
2654 | sed -n -e 's/:.*//p')"
2655 fi
2656 ;;
2657 show,*|apply,*|drop,*|pop,*)
2658 __gitcomp_nl "$(__git stash list \
2659 | sed -n -e 's/:.*//p')"
2660 ;;
2661 *)
2662 ;;
2663 esac
2664 fi
2665}
2666
2667_git_submodule ()
2668{
2669 __git_has_doubledash && return
2670
2671 local subcommands="add status init deinit update set-branch summary foreach sync absorbgitdirs"
2672 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2673 if [ -z "$subcommand" ]; then
2674 case "$cur" in
2675 --*)
2676 __gitcomp "--quiet"
2677 ;;
2678 *)
2679 __gitcomp "$subcommands"
2680 ;;
2681 esac
2682 return
2683 fi
2684
2685 case "$subcommand,$cur" in
2686 add,--*)
2687 __gitcomp "--branch --force --name --reference --depth"
2688 ;;
2689 status,--*)
2690 __gitcomp "--cached --recursive"
2691 ;;
2692 deinit,--*)
2693 __gitcomp "--force --all"
2694 ;;
2695 update,--*)
2696 __gitcomp "
2697 --init --remote --no-fetch
2698 --recommend-shallow --no-recommend-shallow
2699 --force --rebase --merge --reference --depth --recursive --jobs
2700 "
2701 ;;
2702 set-branch,--*)
2703 __gitcomp "--default --branch"
2704 ;;
2705 summary,--*)
2706 __gitcomp "--cached --files --summary-limit"
2707 ;;
2708 foreach,--*|sync,--*)
2709 __gitcomp "--recursive"
2710 ;;
2711 *)
2712 ;;
2713 esac
2714}
2715
2716_git_svn ()
2717{
2718 local subcommands="
2719 init fetch clone rebase dcommit log find-rev
2720 set-tree commit-diff info create-ignore propget
2721 proplist show-ignore show-externals branch tag blame
2722 migrate mkdirs reset gc
2723 "
2724 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2725 if [ -z "$subcommand" ]; then
2726 __gitcomp "$subcommands"
2727 else
2728 local remote_opts="--username= --config-dir= --no-auth-cache"
2729 local fc_opts="
2730 --follow-parent --authors-file= --repack=
2731 --no-metadata --use-svm-props --use-svnsync-props
2732 --log-window-size= --no-checkout --quiet
2733 --repack-flags --use-log-author --localtime
2734 --add-author-from
2735 --ignore-paths= --include-paths= $remote_opts
2736 "
2737 local init_opts="
2738 --template= --shared= --trunk= --tags=
2739 --branches= --stdlayout --minimize-url
2740 --no-metadata --use-svm-props --use-svnsync-props
2741 --rewrite-root= --prefix= $remote_opts
2742 "
2743 local cmt_opts="
2744 --edit --rmdir --find-copies-harder --copy-similarity=
2745 "
2746
2747 case "$subcommand,$cur" in
2748 fetch,--*)
2749 __gitcomp "--revision= --fetch-all $fc_opts"
2750 ;;
2751 clone,--*)
2752 __gitcomp "--revision= $fc_opts $init_opts"
2753 ;;
2754 init,--*)
2755 __gitcomp "$init_opts"
2756 ;;
2757 dcommit,--*)
2758 __gitcomp "
2759 --merge --strategy= --verbose --dry-run
2760 --fetch-all --no-rebase --commit-url
2761 --revision --interactive $cmt_opts $fc_opts
2762 "
2763 ;;
2764 set-tree,--*)
2765 __gitcomp "--stdin $cmt_opts $fc_opts"
2766 ;;
2767 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2768 show-externals,--*|mkdirs,--*)
2769 __gitcomp "--revision="
2770 ;;
2771 log,--*)
2772 __gitcomp "
2773 --limit= --revision= --verbose --incremental
2774 --oneline --show-commit --non-recursive
2775 --authors-file= --color
2776 "
2777 ;;
2778 rebase,--*)
2779 __gitcomp "
2780 --merge --verbose --strategy= --local
2781 --fetch-all --dry-run $fc_opts
2782 "
2783 ;;
2784 commit-diff,--*)
2785 __gitcomp "--message= --file= --revision= $cmt_opts"
2786 ;;
2787 info,--*)
2788 __gitcomp "--url"
2789 ;;
2790 branch,--*)
2791 __gitcomp "--dry-run --message --tag"
2792 ;;
2793 tag,--*)
2794 __gitcomp "--dry-run --message"
2795 ;;
2796 blame,--*)
2797 __gitcomp "--git-format"
2798 ;;
2799 migrate,--*)
2800 __gitcomp "
2801 --config-dir= --ignore-paths= --minimize
2802 --no-auth-cache --username=
2803 "
2804 ;;
2805 reset,--*)
2806 __gitcomp "--revision= --parent"
2807 ;;
2808 *)
2809 ;;
2810 esac
2811 fi
2812}
2813
2814_git_tag ()
2815{
2816 local i c=1 f=0
2817 while [ $c -lt $cword ]; do
2818 i="${words[c]}"
2819 case "$i" in
2820 -d|--delete|-v|--verify)
2821 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
2822 return
2823 ;;
2824 -f)
2825 f=1
2826 ;;
2827 esac
2828 ((c++))
2829 done
2830
2831 case "$prev" in
2832 -m|-F)
2833 ;;
2834 -*|tag)
2835 if [ $f = 1 ]; then
2836 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
2837 fi
2838 ;;
2839 *)
2840 __git_complete_refs
2841 ;;
2842 esac
2843
2844 case "$cur" in
2845 --*)
2846 __gitcomp_builtin tag
2847 ;;
2848 esac
2849}
2850
2851_git_whatchanged ()
2852{
2853 _git_log
2854}
2855
2856_git_worktree ()
2857{
2858 local subcommands="add list lock move prune remove unlock"
2859 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2860 if [ -z "$subcommand" ]; then
2861 __gitcomp "$subcommands"
2862 else
2863 case "$subcommand,$cur" in
2864 add,--*)
2865 __gitcomp_builtin worktree_add
2866 ;;
2867 list,--*)
2868 __gitcomp_builtin worktree_list
2869 ;;
2870 lock,--*)
2871 __gitcomp_builtin worktree_lock
2872 ;;
2873 prune,--*)
2874 __gitcomp_builtin worktree_prune
2875 ;;
2876 remove,--*)
2877 __gitcomp "--force"
2878 ;;
2879 *)
2880 ;;
2881 esac
2882 fi
2883}
2884
2885__git_complete_common () {
2886 local command="$1"
2887
2888 case "$cur" in
2889 --*)
2890 __gitcomp_builtin "$command"
2891 ;;
2892 esac
2893}
2894
2895__git_cmds_with_parseopt_helper=
2896__git_support_parseopt_helper () {
2897 test -n "$__git_cmds_with_parseopt_helper" ||
2898 __git_cmds_with_parseopt_helper="$(__git --list-cmds=parseopt)"
2899
2900 case " $__git_cmds_with_parseopt_helper " in
2901 *" $1 "*)
2902 return 0
2903 ;;
2904 *)
2905 return 1
2906 ;;
2907 esac
2908}
2909
2910__git_complete_command () {
2911 local command="$1"
2912 local completion_func="_git_${command//-/_}"
2913 if ! declare -f $completion_func >/dev/null 2>/dev/null &&
2914 declare -f _completion_loader >/dev/null 2>/dev/null
2915 then
2916 _completion_loader "git-$command"
2917 fi
2918 if declare -f $completion_func >/dev/null 2>/dev/null
2919 then
2920 $completion_func
2921 return 0
2922 elif __git_support_parseopt_helper "$command"
2923 then
2924 __git_complete_common "$command"
2925 return 0
2926 else
2927 return 1
2928 fi
2929}
2930
2931__git_main ()
2932{
2933 local i c=1 command __git_dir __git_repo_path
2934 local __git_C_args C_args_count=0
2935
2936 while [ $c -lt $cword ]; do
2937 i="${words[c]}"
2938 case "$i" in
2939 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2940 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2941 --bare) __git_dir="." ;;
2942 --help) command="help"; break ;;
2943 -c|--work-tree|--namespace) ((c++)) ;;
2944 -C) __git_C_args[C_args_count++]=-C
2945 ((c++))
2946 __git_C_args[C_args_count++]="${words[c]}"
2947 ;;
2948 -*) ;;
2949 *) command="$i"; break ;;
2950 esac
2951 ((c++))
2952 done
2953
2954 if [ -z "$command" ]; then
2955 case "$prev" in
2956 --git-dir|-C|--work-tree)
2957 # these need a path argument, let's fall back to
2958 # Bash filename completion
2959 return
2960 ;;
2961 -c|--namespace)
2962 # we don't support completing these options' arguments
2963 return
2964 ;;
2965 esac
2966 case "$cur" in
2967 --*) __gitcomp "
2968 --paginate
2969 --no-pager
2970 --git-dir=
2971 --bare
2972 --version
2973 --exec-path
2974 --exec-path=
2975 --html-path
2976 --man-path
2977 --info-path
2978 --work-tree=
2979 --namespace=
2980 --no-replace-objects
2981 --help
2982 "
2983 ;;
2984 *)
2985 if test -n "$GIT_TESTING_PORCELAIN_COMMAND_LIST"
2986 then
2987 __gitcomp "$GIT_TESTING_PORCELAIN_COMMAND_LIST"
2988 else
2989 __gitcomp "$(__git --list-cmds=list-mainporcelain,others,nohelpers,alias,list-complete,config)"
2990 fi
2991 ;;
2992 esac
2993 return
2994 fi
2995
2996 __git_complete_command "$command" && return
2997
2998 local expansion=$(__git_aliased_command "$command")
2999 if [ -n "$expansion" ]; then
3000 words[1]=$expansion
3001 __git_complete_command "$expansion"
3002 fi
3003}
3004
3005__gitk_main ()
3006{
3007 __git_has_doubledash && return
3008
3009 local __git_repo_path
3010 __git_find_repo_path
3011
3012 local merge=""
3013 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
3014 merge="--merge"
3015 fi
3016 case "$cur" in
3017 --*)
3018 __gitcomp "
3019 $__git_log_common_options
3020 $__git_log_gitk_options
3021 $merge
3022 "
3023 return
3024 ;;
3025 esac
3026 __git_complete_revlist
3027}
3028
3029if [[ -n ${ZSH_VERSION-} ]] &&
3030 # Don't define these functions when sourced from 'git-completion.zsh',
3031 # it has its own implementations.
3032 [[ -z ${GIT_SOURCING_ZSH_COMPLETION-} ]]; then
3033 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
3034
3035 autoload -U +X compinit && compinit
3036
3037 __gitcomp ()
3038 {
3039 emulate -L zsh
3040
3041 local cur_="${3-$cur}"
3042
3043 case "$cur_" in
3044 --*=)
3045 ;;
3046 *)
3047 local c IFS=$' \t\n'
3048 local -a array
3049 for c in ${=1}; do
3050 c="$c${4-}"
3051 case $c in
3052 --*=*|*.) ;;
3053 *) c="$c " ;;
3054 esac
3055 array[${#array[@]}+1]="$c"
3056 done
3057 compset -P '*[=:]'
3058 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
3059 ;;
3060 esac
3061 }
3062
3063 __gitcomp_direct ()
3064 {
3065 emulate -L zsh
3066
3067 local IFS=$'\n'
3068 compset -P '*[=:]'
3069 compadd -Q -- ${=1} && _ret=0
3070 }
3071
3072 __gitcomp_nl ()
3073 {
3074 emulate -L zsh
3075
3076 local IFS=$'\n'
3077 compset -P '*[=:]'
3078 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
3079 }
3080
3081 __gitcomp_file_direct ()
3082 {
3083 emulate -L zsh
3084
3085 local IFS=$'\n'
3086 compset -P '*[=:]'
3087 compadd -f -- ${=1} && _ret=0
3088 }
3089
3090 __gitcomp_file ()
3091 {
3092 emulate -L zsh
3093
3094 local IFS=$'\n'
3095 compset -P '*[=:]'
3096 compadd -p "${2-}" -f -- ${=1} && _ret=0
3097 }
3098
3099 _git ()
3100 {
3101 local _ret=1 cur cword prev
3102 cur=${words[CURRENT]}
3103 prev=${words[CURRENT-1]}
3104 let cword=CURRENT-1
3105 emulate ksh -c __${service}_main
3106 let _ret && _default && _ret=0
3107 return _ret
3108 }
3109
3110 compdef _git git gitk
3111 return
3112fi
3113
3114__git_func_wrap ()
3115{
3116 local cur words cword prev
3117 _get_comp_words_by_ref -n =: cur words cword prev
3118 $1
3119}
3120
3121# Setup completion for certain functions defined above by setting common
3122# variables and workarounds.
3123# This is NOT a public function; use at your own risk.
3124__git_complete ()
3125{
3126 local wrapper="__git_wrap${2}"
3127 eval "$wrapper () { __git_func_wrap $2 ; }"
3128 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
3129 || complete -o default -o nospace -F $wrapper $1
3130}
3131
3132# wrapper for backwards compatibility
3133_git ()
3134{
3135 __git_wrap__git_main
3136}
3137
3138# wrapper for backwards compatibility
3139_gitk ()
3140{
3141 __git_wrap__gitk_main
3142}
3143
3144__git_complete git __git_main
3145__git_complete gitk __gitk_main
3146
3147# The following are necessary only for Cygwin, and only are needed
3148# when the user has tab-completed the executable name and consequently
3149# included the '.exe' suffix.
3150#
3151if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
3152__git_complete git.exe __git_main
3153fi