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 # 3) Change your PS1 to also show the current branch:
14 # Bash: PS1='[\u@\h \W$(__git_ps1 " (%s)")]\$ '
15 # ZSH: PS1='[%n@%m %c$(__git_ps1 " (%s)")]\$ '
17 # The argument to __git_ps1 will be displayed only if you are currently
18 # in a git repository. The %s token will be the name of the current
21 # In addition, if you set GIT_PS1_SHOWDIRTYSTATE to a nonempty value,
22 # unstaged (*) and staged (+) changes will be shown next to the branch
23 # name. You can configure this per-repository with the
24 # bash.showDirtyState variable, which defaults to true once
25 # GIT_PS1_SHOWDIRTYSTATE is enabled.
27 # You can also see if currently something is stashed, by setting
28 # GIT_PS1_SHOWSTASHSTATE to a nonempty value. If something is stashed,
29 # then a '$' will be shown next to the branch name.
31 # If you would like to see if there're untracked files, then you can set
32 # GIT_PS1_SHOWUNTRACKEDFILES to a nonempty value. If there're untracked
33 # files, then a '%' will be shown next to the branch name.
35 # If you would like to see the difference between HEAD and its upstream,
36 # set GIT_PS1_SHOWUPSTREAM="auto". A "<" indicates you are behind, ">"
37 # indicates you are ahead, and "<>" indicates you have diverged. You
38 # can further control behaviour by setting GIT_PS1_SHOWUPSTREAM to a
39 # space-separated list of values:
41 # verbose show number of commits ahead/behind (+/-) upstream
42 # legacy don't use the '--count' option available in recent
43 # versions of git-rev-list
44 # git always compare HEAD to @{upstream}
45 # svn always compare HEAD to your SVN upstream
47 # By default, __git_ps1 will compare HEAD to your SVN upstream if it can
48 # find one, or @{upstream} otherwise. Once you have set
49 # GIT_PS1_SHOWUPSTREAM, you can override it on a per-repository basis by
50 # setting the bash.showUpstream config variable.
52 # __gitdir accepts 0 or 1 arguments (i.e., location)
53 # returns location of .git repo
56 if [ -z "${1-}" ]; then
57 if [ -n "${__git_dir-}" ]; then
59 elif [ -n "${GIT_DIR-}" ]; then
60 test -d "${GIT_DIR-}" ||
return 1
62 elif [ -d .git
]; then
65 git rev-parse
--git-dir 2>/dev
/null
67 elif [ -d "$1/.git" ]; then
74 # stores the divergence from upstream in $p
75 # used by GIT_PS1_SHOWUPSTREAM
76 __git_ps1_show_upstream
()
79 local svn_remote svn_url_pattern count n
80 local upstream
=git legacy
="" verbose
=""
83 # get some config options from git-config
84 local output
="$(git config -z --get-regexp '^(svn-remote\..*\.url|bash\.showupstream)$' 2>/dev/null | tr '\0\n' '\n ')"
85 while read -r key value
; do
88 GIT_PS1_SHOWUPSTREAM
="$value"
89 if [[ -z "${GIT_PS1_SHOWUPSTREAM}" ]]; then
95 svn_remote
[ $
((${#svn_remote[@]} + 1)) ]="$value"
96 svn_url_pattern
+="\\|$value"
97 upstream
=svn
+git
# default upstream is SVN if available, else git
102 # parse configuration values
103 for option
in ${GIT_PS1_SHOWUPSTREAM}; do
105 git|svn
) upstream
="$option" ;;
106 verbose
) verbose
=1 ;;
113 git
) upstream
="@{upstream}" ;;
115 # get the upstream from the "git-svn-id: ..." in a commit message
116 # (git-svn uses essentially the same procedure internally)
117 local svn_upstream
=($
(git log
--first-parent -1 \
118 --grep="^git-svn-id: \(${svn_url_pattern#??}\)" 2>/dev
/null
))
119 if [[ 0 -ne ${#svn_upstream[@]} ]]; then
120 svn_upstream
=${svn_upstream[ ${#svn_upstream[@]} - 2 ]}
121 svn_upstream
=${svn_upstream%@*}
122 local n_stop
="${#svn_remote[@]}"
123 for ((n
=1; n
<= n_stop
; n
++)); do
124 svn_upstream
=${svn_upstream#${svn_remote[$n]}}
127 if [[ -z "$svn_upstream" ]]; then
128 # default branch name for checkouts with no layout:
129 upstream
=${GIT_SVN_ID:-git-svn}
131 upstream
=${svn_upstream#/}
133 elif [[ "svn+git" = "$upstream" ]]; then
134 upstream
="@{upstream}"
139 # Find how many commits we are ahead/behind our upstream
140 if [[ -z "$legacy" ]]; then
141 count
="$(git rev-list --count --left-right \
142 "$upstream"...HEAD 2>/dev/null)"
144 # produce equivalent output to --count for older versions of git
146 if commits
="$(git rev-list --left-right "$upstream"...HEAD 2>/dev/null)"
148 local commit behind
=0 ahead
=0
149 for commit
in $commits
152 "<"*) ((behind
++)) ;;
156 count
="$behind $ahead"
162 # calculate the result
163 if [[ -z "$verbose" ]]; then
167 "0 0") # equal to upstream
169 "0 "*) # ahead of upstream
171 *" 0") # behind upstream
173 *) # diverged from upstream
180 "0 0") # equal to upstream
182 "0 "*) # ahead of upstream
183 p
=" u+${count#0 }" ;;
184 *" 0") # behind upstream
185 p
=" u-${count% 0}" ;;
186 *) # diverged from upstream
187 p
=" u+${count#* }-${count% *}" ;;
194 # __git_ps1 accepts 0 or 1 arguments (i.e., format string)
195 # returns text to add to bash PS1 prompt (includes branch name)
198 local g
="$(__gitdir)"
202 if [ -f "$g/rebase-merge/interactive" ]; then
204 b
="$(cat "$g/rebase-merge
/head-name
")"
205 elif [ -d "$g/rebase-merge" ]; then
207 b
="$(cat "$g/rebase-merge
/head-name
")"
209 if [ -d "$g/rebase-apply" ]; then
210 if [ -f "$g/rebase-apply/rebasing" ]; then
212 elif [ -f "$g/rebase-apply/applying" ]; then
217 elif [ -f "$g/MERGE_HEAD" ]; then
219 elif [ -f "$g/CHERRY_PICK_HEAD" ]; then
221 elif [ -f "$g/BISECT_LOG" ]; then
225 b
="$(git symbolic-ref HEAD 2>/dev/null)" ||
{
228 case "${GIT_PS1_DESCRIBE_STYLE-}" in
230 git describe --contains HEAD ;;
232 git describe --contains --all HEAD ;;
236 git describe --tags --exact-match HEAD ;;
237 esac 2>/dev/null)" ||
239 b
="$(cut -c1-7 "$g/HEAD
" 2>/dev/null)..." ||
252 if [ "true" = "$(git rev-parse --is-inside-git-dir 2>/dev/null)" ]; then
253 if [ "true" = "$(git rev-parse --is-bare-repository 2>/dev/null)" ]; then
258 elif [ "true" = "$(git rev-parse --is-inside-work-tree 2>/dev/null)" ]; then
259 if [ -n "${GIT_PS1_SHOWDIRTYSTATE-}" ]; then
260 if [ "$(git config --bool bash.showDirtyState)" != "false" ]; then
261 git
diff --no-ext-diff --quiet --exit-code || w
="*"
262 if git rev-parse
--quiet --verify HEAD
>/dev
/null
; then
263 git diff-index
--cached --quiet HEAD
-- || i
="+"
269 if [ -n "${GIT_PS1_SHOWSTASHSTATE-}" ]; then
270 git rev-parse
--verify refs
/stash
>/dev
/null
2>&1 && s
="$"
273 if [ -n "${GIT_PS1_SHOWUNTRACKEDFILES-}" ]; then
274 if [ -n "$(git ls-files --others --exclude-standard)" ]; then
279 if [ -n "${GIT_PS1_SHOWUPSTREAM-}" ]; then
280 __git_ps1_show_upstream
285 printf -- "${1:- (%s)}" "$c${b##refs/heads/}${f:+ $f}$r$p"