Skip to content

pipe, pipeline, and compose functions with 64 overloads per function.

License

Notifications You must be signed in to change notification settings

KSXGitHub/deno-compose

Repository files navigation

Overload Definition of Pipe and Compose

pipe, pipeline, and compose functions with 64 overloads per function.

What's the point?

This package not only provides simple pipe, pipeline, and compose implementation, it also provides 64 TypeScript overloads for each function. [See index.d.ts]

Usage

Import as module

URLs to import from: (replace :VERSION with suitable version, which are git tags)

  • GitHub User Content: https://raw.githubusercontent.com/KSXGitHub/deno-compose/:VERSION/index.js
  • GitHub Pages: https://ksxgithub.github.io/deno-compose/index.js (always master branch)
  • Deno Third-Party Modules: https://deno.land/x/compose@:VERSION/index.js

Code Example:

import {
  pipe,
  pipeline,
  compose,
  pipeUnary,
  pipelineUnary,
  composeUnary,
} from 'https://deno.land/x/[email protected]/index.js'

APIs

pipe

Signature: pipe (value, ...functions) → result

const y = pipe(x0, f1, f2, f3)

is equivalent to

const x1 = f1(x0)
const x2 = f2(x1)
const y = f3(x2)

or

const y = f3(f2(f1(x0)))

pipeline

Signature: pipeline (...functions) → function

const fn = pipeline(f0, f1, f2, f3)

is equivalent to

const fn = (...args) => f3(f2(f1(f0(...args))))

compose

Signature: compose (...functions) → function

const fn = compose(f3, f2, f1, f0)

is equivalent to

const fn = (...args) => f3(f2(f1(f0(...args))))

pipelineUnary

Signature: pipeline (...functions) → function

const fn = pipe(f0, f1, f2, f3)

is equivalent to

const fn = x => f3(f2(f1(f0(x))))

composeUnary

Signature: compose (...functions) → function

const fn = compose(f3, f2, f1, f0)

is equivalent to

const fn = x => f3(f2(f1(f0(x))))

composeRight

It is just an alias of pipeline

composeUnaryRight

It is just an alias of pipelineUnary

Example

// pipe
const y0 = pipe(x, f1, f2, f3, f4)

// pipeline
const g1 = pipeline(f0, f1, f2, f3, f4)
const y1 = g1(...args)

// compose
const g2 = compose(f4, f3, f2, f1, f0)
const y2 = g2(...args)

Development

Code Style

This project is formatted according to sane-fmt.

License

MIT © Hoàng Văn Khải