1
0
mirror of https://github.com/Llewellynvdm/starship.git synced 2024-12-26 19:40:20 +00:00

docs(python): Update the python_binary option (#1731)

* docs(python): Update the python_binary option

Have updated the documentation to make the `python_binary` option a bit
more prominent, since this is becoming a more requested requirement now
that more and more systems don't have a default `python` command.

* Correct order of python options
This commit is contained in:
Thomas O'Donnell 2020-10-06 09:09:06 +02:00 committed by GitHub
parent 47492d686b
commit 140009994d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1883,15 +1883,16 @@ The module will be shown if any of the following conditions are met:
### Options ### Options
| Option | Default | Description | | Option | Default | Description |
| -------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | -------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| `format` | `"via [${symbol}${pyenv_prefix}${version}( \\($virtualenv\\))]($style) "` | The format for the module. | | `format` | `"via [${symbol}${pyenv_prefix}${version}( \\($virtualenv\\))]($style) "` | The format for the module. |
| `symbol` | `"🐍 "` | A format string representing the symbol of Python | | `symbol` | `"🐍 "` | A format string representing the symbol of Python |
| `style` | `"yellow bold"` | The style for the module. | | `style` | `"yellow bold"` | The style for the module. |
| `pyenv_version_name` | `false` | Use pyenv to get Python version | | `pyenv_version_name` | `false` | Use pyenv to get Python version |
| `pyenv_prefix` | `pyenv ` | Prefix before pyenv version display, only used if pyenv is used | | `pyenv_prefix` | `pyenv ` | Prefix before pyenv version display, only used if pyenv is used |
| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. | | `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
| `disabled` | `false` | Disables the `python` module. | | `python_binary` | `python` | Configures the python binary that Starship executes when getting the version. |
| `disabled` | `false` | Disables the `python` module. |
### Variables ### Variables
@ -1903,24 +1904,6 @@ The module will be shown if any of the following conditions are met:
| pyenv_prefix | `"pyenv "` | Mirrors the value of option `pyenv_prefix` | | pyenv_prefix | `"pyenv "` | Mirrors the value of option `pyenv_prefix` |
| virtualenv | `"venv"` | The current `virtualenv` name | | virtualenv | `"venv"` | The current `virtualenv` name |
<details>
<summary>This module has some advanced configuration options.</summary>
| Variable | Default | Description |
| --------------- | -------- | ----------------------------------------------------------------------------- |
| `python_binary` | `python` | Configures the python binary that Starship executes when getting the version. |
The `python_binary` variable changes the binary that Starship executes to get
the version of Python, it doesn't change the arguments that are used.
```toml
# ~/.config/starship.toml
[python]
python_binary = "python3"
```
</details>
### Example ### Example
@ -1932,6 +1915,18 @@ symbol = "👾 "
pyenv_version_name = true pyenv_version_name = true
``` ```
Using the `python3` binary to get the version.
Note - The `python_binary` variable changes the binary that Starship executes
to get the version of Python, it doesn't change the arguments that are used.
```toml
# ~/.config/starship.toml
[python]
python_binary = "python3"
```
## Ruby ## Ruby
The `ruby` module shows the currently installed version of Ruby. The `ruby` module shows the currently installed version of Ruby.