diff options
author | Roger Gonzalez <rogergonzalez21@gmail.com> | 2019-12-29 14:58:33 -0300 |
---|---|---|
committer | Roger Gonzalez <rogergonzalez21@gmail.com> | 2019-12-29 14:58:33 -0300 |
commit | efb336a23b65a9a2d56889396b13c1757bdaf354 (patch) | |
tree | 234e40115f79a84c8a755df6fb932cc6797e36e1 /.config/fisher/github.com/matchai/spacefish/docs |
Initial commit
Diffstat (limited to '.config/fisher/github.com/matchai/spacefish/docs')
4 files changed, 727 insertions, 0 deletions
diff --git a/.config/fisher/github.com/matchai/spacefish/docs/API.md b/.config/fisher/github.com/matchai/spacefish/docs/API.md new file mode 100644 index 00000000..a0db51a9 --- /dev/null +++ b/.config/fisher/github.com/matchai/spacefish/docs/API.md @@ -0,0 +1,162 @@ +# API + +This page describes the Spacefish API for creating plugins and tweaking Spacefish's behavior. + +Spacefish uses the `SPACEFISH_` prefix for variables and the `__sf_` prefix for functions to avoid namespace collisions. All sections, including custom ones, are required to use the `__sf_` prefix before their name to load correctly. + +## Example section + +Below is an example of a typical section for Spacefish. Pay attention to a few critical aspects: + +* Variables used for configuration should start with `SPACEFISH_`. +* The section's name should start with `__sf_`. +* Only show the section as is needed (only in directories containing specific files, when a specific command is available, etc). + +Take a look at [Contribution guidelines](../CONTRIBUTING.md) for further details. + +```sh +# +# Foobar +# +# Foobar is a supa-dupa cool tool for making you development easier. +# Link: https://www.foobar.xyz + +# __sf_ prefix before section's name is required! +# Otherwise this section won't be loaded. +function __sf_section_foobar -d "Show foobar status" + # ------------------------------------------------------------------------------ + # Configuration + # ------------------------------------------------------------------------------ + + __sf_util_set_default SPACEFISH_FOOBAR_SHOW true + __sf_util_set_default SPACEFISH_FOOBAR_PREFIX $SPACEFISH_PROMPT_DEFAULT_PREFIX + __sf_util_set_default SPACEFISH_FOOBAR_SUFFIX $SPACEFISH_PROMPT_DEFAULT_SUFFIX + __sf_util_set_default SPACEFISH_FOOBAR_SYMBOL "🍷 " + __sf_util_set_default SPACEFISH_FOOBAR_COLOR white + + # ------------------------------------------------------------------------------ + # Section + # ------------------------------------------------------------------------------ + + # If SPACEFISH_FOOBAR_SHOW is false, don't show the foobar section + [ $SPACEFISH_FOOBAR_SHOW = false ]; and return + + # If the foobar command doesn't exist, don't show the foobar section + type -q foobar; or return + + # Here some of the various expressions that can be tested + # The full list can be found here: + # https://fishshell.com/docs/current/commands.html#test + type -q command # test that a command exists + test -e /path/to/file # test that a file exists + test -d /path/to/dir # test that a directory exists + test operand1 = operand2 # that for two equal strings + test -n "$variable" # test that a variable exists + + # Use `set -l` to define local variables to avoid populating + # the global namespace + set -l foobar_status + + if test "$SOME_CONDITION" = "true" + set foobar_status (foobar baz) + else + set foobar_status (foobar foo) + end + + # Display the foobar section + __sf_lib_section \ + $SPACEFISH_FOOBAR_COLOR \ + $SPACEFISH_FOOBAR_PREFIX \ + $SPACEFISH_FOOBAR_SYMBOL \ + $SPACEFISH_FOOBAR_SUFFIX +end +``` + +## `SPACEFISH_VERSION` + +An environment variable that defines the version of currently running Spacefish prompt. Can be used for issue reporting or debugging purposes. + +Accessible to any program or script running in a current shell session. + +### Example + +```sh +echo $SPACEFISH_VERSION +#> 0.1.0 +``` + +## `__sf_lib_section <color> [prefix] <content> [suffix]` + +This function prints out the prompt section prefixed with `prefix`, suffixed with `suffix` and `content` formatted to display in `color`. The **Bold** style is applied by default. + +`prefix`, `suffix` and `content` can contain `set_color` to set an additional foreground color, background color or other formatting styles. Read more about `set_color` in the [set_color - set the terminal color](https://fishshell.com/docs/current/commands.html#set_color) section of the Fish Shell documentation. + +If `SPACEFISH_PROMPT_PREFIXES_SHOW` is `false` or if the section is the first to appear in the prompt, then `prefix` will be omitted. + +If `SPACEFISH_PROMPT_SUFFIXES_SHOW` is `false`, then `suffix` will be omitted. + +Both `prefix` and `suffix` are optional. They are equal to empty strings by default. + +### Arguments + +1. `color` _Required_ — The color used when displaying the `content`. Can be any of the valid [basic colors](https://fishshell.com/docs/current/commands.html#set_color) or can be any valid RGB hex code. +2. `prefix` _Optional_ — The prefix shown before `content`. Usually, it's the value of `SPACEFISH_*_PREFIX`. +3. `content` _Required_ — The content of the section. Can be any valid value or the result of command execution. +4. `suffix` _Optional_ — The suffix shown after `content`. Usually, it's the value of `SPACEFISH_*_SUFFIX`. + +### Example + +```sh +# Display the prompt section with a prefix and suffix +# Backslash is used to escape the line endings +__sf_lib_section \ +$SPACEFISH_SECTION_COLOR \ +$SPACEFISH_SECTION_PREFIX \ +$SPACEFISH_SECTION_SYMBOL$section_content \ +$SPACEFISH_SECTION_SUFFIX + +# Display prompt section without prefix and suffix +__sf_lib_section $color $SPACEFISH_CHAR_SYMBOL +``` + +## `__sf_util_set_default <variable_name> <value>` + +This utility function is used to define a default value for a variable while allowing it to be overwritten by a user's personal configuration files (e.g. setting it in their `config.fish`) + +### Arguments + +1. `variable_name` _Required_ — the name of the configuration variable. +2. `value` _Required_ — the value to be assigned by default. + +### Example + +```sh +# Preassign a value to `SPACEFISH_CHAR_SYMBOL` +set -g SPACEFISH_CHAR_SYMBOL ❯ + +# Assign a value if one doesn't already exist +__sf_util_set_default SPACEFISH_CHAR_SYMBOL ■ +__sf_util_set_default SPACEFISH_RUBY_SYMBOL 💎 + +# The original value assigned is used +echo $SPACEFISH_CHAR_SYMBOL +#> ❯ + +echo $SPACEFISH_RUBY_SYMBOL +#> 💎 +``` + +## `__sf_util_git_branch` + +This utility returns the current branch name if the current working directory is a Git repository, and will return nothing if it's not. + +### Example + +```sh +# Return if the current working directory is not a Git repository +[ -z (__sf_util_git_branch) ]; and return + +# Print the Git branch name of the current working directory +echo (__sf_util_git_branch) +#> master +``` diff --git a/.config/fisher/github.com/matchai/spacefish/docs/Options.md b/.config/fisher/github.com/matchai/spacefish/docs/Options.md new file mode 100644 index 00000000..6a85fc77 --- /dev/null +++ b/.config/fisher/github.com/matchai/spacefish/docs/Options.md @@ -0,0 +1,438 @@ +## Options + +You have ability to customize or disable specific elements of Spacefish. All options must be overridden in your `config.fish`. + +Colors for sections can be [basic colors](https://fishshell.com/docs/current/commands.html#set_color) or [color codes](https://upload.wikimedia.org/wikipedia/commons/1/15/Xterm_256color_chart.svg). + +**Note:** the symbol `·` in this document represents a regular space character ` `, it is used to clearly indicate when an option default value starts or ends with a space. + +### Order + +You can specify the order of prompt section using `SPACEFISH_PROMPT_ORDER` option. Use Zsh array syntax to define your own prompt order. + +The order also defines which sections that Spacefish loads. If you're struggling with slow prompt, you can just omit the sections that you don't use, and they won't be loaded. + +The default order is: + +```fish + set SPACEFISH_PROMPT_ORDER time user dir host git package node docker ruby golang php rust haskell julia aws conda pyenv kubecontext exec_time line_sep battery jobs exit_code char +``` +You can also add items to the right prompt by specifying them in the `SPACEFISH_RPROMPT_ORDER` option. By default `SPACEFISH_RPROMPT_ORDER` is empty. + +### Prompt + +This group of options defines a behavior of prompt and standard parameters for sections displaying. + +| Variable | Default | Meaning | +| :--- | :---: | --- | +| `SPACEFISH_PROMPT_ADD_NEWLINE` | `true` | Adds a newline character before each prompt line | +| `SPACEFISH_PROMPT_SEPARATE_LINE` | `true` | Make the prompt span across two lines | +| `SPACEFISH_PROMPT_FIRST_PREFIX_SHOW` | `false` | Shows a prefix of the first section in prompt | +| `SPACEFISH_PROMPT_PREFIXES_SHOW` | `true` | Show prefixes before prompt sections | +| `SPACEFISH_PROMPT_SUFFIXES_SHOW` | `true` | Show suffixes before prompt sections | +| `SPACEFISH_PROMPT_DEFAULT_PREFIX` | `via` | Default prefix for prompt sections | +| `SPACEFISH_PROMPT_DEFAULT_SUFFIX` | ` ` | Default suffix for prompt section | + +### Time \(`time`\) + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_TIME_SHOW` | `false` | Show current time | +| `SPACEFISH_DATE_SHOW` | `false·` | Show today's date | +| `SPACEFISH_TIME_PREFIX` | `at·` | Prefix before time section | +| `SPACEFISH_TIME_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after time section | +| `SPACEFISH_TIME_FORMAT` | `false` | Custom time/date formatting, set as a string to enable (`man date` for help) | +| `SPACEFISH_TIME_12HR` | `false` | Use 12 hour clock AM/PM | +| `SPACEFISH_TIME_COLOR` | `yellow` | Color of time section | + +### Username \(`user`\) + +By default, a username is shown only when it's not the same as `$LOGNAME`, when you're connected via SSH or when you're root. Root user is highlighted in `SPACEFISH_USER_COLOR_ROOT` color (red as default). + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_USER_SHOW` | `true` | Show user section (`true`, `false`, `always` or `needed`) | +| `SPACEFISH_USER_PREFIX` | `with·` | Prefix before user section | +| `SPACEFISH_USER_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after user section | +| `SPACEFISH_USER_COLOR` | `yellow` | Color of user section | +| `SPACEFISH_USER_COLOR_ROOT` | `red` | Color of user section when it's root | + +`SPACEFISH_USER_SHOW` defines when to show username section. Here are possible values: + +| `SPACEFISH_USER_SHOW` | Show on local | Show on remote | +| :-------------------: | :------------- | :-------------- | +| `false` | Never | Never | +| `always` | Always | Always | +| `true` | If needed | Always | +| `needed` | If needed | If needed | + + +### Directory \(`dir`\) + +Directory is always shown and truncated to the value of `SPACEFISH_DIR_TRUNC`. While you are in a Git repository, this section shows only the project title and relevant status icons. If current directory is write-protected or if current user doesn't have write permissions, a padlock (by default) will be displayed as a suffix. + +| Variable | Default | Meaning | +| :--- | :---: | --- | +| `SPACEFISH_DIR_SHOW` | `true` | Show directory section | +| `SPACEFISH_DIR_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after current directory | +| `SPACEFISH_DIR_TRUNC` | `3` | Number of folders of cwd to show in prompt, 0 to show all | +| `SPACEFISH_DIR_TRUNC_REPO` | `true` | While in `git` repo, show only root directory and folders inside it | +| `SPACEFISH_DIR_COLOR` | `cyan` | Color of directory section | +| `SPACEFISH_DIR_PREFIX` | `in·` | Prefix before current directory | +| `SPACEFISH_DIR_LOCK_SHOW` | `true` | Show directory write-protected symbol | +| `SPACEFISH_DIR_LOCK_SYMBOL` | ![·🔒](https://user-images.githubusercontent.com/11844760/47611530-7bf99c00-da8d-11e8-95da-f4ec1f23203a.png) | The symbol displayed if directory is write-protected (requires powerline patched font) | +| `SPACEFISH_DIR_LOCK_COLOR` | `red` | Color for the lock symbol | + +### Hostname \(`host`\) + +Hostname should only be shown while you are connected to another machine using SSH, unless you change it using SPACEFISH_HOST_SHOW. + +| Variable | Default | Meaning | +| :--- | :---: | --- | +| `SPACEFISH_HOST_SHOW` | `true` | Show host section (`true`, `false`, `always`) | +| `SPACEFISH_HOST_SHOW_FULL` | `false` | Show full hostname section (`true`, `false`) | +| `SPACEFISH_HOST_PREFIX` | `at·` | Prefix before the hostname | +| `SPACEFISH_HOST_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the hostname | +| `SPACEFISH_HOST_COLOR` | `blue` | Color of the hostname | +| `SPACEFISH_HOST_COLOR_SSH` | `green` | Color of the hostname during SSH | + +### Git \(`git`\) + +Git section is consists with `git_branch` and `git_status` subsections. It is shown only in Git repositories. + +| Variable | Default | Meaning | +| :--- | :---: | --- | +| `SPACEFISH_GIT_SHOW` | `true` | Show Git section | +| `SPACEFISH_GIT_PREFIX` | `on·` | Prefix before Git section | +| `SPACEFISH_GIT_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after Git section | +| `SPACEFISH_GIT_SYMBOL` | ![·](https://user-images.githubusercontent.com/3459374/34947621-4f324a92-fa13-11e7-9b99-cdba2cdda6b9.png) | Character to be shown before Git section \(requires [powerline patched font](https://github.com/powerline/fonts) | + +#### Git branch \(`git_branch`\) + +| Variable | Default | Meaning | +| :--- | :---: | --- | +| `SPACEFISH_GIT_BRANCH_SHOW` | `true` | Show Git branch subsection | +| `SPACEFISH_GIT_BRANCH_PREFIX` | `$SPACEFISH_GIT_SYMBOL` | Prefix before Git branch subsection | +| `SPACEFISH_GIT_BRANCH_SUFFIX` | ` ` | Suffix after Git branch subsection | +| `SPACEFISH_GIT_BRANCH_COLOR` | `(set_color magenta)` | Color of Git branch subsection | + +#### Git status \(`git_status`\) + +Git status indicators is shown only when you have dirty repository. + +| Variable | Default | Meaning | +| :--- | :---: | --- | +| `SPACEFISH_GIT_STATUS_SHOW` | `true` | Show Git status subsection | +| `SPACEFISH_GIT_STATUS_PREFIX` | `·[` | Prefix before Git status subsection | +| `SPACEFISH_GIT_STATUS_SUFFIX` | `]` | Suffix after Git status subsection | +| `SPACEFISH_GIT_STATUS_COLOR` | `red` | Color of Git status subsection | +| `SPACEFISH_GIT_STATUS_UNTRACKED` | `?` | Indicator for untracked changes | +| `SPACEFISH_GIT_STATUS_ADDED` | `+` | Indicator for added changes | +| `SPACEFISH_GIT_STATUS_MODIFIED` | `!` | Indicator for unstaged files | +| `SPACEFISH_GIT_STATUS_RENAMED` | `»` | Indicator for renamed files | +| `SPACEFISH_GIT_STATUS_DELETED` | `✘` | Indicator for deleted files | +| `SPACEFISH_GIT_STATUS_STASHED` | `$` | Indicator for stashed changes | +| `SPACEFISH_GIT_STATUS_UNMERGED` | `=` | Indicator for unmerged changes | +| `SPACEFISH_GIT_STATUS_AHEAD` | `⇡` | Indicator for unpushed changes \(ahead of remote branch\) | +| `SPACEFISH_GIT_STATUS_BEHIND` | `⇣` | Indicator for unpulled changes \(behind of remote branch\) | +| `SPACEFISH_GIT_STATUS_DIVERGED` | `⇕` | Indicator for diverged chages \(diverged with remote branch\) | + +### Package version \(`package`\) + +> Works only for [npm](https://www.npmjs.com/) and [cargo](https://crates.io/) at the moment. Please, help [spaceship](https://github.com/denysdovhan/spaceship-prompt) improve this section! + +Package version is shown when repository is a package (e.g. contains a `package.json` or `Cargo.toml` file). If no version information is found in `package.json` or there is an error parsing `Cargo.toml`, the `⚠` symbol will be shown. + +* **npm** — `npm` package contains a `package.json` file. We use `jq`, `python` to parse package version for improving performance and `node` as a fallback. Install [jq](https://stedolan.github.io/jq/) for **improved performance** of this section ([Why?](./Troubleshooting.md#why-is-my-prompt-slow)) +* **cargo** — `cargo` package contains a `Cargo.toml` file. Currently, we use `cargo pkgid`, it depends on `Cargo.lock`. So if package version isn't shown, you may need to run some command like `cargo build` which can generate `Cargo.lock` file. + +> **Note:** This is the version of the package you are working on, not the version of package manager itself. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_PACKAGE_SHOW` | `true` | Show package version | +| `SPACEFISH_PACKAGE_PREFIX` | `is·` | Prefix before package version section | +| `SPACEFISH_PACKAGE_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after package version section | +| `SPACEFISH_PACKAGE_SYMBOL` | `📦·` | Character to be shown before package version | +| `SPACEFISH_PACKAGE_COLOR` | `red` | Color of package version section | + +### Node.js \(`node`\) + +Node.js section is shown only in directories that contain `package.json` file, or `node_modules` folder, or any other file with `.js` extension. + +If you set `SPACEFISH_NODE_DEFAULT_VERSION` to the default Node.js version and your current version is the same as `SPACEFISH_NODE_DEFAULT_VERSION`, then Node.js section will be hidden. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_NODE_SHOW` | `true` | Current Node.js section | +| `SPACEFISH_NODE_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before Node.js section | +| `SPACEFISH_NODE_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after Node.js section | +| `SPACEFISH_NODE_SYMBOL` | `⬢·` | Character to be shown before Node.js version | +| `SPACEFISH_NODE_DEFAULT_VERSION` | ` ` | Node.js version to be treated as default | +| `SPACEFISH_NODE_COLOR` | `green` | Color of Node.js section | + +### Julia \(`julia`\) + +Julia section is shown only in directories that contain any file with `.jl` extension. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_JULIA_SHOW` | `true` | Show Julia section | +| `SPACEFISH_JULIA_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before Julia section | +| `SPACEFISH_JULIA_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after Julia section | +| `SPACEFISH_JULIA_SYMBOL` | `ஃ·` | Character to be shown before Julia version | +| `SPACEFISH_JULIA_COLOR` | `green` | Color of Julia section | + +### Docker (`docker`) + +Docker section is shown only in directories that contain `Dockerfile` or `docker-compose.yml` and also if the `$COMPOSE_FILE` is set. +The section will also appear when `.dockerenv` is in the root directory, signifying that you're in a container. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_DOCKER_SHOW` | `true` | Show current Docker version | +| `SPACEFISH_DOCKER_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before the Docker section | +| `SPACEFISH_DOCKER_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the Docker section | +| `SPACEFISH_DOCKER_SYMBOL` | `🐳·` | Character to be shown before Docker version | +| `SPACEFISH_DOCKER_COLOR` | `cyan` | Color of Docker section | +| `SPACEFISH_DOCKER_VERBOSE_VERSION` | `false` | Show full version name. (Beta, Nightly) | + +### Ruby \(`ruby`\) + +Ruby section is shown only in directories that contain `Gemfile`, or `Rakefile`, or any other file with `.rb` extension. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_RUBY_SHOW` | `true` | Show Ruby section | +| `SPACEFISH_RUBY_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before Ruby section | +| `SPACEFISH_RUBY_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after Ruby section | +| `SPACEFISH_RUBY_SYMBOL` | `💎·` | Character to be shown before Ruby version | +| `SPACEFISH_RUBY_COLOR` | `red` | Color of Ruby section | + +### Haskell \(`haskell`\) + +Haskell section is shown only in directories that contain `stack.yaml`. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_HASKELL_SHOW` | `true` | Show Haskell section | +| `SPACEFISH_HASKELL_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before Haskell section | +| `SPACEFISH_HASKELL_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after Haskell section | +| `SPACEFISH_HASKELL_SYMBOL` | `λ·` | Character to be shown before Haskell version | +| `SPACEFISH_HASKELL_COLOR` | `red` | Color of Haskell section | + +### Amazon Web Services (AWS) (`aws`) + +Shows selected Amazon Web Services profile configured using [`AWS_PROFILE`](http://docs.aws.amazon.com/cli/latest/userguide/cli-multiple-profiles.html) variable. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_AWS_SHOW` | `true` | Show current selected AWS-cli profile or not | +| `SPACEFISH_AWS_PREFIX` | `using·` | Prefix before the AWS section | +| `SPACEFISH_AWS_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the AWS section | +| `SPACEFISH_AWS_SYMBOL` | `☁️·` | Character to be shown before AWS profile | +| `SPACEFISH_AWS_COLOR` | `ff8700` | Color of AWS section | + +### Virtualenv (`venv`) + +Python virtual environment when $VIRTUAL_ENV is set. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_VENV_SHOW` | `true` | Show current Python virtualenv or not | +| `SPACEFISH_VENV_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before the virtualenv section | +| `SPACEFISH_VENV_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the virtualenv section | +| `SPACEFISH_VENV_SYMBOL` | `·` | Character to be shown before virtualenv | +| `SPACEFISH_VENV_GENERIC_NAMES` | `virtualenv venv .venv` | If the virtualenv folder is in this *array*, than use its parent directory as its name instead | +| `SPACEFISH_VENV_COLOR` | `blue` | Color of virtualenv environment section | + + +### Conda \(`conda`\) + +Conda section is shown when ```conda``` is installed and $CONDA_DEFAULT_ENV is set. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_CONDA_SHOW` | `true` | Show current Conda version | +| `SPACEFISH_CONDA_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before the conda section | +| `SPACEFISH_CONDA_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the conda section | +| `SPACEFISH_CONDA_SYMBOL` | `🅒·` | Character to be shown before Conda version | +| `SPACEFISH_CONDA_COLOR` | `blue` | Color of Conda section | + + +### Elixir \(`elixir`\) + +Elixir section is shown when ```mix.exs``` is found or elixir files are found and either kiex, exenv, elixir is avaiable on your path. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_ELIXIR_SHOW` | `true` | Show current Elixir version | +| `SPACEFISH_ELIXIR_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before the elixir section | +| `SPACEFISH_ELIXIR_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the elixir section | +| `SPACEFISH_ELIXIR_SYMBOL` | `💧·` | Character to be shown before Elixir version | +| `SPACEFISH_ELIXIR_COLOR` | `magenta` | Color of Elixir section | + +### Pyenv \(`pyenv`\) + +Pyenv section is shown only in directories that contain `.python-version`, `requirements.txt`, `pyproject.toml`, or any other file with `.py` extension. +The section will also be shown if the `$PYENV_VERSION` environment variable is set. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_PYENV_SHOW` | `true` | Show current Pyenv version | +| `SPACEFISH_PYENV_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before the pyenv section | +| `SPACEFISH_PYENV_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the pyenv section | +| `SPACEFISH_PYENV_SYMBOL` | `🐍·` | Character to be shown before Pyenv version | +| `SPACEFISH_PYENV_COLOR` | `yellow` | Color of Pyenv section | + +### Go \(`golang`\) + +Go section is shown only in directories that contain `Godeps`, `glide.yaml`, `go.mod`, any other file with `.go` extension, or when current directory is in the Go workspace defined in `$GOPATH`. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_GOLANG_SHOW` | `true` | Show current Go version | +| `SPACEFISH_GOLANG_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before the Go section | +| `SPACEFISH_GOLANG_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the Go section | +| `SPACEFISH_GOLANG_SYMBOL` | `🐹·` | Character to be shown before Go version | +| `SPACEFISH_GOLANG_COLOR` | `cyan` | Color of Go section | + +### PHP (`php`) + +PHP section is shown only in directories that contain `composer.json` file, or any other file with `.php` extension. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_PHP_SHOW` | true | Show PHP section | +| `SPACEFISH_PHP_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before the PHP section | +| `SPACEFISH_PHP_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the PHP section | +| `SPACEFISH_PHP_SYMBOL` | `🐘·` | Character to be shown before PHP version | +| `SPACEFISH_PHP_COLOR` | `blue` | Color of PHP section | + +### Rust (`rust`) + +Rust section is shown only in directories that contain `Cargo.toml` or any other file with `.rs` extension. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_RUST_SHOW` | `true` | Show current Rust version | +| `SPACEFISH_RUST_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before the Rust section | +| `SPACEFISH_RUST_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the Rust section | +| `SPACEFISH_RUST_SYMBOL` | `𝗥·` | Character to be shown before Rust version | +| `SPACEFISH_RUST_COLOR` | `red` | Color of Rust section | +| `SPACEFISH_RUST_VERBOSE_VERSION` | `false` | Show what branch is being used, if any. (Beta, Nightly) | + +### .NET (`dotnet`) + +.NET section is shown only in directories that contains a `project.json`, `global.json` or `paket.dependencies` file, or a file with one of these extensions: `.csproj`, `.xproj`, `.fproj` or `.sln`. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_DOTNET_SHOW` | `true` | Current .NET section | +| `SPACEFISH_DOTNET_PREFIX` | `$SPACEFISH_PROMPT_DEFAULT_PREFIX` | Prefix before .NET section | +| `SPACEFISH_DOTNET_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after .NET section | +| `SPACEFISH_DOTNET_SYMBOL` | `.NET·` | Character to be shown before .NET version | +| `SPACEFISH_DOTNET_COLOR` | `128` | Color of .NET section | + +### Kubectl context \(`kubecontext`\) + +Kubernetes context is shown everywhere if `kubectl` binary is found. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_KUBECONTEXT_SHOW` | `true` | Show current kubectl context | +| `SPACEFISH_KUBECONTEXT_NAMESPACE_SHOW` | `true` | Show current kubectl context namespace| +| `SPACEFISH_KUBECONTEXT_PREFIX` | `at ` | Prefix before the kubectl section | +| `SPACEFISH_KUBECONTEXT_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after the kubectl section | +| `SPACEFISH_KUBECONTEXT_SYMBOL` | `☸️ ` | Character to be shown before kubectl context | +| `SPACEFISH_KUBECONTEXT_COLOR` | `cyan` | Color of kubectl section | + +### Exec Time \(`exec_time`\) + +Execution time of the last command. Will be displayed if it exceeds the set threshold of time. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_EXEC_TIME_SHOW` | `true` | Show execution time | +| `SPACEFISH_EXEC_TIME_PREFIX` | `took·` | Prefix before exec time section | +| `SPACEFISH_EXEC_TIME_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after exec time section | +| `SPACEFISH_EXEC_TIME_COLOR` | `yellow` | Color of exec time section | +| `SPACEFISH_EXEC_TIME_ELAPSED` | `5` | The threshold in seconds for showing exec time section | + +### Line Separator \(`line_sep`\) + +This is where the prompt will split into two lines, if enabled. + +### Battery \(`battery`\) + +By default, Battery section is shown only if battery level is below `SPACEFISH_BATTERY_THRESHOLD` \(default: 10%\). + +| Variable | Default | Meaning | +| :--- | :---: | --- | +| `SPACEFISH_BATTERY_SHOW` | `true` | Show battery section \(`true`, `false`, `always` or `charged`\) | +| `SPACEFISH_BATTERY_PREFIX` | ` ` | Prefix before battery section | +| `SPACEFISH_BATTERY_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after battery section | +| `SPACEFISH_BATTERY_SYMBOL_CHARGING` | `⇡` | Character to be shown if battery is charging | +| `SPACEFISH_BATTERY_SYMBOL_DISCHARGING` | `⇣` | Character to be shown if battery is discharging | +| `SPACEFISH_BATTERY_SYMBOL_FULL` | `•` | Character to be shown if battery is full | +| `SPACEFISH_BATTERY_THRESHOLD` | 10 | Battery level below which battery section will be shown | + +`SPACEFISH_BATTERY_SHOW` defines when to show battery section. Here are possible values: + +| `SPACEFISH_BATTERY_SHOW` | Below threshold | Above threshold | Fully charged | +| :---: | :--- | :--- | :--- | +| `false` | Hidden | Hidden | Hidden | +| `always` | Shown | Shown | Shown | +| `true` | Shown | Hidden | Hidden | +| `charged` | Shown | Hidden | Shown | + +### Vi-mode \( vi_mode \) + +This section shows mode indicator only when Vi-mode is enabled. + +| Variable | Default | Meaning | +| :--- | :---: | --- | +| `SPACEFISH_VI_MODE_SHOW` | `true` | Shown current Vi-mode or not | +| `SPACEFISH_VI_MODE_PREFIX` | ` ` | Prefix before Vi-mode section | +| `SPACEFISH_VI_MODE_SUFFIX` | `$SPACEFISH_PROMPT_DEFAULT_SUFFIX` | Suffix after Vi-mode section | +| `SPACEFISH_VI_MODE_INSERT` | `[I]` | Text to be shown when in insert mode | +| `SPACEFISH_VI_MODE_NORMAL` | `[N]` | Text to be shown when in normal mode | +| `SPACEFISH_VI_MODE_VISUAL` | `[V]` | Text to be shown when in visual mode | +| `SPACEFISH_VI_MODE_REPLACE_ONE` | `[R]` | Text to be shown when in replace_one mode | +| `SPACEFISH_VI_MODE_COLOR` | `white` | Color of Vi-mode section | + +### Jobs \(`jobs`\) + +This section only shows when there are backgrounded jobs. + +| Variable | Default | Meaning | +| :------- | :-----: | ------- | +| `SPACEFISH_JOBS_SHOW` | `true` | Show background jobs indicator | +| `SPACEFISH_JOBS_PREFIX` | ` ` | Prefix before the jobs indicator | +| `SPACEFISH_JOBS_SUFFIX` | ` ` | Suffix after the jobs indicator | +| `SPACEFISH_JOBS_SYMBOL` | `✦` | Character to be shown when jobs are hiding | +| `SPACEFISH_JOBS_COLOR` | `blue` | Color of background jobs section | +| `SPACEFISH_JOBS_AMOUNT_PREFIX` | ` ` | Prefix before the number of jobs | +| `SPACEFISH_JOBS_AMOUNT_SUFFIX` | ` ` | Suffix after the number of jobs | +| `SPACEFISH_JOBS_AMOUNT_THRESHOLD` | `1` | Number of jobs after which job count will be shown | + +### Exit Code \(`exit_code`\) +Disabled by default. Set `SPACEFISH_EXIT_CODE_SHOW` to `true` to enable. + +| Variable | Default | Meaning | +| :--- | :---: | --- | +| `SPACEFISH_EXIT_CODE_SHOW` | `false` | Show the exit code of the previous command | +| `SPACEFISH_EXIT_CODE_PREFIX` | ` ` | Prefix of exit code | +| `SPACEFISH_EXIT_CODE_SUFFIX` | ` ` | Suffix of exit code | +| `SPACEFISH_EXIT_CODE_SYMBOL` | `✘` | Symbol before the exit code, upon failure | +| `SPACEFISH_EXIT_CODE_COLOR` | `red` | Color of exit code section | + +### Char \(`char`\) + +| Variable | Default | Meaning | +| :--- | :---: | --- | +| `SPACEFISH_CHAR_PREFIX` | ` ` | Prefix before prompt character | +| `SPACEFISH_CHAR_SUFFIX` | ` ` | Suffix after prompt character | +| `SPACEFISH_CHAR_SYMBOL` | `➜` | Prompt character to be shown before any command | +| `SPACEFISH_CHAR_COLOR_SUCCESS` | `green` | Color of prompt character if last command completes successfully | +| `SPACEFISH_CHAR_COLOR_FAILURE` | `red` | Color of prompt character if last command returns non-zero exit-code | diff --git a/.config/fisher/github.com/matchai/spacefish/docs/README.md b/.config/fisher/github.com/matchai/spacefish/docs/README.md new file mode 100644 index 00000000..ca58102b --- /dev/null +++ b/.config/fisher/github.com/matchai/spacefish/docs/README.md @@ -0,0 +1,45 @@ +# Summary + +* [Home](README.md) +* [Options](./docs/Options.md) + * [Order](./docs/Options.md#order) + * [Prompt](./docs/Options.md#prompt) + * [Time](./docs/Options.md#time) + * [Username (user)](./docs/Options.md#username-user) + * [Directory (dir)](./docs/Options.md#directory-dir) + * [Hostname (host)](./docs/Options.md#host-host) + * [Git (git)](./docs/Options.md#git-git) + * [Git branch (git_branch)](./docs/Options.md#git-branch-gitbranch) + * [Git status (git_status)](./docs/Options.md#git-status-gitstatus) + * [Package version (package)](./docs/Options.md#package-version-package) + * [Node (node)](./docs/Options.md#nodejs-node) + * [Julia (julia)](./docs/Options.md#julia-julia) + * [Docker (docker)](./docs/Options.md#docker-docker) + * [Ruby (ruby)](./docs/Options.md#ruby-ruby) + * [Haskell (haskell)](./docs/Options.md#haskell-haskell) + * [Conda (conda)](./docs/Options.md#conda-conda) + * [Elixir (elixir)](./docs/Options.md#elixir-elixir) + * [Amazon Web Services (aws)](./docs/Options.md#amazon-web-services-aws-aws) + * [Pyenv (pyenv)](./docs/Options.md#pyenv-pyenv) + * [Go (golang)](./docs/Options.md#go-golang) + * [PHP (php)](./docs/Options.md#php-php) + * [Rust (rust)](./docs/Options.md#rust-rust) + * [.NET (dotnet)](/docs/Options.md#net-dotnet) + * [Kubectl context (kubecontext)](./docs/Options.md#kubectl-context-kubecontext) + * [Execution time (exec_time)](./docs/Options.md#execution-time-exec_time) + * [Line Separator (line_sep)](./docs/Options.md#line_sep-node) + * [Battery (battery)](./docs/Options.md#battery-battery) + * [Jobs (jobs)](./docs/Options.md#jobs-jobs) + * [Exit Code (exit_code)](./docs/Options.md#nodejs-node) + * [Char (char)](./docs/Options.md#char) +* [Contributing Guide](/CONTRIBUTING.md) + * [Philosophy](/CONTRIBUTING.md#philosophy) + * [Setup](/CONTRIBUTING.md#setup) + * [Sections](/CONTRIBUTING.md#sections) +* [API](/docs/API.md) + * [Example section](/docs/API.md#typical-section) + * [SPACEFISH_VERSION](/docs/API.md#spaceshipversion) + * [__sf_lib_section](/docs/API.md#__sf_lib_section-color-prefix-content-suffix) + * [__sf_util_set_default](/docs/API.md#__sf_util_set_default-variable_name-value) + * [__sf_util_git_branch](/docs/API.md#__sf_util_git_branch) +* [Troubleshooting](/docs/Troubleshooting.md) diff --git a/.config/fisher/github.com/matchai/spacefish/docs/Troubleshooting.md b/.config/fisher/github.com/matchai/spacefish/docs/Troubleshooting.md new file mode 100644 index 00000000..c38bfd02 --- /dev/null +++ b/.config/fisher/github.com/matchai/spacefish/docs/Troubleshooting.md @@ -0,0 +1,82 @@ +# Troubleshooting + +This page aimed to help you fix common problems encountered while using spacefish. + +## My prompt is filling with errors + +Try all of the following troubleshooting steps: + +* Verify that your fish installation is at the [latest version](https://github.com/fish-shell/fish-shell/releases) + + ```sh + fish --version + ``` + +* Update spacefish with `fisher` or `omf` + + ```sh + fisher add matchai/spacefish + # or + omf update spacefish + ``` + +* If errors persist, please [open an issue](https://github.com/matchai/spacefish/issues/new) + +## What's the weird symbol beside the `git` branch? + +You need to have a powerline patched font in order to properly display `git` branch symbol. + +* Install any powerline compatible font like [Fira Code](https://github.com/tonsky/FiraCode) or [others](https://github.com/powerline/fonts). +* Configure your terminal emulator to [use that font](https://powerline.readthedocs.io/en/master/troubleshooting/osx.html). + +## What's the weird character in front of a section? + +This is not an issue with spacefish. Spacefish uses Unicode symbols to represent `SPACESFISH_*_SYMBOL` in sections. To solve this problem: + +* Verify your terminal emulator supports Unicode characters with this command: + + ```sh + curl https://www.cl.cam.ac.uk/~mgk25/ucs/examples/UTF-8-demo.txt + # or + wget -O - https://www.cl.cam.ac.uk/~mgk25/ucs/examples/UTF-8-demo.txt + ``` +* Configure your terminal emulator to use UTF-8 character encoding. + + +In the event that Unicode characters aren't supported, you can replace them with characters that are compatible with your terminal with `SPACEFISH_*_SYMBOL` options. Check out the [Options](./docs/Options.md) page for more information. + +## Why is my prompt slow? + +Spacefish may run more slowlyin big repositories since the status checks add up to be expensive operations. + +To speed up your prompt, try to reduce the number of unused spacefish sections that are enabled. Spacefish only loads the sections mentioned in `SPACEFISH_PROMPT_ORDER`. If you think some sections might not be be useful to you, you can disable them by not including their names in the prompt order. + +## Why do my section icons overlap each other? + +![overlapping icons](../images/icon-overlap.png) + +This issue is due to how your terminal emulator renders Unicode 9 characters. To fix this issue: + +* Make sure terminal uses _Unicode Version 9 Widths_. +* Let your terminal render ambiguous-width characters as double-width. + +In _iTerm_ follow these instructions: + +* Go _iTerm → Preferences… (⌘,) → Profiles → Text_ +* Check _Unicode Version 9 Widths_. +* Check _Threat ambiguous-width characters as double-width_. +* Reload your terminal's tab. + +## Why doesn't my prompt look like it does in the preview? + +![preview](../images/preview.gif) + +Preview shows a `spacefish` setup with: + +* [Hyper](https://hyper.is) as the terminal emulator. +* [One Dark](https://www.npmjs.com/package/hyperterm-atom-dark) color theme from [Atom](https://atom.io/) editor. +* [Fira Code](https://github.com/tonsky/FiraCode) with with ligatures as primary font (16px size). + +## My problem wasn't solved + +If the above suggestions don't address your problem, feel free to [open an issue](https://github.com/matchai/spacefish/issues/new), describe your problem and we will gladly help you. |