nti.schema 1.8.0

Zope schema related support

nti.schema

nti.schema includes utilities for working with schema-driven development using zope.schema.

For complete details and the changelog, see the documentation.

Overview

Some of the most useful features include:

• nti.schema.interfaces.find_most_derived_interface for finding a bounded interface.

• nti.schema.eqhash.EqHash is a class-decorator for creating efficient, correct implementations of equality and hashing.

• nti.schema.field contains various schema fields, including a Variant type and more flexible collection types, all of which produce better validation errors.

• nti.schema.fieldproperty contains field properties that can adapt to interfaces or decode incoming text. The function createDirectFieldProperties can assign just the necessary properties automatically.

Changes

1.8.0 (2018-09-28)

• Add VariantValidationError, an error raised by variant fields when none of their constituent fields could adapt or validate the value.

1.7.0 (2018-09-19)

• Add support for IFromBytes in zope.schema 4.8.0.

• The Variant and ListOrTupleFromObject, TupleFromObject, DictFromObject fields all have tweaked behaviour in fromObject. If the incoming value is a bytestring or text string, the underlying field’s fromBytes and fromUnicode will be called in preference to a fromObject, if that method is implemented.

• ValidSet and UniqueIterable now implement fromObject.

• All fields that implement fromObject now accept an Object field for their value_type (and key_type in the case of DictFromObject) and will attempt to adapt objects that do not provide the schema in fromObject.

1.6.0 (2018-09-18)

• Adjust the deprecated zope.schema.interfaces.InvalidValue to be a simple alias for zope.schema.interfaces.InvalidValue (while preserving the constructor) for improved backwards compatibility.

1.5.0 (2018-09-11)

• Add support for zope.schema 4.7.0; drop support for older versions.

1.4.2 (2018-09-10)

• Fix the repr of nti.schema.interfaces.InvalidValue. See issue 26.

• nti.schema.jsonschema turns more abstract field types into concrete types. See issue 29.

1.4.1 (2018-09-10)

• Make nti.schema.interfaces.InvalidValue a class again. It is deprecated. See issue 24.

1.4.0 (2018-09-10)

• Drop support for dm.zope.schema fields, in particular the Object field. The validation performed by zope.schema.Object is much improved.

• Drop support for zope.schema older than 4.6.1.

• Deprecate nti.schema.field.Number.

• Add support for Python 3.7.

1.3.3 (2018-09-07)

• Minor fix for changes in zope.schema 4.6.0 (import BeforeObjectAssignedEvent from its new, but still private, location).

1.3.2 (2017-10-24)

• Depend on zope.deferredimport >= 4.2.1 to be able to generate Sphinx documentation.

• Clean up code to match PEP8.

1.3.1 (2017-10-18)

• Fix an UnboundLocalError on Python 3 in the Variant field. See issue 14.

1.3.0 (2017-07-06)

• Drop the Python 2 dependency on plone.i18n in favor of the new library nti.i18n, which supports Python 3. If plone.i18n is installed, it should not be configured (ZCML), but its utility objects can be looked up by either interface.

1.2.0 (2017-05-17)

• Remove use of unicode_literals.

• Add support for Python 3.6.

• The SchemaConfigured constructor doesn’t hide errors when checking for properties on Python 2. See issue 11.

1.1.3 (2017-01-17)

• Add info to minLength validation message.

1.1.2 (2016-09-14)

• Add Acquisition and zope.event as install dependencies. Previously they were only pulled in via the test extra.

1.1.1 (2016-09-08)

• Substantial speedups to the hash functions generated by EqHash.

• Substantial speedups to the equality functions generated by EqHash.

1.1.0 (2016-07-29)

• Add support for Python 3. Note the countries vocabulary will not be complete on Python 3.

• Drop the dolmen.builtins dependency.

• Drop the dm.zope.schema dependency.

• The plone.i18n dependency is Python 2 only (and can even be removed).

• The matchers in nti.schema.testing have been moved to nti.testing.matchers.

• Using AdaptingFieldProperty will now raise the more specific SchemaNotProvided error instead of a TypeError if adapting the value fails.

• EqHash has moved from nti.schema.schema to nti.schema.eqhash. A compatibility shim remains.