autonomy

Lightweight functional utility library complementing ES5

npm install autonomy
2 downloads in the last day
33 downloads in the last week
131 downloads in the last month

Autonomy Build Status

Autonomy is a lightweight functional helper library. It is meant to complement an ES5 style with curried helpers, math helpers, curried accessors and higher order looping constructs.

These library is partly inspired by Haskell's Prelude, but its exports are optimized for JavaScript semantics and performance. It does not try to make JavaScript into something it's not.

Usage

Attach it to the short variable of choice:

var $ = require('autonomy');

and get functional:

$.id(x) === x;
$.noop(x) === undefined;

var fn = $(fn1, fn2, fn3);
fn(a); // fn3(fn2(fn1(a)))

[1,3,2].map($.constant(5)); // [5, 5, 5]

[1,2,3,4,3].filter($.elem([1,3])); // [ 1, 3, 3 ]

[1,3,5,-1].some($.notElem([1,2,3,4,5])); // true

$.gcd(10, 15); // 5

[1,2,3,4,5,6].filter($.even); // [ 2, 4, 6 ]

$.range(5); // [ 1, 2, 3, 4, 5 ]

$.zip($.range(5), [1,2], [3,2,5]); // [ [ 1, 1, 3 ], [ 2, 2, 2 ] ]
$.zipWith($.gcd, [5, 10, 15], $.range(5)); // [ 1, 2, 3 ]

$.iterate(3, "ha!", function (str) {
  return "ha" + str
}); // [ 'ha!', 'haha!', 'hahaha!' ]

[[1,2], [3,4]].map($.invoke('join','w')); // [ '1w2', '3w4']

Read the read the API.

In most cases the operators module provides some almost must have additions to autonomy. You can just do $.extend($, require('operators')) to import all the helpers onto autonomy's object.

This modules makes up the core part of the larger utility library: interlude. If you find yourself extending with operators or subset a lot, you should use interlude instead (there's also more documentation included there).

Installation

$ npm install autonomy

Running tests

Install development dependencies

$ npm install

Run the tests

$ npm test

License

MIT-Licensed. See LICENSE file for details.

npm loves you