Functions
	init (engine_settings=None)

EngineResults	search (query, request_params)

Variables
str	engine_type = 'offline'

list	categories = ['general']

bool	disabled = True

float	timeout = 2.0

dict	about

	_my_offline_engine = None

Detailed Description

Within this module we implement a *demo offline engine*.  Do not look to
close to the implementation, its just a simple example.  To get in use of this
*demo* engine add the following entry to your engines list in ``settings.yml``:

.. code:: yaml

  - name: my offline engine
    engine: demo_offline
    shortcut: demo
    disabled: false

Function Documentation

◆ init()

searx.engines.demo_offline.init ( engine_settings = None )

Initialization of the (offline) engine.  The origin of this demo engine is a
simple json string which is loaded in this example while the engine is
initialized.

Definition at line 35 of file demo_offline.py.

def init(engine_settings=None):
    """Initialization of the (offline) engine.  The origin of this demo engine is a
    simple json string which is loaded in this example while the engine is
    initialized.
 
    """
    global _my_offline_engine  # pylint: disable=global-statement
 
    _my_offline_engine = (
        '[ {"value": "%s"}'
        ', {"value":"first item"}'
        ', {"value":"second item"}'
        ', {"value":"third item"}'
        ']' % engine_settings.get('name')
    )
 
 

◆ search()

EngineResults searx.engines.demo_offline.search	(		query,
			request_params )

Query (offline) engine and return results.  Assemble the list of results from
your local engine.  In this demo engine we ignore the 'query' term, usual
you would pass the 'query' term to your local engine to filter out the
results.

Definition at line 52 of file demo_offline.py.

def search(query, request_params) -> EngineResults:
    """Query (offline) engine and return results.  Assemble the list of results from
    your local engine.  In this demo engine we ignore the 'query' term, usual
    you would pass the 'query' term to your local engine to filter out the
    results.
 
    """
    res = EngineResults()
 
    result_list = json.loads(_my_offline_engine)
 
    for row in result_list:
        entry = {
            'query': query,
            'language': request_params['searxng_locale'],
            'value': row.get("value"),
            # choose a result template or comment out to use the *default*
            'template': 'key-value.html',
        }
        res.append(entry)
 
    return res

Variable Documentation

◆ _my_offline_engine

searx.engines.demo_offline._my_offline_engine = None

protected

Definition at line 32 of file demo_offline.py.

◆ about

dict searx.engines.demo_offline.about

Initial value:

=  {
    "wikidata_id": None,
    "official_api_documentation": None,
    "use_official_api": False,
    "require_api_key": False,
    "results": 'JSON',
}

Definition at line 23 of file demo_offline.py.

◆ categories

list searx.engines.demo_offline.categories = ['general']

Definition at line 19 of file demo_offline.py.

◆ disabled

bool searx.engines.demo_offline.disabled = True

Definition at line 20 of file demo_offline.py.

◆ engine_type

str searx.engines.demo_offline.engine_type = 'offline'

Definition at line 18 of file demo_offline.py.

◆ timeout

float searx.engines.demo_offline.timeout = 2.0

Definition at line 21 of file demo_offline.py.

Functions

Variables