Merge remote-tracking branch 'upstream/master' into master

README.rst

@@ -102,13 +102,17 @@ Usage
 
 .. code-block:: python
 
-    from deep_translator import GoogleTranslator, PonsTranslator, LingueeTranslator, MyMemoryTranslator, detect_language
+    from deep_translator import (GoogleTranslator,
+                                 PonsTranslator,
+                                 LingueeTranslator,
+                                 MyMemoryTranslator,
+                                 detect_language)
 
 
 
 .. note::
 
-    You can check the supported languages of every translator by calling the
+    You can check the supported languages of each translator by calling the
     get_supported_languages function as a static method.
 
 - Example of checking the supported languages for the google translator:

deep_translator/__init__.py

@@ -9,7 +9,7 @@ from .detection import detect_language
 
 __author__ = """Nidhal Baccouri"""
 __email__ = '[email protected]'
-__version__ = '1.1.3'
+__version__ = '1.1.4'
 
 __all__ = [GoogleTranslator,
            PonsTranslator,

deep_translator/pons.py

@@ -57,7 +57,7 @@ class PonsTranslator(BaseTranslator):
                     raise LanguageNotSupportedException(lang)
         return True
 
-    def translate(self, word, **kwargs):
+    def translate(self, word, return_all=False, **kwargs):
 
         if self._validate_payload(word):
             url = "{}{}-{}/{}".format(self.__base_url, self._source, self._target, word)
@@ -77,10 +77,8 @@ class PonsTranslator(BaseTranslator):
                             temp += e.get_text() + ' '
                 eof.append(temp)
 
-            if 'return_all' in kwargs and kwargs.get('return_all'):
-                return [word for word in eof if word and len(word) > 1]
-            else:
-                return [word for word in eof if word and len(word) > 1][0]
+            word_list = [word for word in eof if word and len(word) > 1]
+            return word_list if return_all else word_list[0]
 
     def translate_words(self, words, **kwargs):
         if not words:

examples/linguee.py

@@ -0,0 +1,7 @@
+
+from deep_translator import LingueeTranslator
+
+
+res = LingueeTranslator(source='de', target='en').translate('laufen', return_all=False)
+
+print(res)

examples/pons.py

@@ -0,0 +1,7 @@
+
+from deep_translator import PonsTranslator
+
+
+res = PonsTranslator(source='de', target='en').translate('übersetzen', return_all=False)
+
+print(res)

setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 1.1.3
+current_version = 1.1.4
 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.1.3',
+    version='1.1.4',
     zip_safe=False,
 )