node package manager


Watch files (using a path, wildcards, or a regex) and execute a function or shell command.


Sentry is a simple node tool to watch for file changes (using a path, wildcards, or regexes) and execute a function or shell command. It's like a watchr or guard for node.

$ npm install sentry2
var sentry = require('sentry2');
// Watch changes in file.js'file.js', function (errorfilename) {
  console.log("A change has been made in " + filename);
// Watch changes on any file ending in .coffee one directory deep'fld/*.coffee', callback);
// Watch changes recursively on any files'fld/**/*', callback);
// Watch files recursively that match a regex 
sentry.watchRegExp('fld/', /regex/, callback);
// If you pass a string instead of a function it'll execute that child process'', 'coffee -c');

Sentry comes with two methods watch and watchRegExp.

When running a child process you may optionally pass a callback with the arguments (error, filename, stdout, stderr)'file.js', 'coffee -c', function (errorfilenamestdoutstderr) {/*...*/});

Or just pass a callback and Sentry will pass the filename to the callback'file.js', function (errorfilename) {/*...*/});

Feel free to use wildcards with extensions

// Find all files one directory deep'/folder/*', callback);
// Find all files one directory deep ending in .coffee'/folder/*.coffee', callback);
// Find all files recursively'/folder/**/*', callback);
// Find all files recursively ending in .txt'/folder/**/*.txt', callback);

Just like but instead you must pass a root directory and regular expression to match files against.

// Find all files in this folder that end in .coffee 
sentry.watchRegExp('', /\.coffee$/, callback);
// Find all files in the adjacent 'test' folder that begin with `test_` and end in `.coffee` 
sentry.watchRegExp('../tests/', /^test_,.coffee$/, callback);
npm test