mirror of
https://github.com/searxng/searxng.git
synced 2025-09-05 17:58:34 +02:00
57b9673efb
- pyright configuration [1]_ - stub files: types-lxml [2]_ - addition of various type hints - enable use of new type system features on older Python versions [3]_ - ``.tool-versions`` - set python to lowest version we support (3.10.18) [4]_: Older versions typically lack some typing features found in newer Python versions. Therefore, for local type checking (before commit), it is necessary to use the older Python interpreter. .. [1] https://docs.basedpyright.com/v1.20.0/configuration/config-files/ .. [2] https://pypi.org/project/types-lxml/ .. [3] https://typing-extensions.readthedocs.io/en/latest/# .. [4] https://mise.jdx.dev/configuration.html#tool-versions Signed-off-by: Markus Heiser <markus.heiser@darmarit.de> Format: reST
109 lines
3 KiB
Python
109 lines
3 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""Within this module we implement a *demo online engine*. Do not look to
|
|
close to the implementation, its just a simple example which queries `The Art
|
|
Institute of Chicago <https://www.artic.edu>`_
|
|
|
|
To get in use of this *demo* engine add the following entry to your engines
|
|
list in ``settings.yml``:
|
|
|
|
.. code:: yaml
|
|
|
|
- name: my online engine
|
|
engine: demo_online
|
|
shortcut: demo
|
|
disabled: false
|
|
|
|
"""
|
|
|
|
import typing as t
|
|
|
|
from json import loads
|
|
from urllib.parse import urlencode
|
|
from searx.result_types import EngineResults
|
|
|
|
if t.TYPE_CHECKING:
|
|
from searx.extended_types import SXNG_Response
|
|
|
|
|
|
engine_type = "online"
|
|
send_accept_language_header = True
|
|
categories = ["general"]
|
|
disabled = True
|
|
timeout = 2.0
|
|
categories = ["images"]
|
|
paging = True
|
|
page_size = 20
|
|
|
|
search_api = "https://api.artic.edu/api/v1/artworks/search?"
|
|
image_api = "https://www.artic.edu/iiif/2/"
|
|
|
|
about = {
|
|
"website": "https://www.artic.edu",
|
|
"wikidata_id": "Q239303",
|
|
"official_api_documentation": "http://api.artic.edu/docs/",
|
|
"use_official_api": True,
|
|
"require_api_key": False,
|
|
"results": "JSON",
|
|
}
|
|
|
|
|
|
# if there is a need for globals, use a leading underline
|
|
_my_online_engine = None
|
|
|
|
|
|
def init(engine_settings: dict[str, t.Any]) -> None:
|
|
"""Initialization of the (online) engine. If no initialization is needed, drop
|
|
this init function."""
|
|
global _my_online_engine # pylint: disable=global-statement
|
|
_my_online_engine = engine_settings.get("name")
|
|
|
|
|
|
def request(query: str, params: dict[str, t.Any]) -> None:
|
|
"""Build up the ``params`` for the online request. In this example we build a
|
|
URL to fetch images from `artic.edu <https://artic.edu>`__
|
|
|
|
"""
|
|
args = urlencode(
|
|
{
|
|
"q": query,
|
|
"page": params["pageno"],
|
|
"fields": "id,title,artist_display,medium_display,image_id,date_display,dimensions,artist_titles",
|
|
"limit": page_size,
|
|
}
|
|
)
|
|
params["url"] = search_api + args
|
|
|
|
|
|
def response(resp: "SXNG_Response") -> EngineResults:
|
|
"""Parse out the result items from the response. In this example we parse the
|
|
response from `api.artic.edu <https://artic.edu>`__ and filter out all
|
|
images.
|
|
|
|
"""
|
|
res = EngineResults()
|
|
json_data = loads(resp.text)
|
|
|
|
res.add(
|
|
res.types.Answer(
|
|
answer="this is a dummy answer ..",
|
|
url="https://example.org",
|
|
)
|
|
)
|
|
|
|
for result in json_data["data"]:
|
|
|
|
if not result["image_id"]:
|
|
continue
|
|
|
|
kwargs: dict[str, t.Any] = {
|
|
"url": "https://artic.edu/artworks/%(id)s" % result,
|
|
"title": result["title"] + " (%(date_display)s) // %(artist_display)s" % result,
|
|
"content": "%(medium_display)s // %(dimensions)s" % result,
|
|
"author": ", ".join(result["artist_titles"]),
|
|
"img_src": image_api + "/%(image_id)s/full/843,/0/default.jpg" % result,
|
|
"template": "images.html",
|
|
}
|
|
|
|
res.add(res.types.LegacyResult(**kwargs))
|
|
|
|
return res
|