文件聚合器 (fileagg)

欢迎使用 fileagg，终极文件聚合工具！如果您曾经需要轻松地将目录中的多个文件合并到一个文件中，fileagg 就是您的首选解决方案。具有尊重 .gitignore、排除 node_modules 以及支持多种输出选项等功能，fileagg 使文件管理变得轻而易举。

功能

• 聚合文件内容：将目录中所有文件的内容合并到一个文件中。
• 尊重 .gitignore：自动跳过 .gitignore 中列出的文件。
• 排除 node_modules：不再需要在聚合输出中有不必要的冗余。
• 灵活的输出选项：保存到文件、打印到控制台或直接复制到剪贴板。
• 包含隐藏文件：可选地包含聚合中的隐藏文件。
• 按文件类型筛选：仅聚合您关心的特定文件类型。
• 进度指示：在处理文件时查看实时进度。

安装

先决条件

确保您的系统已安装 Rust 和 Cargo。

通过 Cargo 安装

要作为 Cargo 包安装 fileagg，请运行以下命令

cargo install fileagg

本地构建

如果您想从源代码构建 fileagg

1. 克隆存储库或下载源代码。

2. 导航到项目目录

   cd path/to/your/fileagg
   

3. 本地构建和安装

   cargo install --path .
   

用法

默认行为

默认情况下，fileagg 将聚合当前目录中的文件，并将输出保存到 fileagg_output.txt。

fileagg

命令和选项

1. 指定目录

从特定目录聚合文件

fileagg /path/to/directory

2. 指定输出文件

自定义输出文件的位置和名称

fileagg --output result.txt

此命令将输出保存到 result.txt。

3. 打印到标准输出

将聚合的内容打印到控制台

fileagg --stdout

4. 复制到剪贴板

将聚合的内容复制到您的剪贴板

fileagg --clipboard

5. 包含隐藏文件

要包含隐藏文件（例如，.env，.gitignore）

fileagg --include-hidden

6. 忽略.gitignore规则

如果您想忽略.gitignore规则并包含所有文件

fileagg --no-ignore

7. 按文件类型过滤

仅聚合特定文件类型

fileagg --file-types rs,js,py

示例命令

1. 聚合当前目录中的所有文件并保存到fileagg_output.txt

   fileagg
   

2. 从特定目录聚合文件并保存到custom_output.txt

   fileagg /path/to/directory --output custom_output.txt
   

3. 包含隐藏文件并将输出打印到控制台

   fileagg --include-hidden --stdout
   

4. 聚合特定文件类型并将内容复制到剪贴板

   fileagg --file-types md,txt --clipboard
   

注意

• Node模块排除：fileagg自动跳过node_modules目录中的文件。
• 默认输出：如果没有指定输出方法，结果将保存到fileagg_output.txt。
• 安全第一：确保输出文件不在要聚合的文件列表中，以防止覆盖。

贡献

我们欢迎贡献！请随时提交问题、拉取请求或改进建议。

许可

本项目采用MIT许可协议 - 详细内容请参阅LICENSE文件。

联系方式

如有疑问或反馈，请联系simplysabir。