Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
83 lines (52 sloc) 2.24 KB


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 (error, filename) {
  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., [task], callback)

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

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

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);

sentry.watchRegExp(root, regex, [task], 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);

To run tests

npm test