|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""Deepl translation engine"""
|
|
|
|
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<dict>:
|
|
|
|
- ``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):
|
|
results = []
|
|
|
|
result = resp.json()
|
|
|
|
if not result.get('translations'):
|
|
return results
|
|
|
|
translations = [{'text': translation['text']} for translation in result['translations']]
|
|
|
|
results.append({'answer': translations[0]['text'], 'answer_type': 'translations', 'translations': translations})
|
|
|
|
return results
|