uinix-fp

FP utilities for authoring common JS programs in functional form.

Contents

• Install
• Use
• API
• Project
  • Goals
  • Version
  • Contribute
  • Related
  • License

Install

This package is ESM-only and requires Node 12+.

npm install uinix-fp

You may also install specific packages individually.

npm install uinix-fp-i
npm install uinix-fp-map
npm install uinix-fp-noop
npm install uinix-fp-pipe
...

Note: uinix-fp is tree-shakeable and we recommend simply installing the main package if your build supports tree shaking.

Use

The following example shows usage of some uinix-fp programs supporting pointfree and currying ways to express common JS data transformations in a pipeline.

import {
  filter,
  isTruthy,
  map,
  pipe,
  props
} from 'uinix-fp';

const greet = x => 'Hi ' + x;

const exclaim = x => x + '!';

const filterTruthy = filter(isTruthy); // curried

const users = [
  null,
  {user: {firstName: 'Jesse'}},
  null,
  {user: {firstName: 'Walter'}},
  ...
];

const pipeline = pipe([
  filterTruthy, // [{user: {firstName: 'Jesse'}}, {user: {firstName: 'Walter'}}, ...]
  map(props('user.firstName')), // ['Jesse', 'Walter', ...]
  map(greet), // ['Hi Jesse', 'Hi Walter', ...]
  map(exclaim), // ['Hi Jesse!', 'Hi Walter!', ...]
])(users);

uinix-fp is unopinionated and you you can express your code appropriately for your functional style and needs. The following pipeline is equivalent to the previous pipeline.

const shoutFirstName = pipe([
  props('user.firstName'),
  greet,
  exclaim,
]);

const pipeline = pipe([
  filterTruthy,
  map(shoutFirstName),
])(users)

API

This package has no default export and exports the following identifiers:

• filter
• filterEntries
• i
• isPlainObject
• isTruthy
• k
• map
• mapEntries
• merge
• noop
• pipe
• prop
• props

APIs are explorable via JSDoc-based Typescript typings accompanying the source code.

Project

Goals

uinix-fp is fundamentally just a simple JS library of utilities. It aims to be JS-first and avoid opinionated domain-specific APIs.

uinix-fp programs follow the Unix philosophy, with each program maintaining simple and clear responsibilities, while remaining interoperable with other program and most importantly with core JS.

Strict formalization of FP principles and typings should not impede on the primary goal of providing a minimal set of utilities to help express common JS programs in functional form. If you are looking for a formal and rigorous set of FP utilities, please explore other libraries such as sanctuary and fp-ts.

Version

uinix-fp adheres to semver starting at 1.0.0.

Contribute

uinix-fp is a collection of smaller FP utilities managed under a monorepo of packages.

Node 18+ is required for development.

Install dependencies with npm i and run tests with npm test. You can also run other NPM scripts (e.g. lint) from the root of the monorepo.

Related

• uinix-js
• sanctuary
• fp-ts
• combinator-js

License

MIT © Chris Zhou