[Zope-CMF] [dev] RFC: rethinking GenericSetup extension profiles
y.2006_ at wcm-solutions.de
Tue Jul 25 03:16:01 EDT 2006
Since CMF 1.5.1 CMFSetup/GenericSetup supports extension profiles. They
are quite useful, but their current format has some fundamental issues:
- Only a site instance can interpret that format and merge an extension
profile into a base profile. The extension profile has to be applied in
a special mode (non-purging) and needs some special update directives
(like 'remove' or 'insert-before').
- We have no way to specify dependencies between profiles.
That has serious consequences:
1.) Extension profiles are hard to create and maintain
You need a lot of knowledge about the import handlers. Only if you know
how their non-purging mode is implemented and which update directives
are available you can write good extension profiles. There are no tools
that help you to create extension profiles.
2.) Sites using extension profiles are hard to create and maintain
You have to know which profiles depend on other profiles. It's hard to
control the order in which profiles are applied. The Comparison tab
becomes useless if the site uses several extensions that are not part of
the 'initial_configuration' snapshot. (Sometimes I create a new site to
get a clean snapshot of the applied profiles and delete that site again.
A quite expensive procedure.) A snapshot contains no information which
original profiles it 'contains'. The tool has no control on the applied
profiles. There is no way to uninstall profiles.
And now forget everything you know about extension profiles. Imagine
they were like this:
Extension profiles describe how to transform base profiles. They know
which profiles they can transform (AKA dependencies). They are applied
to an other profile, *not* to the site.
Only complete profiles (base profiles or extended base profiles) are
applied to the site. The handlers only need to understand complete
The setup tool knows how to merge profiles without modifying the site.
You can compare your snapshot with any valid combination of profiles you
like. There might even be a function that searches for the profile
combination that has the smallest diff to your snapshot and finds this
way the best dependencies list.
And now imagine we have a tool that can *create* extension profiles
based on the current customizations.
This would allow to provide many new features:
- customization snapshots:
Snapshots would just contain the customizations and a list of
dependencies, not a complete base profile.
Basically any setup change is applied by recreating the site from
scratch. At least for some expensive to create items like indexes we
have to make sure we don't delete/recreate them if they were not
modified. Uninstall would be no different procedure, we just don't
reapply a specific profile.
There are different kinds of migrations. Updates in the base profiles
would be applied using the install procedure.
I can see 2 different ways to change the extension profile format:
1.) Splitting configuration files in many small files
This would also change the format of base profiles. Extension profiles
are simple layers and files in higher layers override files in lower layers.
pros: easy to implement; easy to understand
cons: requires new base profiles and modified setup handlers; changes
can only be as fine grained as the file structure
2.) Using XSLT
For applying XSLT files we can use existing XSLT libraries. I'm not
aware of any generic library that allows to create XSLT files based on
the difference between two XML files. But the GenericSetup profiles just
use a subset of XML so it would be much easier to write a special tool
for GenericSetup diffs than writing a general XML diff tool.
pros: works with current base profiles and setup handlers
cons: depends on the necessary XSLT tools (I guess for the diffs we have
to write them ourselves)
What do you think?
More information about the Zope-CMF