1 files changed, 60 insertions, 0 deletions
diff --git a/searx/engines/github.py b/searx/engines/github.py
new file mode 100644
index 0000000..eaa00da
--- /dev/null
+++ b/searx/engines/github.py
@@ -0,0 +1,60 @@
+"""
+ Github (It)
+
+ @website     https://github.com/
+ @provide-api yes (https://developer.github.com/v3/)
+
+ @using-api   yes
+ @results     JSON
+ @stable      yes (using api)
+ @parse       url, title, content
+"""
+
+from json import loads
+from searx.url_utils import urlencode
+
+# engine dependent config
+categories = ['it']
+
+# search-url
+search_url = 'https://api.github.com/search/repositories?sort=stars&order=desc&{query}'  # noqa
+
+accept_header = 'application/vnd.github.preview.text-match+json'
+
+
+# do search-request
+def request(query, params):
+    params['url'] = search_url.format(query=urlencode({'q': query}))
+
+    params['headers']['Accept'] = accept_header
+
+    return params
+
+
+# get response from search-request
+def response(resp):
+    results = []
+
+    search_res = loads(resp.text)
+
+    # check if items are recieved
+    if 'items' not in search_res:
+        return []
+
+    # parse results
+    for res in search_res['items']:
+        title = res['name']
+        url = res['html_url']
+
+        if res['description']:
+            content = res['description'][:500]
+        else:
+            content = ''
+
+        # append result
+        results.append({'url': url,
+                        'title': title,
+                        'content': content})
+
+    # return results
+    return results