Metadata-Version: 1.0
Name: collective.recipe.rsync
Version: 2.1.0
Summary: A zc.buildout recipe to copy files from one location        to another via rsync
Home-page: http://collective.github.com/collective.recipe.rsync
Author: Alex Clark
Author-email: aclark@aclark.net
License: ZPL
Description: Introduction
        ============
        
        ``collective.recipe.rsync`` is a `zc.buildout`_ recipe that copies files between two locations via the ``rsync`` program.
        
        .. Note::
        
            ``collective.recipe.rsync`` currently assumes you have a UNIX-based operating system and that the ``rsync`` binary is in your path when you execute buildout or the rsync script. Ideas for Windows support are welcome.
        
        Installation
        ------------
        
        Add a section to your ``buildout.cfg`` file, e.g.::
        
            [buildout]
            http://build.pythonpackages.com/buildout/plone/latest
            parts += rsync
        
            [rsync]
            recipe = collective.recipe.rsync
            source = remotehost:/path/to/Data.fs
            target = ${buildout:directory}/var/filestorage/Data.fs
        
        This copies a Data.fs file from `remotehost` to `var/filestorage/Data.fs` relative to the buildout root.
        
        Specify alternate SSH port
        ~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        Optionally you may specify an alternate SSH port for ``rsync`` to use::
        
            [rsync]
            recipe = collective.recipe.rsync
            source = remotehost:/path/to/Data.fs
            target = ${buildout:directory}/var/filestorage/Data.fs
            port = 22000
        
        This copies a Data.fs file from `remotehost` to `var/filestorage/Data.fs` using port 22000.
        
        Create a script
        ~~~~~~~~~~~~~~~
        
        Normally ``collective.recipe.rsync`` will run ``rsync`` during the recipe installation. Optionally you can create a script to execute ``rsync`` later by configuring the ``script = true`` option::
        
            [rsync]
            recipe = collective.recipe.rsync
            source = remotehost:/path/to/Data.fs
            target = ${buildout:directory}/var/filestorage/Data.fs
            script = true
        
        This is useful in cases where you want to automate an ``rsync`` script with cron e.g. via `z3c.recipe.usercrontab`_.
        
        .. _`zc.buildout`: http://pypi.python.org/pypi/zc.buildout
        .. _`z3c.recipe.usercrontab`: http://pypi.python.org/pypi/z3c.recipe.usercrontab
        
        Changelog
        ---------
        
        2.1.0 (2012-04-09)
        ~~~~~~~~~~~~~~~~~~
        
        * Clean up package
          [aclark]
        
        2.0.0 (2011-05-24)
        ~~~~~~~~~~~~~~~~~~
        
        * Don't prefix scripts with "rsync-"
        
        1.9 (2011-04-12)
        ~~~~~~~~~~~~~~~~
        
        * Call install on update
        * UI tweaks
        
        1.8 (2011-03-29)
        ~~~~~~~~~~~~~~~~
        
        * Switched to using subprocess to call rsync (to show progress to stdout) [mattss]
        * Replace print statements with logger [aclark]
        * Update docs
        
        1.7 (2011-01-21)
        ~~~~~~~~~~~~~~~~
        
        * Doc fixes
        * Make script name based on section name
        
          - Support more than one script in the same buildout
        
        1.6 (2011-01-20)
        ~~~~~~~~~~~~~~~~
        
        * Add ``script`` option 
        
          - Generates bin/rsync script
          - Disables rsync during buildout execution
          - Facilitates creation of scheduled rsyncs via cron
        
        1.5 (2011-01-10)
        ~~~~~~~~~~~~~~~~
        
        * Doc fixes
        
          - Add a note about UNIX compat only
        
        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
