|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
import typing
|
|
|
|
|
|
class EngineRef:
|
|
"""Reference by names to an engine and category"""
|
|
|
|
__slots__ = 'name', 'category'
|
|
|
|
def __init__(self, name: str, category: str):
|
|
self.name = name
|
|
self.category = category
|
|
|
|
def __repr__(self):
|
|
return "EngineRef({!r}, {!r})".format(self.name, self.category)
|
|
|
|
def __eq__(self, other):
|
|
return self.name == other.name and self.category == other.category
|
|
|
|
def __hash__(self):
|
|
return hash((self.name, self.category))
|
|
|
|
|
|
class SearchQuery:
|
|
"""container for all the search parameters (query, language, etc...)"""
|
|
|
|
__slots__ = (
|
|
'query',
|
|
'engineref_list',
|
|
'lang',
|
|
'safesearch',
|
|
'pageno',
|
|
'time_range',
|
|
'timeout_limit',
|
|
'external_bang',
|
|
'engine_data',
|
|
)
|
|
|
|
def __init__(
|
|
self,
|
|
query: str,
|
|
engineref_list: typing.List[EngineRef],
|
|
lang: str = 'all',
|
|
safesearch: int = 0,
|
|
pageno: int = 1,
|
|
time_range: typing.Optional[str] = None,
|
|
timeout_limit: typing.Optional[float] = None,
|
|
external_bang: typing.Optional[str] = None,
|
|
engine_data: typing.Optional[typing.Dict[str, str]] = None,
|
|
):
|
|
self.query = query
|
|
self.engineref_list = engineref_list
|
|
self.lang = lang
|
|
self.safesearch = safesearch
|
|
self.pageno = pageno
|
|
self.time_range = time_range
|
|
self.timeout_limit = timeout_limit
|
|
self.external_bang = external_bang
|
|
self.engine_data = engine_data or {}
|
|
|
|
@property
|
|
def categories(self):
|
|
return list(set(map(lambda engineref: engineref.category, self.engineref_list)))
|
|
|
|
def __repr__(self):
|
|
return "SearchQuery({!r}, {!r}, {!r}, {!r}, {!r}, {!r}, {!r}, {!r})".format(
|
|
self.query,
|
|
self.engineref_list,
|
|
self.lang,
|
|
self.safesearch,
|
|
self.pageno,
|
|
self.time_range,
|
|
self.timeout_limit,
|
|
self.external_bang,
|
|
)
|
|
|
|
def __eq__(self, other):
|
|
return (
|
|
self.query == other.query
|
|
and self.engineref_list == other.engineref_list
|
|
and self.lang == other.lang
|
|
and self.safesearch == other.safesearch
|
|
and self.pageno == other.pageno
|
|
and self.time_range == other.time_range
|
|
and self.timeout_limit == other.timeout_limit
|
|
and self.external_bang == other.external_bang
|
|
)
|
|
|
|
def __hash__(self):
|
|
return hash(
|
|
(
|
|
self.query,
|
|
tuple(self.engineref_list),
|
|
self.lang,
|
|
self.safesearch,
|
|
self.pageno,
|
|
self.time_range,
|
|
self.timeout_limit,
|
|
self.external_bang,
|
|
)
|
|
)
|