watch-sync

Watch for file changes and replicate them to a new location

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
watch-sync
200.3.18 years ago8 years agoMinified + gzip package size for watch-sync in KB

Readme

watch-sync
Watch for file changes and replicate them to a new location.
Performs initial synchronization between the src and dest directories and then sets a watcher that updates the dest directory any time a change is made.

Getting Started

Install watch-sync via NPM:
npm install watch-sync

Then require it to use it:
var watchSync = require("watch-sync");

var srcDir = ".";
var destDir = "/tmp/watchSync";
var options = {};
var watcher = watchSync(srcDir, destDir, options);
watcher.on("ready", function() { console.log("ready"); });
watcher.on("add", function(filepath, destDir, stat) {
  console.log("File / directory added", filepath, "in", destDir);
});
watcher.on("change", function(filepath, destDir, stat) {
  console.log("File / directory changed", filepath, "in", destDir);
});
watcher.on("delete", function(filepath, destDir) {
  console.log("File / directory removed", filepath, "from", destDir);
});

By default watchSync is persistent, which means it will run even after the initial sync. You can close the watcher with watcher.close().

API

watchSync(srcDir, destDir, [options])

  • srcDir is the source directory to watch.
  • destDir is the path to the destination directory. The directory will be
created if it does not already exist.
  • options is an optional set of configuration entries, as described in the
Options section below.

Options

  • persistent (default: true). If true continue to watch the srcDir for
changes after the initial sync. To close a persistent watcher use watcher.close().
  • delete (default: true). When true a delete of a file in srcDir after
the ready event will cause the associated file in destDir to be removed.
  • preserveTimestamps (default: false). If enabled sets the modified time
of synchronized files to the modified time of the source file.

Events

  • ready is fired after the initial sync of the file system.
  • add is fired when a file or directory is added. This is only fired after ready.
  • change is fired when a file or directory is changed. This is only fired
after ready.
  • delete is fired when a file or directory is removed. This is only fired
after ready.

watchSync.version()

Returns the version of the watchSync library.