linux/ohmyzsh
1
0
Fork 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2024-11-26 21:51:05 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs(scw): fix and reindent README file correctly

Browse source
This commit is contained in:
Albin Kauffmann 2023-07-05 11:30:27 +02:00
parent 96d7c9fd57
commit 10621789af
1 changed files with 26 additions and 30 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

42
plugins/scw/README.md
View file

@ -1,15 +1,14 @@
# SCW # SCW
This plugin adds functions to manage your Scaleway profile This plugin adds functions to easily manage your Scaleway profiles with the
`scw` command.
## Prerequisites ## Prerequisites
Scaleway CLI (scw) should be installed. You can install it from https://github.com/scaleway/scaleway-cli. Scaleway CLI (scw) should be installed. You can install it from
https://github.com/scaleway/scaleway-cli.
Copy and paste the code into your Zsh shell configuration file (e.g., .zshrc).
Source the updated configuration file or restart your shell.
Copy and paste the code into your Oh My Zsh configuration file (e.g., .zshrc):
```bash ```bash
plugins=(... scw) plugins=(... scw)
@ -18,33 +17,30 @@ plugins=(... scw)
## Functions ## Functions
| Commands | Description | | Commands | Description |
| :---------------: |:---------------| | :---------------: |:-------------------------------------------------------- |
| scw_upgrade | Update your Scaleway CLI version if needed. | | scw_upgrade | Update your Scaleway CLI version if needed. |
| sgp | Displays the current Scaleway profile. | | sgp | Displays the current Scaleway profile. |
| ssp <profilename> | Sets the Scaleway profile. If no profile name is provided, fallback to the curent active profile set in your | ssp <profilename> | Sets the Scaleway profile. If no profile name is provided, fallback to the curent active profile set in your configuration file. |
configuration file. |
| scw_profiles | Displays a list of available Scaleway profiles. | | scw_profiles | Displays a list of available Scaleway profiles. |
| scw_config_path | Returns the path to the Scaleway CLI configuration file (config.yaml). | | scw_config_path | Returns the path to the Scaleway CLI configuration file (config.yaml). |
In addition to setting the `SCW_PROFILE` environment variable, `ssp` also sets the following variables: `SCW_DEFAULT_ORGANIZATION_ID`, In addition to setting the `SCW_PROFILE` environment variable, `ssp` also sets
`SCW_DEFAULT_PROJECT_ID`, `SCW_DEFAULT_REGION`, `SCW_DEFAULT_ZONE`, `SCW_API_URL`. the following variables: `SCW_DEFAULT_ORGANIZATION_ID`,
Additionnally, if `SCW_EXPORT_TOKENS` is set to "true", `SCW_ACCESS_KEY` and `SCW_SECRET_KEY` are also exported. `SCW_DEFAULT_PROJECT_ID`, `SCW_DEFAULT_REGION`, `SCW_DEFAULT_ZONE`,
`SCW_API_URL`.
Additionnally, if `SCW_EXPORT_TOKENS` is set to "true", `SCW_ACCESS_KEY` and
`SCW_SECRET_KEY` are also exported.
## Customizations ## Customizations
| Commands | Description | | Env variables | Description |
| :---------------: |:---------------| | :--------------------------: |:--------------------------------------------- |
| SHOW_SCW_PROMPT | Controls whether to display the Scaleway profile information in the shell prompt. Set this variable to false if you don't | SHOW_SCW_PROMPT | Controls whether to display the Scaleway profile information in the shell prompt. Set this variable to false if you don't want to show the profile information. |
want to show the profile information. |
| ZSH_THEME_SCW_PROFILE_PREFIX | sets the prompt prefix. Defaults to `<scw:` | | ZSH_THEME_SCW_PROFILE_PREFIX | sets the prompt prefix. Defaults to `<scw:` |
| ZSH_THEME_SCW_PROFILE_SUFFIX | Set the prompt suffix. Default to `>` | | ZSH_THEME_SCW_PROFILE_SUFFIX | Set the prompt suffix. Default to `>` |
## Scaleway CLI Autocompletion ## Scaleway CLI Autocompletion
If Scaleway CLI autocompletion is not already loaded, the code automatically loads the autocompletion script for the scw command. This enables If Scaleway CLI autocompletion is not already loaded, the code automatically
autocompletion for all Scaleway CLI commands. loads the autocompletion script for the scw command. This enables autocompletion
for all Scaleway CLI commands.