ros

read-only-stream

wrap a readable/writable stream to be read-only

Showing:

Popularity

Downloads/wk

959K

GitHub Stars

21

Maintenance

Last Commit

6yrs ago

Contributors

2

Package

Dependencies

1

Size (min+gzip)

7.9KB

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

read-only-stream

wrap a readable/writable stream to be read-only to prevent mucking up the input side

build status

example

Suppose you have a module that uses a readable/writable stream internally but want to expose just the readable part of that internal stream. This is common if you use the writable side internally and expose the readable side as the interface.

Now we can write some code like this with a through stream internally for convenience:

var through = require('through2');
var readonly = require('read-only-stream');

module.exports = function () {
    var stream = through();
    stream.end('wooooo\n');
    return readonly(stream);
};

but consumers won't be able to write to the input side and break the api:

var wrap = require('./wrap.js');
var ro = wrap(); // can't write to `ro` and muck up internal state
ro.pipe(process.stdout);

methods

var readonly = require('read-only-stream')

var ro = readonly(stream)

Return a readable stream ro that wraps the readable/writable stream argument given to only expose the readable side.

stream can be a streams1 or streams2 stream.

install

With npm do:

npm install read-only-stream

license

MIT

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100