Skip to main content
Help us improve Python packaging – donate today!

zope.interface extension for defining data schemas

Project Description

zope.schema README

Schemas extend the notion of interfaces to detailed descriptions of Attributes (but not methods). Every schema is an interface and specifies the public fields of an object. A field roughly corresponds to an attribute of a Python object. But a Field provides space for at least a title and a description. It can also constrain its value and provide a validation method. Besides you can optionally specify characteristics such as its value being read-only or not required.

See for more information.

zope.schema Changelog

4.3.2 (2013-02-24)

  • Fix Python 2.6 support. (Forgot to run tox with all environments before last release.)

4.3.1 (2013-02-24)

  • Make sure that we do not fail during bytes decoding of term token when generated from a bytes value by ignoring all errors. (Another option would have been to hexlify the value, but that would break way too many tests.)

4.3.0 (2013-02-24)

  • Fixed a bug where bytes values were turned into tokens inproperly in Python 3.
  • Added createFieldProperties() function which maps schema fields into FieldProperty instances.

4.2.2 (2012-11-21)

  • Added support for Python 3.3.

4.2.1 (2012-11-09)

  • Fix the default property of fields that have no defaultFactory attribute.

4.2.0 (2012-05-12)

  • Automated build of Sphinx HTML docs and running doctest snippets via tox.
  • Dropped explicit support for Python 3.1.
  • Introduce NativeString and NativeStringLine which are equal to Bytes and BytesLine on Python 2 and Text and TextLine on Python 3.
  • Change IURI from a Bytes string to a “native” string. This is a backwards incompatibility which only affects Python 3.
  • 100% unit test coverage.
  • Doctests moved from the package and wired up as normal Sphinx documentation.
  • Added explicit support for PyPy.
  • Added support for continuous integration using tox and jenkins.
  • Dropped the external six dependency in favor of a much-trimmed zope.schema._compat module.
  • Tests now pass when run under nose.
  • Added dev alias (runs develop plus installs nose and coverage).
  • Added docs alias (installs Sphinx and dependencies).

4.1.1 (2012-03-23)

  • Remove trailing slash in, it causes Winbot to crash.

4.1.0 (2012-03-23)

  • Add TreeVocabulary for nested tree-like vocabularies.
  • Fix broken Object field validation where the schema contains a Choice with ICountextSourceBinder source. In this case the vocabulary was not iterable because the field was not bound and the source binder didn’t return the real vocabulary. Added simple test for IContextSourceBinder validation. But a test with an Object field with a schema using a Choice with IContextSourceBinder is still missing.

4.0.1 (2011-11-14)

  • Fix bug in fromUnicode method of DottedName which would fail validation on being given unicode. Introduced in 4.0.0.

4.0.0 (2011-11-09)

  • Fix deprecated unittest methods.
  • Port to Python 3. This adds a dependency on six and removes support for Python 2.5.

3.8.1 (2011-09-23)

  • fix broken Object field validation. Previous version was using a volatile property on object field values which ends in a ForbiddenAttribute error on security proxied objects.

3.8.0 (2011-03-18)

  • Implemented a defaultFactory attribute for all fields. It is a callable that can be used to compute default values. The simplest case is:


    If the factory needs a context to compute a sensible default value, then it must provide IContextAwareDefaultFactory, which can be used as follows:

    def today(context):

3.7.1 (2010-12-25)

  • The validation token, used in the validation of schema with Object Field to avoid infinite recursion, has been renamed. __schema_being_validated became _v_schema_being_validated, a volatile attribute, to avoid persistency and therefore, read/write conflicts.
  • Don’t allow “[]^`” in DottedName.

3.7.0 (2010-09-12)

  • Improve error messages when term tokens or values are duplicates.
  • Fix the buildout so the tests run.

3.6.4 (2010-06-08)

  • fix validation of schema with Object Field that specify Interface schema.

3.6.3 (2010-04-30)

  • Prefer the standard libraries doctest module to the one from zope.testing.

3.6.2 (2010-04-30)

  • Avoid maximum recursion when validating Object field that points to cycles
  • Made the dependency on zope.i18nmessageid optional.

3.6.1 (2010-01-05)

  • Allow “ test” to run at least a subset of the tests runnable via bin/test (227 for test vs. 258. for bin/test)
  • Make zope.schema._bootstrapfields.ValidatedProperty descriptor work under Jython.
  • Make “ test” tests pass on Jython.

3.6.0 (2009-12-22)

  • Prefer zope.testing.doctest over doctestunit.
  • Extend validation error to hold the field name.
  • Add FieldProperty class that uses Field.get and Field.set methods instead of storing directly on the instance __dict__.

3.5.4 (2009-03-25)

  • Don’t fail trying to validate default value for Choice fields with IContextSourceBinder object given as a source. See
  • Add an interface for DottedName field.
  • Add vocabularyName attribute to the IChoice interface, change “vocabulary” attribute description to be more sensible, making it zope.schema.Field instead of plain zope.interface.Attribute.
  • Make IBool interface of Bool more important than IFromUnicode so adapters registered for IBool take precendence over adapters registered for IFromUnicode.

3.5.3 (2009-03-10)

  • Make Choice and Bool fields implement IFromUnicode interface, because they do provide the fromUnicode method.
  • Change package’s mailing list address to zope-dev at, as zope3-dev at is now retired.
  • Fix package’s documentation formatting. Change package’s description.
  • Add buildout part that builds Sphinx-generated documentation.
  • Remove zpkg-related file.

3.5.2 (2009-02-04)

  • Made validation tests compatible with Python 2.5 again (hopefully not breaking Python 2.4)
  • Added an __all__ package attribute to expose documentation.

3.5.1 (2009-01-31)

  • Stop using the old old set type.
  • Make tests compatible and silent with Python 2.4.
  • Fix __cmp__ method in ValidationError. Show some side effects based on the existing __cmp__ implementation. See validation.txt
  • Make ‘repr’ of the ValidationError and its subclasses more sensible. This may require you to adapt your doctests for the new style, but now it makes much more sense for debugging for developers.

3.5.0a2 (2008-12-11)

  • Move zope.testing to “test” extras_require, as it is not needed for zope.schema itself.
  • Change the order of classes in SET_TYPES tuple, introduced in previous release to one that was in 3.4 (SetType, set), because third-party code could be dependent on that order. The one example is z3c.form’s converter.

3.5.0a1 (2008-10-10)

  • Added the doctests to the long description.
  • Removed use of deprecated ‘sets’ module when running under Python 2.6.
  • Removed spurious doctest failure when running under Python 2.6.
  • Added support to bootstrap on Jython.
  • Added helper methods for schema validation: getValidationErrors and getSchemaValidationErrors.
  • zope.schema now works on Python2.5

3.4.0 (2007-09-28)

Added BeforeObjectAssignedEvent that is triggered before the object field sets a value.

3.3.0 (2007-03-15)

Corresponds to the version of the zope.schema package shipped as part of the Zope 3.3.0 release.

3.2.1 (2006-03-26)

Corresponds to the version of the zope.schema package shipped as part of the Zope 3.2.1 release.

Fixed missing import of ‘VocabularyRegistryError’. See .

3.2.0 (2006-01-05)

Corresponds to the version of the zope.schema package shipped as part of the Zope 3.2.0 release.

Added “iterable” sources to replace vocabularies, which are now deprecated and scheduled for removal in Zope 3.3.

3.1.0 (2005-10-03)

Corresponds to the version of the zope.schema package shipped as part of the Zope 3.1.0 release.

Allowed ‘Choice’ fields to take either a ‘vocabulary’ or a ‘source’ argument (sources are a simpler implementation).

Added ‘TimeDelta’ and ‘ASCIILine’ field types.

3.0.0 (2004-11-07)

Corresponds to the version of the zope.schema package shipped as part of the Zope X3.0.0 release.

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date (93.1 kB) Copy SHA256 hash SHA256 Source None Feb 24, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page