Implements the search API. Closes github-tools#151.

add Search API informations and examples based on Github API documentation to README.md

add search api tests

Author: cassioscabral

README.md

@@ -334,6 +334,51 @@ To comment in a issue
 issues.comment(issue, comment,function(err, comment) {});
 ```
 
+## Search API
+
+```js
+var search = github.getSearch(query);
+```
+
+### Search repositories
+
+Suppose you want to search for popular Tetris repositories written in Assembly. Your query might look like this:
+
+```js
+var search = github.getSearch("tetris+language:assembly&sort=stars&order=desc");
+search.repositories(options, function (err, repositories) {});
+```
+
+### Search code
+
+Suppose you want to find the definition of the addClass function inside jQuery. Your query would look something like this:
+
+```js
+var search = github.getSearch("addClass+in:file+language:js+repo:jquery/jquery");
+search.code(options, function (err, codes) {});
+```
+
+### Search issues
+
+Let’s say you want to find the oldest unresolved Python bugs on Windows. Your query might look something like this:
+
+```js
+var search = github.getSearch("windows+label:bug+language:python+state:open&sort=created&order=asc");
+search.issues(options, function (err, issues) {});
+```
+
+### Search users
+
+Imagine you’re looking for a list of popular users. You might try out this query:
+
+```js
+var search = github.getSearch("tom+repos:%3E42+followers:%3E1000");
+search.users(options, function (err, users) {});
+```
+
+Here, we’re looking at users with the name Tom. We’re only interested in those with more than 42 repositories, and only if they have over 1,000 followers.
+
+
 ## Change Log
 
 ### 0.10.X

github.js

@@ -885,6 +885,30 @@
       };
     };
 
+    // Search API
+    // ==========
+
+    Github.Search = function(options) {
+      var path = "/search/";
+      var query = "?q=" + options.query;
+
+      this.repositories = function(options, cb) {
+        _request("GET", path + "repositories" + query, options, cb);
+      };
+
+      this.code = function(options, cb) {
+        _request("GET", path + "code" + query, options, cb);
+      };
+
+      this.issues = function(options, cb) {
+        _request("GET", path + "issues" + query, options, cb);
+      };
+
+      this.users = function(options, cb) {
+        _request("GET", path + "users" + query, options, cb);
+      };
+    };
+
     return Github;
   };
 
@@ -912,5 +936,9 @@
     return new Github.Gist({id: id});
   };
 
+  Github.getSearch = function(query) {
+    return new Github.Search({query: query});
+  };
+
   return Github;
 }));

test/test.search.js

@@ -0,0 +1,61 @@
+'use strict';
+
+var test = require('tape'); //jshint ignore:line
+var Github = require("../");
+var test_user = require('./user.json');
+
+test("User API", function(t) {
+    var timeout = setTimeout(function () { t.fail(); }, 100000);
+    var github = new Github({
+        username: test_user.USERNAME,
+        password: test_user.PASSWORD,
+        auth: "basic"
+    });
+    // var user = github.getUser();
+
+
+    t.test('Search.repositories', function(q) {
+        var search = github.getSearch("tetris+language:assembly&sort=stars&order=desc");
+        var options = null;
+
+        search.repositories(options, function (err) {
+            q.error(err, 'search repositories');
+            q.end();
+        });
+    });
+
+    t.test('Search.code', function(q) {
+        var search = github.getSearch("addClass+in:file+language:js+repo:jquery/jquery");
+        var options = null;
+
+        search.code(options, function (err) {
+            q.error(err, 'search code');
+            q.end();
+        });
+    });
+
+    t.test('Search.issues', function(q) {
+        var search = github.getSearch("windows+label:bug+language:python+state:open&sort=created&order=asc");
+        var options = null;
+
+        search.issues(options, function (err) {
+            q.error(err, 'search issues');
+            q.end();
+        });
+    });
+
+    t.test('Search.users', function(q) {
+        var search = github.getSearch("tom+repos:%3E42+followers:%3E1000");
+        var options = null;
+
+        search.users(options, function (err) {
+            q.error(err, 'search users');
+            q.end();
+        });
+    });
+
+
+
+    clearTimeout(timeout);
+    t.end();
+ });