Metadata-Version: 1.0
Name: collective.recipe.rsync
Version: 1.4
Summary: A zc.buildout recipe to copy data from source to target
Home-page: http://svn.plone.org/svn/collective/buildout/collective.recipe.rsync/
Author: Alex Clark
Author-email: aclark@aclark.net
License: ZPL
Description: .. contents::
        
        Introduction
        ============
        
        ``collective.recipe.rsync`` is a ``zc.buildout`` recipe that makes it easy to
        synchronize data between two locations, via the ``rsync`` program. 
        
        It was originally created to make it easier to synchronize ``Data.fs``
        files between Plone production and development environments. But you can use it to 
        synchronize any tree of data e.g. ZODB blob files, and so on.
        
        Currently, it assumes you have a UNIX-based operating system and that
        the ``rsync`` binary is in your path when you run buildout.
        
        Usage
        -----
        
        Add a section to your ``buildout.cfg`` file, e.g. ``database``::
        
            [buildout]
            parts += database
        
            [database]
            recipe = collective.recipe.rsync
            source = aclark@aclark.net:/srv/aclark/var/filestorage/Data.fs
            target = var/filestorage/Data.fs
        
        Run buildout. You should see::
        
            --------------------------------------------------------------------------------
            Running rsync...
              rsync -av --partial --progress
            aclark@aclark.net:/srv/aclark/var/filestorage/Data.fs
            var/filestorage/Data.fs
              this may take a while!
        
        
        Alternate ssh port
        ~~~~~~~~~~~~~~~~~~
        
        Optionally, you can specify an alternate ssh port for rsync to use::
        
            [database]
            recipe = collective.recipe.rsync
            source = aclark@aclark.net:/srv/aclark/var/filestorage/Data.fs
            target = var/filestorage/Data.fs
            port = 22001
        
        Contact
        -------
        
        Comments, questions, concerns? Email: aclark@aclark.net
        
        Changelog
        ---------
        
        1.4 (2011-01-10)
        ~~~~~~~~~~~~~~~~
        
        - Support alternate ssh ``port`` parameter in recipe section. This allows
          ``collective.recipe.rsync`` to execute rsync with: -e 'ssh <port>', which
          facilitates copying over non-standard ssh ports.
        
        1.3 (2010-12-19)
        ~~~~~~~~~~~~~~~~
        
        - Fix docs
        
        1.2 (2010-12-19)
        ~~~~~~~~~~~~~~~~
        
        - Fix docs
        - Add new test harness
        - Clean up package
        
        1.1 (2010-11-05)
        ~~~~~~~~~~~~~~~~
        
        - Modified output to include rsync command line being executed
        
        1.0 (2010-02-28)
        ~~~~~~~~~~~~~~~~
        
        - Rename package from collective.recipe.rsync_datafs to collective.recipe.rsync
        
        0.1 (2009-08-26)
        ~~~~~~~~~~~~~~~~
        
        - Created recipe with ZopeSkel 
        
Platform: UNKNOWN
Classifier: Framework :: Buildout
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: Zope Public License
