You are not logged in Log in Join
You are here: Home » Download Zope Products » GenericSetup » GenericSetup-1.3.1 » README.txt » View Document

Log in
Name

Password

 

README.txt

GenericSetup Product README

Overview

This product provides a mini-framework for expressing the configured state of a Zope Site as a set of filesystem artifacts. These artifacts consist of declarative XML files, which spell out the configuration settings for each "tool" in the site , and supporting scripts / templates, in their "canonical" filesystem representations.

Configurations Included

The setup_tool knows how to export / import configurations and scripts for the following tools:

  • (x) removal / creation of specified tools
  • (x) itself :)
  • (x) the role / permission map on the "site" object (its parent)
  • (x) properties of the site object
  • (x) placeful utilities and adapters registered in the local site manager. Placeless utilities can only be imported.

Extending The Tool

Third-party products extend the tool by registering handlers for import / export of their unique tools.

See doc/handlers.txt for a step by step how-to.

Providing Profiles

GenericSetup doesn't ship with any profile. They have to be provided by third-party products and depend on the registered handlers.

See doc/profiles.txt for more details.

Glossary

Site
The instance in the Zope URL space which defines a "zone of service" for a set of tools.
Profile
A "preset" configuration of a site, defined on the filesystem
Snapshot
"Frozen" site configuration, captured within the setup tool
"dotted name"
The Pythonic representation of the "path" to a given function / module, e.g. Products.GenericSetup.tool.exportToolset.