1 # bash/zsh git prompt support
3 # Copyright (C) 2006,2007 Shawn O. Pearce <spearce@spearce.org>
4 # Distributed under the GNU General Public License, version 2.0.
6 # This script allows you to see the current branch in your prompt.
10 # 1) Copy this file to somewhere (e.g. ~/.git-prompt.sh).
11 # 2) Add the following line to your .bashrc/.zshrc:
12 # source ~/.git-prompt.sh
13 # 3a) In ~/.bashrc set PROMPT_COMMAND=__git_ps1
14 # To customize the prompt, provide start/end arguments
15 # PROMPT_COMMAND='__git_ps1 "\u@\h:\w" "\\\$ "'
16 # 3b) Alternatively change your PS1 to call __git_ps1 as
17 # command-substitution:
18 # Bash: PS1='[\u@\h \W$(__git_ps1 " (%s)")]\$ '
19 # ZSH: PS1='[%n@%m %c$(__git_ps1 " (%s)")]\$ '
20 # the optional argument will be used as format string
22 # The argument to __git_ps1 will be displayed only if you are currently
23 # in a git repository. The %s token will be the name of the current
26 # In addition, if you set GIT_PS1_SHOWDIRTYSTATE to a nonempty value,
27 # unstaged (*) and staged (+) changes will be shown next to the branch
28 # name. You can configure this per-repository with the
29 # bash.showDirtyState variable, which defaults to true once
30 # GIT_PS1_SHOWDIRTYSTATE is enabled.
32 # You can also see if currently something is stashed, by setting
33 # GIT_PS1_SHOWSTASHSTATE to a nonempty value. If something is stashed,
34 # then a '$' will be shown next to the branch name.
36 # If you would like to see if there're untracked files, then you can set
37 # GIT_PS1_SHOWUNTRACKEDFILES to a nonempty value. If there're untracked
38 # files, then a '%' will be shown next to the branch name.
40 # If you would like to see the difference between HEAD and its upstream,
41 # set GIT_PS1_SHOWUPSTREAM="auto". A "<" indicates you are behind, ">"
42 # indicates you are ahead, "<>" indicates you have diverged and "="
43 # indicates that there is no difference. You can further control
44 # behaviour by setting GIT_PS1_SHOWUPSTREAM to a space-separated list
47 # verbose show number of commits ahead/behind (+/-) upstream
48 # legacy don't use the '--count' option available in recent
49 # versions of git-rev-list
50 # git always compare HEAD to @{upstream}
51 # svn always compare HEAD to your SVN upstream
53 # By default, __git_ps1 will compare HEAD to your SVN upstream if it can
54 # find one, or @{upstream} otherwise. Once you have set
55 # GIT_PS1_SHOWUPSTREAM, you can override it on a per-repository basis by
56 # setting the bash.showUpstream config variable.
58 # If you would like a colored hint about the current dirty state, set
59 # GIT_PS1_SHOWCOLORHINTS to a nonempty value. When tracked files are
60 # modified, the branch name turns red, when all modifications are staged
61 # the branch name turns yellow and when all changes are checked in, the
62 # color changes to green. The colors are currently hardcoded in the function.
64 # __gitdir accepts 0 or 1 arguments (i.e., location)
65 # returns location of .git repo
68 # Note: this function is duplicated in git-completion.bash
69 # When updating it, make sure you update the other one to match.
70 if [ -z "${1-}" ]; then
71 if [ -n "${__git_dir-}" ]; then
73 elif [ -n "${GIT_DIR-}" ]; then
74 test -d "${GIT_DIR-}" ||
return 1
76 elif [ -d .git
]; then
79 git rev-parse
--git-dir 2>/dev
/null
81 elif [ -d "$1/.git" ]; then
88 # stores the divergence from upstream in $p
89 # used by GIT_PS1_SHOWUPSTREAM
90 __git_ps1_show_upstream
()
93 local svn_remote svn_url_pattern count n
94 local upstream
=git legacy
="" verbose
=""
97 # get some config options from git-config
98 local output
="$(git config -z --get-regexp '^(svn-remote\..*\.url|bash\.showupstream)$' 2>/dev/null | tr '\0\n' '\n ')"
99 while read -r key value
; do
102 GIT_PS1_SHOWUPSTREAM
="$value"
103 if [[ -z "${GIT_PS1_SHOWUPSTREAM}" ]]; then
109 svn_remote
[ $
((${#svn_remote[@]} + 1)) ]="$value"
110 svn_url_pattern
+="\\|$value"
111 upstream
=svn
+git
# default upstream is SVN if available, else git
116 # parse configuration values
117 for option
in ${GIT_PS1_SHOWUPSTREAM}; do
119 git|svn
) upstream
="$option" ;;
120 verbose
) verbose
=1 ;;
127 git
) upstream
="@{upstream}" ;;
129 # get the upstream from the "git-svn-id: ..." in a commit message
130 # (git-svn uses essentially the same procedure internally)
131 local svn_upstream
=($
(git log
--first-parent -1 \
132 --grep="^git-svn-id: \(${svn_url_pattern#??}\)" 2>/dev
/null
))
133 if [[ 0 -ne ${#svn_upstream[@]} ]]; then
134 svn_upstream
=${svn_upstream[ ${#svn_upstream[@]} - 2 ]}
135 svn_upstream
=${svn_upstream%@*}
136 local n_stop
="${#svn_remote[@]}"
137 for ((n
=1; n
<= n_stop
; n
++)); do
138 svn_upstream
=${svn_upstream#${svn_remote[$n]}}
141 if [[ -z "$svn_upstream" ]]; then
142 # default branch name for checkouts with no layout:
143 upstream
=${GIT_SVN_ID:-git-svn}
145 upstream
=${svn_upstream#/}
147 elif [[ "svn+git" = "$upstream" ]]; then
148 upstream
="@{upstream}"
153 # Find how many commits we are ahead/behind our upstream
154 if [[ -z "$legacy" ]]; then
155 count
="$(git rev-list --count --left-right \
156 "$upstream"...HEAD 2>/dev/null)"
158 # produce equivalent output to --count for older versions of git
160 if commits
="$(git rev-list --left-right "$upstream"...HEAD 2>/dev/null)"
162 local commit behind
=0 ahead
=0
163 for commit
in $commits
166 "<"*) ((behind
++)) ;;
170 count
="$behind $ahead"
176 # calculate the result
177 if [[ -z "$verbose" ]]; then
181 "0 0") # equal to upstream
183 "0 "*) # ahead of upstream
185 *" 0") # behind upstream
187 *) # diverged from upstream
194 "0 0") # equal to upstream
196 "0 "*) # ahead of upstream
197 p
=" u+${count#0 }" ;;
198 *" 0") # behind upstream
199 p
=" u-${count% 0}" ;;
200 *) # diverged from upstream
201 p
=" u+${count#* }-${count% *}" ;;
208 # __git_ps1 accepts 0 or 1 arguments (i.e., format string)
209 # when called from PS1 using command substitution
210 # in this mode it prints text to add to bash PS1 prompt (includes branch name)
212 # __git_ps1 requires 2 arguments when called from PROMPT_COMMAND (pc)
213 # in that case it _sets_ PS1. The arguments are parts of a PS1 string.
214 # when both arguments are given, the first is prepended and the second appended
215 # to the state string when assigned to PS1.
216 # In this mode you can request colored hints using GIT_PS1_SHOWCOLORHINTS=true
221 local ps1pc_start
='\u@\h:\w '
222 local ps1pc_end
='\$ '
223 local printf_format
=' (%s)'
230 0|
1) printf_format
="${1:-$printf_format}"
236 local g
="$(__gitdir)"
238 if [ $pcmode = yes ]; then
239 #In PC mode PS1 always needs to be set
240 PS1
="$ps1pc_start$ps1pc_end"
245 if [ -f "$g/rebase-merge/interactive" ]; then
247 b
="$(cat "$g/rebase-merge
/head-name
")"
248 elif [ -d "$g/rebase-merge" ]; then
250 b
="$(cat "$g/rebase-merge
/head-name
")"
252 if [ -d "$g/rebase-apply" ]; then
253 if [ -f "$g/rebase-apply/rebasing" ]; then
255 elif [ -f "$g/rebase-apply/applying" ]; then
260 elif [ -f "$g/MERGE_HEAD" ]; then
262 elif [ -f "$g/CHERRY_PICK_HEAD" ]; then
264 elif [ -f "$g/BISECT_LOG" ]; then
268 b
="$(git symbolic-ref HEAD 2>/dev/null)" ||
{
271 case "${GIT_PS1_DESCRIBE_STYLE-}" in
273 git describe --contains HEAD ;;
275 git describe --contains --all HEAD ;;
279 git describe --tags --exact-match HEAD ;;
280 esac 2>/dev/null)" ||
282 b
="$(cut -c1-7 "$g/HEAD
" 2>/dev/null)..." ||
295 if [ "true" = "$(git rev-parse --is-inside-git-dir 2>/dev/null)" ]; then
296 if [ "true" = "$(git rev-parse --is-bare-repository 2>/dev/null)" ]; then
301 elif [ "true" = "$(git rev-parse --is-inside-work-tree 2>/dev/null)" ]; then
302 if [ -n "${GIT_PS1_SHOWDIRTYSTATE-}" ]; then
303 if [ "$(git config --bool bash.showDirtyState)" != "false" ]; then
304 git
diff --no-ext-diff --quiet --exit-code || w
="*"
305 if git rev-parse
--quiet --verify HEAD
>/dev
/null
; then
306 git diff-index
--cached --quiet HEAD
-- || i
="+"
312 if [ -n "${GIT_PS1_SHOWSTASHSTATE-}" ]; then
313 git rev-parse
--verify refs
/stash
>/dev
/null
2>&1 && s
="$"
316 if [ -n "${GIT_PS1_SHOWUNTRACKEDFILES-}" ]; then
317 if [ -n "$(git ls-files --others --exclude-standard)" ]; then
322 if [ -n "${GIT_PS1_SHOWUPSTREAM-}" ]; then
323 __git_ps1_show_upstream
328 if [ $pcmode = yes ]; then
330 if [ -n "${GIT_PS1_SHOWCOLORHINT-}" ]; then
332 local c_green
='\e[32m'
333 local c_yellow
='\e[33m'
334 local c_lblue
='\e[1;34m'
335 local c_purple
='\e[35m'
336 local c_cyan
='\e[36m'
337 local c_clear
='\e[0m'
338 local branchstring
="$c${b##refs/heads/}"
339 local branch_color
="$c_green"
340 local flags_color
="$c_cyan"
342 if [ "$w" = "*" ]; then
343 branch_color
="$c_red"
344 elif [ -n "$i" ]; then
345 branch_color
="$c_yellow"
348 # Setting PS1 directly with \[ and \] around colors
349 # is necessary to prevent wrapping issues!
350 PS1
="$PS1\[$branch_color\]$branchstring\[$c_clear\]"
352 PS1
="$PS1 \[$flags_color\]$f\[$c_clear\]"
355 PS1
="$PS1$c${b##refs/heads/}${f:+ $f}$r$p"
357 PS1
="$PS1)$ps1pc_end"
359 # NO color option unless in PROMPT_COMMAND mode
360 printf -- "$printf_format" "$c${b##refs/heads/}${f:+ $f}$r$p"