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,
            },
            exclude => [ '*.tmp' ],
            parse_templates => TRUE|FALSE,
            on_change => sub {
             my (@files_changed) = @_;
            },
          };

          # download a directory recursively from the remote system to the local machine
          sync_down "/remote/directory", "/local/directory";
        };