vcprompt

Version control information in your prompt.

This project is not under active development. Forks are encouraged!

INSTALL

Download vcprompt, make it executable and add it to your prompt:

$ curl -sL https://github.com/djl/vcprompt/raw/master/bin/vcprompt > ~/bin/vcprompt
$ chmod 755 ~/bin/vcprompt

For bash, you'll want to do something like this:

$ export PS1='\u@\h:\w \$(vcprompt)\$'

ZSH users should be aware that they will have to set the PROMPT_SUBST option first:

$ setopt prompt_subst
$ export PS1='%n@%m:%~ $(vcprompt)$ '

OPTIONS

• -f, --format FORMAT

  Passes a custom output format to vcprompt. Defaults to %s:%b. See below for more details.

• -p, --path PATH

  The path on which to run vcprompt. Defaults to the current directory.

• -n, --no-newline

  Do not print a trailing newline character.

• -s, --systems

  Prints all available version control systems to standard out.

• -t, --timeout

  The maximum execution time in milliseconds.

• -h, --help

  Prints the help message and exists.

• -v, --version

  Prints the current version number and exits.

Each version control system also has it's own formatting option. The options take the form of --format-SYSTEM. The available options are currently:

• --format-bzr
• --format-cvs
• --format-darcs
• --format-fossil
• --format-git
• --format-hg
• --format-svn

You can customise the status symbols used with the following options:

• -A, --staged

  The symbol to print when changes have been staged. Defaults to *

• -M, --modified

  The symbol to print when files have been modified. Defaults to +

• -U, --untracked

  The symbol to print when there are untracked files. Defaults to ?

FORMATS

vcprompt comes with a number of formatting tokens. What follows is a list of all the available tokens:

• %s, %n

  The "short name" of the version control system currently in use. E.g. git, hg, svn

• %h

  The hash of the repository. If no hash is available it will show the revision number instead.

• %r

  The revision number of the repository. If no revision number is available it will return the hash instead.

• %b

  The current branch (or basename of the repository if the branch name is unavailable).

• %m

  Displays a plus symbol (+) if there are any changes (which are not staged for commit, in systems that make such a distinction, i.e. git).

• %a

  Displays an asterisk (*) if there are any changes staged for commit (in systems that make such a distinction, i.e. git).

• %u

  Displays a question mark (?) if there are any untracked files.

• %P

  The name of the repository root directory (typically a project name).

• %p

  The relative path from the repository root directory to the current directory (or the directory specified by --path).

REQUIREMENTS

• Python 2.4 or later (including Python 3).

• Support for Subversion >= 1.7 and Fossil requires the SQLite3 Python module to be installed (built in on Python 2.5+).

NOTES

vcprompt was heavily inspired by Greg Ward's original implementation in C.

This version of vcprompt attempts to stay mostly compatible with the original although there may be some notable differences.