posh-git-bash

This script allows you to see the status of the current git repository in your
prompt. It replicates the prompt status from the Windows PowerShell module
dahlbyk/posh-git.

Installation Instructions

Copy this file to somewhere (e.g. ~/git-prompt.sh).
Add the following line to your ~/.bashrc. (You may need to update
your ~/.bash_profile to source your ~/.bashrc, or you can just modify
~/.bash_profile directly.)
```
 source ~/git-prompt.sh
```
If you are using bash, you should call __posh_git_ps1 in your
PROMPT_COMMAND variable. The function __posh_git_ps1 takes two
parameters as in __posh_git_ps1 <string_to_prepend> <string_to_append>.
This function updates PS1 accordingly. For example, the following
```
PROMPT_COMMAND='__posh_git_ps1 "\u@\h:\w" "\\\$ ";'$PROMPT_COMMAND
```
will show username, at-sign, host, colon, cwd, then various status strings,
followed by dollar and space, as your prompt. This invocation prepends this
instruction to the existing value of PROMPT_COMMAND.

If you are using zsh, you need to set the
PROMPT
variable or the
precmd
hook. See also __posh_git_echo or
issue #14 for oh-my-zsh.

The Prompt

By default, the status summary has the following format:

[{HEAD-name} x +A ~B -C !D | +E ~F -G !H]

{HEAD-name} is the current branch, or the SHA of a detached HEAD. The color
of {HEAD-name} represents the divergence from upstream. {HEAD-name} also
changes to indicate progress if you are in the middle of a cherry-pick, a
merge, a rebase, etc.
- cyan the branch matches its remote
- green the branch is ahead of its remote (green light to push)
- red the branch is behind its remote
- yellow the branch is both ahead of and behind its remote
x is a symbol that represents the divergence from upstream.
- ≡ the branch matches its remote
- ↑ the branch is ahead of its remote
- ↓ the branch is behind its remote
- ↕ the branch is both ahead of and behind its remote
Status changes are indicated by prefixes to A through H, where A through
D represent counts for the index and E through H represent counts for
the working directory. As in git status, index status is dark green and
working directory status is dark red.
- + added
- ~ modified
- - removed
- ! conflicting

For example, a status of [master ≡ +0 ~2 -1 | +1 ~1 -0] corresponds to the
following git status:

# On branch master
#
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#        modified:   this-changed.txt
#        modified:   this-too.txt
#        deleted:    gone.txt
#
# Changed but not updated:
#   (use "git add <file>..." to update what will be committed)
#   (use "git checkout -- <file>..." to discard changes in working directory)
#
#        modified:   not-staged.txt
#
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#
#        new.txt

Example setup

To get the above prompt display, I have the following in my .bashrc:

    export PROMPT_COMMAND='__posh_git_ps1 "\\[\[\e[0;32m\]\u@\h \[\e[0;33m\]\w" " \[\e[1;34m\]\n\$\[\e[0m\] ";'$PROMPT_COMMAND

Try it out and let me know what you think!

Configuration Options

This script should work out of the box. You can set options controlling the
output of the script by using
git config.
This allows you to control the prompt display on a per-repository basis.

For example, if computing file changes is taking too long in a large repository,
you can turn off this behavior (for that repository only):

cd my-git-repo/
git config bash.enableFileStatus false

To restore the default behavior, you can remove the configuration setting:

cd my-git-repo/
git config --unset bash.enableFileStatus

You can also manually edit your git configuration files. These files are most
likely ~/.gitconfig or .git/config. An example illustrating the syntax of
these files can be found at http://git-scm.com/docs/git-config#_example.

bash.describeStyle

This option controls if you would like to see more information about the
identity of commits checked out as a detached HEAD. This is also controlled
by the legacy environment variable GIT_PS1_DESCRIBESTYLE.

Option	Description
contains	relative to newer annotated tag `(v1.6.3.2~35)`
branch	relative to newer tag or branch `(master~4)`
describe	relative to older annotated tag `(v1.6.3.1-13-gdd42c2f)`
default	exactly matching tag

bash.enableFileStatus

Option	Description
true	Default. The script will query for all file indicators every time.
false	No file indicators will be displayed. The script will not query upstream for differences. Branch color-coding information is still displayed.

bash.enableGitStatus

Option	Description
true	Default. Color coding and indicators will be shown.
false	The script will not run.

bash.showStashState

Option	Description
true	Default. An indicator will display if the stash is not empty.
false	An indicator will not display the stash status.

bash.showStatusWhenZero

Option	Description
true	Indicators will be shown even if there are no updates to the index or working tree.
false	Default. No file change indicators will be shown if there are no changes to the index or working tree.

bash.showUpstream

By default, __posh_git_ps1 will compare HEAD to your SVN upstream if it can
find one, or @{upstream} otherwise. This is also controlled by the legacy
environment variable GIT_PS1_SHOWUPSTREAM.

Option	Description
legacy	Does not use the `--count` option available in recent versions of `git-rev-list`
git	Default. Always compares `HEAD` to `@{upstream}`
svn	Always compares `HEAD` to `SVN` upstream

Background

This was my first venture into bash scripting, so I decided to make a clone of
posh-git, which is a set of PowerShell
scripts for git integration. In my humble opinion, I think it is fantastic.

I based my work off of
https://github.com/git/git/blob/master/contrib/completion/git-prompt.sh

Please do not hesitate to contact me about any issues or requests. I hope that
you may find some use for this script.

License

This is distributed under the GNU GPL v2.0.

AluisioASG/posh-git-sh