searx.botdetection.config.Config Class Reference

Public Member Functions
"Config"	from_toml (cls, pathlib.Path schema_file, pathlib.Path cfg_file, dict[str, str] deprecated)
	__init__ (self, dict[str, typing.Any] cfg_schema, dict[str, str] deprecated)
typing.Any	__getitem__ (self, str key)
	validate (self, dict[str, typing.Any] cfg)
	update (self, dict[str, typing.Any] upd_cfg)
	default (self, str name)
typing.Any	get (self, str name, typing.Any default=UNSET, bool replace=True)
	set (self, str name, typing.Any val)
	path (self, str name, typing.Any default=UNSET)
	pyobj (self, str name, typing.Any default=UNSET)

Public Attributes
dict[str, typing.Any]	cfg_schema = cfg_schema
dict[str, str]	deprecated = deprecated
dict[str, typing.Any]	cfg = copy.deepcopy(cfg_schema)

Static Public Attributes
object	UNSET = UNSET

Protected Member Functions
dict[str, typing.Any]	_get_parent_dict (self, str name)

Detailed Description

Base class used for configuration

Definition at line 69 of file config.py.

Constructor & Destructor Documentation

__init__()

searx.botdetection.config.Config.__init__	(		self,
		dict[str, typing.Any]	cfg_schema,
		dict[str, str]	deprecated )

Constructor of class Config.

:param cfg_schema: Schema of the configuration
:param deprecated: dictionary that maps deprecated configuration names to a messages

These values are needed for validation, see :py:obj:`validate`.

Definition at line 98 of file config.py.

    def __init__(self, cfg_schema: dict[str, typing.Any], deprecated: dict[str, str]):
        """Constructor of class Config.
 
        :param cfg_schema: Schema of the configuration
        :param deprecated: dictionary that maps deprecated configuration names to a messages
 
        These values are needed for validation, see :py:obj:`validate`.
 
        """
        self.cfg_schema: dict[str, typing.Any] = cfg_schema
        self.deprecated: dict[str, str] = deprecated
        self.cfg: dict[str, typing.Any] = copy.deepcopy(cfg_schema)
 

Member Function Documentation

__getitem__()

typing.Any searx.botdetection.config.Config.__getitem__	(		self,
		str	key )

Definition at line 111 of file config.py.

    def __getitem__(self, key: str) -> typing.Any:
        return self.get(key)
 

References get().

Here is the call graph for this function:

_get_parent_dict()

dict[str, typing.Any] searx.botdetection.config.Config._get_parent_dict ( self, str name )

protected

Definition at line 156 of file config.py.

    def _get_parent_dict(self, name: str) -> dict[str, typing.Any]:
        parent_name = '.'.join(name.split('.')[:-1])
        if parent_name:
            parent: dict[str, typing.Any] = value(parent_name, self.cfg)
        else:
            parent = self.cfg
        if (parent is UNSET) or (not isinstance(parent, dict)):
            raise KeyError(parent_name)
        return parent
 

References cfg, and searx.botdetection.config.value().

Referenced by get(), and set().

Here is the call graph for this function:

Here is the caller graph for this function:

default()

searx.botdetection.config.Config.default	(		self,
		str	name )

Returns default value of field ``name`` in ``self.cfg_schema``.

Definition at line 125 of file config.py.

    def default(self, name: str):
        """Returns default value of field ``name`` in ``self.cfg_schema``."""
        return value(name, self.cfg_schema)
 

References cfg_schema, and searx.botdetection.config.value().

Here is the call graph for this function:

from_toml()

"Config" searx.botdetection.config.Config.from_toml	(		cls,
		pathlib.Path	schema_file,
		pathlib.Path	cfg_file,
		dict[str, str]	deprecated )

Definition at line 75 of file config.py.

    def from_toml(cls, schema_file: pathlib.Path, cfg_file: pathlib.Path, deprecated: dict[str, str]) -> "Config":
 
        # init schema
 
        log.debug("load schema file: %s", schema_file)
        cfg = cls(cfg_schema=toml_load(schema_file), deprecated=deprecated)
        if not cfg_file.exists():
            log.warning("missing config file: %s", cfg_file)
            return cfg
 
        # load configuration
 
        log.debug("load config file: %s", cfg_file)
        upd_cfg = toml_load(cfg_file)
 
        is_valid, issue_list = cfg.validate(upd_cfg)
        for msg in issue_list:
            log.error(str(msg))
        if not is_valid:
            raise TypeError(f"schema of {cfg_file} is invalid!")
        cfg.update(upd_cfg)
        return cfg
 

References searx.botdetection.config.toml_load().

Here is the call graph for this function:

get()

typing.Any searx.botdetection.config.Config.get	(		self,
		str	name,
		typing.Any	default = UNSET,
		bool	replace = True )

Returns the value to which ``name`` points in the configuration.

If there is no such ``name`` in the config and the ``default`` is
:py:obj:`UNSET`, a :py:obj:`KeyError` is raised.

Definition at line 129 of file config.py.

    def get(self, name: str, default: typing.Any = UNSET, replace: bool = True) -> typing.Any:
        """Returns the value to which ``name`` points in the configuration.
 
        If there is no such ``name`` in the config and the ``default`` is
        :py:obj:`UNSET`, a :py:obj:`KeyError` is raised.
        """
 
        parent = self._get_parent_dict(name)
        val = parent.get(name.split('.')[-1], UNSET)
        if val is UNSET:
            if default is UNSET:
                raise KeyError(name)
            val = default
 
        if replace and isinstance(val, str):
            val = val % self
        return val
 

References _get_parent_dict().

Referenced by __getitem__(), searx.result_types._base.LegacyResult.__init__(), searx.result_types._base.LegacyResult.defaults_from(), path(), pyobj(), and searx.answerers._core.AnswerStorage.register().

Here is the call graph for this function:

Here is the caller graph for this function:

path()

searx.botdetection.config.Config.path	(		self,
		str	name,
		typing.Any	default = UNSET )

Get a :py:class:`pathlib.Path` object from a config string.

Definition at line 166 of file config.py.

    def path(self, name: str, default: typing.Any = UNSET):
        """Get a :py:class:`pathlib.Path` object from a config string."""
 
        val = self.get(name, default)
        if val is UNSET:
            if default is UNSET:
                raise KeyError(name)
            return default
        return pathlib.Path(str(val))
 

References get().

Here is the call graph for this function:

pyobj()

searx.botdetection.config.Config.pyobj	(		self,
		str	name,
		typing.Any	default = UNSET )

Get python object referred by full qualiffied name (FQN) in the config
string.

Definition at line 176 of file config.py.

    def pyobj(self, name: str, default: typing.Any = UNSET):
        """Get python object referred by full qualiffied name (FQN) in the config
        string."""
 
        fqn = self.get(name, default)
        if fqn is UNSET:
            if default is UNSET:
                raise KeyError(name)
            return default
        (modulename, name) = str(fqn).rsplit('.', 1)
        m = __import__(modulename, {}, {}, [name], 0)
        return getattr(m, name)
 
 

References get().

Here is the call graph for this function:

set()

searx.botdetection.config.Config.set	(		self,
		str	name,
		typing.Any	val )

Set the value to which ``name`` points in the configuration.

If there is no such ``name`` in the config, a :py:obj:`KeyError` is
raised.

Definition at line 147 of file config.py.

    def set(self, name: str, val: typing.Any):
        """Set the value to which ``name`` points in the configuration.
 
        If there is no such ``name`` in the config, a :py:obj:`KeyError` is
        raised.
        """
        parent = self._get_parent_dict(name)
        parent[name.split('.')[-1]] = val
 

References _get_parent_dict().

Here is the call graph for this function:

update()

searx.botdetection.config.Config.update	(		self,
		dict[str, typing.Any]	upd_cfg )

Update this configuration by ``upd_cfg``.

Definition at line 120 of file config.py.

    def update(self, upd_cfg: dict[str, typing.Any]):
        """Update this configuration by ``upd_cfg``."""
 
        dict_deepupdate(self.cfg, upd_cfg)
 

References cfg, and searx.botdetection.config.dict_deepupdate().

Here is the call graph for this function:

validate()

searx.botdetection.config.Config.validate	(		self,
		dict[str, typing.Any]	cfg )

Validation of dictionary ``cfg`` on :py:obj:`Config.SCHEMA`.
Validation is done by :py:obj:`validate`.

Definition at line 114 of file config.py.

    def validate(self, cfg: dict[str, typing.Any]):
        """Validation of dictionary ``cfg`` on :py:obj:`Config.SCHEMA`.
        Validation is done by :py:obj:`validate`."""
 
        return validate(self.cfg_schema, cfg, self.deprecated)
 

References cfg_schema, deprecated, and validate().

Referenced by validate().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

cfg

searx.botdetection.config.Config.cfg = copy.deepcopy(cfg_schema)

Definition at line 109 of file config.py.

Referenced by _get_parent_dict(), searx.cache.ExpireCacheSQLite.get(), searx.cache.ExpireCacheSQLite.init(), searx.cache.ExpireCacheSQLite.next_maintenance_time(), searx.favicons.cache.FaviconCacheSQLite.next_maintenance_time(), searx.cache.ExpireCacheSQLite.pairs(), searx.cache.ExpireCache.secret_hash(), searx.cache.ExpireCacheSQLite.set(), searx.favicons.cache.FaviconCacheSQLite.set(), and update().

cfg_schema

searx.botdetection.config.Config.cfg_schema = cfg_schema

Definition at line 107 of file config.py.

Referenced by default(), and validate().

deprecated

searx.botdetection.config.Config.deprecated = deprecated

Definition at line 108 of file config.py.

Referenced by validate().

UNSET

object searx.botdetection.config.Config.UNSET = UNSET

static

Definition at line 72 of file config.py.

Referenced by searx.result_types._base.LegacyResult.__getattr__().

---

The documentation for this class was generated from the following file:

• /home/andrew/Documents/code/public/searxng/searx/botdetection/config.py