Angular-Parse

Angular-Parse is a set of services for using Parse query and objects saving inside angular lifecycle using promises and without the hassle of using $scope.$apply

Installing

via npm

$ npm install angularparse

via Bower

$ bower install angularparse

Demo

Check this plnkr demo for a working example

Quick Start

Services

• parseQuery: Used to build Parse.Query objects
• parsePersistence: Used to persist/save/destroy Parse.Objects back to Parse servers

parseQuery

• Creating a Parse.Query object

A Parse.Query object can be created using the common Parse way

var TestObject = Parse.Object.extend("TestObject");
var query = new Parse.Query(TestObject);

which is useful if you are using TestObject in more than one place. But angular-parse has the following shortcut:

var query = parseQuery.new('TestObject');

• Executing a simple Query

parseQuery.find(query).then(function(results) {
  // do something with the query execution results
}, function(error) {
  // do something with the returning error
});

• More Options

The parseQuery.query(query, options, fnc) method:

query: the Parse.Query object that will be executed

options: the options parameter when executing a Parse.Query. Default value: {}

fnc: The query funcion being executed, for example: find or count. Default value: 'find'

Also, parseQuery has some auxiliary methods acting as shortcuts for parseQuery.query: find, count and total

parsePersistence

• Creating a Parse.Object

Similiar to the parseQuery service, A Parse.Object object can be created using the common Parse way

var TestObject = Parse.Object.extend("TestObject");
var myObject = new TestObject();

And angular-parse has the following shortcut:

var myObject = parsePersistence.new('TestObject');

• Saving Data

parsePersistence.save(myObject, {foo: "bar promise"}).then(function(object) {
  // do something with the returning object
}, function(error) {
  // do something with the returning error
});

• More Options

The parsePersistence.persist(obj, data, fnc) method:

obj: the Parse.Object object being used

data: the optional data parameter when saving the object

fnc: The object funcion being executed, for example: save or destroy.

Also, parsePersistence has some auxiliary methods acting as shortcuts for parseQuery.persist: save and destroy.

Developers

configure:

$ npm install

compile:

$ grunt build

Authors

Felipe Sabino

• http://twitter.com/felipesabino
• http://github.com/felipesabino

Changelog

• 0.2.0

  • Fixed get method missing at compiled JS

• 0.1.0

  • Initial Release

Copyright and license

The MIT License

Copyright (c) 2014 Felipe Sabino (http://felipe.sabino.me)

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.