https://github.com/roobie/mori-ext

Function bind syntax wrappers for mori
https://github.com/roobie/mori-ext

functional-programming immutable wrapper

Last synced: about 2 months ago
JSON representation

Function bind syntax wrappers for mori

• Host: GitHub
• URL: https://github.com/roobie/mori-ext
• Owner: roobie
• License: other
• Created: 2015-06-24T06:34:17.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2016-07-12T17:46:38.000Z (over 9 years ago)
• Last Synced: 2025-08-09T11:24:31.791Z (7 months ago)
• Topics: functional-programming, immutable, wrapper
• Language: JavaScript
• Size: 30.3 KB
• Stars: 16
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# mori-ext

[Function bind syntax](https://github.com/zenparsing/es-function-bind) wrappers for [mori](http://swannodette.github.io/mori)

### immutable data structures + LINQ in javascript

```

\__   __ \_______ \______   \___         \_______ \__  \__ \_______

|  |_|  ||       ||    _ |  |   |        |       ||  |_|  ||       |

|       ||   _   ||   | ||  |   |  ____  |    ___||       ||_     _|

|       ||  | |  ||   |_||_ |   | |____| |   |___ |       |  |   |  

|       ||  |_|  ||    __  ||   |        |    ___| |     |   |   |  

| ||_|| ||       ||   |  | ||   |        |   |___ |   _   |  |   |  

|_|   |_||_______||___|  |_||___|        |_______||__| |__|  |___|  

```

thanks http://patorjk.com/software/taag

#### Quick example

```javascript

import { vector } from 'mori';

import { assoc, equals } from 'mori-ext';

const v1 = vector('foo', 'bar', 'baz');

const v2 = v1::assoc(1, 'quux');

const v3 = vector('foo', 'quux', 'baz');

v2::equals(v3); // => true

```

## How?

Using [babeljs](https://babeljs.io/) everyone can use this syntax.

[Look at an example using gulp](https://github.com/roobie/mori-ext/blob/master/gulpfile.js#L28-L32)

Also, copy the [`.babelrc`](https://github.com/roobie/mori-ext/blob/master/.babelrc) file, in order to enable the required language features in `babeljs`.

This effort is inspired by [trine](https://github.com/jussi-kalliokoski/trine)

## Installation

`npm install --save mori-ext`

see https://www.npmjs.com/package/mori-ext

#### runtime dependencies

mori,

babel-runtime,

## Usage

[Review the spec](https://github.com/roobie/mori-ext/blob/master/spec/basic.js) (covers the majority of the API)

# API

`mori-ext`'s  API is mostly based on collections being the first argument to `mori` functions, i.e.

```javascript

import mori from 'mori';

import { equals, isList } from 'mori-ext';

const coll = mori.vector(1, 2, 3);

mori.isList(coll);

// is equivalent to

coll::isList();

// and

mori.equals(coll1, coll2);

// is equivalent to

coll1::equals(coll2);

```

However, not all functions operate on a single collection, or even, on collections at all, so some consideration has been taken into account, e.g.

```javascript

import { list, vector, seq } from 'mori';

import { mapcat, cons } from 'mori-ext';

// mapcat

((x, y) => list(x, x + y))

  ::mapcat(seq('abc'), seq('123'));

// => ('a' 'a1' 'b' 'b2' 'c' 'c3')

// cons (converts collection into seq)

1::cons(vector(2, 3))

// => (1 2 3)

```

## Exported values

Fundamentals

    equals

    hash

Type Predicates

    isList

    isSeq

    isVector

    isMap

    isSet

    isCollection

    isSequential

    isAssociative

    isCounted

    isIndexed

    isReduceable

    isSeqable

    isReversible

Collections

    list

    vector

    hashMap

    set

    sortedSet

    range

    queue

Collection Operations

    conj

    into

    assoc

    dissoc

    distinct

    empty

    get

    getIn

    hasKey

    find

    nth

    last

    assocIn

    updateIn

    count

    isEmpty

    peek

    pop

    zipmap

    reverse

Vector Operations

    subvec

Hash Map Operations

    keys

    vals

    merge

Set Operations

    disj

    union

    intersection

    difference

    isSubset

    isSuperset

Sequences

    first

    rest

    seq

    cons

    concat

    flatten

    intoArray

    each

    map

    mapcat

    filter

    remove

    reduce

    reduceKV

    take

    takeWhile

    drop

    dropWhile

    some

    every

    sort

    sortBy

    interpose

    interleave

    iterate

    repeat

    repeatedly

    partition

    partitionBy

    groupBy

Helpers

    primSeq

    identity

    constantly

    inc

    dec

    sum

    isEven

    isOdd

    comp

    juxt

    knit

    pipeline

    partial

    curry

    fnil

    toClj

    toJs