1
0
Fork 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2024-12-24 05:11:58 +00:00
ohmyzsh/plugins/branch/README.md
whoami 46e63340ee
feat(branch): show mercurial bookmarks if used (#9948)
Co-authored-by: Marc Cornellà <hello@mcornella.com>
2021-12-01 17:49:42 +01:00

1.2 KiB

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:

plugins=(... branch)

Speed test

  • hg branch:

    $ time hg branch
    0.11s user 0.14s system 70% cpu 0.355 total
    
  • branch plugin:

    $ 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 --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)