@flybondi/ramda-land

A collection of reusable functions for ramda

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
@flybondi/ramda-land
514.0.14a year ago4 years agoMinified + gzip package size for @flybondi/ramda-land in KB

Readme

@flybondi/ramda-land
ramda js-flybondi semantic-release js-semistandard-style code style: prettier
A comprehensive collection of utilities for Ramdaramda, providing a variety of useful, well tested, reusable functions.
yarn add @flybondi/ramda-land
yarn add ramda

Basic usage

Mix and match @flybondi/ramda-land functions with common ramda functions.
const { when } = require('ramda');
const { isNilOrEmpty, alwaysNew } = require('@flybondi/ramda-land');

const defaultToLife = when(isNilOrEmpty, alwaysNew({ life: 42 }));
defaultToLife(null); // -> { life: 42 }
defaultToLife({ foo: 'bar' }); // -> { foo: 'bar' }

Ramda overlap

currycurry, curryNcurry-n and nAryn-ary functions are exported by both @flybondi/ramda-land and ramda. They behave in the exact same way, except that @flybondi/ramda-land counterparts retain wrapped function names after currying. This is useful for debugging and error tracing purposes as the name of the original function passed to any of the aforementioned functions will now appear on stack traces and debuggers (instead of an anonymous or sometimes arbitrarily named, internal ramda function).
This change was already proposed to the Ramda team and a PR is pending approval.

> curry(function foo(x, y) { return x + y; });
[Function: foo]
> curry(function foo(x, y) { return x + y; })(1)
[Function: foo]

> curryN(2, function foo(x, y) { return x + y; })
[Function: foo]
> curryN(2, function foo(x, y) { return x + y; })(1)
[Function: foo]

> nAry(3, function foo(x, y) { return x + y; })
[Function: foo]

View on Githubgithub.