mirror of
https://github.com/searxng/searxng.git
synced 2025-11-03 19:17:07 -05: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
120 lines
4.1 KiB
Python
120 lines
4.1 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""Exception types raised by SearXNG modules.
|
|
"""
|
|
|
|
import typing as t
|
|
from lxml.etree import XPath
|
|
|
|
|
|
class SearxException(Exception):
|
|
"""Base SearXNG exception."""
|
|
|
|
|
|
class SearxParameterException(SearxException):
|
|
"""Raised when query miss a required parameter"""
|
|
|
|
def __init__(self, name: str, value: t.Any):
|
|
if value == '' or value is None:
|
|
message = f"Empty {name} parameter"
|
|
else:
|
|
message = f"Invalid value {value} for parameter {name}"
|
|
super().__init__(message)
|
|
self.message: str = message
|
|
self.parameter_name: str = name
|
|
self.parameter_value: t.Any = value
|
|
|
|
|
|
@t.final
|
|
class SearxSettingsException(SearxException):
|
|
"""Error while loading the settings"""
|
|
|
|
def __init__(self, message: str | Exception, filename: str | None):
|
|
super().__init__(message)
|
|
self.message = message
|
|
self.filename = filename
|
|
|
|
|
|
class SearxEngineException(SearxException):
|
|
"""Error inside an engine"""
|
|
|
|
|
|
class SearxXPathSyntaxException(SearxEngineException):
|
|
"""Syntax error in a XPATH"""
|
|
|
|
def __init__(self, xpath_spec: str | XPath, message: str):
|
|
super().__init__(str(xpath_spec) + " " + message)
|
|
self.message: str = message
|
|
# str(xpath_spec) to deal with str and XPath instance
|
|
self.xpath_str: str = str(xpath_spec)
|
|
|
|
|
|
class SearxEngineResponseException(SearxEngineException):
|
|
"""Impossible to parse the result of an engine"""
|
|
|
|
|
|
class SearxEngineAPIException(SearxEngineResponseException):
|
|
"""The website has returned an application error"""
|
|
|
|
|
|
class SearxEngineAccessDeniedException(SearxEngineResponseException):
|
|
"""The website is blocking the access"""
|
|
|
|
SUSPEND_TIME_SETTING: str = "search.suspended_times.SearxEngineAccessDenied"
|
|
"""This settings contains the default suspended time (default 86400 sec / 1
|
|
day)."""
|
|
|
|
def __init__(self, suspended_time: int | None = None, message: str = 'Access denied'):
|
|
"""Generic exception to raise when an engine denies access to the results.
|
|
|
|
:param suspended_time: How long the engine is going to be suspended in
|
|
second. Defaults to None.
|
|
:type suspended_time: int, None
|
|
:param message: Internal message. Defaults to ``Access denied``
|
|
:type message: str
|
|
"""
|
|
if suspended_time is None:
|
|
suspended_time = self._get_default_suspended_time()
|
|
super().__init__(message + ', suspended_time=' + str(suspended_time))
|
|
self.suspended_time: int = suspended_time
|
|
self.message: str = message
|
|
|
|
def _get_default_suspended_time(self) -> int:
|
|
from searx import get_setting # pylint: disable=C0415
|
|
|
|
return get_setting(self.SUSPEND_TIME_SETTING)
|
|
|
|
|
|
class SearxEngineCaptchaException(SearxEngineAccessDeniedException):
|
|
"""The website has returned a CAPTCHA."""
|
|
|
|
SUSPEND_TIME_SETTING: str = "search.suspended_times.SearxEngineCaptcha"
|
|
"""This settings contains the default suspended time (default 86400 sec / 1
|
|
day)."""
|
|
|
|
def __init__(self, suspended_time: int | None = None, message: str = 'CAPTCHA'):
|
|
super().__init__(message=message, suspended_time=suspended_time)
|
|
|
|
|
|
class SearxEngineTooManyRequestsException(SearxEngineAccessDeniedException):
|
|
"""The website has returned a Too Many Request status code
|
|
|
|
By default, SearXNG stops sending requests to this engine for 1 hour.
|
|
"""
|
|
|
|
SUSPEND_TIME_SETTING: str = "search.suspended_times.SearxEngineTooManyRequests"
|
|
"""This settings contains the default suspended time (default 3660 sec / 1
|
|
hour)."""
|
|
|
|
def __init__(self, suspended_time: int | None = None, message: str = 'Too many request'):
|
|
super().__init__(message=message, suspended_time=suspended_time)
|
|
|
|
|
|
class SearxEngineXPathException(SearxEngineResponseException):
|
|
"""Error while getting the result of an XPath expression"""
|
|
|
|
def __init__(self, xpath_spec: str | XPath, message: str):
|
|
super().__init__(str(xpath_spec) + " " + message)
|
|
self.message: str = message
|
|
# str(xpath_spec) to deal with str and XPath instance
|
|
self.xpath_str: str = str(xpath_spec)
|