index.html

<style>body{
    font-family: Arial;
    background: #ddd;
    padding:20px;
    margin-left: 300px;
}

.menu{
    position:fixed;
    top:0;
    left:0;
    bottom:0;
    overflow-y: scroll;
    width: 300px;
    padding:5px;
    background: white;
}

.menu a{
    display: block;
    padding:5px;
    color: #333;
    text-decoration: none;
    overflow: hidden;
    text-overflow:ellipsis;
    white-space: nowrap;
    border-left: solid 1px #999;
    padding-left: 10px;
    margin-left: 5px;
}

.menu div{
    padding-left:10px;
    position: relative;
}

.menu a + div:before{
    content:"";
    position: absolute;
    left: 5px;
    top: 0;
    border: solid 5px #999;
    border-bottom-color: transparent;
    border-left-color: transparent;
}

.menu a + div:after{
    content:"";
    position: absolute;
    left: 6px;
    top: 0;
    border: solid 5px white;
    border-bottom-color: transparent;
    border-left-color: transparent;
}

pre{
    margin:10px;
    border:solid 1px #ccc;
    padding: 20px;
    background: white;
    box-shadow: 5px 5px 20px rgba(0,0,0,0.3);
    margin-bottom:30px;
}
code{
    padding: 5px;
    display: block;
    line-height: 12px;
    overflow: auto;
}

h1{
    font-size: 36px;
    padding:0 20px;
}

h2{
    color: #555;
    margin-top:30px 0;
    border-bottom: solid 3px #ccc;
}

h3, h4{
    color: #888;
    margin:10px;
    padding:5px 10px;
}

p{
    margin:10px 0;
    padding:0 10px;
}

section{
    margin-left: 20px;
}

.docyacode-block{
    margin: 20px 0;
    padding: 10px 20px;
    background-color: rgba(255,255,255,0.3);
}</style><script>// window.addEventListener('load', function(){
//     var docSections = document.querySelectorAll('[data-blockname]'),
//         menu = document.createElement('div');

//     menu.className = 'menu';

//     for(var i = 0; i < docSections.length; i++) {
//         var section = docSections[i],
//             sectionAnchor = document.createElement('a'),
//             sectionName = section.getAttribute('data-blockname');

//         section.insertBefore(sectionAnchor, section.firstChild);

//         var menuItem = document.createElement('a');
//         menuItem.innerText = sectionName;
//         menuItem.setAttribute('href', '#' + sectionName);

//         sectionAnchor.setAttribute('name', sectionName);
//         sectionAnchor.className = 'sectionAnchor';

//         menu.appendChild(menuItem);
//     }

//     document.body.insertBefore(menu, document.body.firstChild);
// });</script><div class="menu"><a href="#gaffa.js">gaffa.js</a><div><a href="#ViewItem">ViewItem</a><div><a href="#.actions">.actions</a><a href="#.path">.path</a></div><a href="#View">View</a><a href="#ContainerView">ContainerView</a><a href="#The gaffa instance">The gaffa instance</a><div><a href="#.addDefaultStyle">.addDefaultStyle</a><a href="#.createSpec">.createSpec</a><a href="#.jsonConverter">.jsonConverter</a><a href="#.initialiseViewItem">.initialiseViewItem</a><a href="#.events">.events</a><div><a href="#.on">.on</a></div><a href="#.model">.model</a><div><a href="#.get(path, viewItem, scope, asTokens)">.get(path, viewItem, scope, asTokens)</a><a href="#.set(path, value, viewItem, dirty)">.set(path, value, viewItem, dirty)</a><a href="#.remove(path, viewItem, dirty)">.remove(path, viewItem, dirty)</a><a href="#.bind(path, callback, viewItem)">.bind(path, callback, viewItem)</a><a href="#.debind(viewItem)">.debind(viewItem)</a><a href="#.isDirty(path, viewItem)">.isDirty(path, viewItem)</a><a href="#.setDirtyState(path, value, viewItem)">.setDirtyState(path, value, viewItem)</a></div><a href="#.views">.views</a><div><a href="#.renderTarget">.renderTarget</a><a href="#.add(View/viewModel, insertIndex)">.add(View/viewModel, insertIndex)</a><a href="#.remove(view/views)">.remove(view/views)</a><a href="#.empty()">.empty()</a><a href="#.constructors">.constructors</a></div><a href="#.namedViews">.namedViews</a><a href="#.actions">.actions</a><div><a href="#.trigger(actions, parent, scope, event)">.trigger(actions, parent, scope, event)</a><a href="#.constructors">.constructors</a></div><a href="#.behaviours">.behaviours</a><div><a href="#.add(behaviour)">.add(behaviour)</a><a href="#.constructors">.constructors</a></div><a href="#Navigate">Navigate</a></div></div><a href="#License">License</a></div><div class="docyacode-block" data-blockname="gaffa.js"><a name="gaffa.js"></a><h1>gaffa.js</h1>
<p><img src="logosmall.png" alt="logo"></p>
<h2>Example</h2>
<p><a href="http://korynunn.github.io/gaffa-todo/">Gaffa-ToDo</a></p>
<h2>Quick n easy setup</h2>
<pre><code>npm install gaffa-boilerplate</code></pre>
<p>Then make a folder for your test project.</p>
<pre><code>gaffa-boilerplate</code></pre>
<p>This will copy some boilerplate files and start a file watcher that browserifys app.js, in the scripts folder.</p>
<h2>Overview</h2>
<p>Gaffa attempts to speed up the development of complicated UI&#39;s by providing a rich binding layer between arbitrary data and your UI.</p>
<p>Writing UI&#39;s using gaffa is unlike most other MVC/MVVM/etc frameworks for a number of different reasons. (Although, others share some of the below points)</p>
<ul>
<li><p>ASAP databinding - model change events are instantaneous</p>
</li>
<li><p>Extremely powerful model bindings - use complex expressions to bind to data</p>
</li>
<li><p>UI by transform  - Use transforms over data to affect how data is displated, rather than modifying the data to suite the UI.</p>
</li>
<li><p>NO HTML! - Javascript to DOM, no pointless middleman.</p>
</li>
<li><p>Serialise to JSON - An entire application can be serialised to JSON, by design.</p>
</li>
<li><p>No lock-in - Push your views to the edge of Gaffa&#39;s capabilities, and break out whenever you need.</p>
</li>
</ul>
<h3>Dependencies</h3>
<p>Gaffa must be compiled with browserify <a href="https://github.com/substack/node-browserify">browserify</a></p>
<h3>Minimal usage</h3>
<pre><code>var Gaffa = require(&#39;gaffa&#39;),

    gaffa = new Gaffa();</code></pre>
<h3>The Bits..</h3>
<p>A Gaffa application consists of 2 high-level bits:</p>
<ul>
<li><p>Many ViewItems</p>
</li>
<li><p>One model</p>
</li>
</ul>
<h3>ViewItems</h3>
<p>ViewItems can be <strong>Views</strong>, <strong>Actions</strong>, or <strong>Behaviours</strong>.</p>
<p>ViewItems represent and can affect the model, they are combined to create a UI.</p>
<p>a View is a ViewItem that has a renderedElement, be it some DOM, or any other abstract UI element, such as a google maps pin object.</p>
<p>To use a view, you must first load the constructor for that view. For example, to use a label, and a textbox, the label.js and textbox.js files must be required(). Every viewItem must be added to its appropriate constructors object in gaffa, eg:</p>
<pre><code>// Add viewItem constructors to gaffa. Only use what you need.



// Views

gaffa.views.constructors = {

    label: require(&#39;gaffa/views/label&#39;),

    textbox: require(&#39;gaffa/views/textbox&#39;),

    button: require(&#39;gaffa/views/button&#39;)

};



// Actions

gaffa.actions.constructors = {

    remove: require(&#39;gaffa/actions/remove&#39;)

};



// Behaviours

gaffa.actions.constructors = {

    pageLoad: require(&#39;gaffa/behaviours/pageLoad&#39;)

};</code></pre>
<p>For ease of development, the constructors are usually assigned to a variable:</p>
<pre><code>// Cache the view constructors object to easy access later.

var views = gaffa.views.constructors;</code></pre>
<p>viewItems can then be instantiated:</p>
<pre><code>// New up a label

var nameLabel = new views.label(),

    firstNameBox = new views.textbox(),

    surnameBox = new views.textbox(),

    removeUserButton = new views.button();</code></pre>
<p>an Action is a non-visual entity which performs some action when executed. For example, an action could be assigned to be triggered when a button is clicked, and it could set a value into the model, or remove an item from an array.</p>
<pre><code>var removeUser = new actions.remove();</code></pre>
<p>To assign actions to a view:</p>
<pre><code>removeUserButton.actions.click = [removeUser];</code></pre>
<p>Gaffa will automatically use the actions.<em>whatever</em> propertyName as a DOM event name, and trigger any actions assigned when that event occurs.</p>
<p>a Behaviour is a non-visual entity that triggers actions. For example, a modelChange behaviour could be created to watch a property in the model, and assigned actions to perform when the value of that property changes.</p>
<h3>The Model</h3>
<p>The Model is just a Javascript object. If you can serialize it to JSON, and it inherrits from Object, it is a valid gaffa model, and it can be bound to. Unlike most similar frameworks, Gaffa focuses on keeping the model pure. If you add an object to the model, that exact object is used throughout the whole lifecycle, with no extra attributes like &quot;Observable&quot; etc. It&#39;s just a plain old object.</p>
<p>These are valid models:</p>
<pre><code>{};



new Date();



[];</code></pre>
<p>However usually a model would look something like this:</p>
<pre><code>var model = {

    users:[

        {

            firstName: &quot;John&quot;,

            surname: &quot;Smith&quot;,

            age: 30,

            lastVisit: (a date object)

        }

    ]

};</code></pre>
<p>This can be set as the applications model by:</p>
<pre><code>gaffa.model.set(model);</code></pre>
<p>You can also set parts of the model using paths.</p>
<pre><code>gaffa.model.set(&#39;[users/0/firstName]&#39;, &#39;Bob&#39;);</code></pre>
<p>This will cause properties bound to this value to update.</p>
<p>You would very rarely use this syntax to affect the model, but rather use bound viewItem properties to change model data. This method of affecting the model is mostly used for debugging.</p>
<p>You can bind ViewItems properties to parts of the model using paths, eg:</p>
<pre><code>// Bind the firstName box to the users first name in the model

firstNameBox.value.binding = &#39;[user/firstName]&#39;;



// Bind the surname box to the users surname in the model

surnameBox.value.binding = &#39;[user/surname]&#39;;



// Bind the nameLabel to an expression that joins both names together.

nameLabel.text.binding = &#39;(join &quot; &quot; [user/firstName] [user/surname])&#39;;</code></pre>
<p>Once you have set up your viewItems, you can add them to the application.</p>
<p>Calling gaffa.views.add(viewItem) on a viewItem binds and renders the view. No properties will be bound to the model untill this has occured.</p>
<pre><code>// Add the views to gaffa

gaffa.views.add([

    nameLabel,

    firstNameBox,

    surnameBox

]);</code></pre>
<h3>Expressions</h3>
<p>Gaffa uses Gedi as its model, and as such, uses Gedi&#39;s expressions.</p>
<p>Expressions in gaffa are used to address the model in some way.</p>
<p>For a more in-depth explanation of expressions, checkout the gedi readme: <a href="https://github.com/gaffa-tape/gedi">Gedi</a></p>
<section><div class="docyacode-block" data-blockname="ViewItem"><a name="ViewItem"></a><h2>ViewItem</h2>
<p>The base constructor for all gaffa ViewItems.</p>
<p>Views, Behaviours, and Actions inherrit from ViewItem.</p>
<section><div class="docyacode-block" data-blockname=".actions"><a name=".actions"></a><h2>.actions</h2>
<p>All ViewItems have an actions object which can be overriden.</p>
<p>The actions object looks like this:</p>
<pre><code>viewItem.actions = {

    click: [action1, action2],

    hover: [action3, action4]

}</code></pre>
<p>eg:</p>
<pre><code>// Some ViewItems

var someButton = new views.button(),

    removeItem = new actions.remove();



// Set removeItem as a child of someButton.

someButton.actions.click = [removeItem];</code></pre>
<p>If a Views action.[name] matches a DOM event name, it will be automatically bound.</p>
<pre><code>myView.actions.click = [

    // actions to trigger when a &#39;click&#39; event is raised by the views renderedElement

];</code></pre>
</div><div class="docyacode-block" data-blockname=".path"><a name=".path"></a><h2>.path</h2>
<p>the base path for a viewItem.</p>
<p>Any bindings on a ViewItem will recursivly resolve through the ViewItems parent&#39;s paths.</p>
<p>Eg:</p>
<pre><code>// Some ViewItems

var viewItem1 = new views.button(),

    viewItem2 = new actions.set();



// Give viewItem1 a path.

viewItem1.path = &#39;[things]&#39;;

// Set viewItem2 as a child of viewItem1.

viewItem1.actions.click = [viewItem2];



// Give viewItem2 a path.

viewItem2.path = &#39;[stuff]&#39;;

// Set viewItem2s target binding.

viewItem2.target.binding = &#39;[majigger]&#39;;</code></pre>
<p>viewItem2.target.binding will resolve to:</p>
<pre><code>&#39;[/things/stuff/majigger]&#39;</code></pre>
</div></section></div><div class="docyacode-block" data-blockname="View"><a name="View"></a><h2>View</h2>
<p>A base constructor for gaffa Views that have content view.</p>
<p>All Views that inherit from ContainerView will have:</p>
<pre><code>someView.views.content</code></pre>
</div><div class="docyacode-block" data-blockname="ContainerView"><a name="ContainerView"></a><h2>ContainerView</h2>
<p>A base constructor for gaffa Views that have content view.</p>
<p>All Views that inherit from ContainerView will have:</p>
<pre><code>someView.views.content</code></pre>
</div><div class="docyacode-block" data-blockname="The gaffa instance"><a name="The gaffa instance"></a><h2>The gaffa instance</h2>
<p>Instance of Gaffa</p>
<pre><code>var gaffa = new Gaffa();</code></pre>
<section><div class="docyacode-block" data-blockname=".addDefaultStyle"><a name=".addDefaultStyle"></a><h3>.addDefaultStyle</h3>
<p>used to add default syling for a view to the application, eg:</p>
<pre><code>MyView.prototype.render = function(){

    //render code...



    gaffa.addDefaultStyle(css);



};</code></pre>
<p>Gaffa encourages style-free Views, however sometimes views require minimal css to add functionality.</p>
<p>addDefaultStyle allows encaptulation of css within the View&#39;s .js file, and allows the style to be easily overriden.</p>
</div><div class="docyacode-block" data-blockname=".createSpec"><a name=".createSpec"></a><h3>.createSpec</h3>
<pre><code>function myConstructor(){}

myConstructor = gaffa.createSpec(myConstructor, inheritedConstructor);</code></pre>
<p>npm module: <a href="https://npmjs.org/package/spec-js">spec-js</a></p>
</div><div class="docyacode-block" data-blockname=".jsonConverter"><a name=".jsonConverter"></a><h3>.jsonConverter</h3>
<p>default jsonification for ViewItems</p>
</div><div class="docyacode-block" data-blockname=".initialiseViewItem"><a name=".initialiseViewItem"></a><h3>.initialiseViewItem</h3>
<p>takes the plain old object representation of a viewItem and returns an instance of ViewItem with all the settings applied.</p>
<p>Also recurses through the ViewItem&#39;s tree and inflates children.</p>
</div><div class="docyacode-block" data-blockname=".events"><a name=".events"></a><h3>.events</h3>
<p>used throughout gaffa for binding DOM events.</p>
<section><div class="docyacode-block" data-blockname=".on"><a name=".on"></a><h3>.on</h3>
<p>usage:</p>
<pre><code>gaffa.events.on(&#39;eventname&#39;, target, callback);</code></pre>
</div></section></div><div class="docyacode-block" data-blockname=".model"><a name=".model"></a><h2>.model</h2>
<p>access to the applications model</p>
<section><div class="docyacode-block" data-blockname=".get(path, viewItem, scope, asTokens)"><a name=".get(path, viewItem, scope, asTokens)"></a><h3>.get(path, viewItem, scope, asTokens)</h3>
<p>used to get data from the model.</p>
<p>path is relative to the viewItems path.</p>
<pre><code>gaffa.model.get(&#39;[someProp]&#39;, parentViewItem);</code></pre>
</div><div class="docyacode-block" data-blockname=".set(path, value, viewItem, dirty)"><a name=".set(path, value, viewItem, dirty)"></a><h3>.set(path, value, viewItem, dirty)</h3>
<p>used to set data into the model.</p>
<p>path is relative to the viewItems path.</p>
<pre><code>gaffa.model.set(&#39;[someProp]&#39;, &#39;hello&#39;, parentViewItem);</code></pre>
</div><div class="docyacode-block" data-blockname=".remove(path, viewItem, dirty)"><a name=".remove(path, viewItem, dirty)"></a><h3>.remove(path, viewItem, dirty)</h3>
<p>used to remove data from the model.</p>
<p>path is relative to the viewItems path.</p>
<pre><code>gaffa.model.remove(&#39;[someProp]&#39;, parentViewItem);</code></pre>
</div><div class="docyacode-block" data-blockname=".bind(path, callback, viewItem)"><a name=".bind(path, callback, viewItem)"></a><h3>.bind(path, callback, viewItem)</h3>
<p>used to bind callbacks to changes in the model.</p>
<p>path is relative to the viewItems path.</p>
<pre><code>gaffa.model.bind(&#39;[someProp]&#39;, function(){

    //do something when &#39;[someProp]&#39; changes.

}, viewItem);</code></pre>
</div><div class="docyacode-block" data-blockname=".debind(viewItem)"><a name=".debind(viewItem)"></a><h3>.debind(viewItem)</h3>
<p>remove all callbacks assigned to a viewItem.</p>
<pre><code>gaffa.model.debind(&#39;[someProp]&#39;, function(){

    //do something when &#39;[someProp]&#39; changes.

});</code></pre>
</div><div class="docyacode-block" data-blockname=".isDirty(path, viewItem)"><a name=".isDirty(path, viewItem)"></a><h3>.isDirty(path, viewItem)</h3>
<p>check if a part of the model is dirty.</p>
<p>path is relative to the viewItems path.</p>
<pre><code>gaffa.model.isDirty(&#39;[someProp]&#39;, viewItem); // true/false?</code></pre>
</div><div class="docyacode-block" data-blockname=".setDirtyState(path, value, viewItem)"><a name=".setDirtyState(path, value, viewItem)"></a><h3>.setDirtyState(path, value, viewItem)</h3>
<p>set a part of the model to be dirty or not.</p>
<p>path is relative to the viewItems path.</p>
<pre><code>gaffa.model.setDirtyState(&#39;[someProp]&#39;, true, viewItem);</code></pre>
</div></section></div><div class="docyacode-block" data-blockname=".views"><a name=".views"></a><h2>.views</h2>
<pre><code>gaffa.views //Object.</code></pre>
<p>contains functions and properties for manipulating the application&#39;s views.</p>
<section><div class="docyacode-block" data-blockname=".renderTarget"><a name=".renderTarget"></a><h3>.renderTarget</h3>
<p>Overrideable DOM selector that top level view items will be inserted into.</p>
<pre><code>gaffa.views.renderTarget = &#39;body&#39;;</code></pre>
</div><div class="docyacode-block" data-blockname=".add(View/viewModel, insertIndex)"><a name=".add(View/viewModel, insertIndex)"></a><h3>.add(View/viewModel, insertIndex)</h3>
<p>Add a view or views to the root list of viewModels.</p>
<p>When a view is added, it will be rendered bound, and inserted into the DOM.</p>
<pre><code>gaffa.views.add(myView);</code></pre>
<p>Or:</p>
<pre><code>gaffa.views.add([

    myView1,

    myView1,

    myView1

]);</code></pre>
</div><div class="docyacode-block" data-blockname=".remove(view/views)"><a name=".remove(view/views)"></a><h3>.remove(view/views)</h3>
<p>Remove a view or views from anywhere in the application.</p>
<pre><code>gaffa.views.remove(myView);</code></pre>
</div><div class="docyacode-block" data-blockname=".empty()"><a name=".empty()"></a><h3>.empty()</h3>
<p>empty the application of all views.</p>
<pre><code>gaffa.views.empty();</code></pre>
</div><div class="docyacode-block" data-blockname=".constructors"><a name=".constructors"></a><h3>.constructors</h3>
<p>An overridable object used by Gaffa to instantiate views.</p>
<p>The constructors for any views your application requires should be added to this object.</p>
<p>Either:</p>
<pre><code>gaffa.views.constructors.textbox = require(&#39;gaffa/views/textbox&#39;);

gaffa.views.constructors.label = require(&#39;gaffa/views/label&#39;);

// etc...</code></pre>
<p>Or:</p>
<pre><code>gaffa.views.constructors = {

    textbox: require(&#39;gaffa/views/textbox&#39;),

    label: require(&#39;gaffa/views/label&#39;)

}

// etc...</code></pre>
</div></section></div><div class="docyacode-block" data-blockname=".namedViews"><a name=".namedViews"></a><h3>.namedViews</h3>
<p>Storage for named views.</p>
<p>Any views with a .name property will be put here, with the name as the key.</p>
<p>This is used for navigation, where you can specify a view to navigate into.</p>
<p>See gaffa.navitate();</p>
</div><div class="docyacode-block" data-blockname=".actions"><a name=".actions"></a><h2>.actions</h2>
<pre><code>gaffa.actions //Object.</code></pre>
<p>contains functions and properties for manipulating the application&#39;s actions.</p>
<section><div class="docyacode-block" data-blockname=".trigger(actions, parent, scope, event)"><a name=".trigger(actions, parent, scope, event)"></a><h3>.trigger(actions, parent, scope, event)</h3>
<p>trigger a gaffa action where:</p>
<ul>
<li><p>actions is an array of actions to trigger.</p>
</li>
<li><p>parent is an instance of ViewItem that the action is on.</p>
</li>
<li><p>scope is an arbitrary object to be passed in as scope to all expressions in the action</p>
</li>
<li><p>event is an arbitrary event object that may have triggered the action, such as a DOM event.</p>
</li>
</ul>
</div><div class="docyacode-block" data-blockname=".constructors"><a name=".constructors"></a><h3>.constructors</h3>
<p>An overridable object used by Gaffa to instantiate actions.</p>
<p>The constructors for any actions your application requires should be added to this object.</p>
<p>Either:</p>
<pre><code>gaffa.actions.constructors.set = require(&#39;gaffa/actions/set&#39;);

gaffa.actions.constructors.remove = require(&#39;gaffa/actions/remove&#39;);

// etc...</code></pre>
<p>Or:</p>
<pre><code>gaffa.actions.constructors = {

    set: require(&#39;gaffa/views/set&#39;),

    remove: require(&#39;gaffa/views/remove&#39;)

}

// etc...</code></pre>
</div></section></div><div class="docyacode-block" data-blockname=".behaviours"><a name=".behaviours"></a><h2>.behaviours</h2>
<pre><code>gaffa.behaviours //Object.</code></pre>
<p>contains functions and properties for manipulating the application&#39;s behaviours.</p>
<section><div class="docyacode-block" data-blockname=".add(behaviour)"><a name=".add(behaviour)"></a><h3>.add(behaviour)</h3>
<p>add a behaviour to the root of the appliaction</p>
<pre><code>gaffa.behaviours.add(someBehaviour);</code></pre>
</div><div class="docyacode-block" data-blockname=".constructors"><a name=".constructors"></a><h3>.constructors</h3>
<p>An overridable object used by Gaffa to instantiate behaviours.</p>
<p>The constructors for any behaviours your application requires should be added to this object.</p>
<p>Either:</p>
<pre><code>gaffa.behaviours.constructors.pageLoad = require(&#39;gaffa/behaviours/pageLoad&#39;);

gaffa.behaviours.constructors.modelChange = require(&#39;gaffa/behaviours/modelChange&#39;);

// etc...</code></pre>
<p>Or:</p>
<pre><code>gaffa.behaviours.constructors = {

    pageLoad: require(&#39;gaffa/views/pageLoad&#39;),

    modelChange: require(&#39;gaffa/views/modelChange&#39;)

}

// etc...</code></pre>
</div></section></div><div class="docyacode-block" data-blockname="Navigate"><a name="Navigate"></a><h2>Navigate</h2>
<p>Navigates the app to a gaffa-app endpoint</p>
<pre><code>gaffa.navigate(url);</code></pre>
<p>To navigate into a named view:</p>
<pre><code>gaffa.navigate(url, target);</code></pre>
<p>Where target is: [viewName].[viewContainerName], eg:</p>
<pre><code>gaffa.navigate(&#39;/someroute&#39;, &#39;myPageContainer.content&#39;);</code></pre>
<p>myPageContainer would be a named ContainerView and content is the viewContainer on the view to target.</p>
</div></section></div></section></div><div class="docyacode-block" data-blockname="License"><a name="License"></a><h2>License</h2>
<p>(The MIT License)</p>
<p>Copyright (C) 2012 Kory Nunn, Matt Ginty &amp; Maurice Butler</p>
<p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the &quot;Software&quot;), 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:</p>
<p>The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.</p>
<p>THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, 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.</p>
</div>