53 lines
2.9 KiB
Markdown
53 lines
2.9 KiB
Markdown
# Package version `package`
|
|
|
|
!!! important "This section is rendered asynchronously by default"
|
|
|
|
!!! note
|
|
This is the version of the package you are working with, not the version of the package manager itself. Many people use the term `project` instead of `package` and in this context it is the same thing.
|
|
|
|
!!! attention
|
|
This section uses external tools for retrieving package versions.
|
|
|
|
We use `yq`, `jq`, `python` or `node` to parse package version in JSON/YAML/TOML/XML files. Install [jq](https://stedolan.github.io/jq/) and/or [yq](https://kislyuk.github.io/yq/) to get more info from this section.
|
|
|
|
The `package` section shows when the current directory is a package.
|
|
|
|
## Supported package managers
|
|
|
|
Currently, these package managers are supported:
|
|
|
|
* [`npm`][npm] — version form `package.json` file. Private packages are detected.
|
|
* [`lerna`][lerna] — version from `lerna.json` file.
|
|
* [`cargo`][cargo] — version from `Cargo.toml` file. `cargo pkgid` is used to detect the version, which depends on `Cargo.lock`. Run `cargo build` to generate `Cargo.lock` if version is not shown.
|
|
* [`composer`][composer] — version from `composer.json` file.
|
|
* [`julia`][julia] — version from `Project.toml` file.
|
|
* [`maven`][maven] — version from `mvn` command.
|
|
* [`gradle`][gradle] — version from `gradle` command.
|
|
* [`python`][python] — version from `pyproject.toml`, either in [`setuptools`][setuptools] or [`poetry`][poetry] format.
|
|
* [`dart`][dart] — version from the `pubspec.yaml` file.
|
|
|
|
## Options
|
|
|
|
| Variable | Default | Meaning |
|
|
| :------------------------------- | :---------------------------------: | ----------------------------------- |
|
|
| `SPACESHIP_PACKAGE_SHOW` | `true` | Show section |
|
|
| `SPACESHIP_PACKAGE_ASYNC` | `true` | Render section asynchronously |
|
|
| `SPACESHIP_PACKAGE_SHOW_PRIVATE` | `false` | Show when a package is private |
|
|
| `SPACESHIP_PACKAGE_PREFIX` | `is·` | Section's prefix |
|
|
| `SPACESHIP_PACKAGE_SUFFIX` | `$SPACESHIP_PROMPT_DEFAULT_SUFFIX` | Section's suffix |
|
|
| `SPACESHIP_PACKAGE_SYMBOL` | `📦·` | Symbol displayed before the section |
|
|
| `SPACESHIP_PACKAGE_COLOR` | `red` | Section's color |
|
|
|
|
<!-- References -->
|
|
[npm]: https://www.npmjs.com
|
|
[lerna]: https://lerna.io
|
|
[cargo]: https://crates.io
|
|
[composer]: https://getcomposer.org
|
|
[julia]: https://julialang.org
|
|
[maven]: https://maven.apache.org
|
|
[gradle]: https://gradle.org
|
|
[python]: https://python.org
|
|
[setuptools]: https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html
|
|
[poetry]: https://python-poetry.org/docs/pyproject/
|
|
[dart]: https://dart.dev
|