Source code for searx.engines.bing_images

# SPDX-License-Identifier: AGPL-3.0-or-later
"""Bing-Images: description see :py:obj:`searx.engines.bing`."""

import typing as t
import json
from urllib.parse import urlencode

from lxml import html

from searx.engines.bing import fetch_traits  # pylint: disable=unused-import
from searx.result_types import EngineResults

if t.TYPE_CHECKING:
    from searx.extended_types import SXNG_Response
    from searx.search.processors import OnlineParams


about = {
    "website": "https://www.bing.com/images",
    "wikidata_id": "Q182496",
    "official_api_documentation": "https://github.com/MicrosoftDocs/bing-docs",
    "use_official_api": False,
    "require_api_key": False,
    "results": "HTML",
}

categories = ["images", "web"]
paging = True
enable_http3 = True
safesearch = True
time_range_support = True
time_map = {
    "day": 60 * 24,
    "week": 60 * 24 * 7,
    "month": 60 * 24 * 31,
    "year": 60 * 24 * 365,
}

base_url = "https://www.bing.com"
"""Bing-Image search URL"""




def request(query: str, params: "OnlineParams"):
    """Assemble a Bing-Image request."""

    engine_region = traits.get_region(params["searxng_locale"], traits.all_locale)

    # build URL query / example:
    # https://www.bing.com/images/async?q=foo&mmasync=1&first=1&count=35

    query_params = {
        "q": query,
        "mmasync": "1",
        # to simplify the page count lets use the default of 35 images per page
        "first": (int(params.get("pageno", 1)) - 1) * 35 + 1,
        "count": 35,
    }

    if engine_region and engine_region != "clear":
        lang, _, cc = engine_region.partition("-")
        query_params["setlang"] = lang
        if cc:
            query_params["cc"] = cc

    # time range
    # - example: one year (525600 minutes) 'qft=filterui:age-lt525600'
    if params["time_range"]:
        query_params["qft"] = "filterui:age-lt%s" % time_map[params["time_range"]]

    params["url"] = base_url + "/images/async?" + urlencode(query_params)





def response(resp: "SXNG_Response") -> EngineResults:
    """Get response from Bing-Image"""

    res = EngineResults()

    dom = html.fromstring(resp.text)

    for result in dom.xpath('//ul[contains(@class, "dgControl_list")]/li'):
        metadata = result.xpath('.//a[@class="iusc"]/@m')
        if not metadata:
            continue

        metadata = json.loads(result.xpath('.//a[@class="iusc"]/@m')[0])
        title = " ".join(result.xpath('.//div[@class="infnmpt"]//a/text()')).strip()
        if not title:
            title = result.xpath('.//div[@class="infnmpt"]//a/@title')[0]

        img_format = " ".join(result.xpath('.//div[@class="imgpt"]/div/span/text()')).strip().split(" · ")
        source = " ".join(result.xpath('.//div[@class="imgpt"]//div[@class="lnkw"]//a/text()')).strip()

        res.add(
            res.types.Image(
                title=title,
                url=metadata["purl"],
                thumbnail_src=metadata["turl"],
                img_src=metadata["murl"],
                content=metadata.get("desc"),
                source=source,
                resolution=img_format[0],
                img_format=img_format[1] if len(img_format) >= 2 else "",
            )
        )
    return res