Functions
valkey.Valkey\|None	client ()
	initialize ()

Variables
valkey	_CLIENT = None
	logger = logging.getLogger(__name__)

Detailed Description

Implementation of the valkey client (valkey-py_).

.. _valkey-py: https://github.com/valkey-io/valkey-py

This implementation uses the :ref:`settings valkey` setup from ``settings.yml``.
A valkey DB connect can be tested by::

  >>> from searx import valkeydb
  >>> valkeydb.initialize()
  True
  >>> db = valkeydb.client()
  >>> db.set("foo", "bar")
  True
  >>> db.get("foo")
  b'bar'
  >>>

Function Documentation

◆ client()

valkey.Valkey | None searx.valkeydb.client ( )

Returns SearXNG's global Valkey DB connector (Valkey client object).

Definition at line 34 of file valkeydb.py.

def client() -> valkey.Valkey | None:
    """Returns SearXNG's global Valkey DB connector (Valkey client object)."""
    return _CLIENT
 
 

◆ initialize()

searx.valkeydb.initialize ( )

Definition at line 39 of file valkeydb.py.

def initialize():
    global _CLIENT  # pylint: disable=global-statement
    if get_setting('redis.url'):
        warnings.warn("setting redis.url is deprecated, use valkey.url", DeprecationWarning)
    valkey_url = get_setting('valkey.url') or get_setting('redis.url')
    if not valkey_url:
        return False
    try:
        # create a client, but no connection is done
        _CLIENT = valkey.Valkey.from_url(valkey_url)
 
        # log the parameters as seen by the valkey lib, without the password
        kwargs = _CLIENT.get_connection_kwargs().copy()
        kwargs.pop('password', None)
        kwargs = ' '.join([f'{k}={v!r}' for k, v in kwargs.items()])
        logger.info("connecting to Valkey %s", kwargs)
 
        # check the connection
        _CLIENT.ping()
 
        # no error: the valkey connection is working
        logger.info("connected to Valkey")
        return True
    except valkey.exceptions.ValkeyError:
        _CLIENT = None
        _pw = pwd.getpwuid(os.getuid())
        logger.exception("[%s (%s)] can't connect valkey DB ...", _pw.pw_name, _pw.pw_uid)
    return False

References searx.get_setting().

Here is the call graph for this function:

Variable Documentation

◆ _CLIENT

valkey searx.valkeydb._CLIENT = None

protected

Definition at line 30 of file valkeydb.py.

◆ logger

searx.valkeydb.logger = logging.getLogger(__name__)

Definition at line 31 of file valkeydb.py.

Functions