Display information on the cargo cache (~/.cargo/ or $CARGO_HOME). Optional cache pruning.
- check the size of the cargo cache and its components (cmd:
cargo cache) - do a simple cleanup removing checkouts but keeping original files needed for reconstruction on disk (
--autoclean) - clean up everything (cargo will re-download as needed)
- dry-run to see what would be removed (
--dry-run) - recompress git repos (
--gc) - search cache via regex queries (
cargo cache query "reg.*x") - print crates that take the most space (
--top-cache-items) - alternative registries supported
- remove files older or younger than X (
--remove-if-{older,younger}-than) - builds and runs on
stable,betaandnightlychannel - purge cache entries not unused to build a specified crate (
cargo cache clean-unref) - print size stats on a local sccache build cache (
cargo cache sc)
cargo install cargo-cache
or for the bleeding edge development version:
cargo install --git https://github.com/matthiaskrgr/cargo-cache cargo-cache
This only calculates the sizes and does not touch anything:
Cargo cache '/home/matthias/.cargo':
Total: 4.22 GB
102 installed binaries: 920.95 MB
Registry: 2.25 GB
Registry index: 227.07 MB
4412 crate archives: 684.29 MB
2411 crate source checkouts: 1.34 GB
Git db: 1.05 GB
113 bare git repos: 993.72 MB
9 git repo checkouts: 55.48 MB
To learn more about the subdirectories inside the cargo home and what can be safely deleted, check --info.
USAGE:
cargo cache [FLAGS] [OPTIONS] [SUBCOMMAND]
FLAGS:
-a, --autoclean Removes crate source checkouts and git repo checkouts
-e, --autoclean-expensive As --autoclean, but also recompresses git repositories
-d, --dry-run Don't remove anything, just pretend
-f, --fsck Fsck git repositories
-g, --gc Recompress git repositories (may take some time)
-h, --help Prints help information
-i, --info Print information cache directories, what they are for and what can be safely deleted
-l, --list-dirs List all found directory paths
-V, --version Prints version information
OPTIONS:
-k, --keep-duplicate-crates <N> Remove all but N versions of crate in the source archives directory
-r, --remove-dir <dir1,dir2,dir3> Remove directories, accepted values: all,git-db,git-repos,
registry-sources,registry-crate-cache,registry-index,registry
-o, --remove-if-older-than <date> Removes items older than specified date: YYYY.MM.DD or HH:MM:SS
-y, --remove-if-younger-than <date> Removes items younger than the specified date: YYYY.MM.DD or HH:MM:SS
-t, --top-cache-items <N> List the top N items taking most space in the cache
SUBCOMMANDS:
help Prints this message or the help of the given subcommand(s)
l check local build cache (target) of a rust project
local check local build cache (target) of a rust project
q run a query
query run a query
r query each package registry separately
registry query each package registry separately
cargo cache --top-cache-items 5
Summary of: /home/matthias/.cargo/bin/ (588.35 MB total)
Name Size
alacritty 38.40 MB
xsv 29.78 MB
rg 28.51 MB
cargo-geiger 15.11 MB
mdbook 12.39 MB
Summary of: /home/matthias/.cargo/registry/src/ (3.11 GB total)
Name Count Average Total
mozjs_sys 4 131.83 MB 527.31 MB
wabt-sys 2 83.73 MB 167.46 MB
openblas-src 2 78.42 MB 156.84 MB
curl-sys 6 18.47 MB 110.83 MB
winapi-x86_64-pc-windows-gnu 2 54.90 MB 109.80 MB
Summary of: /home/matthias/.cargo/registry/cache/ (1.18 GB total)
Name Count Average Total
mozjs_sys 10 29.45 MB 294.50 MB
curl-sys 16 3.03 MB 48.54 MB
libgit2-sys 18 2.54 MB 45.64 MB
servo-skia 6 5.23 MB 31.39 MB
openssl-src 5 5.55 MB 27.73 MB
Summary of: /home/matthias/.cargo/git/db/ (918.97 MB total)
Name Count Average Total
polonius 1 136.63 MB 136.63 MB
mdbook 1 111.45 MB 111.45 MB
rust-rocksdb 2 33.31 MB 66.62 MB
osmesa-src 2 28.45 MB 56.90 MB
ring 2 23.02 MB 46.04 MB
Summary of: /home/matthias/.cargo/git/checkouts/ (3.80 GB total)
Name Count Average Total
parity-ethereum 2 666.36 MB 1.33 GB
xori 1 372.69 MB 372.69 MB
polonius 2 186.34 MB 372.67 MB
alacritty 9 39.08 MB 351.74 MB
osmesa-src 2 166.12 MB 332.24 MB
This removes extracted tarball sources and repository checkouts. The original source archives and git repos are kept and will be extracted as needed by cargo.
cargo cache --autoclean
Cargo cache '/home/matthias/.cargo/':
Total: 4.22 GB
102 installed binaries: 920.95 MB
Registry: 2.25 GB
Registry index: 227.07 MB
4412 crate archives: 684.29 MB
2411 crate source checkouts: 1.34 GB
Git db: 1.05 GB
113 bare git repos: 993.72 MB
9 git repo checkouts: 55.48 MB
Size changed from 4.22 GB to 2.83 GB (-1.39 GB, -33.02%)
Checking the sizes after cleanup:
Total: 2.83 GB
102 installed binaries: 920.95 MB
Registry: 911.36 MB
Registry index: 227.07 MB
4412 crate archives: 684.29 MB
0 crate source checkouts: 0 B
Git db: 993.72 MB
113 bare git repos: 993.72 MB
0 git repo checkouts: 0 B
The crate also works if you override the default location of the cargo home via the $CARGO_HOME env var!
Side note: cargo-cache started as my learning-by-doing rust project, if you see something that you find very odd or is in dire need of improvement please let me know and open a ticket!
Sometimes it is desired to cache the $CARGO_HOME in CI.
As noted in the document, this might cache sources twice which adds unnecessary overhead.
To reduce the size of the cache before storing it, you might want to run cargo cache --autoclean.
The ci-autoclean feature provides a very stripped-down version of the crate that is only capable of running cargo-cache --autoclean automatically on launch and should compile within a couple of seconds.
To make use of this, you can add these commands to your ci:
cargo install (--git git://github.com/matthiaskrgr/cargo-cache OR cargo-cache) --no-default-features --features ci-autoclean cargo-cache
cargo-cache # no further arguments requiredQ: Is this project related to sccache?
A: Not really.
cargo cache sccache prints a little summary of the local(!) sccache-cache and shows how many files were last accessed on a given date but
it does not modify sccaches cache. It also does not act as a compiler cache such as (s)ccache.
Copyright 2017-2020 Matthias Krüger
Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
<LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
option. All files in the project carrying such notice may not be
copied, modified, or distributed except according to those terms.