mirror of
https://github.com/searxng/searxng.git
synced 2025-10-30 18:22:31 -04:00
57b9673efb
- pyright configuration [1]_ - stub files: types-lxml [2]_ - addition of various type hints - enable use of new type system features on older Python versions [3]_ - ``.tool-versions`` - set python to lowest version we support (3.10.18) [4]_: Older versions typically lack some typing features found in newer Python versions. Therefore, for local type checking (before commit), it is necessary to use the older Python interpreter. .. [1] https://docs.basedpyright.com/v1.20.0/configuration/config-files/ .. [2] https://pypi.org/project/types-lxml/ .. [3] https://typing-extensions.readthedocs.io/en/latest/# .. [4] https://mise.jdx.dev/configuration.html#tool-versions Signed-off-by: Markus Heiser <markus.heiser@darmarit.de> Format: reST
88 lines
2.2 KiB
Python
88 lines
2.2 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""MariaDB is a community driven fork of MySQL. Before enabling MariaDB engine,
|
|
you must the install the pip package ``mariadb`` along with the necessary
|
|
prerequities.
|
|
|
|
`See the following documentation for more details
|
|
<https://mariadb.com/docs/server/connect/programming-languages/c/install/>`_
|
|
|
|
Example
|
|
=======
|
|
|
|
This is an example configuration for querying a MariaDB server:
|
|
|
|
.. code:: yaml
|
|
|
|
- name: my_database
|
|
engine: mariadb_server
|
|
database: my_database
|
|
username: searxng
|
|
password: password
|
|
limit: 5
|
|
query_str: 'SELECT * from my_table WHERE my_column=%(query)s'
|
|
|
|
Implementations
|
|
===============
|
|
|
|
"""
|
|
|
|
try:
|
|
import mariadb # pyright: ignore [reportMissingImports]
|
|
except ImportError:
|
|
# import error is ignored because the admin has to install mysql manually to use
|
|
# the engine
|
|
pass
|
|
|
|
from searx.result_types import EngineResults
|
|
|
|
engine_type = 'offline'
|
|
|
|
host = "127.0.0.1"
|
|
"""Hostname of the DB connector"""
|
|
|
|
port = 3306
|
|
"""Port of the DB connector"""
|
|
|
|
database = ""
|
|
"""Name of the database."""
|
|
|
|
username = ""
|
|
"""Username for the DB connection."""
|
|
|
|
password = ""
|
|
"""Password for the DB connection."""
|
|
|
|
query_str = ""
|
|
"""SQL query that returns the result items."""
|
|
|
|
limit = 10
|
|
paging = True
|
|
_connection = None
|
|
|
|
|
|
def init(engine_settings):
|
|
global _connection # pylint: disable=global-statement
|
|
|
|
if 'query_str' not in engine_settings:
|
|
raise ValueError('query_str cannot be empty')
|
|
|
|
if not engine_settings['query_str'].lower().startswith('select '):
|
|
raise ValueError('only SELECT query is supported')
|
|
|
|
_connection = mariadb.connect(database=database, user=username, password=password, host=host, port=port)
|
|
|
|
|
|
def search(query, params) -> EngineResults:
|
|
query_params = {'query': query}
|
|
query_to_run = query_str + ' LIMIT {0} OFFSET {1}'.format(limit, (params['pageno'] - 1) * limit)
|
|
logger.debug("SQL Query: %s", query_to_run)
|
|
res = EngineResults()
|
|
|
|
with _connection.cursor() as cur:
|
|
cur.execute(query_to_run, query_params)
|
|
col_names = [i[0] for i in cur.description]
|
|
for row in cur:
|
|
kvmap = dict(zip(col_names, map(str, row)))
|
|
res.add(res.types.KeyValue(kvmap=kvmap))
|
|
return res
|