NAME

Rex::Commands::Sync - Sync directories

DESCRIPTION

This module can sync directories between your Rex system and your servers without the need of rsync.

SYNOPSIS

 use Rex::Commands::Sync;
   
 task "prepare", "mysystem01", sub {
   # upload directory recursively to remote system. 
   sync_up "/local/directory", "/remote/directory";
   
   sync_up "/local/directory", "/remote/directory", {
     # setting custom file permissions for every file
     files => {
       owner => "foo",
       group => "bar",
       mode  => 600,
     },
     # setting custom directory permissions for every directory
     directories => {
       owner => "foo",
       group => "bar",
       mode  => 700,
     },
     on_change => sub {
      my (@files_changed) = @_;
     },
   };
    
   # download a directory recursively from the remote system to the local machine
   sync_down "/remote/directory", "/local/directory";
 };