repaired the ability of nano to be able to output DEBUG messages

.travis.yml

@@ -6,15 +6,15 @@ branches:
     - next
     - rewrite
 node_js:
-  - "0.8"
-  - "0.10"
-  - "0.11"
   - "0.12"
   - "iojs"
+  - "4.2"
+  - "node"
 services:
-  - couchdb
+  - docker
 os:
   - linux
-  - osx
+before_script:
+  - ./scripts/run_couchdb_on_travis.sh
 before_install:
   - npm update -g npm

README.md

@@ -29,8 +29,12 @@ minimalistic couchdb driver for node.js
   - [nano.db.list([callback])](#nanodblistcallback)
   - [nano.db.compact(name, [designname], [callback])](#nanodbcompactname-designname-callback)
   - [nano.db.replicate(source, target, [opts], [callback])](#nanodbreplicatesource-target-opts-callback)
+  - [nano.db.replication.enable(source, target, [opts], [callback])](#nanodbreplicatorenablesource-target-opts-callback)
+  - [nano.db.replication.query(id, [opts], [callback])](#nanodbreplicatorquery-id-opts-callback)
+  - [nano.db.replication.disable(id, [opts], [callback])](#nanodbreplicatordisable-id-opts-callback)
   - [nano.db.changes(name, [params], [callback])](#nanodbchangesname-params-callback)
   - [nano.db.follow(name, [params], [callback])](#nanodbfollowname-params-callback)
+  - [nano.db.info([callback])](#nanodbinfocallback)
   - [nano.use(name)](#nanousename)
   - [nano.request(opts, [callback])](#nanorequestopts-callback)
   - [nano.config](#nanoconfig)
@@ -60,6 +64,7 @@ minimalistic couchdb driver for node.js
   - [db.search(designname, viewname, [params], [callback])](#dbsearchdesignname-searchname-params-callback)
 - [using cookie authentication](#using-cookie-authentication)
 - [advanced features](#advanced-features)
+  - [getting uuids](#getting-uuids)
   - [extending nano](#extending-nano)
   - [pipes](#pipes)
 - [tests](#tests)
@@ -272,6 +277,55 @@ nano.db.replicate('alice', 'http://admin:[email protected]:5984/alice',
 });
 ```
 
+### nano.db.replication.enable(source, target, [opts], [callback])
+
+enables replication using the new couchdb api from `source` to `target`
+with options `opts`. `target` has to exist, add `create_target:true` to
+`opts` to create it prior to replication.
+replication will survive server restarts.
+
+``` js
+nano.db.replication.enable('alice', 'http://admin:[email protected]:5984/alice',
+                  { create_target:true }, function(err, body) {
+    if (!err)
+      console.log(body);
+});
+```
+
+### nano.db.replication.query(id, [opts], [callback])
+
+queries the state of replication using the new couchdb api. `id` comes from the response
+given by the call to enable.
+
+``` js
+nano.db.replication.enable('alice', 'http://admin:[email protected]:5984/alice',
+                   { create_target:true }, function(err, body) {
+    if (!err) {
+      nano.db.replication.query(body.id, function(error, reply) {
+        if (!err)
+          console.log(reply);
+      }
+    }
+});
+```
+
+### nano.db.replication.disable(id, [opts], [callback])
+
+disables replication using the new couchdb api. `id` comes from the response given
+by the call to enable.
+
+``` js
+nano.db.replication.enable('alice', 'http://admin:[email protected]:5984/alice',
+                   { create_target:true }, function(err, body) {
+    if (!err) {
+      nano.db.replication.disable(body.id, function(error, reply) {
+        if (!err)
+          console.log(reply);
+      }
+    }
+});
+```
+
 ### nano.db.changes(name, [params], [callback])
 
 asks for the changes feed of `name`, `params` contains additions
@@ -300,6 +354,16 @@ process.nextTick(function () {
 });
 ```
 
+### nano.db.info([callback])
+
+gets database information.
+
+nano.db.info(function(err, body) {
+  if (!err) {
+    console.log('got database info'', body);
+  }
+});
+
 ### nano.use(name)
 
 creates a scope where you operate inside `name`.
@@ -411,7 +475,7 @@ alice.insert({ crazy: true }, 'rabbit', function(err, body) {
 The `insert` function can also be used with the method signature `db.insert(doc,[callback])`, where the `doc` contains the `_id` field e.g.
 
 ~~~ js
-var alice = cloudant.use('alice')
+var alice = nano.use('alice')
 alice.insert({ _id: 'myid', crazy: true }, function(err, body) {
   if (!err)
     console.log(body)
@@ -421,7 +485,7 @@ alice.insert({ _id: 'myid', crazy: true }, function(err, body) {
 and also used to update an existing document, by including the `_rev` token in the document being saved:
 
 ~~~ js
-var alice = cloudant.use('alice')
+var alice = nano.use('alice')
 alice.insert({ _id: 'myid', _rev: '1-23202479633c2b380f79507a776743d5', crazy: false }, function(err, body) {
   if (!err)
     console.log(body)
@@ -765,6 +829,21 @@ nano.session(function(err, session) {
 
 ## advanced features
 
+### getting uuids
+
+if your application needs to generate UUIDs, then CouchDB can provide some for you
+
+```js
+nano.uuids(3, callback);
+// { uuid: [
+// '5d1b3ef2bc7eea51f660c091e3dffa23',
+// '5d1b3ef2bc7eea51f660c091e3e006ff',
+// '5d1b3ef2bc7eea51f660c091e3e007f0',
+//]}
+```
+
+The first parameter is the number of uuids to generate. If omitted, it defaults to 1.
+
 ### extending nano
 
 nano is minimalistic but you can add your own features with
@@ -804,6 +883,32 @@ alice.attachment.get('rabbit', 'picture.png').pipe(fs.createWriteStream('/tmp/ra
 
 then open `/tmp/rabbit.png` and you will see the rabbit picture.
 
+### debugging
+
+debugging messages can be enabled in Nano by
+
+
+#### setting the DEBUG environment variable
+
+Either in the shell
+
+    export DEBUG=nano
+    # then run your Node.js script
+
+or on the same line as you execute your Node.js script:
+
+    DEBUG=nano node myscript.js
+
+#### providing your own debugging function
+
+when initialising Nano, pass in a `log` function:
+
+``` js
+    nano = require('nano')({ url: 'http://127.0.0.1:5984/', log: function(d) {  console.log("!!!",d)}} );
+```
+
+* setting an environment variable `DEBUG` with value of 'nano'
+* or, providing
 
 ## tutorials, examples in the wild & screencasts
 

examples/express.js

@@ -12,16 +12,19 @@
 
 var express = require('express')
    , db    = require('nano')('http://localhost:5984/my_couch')
-   , app     = module.exports = express.createServer()
+   , app     = module.exports = express()
    ;
 
-app.get('/', function(request,response) {
-    db.get('foo', function (error, body, headers) {
-      if(error) { return response.send(error.message, error['status-code']); }
-      response.send(body, 200);
-    });
-  });
+app.get('/', function(req, res) {
+   db.get('foo', function (error, body, headers) {
+      if(error) {
+         res.status(error.statusCode);
+         return res.send(error.message); 
+      }
+      res.status(200);
+      res.send(body);
+   });
 });
 
 app.listen(3333);
-console.log('server is running. check expressjs.org for more cool tricks');
+console.log('server is running. check expressjs.com for more cool tricks');

lib/logger.js

@@ -11,18 +11,12 @@
 // the License.
 
 'use strict';
+var prefix = 'nano';
+var debug = require('debug')(prefix);
 
-var debug = require('debug')('nano/logger');
-
-module.exports = function logging(cfg) {
-  var log = cfg && cfg.log;
-  var logStrategy = typeof log === 'function' ? log : debug;
-
-  return function logEvent(prefix) {
-    var eventId = (prefix ? prefix + '-' : '') +
-      (~~(Math.random() * 1e9)).toString(36);
-    return function log() {
-      logStrategy.call(this, eventId, [].slice.call(arguments, 0));
-    };
+module.exports = function logging() {
+  return function log() {
+    var eventId = prefix + (~~(Math.random() * 1e9)).toString(36);
+    debug.call(this, eventId, [].slice.call(arguments, 0));
   };
 };