#monorepo #publishing #cargo-workspace #cargo #unleash #workspace #publish

app cargo-unleash

Tooling to manage releasing of crates in massiv workspaces/monorepos

14 releases

1.0.0-alpha.dev Feb 1, 2022
1.0.0-alpha.13 Nov 10, 2021
1.0.0-alpha.12 May 18, 2021
1.0.0-alpha.11 Jan 5, 2021
1.0.0-alpha.9 Feb 28, 2020

#326 in Cargo plugins

GPL-3.0 license

2.5K SLoC

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.13


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:

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
    clean-deps     Check the package(s) for unused dependencies
    de-dev-deps    Deactivate the `[dev-dependencies]`
    em-dragons     Unleash 'em dragons
    help           Prints this message or the help of the given subcommand(s)
    rename         Rename a package
    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.
            Generate & verify whether the Readme file has changed.

            When enabled, this will generate a Readme file from the crate's doc comments (using cargo-readme), and check
            whether the existing Readme (if any) matches.
            dry run

            Consider no package matching the criteria an error

    -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 ignored 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.
            Even if not selected by default, also include depedencies with a pre (cascading)

            dry run

    -V, --version
            Prints version information

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

    -c, --changed-since <changed-since>
            Automatically detect the packages, which changed compared to the given git commit.

            Compares the current git `head` to the reference given, identifies which files changed and attempts to
            identify the packages and its dependents through that mechanism. You can use any `tag`, `branch` or
            `commit`, but you must be sure it is available (and up to date) locally.
    -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.
    -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>
            the crates.io token to use for uploading

            If this is nor the environment variable are set, this falls back to the default value provided in the user
            directory [env: CRATES_TOKEN]

Common Usage Examples

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

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

Check if a PR can be released (checking only changes in the PR compared to main)

cargo-unleash check --changed-since=main

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.


~1M SLoC