Merge pull request #32 from eduardolundgren/master

Add search users - Fix #31

Author: tebriel

lib/jira.js

@@ -731,6 +731,64 @@ var JiraApi = exports.JiraApi = function(protocol, host, port, username, passwor
         });
     };
 
+    // ## Search user on Jira ##
+    // ### Takes ###
+    //
+    // username: A query string used to search username, name or e-mail address
+    // startAt: The index of the first user to return (0-based)
+    // maxResults: The maximum number of users to return (defaults to 50).
+    // includeActive: If true, then active users are included in the results (default true)
+    // includeInactive: If true, then inactive users are included in the results (default false)
+    // *  callback: for when it's done
+    //
+    // ### Returns ###
+    //
+    // *  error: string if there's an error
+    // *  users: array of users for the user
+    //
+    // [Jira Doc](http://docs.atlassian.com/jira/REST/latest/#d2e3756)
+    //
+    this.searchUsers = function(username, startAt, maxResults, includeActive, includeInactive, callback) {
+        startAt = (startAt !== undefined) ? startAt : 0;
+        maxResults = (maxResults !== undefined) ? maxResults : 50;
+        includeActive = (includeActive !== undefined) ? includeActive : true;
+        includeInactive = (includeInactive !== undefined) ? includeInactive : false;
+
+        var options = {
+            rejectUnauthorized: this.strictSSL,
+            uri: this.makeUri(
+                '/user/search?username=' + username +
+                '&startAt=' + startAt +
+                '&maxResults=' + maxResults +
+                '&includeActive=' + includeActive +
+                '&includeInactive=' + includeInactive),
+            method: 'GET',
+            json: true,
+            followAllRedirects: true
+        };
+
+        this.request(options, function(error, response, body) {
+
+            if (error) {
+                callback(error, null);
+                return;
+            }
+
+            if (response.statusCode === 400) {
+                callback('Unable to search');
+                return;
+            }
+
+            if (response.statusCode !== 200) {
+                callback(response.statusCode + ': Unable to connect to JIRA during search.');
+                return;
+            }
+
+            callback(null, body);
+
+        });
+    };
+
     // ## Get issues related to a user ##
     // ### Takes ###
     //