| 
							
							"""
 | 
						
						
						
						
							 | 
							
							 DuckDuckGo (Web)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							 @website     https://duckduckgo.com/
 | 
						
						
						
						
							 | 
							
							 @provide-api yes (https://duckduckgo.com/api),
 | 
						
						
						
						
							 | 
							
							              but not all results from search-site
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							 @using-api   no
 | 
						
						
						
						
							 | 
							
							 @results     HTML (using search portal)
 | 
						
						
						
						
							 | 
							
							 @stable      no (HTML can change)
 | 
						
						
						
						
							 | 
							
							 @parse       url, title, content
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							 @todo        rewrite to api
 | 
						
						
						
						
							 | 
							
							 @todo        language support
 | 
						
						
						
						
							 | 
							
							              (the current used site does not support language-change)
 | 
						
						
						
						
							 | 
							
							"""
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							from urllib import urlencode
 | 
						
						
						
						
							 | 
							
							from lxml.html import fromstring
 | 
						
						
						
						
							 | 
							
							from searx.engines.xpath import extract_text
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# engine dependent config
 | 
						
						
						
						
							 | 
							
							categories = ['general']
 | 
						
						
						
						
							 | 
							
							paging = True
 | 
						
						
						
						
							 | 
							
							language_support = True
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# search-url
 | 
						
						
						
						
							 | 
							
							url = 'https://duckduckgo.com/html?{query}&s={offset}'
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# specific xpath variables
 | 
						
						
						
						
							 | 
							
							result_xpath = '//div[@class="results_links results_links_deep web-result"]'  # noqa
 | 
						
						
						
						
							 | 
							
							url_xpath = './/a[@class="large"]/@href'
 | 
						
						
						
						
							 | 
							
							title_xpath = './/a[@class="large"]'
 | 
						
						
						
						
							 | 
							
							content_xpath = './/div[@class="snippet"]'
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# do search-request
 | 
						
						
						
						
							 | 
							
							def request(query, params):
 | 
						
						
						
						
							 | 
							
							    offset = (params['pageno'] - 1) * 30
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    if params['language'] == 'all':
 | 
						
						
						
						
							 | 
							
							        locale = 'en-us'
 | 
						
						
						
						
							 | 
							
							    else:
 | 
						
						
						
						
							 | 
							
							        locale = params['language'].replace('_', '-').lower()
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    params['url'] = url.format(
 | 
						
						
						
						
							 | 
							
							        query=urlencode({'q': query, 'kl': locale}),
 | 
						
						
						
						
							 | 
							
							        offset=offset)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    return params
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# get response from search-request
 | 
						
						
						
						
							 | 
							
							def response(resp):
 | 
						
						
						
						
							 | 
							
							    results = []
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    doc = fromstring(resp.text)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    # parse results
 | 
						
						
						
						
							 | 
							
							    for r in doc.xpath(result_xpath):
 | 
						
						
						
						
							 | 
							
							        try:
 | 
						
						
						
						
							 | 
							
							            res_url = r.xpath(url_xpath)[-1]
 | 
						
						
						
						
							 | 
							
							        except:
 | 
						
						
						
						
							 | 
							
							            continue
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        if not res_url:
 | 
						
						
						
						
							 | 
							
							            continue
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        title = extract_text(r.xpath(title_xpath))
 | 
						
						
						
						
							 | 
							
							        content = extract_text(r.xpath(content_xpath))
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        # append result
 | 
						
						
						
						
							 | 
							
							        results.append({'title': title,
 | 
						
						
						
						
							 | 
							
							                        'content': content,
 | 
						
						
						
						
							 | 
							
							                        'url': res_url})
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    # return results
 | 
						
						
						
						
							 | 
							
							    return results
 |