You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
60 lines
2.2 KiB
60 lines
2.2 KiB
# Mercurial plugin |
|
### Usage |
|
Update .zshrc: |
|
|
|
1. Add name to the list of plugins, e.g. `plugins=(... mercurial ...)` |
|
(that is pretty obvious). |
|
2. Switch to a theme which uses `hg_prompt_info`. |
|
|
|
Or, customize the `$PROMPT` variable of your current theme to contain current folder mercurial repo info. This can be done by putting a custom version of the theme in `$ZSH_CUSTOM` or by changing `$PROMPT` in `.zshrc` after loading the theme. |
|
|
|
The `robbyrussell` theme is used by default, so you need to modify `$PROMPT` var by adding `$(hg_prompt_info)` after `$(git_prompt_info)`, so it looks like this: |
|
|
|
```zsh |
|
PROMPT='${ret_status}%{$fg_bold[green]%}%p %{$fg[cyan]%}%c %{$fg_bold[blue]%}$(git_prompt_info)$(hg_prompt_info)%{$fg_bold[blue]%} % %{$reset_color%}' |
|
``` |
|
|
|
3. Initialize additional vars used in plugin. So in short put next in **.zshrc**: |
|
|
|
``` |
|
ZSH_THEME_HG_PROMPT_PREFIX="%{$fg_bold[magenta]%}hg:(%{$fg[red]%}" |
|
ZSH_THEME_HG_PROMPT_SUFFIX="%{$reset_color%}" |
|
ZSH_THEME_HG_PROMPT_DIRTY="%{$fg[magenta]%}) %{$fg[yellow]%}✗%{$reset_color%}" |
|
ZSH_THEME_HG_PROMPT_CLEAN="%{$fg[magenta]%})" |
|
``` |
|
|
|
### What's inside? |
|
#### Adds handy aliases: |
|
###### general |
|
* `hgc` - `hg commit` |
|
* `hgb` - `hg branch` |
|
* `hgba` - `hg branches` |
|
* `hgbk` - `hg bookmarks` |
|
* `hgco` - `hg checkout` |
|
* `hgd` - `hg diff` |
|
* `hged` - `hg diffmerge` |
|
|
|
###### pull and update |
|
* `hgi` - `hg incoming` |
|
* `hgl` - `hg pull -u` |
|
* `hglr` - `hg pull --rebase` |
|
* `hgo` - `hg outgoing` |
|
* `hgp` - `hg push` |
|
* `hgs` - `hg status` |
|
* `hgsl` - `hg log --limit 20 --template "{node|short} | {date|isodatesec} | {author|user}: {desc|strip|firstline}\n"` |
|
|
|
###### this is the 'git commit --amend' equivalent |
|
* `hgca` - `hg qimport -r tip ; hg qrefresh -e ; hg qfinish tip` |
|
|
|
###### list unresolved files (since hg does not list unmerged files in the status command) |
|
* `hgun` - `hg resolve --list` |
|
|
|
#### Displays repo branch and directory status in prompt |
|
This is the same as git plugin does. |
|
|
|
**Note**: Additional changes to **.zshrc**, or using a theme designed to use `hg_prompt_info`, are required in order for this to work. |
|
|
|
### Mantainers |
|
[ptrv](https://github.com/ptrv) - original creator |
|
|
|
[oshybystyi](https://github.com/oshybystyi) - created this README and know how most of code works
|
|
|