diff options
| author | Roger Gonzalez <roger@rogs.me> | 2020-07-17 09:19:06 -0300 |
|---|---|---|
| committer | Roger Gonzalez <roger@rogs.me> | 2020-07-17 09:19:06 -0300 |
| commit | 9fe9310ccf4971f0d1976f9bdaafd04a68ea314b (patch) | |
| tree | ff1d5d677d5b3c33ac7eb6252029f2a9d165d9b3 /.config/fisher/github.com/matchai/spacefish/docs | |
| parent | 743caecfc68bb6d28f8de2e80bce671e42601c6a (diff) | |
Deleted fisher stuff
Diffstat (limited to '.config/fisher/github.com/matchai/spacefish/docs')
4 files changed, 0 insertions, 727 deletions
diff --git a/.config/fisher/github.com/matchai/spacefish/docs/API.md b/.config/fisher/github.com/matchai/spacefish/docs/API.md deleted file mode 100644 index a0db51a9..00000000 --- a/.config/fisher/github.com/matchai/spacefish/docs/API.md +++ /dev/null @@ -1,162 +0,0 @@ -# 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 deleted file mode 100644 index 6a85fc77..00000000 --- a/.config/fisher/github.com/matchai/spacefish/docs/Options.md +++ /dev/null @@ -1,438 +0,0 @@ -## 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` |  | 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` |  | 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 deleted file mode 100644 index ca58102b..00000000 --- a/.config/fisher/github.com/matchai/spacefish/docs/README.md +++ /dev/null @@ -1,45 +0,0 @@ -# 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 deleted file mode 100644 index c38bfd02..00000000 --- a/.config/fisher/github.com/matchai/spacefish/docs/Troubleshooting.md +++ /dev/null @@ -1,82 +0,0 @@ -# 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? - - - -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 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. |