searx.engines.public_domain_image_archive Namespace Reference

Functions
	_clean_url (url)
	_get_algolia_api_key ()
	_clear_cached_api_key ()
	request (query, params)
	response (resp)

Variables
str	THUMBNAIL_SUFFIX = "?fit=max&h=360&w=360"
dict	about
str	base_url = 'https://oqi2j6v4iz-dsn.algolia.net'
str	pdia_config_url = 'https://pdimagearchive.org/_astro/config.BiNvrvzG.js'
list	categories = ['images']
int	page_size = 20
bool	paging = True
	__CACHED_API_KEY = None

Detailed Description

Public domain image archive

Function Documentation

_clean_url()

searx.engines.public_domain_image_archive._clean_url ( url )

protected

Definition at line 52 of file public_domain_image_archive.py.

def _clean_url(url):
    parsed = urlparse(url)
    query = [(k, v) for (k, v) in parse_qsl(parsed.query) if k not in ['ixid', 's']]
 
    return urlunparse((parsed.scheme, parsed.netloc, parsed.path, parsed.params, urlencode(query), parsed.fragment))
 
 

Referenced by response().

Here is the caller graph for this function:

_clear_cached_api_key()

searx.engines.public_domain_image_archive._clear_cached_api_key ( )

protected

Definition at line 78 of file public_domain_image_archive.py.

def _clear_cached_api_key():
    global __CACHED_API_KEY  # pylint:disable=global-statement
 
    __CACHED_API_KEY = None
 
 

Referenced by response().

Here is the caller graph for this function:

_get_algolia_api_key()

searx.engines.public_domain_image_archive._get_algolia_api_key ( )

protected

Definition at line 59 of file public_domain_image_archive.py.

def _get_algolia_api_key():
    global __CACHED_API_KEY  # pylint:disable=global-statement
 
    if __CACHED_API_KEY:
        return __CACHED_API_KEY
 
    resp = get(pdia_config_url)
    if resp.status_code != 200:
        raise LookupError("Failed to obtain Algolia API key for PDImageArchive")
 
    api_key = extr(resp.text, 'r="', '"', default=None)
 
    if api_key is None:
        raise LookupError("Couldn't obtain Algolia API key for PDImageArchive")
 
    __CACHED_API_KEY = api_key
    return api_key
 
 

Referenced by request().

Here is the caller graph for this function:

request()

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

Definition at line 84 of file public_domain_image_archive.py.

def request(query, params):
    api_key = _get_algolia_api_key()
 
    args = {
        'x-algolia-api-key': api_key,
        'x-algolia-application-id': 'OQI2J6V4IZ',
    }
    params['url'] = f"{base_url}/1/indexes/*/queries?{urlencode(args)}"
    params["method"] = "POST"
 
    request_params = {
        "page": params["pageno"] - 1,
        "query": query,
        "highlightPostTag": "__ais-highlight__",
        "highlightPreTag": "__ais-highlight__",
    }
    data = {
        "requests": [
            {"indexName": "prod_all-images", "params": urlencode(request_params)},
        ]
    }
    params["data"] = dumps(data)
 
    # http errors are handled manually to be able to reset the api key
    params['raise_for_httperror'] = False
    return params
 
 

References _get_algolia_api_key().

Here is the call graph for this function:

response()

searx.engines.public_domain_image_archive.response

(

resp

)

Definition at line 112 of file public_domain_image_archive.py.

def response(resp):
    results = []
    json_data = resp.json()
 
    if resp.status_code == 403:
        _clear_cached_api_key()
        raise SearxEngineAccessDeniedException()
 
    if resp.status_code != 200:
        raise SearxEngineException()
 
    if 'results' not in json_data:
        return []
 
    for result in json_data['results'][0]['hits']:
        content = []
 
        if "themes" in result:
            content.append("Themes: " + result['themes'])
 
        if "encompassingWork" in result:
            content.append("Encompassing work: " + result['encompassingWork'])
        content = "\n".join(content)
 
        base_image_url = result['thumbnail'].split("?")[0]
 
        results.append(
            {
                'template': 'images.html',
                'url': _clean_url(f"{about['website']}/images/{result['objectID']}"),
                'img_src': _clean_url(base_image_url),
                'thumbnail_src': _clean_url(base_image_url + THUMBNAIL_SUFFIX),
                'title': f"{result['title'].strip()} by {result['artist']} {result.get('displayYear', '')}",
                'content': content,
            }
        )
 
    return results

References _clean_url(), and _clear_cached_api_key().

Here is the call graph for this function:

Variable Documentation

__CACHED_API_KEY

searx.engines.public_domain_image_archive.__CACHED_API_KEY = None

private

Definition at line 49 of file public_domain_image_archive.py.

about

dict searx.engines.public_domain_image_archive.about

Initial value:

=  {
    "website": 'https://pdimagearchive.org',
    "use_official_api": False,
    "require_api_key": False,
    "results": 'JSON',
}

Definition at line 35 of file public_domain_image_archive.py.

base_url

str searx.engines.public_domain_image_archive.base_url = 'https://oqi2j6v4iz-dsn.algolia.net'

Definition at line 42 of file public_domain_image_archive.py.

categories

list searx.engines.public_domain_image_archive.categories = ['images']

Definition at line 44 of file public_domain_image_archive.py.

page_size

int searx.engines.public_domain_image_archive.page_size = 20

Definition at line 45 of file public_domain_image_archive.py.

paging

bool searx.engines.public_domain_image_archive.paging = True

Definition at line 46 of file public_domain_image_archive.py.

pdia_config_url

str searx.engines.public_domain_image_archive.pdia_config_url = 'https://pdimagearchive.org/_astro/config.BiNvrvzG.js'

Definition at line 43 of file public_domain_image_archive.py.

THUMBNAIL_SUFFIX

str searx.engines.public_domain_image_archive.THUMBNAIL_SUFFIX = "?fit=max&h=360&w=360"

Definition at line 11 of file public_domain_image_archive.py.