work on deepL

README.rst

@@ -94,13 +94,13 @@ Why you should use it
 Features
 ========
 
-* Support for google translate
-* Support for `Pons translator <https://de.pons.com//>`_
-* Support for the `Linguee translator <https://www.linguee.com//>`_
-* Support for the `Mymemory translator <https://mymemory.translated.net//>`_
+* Support for `google translate <https://translate.google.com/>`_
+* Support for `Pons translator <https://de.pons.com/>`_
+* Support for the `Linguee translator <https://www.linguee.com/>`_
+* Support for the `Mymemory translator <https://mymemory.translated.net/>`_
 * Support for the `Yandex translator <https://yandex.com/>`_ (version >= 1.2.1)
 * Support for the `QCRI translator <https://mt.qcri.org/api/>`_ (version >= 1.2.4)
-
+* Support for the `DeepL translator <https://www.deepl.com/en/translator/>`_ (version >= 1.2.4)
 * Automatic single language detection
 * Batch language detection
 * Translate directly from a text file

deep_translator/__init__.py

@@ -6,6 +6,7 @@ from .linguee import LingueeTranslator
 from .mymemory import MyMemoryTranslator
 from .yandex import YandexTranslator
 from .qcri import QCRI
+from .deepl import DeepL
 from .detection import single_detection, batch_detection
 
 
@@ -19,5 +20,6 @@ __all__ = [GoogleTranslator,
            MyMemoryTranslator,
            YandexTranslator,
            QCRI,
+           DeepL,
            single_detection,
            batch_detection]

deep_translator/constants.py

@@ -6,7 +6,8 @@ BASE_URLS = {
     "YANDEX": "https://translate.yandex.net/api/{version}/tr.json/{endpoint}",
     "LINGUEE": "https://www.linguee.com/",
     "MYMEMORY": "http://api.mymemory.translated.net/get",
-    "QCRI": "https://mt.qcri.org/api/v1/{endpoint}?"
+    "QCRI": "https://mt.qcri.org/api/v1/{endpoint}?",
+    "DEEPL": "https://api.deepl.com/{}/"
 }
 
 GOOGLE_CODES_TO_LANGUAGES = {

deep_translator/deepl.py

@@ -0,0 +1,55 @@
+
+import requests
+from requests.utils import requote_uri
+from deep_translator.constants import BASE_URLS
+from deep_translator.exceptions import (RequestError,
+                                        ServerException, TranslationNotFound, TooManyRequests)
+
+
+class DeepL(object):
+    """
+    class that wraps functions, which use the DeepL translator under the hood to translate word(s)
+    """
+
+    def __init__(self, api_key=None):
+        """
+        @param api_key: your DeepL api key. Get one here: https://www.deepl.com/docs-api/accessing-the-api/
+        """
+
+        if not api_key:
+            raise ServerException(401)
+        self.version = 'v2'
+        self.api_key = api_key
+        self.__base_url = BASE_URLS.get("DEEPL").format(version=self.version)
+
+    def translate(self, source, target, text):
+        params = {
+            "auth_key": self.api_key,
+            "target_lang": target,
+            "source_lang": source,
+            "text": text
+        }
+        try:
+            response = requests.get(self.__base_url, params=params)
+        except ConnectionError:
+            raise ServerException(503)
+
+        else:
+            if response.status_code != 200:
+                ServerException(response.status_code)
+            else:
+                res = response.json()
+                if not res:
+                    raise TranslationNotFound(text)
+                return res
+
+    def translate_batch(self, source, target, batch):
+        """
+        translate a batch of texts
+        @param source: source language
+        @param target: target language
+        @param batch: list of texts to translate
+        @return: list of translations
+        """
+        return [self.translate(source, target, text) for text in batch]
+

deep_translator/qcri.py

@@ -8,7 +8,7 @@ from deep_translator.exceptions import (RequestError,
 
 class QCRI(object):
     """
-    class that wraps functions, which use the yandex translator under the hood to translate word(s)
+    class that wraps functions, which use the QRCI translator under the hood to translate word(s)
     """
 
     def __init__(self, api_key=None):
@@ -64,7 +64,6 @@ class QCRI(object):
             "domain": domain,
             "text": text
         }
-        print("params: ", params)
         try:
             response = self._get("translate", params=params, return_text=False)
         except ConnectionError: