venusianconfiguration 1.1.2

venusianconfiguration

此包（venusianconfiguration）提供了基于venusian的Python配置语法，用于替代zope.configuration中的zcml。此包不会像以前使用的grok那样替换zope.configuration，而是仅提供对现有zope.configuration指令的通用Python绑定。因此，venusianconfiguration更像是grok的替代品，而不是zope.configuration的替代品。

此包的当前状态可以描述为已在内部使用，但可能尚未准备好供社区使用。

优点

from venusianconfiguration import configure

configure.i18n.registerTranslations(directory='locales')

@configure.browser.page.klass(
    name='hello-world', for_=Interface,
    permission='zope2.View')
class HelloWorld(BrowserView):
    def __call__(self):
        return u'Hello world!'

@configure.plone.behavior.provides(
    title=_(u'My behavior),
    description=_(u'Enables magic'))
class IMyBehavior(model.Schema):
    custom_field = schema.TextLine()
alsoProvides(IMyBehavior, IFormFieldProvider)

缺点

from venusianconfiguration import scan
from venusianconfiguration import configure

from mypackage import browser
scan(browser)

import zcmlpackage
configure.include(package=zcmlpackage)

import otherpypackage
configure.include(package=otherpypackage, file='configure.py')

import mypackage.submodule
configure.include(package=mypackage.submodule,
                  file='configure.py')

缺点

zope.configuration基本上是语法无关的，但遗憾的是，ZCML一直是它唯一的实现语法，我们也曾直接调用其ZCML特定的API（例如在测试固定装置和z3c.autoinclude中）。

因此，在没有猴子补丁的情况下，无法在zope.configuration外部引入新的zope.configuration语法...

venusianconfiguration通过猴子补丁在zope.configuration的ZCML支持中的processxmlfile方法工作，使其也能接受Python文件，并将这些文件传递给venusianconfiguration进行处理。

为了支持z3c.autoinclude，venusianconfiguration还通过猴子补丁修改了z3c.autoinclude的includePluginsDirective和includePluginsOveridesDirective（includeDependencies-directive被认为很邪恶，并且故意不支持）。

因此，总共为无ZCML配置进行了三个猴子补丁。

[instance]
recipe = plone.recipe.zope2instance
...
eggs =
    ...
    venusianconfiguration
zope-conf-additional =
    # Enable venuasianconfiguration monkeypatches
    %import venusianconfiguration

setup(
    ...
    namespace_packages=['my'],
    ...
 )

setup(
    ...
    entry_points="""
    # -*- Entry points: -*-
    [z3c.autoinclude.plugin]
    target = plone
    """
)

[instance]
recipe=plone.recipe.zope2instance
...
zcml = my.product

变更日志