Function-pipe NPM

function-pipe

Functional composition for JS

Motivation

Javascript is a very powerful language. Why not make it even more powerful with a simple functional composition tool? Function pipe allows you to create functions by combining other functions, just like lego blocks.

Features

Supports Promises or any mixture of sync and async functions
First function in the pipe can accept multiple arguments
Peturns a promise when there is a promise in the pipe
Works synchronously when all the parts of the pipe are synchronous
Flattens nested arrays of functions

Installation

npm install function-pipe

Usage

import pipe from 'function-pipe'

const toUppercase = string => string.toUpperCase()
const reverse = string => string.split('').reverse().join('')
const splitInWords = string => string.split(' ')

// Simple use
const pipe1 = pipe(toUppercase, reverse, splitInWords)

console.log(pipe1('wow such very much doge!'))
// -> [ '!EGOD', 'HCUM', 'YREV', 'HCUS', 'WOW' ]

pipe1(Promise.resolve('wow such very much doge!'))
  .then(console.log)
// -> [ '!EGOD', 'HCUM', 'YREV', 'HCUS', 'WOW' ]

// Multiple arguments
const join = (separator, array) => array.join(separator)

const pipe2 = pipe(join, toUppercase)
console.log(pipe2('-', ['doge', 'wow']))
// -> 'DOGE-WOW'

// Async functions in the pipe
const asyncPipe = pipe(
  fetchFrom('http://some.com/resource/:id'),
  toJson(),
  map(conutItems)
)

asyncPipe('doge').then(console.log)

console.log(pipe5('wow such very much doge!'));