Skip to content

Package version package

This section is rendered asynchronously by default

Note

This is the version of the package you are working on, not the version of the package manager itself.

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 and/or 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 — version form package.json file. Private packages are detected.
  • lerna — version from lerna.json file.
  • 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 — version from composer.json file.
  • julia — version from Project.toml file.
  • maven — version from mvn command.
  • gradle — version from gradle command.

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