prime-util

Prime-Util

Your utilities for prime

Install

npm install prime-util

Current Modules Docs

prime/mixin

Mixin other primes into another prime

var mixin = require('prime-util/prime/mixin')
mixin(MyPrime, Options, Events)

prime/bound

Provides an alternative way to bind class methods. Stores references to bound methods internally without any manual setup and does not modify the original methods.

var bound = require("prime-util/prime/bound")
var mixin = require("prime-util/prime/mixin")

var MyPrime = prime({
    constructor: function(){
        this.results = []
    },
    method: function(i){
        this.results.push(i)
    },
    run: function(){
        [1, 2, 3].forEach(function(this.bound('method')))
        console.log(this.results) // [1, 2, 3]
    }
})
mixin(MyPrime, bound)

prime/parentize

Parentize makes it easier to call overridden parent methods.

var parentize = require('prime-util/prime/parentize')
var array = require('prime/array')
var mixin = require('prime-util/prime/mixin')
var A = prime({
    a: function(){
        return array.join(arguments)
    }
})
var B = prime({
    inherits: A,
    a: function(){
        // first argument is the parent method name, in this case 'a'
        // the other parameters are passed as the parent method arguments
        return this.parent('a', 'b', 'c') + ',d'
    }
})
mixin(B, parentize)
var b = new B
console.log(b) // logs "b,c,d"

prime/options

Provide "setOptions" method.

var prime = require('prime')
var Options = require('prime-util/prime/options')

var A = prime({

    options: {
        'a': 'aaa',
        'b': 'bbb',
        'c': {
            'd': 'ddd',
            'e': 'eee'
        }
    },

    constructor: function(options){
        this.setOptions(options)
    }

})

mixin(A, Options)

var a = new A({'b': 'B', 'c': {'e': 'E'}})
console.log(a.options); // {'a': 'aaa', 'b': 'B', 'c': {'d': 'ddd', 'e': 'E'}}

shell/array

Familiar MooTools Array functions. This module puts the array functions listed below in the prime array shell.

var array = require('prime-util/shell/array')
array.contains([1, 2, 3], 2) // true

array/clean

Create a new array with all elements that are not null or undefined.

var clean = require('prime-util/array/clean')

clean([null, 2, "foo", undefined]) // [2, "foo"]

array/invoke

Return an array with the named method applied on the array's content.

invoke([
    {a: function(arg){ console.log("first", arg)}},
    {a: function(arg){ console.log("second", arg)}}
], 'a', "thing") // logs "first thing" "second thing"

array/associate

Creates an object with key-value pairs based on the array of keywords passed in and the current content of the array.

var animals = ['Cow', 'Pig', 'Dog', 'Cat']
var sounds = ['Moo', 'Oink', 'Woof', 'Miao']
associate(sounds, animals)
// returns {'Cow': 'Moo', 'Pig': 'Oink', 'Dog': 'Woof', 'Cat': 'Miao'}

array/contains

Returns true if a value is in the array, otherwise it returns false.

array/append

Appends the passed array to the end of the current array.

append([1, 2, 3], [4, 5, [6]]) // [1, 2, 3, 4, 5, [6]]

array/last

Returns the last value of the array.

last([1, 2, 3]) // 3

array/random

Returns a random item from the array.

array/include

Pushes the passed element into the array if it's not already present (case and type sensitive).

include(['Cow', 'Pig', 'Dog'], 'Cat') // returns ['Cow', 'Pig', 'Dog', 'Cat']
include(['Cow', 'Pig', 'Dog'], 'Dog') // returns ['Cow', 'Pig', 'Dog']

array/combine

Combines an array with all the items of another. Does not allow duplicates and is case and type sensitive.

var animals = ['Cow', 'Pig', 'Dog']
combine(animals, ['Cat', 'Dog']; //animals = ['Cow', 'Pig', 'Dog', 'Cat']

array/empty

Empties an array.

var myArray = ['old', 'data']
empty(myArray)) // myArray is now []

array/pick

Returns the first defined value of the array passed in, or null.

pick(["foo", "bar"]) // "foo"
pick([null, "bar"]) // "bar"

array/find

Returns the first item in the array for which the function returns true.

find([1, 2, 3, 4, 5], function(number){
    return number == 2
}) // returns 2

shell/object

Add the object functions to the prime object shell

var object = require('prime-util/shell/object')
object.fromPath({a: {b: 1}}, 'a.b')

object/merge

Merges different objects into one object.

var merge = require('prime-util/object/merge')
merge({a: 1}, {a: 2, b: 3}, {c: 4}) // {a: 2, b: 3, c: 4}

object/fromPath

Returns the value at a given path

var fromPath = require('prime-util/object/fromPath')
var demo = {'a': {'b': {'c': 'prime!'}}};
fromPath(demo, 'a.b.c') // prime!