Javascript Terminal String Editor

View on GitHub




Javascript Terminal String Editor: NSed brings Node.js power to the command line.

It works similarly to the standard GNU sed command, with the exception that everything is Javascript and powered by Node.js.

For instance, the following command computes the hash of each file in the test folder:

find test -type f | nsed -r crypto -c 'fs.readFileSync($data, "utf8")' -c 'crypto.createHash("md5").update($data).digest("hex")'


To install, simply use npm or yarn:

npm install -g nsed


Basic usage

Each command is executed on the output of the previous one. You can reference $data for the current input and $index for the current position in the input.

If operating directly on properties or methods of the input, you can omit $data.

find test -type f | nsed -r crypto -c 'fs.readFileSync($data, "utf8")' -c '.length'

To see all the available options, use -h|--help option.


Input lines can be filtered out by using filter (-f|--filter) or reverse filters (-F|--reverse-filter) that, respectively, will include the input if the result of the evaluation is a truthy or falsy value (according to Javascript rules).

For instance, the following command will print only files starting with index:

find test -type f | nsed -f '/^index/'

Regular expressions

Regular expression can be used in commands and referenced later, using $NUMBER syntax.

For instance, the following command will print the second letter of each file:

find test -type f | nsed -c '.replace("test/", "")' -c '/.(.).+/' -c '$1'

Advanced usage

Before processing commands, you can instruct nsed to require any available Node.js modules, by using -r|--require switch. The module will be available with its name camelcased. For instance, -r string_decoder will make stringDecoder available for your commands.

Finally, instead of providing commands via command line, you can input Javascript file using -s|--source switch. The source file must export a function which accepts a string ($data representing the current line) and a number ($index, representing the current line in the input).

Contributing to nsed


Copyright (C) 2017 and above Shogun shogun@cowtech.it.

Licensed under the MIT license, which can be found at https://choosealicense.com/licenses/isc.

Your browser is obsolete. For the best browsing experience, update it for free by visiting BrowseHappy.
There is a shiny new version. Update now!
Made by a proud Italian!