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 # __gitdir accepts 0 or 1 arguments (i.e., location)
59 # returns location of .git repo
62 # Note: this function is duplicated in git-completion.bash
63 # When updating it, make sure you update the other one to match.
64 if [ -z "${1-}" ]; then
65 if [ -n "${__git_dir-}" ]; then
67 elif [ -n "${GIT_DIR-}" ]; then
68 test -d "${GIT_DIR-}" || return 1
70 elif [ -d .git ]; then
73 git rev-parse --git-dir 2>/dev/null
75 elif [ -d "$1/.git" ]; then
82 # stores the divergence from upstream in $p
83 # used by GIT_PS1_SHOWUPSTREAM
84 __git_ps1_show_upstream ()
87 local svn_remote svn_url_pattern count n
88 local upstream=git legacy="" verbose=""
91 # get some config options from git-config
92 local output="$(git config -z --get-regexp '^(svn-remote\..*\.url|bash\.showupstream)$' 2>/dev/null | tr '\0\n' '\n ')"
93 while read -r key value; do
96 GIT_PS1_SHOWUPSTREAM="$value"
97 if [[ -z "${GIT_PS1_SHOWUPSTREAM}" ]]; then
103 svn_remote[ $((${#svn_remote[@]} + 1)) ]="$value"
104 svn_url_pattern+="\\|$value"
105 upstream=svn+git # default upstream is SVN if available, else git
110 # parse configuration values
111 for option in ${GIT_PS1_SHOWUPSTREAM}; do
113 git|svn) upstream="$option" ;;
114 verbose) verbose=1 ;;
121 git) upstream="@{upstream}" ;;
123 # get the upstream from the "git-svn-id: ..." in a commit message
124 # (git-svn uses essentially the same procedure internally)
125 local svn_upstream=($(git log --first-parent -1 \
126 --grep="^git-svn-id: \(${svn_url_pattern#??}\)" 2>/dev/null))
127 if [[ 0 -ne ${#svn_upstream[@]} ]]; then
128 svn_upstream=${svn_upstream[ ${#svn_upstream[@]} - 2 ]}
129 svn_upstream=${svn_upstream%@*}
130 local n_stop="${#svn_remote[@]}"
131 for ((n=1; n <= n_stop; n++)); do
132 svn_upstream=${svn_upstream#${svn_remote[$n]}}
135 if [[ -z "$svn_upstream" ]]; then
136 # default branch name for checkouts with no layout:
137 upstream=${GIT_SVN_ID:-git-svn}
139 upstream=${svn_upstream#/}
141 elif [[ "svn+git" = "$upstream" ]]; then
142 upstream="@{upstream}"
147 # Find how many commits we are ahead/behind our upstream
148 if [[ -z "$legacy" ]]; then
149 count="$(git rev-list --count --left-right \
150 "$upstream"...HEAD 2>/dev/null)"
152 # produce equivalent output to --count for older versions of git
154 if commits="$(git rev-list --left-right "$upstream"...HEAD 2>/dev/null)"
156 local commit behind=0 ahead=0
157 for commit in $commits
160 "<"*) ((behind++)) ;;
164 count="$behind $ahead"
170 # calculate the result
171 if [[ -z "$verbose" ]]; then
175 "0 0") # equal to upstream
177 "0 "*) # ahead of upstream
179 *" 0") # behind upstream
181 *) # diverged from upstream
188 "0 0") # equal to upstream
190 "0 "*) # ahead of upstream
191 p=" u+${count#0 }" ;;
192 *" 0") # behind upstream
193 p=" u-${count% 0}" ;;
194 *) # diverged from upstream
195 p=" u+${count#* }-${count% *}" ;;
202 # __git_ps1 accepts 0 or 1 arguments (i.e., format string)
203 # when called from PS1 using command substitution
204 # in this mode it prints text to add to bash PS1 prompt (includes branch name)
206 # __git_ps1 requires 2 arguments when called from PROMPT_COMMAND (pc)
207 # in that case it _sets_ PS1. The arguments are parts of a PS1 string.
208 # when both arguments are given, the first is prepended and the second appended
209 # to the state string when assigned to PS1.
214 local ps1pc_start='\u@\h:\w '
215 local ps1pc_end='\$ '
216 local printf_format=' (%s)'
223 0|1) printf_format="${1:-$printf_format}"
229 local g="$(__gitdir)"
231 if [ $pcmode = yes ]; then
232 #In PC mode PS1 always needs to be set
233 PS1="$ps1pc_start$ps1pc_end"
238 if [ -f "$g/rebase-merge/interactive" ]; then
240 b="$(cat "$g/rebase-merge/head-name")"
241 elif [ -d "$g/rebase-merge" ]; then
243 b="$(cat "$g/rebase-merge/head-name")"
245 if [ -d "$g/rebase-apply" ]; then
246 if [ -f "$g/rebase-apply/rebasing" ]; then
248 elif [ -f "$g/rebase-apply/applying" ]; then
253 elif [ -f "$g/MERGE_HEAD" ]; then
255 elif [ -f "$g/CHERRY_PICK_HEAD" ]; then
257 elif [ -f "$g/BISECT_LOG" ]; then
261 b="$(git symbolic-ref HEAD 2>/dev/null)" || {
264 case "${GIT_PS1_DESCRIBE_STYLE-}" in
266 git describe --contains HEAD ;;
268 git describe --contains --all HEAD ;;
272 git describe --tags --exact-match HEAD ;;
273 esac 2>/dev/null)" ||
275 b="$(cut -c1-7 "$g/HEAD" 2>/dev/null)..." ||
288 if [ "true" = "$(git rev-parse --is-inside-git-dir 2>/dev/null)" ]; then
289 if [ "true" = "$(git rev-parse --is-bare-repository 2>/dev/null)" ]; then
294 elif [ "true" = "$(git rev-parse --is-inside-work-tree 2>/dev/null)" ]; then
295 if [ -n "${GIT_PS1_SHOWDIRTYSTATE-}" ]; then
296 if [ "$(git config --bool bash.showDirtyState)" != "false" ]; then
297 git diff --no-ext-diff --quiet --exit-code || w="*"
298 if git rev-parse --quiet --verify HEAD >/dev/null; then
299 git diff-index --cached --quiet HEAD -- || i="+"
305 if [ -n "${GIT_PS1_SHOWSTASHSTATE-}" ]; then
306 git rev-parse --verify refs/stash >/dev/null 2>&1 && s="$"
309 if [ -n "${GIT_PS1_SHOWUNTRACKEDFILES-}" ]; then
310 if [ -n "$(git ls-files --others --exclude-standard)" ]; then
315 if [ -n "${GIT_PS1_SHOWUPSTREAM-}" ]; then
316 __git_ps1_show_upstream
321 if [ $pcmode = yes ]; then
323 PS1="$PS1$c${b##refs/heads/}${f:+ $f}$r$p"
324 PS1="$PS1)$ps1pc_end"
326 printf -- "$printf_format" "$c${b##refs/heads/}${f:+ $f}$r$p"