cargo-diet 1.0.0

Make your crate lean by computing size-optimal include directives for Cargo manifests
Documentation

Rust Crates.io

cargo diet is a companion program of The Lean Crate Initiative to help computing 'optimal' include directives for your Cargo.toml manifest. 'optimal' here is the smallest size a crate can have while retaining everything relevant to building the code and populating crates.io and lib.rs with useful information on the landing page.

Please note that this opinionated approach won't prevent you to adjust the initial include directive to your liking and needs, without cargo diet interfering with you on subsequent invocations.

asciicast

Usage

  • make the crate lean by editing the Cargo.toml file in place

    • cargo diet

  • simulate how the Cargo.toml file would be edited to obtain a lean crate

    • cargo diet -n or cargo diet --dry-run

  • force computing an include directive even though one exists already

    • cargo diet -r or cargo diet --reset-manifest
    • can also be used with --dry-run such as in cargo diet --reset-manifest --dry-run or cargo diet -rn

Installation

Using Cargo

With a recent version of cargo (obtainable using rustup), the following should work:

cargo install cargo-diet

Using GitHub releases

Pre-built binaries can be found in the releases section of this repository.

Development

Run tests

make journey-tests

Learn about other targets

make