❤
npm
Sign UpSign In

paretojs
TypeScript icon, indicating that this package has built-in type declarations

3.7.0 • Public • Published

pareto.js

An extremely small, intuitive and fast functional utility library for JavaScript

  • Only 14 core functions
  • Written in TypeScript
  • Encourages immutability
  • Only pure functions (no side-effects)
  • Smaller than lodash

build downloads npm

Example

import { flatten, tail } from 'paretojs'
 
flatten([1, 2, [3, 4], 5]) // [1, 2, 3, 4, 5]
tail([1, 2, 3]) // [2, 3]

Installation

To install the stable version:

npm install --save paretojs

This assumes that you’re using npm with a module bundler like Webpack

How

ES2015 or TypeScript:

import _ from 'paretojs'

or

import { chunk, debounce } from 'paretojs'

CommonJS:

var _ = require('paretojs');

or

var chunk = require('paretojs').chunk;
var debounce = require('paretojs').debounce;

UMD:

<script src="https://unpkg.com/paretojs/dist/paretojs.min.js"></script>

API

chunk

Returns the chunk of an array based on an integer n

import { chunk } from 'paretojs';
 
chunk([1,2,3,4,5,6,7], 3); // [ [1,2,3], [4,5,6], [7] ]

compose

Gets a composed function

import { compose } from 'paretojs';
 
const toUpperCase = x => x.toUpperCase();
const exclaim = x => x + '!!!';
 
const angry = compose(toUpperCase, exclaim);
 
angry('stop'); // 'STOP!!!

curry

Gets a curried function

import { curry } from 'paretojs';
 
const add = (x, y) => x + y;
 
curry(add, 1, 2); // 3
curry(add)(1)(2); // 3
curry(add)(1, 2); // 3
curry(add, 1)(2); // 3

debounce

Creates and returns a new debounced version of the passed function which will postpone its execution until after wait milliseconds have elapsed since the last time it was invoked.

import { debounce } from 'paretojs';
 
let a = 1;
const fn = () => a = 42;
 
const debounce = debounce(fn, 500);
debounce();
 
console.log(a); // 1 before 500ms
 
console.log(a); // 42 after 500ms

deepCopy

Creates a deep copy of an object

import { deepCopy } from 'paretojs';
 
const object = {
  a: 1,
  b: 2,
  c: {
    d: 3,
  },
};
 
deepCopy(object); // { a: 1, b: 2, c: { d: 3} }

flatMap

Generates a flattened array by iterating through a collection and applying a function to each element

import { flatMap } from 'paretojs';
 
const inc = n => n + 1;
flatMap([1, 2, 3], inc)); // [2, 3, 4]
 
const dup = n => [n, n];
flatMap([1, 2, 3], dup)); // [1, 1, 2, 2, 3, 3]
 
const sq = n => n ** 2;
flatMap([1, 2, 3], sq)) // [1, 4, 9]

flatten

Flattens (recursively) an array

import { flatten } from 'paretojs';
 
flatten([1, [2, 3], 4]); // [1, 2, 3, 4]

get

Gets the value of an object property based on a string path provided. If the property is not found, the defaultValues is returned

import { get } from 'paretojs';
 
get({ a: 1 }, "a")); // 1
get({ a: 1 }, "b", "default")); // "default"
get({ a: { b: 2 } }, "a")); // { b: 2 }
get({ a: { b: 2 } }, "a.b")); // 2
get({ a: { b: 2 } }, "a.c")); // undefined

matches

Checks if an objects matches with some properties

import { matches } from 'paretojs';
 
const object1 = { a: 1, b: 2 };
 
matches(object1, { a: 1 }); // true
matches(object1, { a: 1, b: 2 }); // true
matches(object1, { a: 3 }); // false

memoize

Creates a function that memoizes (caches) the result

import { memoize } from 'paretojs';
 
let count = 0;
 
const square = x => {
  count = count + 1;
  return x * x;
};
 
const memoSquare = memoize(square);
 
count; // 0
memoSquare(10); // 100
memoSquare(10); // 100
memoSquare(10); // 100
count; // 1

pipe

Creates and returns a new function that performs a left-to-right function composition.

import { pipe } from 'paretojs';
 
const increment = x => x + 1;
const decrement = x => x - 1;
 
const piped = pipe(increment, increment, decrement);
piped(0); // 1

prop

Gets the property of an object

import { prop } from 'paretojs';
 
const object = {
  label: 'custom label',
};
 
prop('label', object); // custom label

sort

Sorts a collection based on a property

import { sort } from 'paretojs';
 
const collection = [
  {
    id: 2,
  },
  {
    id: 1,
  },
];
 
sort(collection, 'id'); // [{ id: 1 }, { id: 2 }]

tail

Gets all, except the first element of an array.

import { tail } from 'paretojs';
 
tail([1, 2, 3]); // [2, 3]

Misc

If you want to add a new function, please open an issue and explain why.

Docs

Readme

Keywords

Package Sidebar

Install

npm i paretojs

Repository

github.com/concretesolutions/pareto.js

Homepage

github.com/concretesolutions/pareto.js#readme

Weekly Downloads

1

Version

3.7.0

License

MIT

Last publish

Collaborators

  • concretesolutions
  • matheusml
Try on RunKit
Report malware