mirror of
https://github.com/JanDeDobbeleer/oh-my-posh.git
synced 2024-12-27 11:59:40 -08:00
119 lines
6.2 KiB
Plaintext
119 lines
6.2 KiB
Plaintext
---
|
|
id: plastic
|
|
title: Plastic SCM
|
|
sidebar_label: Plastic SCM
|
|
---
|
|
|
|
## What
|
|
|
|
Display Plastic SCM information when in a plastic repository. Also works for subfolders.
|
|
For maximum compatibility, make sure your `cm` executable is up-to-date
|
|
(when branch or status information is incorrect for example).
|
|
|
|
## Sample Configuration
|
|
|
|
import Config from "@site/src/components/Config.js";
|
|
|
|
<Config
|
|
data={{
|
|
type: "plastic",
|
|
style: "powerline",
|
|
powerline_symbol: "\uE0B0",
|
|
foreground: "#193549",
|
|
background: "#ffeb3b",
|
|
background_templates: [
|
|
"{{ if .MergePending }}#006060{{ end }}",
|
|
"{{ if .Changed }}#FF9248{{ end }}",
|
|
"{{ if and .Changed .Behind }}#ff4500{{ end }}",
|
|
"{{ if .Behind }}#B388FF{{ end }}",
|
|
],
|
|
template:
|
|
"{{ .Selector }}{{ if .Status.Changed }} \uF044 {{ end }}{{ .Status.String }}",
|
|
properties: {
|
|
fetch_status: true,
|
|
branch_max_length: 25,
|
|
truncate_symbol: "\u2026",
|
|
},
|
|
}}
|
|
/>
|
|
|
|
## Plastic SCM Icon
|
|
|
|
If you want to use the icon of Plastic SCM in the segment, then please help me push the icon in this [issue][fa-issue]
|
|
by leaving a like!
|
|
|
|
|
|
## Properties
|
|
|
|
### Fetching information
|
|
|
|
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).
|
|
|
|
| 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
|
|
|
|
#### Branch
|
|
|
|
| Name | Type | Description |
|
|
| ------------------- | -------- | -------------------------------------------------------------------------------------------- |
|
|
| `branch_icon` | `string` | the icon to use in front of the git branch name - defaults to `\uE0A0 ` |
|
|
| `full_branch_path` | `bool` | display the full branch path: `_/main/fix-001_` instead of `_fix-001_` - defaults to `true` |
|
|
| `branch_max_length` | `int` | the max length for the displayed branch name where `0` implies full length - defaults to `0` |
|
|
| `truncate_symbol` | `string` | the icon to display when a branch name is truncated - defaults to empty |
|
|
|
|
#### Selector
|
|
|
|
| Name | Type | Description |
|
|
| ------------- | -------- | ------------------------------------------------------------------------------------- |
|
|
| `commit_icon` | `string` | icon/text to display before the commit context (detached HEAD) - defaults to `\uF417` |
|
|
| `tag_icon` | `string` | icon/text to display before the tag context - defaults to `\uF412` |
|
|
|
|
## Template ([info][templates])
|
|
|
|
:::note default template
|
|
|
|
```template
|
|
{{ .Selector }}
|
|
```
|
|
|
|
:::
|
|
|
|
### Properties
|
|
|
|
| Name | Type | Description |
|
|
| --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `.Selector` | `string` | the current selector context (branch/changeset/label) |
|
|
| `.Behind` | `bool` | the current workspace is behind and changes are incoming |
|
|
| `.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) |
|
|
|
|
### Status
|
|
|
|
| Name | Type | Description |
|
|
| ----------- | --------- | -------------------------------------------- |
|
|
| `.Unmerged` | `int` | number of unmerged changes |
|
|
| `.Deleted` | `int` | number of deleted changes |
|
|
| `.Added` | `int` | number of added changes |
|
|
| `.Modified` | `int` | number of modified changes |
|
|
| `.Moved` | `int` | number of moved changes |
|
|
| `.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 |
|
|
| ---- | ----------- |
|
|
| `x` | Unmerged |
|
|
| `-` | Deleted |
|
|
| `+` | Added |
|
|
| `~` | Modified |
|
|
| `v` | Moved |
|
|
|
|
[templates]: /docs/configuration/templates
|
|
[fa-issue]: https://github.com/FortAwesome/Font-Awesome/issues/18504
|