cargo-release for Mac

cargo release Streamline your crate release process

cargo release extends cargo publish with common release practices like validation, version management, tagging, and pushing. The process is customizable but with defaults that should help you get up and running quickly.

Features include: Ensure you are in a good state for release, including: Right branch Up-to-date with remote Clean tree Supports workspaces using cargo's native flags, like --workspace, --exclude and --package Updates dependent crates in workspace when changing version Change detection to help guide in what crates might not need a release Optionally share commits Handles cargo publish, tagging, and pushing Pre-release search and replace for custom version updates, including Updating changelogs Update tags in Dockerfiles Pre-release hook for extra customization, including CHANGELOG generation

Install

Current release: 1.1.7

Usage

See the reference for more on level, other CLI arguments, and configuration file format. See also the FAQ for help in figuring out how to adapt cargo-release to your workflow.

Prerequisite

Your project should be managed by git.

Dry run

By default, cargo-release runs in dry-run mode so you can safely run it and verify what it will do. Increase the logging level with each additional -v to get more details Speed up dry-run by skipping cargo-publishs verify step with --no-verify

Once you are ready, pass the --execute flag.

Note: the packaging and verifying steps will list the current version and not the bumped version because cargo release delegates to cargo publish which does not know about the in-memory-only version bump (#890).

Related tools release-pr Action cargo-smart-release cargo-set-version cargo-unleash release-plz cargo-workspaces

Semver Compatibility

cargo-release's versioning tracks compatibility for the binaries, not the API. We upload to crates.io to distribute the binary. If using this as a library, be sure to pin the version with a = version requirement operator.

License

Licensed under either of

Apache License, Version 2.0, (LICENSE-APACHE or ) MIT license (LICENSE-MIT or )

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual-licensed as above, without any additional terms or conditions.