Product
Introducing License Enforcement in Socket
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
nano
(short for nanocouch
) is a minimalistic couchdb
driver for node.js
npm install nano
var nano = require('nano')('http://localhost:5984');
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() {
nano.db.create("alice", function() {
// specify the database we are going to use
var alice = nano.use("alice");
alice.insert({crazy: true}, "rabbit", function(e,b,h){
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 the same three arguments
// 6: alice.insert({crazy: true}, "rabbit", function(e,b,h) {
// 7: if(e) { throw e; }
// 8: console.log("you have inserted the rabbit.")
// 9: });
meaning:
e: the `error`, if any
b: the http `response body` from couchdb, if no error. json parsed body, binary for non-json responses
h: the http response `headers` from couchdb, if no error
errors include responses from couchdb which had a non 200 response code. that's it. don't forget to delete the database you created:
nano.db.destroy("alice");
*
marks optional
params
are additional querystring parameters
server.db.create(db_name,callback*)
server.db.get(db_name,callback*)
server.db.destroy(db_name,callback*)
server.db.list(callback*)
server.db.compact(db_name,design_name*,callback*)
server.db.replicate(source,target,continuous*,callback*)
server.db.changes(db_name,params*,callback*)
server.use(db_name)
server.request(opts,callback*)
server.config
nano.use: [nano.db.use, nano.db.scope, nano.scope]
nano.request: [nano.relax, nano.dinosaur]
db.insert(doc,doc_name*,callback*)
db.destroy(doc_name,rev,callback*)
db.get(doc_name,params*,callback*)
db.bulk(docs,params*,callback*)
db.list(params*,callback*)
db.fetch(doc_names,params*,callback*)
db.view(design_name,view_name,params*,callback*)
db.attachment.insert(doc_name,att_name,att,content_type,params*,callback*)
db.attachment.get(doc_name,att_name,params*,callback*)
db.attachment.destroy(doc_name,att_name,rev,callback*)
db.updateWithHandler(design_name, update_name, doc_name, params*, callback*)
nano.use
sets db_name
in scope so you don't have to specify it every time
server.db.get: [db.info(callback*)]
server.db.replicate: [db.replicate(target,continuous*,callback*)]
server.db.compact: [db.compact(callback*), db.view.compact(design_name,callback*)]
server.db.changes: [db.changes(params*,callback*)]
server.config: [db.config]
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 = require('nano')('http://localhost:5984/alice')
):
alice.get("rabbit", {rev: "1-967a00dff5e02add41819138abb3284d"},
function (_,b) { console.log(b) });
you can pipe in nano
just like you do in any other stream. this is available in all methods:
alice.attachment.get("breakfast", "sugar", {rev: rev})
.pipe(fs.createWriteStream("/tmp/sugar-for-rabbit"));
check issues
everyone is welcome to contribute. patches, bugfixes, new features
nano
in githubgit checkout -b my_branch
git push origin my_branch
to run (and configure) the test suite simply:
cd nano
vi cfg/tests.js
npm install # should install ensure and async, if it doesnt install manually
npm test
after adding a new test you can run it individually (with verbose output) using:
NANO_ENV=testing node tests/doc/list.js list_doc_params
where list_doc_params
is the test name.
_
/ _) ROAR! i'm a vegan!
.-^^^-/ /
__/ /
/__.|_|-|_| cannes est superb
git clone git://github.com/dscape/nano.git
(oO)--',-
in caos
FAQs
The official CouchDB client for Node.js
The npm package nano receives a total of 27,477 weekly downloads. As such, nano popularity was classified as popular.
We found that nano demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 7 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
Product
We're launching a new set of license analysis and compliance features for analyzing, managing, and complying with licenses across a range of supported languages and ecosystems.
Product
We're excited to introduce Socket Optimize, a powerful CLI command to secure open source dependencies with tested, optimized package overrides.