Merge branch 'feature/fluent-interface' into develop

README.md

@@ -265,6 +265,23 @@ router.scope('admin', function() {
 The difference with the namespace is that the routes paths don't have a prefix, but the controller lives inside a directory with the same name of the scope.
 
 
+#### Fluent interface
+
+Guidance router have a fluent interface, so it can be used in this way:
+
+```javascript
+router
+  .get('/geocoder', { to: 'geocoder#show' })
+  .namespace('admin', function() {})
+  .resources('books')
+  .resource('geocoder')
+  .scope('admin', function() {})
+  .root('welcome#index')
+  .post('/photos', { to: 'photos#create' })
+;
+```
+
+
 ## Notes
 
 A modern version of node is required (due to harmony syntax).

lib/router.js

@@ -193,6 +193,8 @@ Router.prototype.resources = function(resource, fn) {
   ];
 
   routes.forEach(route => this.layers.push(this._parseRoute(route)));
+
+  return this;
 };
 
 
@@ -249,20 +251,26 @@ Router.prototype.resource = function(resource) {
   ];
 
   routes.forEach(route => this.layers.push(this._parseRoute(route)));
+
+  return this;
 };
 
 
 Router.prototype.namespace = function (namespace, fn) {
   this.namespaceStack.push(namespace);
   fn.call(this);
   this.namespaceStack.pop();
+
+  return this;
 };
 
 
 Router.prototype.scope = function (scope, fn) {
   this.scopeStack.push(scope);
   fn.call(this);
   this.scopeStack.pop();
+
+  return this;
 };
 
 
@@ -279,5 +287,7 @@ methods.forEach((method) => {
     let layer = this._parseRoute({ method, path, opts });
 
     this.layers.push(layer);
+
+    return this;
   };
 });

test/guidanceTest.js

@@ -125,6 +125,24 @@ describe('guidance', function() {
         .end(done)
       ;
     });
+
+
+    it('use a fluent interface', function() {
+      let routes = function(router) {
+        router
+          .get('/geocoder', { to: 'geocoder#show' })
+          .namespace('admin', function() {})
+          .resources('books')
+          .resource('geocoder')
+          .scope('admin', function() {})
+          .root('welcome#index')
+          .post('/photos', { to: 'photos#create' })
+        ;
+      };
+
+      app.use(guidance.initialize(routes, { controllersDir }));
+
+    });
   });
 
   context('resource', function() {