# Python配置文件热更新

**Repository Path**: dragonlord/HotConfigPy

## Basic Information

- **Project Name**: Python配置文件热更新
- **Description**: Python配置文件热更新项目，实现运行时动态修改配置，无需重启应用，提升开发与运维效率。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-16
- **Last Updated**: 2025-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python配置文件热更新

## 介绍
Python配置文件热更新项目，实现运行时动态修改配置，无需重启应用，提升开发与运维效率。

## 软件架构
本项目基于Python语言，使用`watchdog`库监控文件系统变化，实现配置文件的动态加载。主要包含以下组件：
- `Config` 类：负责配置文件的加载与重新加载。
- `ConfigChangeHandler` 类：监听文件变化事件，触发配置重载。
- `main()` 函数：程序入口，启动文件监控并持续输出当前配置。

## 安装教程
1. 安装依赖库：
   ```bash
   pip install watchdog
   ```

2. 将 `HotConfigPy.py` 文件放置到项目目录中。

3. 创建配置文件 `config.json`，示例内容如下：
   ```json
   {
     "version": "1.0",
     "num": 0,
     "debug": true
   }
   ```

## 使用说明
1. 运行程序：
   ```bash
   python HotConfigPy.py
   ```

2. 程序运行期间，修改 `config.json` 文件内容，程序会自动检测到变化并重新加载配置。

3. 控制台将持续输出当前配置内容，如：
   ```
   Current config: 1.0, 1，True
   ```

## API说明
- `Config(filepath)`：初始化配置对象，加载指定路径的配置文件。
- `config.get(key, default)`：获取配置项，若不存在则返回默认值。
- `reload_config()`：手动触发配置重载。

## 参与贡献
1. Fork 本仓库。
2. 新建 Feat_xxx 分支。
3. 提交代码。
4. 新建 Pull Request。

## 许可证
本项目遵循 MIT License，详细信息请查看 [LICENSE](LICENSE) 文件。

## 特技
1. 使用 Readme_XXX.md 来支持不同的语言，例如 Readme_en.md, Readme_zh.md。
2. 更多开源项目请访问 [Gitee Explore](https://gitee.com/explore)。