forked from zaclys/searxng
5720844fcd
We have built up detailed documentation of the *settings* and the *engines* over the past few years. However, this documentation was still spread over various chapters and was difficult to navigate in its entirety. This patch rearranges the Settings & Engines documentation for better readability. To review new ordered docs:: make docs.clean docs.live Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
87 lines
2.1 KiB
Python
87 lines
2.1 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
# lint: pylint
|
|
"""MySQL is said to be the most popular open source database. Before enabling
|
|
MySQL engine, you must install the package ``mysql-connector-python``.
|
|
|
|
The authentication plugin is configurable by setting ``auth_plugin`` in the
|
|
attributes. By default it is set to ``caching_sha2_password``.
|
|
|
|
Example
|
|
=======
|
|
|
|
This is an example configuration for querying a MySQL server:
|
|
|
|
.. code:: yaml
|
|
|
|
- name: my_database
|
|
engine: mysql_server
|
|
database: my_database
|
|
username: searxng
|
|
password: password
|
|
limit: 5
|
|
query_str: 'SELECT * from my_table WHERE my_column=%(query)s'
|
|
|
|
Implementations
|
|
===============
|
|
|
|
"""
|
|
|
|
try:
|
|
import mysql.connector # type: ignore
|
|
except ImportError:
|
|
# import error is ignored because the admin has to install mysql manually to use
|
|
# the engine
|
|
pass
|
|
|
|
engine_type = 'offline'
|
|
auth_plugin = 'caching_sha2_password'
|
|
host = "127.0.0.1"
|
|
port = 3306
|
|
database = ""
|
|
username = ""
|
|
password = ""
|
|
query_str = ""
|
|
limit = 10
|
|
paging = True
|
|
result_template = 'key-value.html'
|
|
_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 = mysql.connector.connect(
|
|
database=database,
|
|
user=username,
|
|
password=password,
|
|
host=host,
|
|
port=port,
|
|
auth_plugin=auth_plugin,
|
|
)
|
|
|
|
|
|
def search(query, params):
|
|
query_params = {'query': query}
|
|
query_to_run = query_str + ' LIMIT {0} OFFSET {1}'.format(limit, (params['pageno'] - 1) * limit)
|
|
|
|
with _connection.cursor() as cur:
|
|
cur.execute(query_to_run, query_params)
|
|
|
|
return _fetch_results(cur)
|
|
|
|
|
|
def _fetch_results(cur):
|
|
results = []
|
|
for res in cur:
|
|
result = dict(zip(cur.column_names, map(str, res)))
|
|
result['template'] = result_template
|
|
results.append(result)
|
|
|
|
return results
|