| 
|Project status & info:
| License | Crates Version |
| :-----: | :------------: |
| | |
Binary application for cleaning \$CARGOHOME/registry & \$CARGOHOME/git folder support orphan and old crates cleaning Default \$CARGO_HOME is set as \$HOME/.cargo
For installation of cargo-trim:-
You can install from crates.io registry
cargo install cargo-trim
OR
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 no-color feature
cargo install cargo-trim --features no-color
Initially you need to set up cargo-trim for some commands such as orphan clean to work properly.
To set up 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 run command cargo trim -d <directory-path>. All projects inside the directory will be used for listing orphan crates. So
if there are any projects in the other directory then their dependencies will be classified as orphan crates. If not used by any
other crates.
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.7.0
Saurav Sharma appdroiddeveloper@gmail.com
Binary application to cleanup $CARGO_HOME cache
USAGE: cargo-trim [FLAGS] [OPTIONS] [SUBCOMMAND]
FLAGS: -a, --all Clean up all registry & git crates -n, --dry-run Run command in dry run mode to see what would be done -h, --help Prints help information -l, --light Light cleanup repo by removing git checkout and registry source but stores git db and registry archive for future compilation without internet requirement -o, --old Clean old cache crates -z, --old-orphan Clean crates which is both old and orphan -x, --orphan 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:
-g, --gc
SUBCOMMANDS: clear Clear current working directory from cargo cache config config Query about config file data used by CLI 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 set Set config file values unset Unset values from config file ```
cargo-trim store its config file to config directory of OS and name config file as cargo_trim_config.toml.
In file cargo-trim stores different information for scanning projects as well as listing crates.
To list where cargo trim is storing config file you can use cargo trim config --location
Below are a list of configuration and their default value a well as corresponding env variable that can be used for setting
same value without editing config file
default: []
env: TRIM_DIRECTORY
List of directory to scan for a Rust projects
default: []
env: TRIM_IGNORE
File/Directory name which should be ignored while scanning through directories. This can be used to exclude some folder such as npm node_modules folder or python venv folder if the directory present in config contains such folder it will help to significantly increase performance.
default: false
env: TRIMSCANHIDDEN_FOLDER
Whether to scan hidden folder(i.e. folder which start with dot notation) or not
default: false
env: TRIMSCANTARGET_FOLDER
Whether to scan target folder. Currently, it searches for environment variable CARGO_BUILD_TARGET_DIR or CARGO_TARGET_DIR
or set default value as target to determine a target folder name