z3c.appconfig 1.0

简介

此软件包提供了一种通过标准 .ini 文件配置应用程序的方法。这对于站点管理员来说很方便，因为他们比ZCML更熟悉ini文件。

创建配置文件

有两种方法可以告诉Zope实例加载哪些配置文件：zcml语句和APPCONFIG环境变量。zcml语句首先被处理，这使得覆盖标准配置成为可能。

zcml语法看起来像这样

<configure xmlns="http://namespaces.zope.org/zope">
  <include package="z3c.appconfig" file="meta.zcml"/>
  <appconfig file="default.ini" />
</configure>

这将加载default.ini的内容并将其合并到应用程序配置中。

如果设置了APPCONFIG环境变量并指向一个文件，则其内容将被合并到应用程序配置中。这是最后一步，允许您覆盖应用程序定义的默认值。例如

$ APPCONFIG=etc/mysite.ini bin/instance fg

访问配置

配置数据可以通过IAppConfig实用程序从您的代码中访问。该实用程序本质上是一个标准Python字典，用于存储所有配置数据。例如，让我们使用一个非常简单的配置文件

[site]
title = My lovely site

您可以使用以下代码从Python访问标题

from zope.component import getUtility
from z3c.appconfig.interfaces import IAppConfig

appconfig=getUtility(IAppConfig)
print "Site title is: %s" % appconfig["site"]["title"]

实用程序方法

为了方便，提供了一个实用程序方法将配置文件中的值转换为布尔值：z3c.appconfig.utils.asBool方法

from z3c.appconfig.utils import asBool
print "Pants are on: %s" % asBool("true")

变更日志