无痛苦的YAML配置。
项目描述
Confuse 是一个用于Python的配置库,它使用 YAML。它负责默认值、覆盖、类型检查、命令行集成、环境变量支持、可读性错误和标准OS特定位置。
它能做什么
以下是Confuse带来的好处
一个 非常合理的API,类似于字典和列表结构,但提供 透明验证,无需大量样板代码。输入 config['num_goats'].get(int) 来获取配置的山羊数量并确保它是一个整数。
从 多个来源 组合配置数据。使用 分层,Confuse 允许用户特定配置无缝覆盖全局配置,后者又覆盖内置默认值。包内的 config_default.yaml 可以使用与用户将看到相同的语法来提供底层默认值。运行时覆盖允许程序以编程方式覆盖和添加配置值。
在 平台特定的路径 中查找配置文件。例如,Unix上的 $XDG_CONFIG_HOME 或 ~/.config;macOS上的“应用程序支持”;Windows上的 %APPDATA%。您的程序将获得自己的目录,您可以使用它来存储其他数据。如果您需要初始化配置文件,例如首次运行,可以透明地按需创建此目录。并且可以使用环境变量来覆盖目录的位置。
通过标准库中的 argparse 或 optparse 与命令行参数集成。使用 argparse 的声明式 API 允许命令行选项覆盖配置默认值。
包含来自 环境变量 的配置值。值会进行自动类型转换,并支持嵌套字典和列表。
安装
Confuse 可在 PyPI 上找到,可以使用 pip
进行安装。
pip install confuse
使用 Confuse
Confuse 的文档 详细描述了其 API。
致谢
关闭
confuse-2.0.1.tar.gz 的散列
算法 | 散列摘要 | |
---|---|---|
SHA256 | 7379a2ad49aaa862b79600cc070260c1b7974d349f4fa5e01f9afa6c4dd0611f |
|
MD5 | 8aa2b5c90e884af2c8f4b65f3e8d574e |
|
BLAKE2b-256 | a77705e2284baff5f2106f74b528b9930caf764d6c400733eb42e617c4234a7d |
关闭
confuse-2.0.1-py3-none-any.whl 的散列
算法 | 散列摘要 | |
---|---|---|
SHA256 | 9b9e5bbc70e2cb9b318bcab14d917ec88e21bf1b724365e3815eb16e37aabd2a |
|
MD5 | a86739f764dbfa6e37a09e8e9828dc50 |
|
BLAKE2b-256 | 321fcf496479814d41fc252004482deeb90b740b4a6a391a3355c0b11d7e0abf |