Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/caolan/highland
High-level streams library for Node.js and the browser
https://github.com/caolan/highland
Last synced: 26 days ago
JSON representation
High-level streams library for Node.js and the browser
- Host: GitHub
- URL: https://github.com/caolan/highland
- Owner: caolan
- License: apache-2.0
- Created: 2012-08-25T05:18:11.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2020-06-18T07:57:58.000Z (over 4 years ago)
- Last Synced: 2024-06-26T01:21:20.644Z (5 months ago)
- Language: JavaScript
- Homepage: https://caolan.github.io/highland
- Size: 5.59 MB
- Stars: 3,423
- Watchers: 67
- Forks: 145
- Open Issues: 129
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: Contributing.md
- License: LICENSE
Awesome Lists containing this project
- awesome-nodejs-cn - Highland.js - 仅使用标准JavaScript 和类似 Node 的流，即可轻松管理同步和异步代码 (包 / 流程控制)
- awesome-nodejs-cn - Highland.js - **star:3422** 使用标准JavaScript和类似节点的流，轻松管理同步和异步代码 ![star > 2000][Awesome] (包 / 控制流)
- awesome-github-repos - caolan/highland - High-level streams library for Node.js and the browser (JavaScript)
- awesome-nodejs - Highland.js - Manages synchronous and asynchronous code easily, using nothing more than standard JavaScript and Node-like Streams. (Packages / Control flow)
- awesome-nodejs - highland - High-level streams library for Node.js and the browser - ★ 3036 (Control flow)
- awesome-node - Highland.js - Manages synchronous and asynchronous code easily, using nothing more than standard JavaScript and Node-like Streams. (Packages / Control flow)
- awesome-nodejs-cn - Highland.js - 仅使用标准JavaScript和类似Node的流，即可轻松管理同步和异步代码. (目录 / 流程控制)
- awesome-starred - caolan/highland - High-level streams library for Node.js and the browser (others)
README
# Highland
The high-level streams library for Node.js and the browser.
View the [Highland website](https://caolan.github.io/highland) for more in-depth
documentation.
[](http://travis-ci.org/caolan/highland)
[](https://gitter.im/caolan/highland?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## Introduction
Re-thinking the [JavaScript](http://underscorejs.org)
[utility](http://lodash.com) [belt](https://github.com/caolan/async),
Highland manages synchronous and asynchronous code easily, using nothing more than
standard JavaScript and Node-like Streams.
You may be familiar with Promises, EventEmitters and callbacks, but moving
between them is far from seamless. Thankfully, there exists a deeper abstraction
which can free our code. By updating the tools we use on Arrays, and applying them
to values distributed in time instead of space, we can discard plumbing and
focus on the important things. With Highland, you can switch between
synchronous and asynchronous data sources at will, without having to
re-write your code. Time to dive in!
Made by @caolan, with help and patience from friends :)
## Highland v3
This branch tracks the ongoing development of version 3.0, which will feature a
rewritten Highland core implementation, extensibility support, limited stream
lifecycle, and some breaking changes to certain transforms. See
[#179](https://github.com/caolan/highland/issues/179) and the [3.x
label](https://github.com/caolan/highland/issues?utf8=%E2%9C%93&q=label%3A3.x%20)
for more details. New features will only be added to this branch. However,
until 3.0 is released, we will still be doing bug fixes for the 2.x releases.
See the [2.x branch](https://github.com/caolan/highland/tree/2.x) for those
files.
Currently, the code is in a semi-stable state. The only major missing feature
is [`onDestroy` for higher-level
transforms](https://github.com/caolan/highland/issues/412). To try out the new
goodness, install the `next` tag from NPM.
```
npm install --save highland@next
```
## Interoperability
Highland implements the [Fantasy
Land](https://github.com/fantasyland/fantasy-land)
[Alternative](https://github.com/fantasyland/fantasy-land#alternative),
[Filterable](https://github.com/fantasyland/fantasy-land#filterable), and
[Monad](https://github.com/fantasyland/fantasy-land#monad)
specifications.
Highland supports
[Transducers](https://github.com/cognitect-labs/transducers-js) via the
`transduce` transform.
## Examples
Usage as a Node.js module
```javascript
var _ = require('highland');
```
Converting to/from Highland Streams
```javascript
_([1,2,3,4]).toArray(function (xs) {
// xs is [1,2,3,4]
});
```
Mapping over a Stream
```javascript
var doubled = _([1,2,3,4]).map(function (x) {
return x * 2;
});
```
Reading files in parallel (4 at once)
```javascript
var data = _(filenames).map(readFile).parallel(4);
```
Handling errors
```javascript
data.errors(function (err, rethrow) {
// handle or rethrow error
});
```
Piping to a Node Stream
```javascript
data.pipe(output);
```
Piping in data from Node Streams
```javascript
var output = fs.createWriteStream('output');
var docs = db.createReadStream();
// wrap a node stream and pipe to file
_(docs).filter(isBlogpost).pipe(output);
// or, pipe in a node stream directly:
var through = _.pipeline(_.filter(isBlogpost));
docs.pipe(through).pipe(output);
```
Handling events
```javascript
var clicks = _('click', btn).map(1);
var counter = clicks.scan(0, _.add);
counter.each(function (n) {
$('#count').text(n);
});
```
Learn more at [https://caolan.github.io/highland/](https://caolan.github.io/highland/)