isomorph

======================== Isomorph |travis_status|

.. |travis_status| image:: https://secure.travis-ci.org/insin/isomorph.png :target: http://travis-ci.org/insin/isomorph

Utilities which can be shared between browsers and Node.js_.

Browsers:

• isomorph.js_

Node.js::

npm install isomorph

.. _Node.js: http://nodejs.org .. _isomorph.js: https://raw.github.com/insin/isomorph/master/isomorph.js

is

Utilities for type-checking and more - anything which is a generic, reusable test which would naturally have a function name starting with "is".

Type-checking functions

| is.Array, | is.Boolean, | is.Date, | is.Error, | is.Function, | is.Number, | is.Object, | is.RegExp, | is.String

Determines if the given input is of the specified type.

Content-checking functions

is.Empty

Determines if the given Object has any enumerable properties.

func

Utilities for working with functions.

func.bind(fn, context[, arg1, ...])

Binds the given function to the given execution context (this when the function is called) and optionally partially applies any additional arguments.

The following properties are available on the bound function:

__func__ The original function which is being bound. __context__ The context to which the function is bound.

object

object.extend(dest[, src1, ...])

The classic extend method -- copies own properties from src arguments to dest, returning dest.

Does nothing for any src arguments which are falsy, so it's safe to pass in an options argument which is potentially undefined, e.g.::

function quiz(kwargs) { kwargs = object.extend({answer: 42, question: 'Meaning?'}, kwargs) // ... }

object.inherits(childConstructor, parentConstructor)

The classic inherits method -- puts parentConstructor's prototype in childConstructor's prototype chain, returning childConstructor.

object.items(obj)

Creates an Array of [property, value] pairs from an Object.

object.fromItems(items)

Creates an Object from an Array of [property, value] pairs.

::

function sortedFieldObj(fieldObj) { var fields = object.items(fieldObj) fields.sort(function(a, b) { return a[1].creationCounter - b[1].creationCounter }) return object.fromItems(fields) }

object.lookup(arr)

Creates a lookup Object from an Array, coercing each item in the Array to String and adding it to the resulting Object as a property whose value is true::

var ALLOWED_TAGS = ['div', 'span', 'h1'] , TAG_LOOKUP = object.lookup(ALLOWED_TAGS)

function elementify(tagName) { if (TAG_LOOKUP[tagName]) { console.log(tagName + ' is valid') } else { console.log(tagName + ' is not allowed') } }

format

format.format(str[, r1, ...])

Replaces "%s" placeholders in the given string with positional arguments.

format.formatArr(str, arr)

Replaces "%s" placeholders in the given string with arguments passed as an Array.

To output a literal '%', escape percentage signs by doubling them up::

format.format('%% Complete: %s%%', 95) // '% Complete: 95%'

format.formatObj(str, obj)

Replaces "{varName}" placeholders in the given string with same-named properties from a given object.

To output a literal '{varName}', double up the opening brace::

format.formatObj('{{foo}={foo}, {{bar}={bar}', {foo: 1, bar: 2}) // '{foo}=1, {bar}=2'

re

re.findAll(regex, str[, flags])

Uses a regular expression (given as a String or a RegExp object) to find and return matches in the given String, in the vein of Python's re.findall_.

If a single group is present in the RegExp, a list of matches will be returned. If more than one group is present, a list of lists of matches will be returned.

If regex is specified as a String, the flags argument can be used to specify the flags to be used when compiling the RegExp.

.. _re.findall: http://docs.python.org/library/re.html#re.findall

MIT License

Copyright (c) 2011, Jonathan Buchanan

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.