This tool extends Cargo to allow you to add, remove, and upgrade dependencies by modifying your Cargo.toml file from the command line.
Currently available subcommands:
Ensure that you have a fairly recent version of rust/cargo installed. On Ubuntu you would also need to install libssl-dev and pkg-config packages.
console,ignore
$ cargo install cargo-edit
If you wish to use a bundled version of openssl:
console,ignore
$ cargo install cargo-edit --features vendored-openssl
Compiler support: requires rustc 1.44+
(Please check cargo's documentation to learn how cargo install works and how to set up your system so it finds binaries installed by cargo.)
Install a sub-set of the commands with cargo install -f --no-default-features --features "<COMMANDS>", where <COMMANDS> is a space-separated list of commands; i.e. add rm upgrade for the full set.
cargo addcargo add is now integrated into cargo as of v1.62. If you want access in older versions of cargo, you'll need to install cargo-edit v0.9 or earlier.
Known differences from cargo-edit v0.9.1
- cargo add <path> is unsupported, instead use cargo add --path <path>
- cargo add <crate> +<feature> is unsupported, instead use cargo add <crate> -F <feature>
- If adding multiple crates, qualify the feature like cargo add serde -F serde/derive serde_json
- See rust-lang/cargo#10809
cargo rmcargo rm is now integrated into cargo as of v1.66. If you want access in older versions of cargo, you'll need to install cargo-edit v0.11 or earlier.
cargo upgradeUpgrade dependencies in your Cargo.toml to their latest versions.
To specify a version to upgrade to, provide the dependencies in the <crate name>@<version> format,
e.g. cargo upgrade -p docopt@~0.9.0 -p serde@>=0.9,<2.0.
This command differs from cargo update, which updates the dependency versions recorded in the
local lock file (Cargo.lock).
```console,ignore
$ cargo upgrade
$ cargo upgrade -p docopt@~0.9 -p serde@>=0.9,<2.0
$ cargo upgrade --exclude docopt --exclude serde ```
```console $ cargo-upgrade upgrade --help Upgrade dependency version requirements in Cargo.toml manifest files
Usage: cargo upgrade [OPTIONS]
Options:
--dry-run Print changes to be made without making them
--manifest-path rust-version
--ignore-rust-version Ignore rust-version specification in packages
--offline Run without accessing the network
--locked Require Cargo.toml to be up to date
-v, --verbose... Use verbose output
-Z
Version:
--compatible [
Dependencies:
-p, --package
```
cargo set-versionSet the version in your Cargo.toml.
```console,ignore
$ cargo set-version 1.0.0
$ cargo set-version --bump major
$ cargo set-version --bump minor
$ cargo set-version --bump patch ```
```console $ cargo-set-version set-version --help Change a package's version in the local manifest file (i.e. Cargo.toml)
Usage: cargo set-version [OPTIONS] [TARGET]
Arguments: [TARGET] Version to change manifests to
Options:
--bump --workspace]
--workspace Modify all packages in the workspace
--dry-run Print changes to be made without making them
--exclude Cargo.toml to be up to date
-Z
```
For more on metadata, see the
semver crate's documentation.
Thanks for your interest - we gratefully welcome contributions.
Questions can be asked in issues, or on Gitter.
To help us help you get pull requests merged quickly and smoothly, open an issue before submitted large changes. Please keep the contents of pull requests and commits short. Commit messages should include the intent of the commit.
cargo-edit has a moderately comprehensive test suite. Contributions that add/improve tests are awesome. Please add tests for every change.
cargo-edit uses rustfmt for formatting and clippy for linting.
Apache-2.0/MIT