2021-05-28 16:45:22 +00:00
|
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
2021-06-01 14:03:19 +00:00
|
|
|
"""Implementation of the default settings.
|
|
|
|
|
|
|
|
"""
|
2021-05-28 16:45:22 +00:00
|
|
|
|
|
|
|
import typing
|
|
|
|
import numbers
|
|
|
|
import errno
|
|
|
|
import os
|
|
|
|
import logging
|
2022-08-27 10:01:04 +00:00
|
|
|
from base64 import b64decode
|
2021-05-28 16:45:22 +00:00
|
|
|
from os.path import dirname, abspath
|
|
|
|
|
2022-10-10 17:31:22 +00:00
|
|
|
from .sxng_locales import sxng_locales
|
2021-05-28 16:45:22 +00:00
|
|
|
|
|
|
|
searx_dir = abspath(dirname(__file__))
|
|
|
|
|
|
|
|
logger = logging.getLogger('searx')
|
|
|
|
OUTPUT_FORMATS = ['html', 'csv', 'json', 'rss']
|
2022-10-10 17:31:22 +00:00
|
|
|
SXNG_LOCALE_TAGS = ['all', 'auto'] + list(l[0] for l in sxng_locales)
|
2024-09-20 14:44:53 +00:00
|
|
|
SIMPLE_STYLE = ('auto', 'light', 'dark', 'black')
|
2022-01-04 17:00:45 +00:00
|
|
|
CATEGORIES_AS_TABS = {
|
|
|
|
'general': {},
|
|
|
|
'images': {},
|
|
|
|
'videos': {},
|
|
|
|
'news': {},
|
|
|
|
'map': {},
|
|
|
|
'music': {},
|
|
|
|
'it': {},
|
|
|
|
'science': {},
|
|
|
|
'files': {},
|
|
|
|
'social media': {},
|
|
|
|
}
|
2021-05-28 16:45:22 +00:00
|
|
|
STR_TO_BOOL = {
|
|
|
|
'0': False,
|
|
|
|
'false': False,
|
|
|
|
'off': False,
|
|
|
|
'1': True,
|
|
|
|
'true': True,
|
|
|
|
'on': True,
|
|
|
|
}
|
|
|
|
_UNDEFINED = object()
|
|
|
|
|
2021-10-02 10:21:02 +00:00
|
|
|
|
2021-05-28 16:45:22 +00:00
|
|
|
class SettingsValue:
|
2021-12-27 08:26:22 +00:00
|
|
|
"""Check and update a setting value"""
|
|
|
|
|
|
|
|
def __init__(
|
|
|
|
self,
|
|
|
|
type_definition: typing.Union[None, typing.Any, typing.Tuple[typing.Any]] = None,
|
|
|
|
default: typing.Any = None,
|
|
|
|
environ_name: str = None,
|
|
|
|
):
|
2021-06-01 14:03:19 +00:00
|
|
|
self.type_definition = (
|
2021-12-27 08:26:22 +00:00
|
|
|
type_definition if type_definition is None or isinstance(type_definition, tuple) else (type_definition,)
|
2021-06-01 14:03:19 +00:00
|
|
|
)
|
2021-05-28 16:45:22 +00:00
|
|
|
self.default = default
|
|
|
|
self.environ_name = environ_name
|
|
|
|
|
|
|
|
@property
|
|
|
|
def type_definition_repr(self):
|
2021-12-27 08:26:22 +00:00
|
|
|
types_str = [t.__name__ if isinstance(t, type) else repr(t) for t in self.type_definition]
|
2021-05-28 16:45:22 +00:00
|
|
|
return ', '.join(types_str)
|
|
|
|
|
|
|
|
def check_type_definition(self, value: typing.Any) -> None:
|
|
|
|
if value in self.type_definition:
|
|
|
|
return
|
|
|
|
type_list = tuple(t for t in self.type_definition if isinstance(t, type))
|
|
|
|
if not isinstance(value, type_list):
|
2021-12-27 08:26:22 +00:00
|
|
|
raise ValueError('The value has to be one of these types/values: {}'.format(self.type_definition_repr))
|
2021-05-28 16:45:22 +00:00
|
|
|
|
|
|
|
def __call__(self, value: typing.Any) -> typing.Any:
|
|
|
|
if value == _UNDEFINED:
|
|
|
|
value = self.default
|
|
|
|
# override existing value with environ
|
|
|
|
if self.environ_name and self.environ_name in os.environ:
|
|
|
|
value = os.environ[self.environ_name]
|
|
|
|
if self.type_definition == (bool,):
|
|
|
|
value = STR_TO_BOOL[value.lower()]
|
2021-06-01 14:03:19 +00:00
|
|
|
|
2021-05-28 16:45:22 +00:00
|
|
|
self.check_type_definition(value)
|
|
|
|
return value
|
|
|
|
|
2021-10-21 08:41:57 +00:00
|
|
|
|
|
|
|
class SettingSublistValue(SettingsValue):
|
2021-12-27 08:26:22 +00:00
|
|
|
"""Check the value is a sublist of type definition."""
|
2021-10-21 08:41:57 +00:00
|
|
|
|
|
|
|
def check_type_definition(self, value: typing.Any) -> typing.Any:
|
|
|
|
if not isinstance(value, list):
|
|
|
|
raise ValueError('The value has to a list')
|
|
|
|
for item in value:
|
|
|
|
if not item in self.type_definition[0]:
|
|
|
|
raise ValueError('{} not in {}'.format(item, self.type_definition))
|
|
|
|
|
2021-12-27 08:26:22 +00:00
|
|
|
|
2021-05-28 16:45:22 +00:00
|
|
|
class SettingsDirectoryValue(SettingsValue):
|
2021-12-27 08:26:22 +00:00
|
|
|
"""Check and update a setting value that is a directory path"""
|
2021-05-28 16:45:22 +00:00
|
|
|
|
|
|
|
def check_type_definition(self, value: typing.Any) -> typing.Any:
|
|
|
|
super().check_type_definition(value)
|
|
|
|
if not os.path.isdir(value):
|
|
|
|
raise FileNotFoundError(errno.ENOENT, os.strerror(errno.ENOENT), value)
|
|
|
|
|
|
|
|
def __call__(self, value: typing.Any) -> typing.Any:
|
|
|
|
if value == '':
|
|
|
|
value = self.default
|
|
|
|
return super().__call__(value)
|
|
|
|
|
|
|
|
|
2022-08-27 10:01:04 +00:00
|
|
|
class SettingsBytesValue(SettingsValue):
|
|
|
|
"""str are base64 decoded"""
|
|
|
|
|
|
|
|
def __call__(self, value: typing.Any) -> typing.Any:
|
|
|
|
if isinstance(value, str):
|
|
|
|
value = b64decode(value)
|
|
|
|
return super().__call__(value)
|
|
|
|
|
|
|
|
|
2021-05-28 16:45:22 +00:00
|
|
|
def apply_schema(settings, schema, path_list):
|
|
|
|
error = False
|
|
|
|
for key, value in schema.items():
|
|
|
|
if isinstance(value, SettingsValue):
|
|
|
|
try:
|
|
|
|
settings[key] = value(settings.get(key, _UNDEFINED))
|
|
|
|
except Exception as e: # pylint: disable=broad-except
|
|
|
|
# don't stop now: check other values
|
|
|
|
logger.error('%s: %s', '.'.join([*path_list, key]), e)
|
|
|
|
error = True
|
|
|
|
elif isinstance(value, dict):
|
|
|
|
error = error or apply_schema(settings.setdefault(key, {}), schema[key], [*path_list, key])
|
|
|
|
else:
|
|
|
|
settings.setdefault(key, value)
|
|
|
|
if len(path_list) == 0 and error:
|
|
|
|
raise ValueError('Invalid settings.yml')
|
|
|
|
return error
|
|
|
|
|
|
|
|
|
|
|
|
SCHEMA = {
|
|
|
|
'general': {
|
2021-10-02 10:21:02 +00:00
|
|
|
'debug': SettingsValue(bool, False, 'SEARXNG_DEBUG'),
|
|
|
|
'instance_name': SettingsValue(str, 'SearXNG'),
|
2022-06-15 20:06:52 +00:00
|
|
|
'privacypolicy_url': SettingsValue((None, False, str), None),
|
2021-05-28 16:45:22 +00:00
|
|
|
'contact_url': SettingsValue((None, False, str), None),
|
2022-07-02 09:29:21 +00:00
|
|
|
'donation_url': SettingsValue((bool, str), "https://docs.searxng.org/donate.html"),
|
2021-12-26 21:44:46 +00:00
|
|
|
'enable_metrics': SettingsValue(bool, True),
|
2024-09-17 14:43:48 +00:00
|
|
|
'open_metrics': SettingsValue(str, ''),
|
2021-05-28 16:45:22 +00:00
|
|
|
},
|
|
|
|
'brand': {
|
2021-10-21 10:11:42 +00:00
|
|
|
'issue_url': SettingsValue(str, 'https://github.com/searxng/searxng/issues'),
|
|
|
|
'new_issue_url': SettingsValue(str, 'https://github.com/searxng/searxng/issues/new'),
|
2022-01-02 19:54:41 +00:00
|
|
|
'docs_url': SettingsValue(str, 'https://docs.searxng.org'),
|
2022-07-02 14:56:28 +00:00
|
|
|
'public_instances': SettingsValue((False, str), 'https://searx.space'),
|
2021-10-21 10:11:42 +00:00
|
|
|
'wiki_url': SettingsValue(str, 'https://github.com/searxng/searxng/wiki'),
|
2024-01-29 16:10:11 +00:00
|
|
|
'custom': SettingsValue(dict, {'links': {}}),
|
2021-05-28 16:45:22 +00:00
|
|
|
},
|
|
|
|
'search': {
|
2021-12-27 08:26:22 +00:00
|
|
|
'safe_search': SettingsValue((0, 1, 2), 0),
|
2021-05-28 16:45:22 +00:00
|
|
|
'autocomplete': SettingsValue(str, ''),
|
2022-04-22 11:47:54 +00:00
|
|
|
'autocomplete_min': SettingsValue(int, 4),
|
2024-08-11 08:39:46 +00:00
|
|
|
'favicon_resolver': SettingsValue(str, ''),
|
2022-10-10 17:31:22 +00:00
|
|
|
'default_lang': SettingsValue(tuple(SXNG_LOCALE_TAGS + ['']), ''),
|
|
|
|
'languages': SettingSublistValue(SXNG_LOCALE_TAGS, SXNG_LOCALE_TAGS),
|
2021-05-28 16:45:22 +00:00
|
|
|
'ban_time_on_fail': SettingsValue(numbers.Real, 5),
|
|
|
|
'max_ban_time_on_fail': SettingsValue(numbers.Real, 120),
|
2022-11-21 22:55:04 +00:00
|
|
|
'suspended_times': {
|
|
|
|
'SearxEngineAccessDenied': SettingsValue(numbers.Real, 86400),
|
|
|
|
'SearxEngineCaptcha': SettingsValue(numbers.Real, 86400),
|
|
|
|
'SearxEngineTooManyRequests': SettingsValue(numbers.Real, 3600),
|
|
|
|
'cf_SearxEngineCaptcha': SettingsValue(numbers.Real, 1296000),
|
|
|
|
'cf_SearxEngineAccessDenied': SettingsValue(numbers.Real, 86400),
|
|
|
|
'recaptcha_SearxEngineCaptcha': SettingsValue(numbers.Real, 604800),
|
|
|
|
},
|
2021-05-28 16:45:22 +00:00
|
|
|
'formats': SettingsValue(list, OUTPUT_FORMATS),
|
2023-11-13 18:12:50 +00:00
|
|
|
'max_page': SettingsValue(int, 0),
|
2021-05-28 16:45:22 +00:00
|
|
|
},
|
|
|
|
'server': {
|
2021-12-27 08:26:22 +00:00
|
|
|
'port': SettingsValue((int, str), 8888, 'SEARXNG_PORT'),
|
2021-10-02 10:21:02 +00:00
|
|
|
'bind_address': SettingsValue(str, '127.0.0.1', 'SEARXNG_BIND_ADDRESS'),
|
2024-06-14 12:52:31 +00:00
|
|
|
'limiter': SettingsValue(bool, False, 'SEARXNG_LIMITER'),
|
|
|
|
'public_instance': SettingsValue(bool, False, 'SEARXNG_PUBLIC_INSTANCE'),
|
2021-10-02 10:21:02 +00:00
|
|
|
'secret_key': SettingsValue(str, environ_name='SEARXNG_SECRET'),
|
2022-03-19 19:20:13 +00:00
|
|
|
'base_url': SettingsValue((False, str), False, 'SEARXNG_BASE_URL'),
|
2024-06-14 12:52:31 +00:00
|
|
|
'image_proxy': SettingsValue(bool, False, 'SEARXNG_IMAGE_PROXY'),
|
2021-05-28 16:45:22 +00:00
|
|
|
'http_protocol_version': SettingsValue(('1.0', '1.1'), '1.0'),
|
|
|
|
'method': SettingsValue(('POST', 'GET'), 'POST'),
|
|
|
|
'default_http_headers': SettingsValue(dict, {}),
|
|
|
|
},
|
2022-01-03 16:43:20 +00:00
|
|
|
'redis': {
|
2022-11-11 19:14:47 +00:00
|
|
|
'url': SettingsValue((None, False, str), False, 'SEARXNG_REDIS_URL'),
|
2022-01-03 16:43:20 +00:00
|
|
|
},
|
2021-05-28 16:45:22 +00:00
|
|
|
'ui': {
|
|
|
|
'static_path': SettingsDirectoryValue(str, os.path.join(searx_dir, 'static')),
|
2024-06-14 12:52:31 +00:00
|
|
|
'static_use_hash': SettingsValue(bool, False, 'SEARXNG_STATIC_USE_HASH'),
|
2021-05-28 16:45:22 +00:00
|
|
|
'templates_path': SettingsDirectoryValue(str, os.path.join(searx_dir, 'templates')),
|
2021-12-29 13:49:06 +00:00
|
|
|
'default_theme': SettingsValue(str, 'simple'),
|
2021-05-28 16:45:22 +00:00
|
|
|
'default_locale': SettingsValue(str, ''),
|
|
|
|
'theme_args': {
|
2021-11-19 12:49:16 +00:00
|
|
|
'simple_style': SettingsValue(SIMPLE_STYLE, 'auto'),
|
2021-05-28 16:45:22 +00:00
|
|
|
},
|
2022-07-03 15:35:54 +00:00
|
|
|
'center_alignment': SettingsValue(bool, False),
|
2021-05-28 16:45:22 +00:00
|
|
|
'results_on_new_tab': SettingsValue(bool, False),
|
|
|
|
'advanced_search': SettingsValue(bool, False),
|
2021-11-06 11:26:48 +00:00
|
|
|
'query_in_title': SettingsValue(bool, False),
|
2022-01-23 10:37:57 +00:00
|
|
|
'infinite_scroll': SettingsValue(bool, False),
|
2022-09-04 07:36:01 +00:00
|
|
|
'cache_url': SettingsValue(str, 'https://web.archive.org/web/'),
|
2023-09-09 14:49:14 +00:00
|
|
|
'search_on_category_select': SettingsValue(bool, True),
|
2023-10-07 19:05:46 +00:00
|
|
|
'hotkeys': SettingsValue(('default', 'vim'), 'default'),
|
2024-11-27 12:42:08 +00:00
|
|
|
'url_formatting': SettingsValue(('pretty', 'full', 'host'), 'pretty'),
|
2021-05-28 16:45:22 +00:00
|
|
|
},
|
|
|
|
'preferences': {
|
|
|
|
'lock': SettingsValue(list, []),
|
|
|
|
},
|
|
|
|
'outgoing': {
|
|
|
|
'useragent_suffix': SettingsValue(str, ''),
|
|
|
|
'request_timeout': SettingsValue(numbers.Real, 3.0),
|
|
|
|
'enable_http2': SettingsValue(bool, True),
|
2022-07-19 21:40:11 +00:00
|
|
|
'verify': SettingsValue((bool, str), True),
|
2021-05-28 16:45:22 +00:00
|
|
|
'max_request_timeout': SettingsValue((None, numbers.Real), None),
|
|
|
|
'pool_connections': SettingsValue(int, 100),
|
|
|
|
'pool_maxsize': SettingsValue(int, 10),
|
|
|
|
'keepalive_expiry': SettingsValue(numbers.Real, 5.0),
|
|
|
|
# default maximum redirect
|
|
|
|
# from https://github.com/psf/requests/blob/8c211a96cdbe9fe320d63d9e1ae15c5c07e179f8/requests/models.py#L55
|
|
|
|
'max_redirects': SettingsValue(int, 30),
|
|
|
|
'retries': SettingsValue(int, 0),
|
|
|
|
'proxies': SettingsValue((None, str, dict), None),
|
|
|
|
'source_ips': SettingsValue((None, str, list), None),
|
|
|
|
# Tor configuration
|
|
|
|
'using_tor_proxy': SettingsValue(bool, False),
|
|
|
|
'extra_proxy_timeout': SettingsValue(int, 0),
|
2021-12-27 08:26:22 +00:00
|
|
|
'networks': {},
|
2021-05-28 16:45:22 +00:00
|
|
|
},
|
2022-08-27 10:01:04 +00:00
|
|
|
'result_proxy': {
|
|
|
|
'url': SettingsValue((None, str), None),
|
|
|
|
'key': SettingsBytesValue((None, bytes), None),
|
|
|
|
'proxify_results': SettingsValue(bool, False),
|
|
|
|
},
|
2021-09-13 17:37:51 +00:00
|
|
|
'plugins': SettingsValue(list, []),
|
|
|
|
'enabled_plugins': SettingsValue((None, list), None),
|
2021-05-28 16:45:22 +00:00
|
|
|
'checker': {
|
2022-07-15 16:38:32 +00:00
|
|
|
'off_when_debug': SettingsValue(bool, True, None),
|
|
|
|
'scheduling': SettingsValue((None, dict), None, None),
|
2021-05-28 16:45:22 +00:00
|
|
|
},
|
2022-01-04 17:00:45 +00:00
|
|
|
'categories_as_tabs': SettingsValue(dict, CATEGORIES_AS_TABS),
|
2021-05-28 16:45:22 +00:00
|
|
|
'engines': SettingsValue(list, []),
|
2021-12-27 08:26:22 +00:00
|
|
|
'doi_resolvers': {},
|
2021-05-28 16:45:22 +00:00
|
|
|
}
|
|
|
|
|
2021-12-27 08:26:22 +00:00
|
|
|
|
2021-05-28 16:45:22 +00:00
|
|
|
def settings_set_defaults(settings):
|
|
|
|
apply_schema(settings, SCHEMA, [])
|
|
|
|
return settings
|