docs.rs failed to build purger-gui-0.4.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

Visit the last successful build: purger-gui-0.4.1

Rust Project Purger

一个用于清理Rust项目构建目录的工具，支持CLI和GUI两种界面。

功能特性

🔍 智能扫描: 递归扫描目录下的所有Rust项目
🧹 多种清理策略: 支持cargo clean和直接删除两种方式
📊 大小统计: 显示每个项目的target目录大小
✅ 选择性清理: 可以选择要清理的特定项目
🖥️ 双界面: 提供命令行和图形界面两种使用方式
🚀 并行处理: 支持并行扫描和清理以提高效率
⏰ 时间过滤: 保留最近编译的项目，避免清理正在使用的项目
📏 大小过滤: 保留小于指定大小的target目录
📁 路径忽略: 支持忽略特定目录，避免误删重要项目
💾 可执行文件备份: 在清理前自动备份编译好的可执行文件

项目结构

purger/
├── purger-core/     # 核心逻辑库
├── purger-cli/      # 命令行界面
├── purger-gui/      # 图形界面
└── README.md

安装

从 crates.io 安装 (推荐)

# 安装命令行版本

cargo install purger-cli


# 安装图形界面版本

cargo install purger-gui


# 或者安装完整包

cargo install purger

从源码编译

# 安装 CLI 版本

cargo install purger


# 安装包含 GUI 的完整版本

cargo install purger --features gui

安装后可以直接使用：

# CLI 版本

purger scan

purger clean --all


# GUI 版本 (如果安装了 gui 功能)

purger-gui

从源码构建

git clone <repository-url>
cd purger

cargo build --release

构建完成后，可执行文件位于：

CLI版本: target/release/purger
GUI版本: target/release/purger-gui

使用方法

命令行界面 (CLI)

扫描项目

# 扫描当前目录

purger scan


# 扫描指定目录

purger scan /path/to/projects


# 只显示有target目录的项目

purger scan --target-only


# 按大小排序

purger scan --sort-by-size


# 限制扫描深度

purger scan --max-depth 5


# 使用过滤选项

purger scan --keep-days 7 --keep-size 10MB --ignore ~/Downloads

清理项目

# 清理当前目录下的所有项目

purger clean


# 预览清理操作（不实际删除）

purger clean --dry-run


# 使用直接删除策略

purger clean --strategy delete


# 跳过确认提示

purger clean --yes


# 清理指定目录

purger clean /path/to/projects


# 使用过滤和备份选项

purger clean --keep-days 7 --keep-size 10MB --keep-executable --ignore ~/Downloads

新增命令行选项

扫描过滤选项:

--keep-days <DAYS>: 保留最近N天编译的项目
--keep-size <SIZE>: 保留target目录小于指定大小的项目 (如: 10MB, 1GB)
--ignore <PATH>: 忽略特定目录 (可多次使用)

清理选项:

--keep-executable: 保留可执行文件 (自动备份)
--executable-backup-dir <DIR>: 指定可执行文件备份目录

通用选项:

--verbose, -v: 显示详细日志
--debug, -d: 显示调试日志
--help, -h: 显示帮助信息

图形界面 (GUI)

运行GUI版本：

purger-gui

GUI功能：

设置扫描路径和深度
实时显示扫描进度
可视化项目列表和大小
选择性清理项目
显示清理结果统计
过滤选项配置 (时间、大小、忽略路径)
可执行文件备份设置
多语言支持

清理策略

Cargo Clean (推荐)

使用cargo clean命令清理
更安全，只删除Cargo生成的构建产物
保留用户手动放入target的文件
正确处理工作空间依赖

直接删除

直接删除整个target目录
速度更快，但可能删除非Cargo文件
适用于确定target目录只包含构建产物的情况

配置

扫描配置

max_depth: 最大扫描深度（默认10层）
follow_links: 是否跟随符号链接（默认false）
respect_gitignore: 是否遵循.gitignore规则（默认true）
ignore_hidden: 是否忽略隐藏文件（默认true）
keep_days: 保留最近N天编译的项目（可选）
keep_size: 保留小于指定大小的target目录（可选）
ignore_paths: 忽略的路径列表（可选）

清理配置

strategy: 清理策略（cargo/delete）
dry_run: 预览模式（默认false）
parallel: 并行处理（默认true）
keep_executable: 是否保留可执行文件（默认false）
executable_backup_dir: 可执行文件备份目录（可选）

开发

运行测试

cargo test

运行CLI版本

cargo run --bin purger -- scan

运行GUI版本

cargo run --bin purger-gui

代码结构

purger-core

核心功能库，包含：

ProjectScanner: 项目扫描器
ProjectCleaner: 项目清理器
ProjectFilter: 项目过滤器
RustProject: 项目信息结构
工具函数和类型定义

purger-cli

命令行界面，使用clap进行参数解析。

purger-gui

图形界面，使用egui框架构建。

依赖

主要依赖：

walkdir: 目录遍历
ignore: .gitignore支持
clap: 命令行参数解析
egui/eframe: GUI框架
tokio: 异步运行时
rayon: 并行处理
anyhow: 错误处理

许可证

MIT OR Apache-2.0

贡献

欢迎提交Issue和Pull Request！

注意事项

清理操作不可逆，请谨慎使用
建议先使用--dry-run预览清理结果
大型项目清理可能需要较长时间
确保有足够的权限访问目标目录

purger-gui 0.4.0