| 
							
							# SPDX-License-Identifier: AGPL-3.0-or-later
 | 
						
						
						
						
							 | 
							
							"""BASE (Scholar publications)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							"""
 | 
						
						
						
						
							 | 
							
							from datetime import datetime
 | 
						
						
						
						
							 | 
							
							import re
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							from urllib.parse import urlencode
 | 
						
						
						
						
							 | 
							
							from lxml import etree
 | 
						
						
						
						
							 | 
							
							from searx.utils import searx_useragent
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# about
 | 
						
						
						
						
							 | 
							
							about = {
 | 
						
						
						
						
							 | 
							
							    "website": 'https://base-search.net',
 | 
						
						
						
						
							 | 
							
							    "wikidata_id": 'Q448335',
 | 
						
						
						
						
							 | 
							
							    "official_api_documentation": 'https://api.base-search.net/',
 | 
						
						
						
						
							 | 
							
							    "use_official_api": True,
 | 
						
						
						
						
							 | 
							
							    "require_api_key": False,
 | 
						
						
						
						
							 | 
							
							    "results": 'XML',
 | 
						
						
						
						
							 | 
							
							}
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							categories = ['science']
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							base_url = (
 | 
						
						
						
						
							 | 
							
							    'https://api.base-search.net/cgi-bin/BaseHttpSearchInterface.fcgi'
 | 
						
						
						
						
							 | 
							
							    + '?func=PerformSearch&{query}&boost=oa&hits={hits}&offset={offset}'
 | 
						
						
						
						
							 | 
							
							)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# engine dependent config
 | 
						
						
						
						
							 | 
							
							paging = True
 | 
						
						
						
						
							 | 
							
							number_of_results = 10
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							# shortcuts for advanced search
 | 
						
						
						
						
							 | 
							
							shortcut_dict = {
 | 
						
						
						
						
							 | 
							
							    # user-friendly keywords
 | 
						
						
						
						
							 | 
							
							    'format:': 'dcformat:',
 | 
						
						
						
						
							 | 
							
							    'author:': 'dccreator:',
 | 
						
						
						
						
							 | 
							
							    'collection:': 'dccollection:',
 | 
						
						
						
						
							 | 
							
							    'hdate:': 'dchdate:',
 | 
						
						
						
						
							 | 
							
							    'contributor:': 'dccontributor:',
 | 
						
						
						
						
							 | 
							
							    'coverage:': 'dccoverage:',
 | 
						
						
						
						
							 | 
							
							    'date:': 'dcdate:',
 | 
						
						
						
						
							 | 
							
							    'abstract:': 'dcdescription:',
 | 
						
						
						
						
							 | 
							
							    'urls:': 'dcidentifier:',
 | 
						
						
						
						
							 | 
							
							    'language:': 'dclanguage:',
 | 
						
						
						
						
							 | 
							
							    'publisher:': 'dcpublisher:',
 | 
						
						
						
						
							 | 
							
							    'relation:': 'dcrelation:',
 | 
						
						
						
						
							 | 
							
							    'rights:': 'dcrights:',
 | 
						
						
						
						
							 | 
							
							    'source:': 'dcsource:',
 | 
						
						
						
						
							 | 
							
							    'subject:': 'dcsubject:',
 | 
						
						
						
						
							 | 
							
							    'title:': 'dctitle:',
 | 
						
						
						
						
							 | 
							
							    'type:': 'dcdctype:',
 | 
						
						
						
						
							 | 
							
							}
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							def request(query, params):
 | 
						
						
						
						
							 | 
							
							    # replace shortcuts with API advanced search keywords
 | 
						
						
						
						
							 | 
							
							    for key, val in shortcut_dict.items():
 | 
						
						
						
						
							 | 
							
							        query = re.sub(key, val, query)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    # basic search
 | 
						
						
						
						
							 | 
							
							    offset = (params['pageno'] - 1) * number_of_results
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    string_args = {
 | 
						
						
						
						
							 | 
							
							        'query': urlencode({'query': query}),
 | 
						
						
						
						
							 | 
							
							        'offset': offset,
 | 
						
						
						
						
							 | 
							
							        'hits': number_of_results,
 | 
						
						
						
						
							 | 
							
							    }
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    params['url'] = base_url.format(**string_args)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    params['headers']['User-Agent'] = searx_useragent()
 | 
						
						
						
						
							 | 
							
							    return params
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							def response(resp):
 | 
						
						
						
						
							 | 
							
							    results = []
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    search_results = etree.XML(resp.content)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    for entry in search_results.xpath('./result/doc'):
 | 
						
						
						
						
							 | 
							
							        content = "No description available"
 | 
						
						
						
						
							 | 
							
							        url = ""
 | 
						
						
						
						
							 | 
							
							        title = ""
 | 
						
						
						
						
							 | 
							
							        date = datetime.now()  # needed in case no dcdate is available for an item
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        for item in entry:
 | 
						
						
						
						
							 | 
							
							            if item.attrib["name"] == "dcdate":
 | 
						
						
						
						
							 | 
							
							                date = item.text
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							            elif item.attrib["name"] == "dctitle":
 | 
						
						
						
						
							 | 
							
							                title = item.text
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							            elif item.attrib["name"] == "dclink":
 | 
						
						
						
						
							 | 
							
							                url = item.text
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							            elif item.attrib["name"] == "dcdescription":
 | 
						
						
						
						
							 | 
							
							                content = item.text[:300]
 | 
						
						
						
						
							 | 
							
							                if len(item.text) > 300:
 | 
						
						
						
						
							 | 
							
							                    content += "..."
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        # dates returned by the BASE API are not several formats
 | 
						
						
						
						
							 | 
							
							        publishedDate = None
 | 
						
						
						
						
							 | 
							
							        for date_format in ['%Y-%m-%dT%H:%M:%SZ', '%Y-%m-%d', '%Y-%m', '%Y']:
 | 
						
						
						
						
							 | 
							
							            try:
 | 
						
						
						
						
							 | 
							
							                publishedDate = datetime.strptime(date, date_format)
 | 
						
						
						
						
							 | 
							
							                break
 | 
						
						
						
						
							 | 
							
							            except:  # pylint: disable=bare-except
 | 
						
						
						
						
							 | 
							
							                pass
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        if publishedDate is not None:
 | 
						
						
						
						
							 | 
							
							            res_dict = {'url': url, 'title': title, 'publishedDate': publishedDate, 'content': content}
 | 
						
						
						
						
							 | 
							
							        else:
 | 
						
						
						
						
							 | 
							
							            res_dict = {'url': url, 'title': title, 'content': content}
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        results.append(res_dict)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    return results
 |