fileinput

fileinput
=========

A class and functions to quickly write a loop over standard input or a list of
files. Heavilly inspired by the [fileinput][py-fileinput] module of Python.


Installation
------------

$ npm install fileinput

Typical Usage
-------------

``js
var fileinput = require('fileinput');

fileinput.input()
.on('line', function(line) {
console.log( fileinput.lineno(), line.toString('utf8') );
});
`

This will read files specified in process.argv and emit each line to the
event _line_. When no filenames are found in argv it will default to reading
from stdin (this can also be achieved by using - as a filename).

Files can also be passed to the .input() function directly:

`js
var fileinput = require('fileinput');

var lines = 0;
fileinput.input(['index.js', 'lib/fileinput.js')
.on('line', function(line) {
if(line.toString().trim().length > 0) {
lines += 1;
}
})
.on('end', function() {
console.log('lines:', lines);
});
`

See examples/` from more uses.

API documentation
-----------------

Read the examples, tests and source for now, sorry...

Todo
----

* Support stdin reading for Windows (it now uses /dev/stdin)

[py-fileinput]: https://docs.python.org/3/library/fileinput.html "11.3. fileinput — Iterate over lines from multiple input streams"