first commit

searx/engines/libretranslate.py

@@ -0,0 +1,59 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+"""LibreTranslate (Free and Open Source Machine Translation API)"""
+
+import random
+import json
+from searx.result_types import EngineResults
+
+about = {
+    "website": 'https://libretranslate.com',
+    "wikidata_id": None,
+    "official_api_documentation": 'https://libretranslate.com/docs/',
+    "use_official_api": True,
+    "require_api_key": False,
+    "results": 'JSON',
+}
+
+engine_type = 'online_dictionary'
+categories = ['general', 'translate']
+
+base_url = "https://libretranslate.com/translate"
+api_key = ""
+
+
+def request(_query, params):
+    request_url = random.choice(base_url) if isinstance(base_url, list) else base_url
+
+    if request_url.startswith("https://libretranslate.com") and not api_key:
+        return None
+    params['url'] = f"{request_url}/translate"
+
+    args = {
+        'q': params['query'],
+        'source': params['from_lang'][1],
+        'target': params['to_lang'][1],
+        'alternatives': 3,
+    }
+    if api_key:
+        args['api_key'] = api_key
+
+    params['data'] = json.dumps(args)
+    params['method'] = 'POST'
+    params['headers'] = {'Content-Type': 'application/json'}
+    params['req_url'] = request_url
+
+    return params
+
+
+def response(resp) -> EngineResults:
+    results = EngineResults()
+
+    json_resp = resp.json()
+    text = json_resp.get('translatedText')
+    if not text:
+        return results
+
+    item = results.types.Translations.Item(text=text, examples=json_resp.get('alternatives', []))
+    results.add(results.types.Translations(translations=[item]))
+
+    return results