commit
This commit is contained in:
parent
be4fd23bcf
commit
0bd53741af
728 changed files with 86573 additions and 0 deletions
58
node_modules/sandwich-stream/README.md
generated
vendored
Normal file
58
node_modules/sandwich-stream/README.md
generated
vendored
Normal file
|
@ -0,0 +1,58 @@
|
|||
# SandwichStream
|
||||
|
||||
[](https://www.npmjs.com/package/sandwich-stream)
|
||||
[](https://www.npmjs.com/package/sandwich-stream)
|
||||
[](https://travis-ci.org/connrs/node-sandwich-stream)
|
||||
[](https://codecov.io/gh/connrs/node-sandwich-stream)
|
||||
[](https://www.codacy.com/project/connrs/node-sandwich-stream/dashboard?utm_source=github.com&utm_medium=referral&utm_content=connrs/node-sandwich-stream&utm_campaign=Badge_Grade_Dashboard)
|
||||
[](https://codeclimate.com/github/connrs/node-sandwich-stream/master/package.json)
|
||||
[](https://snyk.io/test/github/connrs/node-sandwich-stream?targetFile=package.json)
|
||||
[](https://codeclimate.com/github/connrs/node-sandwich-stream/maintainability)
|
||||
|
||||
## About
|
||||
While I'm not overjoyed about how performant the internals will operate, I wanted a readable stream that was ACTUALLY A READABLE STREAM. Not a streams1 stream masquerading as streams2. As soon as somebody writes a better concat stream as a readable stream with a nice simple API, this baby is going to develop some serious abandonment issues.
|
||||
|
||||
## Installation
|
||||
```bash
|
||||
npm install sandwich-stream --save
|
||||
```
|
||||
|
||||
**note**: this code was made using it [TypeScript](https://www.typescriptlang.org/), and its typings are linked in [package.json](./package.json), so there's no need of installing _@types/sandwich-stream_ or anything related.
|
||||
|
||||
## Usage
|
||||
```typescript
|
||||
import { SandwichStream } from 'sandwich-stream';
|
||||
// OR EVEN:
|
||||
// const SandwichStream = require('sandwich-stream');
|
||||
|
||||
const sandwich = SandwichStream({
|
||||
head: 'Thing at the top\n',
|
||||
tail: '\nThing at the bottom',
|
||||
separator: '\n ---- \n'
|
||||
});
|
||||
|
||||
sandwich.add(aStreamIPreparedEarlier)
|
||||
.add(anotherStreamIPreparedEarlier)
|
||||
.add(aFurtherStreamIPreparedEarlier)
|
||||
.pipe(process.stdout);
|
||||
|
||||
// The thing at the top
|
||||
// ----
|
||||
// Stream1
|
||||
// ----
|
||||
// Stream2
|
||||
// ----
|
||||
// Stream3
|
||||
// The thing at the bottom
|
||||
```
|
||||
## Configuration Options
|
||||
* `head` option takes a string/buffer and pushes the string before all other content
|
||||
* `foot` option takes a string/buffer and pushes the string after all other data has been pushed
|
||||
* `separator` option pushes a string/buffer between each stream
|
||||
* [Readable Options](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/be662c475da091788139b486a55708f02e2880b6/types/node/index.d.ts#L6485) can also be passed through.
|
||||
|
||||
## API
|
||||
Too add a stream use the **.add** method: `sandwich.add(streamVariable);`
|
||||
|
||||
## More
|
||||
Wanna known more about Node Streams? Read [this](https://medium.freecodecamp.org/node-js-streams-everything-you-need-to-know-c9141306be93).
|
Loading…
Add table
Add a link
Reference in a new issue