Nosy Pinocchio Manners

    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.

    Install

    npm i subset

    DownloadsWeekly Downloads

    2,231

    Version

    1.1.0

    License

    MIT

    Last publish

    Collaborators

    • clux