zope.app.schema 5.0

Component Architecture based Vocabulary Registry

This package provides a component architecture based vocabulary registry.

Component-based Vocabulary Registry

This package provides a vocabulary registry for zope.schema, based on the component architecture.

NOTE: This functionality has been replaced with zope.vocabularyregistry. These imports continue to work for backwards compatibility.

It replaces the zope.schema’s simple vocabulary registry when zope.app.schema package is imported, so it’s done automatically. All we need is provide vocabulary factory utilities:

>>> import zope.app.schema
>>> from zope.component import provideUtility
>>> from zope.schema.interfaces import IVocabularyFactory
>>> from zope.schema.vocabulary import SimpleTerm
>>> from zope.schema.vocabulary import SimpleVocabulary

>>> def SomeVocabulary(context=None):
...     terms = [SimpleTerm(1), SimpleTerm(2)]
...     return SimpleVocabulary(terms)

>>> provideUtility(SomeVocabulary, IVocabularyFactory,
...                name='SomeVocabulary')

Now we can get the vocabulary using standard zope.schema way:

>>> from zope.schema.vocabulary import getVocabularyRegistry
>>> vr = getVocabularyRegistry()
>>> voc = vr.get(None, 'SomeVocabulary')
>>> [term.value for term in voc]
[1, 2]

Configuration

This package provides configuration that sets security permissions and factories for the objects provided in zope.schema. The zope.security package must be installed to use it.

>>> from zope.configuration import xmlconfig
>>> _ = xmlconfig.string(r"""
... <configure xmlns="http://namespaces.zope.org/zope" i18n_domain="zope">
...   <include package="zope.app.schema" />
... </configure>
... """)

CHANGES

5.0 (2023-02-07)

• Drop support for Python 2.7, 3.5, 3.6.

• Add support for Python 3.7, 3.8, 3.9, 3.10, 3.11.

4.1.0 (2017-05-10)

• Replaced the local implementation of ZopeVocabularyRegistry with one imported from zope.vocabularyregistry. Backwards compatibility imports remain.

4.0.1 (2017-05-10)

• Packaging: Add the Python version and implementation classifiers.

4.0.0 (2017-04-17)

• Support for Python 3.5, 3.6 and PyPy has been added.

• Added support for tox.

• Drop dependency on zope.app.testing, since it was not needed.

3.6.0 (2017-04-17)

• Package modernization including manifest.

3.5.0 (2008-12-16)

• Remove deprecated vocabulary directive.

• Add test for component-based vocabulary registry.

3.4.0 (2007-10-27)

• Initial release independent of the main Zope tree.