# SPDX-License-Identifier: AGPL-3.0-or-later # lint: pylint """Redis is an open source (BSD licensed), in-memory data structure (key value based) store. Before configuring the ``redis_server`` engine, you must install the dependency redis_. Configuration ============= Select a database to search in and set its index in the option ``db``. You can either look for exact matches or use partial keywords to find what you are looking for by configuring ``exact_match_only``. Example ======= Below is an example configuration: .. code:: yaml # Required dependency: redis - name: myredis shortcut : rds engine: redis_server exact_match_only: false host: '127.0.0.1' port: 6379 enable_http: true password: '' db: 0 Implementations =============== """ import redis # pylint: disable=import-error engine_type = 'offline' # redis connection variables host = '127.0.0.1' port = 6379 password = '' db = 0 # engine specific variables paging = False result_template = 'key-value.html' exact_match_only = True _redis_client = None def init(_engine_settings): global _redis_client # pylint: disable=global-statement _redis_client = redis.StrictRedis( host=host, port=port, db=db, password=password or None, decode_responses=True, ) def search(query, _params): if not exact_match_only: return search_keys(query) ret = _redis_client.hgetall(query) if ret: ret['template'] = result_template return [ret] if ' ' in query: qset, rest = query.split(' ', 1) ret = [] for res in _redis_client.hscan_iter(qset, match='*{}*'.format(rest)): ret.append( { res[0]: res[1], 'template': result_template, } ) return ret return [] def search_keys(query): ret = [] for key in _redis_client.scan_iter(match='*{}*'.format(query)): key_type = _redis_client.type(key) res = None if key_type == 'hash': res = _redis_client.hgetall(key) elif key_type == 'list': res = dict(enumerate(_redis_client.lrange(key, 0, -1))) if res: res['template'] = result_template res['redis_key'] = key ret.append(res) return ret