# pull-cat

> concatenate pull-streams

Latest version **1.1.11** (published 2016-08-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install pull-cat
pnpm add pull-cat
yarn add pull-cat
bun add pull-cat
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.11 |
| Published | 2016-08-09 |
| First published | 2013-04-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 10 |
| Author | Dominic Tarr |
| Maintainers | dominictarr |

## Links

- npm: https://www.npmjs.com/package/pull-cat
- Repository: https://github.com/pull-stream/pull-cat
- Issues: https://github.com/pull-stream/pull-cat/issues
- npm.io page: https://npm.io/package/pull-cat

## Recent versions

- 1.1.11 (latest) — 2016-08-09
- 1.1.10 — 2016-07-13
- 1.1.9 — 2016-02-17
- 1.1.8 — 2015-07-30
- 1.1.7 — 2015-06-16
- 1.1.5 — 2013-11-14
- 1.1.4 — 2013-05-30
- 1.1.3 — 2013-05-30
- 1.1.2 — 2013-04-27
- 1.1.1 — 2013-04-13
- 1.1.0 — 2013-04-13
- 1.0.3 — 2013-04-05
- 1.0.2 — 2013-04-05
- 1.0.1 — 2013-04-05
- 1.0.0 — 2013-04-03

## README

# pull-cat

> Concatenate pull-streams

## Install

```shell
npm install --save pull-cat
```

## Example

Construct a new source stream from a sequential list of source streams,
reading from each one in turn until it ends, then the next, etc.
If one stream errors, then the rest of the streams are aborted immediately.
If the cat stream is aborted (i.e. if it's sink errors) then all the streams
are aborted.

A cat stream is a moderately challenging stream to implement,
especially in the context of error states.

```js
var cat = require('pull-cat')
var pull = require('pull-stream')

pull(
  cat([
    pull.values([1,2,3]),
    pull.values([4,5,6])
  ]),
  pull.log()
)
// 1
// 2
// 3
// 4
// 5
// 6
```


## Api

### `cat = require('pull-cat')`

### `stream = cat(streams)`

Reads from each stream in `streams` until finished.

If a stream errors, stop all the streams.
if the concatenated stream is aborted, abort all the streams,
then callback to the aborter.

## License

MIT

---
_Source: https://npm.io/package/pull-cat · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._