Skip to content
Apply Symmetry patches to Backbone models
JavaScript
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.gitignore
.travis.yml
README.md
index.js
package.json
patch.js
test.js

README.md

Symmetry for Backbone.js Build Status

Creating diffs for Backbone.js models with Symmetry is easy. Applying them, however, is not. This module implements a best effort patch function.

Simply apply a patch to a model or collection, and events are fired:

model = new Backbone.Model();
SymmetryBB.patch(model, patch);

For nested objects, either set your models and collections in advance:

scope = {
    people: new Backbone.Collection()
};
SymmetryBB.patch(scope, patch);

Or replace objects and arrays with similar models and collections:

scope = {
    people: []
};
scope.people = new Backbone.Collection(scope.people);
SymmetryBB.patch(scope, patch);

While traversing, patch will try to preserve existing models and collections, firing events on them as they change.

MIT-licensed

Installing

In node.js, install using NPM:

npm install symmetry-bb

In the browser, simply include patch.js.

Hacking the code

git clone https://github.com/Two-Screen/symmetry-bb.git
cd symmetry-bb
npm install
npm test
Something went wrong with that request. Please try again.