#cargo #workspaces #monorepo #publishing #unleash

app cargo-unleash

Tooling to manage releasing of crates in massiv workspaces/monorepos

12 releases

1.0.0-alpha.12 May 18, 2021
1.0.0-alpha.11 Jan 5, 2021
1.0.0-alpha.10 Mar 19, 2020
1.0.0-alpha.9 Feb 28, 2020

#66 in Cargo plugins

Download history 39/week @ 2021-02-21 39/week @ 2021-02-28 36/week @ 2021-03-07 40/week @ 2021-03-14 66/week @ 2021-03-21 51/week @ 2021-03-28 58/week @ 2021-04-04 45/week @ 2021-04-11 57/week @ 2021-04-18 20/week @ 2021-04-25 46/week @ 2021-05-02 36/week @ 2021-05-09 66/week @ 2021-05-16 38/week @ 2021-05-23 43/week @ 2021-05-30 47/week @ 2021-06-06

199 downloads per month

GPL-3.0 license


cargo unleash em 🐉

cargo release automation tooling for massiv mono-repo. Developed primarily for Parity Substrate.


see Changelog.md


Use cargo install to install:

cargo install cargo-unleash --version 1.0.0-alpha.11


Try and have it report what it would do on your mono repo with

cargo unleash em-dragons --dry-run

There are more options available on the CLI, just run with --help:

cargo-unleash 1.0.0-alpha.11
Release the crates of this massiv monorepo

    cargo-unleash [FLAGS] [OPTIONS] <SUBCOMMAND>

    -h, --help
            Prints help information

    -V, --version
            Prints version information

    -v, --verbose
            Show verbose cargo output

    -l, --log <log>
            Specify the log levels [default: warn]

    -m, --manifest-path <manifest-path>
            The path to workspace manifest

            Can either be the folder if the file is named `Cargo.toml` or the path to the specific `.toml`-manifest to
            load as the cargo workspace. [default: ./]

    add-owner      Add owners for a lot of crates
    check          Check whether crates can be packaged
    de-dev-deps    Deactivate the `[dev-dependencies]`
    em-dragons     Unleash 'em dragons
    help           Prints this message or the help of the given subcommand(s)
    set            Set a field in all manifests
    to-release     Calculate the packages and the order in which to release
    version        Messing with versioning


The main command is cargo unleash em-dragons, here is its help. All subcommands have extensive --help for you.

$ cargo-unleash em-dragons --help

Unleash 'em dragons

Package all selected crates, check them and attempt to publish them.

    cargo-unleash em-dragons [FLAGS] [OPTIONS]

            Actually build the package in check

            By default, this only runs `cargo check` against the package build. Set this flag to have it run an actual
            `build` instead.
            dry run

    -h, --help
            Prints help information

            Ignore whether `publish` is set.

            If nothing else is specified `publish = true` is assumed for every package. If publish is set to false or
            any registry, it is ignore by default. If you want to include it regardless, set this flag.
            Do not disable dev-dependencies

            By default we disable dev-dependencies before the run.
            dry run

    -V, --version
            Prints version information

        --owner <add-owner>
            Ensure we have the owner set as well

    -i, --ignore-pre-version <ignore-pre-version>...
            Ignore version pre-releases

            Skip if the SemVer pre-release field is any of the listed. Mutually exclusive with `--package`
    -p, --packages <packages>...
            Only use the specfic set of packages

            Apply only to the packages named as defined. This is mutually exclusive with skip and ignore-version-pre.
            Default: []
    -s, --skip <skip>...
            skip the package names matching ...

            Provide one or many regular expression that, if the package name matches, means we skip that package.
            Mutually exclusive with `--package`
        --token <token>
             [env: CRATES_TOKEN]

Common Usage Examples

Release all crates not having the -dev-pre version set

cargo-unleash em-dragons --ignore-pre-version dev

Release all crates not having test in the name

cargo-unleash em-dragons --skip test

Set the pre-version to -dev

cargo-unleash version set-pre dev

Bump the pre-version, so for e.g. from alpha.1 to alpha.2 or beta.3 to beta.4:

cargo-unleash version bump-pre

In the wild

You are using the tooling and want to be mentioned here–create an issue

License & Credits

This Software is released under the GNU General Public License (GPL) 3.0.

This, as any other software, is build on the shoulders of giants. In particular, this uses cargo internally and draws heavily on the knowledge established by cargo publish-all and cargo hack.


~884K SLoC