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";
};