tiny-curry

A minimal utility similar to lodash.curry. For when every byte counts! Returns a series of functions that consume the original function's arguments one at a time until the original function's arity (or the passed arity) is met.

---

lodash.curry:
tiny-curry:

---

Install

1npm install @ngard/tiny-curry

Syntax

1curry(/* function [, arity] */);

Parameters

function - A function that will be called once the parameters are gathered through currying. arity - The number of curry functions to create before returning the result of the passed function called with the arguments. Defaults to function.length.

Returns

A series of functions that each take a single argument and apply those arguments to the supplied function once they have all been gathered. Each intermediate function also has a value method that may be invoked to apply the currently gathered arguments to the function.

Examples

1import { curry } from '@ngard/tiny-curry';
2
3function add(a, b) { return a + b; }
4// add.length = 2, the number of arguments it expects
5
6const curriedAdd = curry(add);
7const addTwo = curriedAdd(2);
8
9console.log(addTwo(5)); // logs '7'

1import { curry } from '@ngard/tiny-curry';
2
3function greet(name, title = 'Your Lordship') {
4  return `Good day,  ${name}, ${title}`;
5}
6// greet.length = 1, because defaulted arguments are not 'expected'
7
8const curriedGreet = curry(greet, 2);
9const greetBob = curriedGreet('Bob');
10
11console.log(greetBob('my friend')); // logs 'Good day, Bob, my friend'
12console.log(greetBob()); // logs 'Good day, Bob, Your Lordship'

1import { curry } from '@ngard/tiny-curry';
2
3function sum(...numbers) {
4  return numbers.reduce((total, number) => total + number);
5}
6// sum.length = 0, because rest arguments are not 'expected'
7
8const curriedSum = curry(sum, Infinity);
9
10// call `.value()` on an infinitely curried function to call the
11// original function with the gathered arguments
12const total = curriedSum(1)(2)(3)(4).value();
13
14console.log(total); // logs '10'