1.8 KiB
1.8 KiB
cargo-cleanup
A fast, recursive cargo clean tool for saving disk space across multiple Rust projects.
Overview
cargo-cleanup is a Cargo subcommand that recursively cleans build artifacts from Rust projects, helping you reclaim disk space. Instead of running cargo clean in each project manually, you can clean entire directory trees in a single command.
Features
- Recursive cleaning: Clean build artifacts across all Cargo projects in a directory tree
- Dry-run mode: Preview what would be deleted without actually removing files
- Simple CLI: Intuitive subcommand interface integrated with Cargo
- Multi-path support: Clean multiple directories in one command
Installation
Add this to your Cargo.toml:
[dependencies]
# or install with: cargo install cargo-cleanup
Or install directly from source:
cargo install --path .
Usage
Basic usage
Clean the current directory and all subdirectories:
cargo slim
Clean specific directories
cargo slim path/to/project1 path/to/project2
Preview changes with dry-run
cargo slim --dry-run
Get help
cargo slim --help
How it works
cargo-cleanup recursively searches for Cargo.toml files in the specified paths (or current directory by default) and runs cargo clean in each project found. This removes target/ directories and other build artifacts, freeing up disk space.
Examples
# Clean current project and any nested workspaces
cargo slim
# Clean your entire ~/projects directory
cargo slim ~/projects
# See what would be deleted without actually deleting
cargo slim ~/projects --dry-run
# Clean multiple locations at once
cargo slim ~/work ~/hobby-projects
License
MIT