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.

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