@barandis/utils v0.5.1
@barandis/utils
This is simply a library of small dependency-free utility functions. It's meant as a place for me to keep things for my own personal use, but if there's anything you find here that you'd like to use, please feel free (in accordance with the MIT License, of course).
I'm not planning on providing any documentation short of what's on this page, but there are extensive doc comments, and the unit tests probably provide the best documentation of all.
Installation
If you want to install the package, get it from npm.
npm install --save @barandis/utils
Once you do, you can import
or require
directly from @barandis/utils
as normal.
// import syntax
import * as utils from '@barandis/utils'
// require syntax
const utils = require('@barandis/utils')
Alternately, you can import individual modules by adding '/modules/<module-name>'
to the end of the package name. For example, if you only want to use a function out of the iterators
module, you can do this:
// import syntax
import * as iterators from '@barandis/utils/modules/iterators'
// require syntax
const iterators = require('@barandis/utils/modules/iterators')
The module to which each utility belongs is listed in the table of utilities below.
Utilities
Here's a list of the utilities available.
Name | Module | Description |
---|---|---|
compose | functions | Combines two or more functions into a single function |
curry | functions | Partially applies a function |
enumerate | iterators | Iterates over a collection, returning tuples of the value and its index |
final | objects | Creates a class whose instances cannot be modified |
flip | functions | Reverses the order of parameter lists in a curried function |
frozen | objects | Creates an extensible class whose instances cannot be modified |
Nothing | objects | A chainable object representing nothing |
NullClass | objects | A class that does not extend from Object |
ordinal | numbers | Appends a number with 'st' , 'nd' , 'rd' , or 'th' as appropriate |
pipe | functions | Composes functions in reverse order from compose |
pluck | collections | Extracts values from object collections by key |
range | ierators | Produces an iterator starting at a number and ending at another |
scan | collections | Like reduce but returns all of the intermediate reductions |
tracked | objects | Adds object tracking to a factory function |
wordinal | numbers | Turns a number into a word-based ordinal number |