Skip to main content

zodbupdate rename rules by Zest

Project description


zodbupdate rename dictionary and dexterity patch for Plone 5.2 projects.

See post on And the Plone ZODB Python 3 migration docs.

Quick usage

In a simplified buildout.cfg:

parts =

recipe = plone.recipe.zope2instance
eggs =

recipe = zc.recipe.egg
eggs =

Run bin/buildout and then bin/zodbupdate -f var/filestorage/Data.fs.

Use case and process

You want to migrate your Plone 5.2 database from Python 2.7 to Python 3. You use the zodbverify and zodbupdate tools for this. When you first run bin/zodbverify or bin/instance zodbverify, you may see warnings and exceptions. It may warn about problems that zodbupdate will fix. So the idea is now:

  1. First with Python 2.7, run bin/zodbupdate -f var/filestorage/Data.fs So no python3 convert stuff! This will detect and apply several explicit and implicit rename rules.

  2. Then run bin/instance zodbverify. If this still gives warnings or exceptions, you may need to define more rules and apply them with zodbupdate.

  3. When all is well, on Python 3 run:

    bin/zodbupdate --convert-py3 --file=var/filestorage/Data.fs --encoding utf8
  4. For good measure, on Python 3 run bin/instance zodbverify.

When this works fine on a copy of your production database, you could choose to safe some downtime and only do step 3 on your production database. But please check this process again on a copy of your database.

Rename rules

zodbverify may give warnings and exceptions like these:

Warning: Missing factory for Products.ResourceRegistries.interfaces.settings IResourceRegistriesSettings
Warning: Missing factory for App.interfaces IPersistentExtra
Warning: Missing factory for App.interfaces IUndoSupport
Found X records that could not be loaded.
Exceptions and how often they happened:
ImportError: No module named ResourceRegistries.interfaces.settings: 8
AttributeError: 'module' object has no attribute 'IPersistentExtra': 4508

For each, you need to check if it can be safely replaced by something else, or if this points to a real problem: maybe a previously installed add-on is missing.

In this case, these interfaces seem no longer needed. Easiest is to replace them with a basic Interface. Maybe there are better ways to clean these up, but so far so good.

You fix these with renames in an entrypoint using zodbupdate. See The current package defines such an entrypoint.

Here is the rename dictionary from the master branch. The warnings and exceptions mentioned above are handled here. Each version of this package may have different contents.

Note that I have seen several warnings that are not handled but that seem innocent. I choose to ignore them. These are some warnings because of a missing webdav (removed in Zope 4.0, reintroduced in 4.3):

Warning: Missing factory for webdav.interfaces IDAVResource
Warning: Missing factory for webdav.interfaces IFTPAccess
Warning: Missing factory for webdav.interfaces IDAVCollection

Dynamic dexterity schemas

A special case that bin/zodbupdate and bin/zodbverify may bump into, is:

AttributeError: Cannot find dynamic object factory for module plone.dexterity.schema.generated: 58
Warning: Missing factory for plone.dexterity.schema.generated Plone_0_Image
Warning: Missing factory for plone.dexterity.schema.generated Plone_0_Document
Warning: Missing factory for plone.dexterity.schema.generated Site2_0_News_1_Item
Warning: Missing factory for plone.dexterity.schema.generated Site3_0_Document

This is because no zcml is loaded by these scripts. So this utility from plone.dexterity/configure.zcml is not registered:


This utility implements plone.alterego.interfaces.IDynamicObjectFactory. This is responsible for generating schemas on the fly. So we register this utility in Python code.

Note that in normal use (bin/instance) this would result in a double registration, but the second one is simply ignored by zope.interface, because it is the same.

Also, when you have zodbverify in the instance eggs and you call bin/instance zodbverify, you will not get this error, because then zcml is loaded, and no special handling is needed.

Package structure

  • This package only has an file.
  • It has the rename dictionary pointed to by the entrypoint in our setup.cfg.
  • It is only loaded when running bin/zodbupdate, because this is the only code that looks for the entrypoint.
  • As a side effect, when the entrypoint is loaded we also register the dexterity utility when available. This code is executed simply because it also is in the file.


1.0.0b1 (2020-03-03)

  • Initial release. [maurits]

Project details

Download files

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

Files for zest.zodbupdate, version 1.0.0b1
Filename, size File type Python version Upload date Hashes
Filename, size zest.zodbupdate-1.0.0b1-py2.py3-none-any.whl (5.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size zest.zodbupdate-1.0.0b1.tar.gz (4.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page