| 
							
							# SPDX-License-Identifier: AGPL-3.0-or-later
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							from os import environ
 | 
						
						
						
						
							 | 
							
							from os.path import dirname, join, abspath, isfile
 | 
						
						
						
						
							 | 
							
							from collections.abc import Mapping
 | 
						
						
						
						
							 | 
							
							from itertools import filterfalse
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							import yaml
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							from searx.exceptions import SearxSettingsException
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							searx_dir = abspath(dirname(__file__))
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							def check_settings_yml(file_name):
 | 
						
						
						
						
							 | 
							
							    if isfile(file_name):
 | 
						
						
						
						
							 | 
							
							        return file_name
 | 
						
						
						
						
							 | 
							
							    return None
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							def load_yaml(file_name):
 | 
						
						
						
						
							 | 
							
							    try:
 | 
						
						
						
						
							 | 
							
							        with open(file_name, 'r', encoding='utf-8') as settings_yaml:
 | 
						
						
						
						
							 | 
							
							            return yaml.safe_load(settings_yaml)
 | 
						
						
						
						
							 | 
							
							    except IOError as e:
 | 
						
						
						
						
							 | 
							
							        raise SearxSettingsException(e, file_name)
 | 
						
						
						
						
							 | 
							
							    except yaml.YAMLError as e:
 | 
						
						
						
						
							 | 
							
							        raise SearxSettingsException(e, file_name)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							def get_default_settings_path():
 | 
						
						
						
						
							 | 
							
							    return check_settings_yml(join(searx_dir, 'settings.yml'))
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							def get_user_settings_path():
 | 
						
						
						
						
							 | 
							
							    # find location of settings.yml
 | 
						
						
						
						
							 | 
							
							    if 'SEARX_SETTINGS_PATH' in environ:
 | 
						
						
						
						
							 | 
							
							        # if possible set path to settings using the
 | 
						
						
						
						
							 | 
							
							        # enviroment variable SEARX_SETTINGS_PATH
 | 
						
						
						
						
							 | 
							
							        return check_settings_yml(environ['SEARX_SETTINGS_PATH'])
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    # if not, get it from searx code base or last solution from /etc/searx
 | 
						
						
						
						
							 | 
							
							    return check_settings_yml('/etc/searx/settings.yml')
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							def update_dict(default_dict, user_dict):
 | 
						
						
						
						
							 | 
							
							    for k, v in user_dict.items():
 | 
						
						
						
						
							 | 
							
							        if isinstance(v, Mapping):
 | 
						
						
						
						
							 | 
							
							            default_dict[k] = update_dict(default_dict.get(k, {}), v)
 | 
						
						
						
						
							 | 
							
							        else:
 | 
						
						
						
						
							 | 
							
							            default_dict[k] = v
 | 
						
						
						
						
							 | 
							
							    return default_dict
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							def update_settings(default_settings, user_settings):
 | 
						
						
						
						
							 | 
							
							    # merge everything except the engines
 | 
						
						
						
						
							 | 
							
							    for k, v in user_settings.items():
 | 
						
						
						
						
							 | 
							
							        if k not in ('use_default_settings', 'engines'):
 | 
						
						
						
						
							 | 
							
							            if k in default_settings:
 | 
						
						
						
						
							 | 
							
							                update_dict(default_settings[k], v)
 | 
						
						
						
						
							 | 
							
							            else:
 | 
						
						
						
						
							 | 
							
							                default_settings[k] = v
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    # parse the engines
 | 
						
						
						
						
							 | 
							
							    remove_engines = None
 | 
						
						
						
						
							 | 
							
							    keep_only_engines = None
 | 
						
						
						
						
							 | 
							
							    use_default_settings = user_settings.get('use_default_settings')
 | 
						
						
						
						
							 | 
							
							    if isinstance(use_default_settings, dict):
 | 
						
						
						
						
							 | 
							
							        remove_engines = use_default_settings.get('engines', {}).get('remove')
 | 
						
						
						
						
							 | 
							
							        keep_only_engines = use_default_settings.get('engines', {}).get('keep_only')
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    if 'engines' in user_settings or remove_engines is not None or keep_only_engines is not None:
 | 
						
						
						
						
							 | 
							
							        engines = default_settings['engines']
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        # parse "use_default_settings.engines.remove"
 | 
						
						
						
						
							 | 
							
							        if remove_engines is not None:
 | 
						
						
						
						
							 | 
							
							            engines = list(filterfalse(lambda engine: (engine.get('name')) in remove_engines, engines))
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        # parse "use_default_settings.engines.keep_only"
 | 
						
						
						
						
							 | 
							
							        if keep_only_engines is not None:
 | 
						
						
						
						
							 | 
							
							            engines = list(filter(lambda engine: (engine.get('name')) in keep_only_engines, engines))
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        # parse "engines"
 | 
						
						
						
						
							 | 
							
							        user_engines = user_settings.get('engines')
 | 
						
						
						
						
							 | 
							
							        if user_engines:
 | 
						
						
						
						
							 | 
							
							            engines_dict = dict((definition['name'], definition) for definition in engines)
 | 
						
						
						
						
							 | 
							
							            for user_engine in user_engines:
 | 
						
						
						
						
							 | 
							
							                default_engine = engines_dict.get(user_engine['name'])
 | 
						
						
						
						
							 | 
							
							                if default_engine:
 | 
						
						
						
						
							 | 
							
							                    update_dict(default_engine, user_engine)
 | 
						
						
						
						
							 | 
							
							                else:
 | 
						
						
						
						
							 | 
							
							                    engines.append(user_engine)
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							        # store the result
 | 
						
						
						
						
							 | 
							
							        default_settings['engines'] = engines
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    return default_settings
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							def is_use_default_settings(user_settings):
 | 
						
						
						
						
							 | 
							
							    use_default_settings = user_settings.get('use_default_settings')
 | 
						
						
						
						
							 | 
							
							    if use_default_settings is True:
 | 
						
						
						
						
							 | 
							
							        return True
 | 
						
						
						
						
							 | 
							
							    if isinstance(use_default_settings, dict):
 | 
						
						
						
						
							 | 
							
							        return True
 | 
						
						
						
						
							 | 
							
							    if use_default_settings is False or use_default_settings is None:
 | 
						
						
						
						
							 | 
							
							        return False
 | 
						
						
						
						
							 | 
							
							    raise ValueError('Invalid value for use_default_settings')
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							def load_settings(load_user_setttings=True):
 | 
						
						
						
						
							 | 
							
							    default_settings_path = get_default_settings_path()
 | 
						
						
						
						
							 | 
							
							    user_settings_path = get_user_settings_path()
 | 
						
						
						
						
							 | 
							
							    if user_settings_path is None or not load_user_setttings:
 | 
						
						
						
						
							 | 
							
							        # no user settings
 | 
						
						
						
						
							 | 
							
							        return (load_yaml(default_settings_path),
 | 
						
						
						
						
							 | 
							
							                'load the default settings from {}'.format(default_settings_path))
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    # user settings
 | 
						
						
						
						
							 | 
							
							    user_settings = load_yaml(user_settings_path)
 | 
						
						
						
						
							 | 
							
							    if is_use_default_settings(user_settings):
 | 
						
						
						
						
							 | 
							
							        # the user settings are merged with the default configuration
 | 
						
						
						
						
							 | 
							
							        default_settings = load_yaml(default_settings_path)
 | 
						
						
						
						
							 | 
							
							        update_settings(default_settings, user_settings)
 | 
						
						
						
						
							 | 
							
							        return (default_settings,
 | 
						
						
						
						
							 | 
							
							                'merge the default settings ( {} ) and the user setttings ( {} )'
 | 
						
						
						
						
							 | 
							
							                .format(default_settings_path, user_settings_path))
 | 
						
						
						
						
							 | 
							
							
 | 
						
						
						
						
							 | 
							
							    # the user settings, fully replace the default configuration
 | 
						
						
						
						
							 | 
							
							    return (user_settings,
 | 
						
						
						
						
							 | 
							
							            'load the user settings from {}'.format(user_settings_path))
 |