Updating nextest¶
Nextest includes a self-update feature that will fetch and write the latest version of the binary to your system.
Pre-built binaries¶
For pre-built binaries installed via cargo-binstall or a release URL, run:
cargo nextest self update
The nextest updater downloads and installs the latest version of the cargo-nextest binary from get.nexte.st.
To request a specific version, add --version <version> to the command. For example, to update to nextest 0.9.72, run:
cargo nextest self update --version 0.9.72
Beta and RC channels¶
The nextest project occasionally publishes betas and release candidates (RCs) to test new features. To update to the latest prerelease, run:
# Update to the latest beta release:
cargo nextest self update --beta
# Update to the latest RC release:
cargo nextest self update --rc
If no newer betas or RCs are available, these commands update to the latest stable release.
You can also specify an exact prerelease version. This approach works with older versions of nextest as well:
# Update to a specific version:
cargo nextest self update --version 0.9.119-b.2
From source¶
Nextest can also be updated from source, by running:
cargo install cargo-nextest --locked
With distro packages¶
For versions of nextest packaged by a distributor, follow the instructions for the respective package manager.
Note for distributors¶
The cargo-nextest crate has a default-no-update feature which consists of all default features except for self-update. The recommended, forward-compatible way to build cargo-nextest is with --locked --no-default-features --features default-no-update.
Options and arguments¶
The output of cargo nextest self update -h:
Download and install updates to nextest
Usage: cargo nextest self update [OPTIONS]
Options:
--version <VERSION> Version or version range to download [default: latest]
-n, --check Check for updates rather than downloading them
-v, --verbose Verbose output [env: NEXTEST_VERBOSE=]
--color <WHEN> Produce color output: auto, always, never [env:
CARGO_TERM_COLOR=always] [default: auto]
-y, --yes Do not prompt for confirmation
-f, --force Force downgrades and reinstalls
--releases-url <RELEASES_URL> URL or path to fetch releases.json from
-h, --help Print help (see more with '--help')
Manifest options:
--manifest-path <PATH> Path to Cargo.toml
Config options:
--config-file <PATH>
Config file [default: workspace-root/.config/nextest.toml]
--tool-config-file <TOOL:ABS_PATH>
Tool-specific config files
--override-version-check
Override checks for the minimum version defined in nextest's config
-P, --profile <PROFILE>
The nextest profile to use [env: NEXTEST_PROFILE=]
Download and install updates to nextest
Usage: cargo nextest self update [OPTIONS]
Options:
--version <VERSION> Version or version range to download [default: latest]
-n, --check Check for updates rather than downloading them
-v, --verbose Verbose output [env: NEXTEST_VERBOSE=]
--color <WHEN> Produce color output: auto, always, never [env:
CARGO_TERM_COLOR=always] [default: auto]
-y, --yes Do not prompt for confirmation
-f, --force Force downgrades and reinstalls
--releases-url <RELEASES_URL> URL or path to fetch releases.json from
-h, --help Print help (see more with '--help')
Manifest options:
--manifest-path <PATH> Path to Cargo.toml
Config options:
--config-file <PATH>
Config file [default: workspace-root/.config/nextest.toml]
--tool-config-file <TOOL:ABS_PATH>
Tool-specific config files
--override-version-check
Override checks for the minimum version defined in nextest's config
-P, --profile <PROFILE>
The nextest profile to use [env: NEXTEST_PROFILE=]
The output of cargo nextest self update --help:
Download and install updates to nextest
This command checks the internet for updates to nextest, then downloads and installs them if an
update is available.
Usage: cargo nextest self update [OPTIONS]
Options:
--version <VERSION>
Version or version range to download
[default: latest]
-n, --check
Check for updates rather than downloading them
If no update is available, exits with code 0. If an update is available, exits with code
80 (UPDATE_AVAILABLE).
-v, --verbose
Verbose output
[env: NEXTEST_VERBOSE=]
--color <WHEN>
Produce color output: auto, always, never
[env: CARGO_TERM_COLOR=always]
[default: auto]
-y, --yes
Do not prompt for confirmation
-f, --force
Force downgrades and reinstalls
--releases-url <RELEASES_URL>
URL or path to fetch releases.json from
-h, --help
Print help (see a summary with '-h')
Manifest options:
--manifest-path <PATH>
Path to Cargo.toml
Config options:
--config-file <PATH>
Config file [default: workspace-root/.config/nextest.toml]
--tool-config-file <TOOL:ABS_PATH>
Tool-specific config files
Some tools on top of nextest may want to set up their own default configuration but
prioritize user configuration on top. Use this argument to insert configuration that's
lower than --config-file in priority but above the default config shipped with nextest.
Arguments are specified in the format "tool:abs_path", for example
"my-tool:/path/to/nextest.toml" (or "my-tool:C:\path\to\nextest.toml" on Windows). Paths
must be absolute.
This argument may be specified multiple times. Files that come later are lower priority
than those that come earlier.
--override-version-check
Override checks for the minimum version defined in nextest's config.
Repository and tool-specific configuration files can specify minimum required and
recommended versions of nextest. This option overrides those checks.
-P, --profile <PROFILE>
The nextest profile to use.
Nextest's configuration supports multiple profiles, which can be used to set up different
configurations for different purposes. (For example, a configuration for local runs and
one for CI.) This option selects the profile to use.
[env: NEXTEST_PROFILE=]
Download and install updates to nextest
This command checks the internet for updates to nextest, then downloads and installs them if an
update is available.
Usage: cargo nextest self update [OPTIONS]
Options:
--version <VERSION>
Version or version range to download
[default: latest]
-n, --check
Check for updates rather than downloading them
If no update is available, exits with code 0. If an update is available, exits with code
80 (UPDATE_AVAILABLE).
-v, --verbose
Verbose output
[env: NEXTEST_VERBOSE=]
--color <WHEN>
Produce color output: auto, always, never
[env: CARGO_TERM_COLOR=always]
[default: auto]
-y, --yes
Do not prompt for confirmation
-f, --force
Force downgrades and reinstalls
--releases-url <RELEASES_URL>
URL or path to fetch releases.json from
-h, --help
Print help (see a summary with '-h')
Manifest options:
--manifest-path <PATH>
Path to Cargo.toml
Config options:
--config-file <PATH>
Config file [default: workspace-root/.config/nextest.toml]
--tool-config-file <TOOL:ABS_PATH>
Tool-specific config files
Some tools on top of nextest may want to set up their own default configuration but
prioritize user configuration on top. Use this argument to insert configuration that's
lower than --config-file in priority but above the default config shipped with nextest.
Arguments are specified in the format "tool:abs_path", for example
"my-tool:/path/to/nextest.toml" (or "my-tool:C:\path\to\nextest.toml" on Windows). Paths
must be absolute.
This argument may be specified multiple times. Files that come later are lower priority
than those that come earlier.
--override-version-check
Override checks for the minimum version defined in nextest's config.
Repository and tool-specific configuration files can specify minimum required and
recommended versions of nextest. This option overrides those checks.
-P, --profile <PROFILE>
The nextest profile to use.
Nextest's configuration supports multiple profiles, which can be used to set up different
configurations for different purposes. (For example, a configuration for local runs and
one for CI.) This option selects the profile to use.
[env: NEXTEST_PROFILE=]