underscore-contrib

underscore-contrib

The brass buckles on Underscore's utility belt -- a contributors' library for Underscore.

Links

• Documentation
• Source repository
• Tickets and bug reports
• Maintainer's website

Why underscore-contrib?

While Underscore provides a bevy of useful tools to support functional programming in JavaScript, it can't (and shouldn't) be everything to everyone. Underscore-contrib is intended as a home for functions that, for various reasons, don't belong in Underscore proper. In particular, it aims to be:

• a home for functions that are limited in scope, but solve certain point problems, and
• a proving ground for features that belong in Underscore proper, but need some advocacy and/or evolution (or devolution) to get them there.

Use

First, you’ll need Underscore. Then you can grab the relevant underscore-contrib libraries and simply add something like the following to your pages:

<script type="text/javascript" src="underscore.js"></script>
<script type="text/javascript" src="underscore.object.builders.js"></script>

At the moment there are no cross-contrib dependencies (i.e. each library can stand by itself), but that may change in the future.

Contributing

There is still a lot of work to do around perf, documentation, examples, testing and distribution so any help in those areas is welcomed. Pull requests are accepted, but please search the issues before proposing a new sub-contrib or addition. Additionally, all patches and proposals should have strong documentation, motivating cases and tests. It would be nice if we could not only provide useful tools built on Underscore, but also provide an educational experience for why and how one might use them.

Other (potentially) useful sub-contribs include the following:

• String utilities
• Date/time utilities
• Validators
• Iterators
• Generators
• Promises
• Monads
• Currying
• Laziness
• Multimethods

What do these mean? Well, that’s up for discussion. :-)

Changelog

0.3.0

• Contrib now requires Underscore 1.6.0 or higher.
• Rename partition and partitionAll to chunk and chunkAll to avoid name conflicts with Underscore's partition - [#115][115]
• Added toQuery and fromQuery - [#134][134]
• Switch always to an alias of Underscore's constant. - [#132][132]
• The combinators sub-library now supports method combinators - [#14][14]