A simple module that concatenates files and binary streams with some extras.
const Kat = ;const readstream = ;readstream;readstream;readstream;readstream;
readstream will emit
end events like a regular readstream should.
resume() can also be called on it.
When you should use this
You might be thinking this module is way too simple to even be a module. I was thinking the same thing until I thought about how this type of module should really work.
There are several node modules where their API allow developers to pass in file data by passing in a file path to a method.
These modules are doing it wrong. (With the exception of modules that are used during setup)
In many cases, you will want to have the option to pass in a readable stream of the file. Why? Because with a stream, not only can you give it a local file stream, but it can also be a stream from a remote request. Or even a stream that parses or uncompresses another stream.
// Local file.const fs = ;foo;// Remote file.// Request conveniently returns a readable stream.const request = ;foo;// Compressed file.const fs = ;const zlib = ;var stream = fs;foo;
The module could even be used in a server that allows file uploads without the server having to save the entire file to disc.
But ideally, we want to make our module APIs as convenient as possible for other developers. It's really common for a module to receive streams that are local file read streams made with
fs.createReadStream. Thus it would be convenient to allow its users to give the module a file path OR a readable stream.
// Pass in a file path.foo;// Pass in a stream.foo;
But what if your module is the type that allows its users to add multiple files to it?
var bar = foo;bar;bar;
This is where node-kat shines. It easily allows you to convenielize (yes convenielize) your API by allowing users to input file paths, readable streams, and even paths to directories.
var bar = foo;var request = ;bar;bar
Now the bar instance will get all the data from the files it needs, in order, and aware of what file or stream it's coming from.
new Kat([file1...], [options])
Creates a new instance of Kat. Passing in files to the constructor is a shortcut to the
Kat#add() method. Last argument will be considered options object if not a string or a stream. Options defaults to
// will be used whenever a file is openedflags: 'r'encoding: nullmode: 438// can be used to select what part of the concatenated file will be read// even if that means skipping files entirelystart: 0end: Infinity// if true, will keep reading any additional streams if there is an error// if false, will stop and destroy all streams as soon as there is one errorcontinueOnErr: falseallowFiles: trueallowDirs: trueallowStreams: trueconcurrency: 250// if true, will emit `end` when it finishes reading all streamsautoEnd: true
Adds argument list to the list of files that will be concatenated.
file can be a string to a path of a file, a folder, or a readable stream. If it's a folder, all files in it will be recursively added alphabetically.
Stops the stream and destroys all underlying file stream.
number- File descriptor.
string- File path.
When a file descriptor is opened, this will be emitted. In case a non-file readable stream is added,
filepath will be the item index relative to all other items in the list.
string- File path.
Emitted when a file descriptor is closed.
string- File path.
Emitted when the Kat instance starts reading from a stream.
Emitted when all streams have been read.
Array.Object- Will be an array of objects containing a
Emitted right before the
path: "/home/user/files/somefile.txt" size: 324path: 1 size: 4459
When there is an error opening a file, reading from it, or with a stream.
npm install kat
Tests are written with mocha