searx.engines.wolframalpha_api Namespace Reference

Functions
	request (query, params)
	replace_pua_chars (text)
	response (resp)

Variables
dict	about
str	search_url = 'https://api.wolframalpha.com/v2/query?appid={api_key}&{query}'
str	site_url = 'https://www.wolframalpha.com/input/?{query}'
str	api_key = ''
str	failure_xpath = '/queryresult[attribute::success="false"]'
str	input_xpath = '//pod[starts-with(attribute::id, "Input")]/subpod/plaintext'
str	pods_xpath = '//pod'
str	subpods_xpath = './subpod'
str	pod_primary_xpath = './@primary'
str	pod_id_xpath = './@id'
str	pod_title_xpath = './@title'
str	plaintext_xpath = './plaintext'
str	image_xpath = './img'
str	img_src_xpath = './@src'
str	img_alt_xpath = './@alt'
dict	image_pods = {'VisualRepresentation', 'Illustration'}

Detailed Description

Wolfram|Alpha (Science)

Function Documentation

replace_pua_chars()

searx.engines.wolframalpha_api.replace_pua_chars

(

text

)

Definition at line 52 of file wolframalpha_api.py.

def replace_pua_chars(text):
    pua_chars = {
        '\uf522': '\u2192',  # right arrow
        '\uf7b1': '\u2115',  # set of natural numbers
        '\uf7b4': '\u211a',  # set of rational numbers
        '\uf7b5': '\u211d',  # set of real numbers
        '\uf7bd': '\u2124',  # set of integer numbers
        '\uf74c': 'd',  # differential
        '\uf74d': '\u212f',  # euler's number
        '\uf74e': 'i',  # imaginary number
        '\uf7d9': '=',
    }  # equals sign
 
    for k, v in pua_chars.items():
        text = text.replace(k, v)
 
    return text
 
 
# get response from search-request

Referenced by searx.engines.wolframalpha_api.response().

Here is the caller graph for this function:

request()

searx.engines.wolframalpha_api.request	(		query,
			params )

Definition at line 44 of file wolframalpha_api.py.

def request(query, params):
    params['url'] = search_url.format(query=urlencode({'input': query}), api_key=api_key)
    params['headers']['Referer'] = site_url.format(query=urlencode({'i': query}))
 
    return params
 
 
# replace private user area characters to make text legible

response()

searx.engines.wolframalpha_api.response

(

resp

)

Definition at line 72 of file wolframalpha_api.py.

def response(resp):
    results = []
 
    search_results = etree.XML(resp.content)
 
    # return empty array if there are no results
    if search_results.xpath(failure_xpath):
        return []
 
    try:
        infobox_title = search_results.xpath(input_xpath)[0].text
    except:  # pylint: disable=bare-except
        infobox_title = ""
 
    pods = search_results.xpath(pods_xpath)
    result_chunks = []
    result_content = ""
    for pod in pods:
        pod_id = pod.xpath(pod_id_xpath)[0]
        pod_title = pod.xpath(pod_title_xpath)[0]
        pod_is_result = pod.xpath(pod_primary_xpath)
 
        subpods = pod.xpath(subpods_xpath)
        if not subpods:
            continue
 
        # Appends either a text or an image, depending on which one is more suitable
        for subpod in subpods:
            content = subpod.xpath(plaintext_xpath)[0].text
            image = subpod.xpath(image_xpath)
 
            if content and pod_id not in image_pods:
 
                if pod_is_result or not result_content:
                    if pod_id != "Input":
                        result_content = "%s: %s" % (pod_title, content)
 
                # if no input pod was found, title is first plaintext pod
                if not infobox_title:
                    infobox_title = content
 
                content = replace_pua_chars(content)
                result_chunks.append({'label': pod_title, 'value': content})
 
            elif image:
                result_chunks.append(
                    {
                        'label': pod_title,
                        'image': {'src': image[0].xpath(img_src_xpath)[0], 'alt': image[0].xpath(img_alt_xpath)[0]},
                    }
                )
 
    if not result_chunks:
        return []
 
    title = "Wolfram Alpha (%s)" % infobox_title
 
    # append infobox
    results.append(
        {
            'infobox': infobox_title,
            'attributes': result_chunks,
            'urls': [{'title': 'Wolfram|Alpha', 'url': resp.request.headers['Referer']}],
        }
    )
 
    # append link to site
    results.append({'url': resp.request.headers['Referer'], 'title': title, 'content': result_content})
 
    return results

References searx.engines.wolframalpha_api.replace_pua_chars().

Here is the call graph for this function:

Variable Documentation

about

dict searx.engines.wolframalpha_api.about

Initial value:

=  {
    "website": 'https://www.wolframalpha.com',
    "wikidata_id": 'Q207006',
    "official_api_documentation": 'https://products.wolframalpha.com/api/',
    "use_official_api": True,
    "require_api_key": False,
    "results": 'XML',
}

Definition at line 11 of file wolframalpha_api.py.

api_key

str searx.engines.wolframalpha_api.api_key = ''

Definition at line 23 of file wolframalpha_api.py.

failure_xpath

str searx.engines.wolframalpha_api.failure_xpath = '/queryresult[attribute::success="false"]'

Definition at line 26 of file wolframalpha_api.py.

image_pods

dict searx.engines.wolframalpha_api.image_pods = {'VisualRepresentation', 'Illustration'}

Definition at line 40 of file wolframalpha_api.py.

image_xpath

str searx.engines.wolframalpha_api.image_xpath = './img'

Definition at line 34 of file wolframalpha_api.py.

img_alt_xpath

str searx.engines.wolframalpha_api.img_alt_xpath = './@alt'

Definition at line 36 of file wolframalpha_api.py.

img_src_xpath

str searx.engines.wolframalpha_api.img_src_xpath = './@src'

Definition at line 35 of file wolframalpha_api.py.

input_xpath

str searx.engines.wolframalpha_api.input_xpath = '//pod[starts-with(attribute::id, "Input")]/subpod/plaintext'

Definition at line 27 of file wolframalpha_api.py.

plaintext_xpath

str searx.engines.wolframalpha_api.plaintext_xpath = './plaintext'

Definition at line 33 of file wolframalpha_api.py.

pod_id_xpath

str searx.engines.wolframalpha_api.pod_id_xpath = './@id'

Definition at line 31 of file wolframalpha_api.py.

pod_primary_xpath

str searx.engines.wolframalpha_api.pod_primary_xpath = './@primary'

Definition at line 30 of file wolframalpha_api.py.

pod_title_xpath

str searx.engines.wolframalpha_api.pod_title_xpath = './@title'

Definition at line 32 of file wolframalpha_api.py.

pods_xpath

str searx.engines.wolframalpha_api.pods_xpath = '//pod'

Definition at line 28 of file wolframalpha_api.py.

search_url

str searx.engines.wolframalpha_api.search_url = 'https://api.wolframalpha.com/v2/query?appid={api_key}&{query}'

Definition at line 21 of file wolframalpha_api.py.

site_url

str searx.engines.wolframalpha_api.site_url = 'https://www.wolframalpha.com/input/?{query}'

Definition at line 22 of file wolframalpha_api.py.

subpods_xpath

str searx.engines.wolframalpha_api.subpods_xpath = './subpod'

Definition at line 29 of file wolframalpha_api.py.