added linguee support

HISTORY.rst

@@ -2,6 +2,6 @@
 History
 =======
 
-0.1.2 stable release
+0.1.4 stable release
 ---------------------
 

deep_translator/constants.py

@@ -1,7 +1,10 @@
 
+
 BASE_URLS = {
     "GOOGLE_TRANSLATE": "https://translate.google.com/m",
-    "PONS": "https://en.pons.com/translate/"
+    "PONS": "https://en.pons.com/translate/",
+    "YANDEX": "https://translate.yandex.com/",
+    "LINGUEE": "https://www.linguee.com/"
 }
 
 GOOGLE_CODES_TO_LANGUAGES = {
@@ -115,7 +118,6 @@ GOOGLE_CODES_TO_LANGUAGES = {
 
 GOOGLE_LANGUAGES_TO_CODES = {v: k for k, v in GOOGLE_CODES_TO_LANGUAGES.items()}
 
-
 PONS_CODES_TO_LANGUAGES = {
     'ar': 'arabic',
     'bg': 'bulgarian',
@@ -142,3 +144,35 @@ PONS_CODES_TO_LANGUAGES = {
 }
 
 PONS_LANGUAGES_TO_CODES = {v: k for k, v in PONS_CODES_TO_LANGUAGES.items()}
+
+LINGUEE_LANGUAGES_TO_CODES = {
+    "maltese": "mt",
+    "english": "en",
+    "german": "de",
+    "bulgarian": "bg",
+    "polish": "pl",
+    "portuguese": "pt",
+    "hungarian": "hu",
+    "romanian": "ro",
+    "russian": "ru",
+    #"serbian": "sr",
+    "dutch": "nl",
+    "slovakian": "sk",
+    "greek": "el",
+    "slovenian": "sl",
+    "danish": "da",
+    "italian": "it",
+    "spanish": "es",
+    "finnish": "fi",
+    "chinese": "zh",
+    "french": "fr",
+    #"croatian": "hr",
+    "czech": "cs",
+    "laotian": "lo",
+    "swedish": "sv",
+    "latvian": "lv",
+    "estonian": "et",
+    "japanese": "ja"
+}
+
+LINGUEE_CODE_TO_LANGUAGE = {v: k for k, v in LINGUEE_LANGUAGES_TO_CODES.items()}

deep_translator/google_trans.py

@@ -1,4 +1,3 @@
-from abc import ABC
 
 from deep_translator.constants import BASE_URLS, GOOGLE_LANGUAGES_TO_CODES
 from deep_translator.exceptions import LanguageNotSupportedException, ElementNotFoundInGetRequest, NotValidPayload, NotValidLength
@@ -7,7 +6,7 @@ from bs4 import BeautifulSoup
 import requests
 
 
-class GoogleTranslator(BaseTranslator, ABC):
+class GoogleTranslator(BaseTranslator):
     """
     class that uses google translate to translate texts
     """
@@ -65,8 +64,8 @@ class GoogleTranslator(BaseTranslator, ABC):
             if self.payload_key:
                 self._url_params[self.payload_key] = payload
 
-            res = requests.get(self.__base_url, params=self._url_params)
-            soup = BeautifulSoup(res.text, 'html.parser')
+            response = requests.get(self.__base_url, params=self._url_params)
+            soup = BeautifulSoup(response.text, 'html.parser')
             element = soup.find(self._element_tag, self._element_query)
             if not element:
                 raise ElementNotFoundInGetRequest(element)

deep_translator/linguee.py

@@ -0,0 +1,77 @@
+from deep_translator.constants import BASE_URLS, LINGUEE_LANGUAGES_TO_CODES, LINGUEE_CODE_TO_LANGUAGE
+from deep_translator.exceptions import LanguageNotSupportedException, ElementNotFoundInGetRequest, NotValidPayload, NotValidLength
+from deep_translator.parent import BaseTranslator
+from bs4 import BeautifulSoup
+import requests
+from requests.utils import quote
+
+
+class LingueeTranslator(BaseTranslator):
+    def __init__(self, source, target):
+        """
+        @param source: source language to translate from
+        @param target: target language to translate to
+        """
+        self.__base_url = BASE_URLS.get("LINGUEE")
+
+        if self.is_language_supported(source, target):
+            self._source, self._target = self._map_language_to_code(source.lower(), target.lower())
+
+        super().__init__(base_url=self.__base_url,
+                         source=self._source,
+                         target=self._target,
+                         element_tag='a',
+                         element_query={'class': 'dictLink featured'},
+                         payload_key=None,  # key of payload in the url
+                        )
+
+    def _map_language_to_code(self, *languages, **kwargs):
+        """
+        @param language: type of language
+        @return: mapped value of the language or raise an exception if the language is not supported
+        """
+        for language in languages:
+            if language in LINGUEE_LANGUAGES_TO_CODES.values():
+                yield LINGUEE_CODE_TO_LANGUAGE[language]
+            elif language in LINGUEE_LANGUAGES_TO_CODES.keys():
+                yield language
+            else:
+                raise LanguageNotSupportedException(language)
+
+    def is_language_supported(self, *languages, **kwargs):
+        for lang in languages:
+            if lang not in LINGUEE_LANGUAGES_TO_CODES.keys():
+                if lang not in LINGUEE_LANGUAGES_TO_CODES.values():
+                    raise LanguageNotSupportedException(lang)
+        return True
+
+    def translate(self, word, **kwargs):
+
+        if self._validate_payload(word):
+            # %s-%s/translation/%s.html
+            url = "{}{}-{}/translation/{}.html".format(self.__base_url, self._source, self._target, quote(word))
+            response = requests.get(url)
+            soup = BeautifulSoup(response.text, 'html.parser')
+            elements = soup.find_all(self._element_tag, self._element_query)
+            if not elements:
+                raise ElementNotFoundInGetRequest(elements)
+
+            if 'return_all' in kwargs and kwargs.get('return_all'):
+                return [el.get_text(strip=True) for el in elements]
+            else:
+                return elements[0].get_text(strip=True)
+
+    def translate_words(self, words, **kwargs):
+        if not words:
+            raise NotValidPayload(words)
+
+        translated_words = []
+        for word in words:
+            translated_words.append(self.translate(payload=word))
+        return translated_words
+
+
+if __name__ == '__main__':
+    res = LingueeTranslator(source="en", target="de").translate(word='cute', return_all=False)
+    print(res)
+

deep_translator/pons.py

@@ -36,7 +36,7 @@ class PonsTranslator(BaseTranslator):
         @return: mapped value of the language or raise an exception if the language is not supported
         """
         for language in languages:
-            if language in PONS_LANGUAGES_TO_CODES.values() or language == 'auto':
+            if language in PONS_LANGUAGES_TO_CODES.values():
                 yield PONS_CODES_TO_LANGUAGES[language]
             elif language in PONS_LANGUAGES_TO_CODES.keys():
                 yield language
@@ -94,5 +94,4 @@ if __name__ == '__main__':
     # ])
     # res = PonsTranslator(source="en", target="ar").translate(payload='good')
     res = PonsTranslator(source="en", target="ar").translate_words(words=('good', 'cute', 'angry'))
-
     print(res)