jsonconfig-tool 1.5

它是用来干什么的？

• 管理设置、配置信息、应用程序数据等
• 管理机密、令牌、密钥、密码等。
• 管理环境设置。

基本示例

with Config('myapp') as cfg:
    cfg.data = 'Any JSON serializable object ...'
    cfg.pwd.a_secret = 'Encrypted data ...'
    cfg.env.a_variable = 'Environment variables.'

其他示例可以在documentation[1]中找到。

只是头脑清醒

no magic here…

配置文件位置

Click[2]是用于确定默认应用程序目录的包

默认行为是返回最适合 操作系统。为了给你一个主意，一个名为Foo Bar的应用程序 可能返回以下内容：

Mac OS X:
~/Library/Application Support/Foo Bar

Mac OS X (POSIX):
~/.foo-bar

Unix:
~/.config/foo-bar

Unix (POSIX):
~/.foo-bar

Win XP (roaming):
C:\Documents and Settings\<user>\Local Settings\Application Data\Foo Bar

Win XP (not roaming):
C:\Documents and Settings\<user>\Application Data\Foo Bar

Win 7+ (roaming):
C:\Users\<user>\AppData\Roaming\Foo Bar

Win 7+ (not roaming):
C:\Users\<user>\AppData\Local\Foo Bar

当然，您或用户可以自由重写此行为并设置 去你想去的地方。

加密后端

Keyring[3]是用于管理加密的包。

默认行为是选择 用户平台为了给你一个主意，下面的钥匙圈后端将 可能被退回：

Mac OS X:

Keychain[5]

Unix（安装了secretstorage）：

Secret Service[6]

Unix（已安装DBU）：

kwallet[7]

窗口：

Windows Credential Locker[8]

当然，您或用户可以自由覆盖默认值用户可以 同时从系统范围内更改其keyring后端首选项 命令行或通过配置文件。然后json配置将使用 用户首选的密钥环后端，除非另有说明

您希望如何提供您的数据？

Box[4]是用于处理数据访问包装器的包

普通的

没有包装有机的，自由范围的数据。如果它是JSON可序列化的 我们会处理的这是默认设置。

盒装

在Box[4]；一个同时支持这两种功能的Python字典中交付数据 递归点表示法访问和标准字典键访问。如果 你害怕被boxed in，不要惊慌！你可以进去 随时可用，请参阅下面的数据转换部分。

冻结

在aFrozen Box中ICES数据，与装箱的数据相同，但不可变；将 如果其中的所有对象都是不可变的，也可以进行哈希运算。

嵌套

将数据嵌套在默认字典中，该字典可以自动创建 缺少中间密钥。找回的时候也很宽容 字典中的数据；例如，如果密钥 不存在。相反，它将不返回任何值；即使键是嵌套的 多个键丢失。

数据转换

• BOXED、FROZEN和NESTED都是dicts或 默认指令你可以在他们之间来回转换 时间。
• 如果您的数据对象不是 一个映射然后使用PLAIN来释放所有的装饰。 有了PLAIN，就只有你和你的伙伴python了；我们让开。

参考文献