Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/championswimmer/ember-parse-adapter-two
https://github.com/championswimmer/ember-parse-adapter-two
Last synced: 29 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/championswimmer/ember-parse-adapter-two
- Owner: championswimmer
- License: mit
- Created: 2016-10-05T23:14:44.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2016-10-05T23:37:34.000Z (about 8 years ago)
- Last Synced: 2024-10-09T08:55:37.665Z (about 1 month ago)
- Language: JavaScript
- Size: 1.37 MB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Ember Data Adapter for parse-server
An [Ember Data](https://github.com/emberjs/data) plugin built to use the [Parse REST API](https://parse.com/docs/rest). This is a full Ember implementation against the Parse REST API without the use of the Parse JavaScript SDK.
If you are not familiarized with the new open source project [parse-server](https://github.com/ParsePlatform/parse-server), you should visit the project page first.
## Features
##### EmberParseAdapter.Serializer
* Provides the translation of objectId to id for identity mapping.
* Provides encoding of hasMany associations to arrays of [Parse Pointer objects](https://parse.com/docs/rest#objects-types).
##### EmberParseAdapter.Adapter
* Implements the persistence layer to Parse by extending the Ember Data REST Adapter.
* Provides a `sessionToken` property which can set a session token.
##### EmberParseAdapter.ParseUser
Is stored at the special user endpoint at parse-server.
* Signup
* Login
* Logout
* Request password reset
* Request current user
##### EmberParseAdapter.Transforms
* Provides transforms for date, file and geo types at parse-server.
## Get started
You'll need to use a [Parse.com](https://parse.com) account, or to run [parse-server](https://github.com/ParsePlatform/parse-server) on your own. After this you will have to provide:
* The url of your parse-server (is "https://api.parse.com" on Parse.com)
* The URL prefix of your Parse API (is "1" on Parse.com)
* The ID of your application
* The REST API Key of your application (only if you use a Parse.com account)
You will need these to configure the ParseAdapter via entries in the `config/environment.js` file:
```javascript
var ENV = {
...
APP: {
parseUrl: '',
parseNamespace: '',
applicationId: '',
restApiId: '' // (only if you use a Parse.com account)
}
};
```
Any model using this adapter will be stored on Parse. Create models
as you would normally:
```javascript
App.Post = DS.Model.extend({
// Attributes can use normal transforms
title: DS.attr('string'),
body: DS.attr('string'),
rate: DS.attr('number'),
// Or there are special transforms for some data-types like files
avatar: DS.attr('parse-file'),
// There is a parse-date transform, but sometimes dates are just strings
updatedAt: DS.attr('parse-date'),
// ALWAYS refer to relationships as async, for now.
user: DS.belongsTo('parse-user', {async: true})
});
```
## Security Warning
Before publishing your app you should **disable REST Push**. Parse apps are created with this feature enabled by default. If this feature is enabled anyone with your `Application ID` and `REST API Key` will be able to send push notifications to your user's devices. Anyone using your app has access your `Application ID` and `REST API Key`.
To disable REST Push:
- Login to your Parse account.
- Click on your application.
- Go to Settings > Push.
- And disable REST Push.
- It should look like the image below.
## Installation
* `git clone` this repository
* `npm install`
* `bower install`
## Running
* `ember server`
* Visit your app at http://localhost:4200.
## Running Tests
* `npm test` (Runs `ember try:testall` to test your addon against multiple Ember versions)
* `ember test`
* `ember test --server`
## Building
* `ember build`
For more information on using ember-cli, visit [http://www.ember-cli.com/](http://www.ember-cli.com/).