Merge pull request octokit#238 from danielmiller-nl/master

Add getAll for users

Author: mikedeboer

api/v3.0.0/routes.json

@@ -2919,6 +2919,20 @@
     },
 
     "user": {
+        "get-all": {
+            "url": "/users",
+            "method": "GET",
+            "params": {
+                "since":{
+                    "type": "Number",
+                    "required": false,
+                    "validation": "",
+                    "description": "The integer ID of the last User that you’ve seen." 
+                }
+            }
+            
+        },
+        
         "get-from": {
             "url": "/users/:user",
             "method": "GET",

api/v3.0.0/user.js

@@ -19,6 +19,45 @@ var user = module.exports = {
 };
 
 (function() {
+    /** section: github
+     *  user#getAll(msg, callback) -> null
+     *      - msg (Object): Object that contains the parameters and their values to be sent to the server.
+     *      - callback (Function): function to call when the request is finished with an error as first argument and result data as second argument.
+     *
+     *  ##### Params on the `msg` object:
+     *
+     *  - headers (Object): Optional. Key/ value pair of request headers to pass along with the HTTP request. Valid headers are: 'If-Modified-Since', 'If-None-Match', 'Cookie', 'User-Agent', 'Accept', 'X-GitHub-OTP'.
+     *  - since (Number): Optional. The integer ID of the last User that you’ve seen.
+     **/
+    this.getAll = function(msg, block, callback) {
+        var self = this;
+        this.client.httpSend(msg, block, function(err, res) {
+            if (err)
+                return self.sendError(err, null, msg, callback);
+
+            var ret;
+            try {
+                ret = res.data && JSON.parse(res.data);
+            }
+            catch (ex) {
+                if (callback)
+                    callback(new error.InternalServerError(ex.message), res);
+                return;
+            }
+
+            if (!ret)
+                ret = {};
+            if (!ret.meta)
+                ret.meta = {};
+            ["x-ratelimit-limit", "x-ratelimit-remaining", "x-ratelimit-reset", "x-oauth-scopes", "link", "location", "last-modified", "etag", "status"].forEach(function(header) {
+                if (res.headers[header])
+                    ret.meta[header] = res.headers[header];
+            });
+
+            if (callback)
+                callback(null, ret);
+        });
+    };
     /** section: github
      *  user#getFrom(msg, callback) -> null
      *      - msg (Object): Object that contains the parameters and their values to be sent to the server.