nti.externalization 2.3.0

添加一个新基类，StandardInternalObjectExternalizer。参见PR 120和问题117。

将 IExternalMappingDecorator 重命名为 IExternalStandardDictionaryDecorator，以强调它仅在您（直接或通过超类）调用 to_standard_external_dictionary 时使用。兼容别名仍然存在。请参阅 PR 120 和 问题 118。

在 nti.externalization.interfaces 中的弃用别名现在在运行时也会发出弃用警告。

其他文档改进。Sphinx 现在可以在 Python 3 上运行所有 doctests（许多 doctests 仍在 Python 2 上运行）。

添加对 Python 3.9 的支持。

依赖于 BTrees 4.8 及以上版本。这简化了外部化检查。请参阅 问题 111。

更改 ILocatedExternalMapping：之前它扩展了遗留的 zope.interface.common.mapping.IFullMapping。现在它扩展了现代的 zope.interface.common.collections.IMapping。请注意，这与较旧的接口不同，这不需要可变性。（该软件包提供的 LocatedExternalDict 类是完全可变的，并实现了 IMutableMapping。它还继续实现 IFullMapping，但建议不要使用该接口。）

更改 ILocatedExternalSequence：之前它扩展了遗留的 zope.interface.common.sequence.ISequence。现在它扩展了现代的 zope.interface.common.collections.ISequence。请注意，这与较旧的接口不同，这不需要可变性。（该软件包提供的 LocatedExternalList 类是完全可变的，并实现了 IMutableSequence。）

修复 LocatedExternalList 的接口解析顺序。之前，使用 zope.interface 5 时，它开始实现 IMutableSequence（来自 zope.interface.common.collections 的新接口）以及较旧的接口 ISequence（来自 zope.interface.common.sequence）；这两个接口的解析顺序不一致。现在，它只实现 IMutableSequence 和不冲突的遗留接口的子集。请参阅 问题 105。

在更新对象之前正确触发 IObjectWillUpdateFromExternalEvent 事件。

适应 zope.container 4.4.0 中的更改，该更改暴露了不安全的假设，即 providedBy(obj) 将在后续调用中返回具有完全相同状态的确切相同对象。这在并发情况下始终是一个错误（例如，如果不同的线程在同一对象上调用 directlyProvides 或调整 IRO 中某些接口的 __bases__）；zope.container 的更改使它可能在没有并发的情况下实现。请参阅 https://github.com/zopefoundation/zope.container/issues/38 和 https://github.com/NextThought/nti.externalization/issues/104。

修复一个错误的断言错误。请参阅 问题 102。

将fractions.Fraction实例外部化为字符串，例如"1/3"。当由可以解析此格式的模式字段接收时，例如zope.schema.Rational（或在数值塔上更高），这意味着分数可以来回转换。

支持将decimal.Decimal对象外部化为YAML表示。

添加与zope.interface 5.0的兼容性，并要求使用。

记录哪些标记值被继承，哪些没有被继承。

停止继承_ext_is_marker_interface。

使用'3str'作为语言级别，用Cython 0.29.14进行构建。

添加对Python 3.8的支持。

将PyYAML更新到5.1，并略微改变默认输出样式。

修复与Persistent 4.4.3及更高版本兼容的测试。

支持zope.interface 4.7，当在具有多个对象实现派生接口的模块上使用<registerAutoPackageIO>时，允许接口上的标记值继承。请参阅问题97。

支持zope.schema 4.8.0引入的IFromBytes字段。请参阅问题92。

对于非字节和非文本数据，validate_field_value（以及由此扩展的InterfaceObjectIO.update_from_external_object）将调用任何字段定义的fromObject。以前，只有当字段引发WrongContainedTypeError时，才会调用fromObject。

添加对zope.schema 4.7.0和nti.schema 1.5.0的支持。删除对旧版本的支持，包括删除对dm.zope.schema.Object字段的支撑。

@WithRepr装饰器考虑了Persistent 4.4更新的默认repr，并且不隐藏它。

具有非-str（Python 2上的unicode，Python 3上的bytes）键的ExternalizableInstanceDict子类在外部化时不会抛出TypeError。相反，非-str值将转换为str（使用ASCII编码），如果有的话，将设置_p_changed属性。

大多数函数的registry参数已弃用并忽略。现在，我们直接调用接口，而不是调用registry.queryAdapter。例如，IInternalObjectExternalizer(containedObject)。这允许个别对象在没有通过旧代码路径的情况下提供接口时发表意见（如果需要，它也会在对象上调用__conform__）。

允许InterfaceObjectIO的子类为_ext_primitive_out_ivars_具有非frozenset值。这会发出警告，并在将来引发TypeError。

更好地支持在Dict值中发现的匿名值对象。现在，如果require_updater为True，它们不会引发ComponentLookupError，并且将根据模式（如果它们没有的话）给出一个MimeType。

当外部对象具有unicode键时，避免从validate_named_field_value引发TypeError。

LocatedExternalDict对象接受更多的构造函数参数，并允许任意属性。

InterfaceObjectIO仅在其想要对象时返回IDict字段的匿名工厂。

StandardExternalFields和StandardInternalFields是nti.externalization.externalization中的弃用别名。

update_from_external_object 正确处理了 INamedExternalizedObjectFactoryFinder 和 IInternalObjectUpdater 以不同特定级别注册的情况，并且查找器还实现了 IInternalObjectUpdater。在此之前，查找器可能会被错误地用作更新器。

从 InterfaceObjectIO 继承的对象，并在组件注册（在 ZCML 中）中注册为 IInternalObjectIO 的对象仍然可以找到并用作 INamedExternalizedObjectFactoryFinder，这是通过 IInternalObjectIOFinder 在 InterfaceObjectIO 中实现的接口。将发出警告以更新注册（这通常意味着在 ZCML 中删除 provides 行）。

ExternalizableInstanceDict 不再继承自 AbstractDynamicIO，它只实现了相同的接口（除了许多 _ext 方法）。此类已被弃用。

正式记录 nti.externalization.internalization 的 notify_modified 成员。《notifyModified》是一个已弃用的别名。

使 InterfaceObjectIO._ext_self 可从 Python 读取，尽管这尚未记录（并且将来可能会再次更改）。记录预期的 API，_ext_replacement()。请参阅 问题 73。

使 AbstractDynamicObjectIO._ext_getattr 处理默认值，并添加 _ext_replacement_getattr 以处理仅调用一次的情况。请参阅 问题 73。

@NoPickle 装饰器也适用于 Persistent 子类（并且可能与 Persistent 的多继承子类一起工作，这取决于 MRO，但这是常规对象始终的情况）。带有 @NoPickle 装饰器的 Persistent 子类没有太大意义，因此会发出 RuntimeWarning。如果类直接实现了 pickle 协议方法之一，也会发出警告。

使用 createFieldProperties 或在其类型中具有 FieldProperty 对象的对象更新至少快 10%，这是由于在 FieldProperty 上进行的小型 monkey-patch 而避免了双重验证。请参阅 问题 67。

允许再次使用实现 toExternalObject 的对象的代理；将被代理对象的 toExternalObject 调用。

已紧化 updateFromExternalObject() 的签名。它应该是 (self, external_object, context, **kwargs)，其中 **kwargs 是可选的，就像上下文一样。**kwargs 目前不包含任何有用的内容。签名中使用的 dataserver=None 将生成警告。将来可能会进一步紧化。请参阅 问题 30。

__ext_ignore_updateFromExternalObject__ 已正式弃用并生成警告。

update_from_external_object 缓存有关更新器对象类型的某些信息，使其快 8-25%。

update_from_external_object 在字典中就地修改包含的序列，而不是用新列表覆盖。

update_from_external_object 方法在顶层修改序列而不是返回一个新的列表。

添加了对查找未指定 MIME 类型或类字段的入站数据工厂的支持，这些数据基于它们分配的键。这有助于消费由外国系统生成或使用需要模型值的 Dict 方案字段的数据。请参阅 问题 51 和 PR 68。

使用 InterfaceObjectIO（包括通过 ZCML 指令 registerAutoPackageIO）的方案可以在内部化（外部化一直有效）上更容易地使用 Dict 字段：它们自动将 Dict 作为匿名外部数据内部化。

字符串可以自动转换为 ITimeDelta 对象。

外部化的低级别不再捕获并隐藏 POSKeyError。这表明数据库存在问题。请参阅 https://github.com/NextThought/nti.externalization/issues/60

从 update_from_external_object 中移除了对 object_hook 的支持。请参阅 https://github.com/NextThought/nti.externalization/issues/29。

移除了一些已移除函数的过时别名的支持。

在 CPython 上，一些模块使用 Cython 编译为扩展模块，以实现 10-30% 的速度提升。通过设置 PURE_PYTHON 环境变量，在运行时禁用此功能。

已从 ExternalizableDictionaryMixin 的实例中移除了未使用、未记录的方法 stripSyntheticKeysFromExternalDictionary。使用导入代替。

现在对于 to_standard_external_dictionary 和 to_minimal_standard_external_dictionary 的未使用关键字参数会产生警告。将来，额外的关键字参数将是一个错误。

notifyModified 不再接受 eventFactory 参数。

已移除 notifyModified 的别名 notifyModified。

外部映射和外部对象的装饰处理 decorate_callback 的参数不同。此参数仅在 decorate 为假时使用。此参数也很容易混淆，应考虑将其弃用。

choose_field 不再具有对 CREATOR 外部字段名的未记录转换行为。

首次 PyPI 发布。

添加了对 Python 3 的支持。

取消对外部化到 plists 的支持。请参阅 https://github.com/NextThought/nti.externalization/issues/21

达到 100% 的测试覆盖率，并确保通过 CI 保持这一点。

引入 nti.externalization.extension_points 来保存钩子函数。将 Pyramid 集成移到那里（并弃用该集成）。还将 NTIID 支持移到那里（但旧名称也有效）。请参阅 https://github.com/NextThought/nti.externalization/issues/27

弃用 nti.externalization.internalization.register_legacy_search_module。请参阅 https://github.com/NextThought/nti.externalization/issues/35

默认情况下阻止 ext:registerAutoPackageIO 注册基于旧类名的工厂。如果您需要基于类名的工厂，有两个选择。第一个是将 IClassObjectFactory 对象显式注册到 ZCML 中（我们可以添加一个扫描指令以方便处理大量类），第二个是在 ext:registerAutoPackageIO 的 ZCML 指令中将 register_legacy_search_module 设置为 true 值。请注意，我们预计这个属性的 behavior 将在不久的将来发生变化。请参阅 https://github.com/NextThought/nti.externalization/issues/33

使 ext:registerAutoPackageIO 在配置上下文执行时进行旧类注册，而不是在指令运行时进行。这意味着在配置时将检测到旧类名冲突。这也意味着可以使用 z3c.baseregistry 在本地注册旧类名（以前它们总是注册在全局站点管理器中）。请参阅 https://github.com/NextThought/nti.externalization/issues/28

取消对 zope.preference 和 zope.annotation 的依赖。虽然我们的 configure.zcml 中包括了它们，但此包并未使用。如果您使用 zope.preference 或 zope.annotation，请在您的 ZCML 文件中包括它们。

取消对 Acquisition 的严格依赖。如果可用，它仍然会被使用，并且在测试模式下会被使用。

在 nti.externalization.factory 中添加 IMimeObjectFactory 和 IClassObjectFactory 的公共实现。

取消对 nti.zodb 及其 PersistentPropertyHolder 的依赖。在 nti.externalization.persistence 中的数据结构不再扩展该类；如果您有进一步子类添加了 nti.zodb.peristentproperty.PropertyHoldingPersistent 属性，您现在需要确保混入这个类。请参阅 https://github.com/NextThought/nti.externalization/issues/43

添加用于注册基于类名的工厂的 <ext:classObjectFactory> 指令。（注意：MIME 工厂是首选。）

现在，调用 to_standard_external_dictionary（包括 AutoPackageScopedInterfaceIO）的调用者将自动获得一个 MimeType 值（如果找到的话）。以前只有调用 to_minimal_standard_external_dictionary 的调用者会得到。