Mercurial
Whatโ
Display Mercurial information when in a Mercurial repository. For maximum compatibility,
make sure your hg executable is up-to-date (when branch or status information is incorrect for example).
Sample Configurationโ
- json
- yaml
- toml
{
"type": "mercurial",
"style": "powerline",
"powerline_symbol": "๎ฐ",
"foreground": "#193549",
"background": "#ffeb3b",
"properties": {
"newprop": "๎ฟฑ"
}
}
type: mercurial
style: powerline
powerline_symbol: ๎ฐ
foreground: "#193549"
background: "#ffeb3b"
properties:
newprop: ๎ฟฑ
type = "mercurial"
style = "powerline"
powerline_symbol = "๎ฐ"
foreground = "#193549"
background = "#ffeb3b"
[properties]
newprop = "๎ฟฑ"
Propertiesโ
Fetching informationโ
As doing Mercurial (hg) calls can slow down the prompt experience, we do not fetch information by default.
You can set the following properties to true to enable fetching additional information (and populate the template).
| Name | Type | Default | Description |
|---|---|---|---|
fetch_status | boolean | false | fetch the local changes |
status_formats | map[string]string | a key, value map allowing to override how individual status items are displayed. For example, "status_formats": { "Added": "Added: %d" } will display the added count as Added: 1 instead of +1. See the Status section for available overrides |
Template (info)โ
default template
hg {{.Branch}} {{if .LocalCommitNumber}}({{.LocalCommitNumber}}:{{.ChangeSetIDShort}}){{end}}{{range .Bookmarks }} \uf02e {{.}}{{end}}{{range .Tags}} \uf02b {{.}}{{end}}{{if .Working.Changed}} \uf044 {{ .Working.String }}{{ end }}
Propertiesโ
| Name | Type | Description |
|---|---|---|
.Working | Status | changes in the worktree (see below) |
.IsTip | boolean | Current commit is the tip commit |
.ChangeSetID | string | The current local commit number |
.ChangeSetID | string | The current local commit number |
.ChangeSetIDShort | string | The current local commit number |
.Branch | string | current branch (releative URL reported by svn info) |
.Bookmarks | []string | the currently checked out revision number |
.Tags | []string | the currently checked out revision number |
Statusโ
| Name | Type | Description |
|---|---|---|
.Untracked | int | number of files not under version control |
.Modified | int | number of modified files |
.Deleted | int | number of deleted files |
.Added | int | number of added files |
.Changed | boolean | if the status contains changes or not |
.String | string | a string representation of the changes above |
Local changes use the following syntax:
| Icon | Description |
|---|---|
? | Untracked |
~ | Modified |
- | Deleted |
+ | Added |