plone.registry 1.1.3

Creating a record

The supported field types are found in the module plone.registry.field. These are named the same as the equivalent field in zope.schema, and have the same constructors. You must use one of these fields when creating records directly:

>>> from plone.registry import field
>>> age_field = field.Int(title=u"Age", min=0, default=18)

>>> from plone.registry import Record
>>> age_record = Record(age_field)

Note that in this case, we did not supply a value. The value will therefore be the field default:

>>> age_record.value
18

We can set a different value, either in the Record constructor or via the value attribute:

>>> age_record.value = 2
>>> age_record.value
2

Note that the value is validated against the field:

>>> age_record.value = -1  # doctest: +SKIP_PYTHON_3
Traceback (most recent call last):
...
TooSmall: (-1, 0)

>>> age_record.value = -1  # doctest: +SKIP_PYTHON_2
Traceback (most recent call last):
...
zope.schema._bootstrapinterfaces.TooSmall: (-1, 0)

>>> age_record.value
2

We can now add the field to the registry. This is done via the record dictionary:

>>> 'plone.registry.tests.age' in registry
False
>>> registry.records['plone.registry.tests.age'] = age_record

At this point, the record will gain __name__ and __parent__ attributes:

>>> age_record.__name__
'plone.registry.tests.age'

>>> age_record.__parent__ is registry
True

Creating a record with an initial value

We can create records more succinctly in one go by

1. creating the field,

2. creating the Record and setting its value as and

3. assigning it to the registry,

like this:

>>> registry.records['plone.registry.tests.cms'] = \
...     Record(field.TextLine(title=u"CMS of choice"), u"Plone")

The record can now be obtained. Note that it has a nice __repr__ to help debugging.

>>> registry.records['plone.registry.tests.cms']
<Record plone.registry.tests.cms>

Accessing and manipulating record values

Once a record has been created and added to the registry, you can access its value through dict-like operations on the registry itself:

>>> 'plone.registry.tests.cms' in registry
True

>>> registry['plone.registry.tests.cms']  # doctest: +IGNORE_U
u'Plone'

>>> registry['plone.registry.tests.cms'] = u"Plone 3.x"

Again, values are validated:

>>> registry['plone.registry.tests.cms'] = b'Joomla'  # doctest: +SKIP_PYTHON_3
Traceback (most recent call last):
...
WrongType: ('Joomla', <type 'unicode'>...)

>>> registry['plone.registry.tests.cms'] = b'Joomla'  # doctest: +SKIP_PYTHON_2
Traceback (most recent call last):
...
zope.schema._bootstrapinterfaces.WrongType: (b'Joomla', <class 'str'>, 'value')

There is also a get() method:

>>> registry.get('plone.registry.tests.cms')  # doctest: +IGNORE_U
u'Plone 3.x'
>>> registry.get('non-existent-key') is None
True

Deleting records

Records may be deleted from the records property:

>>> del registry.records['plone.registry.tests.cms']
>>> 'plone.registry.tests.cms' in registry.records
False
>>> 'plone.registry.tests.cms' in registry
False

Accessing the original interface

Now that we have these records, we can look up the original interface. This does not break the golden rules: internally, we only store the name of the interface, and resolve it at runtime.

Records that know about interfaces are marked with IInterfaceAwareRecord and have two additional properties: interface and fieldName:

>>> from plone.registry.interfaces import IInterfaceAwareRecord
>>> IInterfaceAwareRecord.providedBy(age_record)
False
>>> IInterfaceAwareRecord.providedBy(sender_record)
True

>>> sender_record.interfaceName
'plone.registry.tests.IMailSettings'

>>> sender_record.interface is IMailSettings
True

Using the records proxy

Once the records for an interface has been created, it is possible to obtain a proxy object that provides the given interface, but reads and writes its values to the registry. This is useful, for example, to create a form using zope.formlib or z3c.form that is configured with widgets based on the interface. Or simply as a more convenient API when working with multiple, related settings.

>>> proxy = registry.forInterface(IMailSettings)
>>> proxy
<RecordsProxy for plone.registry.tests.IMailSettings>

If you use your registry values in code which might be encountered on normal HTML rendering paths (e.g. in a viewlet) you need to be aware that records might not exist or they are invalid. forInterface() will raise KeyError on this kind of situations:

try:
    proxy = registry.forInterface(IMailSettings)
except KeyError:
    # Gracefully handled cases
    # when GenericSetup installer has not been run or rerun
    # e.g. by returning or using some default values
    pass

The proxy is not a persistent object on its own:

>>> from persistent.interfaces import IPersistent
>>> IPersistent.providedBy(proxy)
False

It does, however, provide the requisite interface:

>>> IMailSettings.providedBy(proxy)
True

You can distinguish between the proxy and a ‘normal’ object by checking for the IRecordsProxy marker interface:

>>> from plone.registry.interfaces import IRecordsProxy
>>> IRecordsProxy.providedBy(proxy)
True

When we set a value, it is stored in the registry:

>>> proxy.smtp_host = 'http://mail.server.com'
>>> registry['plone.registry.tests.IMailSettings.smtp_host']
'http://mail.server.com'

>>> registry['plone.registry.tests.IMailSettings.smtp_host'] = 'smtp://mail.server.com'
>>> proxy.smtp_host
'smtp://mail.server.com'

Values not in the interface will raise an AttributeError:

>>> proxy.age
Traceback (most recent call last):
...
AttributeError: age

Note that by default, the forInterface() method will check that the necessary records have been registered. For example, we cannot use any old interface:

>>> registry.forInterface(IInterfaceAwareRecord)
Traceback (most recent call last):
...
KeyError: 'Interface `plone.registry.interfaces.IInterfaceAwareRecord` defines a field `...`, for which there is no record.'

By default, we also cannot use an interface for which only some records exist:

>>> registry.forInterface(IMailPreferences)
Traceback (most recent call last):
...
KeyError: 'Interface `plone.registry.tests.IMailPreferences` defines a field `settings`, for which there is no record.'

It is possible to disable this check, however. This will be a bit more efficient:

>>> registry.forInterface(IMailPreferences, check=False)
<RecordsProxy for plone.registry.tests.IMailPreferences>

A better way, however, is to explicitly declare that some fields are omitted:

>>> pref_proxy = registry.forInterface(IMailPreferences, omit=('settings',))

In this case, the omitted fields will default to their ‘missing’ value:

>>> pref_proxy.settings ==  IMailPreferences['settings'].missing_value
True

However, trying to set the value will result in a AttributeError:

>>> pref_proxy.settings = None
Traceback (most recent call last):
...
AttributeError: settings

To access another instance of the field, supply the prefix:

>>> alt_proxy = registry.forInterface(IMailSettings,
...     prefix="plone.registry.tests.alternativesettings")
>>> alt_proxy.sender  # doctest: +IGNORE_U
u'alt@example.org'

Collections of records proxies

A collection of record sets may be accessed using collectionOfInterface:

>>> collection = registry.collectionOfInterface(IMailSettings)

You can create a new record set:

>>> proxy = collection.setdefault('example')
>>> proxy.sender = u'collection@example.org'
>>> proxy.smtp_host = 'smtp://mail.example.org'

Record sets are stored based under the prefix:

>>> prefix = IMailSettings.__identifier__
>>> registry.records.values(prefix+'/', prefix+'0')
[<Record plone.registry.tests.IMailSettings/example.sender>,
 <Record plone.registry.tests.IMailSettings/example.smtp_host>]
>>> registry['plone.registry.tests.IMailSettings/example.sender']  # doctest: +IGNORE_U
u'collection@example.org'

Records may be set from an existing object:

>>> class MailSettings:
...     sender = u'someone@example.com'
...     smtp_host = 'smtp://mail.example.com'
>>> collection['example_com'] = MailSettings()
>>> registry.records.values(prefix+'/', prefix+'0')
[<Record plone.registry.tests.IMailSettings/example.sender>,
 <Record plone.registry.tests.IMailSettings/example.smtp_host>,
 <Record plone.registry.tests.IMailSettings/example_com.sender>,
 <Record plone.registry.tests.IMailSettings/example_com.smtp_host>]

The collection may be iterated over:

>>> for name in collection: print(name)
example
example_com

And may be deleted:

>>> del collection['example_com']
>>> registry.records.values(prefix+'/', prefix+'0')
[<Record plone.registry.tests.IMailSettings/example.sender>,
 <Record plone.registry.tests.IMailSettings/example.smtp_host>]

Bytes

The bytes field describes a string of bytes:

>>> f = field.Bytes(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.Bytes)
True

>>> f.order
-1

>>> field.Bytes(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint('ABC')
True

BytesLine

The bytes field describes a string of bytes, disallowing newlines:

>>> f = field.BytesLine(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.BytesLine)
True

>>> f.order
-1

>>> field.BytesLine(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(b'AB\nC')
False

ASCII

The ASCII field describes a string containing only ASCII characters:

>>> f = field.ASCII(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.ASCII)
True

>>> f.order
-1

>>> field.ASCII(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint('ab\nc')
True

ASCIILine

The ASCII line field describes a string containing only ASCII characters and disallowing newlines:

>>> f = field.ASCIILine(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.ASCIILine)
True

>>> f.order
-1

>>> field.ASCIILine(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint('ab\nc')
False

Text

The text field describes a unicode string:

>>> f = field.Text(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.Text)
True

>>> f.order
-1

>>> field.Text(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'ab\nc')
True

TextLine

The text line field describes a unicode string, disallowing newlines:

>>> f = field.TextLine(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.TextLine)
True

>>> f.order
-1

>>> field.TextLine(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'ab\nc')
False

Bool

The bool field describes a boolean:

>>> f = field.Bool(title=u"Test")
>>> isinstance(f, schema.Bool)
True

>>> f.order
-1

>>> field.Bool(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(False)
True

Int

The int field describes an integer or long:

>>> f = field.Int(title=u"Test", min=-123, max=1234)
>>> isinstance(f, schema.Int)
True

>>> f.order
-1

>>> field.Int(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(123)
True

Float

The float field describes a float:

>>> f = field.Float(title=u"Test", min=-123.0, max=1234.0)
>>> isinstance(f, schema.Float)
True

>>> f.order
-1

>>> field.Float(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(123)
True

Decimal

The decimal field describes a decimal:

>>> import decimal
>>> f = field.Decimal(title=u"Test", min=decimal.Decimal('-123.0'), max=decimal.Decimal('1234.0'))
>>> isinstance(f, schema.Decimal)
True

>>> f.order
-1

>>> field.Decimal(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(123)
True

Password

The password field describes a unicode string used for a password:

>>> f = field.Password(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.Password)
True

>>> f.order
-1

>>> field.Password(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'ab\nc')
False

SourceText

The source text field describes a unicode string with source code:

>>> f = field.SourceText(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.SourceText)
True

>>> f.order
-1

>>> field.SourceText(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'ab\nc')
True

URI

The URI field describes a URI string:

>>> f = field.URI(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.URI)
True

>>> f.order
-1

>>> field.URI(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'abc')
True

Id

The id field describes a URI string or a dotted name:

>>> f = field.Id(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.Id)
True

>>> f.order
-1

>>> field.Id(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'abc')
True

DottedName

The dotted name field describes a Python dotted name:

>>> f = field.DottedName(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.DottedName)
True

>>> f.order
-1

>>> field.DottedName(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'abc')
True

Datetime

The date/time field describes a Python datetime object:

>>> f = field.Datetime(title=u"Test")
>>> isinstance(f, schema.Datetime)
True

>>> f.order
-1

>>> field.Datetime(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> import datetime
>>> f.constraint(datetime.datetime.now())
True

Date

The date field describes a Python date object:

>>> f = field.Date(title=u"Test")
>>> isinstance(f, schema.Date)
True

>>> f.order
-1

>>> field.Date(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> import datetime
>>> f.constraint(datetime.date.today())
True

Timedelta

The time-delta field describes a Python timedelta object:

>>> f = field.Timedelta(title=u"Test")
>>> isinstance(f, schema.Timedelta)
True

>>> f.order
-1

>>> field.Timedelta(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> import datetime
>>> f.constraint(datetime.timedelta(1))
True

Tuple

The tuple field describes a tuple:

>>> f = field.Tuple(title=u"Test", min_length=0, max_length=10,
...     value_type=field.TextLine(title=u"Value"))
>>> isinstance(f, schema.Tuple)
True

>>> f.order
-1

>>> field.Tuple(title=u"Test", min_length=0, max_length=10,
...     value_type=schema.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.value_type = schema.TextLine(title=u"Value")
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.Tuple(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint((1,2))
True

List

The list field describes a tuple:

>>> f = field.List(title=u"Test", min_length=0, max_length=10,
...     value_type=field.TextLine(title=u"Value"))
>>> isinstance(f, schema.List)
True

>>> f.order
-1

>>> field.List(title=u"Test", min_length=0, max_length=10,
...     value_type=schema.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.value_type = schema.TextLine(title=u"Value")
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.List(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint([1,2])
True

Set

The set field describes a set:

>>> f = field.Set(title=u"Test", min_length=0, max_length=10,
...     value_type=field.TextLine(title=u"Value"))
>>> isinstance(f, schema.Set)
True

>>> f.order
-1

>>> field.Set(title=u"Test", min_length=0, max_length=10,
...     value_type=schema.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.value_type = schema.TextLine(title=u"Value")
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.Set(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(set([1,2]))
True

Frozenset

The set field describes a frozenset:

>>> f = field.FrozenSet(title=u"Test", min_length=0, max_length=10,
...     value_type=field.TextLine(title=u"Value"))
>>> isinstance(f, schema.FrozenSet)
True

>>> f.order
-1

>>> field.FrozenSet(title=u"Test", min_length=0, max_length=10,
...     value_type=schema.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.value_type = schema.TextLine(title=u"Value")
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.FrozenSet(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(frozenset([1,2]))
True

Dict

The set field describes a dict:

>>> f = field.Dict(title=u"Test", min_length=0, max_length=10,
...     key_type=field.ASCII(title=u"Key"),
...     value_type=field.TextLine(title=u"Value"))
>>> isinstance(f, schema.Dict)
True

>>> f.order
-1

>>> field.Dict(title=u"Test", min_length=0, max_length=10,
...     key_type=schema.ASCII(title=u"Key"),
...     value_type=field.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `key_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.key_type = schema.ASCII(title=u"Key")
Traceback (most recent call last):
...
ValueError: The property `key_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.Dict(title=u"Test", min_length=0, max_length=10,
...     key_type=field.ASCII(title=u"Key"),
...     value_type=schema.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.value_type = schema.TextLine(title=u"Value")
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.Dict(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(dict())
True

Choice

A choice field represents a selection from a vocabulary. For persistent fields, the vocabulary cannot be a source or any kind of object: it must either be a list of primitives, or a named vocabulary:

>>> f = field.Choice(title=u"Test", values=[1,2,3])
>>> isinstance(f, schema.Choice)
True

>>> f.order
-1

With a list of values given, the vocabulary property returns a vocabulary constructed from the values on the fly, and vocabularyName is None:

>>> f.vocabulary
<zope.schema.vocabulary.SimpleVocabulary object at ...>

>>> f.vocabularyName is None
True

We will get an error if we use anything other than primitives:

>>> f = field.Choice(title=u"Test", values=[object(), object()])
Traceback (most recent call last):
...
ValueError: Vocabulary values may only contain primitive values.

If a vocabulary name given, it is stored in vocabularyName, and the vocabulary property returns None:

>>> f = field.Choice(title=u"Test", vocabulary='my.vocab')
>>> f.vocabulary is None
True

>>> f.vocabularyName
'my.vocab'

Other combinations are now allowed, such as specifying no vocabulary:

>>> field.Choice(title=u"Test")
Traceback (most recent call last):
...
AssertionError: You must specify either values or vocabulary.

Or specifying both types:

>>> field.Choice(title=u"Test", values=[1,2,3], vocabulary='my.vocab')
Traceback (most recent call last):
...
AssertionError: You cannot specify both values and vocabulary.

Or specifying an object source:

>>> from zope.schema.vocabulary import SimpleVocabulary
>>> dummy_vocabulary = SimpleVocabulary.fromValues([1,2,3])
>>> field.Choice(title=u"Test", source=dummy_vocabulary)
Traceback (most recent call last):
...
ValueError: Persistent fields do not support sources, only named vocabularies or vocabularies based on simple value sets.

Or specifying an object vocabulary:

>>> field.Choice(title=u"Test", vocabulary=dummy_vocabulary)
Traceback (most recent call last):
...
ValueError: Persistent fields only support named vocabularies or vocabularies based on simple value sets.

As with other fields, you also cannot set a constraint:

>>> field.Choice(title=u"Test", values=[1,2,3], constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint('ABC')
True

1.1.3 (2018-06-22)

Bug fixes:

• Improve performance of RecordsProxy.__iter__ which is now invoked more in core Plone as part of the requireJS configuration [MatthewWilkes]

1.1.2 (2016-12-06)

Bug fixes:

• Fix tests to pass on Python 3.5 [datakurre]

1.1.1 (2016-11-19)

Bug fixes:

• Fix endless recursion on getting values from broken records proxy objects [tomgross]

1.1.0 (2016-07-05)

New features:

• Give RecordsProxy a __parent__ (the registry) in order to make it a good Zope citizen. This helps in context of z3cform binders and other similar situations, where a records proxy is used as context. [jensens]

1.0.4 (2016-06-12)

Fixes:

• More cleanup: PEP8, isort, readability. [jensens]

1.0.3 (2016-02-26)

Fixes:

• Replace deprecated zope.testing.doctestunit import with doctest module from stdlib. [thet]

• Cleanup: Pep8, utf8 headers, whitespace fixes, readability, ReST-fixes, doc-style, etc. [jensens]

1.0.2 (2014-09-11)

• Choice field construction compatible with a simple vocabulary of string-based choices, which are converted to values on construction. This provides compatibility for plone.registry/plone.app.registry integration with plone.supermodel >= 1.2.5. [seanupton]

1.0.1 (2013-01-13)

1.0 - 2011-05-13

• Release 1.0 Final [esteele]

• Add MANIFEST.in. [WouterVH]

1.0b5 - 2011-04-06

• Make RecordsProxy type customizable through factory argument to forInterface and collectionOfInterface. [elro]

• Add collectionOfInterface support to registry. [elro]

• Fixed bug where prefix was ignored by registry.forInterface. [elro]

• Add optional min, max arguments for keys/values/items of _Records. [elro]

1.0b4 - 2011-02-04

• Added support for field references, via the FieldRef class. See registry.txt for details. [optilude]

• Change the internal persistent structure around to make it more efficient. The API remains the same. Old registries will be migrated when first accessed. Warning: This may lead to a “write-on-read” situation for the first request in which the registry is being used. [optilude]

1.0b3 - 2011-01-03

• Added prefix option to forInterface (as it was added to registerInterface) [garbas]

1.0b2 - 2010-04-21

• Added support for Decimal fields [optilude]

• Add a prefix option to registerInterface to allow an interface to be used as a template for a series of values, rather than single use. [MatthewWilkes]

1.0b1 - 2009-08-02

• Fix a bug in bind() for Choice fields. [optilude]

1.0a2 - 2009-07-12

• Changed API methods and arguments to mixedCase to be more consistent with the rest of Zope. This is a non-backwards-compatible change. Our profuse apologies, but it’s now or never. :-/

  If you find that you get import errors or unknown keyword arguments in your code, please change names from foo_bar too fooBar, e.g. for_interface() becomes forInterface(). [optilude]

1.0a1 - 2009-04-17

• Initial release