Metadata-Version: 1.0
Name: gocept.fssyncz2
Version: 1.5.2
Summary: zope.app.fssync integration for Zope2
Home-page: http://pypi.python.org/pypi/gocept.fssyncz2
Author: gocept gmbh & co. kg
Author-email: mail@gocept.com
License: ZPL 2.1
Description: ===============
        gocept.fssyncz2
        ===============
        
        This package provides Zope2 integration of zope.fssync/zope.app.fssync, that
        is, the ability to dump and restore ZODB content to the filesystem (To that
        end, it provides synchronisers for OFS folders and the like, and adapts the
        Zope3-ish mechanisms of zope.app.fssync to work with the Zope2 publisher).
        
        Its main use case is to keep code stored inside the ZODB in a source code
        management system. Therefore, it tries to make the pickles that are written to
        disk as readable as possible (e. g. by not using base64 encoding).
        
        So far, it concentrates on the ``dump`` and ``load`` actions (which
        overwrite their target completely), since merging changes between different
        checkouts needs to be done via the SCM anyway. (zope.app.fssync offers several
        other actions, such as ``update`` and ``commit``, that try to be smart when
        both the ZODB and the filesystem dump have changed concurrently. While this is
        fine as long as only one filesystem representation exists, the model breaks
        down when several dumps need to be synchronized with each other -- it is highly
        non-trivial to determine whose change really is the right one in that case, so
        we recommend against using these actions at this point.)
        
        Usage
        =====
        
        You'll need to load both the configure.zcml and overrides.zcml configuration
        files.
        
        gocept.fssyncz2 provides a console script called ``fssync`` which wraps the two
        actions (``dump`` and ``load``) and allows to pass in all other
        parameters (URLs, locations, credentials). This is meant to be generated (via
        buildout for example), like this::
        
          [fssync]
          recipe = zc.recipe.egg:scripts
          eggs = gocept.fssyncz2
          extra-paths = ${zope2:location}/lib/python
          arguments = host='${instance:http-address}', folder='myfolder', credentials='${instance:user}', repository='${buildout:directory}/var/zodb-dump'
        
        Then you can dump your ZODB to the configured filesystem location with
        ``bin/fssync dump`` and load the data stored on the filesystem into the
        ZODB with ``bin/fssync load``.
        
        
        Ignoring objects
        ================
        
        If you want to exclude some objects from being dumped (e.g. user data that
        changes often), create a "Restrucured Text Document" named
        ``fssync-dump-ignore`` in the parent folder. This file may contain one object
        name per line that should be excluded from dumping.
        
        
        =======
        Changes
        =======
        
        
        1.5.2 (2012-07-04)
        ==================
        
        - Add workaround for CookieUserFolder to restore the ``__allow_groups__``
          pointer after load when fssync-ignoring it (#11111).
        
        
        1.5.1 (2012-02-27)
        ==================
        
        - Made ignore mechanism actually ignore objects on loading a dump. (#10488)
        
        
        1.5 (2012-02-23)
        ================
        
        - Add ignore mechanism (#10483).
        
        
        1.4 (2011-11-28)
        ================
        
        - Fixed a bug which prevented strings containing the sequence ]]> from being
          dumped and loaded back, giving rise to ill-formed XML pickles.
        
        - Cleaned up a little: removed an unused testdata directory.
        
        
        1.3 (2011-08-05)
        ================
        
        - Pinned all used versions in buildout.
        
        - Added trove classifiers to package meta data.
        
        
        1.2 (2011-04-10)
        ================
        
        - Made sure that newlines inside strings end up as newlines instead of ``\n``
          notation in XML pickles (fixes #8860).
        
        - Install the fssync script in the development buildout.
        
        - When dumping a PythonScript, leave out its _code attribute to reduce noise
          in the XML pickles (fixes #8859).
        
        - Declared dependency on `zope.i18nmessageid`.
        
        - Better error message when finding persistent objects in Extras.`
        
        
        1.1 (2011-01-31)
        ================
        
        - Renamed console commands to dump/load instead of checkout/checkin to avoid
          confusion with SCM operations.
        
        
        1.0 (2011-01-31)
        ================
        
        - Initial release.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Framework :: ZODB
Classifier: Framework :: Zope2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.4
Classifier: Programming Language :: Python :: 2.5
Classifier: Topic :: Database
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Utilities
