Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
The brass buckles on Underscore's utility belt
branch: master
Failed to load latest commit information.
dist Bump to 0.3.0
docs change obj vars to playwrights
examples Complete the parse tree example.
test Add test for updated hasPath
.gitignore Added bower_components contents to .gitignore.
.jshintrc Change underscore import/export boiler plate (#186)
.travis.yml Configuration for Travis CI.
CHANGELOG.md Bump to 0.3.0
CONTRIBUTING.md Restructure contributor's guide. Fixes #165.
Gruntfile.js Change underscore import/export boiler plate (#186)
LICENSE Updating license files.
README.md Update README.md with info on purpose and use.
bower.json Bump to 0.3.0
index.html Expose _.keysFromPath. Fixes #178.
index.js _.attempt(object, 'method', [*arguments])
package.json Change underscore import/export boiler plate (#186)
tocdoc.css Added tocdoc and improved documentation intro.
underscore.array.builders.js Change underscore import/export boiler plate (#186)
underscore.array.selectors.js Change underscore import/export boiler plate (#186)
underscore.collections.walk.js Change underscore import/export boiler plate (#186)
underscore.function.arity.js Change underscore import/export boiler plate (#186)
underscore.function.combinators.js Change underscore import/export boiler plate (#186)
underscore.function.dispatch.js Change underscore import/export boiler plate (#186)
underscore.function.iterators.js Change underscore import/export boiler plate (#186)
underscore.function.predicates.js Change underscore import/export boiler plate (#186)
underscore.object.builders.js Change underscore import/export boiler plate (#186)
underscore.object.selectors.js Update hasPath
underscore.util.existential.js Change underscore import/export boiler plate (#186)
underscore.util.operators.js Change underscore import/export boiler plate (#186)
underscore.util.strings.js Change underscore import/export boiler plate (#186)
underscore.util.trampolines.js Change underscore import/export boiler plate (#186)

README.md

underscore-contrib

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

Links

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. :-)

Something went wrong with that request. Please try again.