autonomy

Lightweight functional utility library complementing ES5

Autonomy

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.

Attach it to the short variable of choice:

var $ = require('autonomy');

and get functional:

$.id(x) === x;
$.noop(x) === ;
 
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.

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

$ npm install autonomy

Install development dependencies

$ npm install

Run the tests

$ npm test

MIT-Licensed. See LICENSE file for details.