Skip to main content

Experiment for configuring with venusian instead of *.zcml

Project description

venusianconfiguration

This package (venusianconfiguration) provides venusian based Python configuration syntax for zope.configuration as an alternative to zcml. This package does not replace zope.configuration like grok used to do, but just provides generic Python bindings for existing zope.configuration directives. So, venusianconfiguration is more an alternative to grok than it is to zope.configuration.

The current status of this package can be described as already in internal use, but maybe not yet ready for the community.

https://travis-ci.org/datakurre/collective.venusianconfig.png

The good:

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)

The bad:

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')

The ugly:

zope.configuration is mostly syntax-agnostic, but unfortunately ZCML has been the only implemented syntax for it and we have also used to call its ZCML-specific API directly (e.g. in test fixtures and in z3c.autoinclude).

Therefore a new zope.configuration syntax cannot be introduced outside zope.configuration without monkeypatching…

venusianconfiguration works by monkeypatching the processxmlfile method in zope.configuration’s ZCML-support to accept also Python files pass those to venusianconfiguration to process.

To support z3c.autoinclude, venusianconfiguration also monkeypatches z3c.autoincludes’s includePluginsDirective and includePluginsOveridesDirective (includeDependencies-directive is considered evil and is intentionally left unsupported).

So, three monkeypatches in total for zcml-free configuration.

Usage

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

For more examples, look into the demo-package included in the sources.

Troubleshooting

Because the configuration now written in Python, your add-on must have its namespaces packages properly defined in its setup.py. E.g. add-on called my.product would have following namespace package definition:

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

Even there’s no ZCML, the add-on must be registered to be configured. This can be done by adding the usual z3c.autoinclude-entrypoint into add-on’s setup.py:

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

An alternative would be to add the package into the zcml-option of your Plone instance’s buildout-part for plone.recipe.zope2instance:

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

Changelog

1.1.2 (2021-09-01)

  • Fix issue where PEP 320 hook failed on Plone 5.2 because dummy component.xml was returned as string instead of bytes [datakurre]

1.1.1 (2018-11-07)

  • Add faceted namespace [datakurre]

1.1.0 (2018-01-17)

  • Drop z3c.autoinclude plugin entrypoint for plone to fix issues with where z3c.autoinclude included wrong packages on and pip-installed Plone. This will disable the experimental ZCML directives from meta.zcml to be loaded by default with Plone. [datakurre]

1.0.2 (2017-12-21)

  • Fix issue where default configuration directive being mutable caused unexpected behavior [datakurre]

1.0.1 (2016-09-21)

  • Fix issue where zope.deferredimported module was not recognized as module [datakurre]

1.0.0 (2016-04-19)

  • First release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

venusianconfiguration-1.1.2.tar.gz (13.8 kB view details)

Uploaded Source

Built Distribution

venusianconfiguration-1.1.2-py2.py3-none-any.whl (9.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file venusianconfiguration-1.1.2.tar.gz.

File metadata

  • Download URL: venusianconfiguration-1.1.2.tar.gz
  • Upload date:
  • Size: 13.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/47.3.1.post20210326 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.10

File hashes

Hashes for venusianconfiguration-1.1.2.tar.gz
Algorithm Hash digest
SHA256 2c63f18390b71ba2e34d095bb7274204b418e44b9a824804746cff3f399843d3
MD5 f5257ffdd2f2aea772ba3fb9c8012b79
BLAKE2b-256 2c947dab90aebb095b4a8a91d097160bf961b67530f48ba9a5c360e2b83bbcd2

See more details on using hashes here.

File details

Details for the file venusianconfiguration-1.1.2-py2.py3-none-any.whl.

File metadata

  • Download URL: venusianconfiguration-1.1.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 9.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/47.3.1.post20210326 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.10

File hashes

Hashes for venusianconfiguration-1.1.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 e9b0bb14f0b511c36c2534d2cf24a32e6401c810a1bd1c1784386828cc16c482
MD5 b1e9b900caaa039b71beec142bcae07c
BLAKE2b-256 8ebfd619716d51faa7da1d728601e1e850bb31fcae2242c1efc3721940246339

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page