A practical functional library for Javascript programmers.

Our basic data structures will be normal Javascript objects, and our usual collections will be Javascript arrays. We will not try to reach the point where all the functions have only zero, one, or two arguments. We will certainly try to keep some of the normal features of Javascript that seem to be unusual in functional languages, including variable length function signatures and functions as objects with properties.

Functional programming is in good part about immutable objects and side-effect free functions. We will stick to that as much as feasible, but will not be dogmatic about it.

As much as we can, we would like the implementation to be both clean and elegant. But the API is king: we will sacrifice a great deal of implementation elegance for even a slightly cleaner API.

Unlike the developers of that silly-named Eweda project, though, this one will focues also on performance, striving for a reliable and quick implementation over any notions of functional purity.

Please review the annotated source code documentation (generated by Docco). So far, that's the only documentation available.

Ok, so we like sheep. That's all. It's a short name, not already taken. It could as easily have been eweda, but then we would be forced to say eweda lamb!, and no one wants that For non-English speakers, lambs are baby sheep, ewes are female sheep, and rams are male sheep. So perhaps ramda is a grown-up lambda... but probably not.

The functions included should automatically allow for partial application without an explicit call to lPartial. Many of these operate on lists. A single list parameter should probably come last, which might conflict with the design of other libraries that have strong functional components (I'm looking at you Underscore!)

The idea is that, if foldl has this signature:

var foldl = function(fn, accum, arr) { /* ... */}

and we have this simple function:

var add = function(a, b) {return a + b;};

then, instead of having to manually call lPartial like this:

 var sum = lPartial(foldl, add, 0);
 var total = sum([1, 2, 3, 4]);

we could just do this:

 var sum = foldl(add, 0);
 var total = sum([1, 2, 3, 4]);

We want to include the basic functions that will help a Javscript programmer work with objects and arrays. We will try to use the most common names for these, possibly using multiple aliases for those that are most debated.

• isEmpty
• prepend
• append
• merge
• head
• tail
• size

• compose (fog)
• pipe (sequence) (i.e., like compose but in reverse order)
• flip
• partial (applyLeft)
• rPartial (applyRight)
• memoize
• once
• wrap

• map
• foldl (reduce)
• foldl1
• foldr (reduceRight)
• foldr1
• filter
• reject
• take
• skip (drop)
• find
• all (every)
• any (some)
• contains
• uniq
• pluck
• flatten
• zip
• zipWith
• xprod (i.e. cartesian product)
• xprodWith (i.e. cartesian product with function)
• reverse
• range

• tap (K)
• eq
• prop
• func
• props
• identity (I)
• alwaysTrue
• alwaysFalse
• alwaysZero
• maybe
• keys
• values

• and
• or
• not
• andFn
• orFn
• notFn

• add
• multiply
• subtract
• divide
• sum
• product