mudhorn/oh-my-posh
1
0
Fork 0
mirror of https://github.com/JanDeDobbeleer/oh-my-posh.git synced 2024-12-26 03:24:04 -08:00
Code Issues Actions Packages Projects Releases Wiki Activity

feat(scm): allow status override

Browse source 
resolves #3992
This commit is contained in:
Jan De Dobbeleer 2023-06-26 08:44:17 +02:00 committed by Jan De Dobbeleer
parent e5d4282136
commit 32ee6fa7ab
15 changed files with 284 additions and 195 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
src/segments/git.go
View file

@ -146,8 +146,9 @@ func (g *Git) Template() string {
} }
func (g *Git) Enabled() bool { func (g *Git) Enabled() bool {
g.Working = &GitStatus{} statusFormats := g.props.GetKeyValueMap(StatusFormats, map[string]string{})
g.Staging = &GitStatus{} g.Working = &GitStatus{ScmStatus: ScmStatus{Formats: statusFormats}}
g.Staging = &GitStatus{ScmStatus: ScmStatus{Formats: statusFormats}}
g.User = &User{} g.User = &User{}
if !g.shouldDisplay() { if !g.shouldDisplay() {

3
src/segments/mercurial.go
View file

@ -51,7 +51,8 @@ func (hg *Mercurial) Enabled() bool {
return false return false
} }
hg.Working = &MercurialStatus{} statusFormats := hg.props.GetKeyValueMap(StatusFormats, map[string]string{})
hg.Working = &MercurialStatus{ScmStatus: ScmStatus{Formats: statusFormats}}
displayStatus := hg.props.GetBool(FetchStatus, false) displayStatus := hg.props.GetBool(FetchStatus, false)
if displayStatus { if displayStatus {

4
src/segments/mercurial_test.go
View file

@ -165,6 +165,10 @@ A Added.File
}, },
} }
if tc.ExpectedWorking != nil {
tc.ExpectedWorking.Formats = map[string]string{}
}
assert.True(t, hg.Enabled()) assert.True(t, hg.Enabled())
assert.Equal(t, fileInfo.Path, hg.workingDir) assert.Equal(t, fileInfo.Path, hg.workingDir)
assert.Equal(t, fileInfo.Path, hg.realDir) assert.Equal(t, fileInfo.Path, hg.realDir)

5
src/segments/plastic.go
View file

@ -61,6 +61,7 @@ func (p *Plastic) Enabled() bool {
if !wkdir.IsDir { if !wkdir.IsDir {
return false return false
} }
p.plasticWorkspaceFolder = wkdir.ParentFolder p.plasticWorkspaceFolder = wkdir.ParentFolder
displayStatus := p.props.GetBool(FetchStatus, false) displayStatus := p.props.GetBool(FetchStatus, false)
p.setSelector() p.setSelector()
@ -78,9 +79,11 @@ func (p *Plastic) setPlasticStatus() {
headChangeset := p.getHeadChangeset() headChangeset := p.getHeadChangeset()
p.Behind = headChangeset > currentChangeset p.Behind = headChangeset > currentChangeset
statusFormats := p.props.GetKeyValueMap(StatusFormats, map[string]string{})
p.Status = &PlasticStatus{ScmStatus: ScmStatus{Formats: statusFormats}}
// parse file state // parse file state
p.MergePending = false p.MergePending = false
p.Status = &PlasticStatus{}
p.parseFilesStatus(splittedOutput) p.parseFilesStatus(splittedOutput)
} }

3
src/segments/sapling.go
View file

@ -106,7 +106,8 @@ func (sl *Sapling) setDir(dir string) {
func (sl *Sapling) setHeadContext() { func (sl *Sapling) setHeadContext() {
sl.setCommitContext() sl.setCommitContext()
sl.Working = &SaplingStatus{} statusFormats := sl.props.GetKeyValueMap(StatusFormats, map[string]string{})
sl.Working = &SaplingStatus{ScmStatus: ScmStatus{Formats: statusFormats}}
displayStatus := sl.props.GetBool(FetchStatus, true) displayStatus := sl.props.GetBool(FetchStatus, true)
if !displayStatus { if !displayStatus {

52
src/segments/scm.go
View file

@ -11,6 +11,8 @@ import (
const ( const (
// Fallback to native command // Fallback to native command
NativeFallback properties.Property = "native_fallback" NativeFallback properties.Property = "native_fallback"
// Override the built-in status formats
StatusFormats properties.Property = "status_formats"
) )
// ScmStatus represents part of the status of a repository // ScmStatus represents part of the status of a repository
@ -25,6 +27,8 @@ type ScmStatus struct {
Clean int Clean int
Missing int Missing int
Ignored int Ignored int
Formats map[string]string
} }
func (s *ScmStatus) Changed() bool { func (s *ScmStatus) Changed() bool {
@ -41,24 +45,38 @@ func (s *ScmStatus) Changed() bool {
} }
func (s *ScmStatus) String() string { func (s *ScmStatus) String() string {
var status string var status strings.Builder
stringIfValue := func(value int, prefix string) string {
if value > 0 { if s.Formats == nil {
return fmt.Sprintf(" %s%d", prefix, value) s.Formats = make(map[string]string)
}
return ""
} }
status += stringIfValue(s.Untracked, "?")
status += stringIfValue(s.Added, "+") stringIfValue := func(value int, name, prefix string) {
status += stringIfValue(s.Modified, "~") if value <= 0 {
status += stringIfValue(s.Deleted, "-") return
status += stringIfValue(s.Moved, ">") }
status += stringIfValue(s.Unmerged, "x")
status += stringIfValue(s.Conflicted, "!") // allow user override for prefix
status += stringIfValue(s.Missing, "!") if _, ok := s.Formats[name]; ok {
status += stringIfValue(s.Clean, "=") status.WriteString(fmt.Sprintf(s.Formats[name], value))
status += stringIfValue(s.Ignored, "Ø") return
return strings.TrimSpace(status) }
status.WriteString(fmt.Sprintf(" %s%d", prefix, value))
}
stringIfValue(s.Untracked, "Untracked", "?")
stringIfValue(s.Added, "Added", "+")
stringIfValue(s.Modified, "Modified", "~")
stringIfValue(s.Deleted, "Deleted", "-")
stringIfValue(s.Moved, "Moved", ">")
stringIfValue(s.Unmerged, "Unmerged", "x")
stringIfValue(s.Conflicted, "Conflicted", "!")
stringIfValue(s.Missing, "Missing", "!")
stringIfValue(s.Clean, "Clean", "=")
stringIfValue(s.Ignored, "Ignored", "Ø")
return strings.TrimSpace(status.String())
} }
type scm struct { type scm struct {

55
src/segments/scm_test.go
View file

@ -63,27 +63,46 @@ func TestScmStatusChanged(t *testing.T) {
} }
} }
func TestScmStatusUnmerged(t *testing.T) { func TestScmStatusString(t *testing.T) {
expected := "x1" cases := []struct {
status := &ScmStatus{ Case string
Unmerged: 1, Expected string
Status ScmStatus
}{
{
Case: "Unmerged",
Expected: "x1",
Status: ScmStatus{
Unmerged: 1,
},
},
{
Case: "Unmerged and Modified",
Expected: "~3 x1",
Status: ScmStatus{
Unmerged: 1,
Modified: 3,
},
},
{
Case: "Empty",
Status: ScmStatus{},
},
{
Case: "Format override",
Expected: "Added: 1",
Status: ScmStatus{
Added: 1,
Formats: map[string]string{
"Added": "Added: %d",
},
},
},
} }
assert.Equal(t, expected, status.String())
}
func TestScmStatusUnmergedModified(t *testing.T) { for _, tc := range cases {
expected := "~3 x1" assert.Equal(t, tc.Expected, tc.Status.String(), tc.Case)
status := &ScmStatus{
Unmerged: 1,
Modified: 3,
} }
assert.Equal(t, expected, status.String())
}
func TestScmStatusEmpty(t *testing.T) {
expected := ""
status := &ScmStatus{}
assert.Equal(t, expected, status.String())
} }
func TestTruncateBranch(t *testing.T) { func TestTruncateBranch(t *testing.T) {

6
src/segments/svn.go
View file

@ -63,10 +63,12 @@ func (s *Svn) shouldDisplay() bool {
if !s.hasCommand(SVNCOMMAND) { if !s.hasCommand(SVNCOMMAND) {
return false return false
} }
Svndir, err := s.env.HasParentFilePath(".svn") Svndir, err := s.env.HasParentFilePath(".svn")
if err != nil { if err != nil {
return false return false
} }
if s.shouldIgnoreRootRepository(Svndir.ParentFolder) { if s.shouldIgnoreRootRepository(Svndir.ParentFolder) {
return false return false
} }
@ -78,6 +80,7 @@ func (s *Svn) shouldDisplay() bool {
s.realDir = strings.TrimSuffix(s.convertToWindowsPath(Svndir.Path), "/.svn") s.realDir = strings.TrimSuffix(s.convertToWindowsPath(Svndir.Path), "/.svn")
return true return true
} }
// handle worktree // handle worktree
s.rootDir = Svndir.Path s.rootDir = Svndir.Path
dirPointer := strings.Trim(s.env.FileContent(Svndir.Path), " \r\n") dirPointer := strings.Trim(s.env.FileContent(Svndir.Path), " \r\n")
@ -98,7 +101,8 @@ func (s *Svn) setSvnStatus() {
s.Branch = branch[2:] s.Branch = branch[2:]
} }
s.Working = &SvnStatus{} statusFormats := s.props.GetKeyValueMap(StatusFormats, map[string]string{})
s.Working = &SvnStatus{ScmStatus: ScmStatus{Formats: statusFormats}}
displayStatus := s.props.GetBool(FetchStatus, false) displayStatus := s.props.GetBool(FetchStatus, false)
if !displayStatus { if !displayStatus {

6
src/segments/svn_test.go
View file

@ -193,6 +193,7 @@ R Moved.File`,
Moved: 2, Moved: 2,
Untracked: 1, Untracked: 1,
Conflicted: 1, Conflicted: 1,
Formats: map[string]string{},
}}, }},
RefOutput: "1133", RefOutput: "1133",
ExpectedRef: 1133, ExpectedRef: 1133,
@ -206,18 +207,19 @@ R Moved.File`,
StatusOutput: `C build.cake`, StatusOutput: `C build.cake`,
ExpectedWorking: &SvnStatus{ScmStatus: ScmStatus{ ExpectedWorking: &SvnStatus{ScmStatus: ScmStatus{
Conflicted: 1, Conflicted: 1,
Formats: map[string]string{},
}}, }},
ExpectedChanged: true, ExpectedChanged: true,
ExpectedConflicts: true, ExpectedConflicts: true,
}, },
{ {
Case: "no change", Case: "no change",
ExpectedWorking: &SvnStatus{ScmStatus: ScmStatus{}}, ExpectedWorking: &SvnStatus{ScmStatus: ScmStatus{Formats: map[string]string{}}},
ExpectedChanged: false, ExpectedChanged: false,
}, },
{ {
Case: "not an integer ref", Case: "not an integer ref",
ExpectedWorking: &SvnStatus{ScmStatus: ScmStatus{}}, ExpectedWorking: &SvnStatus{ScmStatus: ScmStatus{Formats: map[string]string{}}},
ExpectedChanged: false, ExpectedChanged: false,
RefOutput: "not an integer", RefOutput: "not an integer",
}, },

21
themes/schema.json
View file

@ -102,6 +102,12 @@
"description": "Template that creates the URL of the version info / release notes", "description": "Template that creates the URL of the version info / release notes",
"default": "" "default": ""
}, },
"status_formats": {
"type": "object",
"title": "Status string formats",
"description": "Override the status format for a specific change. Example: {\"Added\": \"Added: %d\"}",
"default": {}
},
"extra_prompt": { "extra_prompt": {
"type": "object", "type": "object",
"default": {}, "default": {},
@ -1014,6 +1020,9 @@
"title": "Fetch the user", "title": "Fetch the user",
"description": "Fetch the current configured user for the repository", "description": "Fetch the current configured user for the repository",
"default": false "default": false
},
"status_formats": {
"$ref": "#/definitions/status_formats"
} }
} }
} }
@ -1891,6 +1900,9 @@
"title": "Display Status", "title": "Display Status",
"description": "Display the local changes or not", "description": "Display the local changes or not",
"default": true "default": true
},
"status_formats": {
"$ref": "#/definitions/status_formats"
} }
} }
} }
@ -2371,6 +2383,9 @@
"title": "Display Status", "title": "Display Status",
"description": "Display the local changes or not", "description": "Display the local changes or not",
"default": true "default": true
},
"status_formats": {
"$ref": "#/definitions/status_formats"
} }
} }
} }
@ -2584,6 +2599,9 @@
"title": "Full branch path", "title": "Full branch path",
"description": "display the full branch path instead of only the branch name", "description": "display the full branch path instead of only the branch name",
"default": false "default": false
},
"status_formats": {
"$ref": "#/definitions/status_formats"
} }
} }
} }
@ -3180,6 +3198,9 @@
"title": "Display Status", "title": "Display Status",
"description": "Display the local changes or not", "description": "Display the local changes or not",
"default": true "default": true
},
"status_formats": {
"$ref": "#/definitions/status_formats"
} }
} }
} }

64
website/docs/segments/git.mdx
View file

@ -80,6 +80,7 @@ You can set the following properties to `true` to enable fetching additional inf
| `ignore_submodules` | `map[string]string` | map of repo's where to change the [--ignore-submodules][submodules] flag (`none`, `untracked`, `dirty` or `all`). For example `"ignore_submodules": { "/Users/me/repos/repo1": "all" }`. If you want to override for all repo's, use `*` to set the mode instead of the repo path | | `ignore_submodules` | `map[string]string` | map of repo's where to change the [--ignore-submodules][submodules] flag (`none`, `untracked`, `dirty` or `all`). For example `"ignore_submodules": { "/Users/me/repos/repo1": "all" }`. If you want to override for all repo's, use `*` to set the mode instead of the repo path |
| `native_fallback` | `boolean` | when set to `true` and `git.exe` is not available when inside a WSL2 shared Windows drive, we will fallback to the native git executable to fetch data. Not all information can be displayed in this case. Defaults to `false` | | `native_fallback` | `boolean` | when set to `true` and `git.exe` is not available when inside a WSL2 shared Windows drive, we will fallback to the native git executable to fetch data. Not all information can be displayed in this case. Defaults to `false` |
| `fetch_user` | [`User`](#user) | fetch the current configured user for the repository - defaults to `false` | | `fetch_user` | [`User`](#user) | fetch the current configured user for the repository - defaults to `false` |
| `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](#status) section for available overrides. Defaults to an empty map. |
### Icons ### Icons
@ -130,29 +131,29 @@ You can set the following properties to `true` to enable fetching additional inf
### Properties ### Properties
| Name | Type | Description | | Name | Type | Description |
| ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------- | | ---------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `.RepoName` | `string` | the repo folder name | | `.RepoName` | `string` | the repo folder name |
| `.Working` | `GitStatus` | changes in the worktree (see below) | | `.Working` | `Status` | changes in the worktree (see below) |
| `.Staging` | `GitStatus` | staged changes in the work tree (see below) | | `.Staging` | `Status` | staged changes in the work tree (see below) |
| `.HEAD` | `string` | the current HEAD context (branch/rebase/merge/...) | | `.HEAD` | `string` | the current HEAD context (branch/rebase/merge/...) |
| `.Ref` | `string` | the current HEAD reference (branch/tag/...) | | `.Ref` | `string` | the current HEAD reference (branch/tag/...) |
| `.Behind` | `int` | commits behind of upstream | | `.Behind` | `int` | commits behind of upstream |
| `.Ahead` | `int` | commits ahead of upstream | | `.Ahead` | `int` | commits ahead of upstream |
| `.BranchStatus` | `string` | the current branch context (ahead/behind string representation) | | `.BranchStatus` | `string` | the current branch context (ahead/behind string representation) |
| `.Upstream` | `string` | the upstream name (remote) | | `.Upstream` | `string` | the upstream name (remote) |
| `.UpstreamGone` | `boolean` | whether the upstream is gone (no remote) | | `.UpstreamGone` | `boolean` | whether the upstream is gone (no remote) |
| `.UpstreamIcon` | `string` | the upstream icon (based on the icons above) | | `.UpstreamIcon` | `string` | the upstream icon (based on the icons above) |
| `.UpstreamURL` | `string` | the upstream URL for use in [hyperlinks][hyperlinks] in templates: `{{ url .UpstreamIcon .UpstreamURL }}` | | `.UpstreamURL` | `string` | the upstream URL for use in [hyperlinks][hyperlinks] in templates: `{{ url .UpstreamIcon .UpstreamURL }}` |
| `.StashCount` | `int` | the stash count | | `.StashCount` | `int` | the stash count |
| `.WorktreeCount` | `int` | the worktree count | | `.WorktreeCount` | `int` | the worktree count |
| `.IsWorkTree` | `boolean` | if in a worktree repo or not | | `.IsWorkTree` | `boolean` | if in a worktree repo or not |
| `.IsBare` | `boolean` | if in a bare repo or not, only set when `fetch_bare_info` is set to `true` | | `.IsBare` | `boolean` | if in a bare repo or not, only set when `fetch_bare_info` is set to `true` |
| `.Dir` | `string` | the repository's root directory | | `.Dir` | `string` | the repository's root directory |
| `.Kraken` | `string` | a link to the current HEAD in [GitKraken][kraken-ref] for use in [hyperlinks][hyperlinks] in templates `{{ url .HEAD .Kraken }}` | | `.Kraken` | `string` | a link to the current HEAD in [GitKraken][kraken-ref] for use in [hyperlinks][hyperlinks] in templates `{{ url .HEAD .Kraken }}` |
| `.Commit` | `Commit` | HEAD commit information (see below) | | `.Commit` | `Commit` | HEAD commit information (see below) |
### GitStatus ### Status
| Name | Type | Description | | Name | Type | Description |
| ------------ | --------- | -------------------------------------------- | | ------------ | --------- | -------------------------------------------- |
@ -164,6 +165,16 @@ You can set the following properties to `true` to enable fetching additional inf
| `.Changed` | `boolean` | if the status contains changes or not | | `.Changed` | `boolean` | if the status contains changes or not |
| `.String` | `string` | a string representation of the changes above | | `.String` | `string` | a string representation of the changes above |
Local changes use the following syntax:
| Icon | Description |
| ---- | ----------- |
| `x` | Unmerged |
| `-` | Deleted |
| `+` | Added |
| `~` | Modified |
| `?` | Untracked |
### Commit ### Commit
| Name | Type | Description | | Name | Type | Description |
@ -180,15 +191,6 @@ You can set the following properties to `true` to enable fetching additional inf
| `.Name` | `string` | the user's name | | `.Name` | `string` | the user's name |
| `.Email` | `string` | the user's email | | `.Email` | `string` | the user's email |
Local changes use the following syntax:
| Icon | Description |
| ---- | ----------- |
| `+` | added |
| `~` | modified |
| `-` | deleted |
| `?` | untracked |
[poshgit]: https://github.com/dahlbyk/posh-git [poshgit]: https://github.com/dahlbyk/posh-git
[templates]: /docs/configuration/templates [templates]: /docs/configuration/templates
[hyperlinks]: /docs/configuration/templates#custom [hyperlinks]: /docs/configuration/templates#custom

77
website/docs/segments/mercurial.mdx
View file

@ -11,18 +11,20 @@ make sure your `hg` executable is up-to-date (when branch or status information
## Sample Configuration ## Sample Configuration
import Config from '@site/src/components/Config.js'; import Config from "@site/src/components/Config.js";
<Config data={{ <Config
"type": "mercurial", data={{
"style": "powerline", type: "mercurial",
"powerline_symbol": "\uE0B0", style: "powerline",
"foreground": "#193549", powerline_symbol: "\uE0B0",
"background": "#ffeb3b", foreground: "#193549",
"properties": { background: "#ffeb3b",
"newprop": "\uEFF1" properties: {
} newprop: "\uEFF1",
}}/> },
}}
/>
## Properties ## Properties
@ -31,9 +33,10 @@ import Config from '@site/src/components/Config.js';
As doing Mercurial (hg) calls can slow down the prompt experience, we do not fetch information by default. 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). You can set the following properties to `true` to enable fetching additional information (and populate the template).
| Name | Type | Description | | Name | Type | Description |
| ----------------- | --------- | --------------------------------------------- | | ---------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fetch_status` | `boolean` | fetch the local changes - defaults to `false` | | `fetch_status` | `boolean` | fetch the local changes - defaults to `false` |
| `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](#status) section for available overrides. Defaults to an empty map. |
## Template ([info][templates]) ## Template ([info][templates])
@ -47,35 +50,35 @@ hg {{.Branch}} {{if .LocalCommitNumber}}({{.LocalCommitNumber}}:{{.ChangeSetIDSh
### Properties ### Properties
| Name | Type | Description | | Name | Type | Description |
| -------------------- | ----------------- | ----------------------------------------------------- | | ------------------- | ---------- | ----------------------------------------------------- |
| `.Working` | `MercurialStatus` | changes in the worktree (see below) | | `.Working` | `Status` | changes in the worktree (see below) |
| `.IsTip` | `boolean` | Current commit is the tip commit | | `.IsTip` | `boolean` | Current commit is the tip commit |
| `.ChangeSetID` | `string` | The current local commit number | | `.ChangeSetID` | `string` | The current local commit number |
| `.ChangeSetID` | `string` | The current local commit number | | `.ChangeSetID` | `string` | The current local commit number |
| `.ChangeSetIDShort` | `string` | The current local commit number | | `.ChangeSetIDShort` | `string` | The current local commit number |
| `.Branch` | `string` | current branch (releative URL reported by `svn info`) | | `.Branch` | `string` | current branch (releative URL reported by `svn info`) |
| `.Bookmarks` | `[]string` | the currently checked out revision number | | `.Bookmarks` | `[]string` | the currently checked out revision number |
| `.Tags` | `[]string` | the currently checked out revision number | | `.Tags` | `[]string` | the currently checked out revision number |
### SvnStatus ### Status
| Name | Type | Description | | Name | Type | Description |
| --------------- | --------- | ---------------------------------------------- | | ------------ | --------- | -------------------------------------------- |
| `.Untracked` | `int` | number of files not under version control | | `.Untracked` | `int` | number of files not under version control |
| `.Modified` | `int` | number of modified files | | `.Modified` | `int` | number of modified files |
| `.Deleted` | `int` | number of deleted files | | `.Deleted` | `int` | number of deleted files |
| `.Added` | `int` | number of added files | | `.Added` | `int` | number of added files |
| `.Changed` | `boolean` | if the status contains changes or not | | `.Changed` | `boolean` | if the status contains changes or not |
| `.String` | `string` | a string representation of the changes above | | `.String` | `string` | a string representation of the changes above |
Local changes use the following syntax: Local changes use the following syntax:
| Icon | Description | | Icon | Description |
| ---- | ----------- | | ---- | ----------- |
| `?` | untracked | | `?` | Untracked |
| `+` | added | | `~` | Modified |
| `-` | deleted | | `-` | Deleted |
| `~` | modified | | `+` | Added |
[templates]: /docs/config-templates [templates]: /docs/config-templates

72
website/docs/segments/plastic.mdx
View file

@ -12,27 +12,30 @@ For maximum compatibility, make sure your `cm` executable is up-to-date
## Sample Configuration ## Sample Configuration
import Config from '@site/src/components/Config.js'; import Config from "@site/src/components/Config.js";
<Config data={{ <Config
"type": "plastic", data={{
"style": "powerline", type: "plastic",
"powerline_symbol": "\uE0B0", style: "powerline",
"foreground": "#193549", powerline_symbol: "\uE0B0",
"background": "#ffeb3b", foreground: "#193549",
"background_templates": [ background: "#ffeb3b",
"{{ if .MergePending }}#006060{{ end }}", background_templates: [
"{{ if .Changed }}#FF9248{{ end }}", "{{ if .MergePending }}#006060{{ end }}",
"{{ if and .Changed .Behind }}#ff4500{{ end }}", "{{ if .Changed }}#FF9248{{ end }}",
"{{ if .Behind }}#B388FF{{ end }}" "{{ if and .Changed .Behind }}#ff4500{{ end }}",
], "{{ if .Behind }}#B388FF{{ end }}",
"template": "{{ .Selector }}{{ if .Status.Changed }} \uF044 {{ end }}{{ .Status.String }}", ],
"properties": { template:
"fetch_status": true, "{{ .Selector }}{{ if .Status.Changed }} \uF044 {{ end }}{{ .Status.String }}",
"branch_max_length": 25, properties: {
"truncate_symbol": "\u2026" fetch_status: true,
} branch_max_length: 25,
}}/> truncate_symbol: "\u2026",
},
}}
/>
## Plastic SCM Icon ## Plastic SCM Icon
@ -47,7 +50,10 @@ by leaving a like!
As doing multiple `cm` calls can slow down the prompt experience, we do not fetch information by default. As doing multiple `cm` calls can slow down the prompt experience, we do not fetch information by default.
You can set the following property to `true` to enable fetching additional information (and populate the template). You can set the following property to `true` to enable fetching additional information (and populate the template).
|`fetch_status`|`boolean`|fetch the local changes - defaults to `false`| | Name | Type | Description |
| ---------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fetch_status` | `boolean` | fetch the local changes - defaults to `false` |
| `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](#status) section for available overrides. Defaults to an empty map. |
### Icons ### Icons
@ -79,14 +85,14 @@ You can set the following property to `true` to enable fetching additional infor
### Properties ### Properties
| Name | Type | Description | | Name | Type | Description |
| --------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `.Selector` | `string` | the current selector context (branch/changeset/label) | | `.Selector` | `string` | the current selector context (branch/changeset/label) |
| `.Behind` | `bool` | the current workspace is behind and changes are incoming | | `.Behind` | `bool` | the current workspace is behind and changes are incoming |
| `.Status` | `PlasticStatus` | changes in the workspace (see below) | | `.Status` | `Status` | changes in the workspace (see below) |
| `.MergePending` | `bool` | if a merge is pending and needs to be commited (known issue: when no file is left after a _Change/Delete conflict_ merge, the `MergePending` property is not set) | | `.MergePending` | `bool` | if a merge is pending and needs to be commited (known issue: when no file is left after a _Change/Delete conflict_ merge, the `MergePending` property is not set) |
### PlasticStatus ### Status
| Name | Type | Description | | Name | Type | Description |
| ----------- | --------- | -------------------------------------------- | | ----------- | --------- | -------------------------------------------- |
@ -102,11 +108,11 @@ Local changes use the following syntax:
| Icon | Description | | Icon | Description |
| ---- | ----------- | | ---- | ----------- |
| `+` | added | | `x` | Unmerged |
| `~` | modified | | `-` | Deleted |
| `-` | deleted | | `+` | Added |
| `v` | moved | | `~` | Modified |
| `x` | unmerged | | `v` | Moved |
[templates]: /docs/configuration/templates [templates]: /docs/configuration/templates
[fa-issue]: https://github.com/FortAwesome/Font-Awesome/issues/18504 [fa-issue]: https://github.com/FortAwesome/Font-Awesome/issues/18504

49
website/docs/segments/sapling.mdx
View file

@ -30,10 +30,11 @@ import Config from "@site/src/components/Config.js";
### Fetching information ### Fetching information
| Name | Type | Description | | Name | Type | Description |
| ----------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ----------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fetch_status` | `boolean` | fetch the local changes - defaults to `true` | | `fetch_status` | `boolean` | fetch the local changes - defaults to `true` |
| `native_fallback` | `boolean` | when set to `true` and `sl.exe` is not available when inside a WSL2 shared Windows drive, we will fallback to the native sapling executable to fetch data. Not all information can be displayed in this case. Defaults to `false` | | `native_fallback` | `boolean` | when set to `true` and `sl.exe` is not available when inside a WSL2 shared Windows drive, we will fallback to the native sapling executable to fetch data. Not all information can be displayed in this case. Defaults to `false` |
| `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](#status) section for available overrides. Defaults to an empty map. |
## Template ([info][templates]) ## Template ([info][templates])
@ -47,20 +48,20 @@ import Config from "@site/src/components/Config.js";
### Properties ### Properties
| Name | Type | Description | | Name | Type | Description |
| -------------- | --------------- | ------------------------------------------ | | -------------- | --------- | ------------------------------------------ |
| `.RepoName` | `string` | the repo folder name | | `.RepoName` | `string` | the repo folder name |
| `.Working` | `SaplingStatus` | changes in the worktree (see below) | | `.Working` | `Status` | changes in the worktree (see below) |
| `.Description` | `string` | the first line of the commit's description | | `.Description` | `string` | the first line of the commit's description |
| `.Author` | `string` | the author of the commit | | `.Author` | `string` | the author of the commit |
| `.Hash` | `string` | the full hash of the commit | | `.Hash` | `string` | the full hash of the commit |
| `.ShortHash` | `string` | the short hash of the commit | | `.ShortHash` | `string` | the short hash of the commit |
| `.When` | `string` | the commit's relative time indication | | `.When` | `string` | the commit's relative time indication |
| `.Bookmark` | `string` | the commit's bookmark (if any) | | `.Bookmark` | `string` | the commit's bookmark (if any) |
| `.Dir` | `string` | the repository's root directory | | `.Dir` | `string` | the repository's root directory |
| `.New` | `boolean` | true when there are no commits in the repo | | `.New` | `boolean` | true when there are no commits in the repo |
### SaplingStatus ### Status
| Name | Type | Description | | Name | Type | Description |
| ------------ | --------- | -------------------------------------------- | | ------------ | --------- | -------------------------------------------- |
@ -77,13 +78,13 @@ Local changes use the following syntax:
| Icon | Description | | Icon | Description |
| ---- | ----------- | | ---- | ----------- |
| `+` | added | | `~` | Modified |
| `~` | modified | | `+` | Added |
| `-` | deleted | | `-` | Deleted |
| `?` | untracked | | `?` | Untracked |
| `=` | clean | | `=` | Clean |
| `!` | missing | | `!` | Missing |
| `Ø` | ignored | | `Ø` | Ignored |
[sapling]: https://sapling-scm.com/ [sapling]: https://sapling-scm.com/
[templates]: /docs/configuration/templates [templates]: /docs/configuration/templates

57
website/docs/segments/svn.mdx
View file

@ -11,18 +11,20 @@ make sure your `svn` executable is up-to-date (when branch or status information
## Sample Configuration ## Sample Configuration
import Config from '@site/src/components/Config.js'; import Config from "@site/src/components/Config.js";
<Config data={{ <Config
"type": "svn", data={{
"style": "powerline", type: "svn",
"powerline_symbol": "\uE0B0", style: "powerline",
"foreground": "#193549", powerline_symbol: "\uE0B0",
"background": "#ffeb3b", foreground: "#193549",
"properties": { background: "#ffeb3b",
"fetch_status": true properties: {
} fetch_status: true,
}}/> },
}}
/>
## Properties ## Properties
@ -31,10 +33,11 @@ import Config from '@site/src/components/Config.js';
As doing multiple [subversion][svn] calls can slow down the prompt experience, we do not fetch information by default. As doing multiple [subversion][svn] 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). You can set the following properties to `true` to enable fetching additional information (and populate the template).
| Name | Type | Description | | Name | Type | Description |
| ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ----------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fetch_status` | `boolean` | fetch the local changes - defaults to `false` | | `fetch_status` | `boolean` | fetch the local changes - defaults to `false` |
| `native_fallback` | `boolean` | when set to `true` and `svn.exe` is not available when inside a WSL2 shared Windows drive, we will fallback to the native svn executable to fetch data. Not all information can be displayed in this case. Defaults to `false`. | | `native_fallback` | `boolean` | when set to `true` and `svn.exe` is not available when inside a WSL2 shared Windows drive, we will fallback to the native svn executable to fetch data. Not all information can be displayed in this case. Defaults to `false`. |
| `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](#status) section for available overrides. Defaults to an empty map. |
## Template ([info][templates]) ## Template ([info][templates])
@ -48,13 +51,13 @@ You can set the following properties to `true` to enable fetching additional inf
### Properties ### Properties
| Name | Type | Description | | Name | Type | Description |
| ---------- | ----------- | ----------------------------------------------------- | | ---------- | -------- | ----------------------------------------------------- |
| `.Working` | `SvnStatus` | changes in the worktree (see below) | | `.Working` | `Status` | changes in the worktree (see below) |
| `.Branch` | `string` | current branch (releative URL reported by `svn info`) | | `.Branch` | `string` | current branch (releative URL reported by `svn info`) |
| `.BaseRev` | `int` | the currently checked out revision number | | `.BaseRev` | `int` | the currently checked out revision number |
### SvnStatus ### Status
| Name | Type | Description | | Name | Type | Description |
| --------------- | --------- | ---------------------------------------------- | | --------------- | --------- | ---------------------------------------------- |
@ -72,12 +75,12 @@ Local changes use the following syntax:
| Icon | Description | | Icon | Description |
| ---- | ----------- | | ---- | ----------- |
| `?` | untracked | | `?` | Untracked |
| `+` | added | | `~` | Modified |
| `!` | conflicted | | `-` | Deleted |
| `-` | deleted | | `+` | Added |
| `~` | modified | | `>` | Moved |
| `>` | moved | | `!` | Conflicted |
[svn]: https://subversion.apache.org [svn]: https://subversion.apache.org
[templates]: /docs/config-templates [templates]: /docs/config-templates