Garmin Connect 数据导出工具使用教程
1. 项目的目录结构及介绍
Garmin Connect 数据导出工具的目录结构如下:
garmin-connect-export/
├── README.md
├── garmin.py
├── config.py
├── requirements.txt
└── tests/
└── test_garmin.py
README.md
: 项目说明文档,包含项目的基本介绍和使用方法。garmin.py
: 主程序文件,负责与 Garmin Connect 进行交互并导出数据。config.py
: 配置文件,包含用户登录信息和其他配置选项。requirements.txt
: 项目依赖的 Python 包列表。tests/
: 测试文件夹,包含测试脚本test_garmin.py
。
2. 项目的启动文件介绍
项目的启动文件是 garmin.py
。该文件包含了主要的逻辑代码,用于连接到 Garmin Connect 并导出用户的活动数据。以下是 garmin.py
的主要功能模块:
main()
: 主函数,负责处理命令行参数并调用其他函数执行数据导出。login()
: 登录 Garmin Connect 的函数。fetch_activities()
: 获取用户活动数据的函数。export_activities()
: 导出活动数据的函数。
3. 项目的配置文件介绍
配置文件是 config.py
,它包含了用户登录 Garmin Connect 所需的账号和密码信息。以下是 config.py
的主要内容:
# config.py
# 用户登录信息
USERNAME = 'your_username'
PASSWORD = 'your_password'
# 其他配置选项
EXPORT_DIR = 'exported_data'
LOG_LEVEL = 'INFO'
USERNAME
: 用户的 Garmin Connect 账号。PASSWORD
: 用户的 Garmin Connect 密码。EXPORT_DIR
: 导出的数据存放目录。LOG_LEVEL
: 日志级别,用于控制日志输出的详细程度。
通过修改 config.py
文件中的配置项,用户可以自定义数据导出的行为和输出目录。