Products.contentmigration 2.1.0

A generic content migration framework for Plone

  Add it to your Download Basket!

 Add it to your Watch List!


Rate it!

What's new in Products.contentmigration 2.1.0:

  • Add support for a limit option for the catalog based walkers, so it only tries to load up to limit items at a time, defaulting to no limit. [hannosch]
  • Catch attribute errors during brain.getObject and log them instead of breaking the upgrade. [hannosch]
Read full changelog
send us
an update
LGPL (GNU Lesser General Public License) 
Martin Aspeli
ROOT \ Internet \ Plone Extensions
Products.contentmigration is a generic content migration framework, which should help you write your own content migrations. It has no UI and no value on its own, but makes it easy to write certain type of content migrations.

This replaces the ATContentTypes migration framework, and provide three useful extensions:

 * A CustomQueryWalker can be used to specify a more specific catalog query for a walker to use (e.g. which content to actually migrate). This can be used with any migrator.
 * A BaseInlineMigrator is similar to BaseMigrator, but does not migrate by copying the old object to a temporary location, creating a new object and applying migration methods. Instead, migration methods are applied in-place. This simplifies the code significantly, because attributes, local roles etc. does not need to be copied over.

 Note that whereas BaseMigrator works in terms of self.old and as the objects being migrated, BaseInlineMigrator only has a single object, stored in self.obj. This can be used with any walker.
 * An extension of this class called FieldActionMigrator uses the action-based migration framework for Archetypes fields, found in Please refer to that file for full details, but briefly, you specify a list of attributes to migrate at the storage level, instructing the migrator whether to rename, transform, unset or change the storage for an attribute.

Please see the docstrings in, and for full details. For examples, see tests/ and tests/

Last updated on October 6th, 2011


#migration framework #content migrations #Plone extension #migration #framework #content #Plone

Add your review!