streamqueue

WebJar for streamqueue

License

License

MIT
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

streamqueue
Last Version

Last Version

0.1.3
Release Date

Release Date

Type

Type

jar
Description

Description

streamqueue
WebJar for streamqueue
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/nfroidure/StreamQueue

Download streamqueue

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/streamqueue/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>streamqueue</artifactId>
    <version>0.1.3</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/streamqueue/
implementation 'org.webjars.npm:streamqueue:0.1.3'
// https://jarcasting.com/artifacts/org.webjars.npm/streamqueue/
implementation ("org.webjars.npm:streamqueue:0.1.3")
'org.webjars.npm:streamqueue:jar:0.1.3'
<dependency org="org.webjars.npm" name="streamqueue" rev="0.1.3">
  <artifact name="streamqueue" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='streamqueue', version='0.1.3')
)
libraryDependencies += "org.webjars.npm" % "streamqueue" % "0.1.3"
[org.webjars.npm/streamqueue "0.1.3"]

Dependencies

compile (2)

Group / Artifact Type Version
org.webjars.npm : readable-stream jar [1.0.33,1.1)
org.webjars.npm : isstream jar [0.1.1,0.2)

Project Modules

There are no modules declared in this project.

streamqueue

StreamQueue pipe the queued streams one by one in order to preserve their content order.

NPM version Build status Dependency Status devDependency Status Coverage Status Code Climate Dependency Status

## Usage Install the npm module:

npm install streamqueue --save

Then, in your scripts:

var streamqueue = require('streamqueue');

var queue = streamqueue(
  Fs.createReadStream('input.txt'),
  Fs.createReadStream('input2.txt'),
  Fs.createReadStream('input3.txt')
).pipe(process.stdout);

StreamQueue also accept functions returning streams, the above can be written like this, doing system calls only when piping:

var streamqueue = require('streamqueue');

var queue = streamqueue(
  Fs.createReadStream.bind(null, 'input.txt'),
  Fs.createReadStream.bind(null, 'input2.txt'),
  Fs.createReadStream.bind(null, 'input3.txt')
).pipe(process.stdout);

Object-oriented traditionnal API offers more flexibility:

var StreamQueue = require('streamqueue');

var queue = new StreamQueue();
queue.queue(
  Fs.createReadStream('input.txt'),
  Fs.createReadStream('input2.txt'),
  Fs.createReadStream('input3.txt')
);
queue.done();

queue.pipe(process.stdout);

You can also chain StreamQueue methods like that:

var StreamQueue = require('streamqueue');

new StreamQueue()
  .queue(Fs.createReadStream('input.txt'))
  .queue(Fs.createReadStream('input2.txt'))
  .queue(Fs.createReadStream('input3.txt'))
  .done()
  .pipe(process.stdout);

You can queue new streams at any moment until you call the done() method. So the created stream will not fire the end event until done() call.

Note that stream queue is compatible with the Node 0.10+ streams. For older streams, stream queue will wrap them with Readable.wrap before queueing. Please fix your dependencies or report issues to libraries using 0.8 streams since this extra code will finally be removed.

API

StreamQueue([options], [stream1, stream2, ... streamN])

options

options.objectMode

Type: Boolean Default value: false

Use if piped in streams are in object mode. In this case, the stream queue will also be in the object mode.

options.pauseFlowingStream

Type: Boolean Default value: true

If a stream is in flowing mode, then it will be paused before queueing.

options.resumeFlowingStream

Type: Boolean Default value: true

If a stream is in flowing mode, then it will be resumed before piping.

options.*

StreamQueue inherits of Stream.PassThrough, the options are passed to the parent constructor so you can use it's options too.

streamN

Type: Stream

Append streams given in argument to the queue and ends when the queue is empty.

StreamQueue.queue(stream1, [stream2, ... streamN])

Append streams given in argument to the queue.

StreamQueue.done([stream1, stream2, ... streamN])

Append streams given in argument to the queue and ends when the queue is empty.

StreamQueue.obj([options], [stream1, stream2, ... streamN])

A shortcut for StreamQueue({objectMode: true}).

Stats

NPM NPM

Contributing

Feel free to pull your code if you agree with publishing it under the MIT license.

License

MIT

Versions

Version
0.1.3
0.0.6