| 
							
							"""
 | 
						
						
						
						
							 | 
							
							 Gigablast (Web)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							 @website     https://gigablast.com
 | 
						
						
						
						
							 | 
							
							 @provide-api yes (https://gigablast.com/api.html)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							 @using-api   yes
 | 
						
						
						
						
							 | 
							
							 @results     XML
 | 
						
						
						
						
							 | 
							
							 @stable      yes
 | 
						
						
						
						
							 | 
							
							 @parse       url, title, content
 | 
						
						
						
						
							 | 
							
							"""
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							from urllib import urlencode
 | 
						
						
						
						
							 | 
							
							from cgi import escape
 | 
						
						
						
						
							 | 
							
							from lxml import etree
 | 
						
						
						
						
							 | 
							
							from random import randint
 | 
						
						
						
						
							 | 
							
							from time import time
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# engine dependent config
 | 
						
						
						
						
							 | 
							
							categories = ['general']
 | 
						
						
						
						
							 | 
							
							paging = True
 | 
						
						
						
						
							 | 
							
							number_of_results = 10
 | 
						
						
						
						
							 | 
							
							language_support = True
 | 
						
						
						
						
							 | 
							
							safesearch = True
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# search-url
 | 
						
						
						
						
							 | 
							
							base_url = 'https://gigablast.com/'
 | 
						
						
						
						
							 | 
							
							search_string = 'search?{query}'\
 | 
						
						
						
						
							 | 
							
							    '&n={number_of_results}'\
 | 
						
						
						
						
							 | 
							
							    '&s={offset}'\
 | 
						
						
						
						
							 | 
							
							    '&format=xml'\
 | 
						
						
						
						
							 | 
							
							    '&qh=0'\
 | 
						
						
						
						
							 | 
							
							    '&rxiyd={rxiyd}'\
 | 
						
						
						
						
							 | 
							
							    '&rand={rand}'\
 | 
						
						
						
						
							 | 
							
							    '&qlang={lang}'\
 | 
						
						
						
						
							 | 
							
							    '&ff={safesearch}'
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# specific xpath variables
 | 
						
						
						
						
							 | 
							
							results_xpath = '//response//result'
 | 
						
						
						
						
							 | 
							
							url_xpath = './/url'
 | 
						
						
						
						
							 | 
							
							title_xpath = './/title'
 | 
						
						
						
						
							 | 
							
							content_xpath = './/sum'
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# do search-request
 | 
						
						
						
						
							 | 
							
							def request(query, params):
 | 
						
						
						
						
							 | 
							
							    offset = (params['pageno'] - 1) * number_of_results
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    if params['language'] == 'all':
 | 
						
						
						
						
							 | 
							
							        language = 'xx'
 | 
						
						
						
						
							 | 
							
							    else:
 | 
						
						
						
						
							 | 
							
							        language = params['language'][0:2]
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    if params['safesearch'] >= 1:
 | 
						
						
						
						
							 | 
							
							        safesearch = 1
 | 
						
						
						
						
							 | 
							
							    else:
 | 
						
						
						
						
							 | 
							
							        safesearch = 0
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    search_path = search_string.format(query=urlencode({'q': query}),
 | 
						
						
						
						
							 | 
							
							                                       offset=offset,
 | 
						
						
						
						
							 | 
							
							                                       number_of_results=number_of_results,
 | 
						
						
						
						
							 | 
							
							                                       rxiyd=randint(10000, 10000000),
 | 
						
						
						
						
							 | 
							
							                                       rand=int(time()),
 | 
						
						
						
						
							 | 
							
							                                       lang=language,
 | 
						
						
						
						
							 | 
							
							                                       safesearch=safesearch)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    params['url'] = base_url + search_path
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    return params
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# get response from search-request
 | 
						
						
						
						
							 | 
							
							def response(resp):
 | 
						
						
						
						
							 | 
							
							    results = []
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    dom = etree.fromstring(resp.content)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    # parse results
 | 
						
						
						
						
							 | 
							
							    for result in dom.xpath(results_xpath):
 | 
						
						
						
						
							 | 
							
							        url = result.xpath(url_xpath)[0].text
 | 
						
						
						
						
							 | 
							
							        title = result.xpath(title_xpath)[0].text
 | 
						
						
						
						
							 | 
							
							        content = escape(result.xpath(content_xpath)[0].text)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        # append result
 | 
						
						
						
						
							 | 
							
							        results.append({'url': url,
 | 
						
						
						
						
							 | 
							
							                        'title': title,
 | 
						
						
						
						
							 | 
							
							                        'content': content})
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    # return results
 | 
						
						
						
						
							 | 
							
							    return results
 |