Files
kenaito-conf/python-client
odboy 08b2ba4c25 refactor(api): fetchAllConfigs 接口从 GET 改为 POST
- 服务端: 新增 FetchAllRequest 结构体,参数通过 JSON body 传递
- 服务端: 路由从 api.GET 改为 api.POST
- Go/Python/Node.js/Java 客户端同步更新为 POST + JSON body
- 与 fetchChangedConfigs 接口风格统一,token 不再暴露在 URL 中
2026-02-20 21:18:43 +08:00
..

Kenaito Config Center Python Client

安装

cd python-client
pip3 install -e .

快速开始

from kenaito_conf import Config, ConfigClient

config = Config(
    base_url="http://localhost:8080",
    app_name="my-app",
    env="daily",
    sync_interval=30,
)

client = ConfigClient(config)

# 监听配置变更
def on_change(changed):
    for k, v in changed.items():
        print(f"config changed: {k} = {v}")

client.on_change(on_change)

# 启动客户端(拉取配置 + 开启定时同步)
client.start()

# 获取配置
value = client.get("database.host")
all_configs = client.get_all()

# 停止
client.stop()

配置项

参数 说明 默认值
base_url 配置中心地址 必填
app_name 应用名称 必填
env 环境(dev/daily/prod) dev
version 配置版本 latest
token 认证令牌 空
sync_interval 同步间隔(秒) 60
ignore_global 是否忽略全局配置 False
cache_dir 本地缓存目录 .

Demo

cd python-client-demo
pip3 install -r requirements.txt
python3 app.py

Demo 默认监听 8082 端口,访问 http://localhost:8082/ 查看配置。

环境变量覆盖:

环境变量 说明 默认值
SERVER_PORT 服务端口 8082
KENAITO_BASE_URL 配置中心地址 http://localhost:8080
KENAITO_APP_NAME 应用名称 kenaito-springboot-demo
KENAITO_PROFILE 环境 daily
KENAITO_VERSION 配置版本 latest
KENAITO_TOKEN 认证令牌 空
KENAITO_SYNC_INTERVAL 同步间隔(秒) 30
KENAITO_CACHE_DIR 缓存目录 .