Project status & info:
|Travis Build Status||Dependency Status||License||Crates Version|
Rust & OS support:
Binary application for cleaning $CARGO_HOME/registry & $CARGO_HOME/git folder support orphan cleaning and old cleaning Default $CARGO_HOME is set as $HOME/.cargo
Initially you should have rustc and cargo installed for a detail information of how to install rust-lang visit https://rust-lang.org
For installation of cargo-trim:- You can install from crates.io registry
cargo install cargo-trim
For bleeding edge latest development version:
cargo install --git https://github.com/iamsauravsharma/cargo-trim
By default cargo-trim print out colored output if you want to use a non colored output you can enable out no-color feature
cargo install cargo-trim --features no-color
Initially you need to setup cargo-trim for some of commands such as orphan clean to work properly.
To setup cargo-trim to properly work for all projects related to rust lang go to directory where all projects lies and run
cargo trim init. You can even run this command multiple time to add multiple directory.
or simple run command
cargo trim -s <directory-path>. All projects inside directory will be used for listing orphan crates. So
if there is any projects in other directory then their dependencies will be classified as orphan crates. If not used by any
All cargo-trim can be run using
cargo trim <command>
cargo trim --help will produce out following output which list out all of available command for cargo-trim
cargo-trim 0.5.3 Saurav Sharma <firstname.lastname@example.org> Binary application to cleanup $CARGO_HOME cache USAGE: cargo trim [FLAGS] [OPTIONS] [SUBCOMMAND] FLAGS: -a, --all Clean up all .cargo/registry & .cargo/git follow config file data -c, --clear Clear config file data -n, --dry-run Run command in dry run mode to see what would be removed -f, --force Force clear cache without reading conf file -h, --help Prints help information -l, --light Light cleanup repos by removing git checkout and registry source but stores git db and registry archive for future compilation without internet requirement -o, --old-clean Clean old cache crates -z, --old-orphan-clean Clean crates which is both old and orphan -x, --orphan-clean Clean orphan cache crates i.e all crates which are not present in lock file generated till now use cargo trim -u to guarantee your all project generate lock file -q, --query Return size of different .cargo/cache folders -u, --update Generate and Update Cargo.lock file present inside config directory folder path -V, --version Prints version information OPTIONS: -e, --exclude <crate>... Add listed crates to default conf file exclude list [use TRIM_EXCLUDE environment variable for creating exclude list without editing conf file] -g, --gc <git compress> Git compress to reduce size of .cargo [possible values: all, index, git, git- checkout, git-db] -i, --include <crate>... Add listed crates to default conf file include list [use TRIM_INCLUDE environment variable for creating include list without editing conf file] -r, --remove <crate>... Remove provided crates from registry or git -s, --set-directory <Directory>... Set directory of Rust project [use TRIM_DIRECTORY environment variable for creating directory list without editing conf file] -t, --top <number> Show certain number of top crates which have highest size -w, --wipe <folder> Wipe folder [possible values: git, checkouts, db, registry, cache, index, src] SUBCOMMANDS: clear Clear current working directory from cargo cache config completions Generate tab-completions scripts for shell config Query config file data git Perform operation only to git related cache file help Prints this message or the help of the given subcommand(s) init Initialize current working directory as cargo trim directory list List out crates registry Perform operation only to registry related cache file remove Remove values from config file
Config file location
cargo-trim store its config file to config directory of OS and name config file as
In file cargo-trim stores out information about directory of rust projects and exclude and include crates list for cargo trim.