|  | ## Yacy (Web, Images, Videos, Music, Files)
 | 
						
						
						
							|  | #
 | 
						
						
						
							|  | # @website     http://yacy.net
 | 
						
						
						
							|  | # @provide-api yes
 | 
						
						
						
							|  | #              (http://www.yacy-websuche.de/wiki/index.php/Dev:APIyacysearch)
 | 
						
						
						
							|  | #
 | 
						
						
						
							|  | # @using-api   yes
 | 
						
						
						
							|  | # @results     JSON
 | 
						
						
						
							|  | # @stable      yes
 | 
						
						
						
							|  | # @parse       (general)    url, title, content, publishedDate
 | 
						
						
						
							|  | # @parse       (images)     url, title, img_src
 | 
						
						
						
							|  | #
 | 
						
						
						
							|  | # @todo        parse video, audio and file results
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  | from json import loads
 | 
						
						
						
							|  | from urllib import urlencode
 | 
						
						
						
							|  | from dateutil import parser
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  | # engine dependent config
 | 
						
						
						
							|  | categories = ['general', 'images']  # TODO , 'music', 'videos', 'files'
 | 
						
						
						
							|  | paging = True
 | 
						
						
						
							|  | language_support = True
 | 
						
						
						
							|  | number_of_results = 5
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  | # search-url
 | 
						
						
						
							|  | base_url = 'http://localhost:8090'
 | 
						
						
						
							|  | search_url = '/yacysearch.json?{query}&startRecord={offset}&maximumRecords={limit}&contentdom={search_type}&resource=global'
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  | # yacy specific type-definitions
 | 
						
						
						
							|  | search_types = {'general': 'text',
 | 
						
						
						
							|  |                 'images': 'image',
 | 
						
						
						
							|  |                 'files': 'app',
 | 
						
						
						
							|  |                 'music': 'audio',
 | 
						
						
						
							|  |                 'videos': 'video'}
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  | # do search-request
 | 
						
						
						
							|  | def request(query, params):
 | 
						
						
						
							|  |     offset = (params['pageno'] - 1) * number_of_results
 | 
						
						
						
							|  |     search_type = search_types.get(params['category'], '0')
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |     params['url'] = base_url + search_url.format(query=urlencode({'query': query}),
 | 
						
						
						
							|  |                                                  offset=offset,
 | 
						
						
						
							|  |                                                  limit=number_of_results,
 | 
						
						
						
							|  |                                                  search_type=search_type)
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |     # add language tag if specified
 | 
						
						
						
							|  |     if params['language'] != 'all':
 | 
						
						
						
							|  |         params['url'] += '&lr=lang_' + params['language'].split('_')[0]
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |     return params
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  | # get response from search-request
 | 
						
						
						
							|  | def response(resp):
 | 
						
						
						
							|  |     results = []
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |     raw_search_results = loads(resp.text)
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |     # return empty array if there are no results
 | 
						
						
						
							|  |     if not raw_search_results:
 | 
						
						
						
							|  |         return []
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |     search_results = raw_search_results.get('channels', {})[0].get('items', [])
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |     if resp.search_params['category'] == 'general':
 | 
						
						
						
							|  |         # parse general results
 | 
						
						
						
							|  |         for result in search_results:
 | 
						
						
						
							|  |             publishedDate = parser.parse(result['pubDate'])
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |             # append result
 | 
						
						
						
							|  |             results.append({'url': result['link'],
 | 
						
						
						
							|  |                         'title': result['title'],
 | 
						
						
						
							|  |                         'content': result['description'],
 | 
						
						
						
							|  |                         'publishedDate': publishedDate})
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |     elif resp.search_params['category'] == 'images':
 | 
						
						
						
							|  |         # parse image results
 | 
						
						
						
							|  |         for result in search_results:
 | 
						
						
						
							|  |             # append result
 | 
						
						
						
							|  |             results.append({'url': result['url'],
 | 
						
						
						
							|  |                         'title': result['title'],
 | 
						
						
						
							|  |                         'content': '',
 | 
						
						
						
							|  |                         'img_src': result['image'],
 | 
						
						
						
							|  |                         'template': 'images.html'})
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |     #TODO parse video, audio and file results
 | 
						
						
						
							|  | 
 | 
						
						
						
							|  |     # return results
 | 
						
						
						
							|  |     return results
 |