Search-Act-Replace (SAR)

Install with npm install search-act-replace.

This modules takes a root path, a regex and a callback. It will recursively search the file within the root path and call the callback for each match. It also provides another callback, which you can feed with the text that the match should be replaced with (or false for no replacement).

Let the example talk for itself.

Example

var sar = require('search-act-replace');
 
sar('./test', /www\.\w+\.com/g, function (match, file, replace) {
  http.get('http://' + match[0], function (res) {
    if (res.statusCode !== 200) {
      replace(match[0] + ' (link broken)');
    } else {
      replace(false);
    }
  });
});

The script will automatically ignore .git, .svn, node_modules, and bower_components folders (have a look at the .sarignore file) as well as files specified in the roots .gitignore file as well as a custom .sarignore file in the root folder.

Events

SAR is an Event Emitter. It supports the following events:

file

Emitted whenever sar stumbles across a file.

.on('file', function (file) {
  // file is the filename
})

directory

Emitted whenever sar stumbles across a directory.

.on('directory', function (dir) {
  // dir is the filename
})

ignore

Whenever SAR ignores to match within a file or ignores a directory.

.on('ignore', function (file) {
  // file is the filename or foldername
})

end

When everything is done. Meaning that all files are traversed, all callbacks finished and all the writing/replacing has been done.

.on('end', function () {
  // file is the filename
})