GooglePhotosTakeoutHelper 项目使用教程

1. 项目的目录结构及介绍

GooglePhotosTakeoutHelper/
├── google_photos_takeout_helper/
│   ├── __init__.py
│   ├── main.py
│   ├── utils.py
│   ├── exif_utils.py
│   ├── date_utils.py
│   └── ...
├── tests/
│   ├── test_main.py
│   ├── test_utils.py
│   └── ...
├── README.md
├── LICENSE
├── setup.py
└── requirements.txt

目录结构介绍

• google_photos_takeout_helper/: 项目的主要代码目录，包含所有核心功能的实现。

  • __init__.py: 初始化文件，用于定义包的结构。
  • main.py: 项目的启动文件，包含主要的逻辑和命令行接口。
  • utils.py: 包含各种工具函数，用于辅助处理照片和文件。
  • exif_utils.py: 处理照片的EXIF数据。
  • date_utils.py: 处理照片的日期和时间信息。
  • ...: 其他辅助文件和模块。

• tests/: 包含项目的单元测试文件，用于确保代码的正确性和稳定性。

  • test_main.py: 测试 main.py 中的功能。
  • test_utils.py: 测试 utils.py 中的功能。
  • ...: 其他测试文件。

• README.md: 项目的说明文档，包含项目的介绍、安装方法、使用方法等。

• LICENSE: 项目的开源许可证文件。

• setup.py: 用于安装项目的脚本。

• requirements.txt: 项目依赖的Python包列表。

2. 项目的启动文件介绍

main.py

main.py 是项目的启动文件，负责处理命令行参数并调用相应的功能模块来组织和整理Google Photos Takeout的文件。

主要功能

• 命令行参数解析: 使用 argparse 模块解析用户输入的命令行参数，如输入文件夹、输出文件夹、日期分割等。
• 文件处理: 调用 utils.py 和 exif_utils.py 中的函数，处理照片文件，设置正确的EXIF数据和最后修改时间。
• 日志记录: 记录处理过程中的日志信息，方便用户查看处理进度和错误信息。

使用方法

python main.py -i [INPUT_FOLDER] -o [OUTPUT_FOLDER] [--divide-to-dates]

• -i [INPUT_FOLDER]: 指定Google Photos Takeout的输入文件夹。
• -o [OUTPUT_FOLDER]: 指定整理后的输出文件夹。
• --divide-to-dates: 可选参数，用于按年月分割照片文件夹。

3. 项目的配置文件介绍

requirements.txt

requirements.txt 文件列出了项目运行所需的Python包及其版本。用户可以通过以下命令安装这些依赖：

pip install -r requirements.txt

setup.py

setup.py 文件用于项目的安装和分发。用户可以通过以下命令安装项目：

pip install .

LICENSE

LICENSE 文件包含了项目的开源许可证信息，通常为Apache 2.0许可证。

README.md

README.md 文件是项目的说明文档，包含了项目的介绍、安装方法、使用方法、贡献指南等信息。用户在开始使用项目之前，应仔细阅读此文件。

---

通过以上内容，您可以了解 GooglePhotosTakeoutHelper 项目的基本结构、启动文件和配置文件的使用方法。希望这份教程对您有所帮助！