49 lines
1.2 KiB
Markdown
49 lines
1.2 KiB
Markdown
# Branch plugin
|
|
|
|
This plugin displays the current Git or Mercurial branch, fast. If in a Mercurial repository,
|
|
also display the current bookmark, if present.
|
|
|
|
To use it, add `branch` to the plugins array in your zshrc file:
|
|
|
|
```zsh
|
|
plugins=(... branch)
|
|
```
|
|
|
|
## Speed test
|
|
|
|
- `hg branch`:
|
|
|
|
```console
|
|
$ time hg branch
|
|
0.11s user 0.14s system 70% cpu 0.355 total
|
|
```
|
|
|
|
- branch plugin:
|
|
|
|
```console
|
|
$ time zsh /tmp/branch_prompt_info_test.zsh
|
|
0.00s user 0.01s system 78% cpu 0.014 total
|
|
```
|
|
|
|
## Usage
|
|
|
|
Copy your theme to `$ZSH_CUSTOM/themes/` and modify it to add `$(branch_prompt_info)` in your prompt.
|
|
This example is for the `robbyrussell` theme:
|
|
|
|
```diff
|
|
diff --git a/themes/robbyrussell.zsh-theme b/themes/robbyrussell.zsh-theme
|
|
index 2fd5f2cd..9d89a464 100644
|
|
--- a/themes/robbyrussell.zsh-theme
|
|
+++ b/themes/robbyrussell.zsh-theme
|
|
@@ -1,5 +1,5 @@
|
|
PROMPT="%(?:%{$fg_bold[green]%}➜ :%{$fg_bold[red]%}➜ )"
|
|
-PROMPT+=' %{$fg[cyan]%}%c%{$reset_color%} $(git_prompt_info)'
|
|
+PROMPT+=' %{$fg[cyan]%}%c%{$reset_color%} $(branch_prompt_info)'
|
|
|
|
ZSH_THEME_GIT_PROMPT_PREFIX="%{$fg_bold[blue]%}git:(%{$fg[red]%}"
|
|
ZSH_THEME_GIT_PROMPT_SUFFIX="%{$reset_color%} "
|
|
```
|
|
|
|
## Maintainer
|
|
|
|
Victor Torres (<vpaivatorres@gmail.com>)
|