@@ -1,31 +1,59 @@
1+## Github (It)
2+#
3+# @website https://github.com/
4+# @provide-api yes (https://developer.github.com/v3/)
5+#
6+# @using-api yes
7+# @results JSON
8+# @stable yes (using api)
9+# @parse url, title, content
10+
111from urllib import urlencode
212from json import loads
313from cgi import escape
414
15+# engine dependent config
516categories = ['it']
617
18+# search-url
719search_url = 'https://api.github.com/search/repositories?sort=stars&order=desc&{query}' # noqa
820
921accept_header = 'application/vnd.github.preview.text-match+json'
1022
1123
24+# do search-request
1225def request(query, params):
1326 params['url'] = search_url.format(query=urlencode({'q': query}))
27+
1428 params['headers']['Accept'] = accept_header
29+
1530 return params
1631
1732
33+# get response from search-request
1834def response(resp):
1935 results = []
36+
2037 search_res = loads(resp.text)
38+
39+ # check if items are recieved
2140 if not 'items' in search_res:
22− return results
41+ return []
42+
43+ # parse results
2344 for res in search_res['items']:
2445 title = res['name']
2546 url = res['html_url']
47+
2648 if res['description']:
2749 content = escape(res['description'][:500])
2850 else:
2951 content = ''
30− results.append({'url': url, 'title': title, 'content': content})
52+
53+ # append result
54+ results.append({'url': url,
55+ 'title': title,
56+ 'content': content})
57+
58+ # return results
3159 return results