core.config_center

统一配置中心 - 实现中心化配置管理

提供统一的配置访问、监控、热更新和验证功能。 支持多环境配置、运行时配置更新和配置变更监听。

Functions

get_config_center([base_config_path, ...])

获取全局配置中心实例

init_config_center([base_config_path, ...])

初始化全局配置中心

Classes

ConfigCenter([base_config_path, ...])

统一配置中心

ConfigChangeEvent(key, old_value, new_value)

配置变更事件

ConfigWatcher(config_center)

配置文件监听器

class core.config_center.ConfigChangeEvent(key, old_value, new_value, timestamp=None)[source]

Bases: object

配置变更事件

__init__(key, old_value, new_value, timestamp=None)[source]
class core.config_center.ConfigWatcher(config_center)[source]

Bases: FileSystemEventHandler

配置文件监听器

__init__(config_center)[source]
on_modified(event)[source]

文件修改事件处理

class core.config_center.ConfigCenter(base_config_path='./config', environment='default', watch_changes=True)[source]

Bases: object

统一配置中心

提供配置管理、监控、热更新和验证功能。 支持多环境配置和运行时配置变更。

__init__(base_config_path='./config', environment='default', watch_changes=True)[source]

初始化配置中心

Parameters:
  • base_config_path (str) – 配置文件基础路径

  • environment (str) – 环境名称 (default, development, production等)

  • watch_changes (bool) – 是否监听配置文件变更

get_config()[source]

获取完整配置

get_value(key_path, default=None)[source]

获取配置值

Parameters:
  • key_path (str) – 配置键路径 (如 “storage.base_path”)

  • default (Any) – 默认值

Returns:

配置值

Return type:

Any

set_value(key_path, value, persist=True)[source]

设置配置值

Parameters:
  • key_path (str) – 配置键路径

  • value (Any) – 新值

  • persist (bool) – 是否持久化到文件

Returns:

是否成功设置

Return type:

bool

add_change_listener(listener)[source]

添加配置变更监听器

remove_change_listener(listener)[source]

移除配置变更监听器

get_environment_config(environment)[source]

获取特定环境的配置

switch_environment(environment)[source]

切换环境配置

get_stats()[source]

获取配置中心统计信息

validate_current_config()[source]

验证当前配置

backup_config(backup_path=None)[source]

备份当前配置

restore_config(backup_path)[source]

从备份恢复配置

close()[source]

关闭配置中心

core.config_center.get_config_center(base_config_path='./config', environment=None)[source]

获取全局配置中心实例

Parameters:
  • base_config_path (str) – 配置文件基础路径

  • environment (str | None) – 环境名称

Returns:

配置中心实例

Return type:

ConfigCenter

core.config_center.init_config_center(base_config_path='./config', environment=None, watch_changes=True)[source]

初始化全局配置中心

Parameters:
  • base_config_path (str) – 配置文件基础路径

  • environment (str | None) – 环境名称

  • watch_changes (bool) – 是否监听文件变更

Returns:

配置中心实例

Return type:

ConfigCenter