Cargo-sweep

一个用于清理由Cargo生成的未使用构建文件的cargo子命令。

动机

理想情况下，您希望：

• 缓存最近的构建产物以实现快速构建时间
• 限制目标目录大小，以便CI缓存（在Travis等上）快速
• 一种简单的方式来同时维护一个或多个项目

Cargo-sweep旨在解决所有这些问题，而简单的cargo clean不足以解决这些问题。

快速开始

要安装运行：

cargo install cargo-sweep

要清理本地Cargo项目中超过30天的所有构建文件运行：

cargo sweep --time 30

要清理不是由当前安装的（通过rustup）nightly编译器生成的所有构建文件：

cargo sweep --toolchains nightly

如果您检查了您的库在stable上工作，但主要在nightly上开发，这可能很有用。

要清理不是由任何当前安装的（通过rustup）编译器生成的所有构建文件：

cargo sweep --installed

如果您刚刚使用rustup update更新了编译器，这可能很有用。

也支持非rustup环境。如果cargo-sweep无法运行rustup，它会回退到裸rustc调用（必须安装rustc并且其路径必须通过PATH环境变量可用）。

要预览清理运行的结果，建议作为第一步，添加--dry-run标志，例如：

cargo sweep --dry-run --time 30

您还可以指定路径而不是默认为当前目录：

cargo sweep --time 30 <path>

要清理除最新构建之外的所有内容，您需要分几步运行它。

cargo sweep --stamp

<插入任意数量的cargo build、cargo test等...>

cargo sweep --file

第一步生成一个时间戳文件，该文件将用于清理在它和下次使用文件（–file）选项之间未使用的所有内容。

最后，您可以通过添加--recursive标志递归清理给定路径下的所有Cargo项目，例如：

cargo sweep --recursive --time 30 path/to/project

要获取更多信息，运行：

cargo sweep --help

许可证

Cargo-sweep根据MIT许可证的条款分发。

完整示例代码：

# 安装cargo-sweep
cargo install cargo-sweep

# 清理超过30天的构建文件（预览模式）
cargo sweep --dry-run --time 30

# 实际清理超过30天的构建文件
cargo sweep --time 30

# 清理非当前安装工具链的构建文件
cargo sweep --installed

# 清理特定工具链（如nightly）的构建文件
cargo sweep --toolchains nightly

# 在特定路径下执行清理
cargo sweep --time 30 /path/to/your/project

# 递归清理子目录中的项目
cargo sweep --recursive --time 30 /path/to/projects

# 使用时间戳标记清理（保留最新构建）
cargo sweep --stamp
# ...执行构建或测试操作...
cargo sweep --file