added support for mymemory

README.rst

@@ -51,20 +51,20 @@ Usage
 
 .. code-block:: python
 
-    from deep_translator import GoogleTranslator, PonsTranslator, LingueeTranslator
+    from deep_translator import MyMemoryTranslator, PonsTranslator, LingueeTranslator
 
     english_text = 'happy coding'
 
-    result_german = GoogleTranslator(source='auto', target='de').translate(payload=english_text)
+    result_german = MyMemoryTranslator(source='auto', target='de').translate(payload=english_text)
 
     # Alternatively, you can pass languages by their name:
-    translated = GoogleTranslator(source='english', target='german').translate(payload=english_text)
+    translated = MyMemoryTranslator(source='english', target='german').translate(payload=english_text)
 
     # or maybe you want to translate a text file ?
-    translated = GoogleTranslator(source='auto', target='german').translate_file('path/to/file')
+    translated = MyMemoryTranslator(source='auto', target='german').translate_file('path/to/file')
 
     # or maybe you have many sentences in different languages and want to automate the translation process
-    translated = GoogleTranslator(source='auto', target='de').translate_sentences(your_list_of_sentences)
+    translated = MyMemoryTranslator(source='auto', target='de').translate_sentences(your_list_of_sentences)
 
 
 or maybe you would like to use the Pons translator: Pons.com

deep_translator/__init__.py

@@ -3,9 +3,14 @@
 from .google_trans import GoogleTranslator
 from .pons import PonsTranslator
 from .linguee import LingueeTranslator
+from .mymemory import MyMemoryTranslator
+
 
 __author__ = """Nidhal Baccouri"""
 __email__ = '[email protected]'
-__version__ = '1.0.0'
+__version__ = '1.0.1'
 
-__all__ = [GoogleTranslator, PonsTranslator, LingueeTranslator]
+__all__ = [GoogleTranslator,
+           PonsTranslator,
+           LingueeTranslator,
+           MyMemoryTranslator]

deep_translator/constants.py

@@ -4,7 +4,8 @@ BASE_URLS = {
     "GOOGLE_TRANSLATE": "https://translate.google.com/m",
     "PONS": "https://en.pons.com/translate/",
     "YANDEX": "https://translate.yandex.com/",
-    "LINGUEE": "https://www.linguee.com/"
+    "LINGUEE": "https://www.linguee.com/",
+    "MYMEMORY": "http://api.mymemory.translated.net/get"
 }
 
 GOOGLE_CODES_TO_LANGUAGES = {

deep_translator/exceptions.py

@@ -17,7 +17,7 @@ class LanguageNotSupportedException(BaseError):
 class NotValidPayload(BaseError):
     def __init__(self,
                  val,
-                 message='payload must be a valid text with maximum 5000 character, otherwise it cannot be translated'):
+                 message='text must be a valid text with maximum 5000 character, otherwise it cannot be translated'):
         super(NotValidPayload, self).__init__(val, message)
 
 
@@ -29,5 +29,5 @@ class ElementNotFoundInGetRequest(BaseError):
 
 
 class NotValidLength(BaseError):
-    def __init__(self, val, message="Length of payload need to be between 0 and 5000"):
+    def __init__(self, val, message="Length of text need to be between 0 and 5000"):
         super(NotValidLength, self).__init__(val, message)

deep_translator/google_trans.py

@@ -27,7 +27,7 @@ class GoogleTranslator(BaseTranslator):
                                                target=self._target,
                                                element_tag='div',
                                                element_query={"class": "t0"},
-                                               payload_key='q',  # key of payload in the url
+                                               payload_key='q',  # key of text in the url
                                                hl=self._target,
                                                sl=self._source)
 
@@ -52,18 +52,18 @@ class GoogleTranslator(BaseTranslator):
                     raise LanguageNotSupportedException(lang)
         return True
 
-    def translate(self, payload, **kwargs):
+    def translate(self, text, **kwargs):
         """
         main function that uses google translate to translate a text
-        @param payload: desired text to translate
+        @param text: desired text to translate
         @return: str: translated text
         """
 
-        if self._validate_payload(payload):
-            payload = payload.strip()
+        if self._validate_payload(text):
+            text = text.strip()
 
             if self.payload_key:
-                self._url_params[self.payload_key] = payload
+                self._url_params[self.payload_key] = text
 
             response = requests.get(self.__base_url, params=self._url_params)
             soup = BeautifulSoup(response.text, 'html.parser')
@@ -78,7 +78,7 @@ class GoogleTranslator(BaseTranslator):
             with open(path) as f:
                 text = f.read()
 
-            return self.translate(payload=text)
+            return self.translate(text=text)
         except Exception as e:
             raise e
 
@@ -97,7 +97,7 @@ class GoogleTranslator(BaseTranslator):
         translated_sentences = []
         try:
             for sentence in sentences:
-                translated = self.translate(payload=sentence)
+                translated = self.translate(text=sentence)
                 translated_sentences.append(translated)
 
             return translated_sentences
@@ -107,5 +107,5 @@ class GoogleTranslator(BaseTranslator):
 
 
 if __name__ == '__main__':
-    res = GoogleTranslator(source="auto", target="de").translate(payload='this is a good day')
+    res = GoogleTranslator(source="auto", target="de").translate(text='this is a good day')
     print(res)

deep_translator/linguee.py

@@ -24,7 +24,7 @@ class LingueeTranslator(BaseTranslator):
                          target=self._target,
                          element_tag='a',
                          element_query={'class': 'dictLink featured'},
-                         payload_key=None,  # key of payload in the url
+                         payload_key=None,  # key of text in the url
                         )
 
     def _map_language_to_code(self, *languages, **kwargs):

deep_translator/mymemory.py

@@ -0,0 +1,86 @@
+
+from deep_translator.constants import BASE_URLS, GOOGLE_LANGUAGES_TO_CODES
+from deep_translator.exceptions import NotValidPayload
+from deep_translator.parent import BaseTranslator
+import requests
+
+
+class MyMemoryTranslator(BaseTranslator):
+    """
+    class that uses google translate to translate texts
+    """
+    supported_languages = list(GOOGLE_LANGUAGES_TO_CODES.keys())
+
+    def __init__(self, source, target, **kwargs):
+        """
+        @param source: source language to translate from
+        @param target: target language to translate to
+        """
+        self.__base_url = BASE_URLS.get("MYMEMORY")
+        self._source = source
+        self._target = target
+
+        self.email = kwargs.get('email', None)
+        super(MyMemoryTranslator, self).__init__(base_url=self.__base_url,
+                                                 source=self._source,
+                                                 target=self._target,
+                                                 payload_key='q',
+                                                 langpair='{}|{}'.format(self._source, self._target))
+
+    def translate(self, text, **kwargs):
+        """
+        main function that uses google translate to translate a text
+        @param text: desired text to translate
+        @return: str: translated text
+        """
+
+        if self._validate_payload(text):
+            text = text.strip()
+
+            if self.payload_key:
+                self._url_params[self.payload_key] = text
+            if self.email:
+                self._url_params['de'] = self.email
+
+            response = requests.get(self.__base_url, params=self._url_params, headers=self.headers)
+            data = response.json()
+            if not data:
+                raise Exception("Translation was not found in response!")
+
+            translation = data.get('responseData').get('translatedText')
+            if translation:
+                return translation
+
+            elif not translation:
+                all_matches = data.get('matches')
+                matches = (match['translation'] for match in all_matches)
+                next_match = next(matches)
+                return next_match if not kwargs.get('return_all') else list(all_matches)
+
+    def translate_sentences(self, sentences=None, **kwargs):
+        """
+        translate many sentences together. This makes sense if you have sentences with different languages
+        and you want to translate all to unified language. This is handy because it detects
+        automatically the language of each sentence and then translate it.
+
+        @param sentences: list of sentences to translate
+        @return: list of all translated sentences
+        """
+        if not sentences:
+            raise NotValidPayload(sentences)
+
+        translated_sentences = []
+        try:
+            for sentence in sentences:
+                translated = self.translate(text=sentence, **kwargs)
+                translated_sentences.append(translated)
+
+            return translated_sentences
+
+        except Exception as e:
+            raise e
+
+
+if __name__ == '__main__':
+    res = MyMemoryTranslator(source="en", target="zh").translate(text='cute')
+    print(res)

deep_translator/parent.py

@@ -27,12 +27,14 @@ class BaseTranslator(ABC):
         self._element_tag = element_tag
         self._element_query = element_query
         self.payload_key = payload_key
+        self.headers = {'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebit/535.19'
+                                      '(KHTML, like Gecko) Chrome/18.0.1025.168 Safari/535.19'}
         super(BaseTranslator, self).__init__()
 
     @staticmethod
     def _validate_payload(payload, min_chars=1, max_chars=5000):
         """
-        validate the payload text to translate
+        validate the text text to translate
         @param payload: text to translate
         @return: bool
         """
@@ -48,6 +50,6 @@ class BaseTranslator(ABC):
         return True if min_chars < len(payload) < max_chars else False
 
     @abstractmethod
-    def translate(self, payload, **kwargs):
+    def translate(self, text, **kwargs):
         return NotImplemented('You need to implement the translate method!')
 

deep_translator/pons.py

@@ -88,12 +88,12 @@ class PonsTranslator(BaseTranslator):
 
 if __name__ == '__main__':
 
-    # res = GoogleTranslator(source='auto', target='french').translate_text(path='../examples/test.txt')
-    # res = GoogleTranslator(source='auto', target='french').translate_sentences([
+    # res = MyMemoryTranslator(source='auto', target='french').translate_text(path='../examples/test.txt')
+    # res = MyMemoryTranslator(source='auto', target='french').translate_sentences([
     #     "this is good",
     #     "das Wetter ist schön",
     #     "un verme verde in un bicchiere verde"
     # ])
-    # res = PonsTranslator(source="en", target="ar").translate(payload='good')
+    # res = PonsTranslator(source="en", target="ar").translate(text='good')
     res = PonsTranslator(source="en", target="ar").translate_words(words=('good', 'cute', 'angry'))
     print(res)

deep_translator/tests/test_deep_translator.py

@@ -19,7 +19,7 @@ def test_content(google_translator):
     """Sample pytest test function with the pytest fixture as an argument."""
     # from bs4 import BeautifulSoup
     # assert 'GitHub' in BeautifulSoup(response.content).title.string
-    assert google_translator.translate(payload='좋은') == "good"
+    assert google_translator.translate(text='좋은') == "good"
 
 
 def test_inputs():
@@ -32,8 +32,8 @@ def test_inputs():
 
 def test_payload(google_translator):
     with pytest.raises(exceptions.NotValidPayload):
-        google_translator.translate(payload="")
+        google_translator.translate(text="")
     with pytest.raises(exceptions.NotValidPayload):
-        google_translator.translate(payload=123)
+        google_translator.translate(text=123)
 
 

docs/usage.rst

@@ -4,20 +4,20 @@ Usage
 
 .. code-block:: python
 
-    from deep_translator import GoogleTranslator, PonsTranslator, LingueeTranslator
+    from deep_translator import MyMemoryTranslator, PonsTranslator, LingueeTranslator
 
     english_text = 'happy coding'
 
-    result_german = GoogleTranslator(source='auto', target='de').translate(payload=english_text)
+    result_german = MyMemoryTranslator(source='auto', target='de').translate(payload=english_text)
 
     # Alternatively, you can pass languages by their name:
-    translated = GoogleTranslator(source='english', target='german').translate(payload=english_text)
+    translated = MyMemoryTranslator(source='english', target='german').translate(payload=english_text)
 
     # or maybe you want to translate a text file ?
-    translated = GoogleTranslator(source='auto', target='german').translate_file('path/to/file')
+    translated = MyMemoryTranslator(source='auto', target='german').translate_file('path/to/file')
 
     # or maybe you have many sentences in different languages and want to automate the translation process
-    translated = GoogleTranslator(source='auto', target='de').translate_sentences(your_list_of_sentences)
+    translated = MyMemoryTranslator(source='auto', target='de').translate_sentences(your_list_of_sentences)
 
 
 or maybe you would like to use the Pons translator: Pons.com

examples/trans.py

@@ -6,8 +6,8 @@ from deep_translator import GoogleTranslator, PonsTranslator, LingueeTranslator
 english_text = 'happy coding'
 chinese_text = '這很好'
 
-result_german = GoogleTranslator(source='english', target='german').translate(payload=english_text)
-result_french = GoogleTranslator(source='auto', target='french').translate(payload=chinese_text)
+result_german = GoogleTranslator(source='english', target='german').translate(text=english_text)
+result_french = GoogleTranslator(source='auto', target='french').translate(text=chinese_text)
 
 print(f"original english text: {english_text} | translated text: {result_german}")  # result: fröhliche Codierung
 print(f"original chinese text: {chinese_text} | translated text: {result_french}")  # result: C' est bon

setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 1.0.0
+current_version = 1.0.1
 commit = True
 tag = True
 

setup.py

@@ -51,6 +51,6 @@ setup(
     test_suite='tests',
     tests_require=test_requirements,
     url='https://github.com/nidhaloff/deep_translator',
-    version='1.0.0',
+    version='1.0.1',
     zip_safe=False,
 )