| commit | 6bcb74afda0bf94ae1252c37ad574c7bb97b8f33 | [log] [tgz] |
|---|---|---|
| author | Nuno Job <nunojobpinto@gmail.com> | Wed Aug 17 13:15:08 2011 +0200 |
| committer | Nuno Job <nunojobpinto@gmail.com> | Wed Aug 17 13:15:08 2011 +0200 |
| tree | fc375782f554fc6fc4fce9fc1cc8054207969da0 | |
| parent | 762e3bd086a36d9d4da24aef24e49d2388907351 [diff] |
Support Compaction of views fixes #4
nano (short for nanocouch) is a minimalistic couchdb driver for node.js
npm install nanoa quick example using nano
to use nano you have to either provide a) a json configuration object or b) a configuration file path like cfg/tests.js. refer to cfg/couch.example.js for a example
var nano = require('nano')('./cfg/tests.js');
within the nano variable you have various methods you can call. these include tasks like create, delete or list databases:
nano.db.create("alice");
in this function there is not callback. in nano the absence of callback means “do this, ignore what happens”
you normally don't want to do that though:
// clean up the database we created previously
nano.db.destroy("alice", function(err,headers,response) {
nano.db.create("alice", function(){
// specify the database we are going to use
var alice = nano.use("alice");
alice.insert("rabbit", {crazy: true}, function(e,h,r){
if(e) { throw e; }
console.log("you have inserted the rabbit.")
});
});
});
the nano.use method creates a scope where you operate inside a single database. this is just a convenience so you don't have to specify the database name every single time you do an update or delete
// 5: var alice = nano.use("alice");
in nano a callback has always three arguments
// 6: alice.insert("rabbit", {crazy: true}, function(e,h,r){
// 7: if(e) { throw e; }
// 8: console.log("you have inserted the rabbit.")
// 9: });
meaning:
e: the `error`, if any. check error.js for more info. h: the http response `headers` from couchdb, if no error. r: the http `response body` from couchdb, if no error.
that‘s it. don’t forget to delete the database you created:
nano.db.destroy("alice");
* marks optional params are additional querystring parameters
nano.db.create(db_name,callback*) nano.db.get(db_name,callback*) nano.db.destroy(db_name,callback*) nano.db.list(callback*) nano.db.compact(db_name,design_name*,callback*) nano.db.replicate(source,target,continuous*,callback*) nano.use(db_name) nano.request(opts,callback*) nano.config(callback)
nano.use: [nano.db.use, nano.db.scope, nano.scope] nano.request: [nano.relax, nano.dinosaur]
doc.insert(doc,doc_name*,callback*) doc.update(doc_name,rev,doc,callback*) doc.destroy(doc_name,rev,callback*) doc.get(doc_name,params*,callback*) doc.bulk(docs,callback*) doc.list(params*,callback*) doc.attachment.insert(doc_name,att_name,att,content_type,params*,callback*) doc.attachment.get(doc_name,att_name,params*,callback*) doc.attachment.destroy(doc_name,att_name,rev,callback*) doc.view.compact(design_name,callback*)
nano.use sets db_name in scope so you don't have to specify it every time
nano.db.get: [doc.info(callback*)] nano.db.replicate: [doc.replicate(target,continuous*,callback*)] nano.db.compact: [doc.compact(callback*)]
nano is minimalistic so it provides advanced users with a way to code their own extension functions:
nano.request(opts,callback*)
to get a document in a specific rev an advanced user might do:
nano.request( { db: "alice"
, doc: "rabbit"
, method: "GET"
, params: { rev: "1-967a00dff5e02add41819138abb3284d"}
},
function (_,_,b) { console.log(b) }
);
this is the same as (assuming alice = nano.use("alice");):
alice.get("rabbit", {rev: "1-967a00dff5e02add41819138abb3284d"},
function (_,_,b) { console.log(b) }
);
pipe support as provided by request_changes feedviewseveryone is welcome to contribute. patches, bugfixes, new features
nano in githubgit checkout -b my_branchgit push origin my_branchpackage.jsontest/ and ./run.always make sure all the tests pass before sending in your pull request!
we will tell santa
_
/ _) ROAR! i'm a vegan!
.-^^^-/ /
__/ /
/__.|_|-|_| cannes est superb
git clone git://github.com/dscape/nano.git(oO)--',- in caos