cargo-goose
| Crates.io | cargo-goose |
| lib.rs | cargo-goose |
| version | 0.4.0 |
| created_at | 2026-01-06 22:25:02.863768+00 |
| updated_at | 2026-01-09 21:44:39.513627+00 |
| description | A strict, explicit SemVer CLI with first-class prerelease support. |
| homepage | |
| repository | https://github.com/mozilla-ai/cargo-goose |
| max_upload_size | |
| id | 2027013 |
| size | 75,231 |
Raz Besaleli (besaleli)
documentation
README
cargo-goose 🪿
A strict, explicit SemVer CLI with first-class prerelease support.
Installation
cargo install cargo-goose
Usage
cargo goose bump <command>
Commands
Bump a release version
Bump the current version by level:
cargo goose bump version patch
# 1.2.3 → 1.2.4
cargo goose bump version minor
# 1.2.3 → 1.3.0
cargo goose bump version major
# 1.2.3 → 2.0.0
Start a prerelease on the new version line:
cargo goose bump version minor rc
# 1.2.3 → 1.3.0-rc.1
Prerelease management
Increment the current prerelease counter:
cargo goose bump prerelease
# alpha.1 → alpha.2
Transition to a new prerelease identifier:
cargo goose bump prerelease beta
# 1.2.3-alpha.3 → 1.2.3-beta.1
Finalize a release
Finalize a prerelease into a stable release:
cargo goose bump release
# 1.2.0-rc.2 → 1.2.0
Build metadata
All commands accept optional build metadata:
cargo goose bump version patch --metadata git.abc123
Dry run
Don't want to screw up your Cargo.toml just yet? Add the --dry-run flag to see what cargo-goose will do without modifying any files:
cargo goose --dry-run bump ...
Prerelease format
Prereleases must use the following format:
<identifier>.<counter>
Examples:
alpha.1beta.2rc.3
Invalid prerelease formats are rejected.