add acl.isInRole function to test whether a user is in a certain role…

…. tests added for isInRole & userRoles functions. version bumped

Readme.md

@@ -243,6 +243,21 @@ __Arguments__
 
 ---------------------------------------
 
+<a name="isInRole" />
+### isInRole( userId, rolename, function(err, is_in_role) )
+
+Return boolean whether user is in the role
+
+__Arguments__
+  
+```javascript
+    userId   {String|Number} User id.
+    rolename {String|Number} role name.
+    callback {Function} Callback called when finished.
+```
+
+---------------------------------------
+
 <a name="addRoleParents" />
 ### addRoleParents( role, parents, function(err) )
 

lib/acl.js

@@ -112,6 +112,22 @@ Acl.prototype.userRoles = function(userId, cb){
   return this.backend.getAsync('users', userId).nodeify(cb);
 };
 
+/**
+  isInRole( userId, rolename, function(err, is_in_role) )
+
+  Return boolean whether user is in the 
+
+  @param {String|Number} User id.
+  @param {String|Number} rolename.
+  @param {Function} Callback called when finished.
+  @return {Promise} Promise resolved with boolean of whether user is in role
+*/
+Acl.prototype.isInRole = function(userId, rolename, cb){
+  return this.backend.getAsync('users', userId).nodeify(function(err, roles) {
+    return cb(err, roles.indexOf(rolename) != -1);
+  });
+};
+
 /**
   addRoleParents( role, parents, function(err) )
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "acl",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "An Access Control List module, based on Redis with Express middleware support",
   "keywords": [
     "middleware",

test/tests.js

@@ -71,6 +71,31 @@ exports.Allows = function () {
 		})
   })
 
+  describe('read User Roles', function() {
+    it('run userRoles function', function(done) {
+      var acl = new Acl(this.backend)
+      acl.addUserRoles('harry', 'admin', function (err) {
+        if (err) return done(err);
+
+        acl.userRoles('harry', function(err, roles) {
+          if (err) return done(err);
+
+          assert.deepEqual(roles, ['admin']);
+          acl.isInRole('harry', 'admin', function(err, is_in_role) {
+            if (err) return done(err);
+
+            assert.ok(is_in_role);
+            acl.isInRole('harry', 'no role', function(err, is_in_role) {
+              if (err) return done(err);
+
+              assert.notOk(is_in_role)
+              done()
+            })
+          })
+        })
+      })
+    })
+  })
 
   describe('allow', function () {
     it('admin view/add/edit/delete users', function (done) {