【亲测免费】 FreeReNamer 使用教程

1. 项目目录结构及介绍

FreeReNamer/
├── README.md          # 项目简介和指南
├── src/                # 源代码目录
│   ├── main.py         # 主程序入口
│   └── config.yaml     # 配置文件
├── requirements.txt    # 依赖库列表
├── data/               # 可选的数据或模板文件
└── tests/              # 单元测试目录

• README.md: 包含项目说明和快速入门指导。
• src/main.py: 项目的启动脚本，负责执行重命名操作。
• config.yaml: 用户配置文件，用于设置重命名规则等参数。
• requirements.txt: 列出所有必要的Python库，用于安装依赖。
• data/: 存放任何与重命名操作相关的数据，例如模板或其他资源。
• tests/: 包含项目单元测试，确保代码功能正确性。

2. 项目启动文件介绍

src/main.py

main.py是FreeReNamer的核心启动文件。它的主要任务包括：

• 加载配置文件config.yaml中的设置。
• 处理命令行参数，如输入目录、输出目录等。
• 初始化重命名规则并应用到指定的文件或目录。
• 输出重命名结果。

要运行该项目，你可以使用以下命令（假设已经将项目克隆到本地并激活了虚拟环境）：

python src/main.py -i /path/to/input -o /path/to/output

其中-i和-o分别代表输入目录和输出目录，可以根据实际需求调整。

3. 项目配置文件介绍

config.yaml

配置文件config.yaml允许用户自定义重命名规则。典型的配置可能包括以下几个部分：

rules:
  - name: "添加前缀"
    action: "prepend"
    value: "renamed_"

  - name: "替换扩展名"
    action: "replace_extension"
    new_extension: "txt"

parameters:
  input_directory: "./input"       # 默认输入目录
  output_directory: "./output"     # 默认输出目录
  dry_run: false                    # 是否进行模拟运行，不实际修改文件

• rules: 规则集合，每个规则包含一个名字（name），一个动作（action），以及动作相关的值。目前支持的动作有prepend(在文件名前添加)、append(在文件名后添加)和replace_extension(替换文件扩展名)。
• parameters: 设置全局参数，如默认输入目录、输出目录和是否进行干燥运行（dry_run）。

根据需要，你可以修改这个文件来适应不同的重命名场景。记住，修改后需要重新运行main.py以应用新的配置。

请按照上述步骤和配置文件说明使用FreeReNamer进行文件批量重命名，如有其他疑问，欢迎继续提问。