ember-couch
v1.1.0
Published
An Ember.js adapter for Apache CouchDB
Downloads
6
Readme
Ember Couch
An ember-data
kit for Apache CouchDB. A collection of adapters and serializers to work with CouchDB documents, attachments, revisions, and the changes feed. Based off of ember-couchdb-kit by Aleksey Zatvobor.
Version
Version 1.0.0 of this addon is tested to work with Ember 2.4.4 and Ember Data 2.4.0.
Installation and Setup
ember install ember-couch
In your adapters and serializers you must import then extend the adapter and serializer you wish to use from ember-couch. There are 3 adapters you can extend and 3 serializers you can extend. They are:
Adapters
- DocumentAdapter
- AttachmentAdapter
- RevAdapter (experimental)
Serializers
- DocumentSerializer
- AttachmentSerializer
- RevSerializer (experimental)
Example adapter:
import { DocumentAdapter } from 'ember-couch';
export default DocumentAdapter.extend({
host: 'localhost:5984',
db: 'boards'
});
Example serializer:
import { DocumentSerializer } from 'ember-couch';
export default DocumentSerializer.extend();
If you would like to work with the changes feed, just add this statement to the top of your route:
import { ChangesFeed } from "ember-couch";
Features
Some notable features:
- natural
findRecord/createRecord/deleteRecord
functions; - document's attachments designed as
hasMany
relationship; - document's revisions designed as
belongsTo
andhasMany
relationships; - ability to work with
/_changes
feeds;
For other features have a look at our example app located in
tests/dummy/app
Contribution
See CONTRIBUTING.md
License
ember-couch
source code is released under MIT-License. Check LICENSE.md for more details.