subset

1.1.0 • Public • Published

Subset

npm status build status dependency status coverage status

Subset provides basic and generalized set operations for JavaScript. They are inspired by a subset of the interface to Haskell's Data.List, but optimized for JavaScript semantics.

The new ES6 Set class is not particularly helpful for doing set operations on general objects (as their only version of equality is ===), and this module provides a general alternative for people who want to do the same-ish things on arrays.

Usage

Use it with qualified imports with the yet unfinished module import syntax or attach it to the short variable of choice. For selling points, here's how it will look with ES7 modules.

import { equality, union, unionBy, intersect, unique, uniqueBy, insert, delete, group } from 'autonomy'
 
intersect([1,2,3,4], [2,4,6,8]); // [ 2, 4 ]
 
union([1,3,5], [4,5,6]); // [ 1, 3, 5, 4, 6 ]
unionBy(equality('a'), [{ a: 1 }, { a: 3 }], [{ a: 2 }, { a: 3 }]);
// [ { a: 1 }, { a: 3 }, { a: 2 } ]
 
unique([1,3,2,4,1,2]); // [ 1, 3, 2, 4 ]
 
var notCoprime = (x, y) => gcd(x, y) > 1;
var primes = uniqueBy(notCoprime, [2,3,4,5,6,7,8,9,10,11,12]); // [ 2, 3, 5, 7, 11 ]
 
group([1,2,2,3,5,5,2]); // [ [1], [2,2], [3], [5,5], [2] ]
 
insert([1,2,3,4], 3); // [ 1, 2, 3, 3, 4 ]
 
delete([1,2,3,2,3], 2); // [ 1, 3, 2, 3 ]

Read the full API.

Note that it is often useful to get it with the larger utility library interlude for which it was made.

License

MIT-Licensed. See LICENSE file for details.

Package Sidebar

Install

npm i subset

Weekly Downloads

1,267

Version

1.1.0

License

MIT

Last publish

Collaborators

  • clux