# SPDX-License-Identifier: AGPL-3.0-or-later """Deepl translation engine""" from searx.result_types import EngineResults about = { "website": 'https://deepl.com', "wikidata_id": 'Q43968444', "official_api_documentation": 'https://www.deepl.com/docs-api', "use_official_api": True, "require_api_key": True, "results": 'JSON', } engine_type = 'online_dictionary' categories = ['general', 'translate'] url = 'https://api-free.deepl.com/v2/translate' api_key = None def request(_query, params): '''pre-request callback params: - ``method`` : POST/GET - ``headers``: {} - ``data``: {} # if method == POST - ``url``: '' - ``category``: 'search category' - ``pageno``: 1 # number of the requested page ''' params['url'] = url params['method'] = 'POST' params['data'] = {'auth_key': api_key, 'text': params['query'], 'target_lang': params['to_lang'][1]} return params def response(resp) -> EngineResults: res = EngineResults() data = resp.json() if not data.get('translations'): return res translations = [res.types.Translations.Item(text=t['text']) for t in data['translations']] res.add(res.types.Translations(translations=translations)) return res