@k88/pipe-compose

ES6-like pipe, compose, p-pipe, and p-compose in JavaScript, inspired by this Medium post.

What is it?

This library exports 6 functions: pipe, compose, cPipe, cCompose, pPipe, and pCompose.

$3

To paraphrase the Medium post, image you want to pipe the output of n-functions together. You'll end up with something like:

``js
reverse(get3Chars(uppercase('the-argument')));
// EHT
`

In this example, you first uppercase to get THE-ARGUMENT, then you get3Chars and have THE and finally you reverse it to get EHT.

With pipe you can accomplish the same thing using:

`js
pipe('the-argument', uppercase, get3Chars, reverse);
`

It helps to read this similar to bash's pipe |:

`bash
echo 'the-argument' | uppercase | get3Chars | reverse;
`

compose is the reverse of pipe. For example these two would return the same result.

`js
pipe('the-argument', uppercase, get3Chars, reverse);
compose('the-argument', reverse, get3Chars, uppercase);
`

$3

These are composable versions of pipe and compose, i.e.:

`js
const textModifier = cPipe(uppercase, get3Chars, reverse);

textModifier('the-argument');
// EHT

textModifier('another-argument');
// ONA
`

$3

There are also composable promise version of the pipe and compose.

`js
const calc = pPipe(add1, multiply2, divide3);
await calc(2);
// 2
`

In this example, we are creating a calculation function that takes in an number, and performs basic math operation on it. In this case, we are passing 2 and first adding 1 to it (giving us 3), then multiplying by 2 (giving us 6) and finally dividing by 3 (giving us back 2).

As before, pCompose would work in the reverse:

`js
const calc = pCompose(add1, multiply2, divide3);
await calc(6);
// 5
`

How to use it

$3

Install from npm:

`bash
npm install @k88/pipe-compose
`

and use it:

`js
import { pipe, compose } from '@k88/pipe-compose';
`

$3

All of these auxiliary functions are one-liner, so you can also just copy/paste them into your application:

`js
const pipe = (x, ...fns) => fns.reduce((v, f) => f(v), x);
const compose = (x, ...fns) => fns.reduceRight((v, f) => f(v), x);

const cPipe = (...fns) => (x) => => fns.reduce((v, f) => f(v), x);
const cCompose = (...fns) => (x) => fns.reduceRight((v, f) => f(v), x);

const pPipe = (...fns) => async (x) => fns.reduce(async (v, f) => f(await v), x);
const pCompose = (...fns) => async (x) => fns.reduceRight(async (v, f) => f(await v), x);
``