Metadata-Version: 1.0
Name: iwm.recipe.bebopinstance
Version: 0.0.2
Summary: ZC Buildout recipe for defining a Bebop instance
Home-page: http://svn.kmrc.de/projects/devel/iwm.recipe.bebopinstance
Author: Torsten Kurbad
Author-email: t.kurbad@iwm-kmrc.de
License: GPL
Description: Bebop Instance Recipe
        =====================
        
        Derived from Jim Fultons Zope 3 Instance Recipe (zc.recipe.zope3instance).
        Difference:
        - corrected filepaths for binaries, config files, etc.
        - new Parameter:
        
        bebop-mode
        If set to 'on', enables some bebop specific features, like a
        customized securitypolicy.zcml.
        
        
        Jim's original README follows:
        ==============================
        
        The zc.recipe.zope3instance recipe creates a Zope 3 instance.  A Zope
        3 instance is a collection of scripts and configuration that define a Zope
        server process.  This recipe is likely to evolve quite a bit as our
        knowledge of how to deploy applications with eggs evolves. For
        example, we now need to know the location of a Zope 3 installation,
        however, in the future, we may be able to express our dependence on
        Zope3 soley via eggs.
        
        Note that, currently, this recipe is fairly unix-centric.  Windows
        support will be added in the future.
        
        The zope3 instance recipe takes a number of options:
        
        eggs
        Specify one or more distribution requirements, on separate lines,
        for software to be included in the Zope instance.
        
        zope3
        The name of a section defining a Zope3 installation location (as a
        location option).  This can be either a checkout or a release
        installtion. (Unfortunately, we have to do some introspection to
        determine whether a checkout or release installation is
        provided.)  Hopefully, this option will be unnecessary in the
        future and we'll use egg depedencies to define the Zope software
        used.
        
        database
        The names of one or more sections defining databases to be used.
        These sections must contain zconfig options giving configurations
        for individual databases.
        
        address
        One or more addresses to listed for HTTP connections on.  Each
        address of of the form "host:port" or just "port".
        
        user
        A global management user of the form:
        user:encyption:encrypted-password.
        
        zcml
        Specifications for one or more zcml files to be loaded.
        
        zope-options
        Top-level ZConfig options to be used for the instance,
        e.g. devmode on, threads 4, ...
        
        In addition, the find-links, index, python, interpreter, and
        extra-paths options of the zc.recipe.egg recipe are honored.
        
        Let's start with a minimal example. We have a sample buildout.  Let's
        write a buildout.cfg file that defines a zope instance:
        
        >>> cd(sample_buildout)
        >>> write('buildout.cfg',
        ... """
        ... [buildout]
        ... parts = instance
        ...
        ... [zope3]
        ... location = %(zope3_installation)s
        ...
        ... [mydata]
        ... zconfig =
        ...     <zodb>
        ...        <filestorage>
        ...           path /foo/baz/Data.fs
        ...        </filestorage>
        ...     </zodb>
        ...
        ... [instance]
        ... database = mydata
        ... user = jim:SHA1:40bd001563085fc35165329ea1ff5c5ecbdbbeef
        ...
        ... """
        ... % dict(zope3_installation=sample_zope3))
        
        The Zope3 instance recipe needs to be told the location of a Zope 3
        installation.   This can be done in two ways:
        
        1. Use a zope3checkout recipe to install Zope 3 from subversion,
        
        2. Use the configure-make-make-install recipe to install a Zope
        release, or
        
        3. Create a section with an option that provides the location of a
        Zope 3 installation.
        
        
        We provided a zope3 section containing the location of an existing
        Zope3 installation.
        
        We also provided a section that provided a zconfig option containing a
        ZConfig definition for a database.  We provided it by hand, but one
        would normally provide it using a part that used a database recipe,
        such as zc.recipe.filestorage or zc.recipe.clientstorage recipe.
        
        Let's run the buildout:
        
        >>> print system(join('bin', 'buildout')),
        
        We'll get a directory created in the buildout parts directory
        containing configuration files and some directories to contain og
        files, pid files, and so on.
        
        >>> ls(join('parts', 'instance'))
        
        
Keywords: zope3 bebop buildout name
Platform: UNKNOWN
