oh-my-posh/website/docs/segments/svn.mdx

85 lines
3.6 KiB
Plaintext
Raw Normal View History

2022-03-30 15:33:15 -07:00
---
id: svn
2022-06-05 07:33:13 -07:00
title: Subversion
sidebar_label: Subversion
2022-03-30 15:33:15 -07:00
---
## What
2022-06-05 07:33:13 -07:00
Display subversion information when in a subversion repository. Also works for subfolders. For maximum compatibility,
2022-03-30 15:33:15 -07:00
make sure your `svn` executable is up-to-date (when branch or status information is incorrect for example).
## Sample Configuration
```json
{
"type": "svn",
"style": "powerline",
"powerline_symbol": "\uE0B0",
"foreground": "#193549",
"background": "#ffeb3b",
"properties": {
2022-06-05 07:33:13 -07:00
"fetch_status": true
2022-03-30 15:33:15 -07:00
}
}
```
## Properties
### Fetching information
2022-06-05 07:33:13 -07:00
As doing multiple [subversion][svn] calls can slow down the prompt experience, we do not fetch information by default.
2022-03-30 15:33:15 -07:00
You can set the following properties to `true` to enable fetching additional information (and populate the template).
| Name | Type | Description |
| ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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`. |
2022-03-30 15:33:15 -07:00
## Template ([info][templates])
:::note default template
```template
2022-03-30 15:33:15 -07:00
\ue0a0{{.Branch}} r{{.BaseRev}} {{.Working.String}}
```
:::
### Properties
| Name | Type | Description |
| ---------- | ----------- | ----------------------------------------------------- |
| `.Working` | `SvnStatus` | changes in the worktree (see below) |
| `.Branch` | `string` | current branch (releative URL reported by `svn info`) |
| `.BaseRev` | `int` | the currently checked out revision number |
2022-03-30 15:33:15 -07:00
### SvnStatus
| Name | Type | Description |
| --------------- | --------- | ---------------------------------------------- |
2022-12-25 11:21:23 -08:00
| `.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 |
| `.Moved` | `int` | number of changed moved files |
| `.Conflicted` | `int` | number of changed tracked files with conflicts |
| `.Changed` | `boolean` | if the status contains changes or not |
| `.HasConflicts` | `boolean` | if the status contains conflicts or not |
| `.String` | `string` | a string representation of the changes above |
Local changes use the following syntax:
| Icon | Description |
| ---- | ----------- |
2022-12-25 11:21:23 -08:00
| `?` | untracked |
| `+` | added |
| `!` | conflicted |
| `-` | deleted |
| `~` | modified |
| `>` | moved |
2022-03-30 15:33:15 -07:00
2022-06-05 07:33:13 -07:00
[svn]: https://subversion.apache.org
2022-03-30 15:33:15 -07:00
[templates]: /docs/config-templates
[hyperlinks]: /docs/config-templates#helper-functions