added opt params

deep_translator/deepl.py

@@ -12,7 +12,7 @@ class DeepL(object):
     """
     _languages = DEEPL_LANGUAGE_TO_CODE
 
-    def __init__(self, api_key=None, source="en", target="en", use_free_api=True):
+    def __init__(self, api_key=None, source="en", target="en", use_free_api=True, **kwargs):
         """
         @param api_key: your DeepL api key.
         Get one here: https://www.deepl.com/docs-api/accessing-the-api/
@@ -30,7 +30,7 @@ class DeepL(object):
         else:
             self.__base_url = BASE_URLS.get("DEEPL").format(version=self.version)
 
-    def translate(self, text):
+    def translate(self, text, **kwargs):
         """
         @param text: text to translate
         @return: translated text
@@ -60,18 +60,18 @@ class DeepL(object):
         # Process and return the response.
         return res['translations'][0]['text']
 
-    def translate_batch(self, batch):
+    def translate_batch(self, batch, **kwargs):
         """
         @param batch: list of texts to translate
         @return: list of translations
         """
-        return [self.translate(text) for text in batch]
+        return [self.translate(text, **kwargs) for text in batch]
 
-    def _is_language_supported(self, lang):
+    def _is_language_supported(self, lang, **kwargs):
         # The language is supported when is in the dicionary.
         return lang == 'auto' or lang in self._languages.keys() or lang in self._languages.values()
 
-    def _map_language_to_code(self, lang):
+    def _map_language_to_code(self, lang, **kwargs):
         if lang in self._languages.keys():
             return self._languages[lang]
         elif lang in self._languages.values():

deep_translator/detection.py

@@ -6,7 +6,7 @@ from deep_translator.configs import config
 from requests.exceptions import HTTPError
 
 
-def get_request_body(text, api_key, *args):
+def get_request_body(text, api_key, *args, **kwargs):
     """
     send a request and return the response body parsed as dictionary
 
@@ -58,7 +58,7 @@ def single_detection(text, api_key=None, detailed=False, *args, **kwargs):
         return lang
 
 
-def batch_detection(text_list, api_key, detailed=False, *args):
+def batch_detection(text_list, api_key, detailed=False, *args, **kwargs):
     """
     function responsible for detecting the language from a text
 

deep_translator/google_trans.py

@@ -43,7 +43,7 @@ class GoogleTranslator(BaseTranslator):
         self._alt_element_query = {"class": "result-container"}
 
     @staticmethod
-    def get_supported_languages(as_dict=False):
+    def get_supported_languages(as_dict=False, **kwargs):
         """
         return the supported languages by the google translator
         @param as_dict: if True, the languages will be returned as a dictionary mapping languages to their abbreviations
@@ -160,7 +160,7 @@ class GoogleTranslator(BaseTranslator):
         except Exception as e:
             raise e
 
-    def translate_batch(self, batch=None):
+    def translate_batch(self, batch=None, **kwargs):
         """
         translate a list of texts
         @param batch: list of texts you want to translate
@@ -174,7 +174,7 @@ class GoogleTranslator(BaseTranslator):
         arr = []
         for i, text in enumerate(batch):
 
-            translated = self.translate(text)
+            translated = self.translate(text, **kwargs)
             arr.append(translated)
             print("sentence number ", i+1, " has been translated successfully")
             sleep(2)

deep_translator/linguee.py

@@ -22,7 +22,7 @@ class LingueeTranslator(BaseTranslator):
     _languages = LINGUEE_LANGUAGES_TO_CODES
     supported_languages = list(_languages.keys())
 
-    def __init__(self, source, target="en", proxies=None):
+    def __init__(self, source, target="en", proxies=None, **kwargs):
         """
         @param source: source language to translate from
         @param target: target language to translate to
@@ -42,7 +42,7 @@ class LingueeTranslator(BaseTranslator):
                         )
 
     @staticmethod
-    def get_supported_languages(as_dict=False):
+    def get_supported_languages(as_dict=False, **kwargs):
         """
         return the supported languages by the linguee translator
         @param as_dict: if True, the languages will be returned as a dictionary mapping languages to their abbreviations
@@ -126,6 +126,6 @@ class LingueeTranslator(BaseTranslator):
 
         translated_words = []
         for word in words:
-            translated_words.append(self.translate(word=word))
+            translated_words.append(self.translate(word=word, **kwargs))
         return translated_words
 

deep_translator/microsoft.py

@@ -58,7 +58,7 @@ class MicrosoftTranslator:
         self.__base_url = BASE_URLS.get("MICROSOFT_TRANSLATE")
 
     @staticmethod
-    def get_supported_languages(as_dict=False):
+    def get_supported_languages(as_dict=False, **kwargs):
         """
         return the languages supported by the microsoft translator
         @param as_dict: if True, the languages will be returned as a dictionary mapping languages to their abbreviations
@@ -66,7 +66,7 @@ class MicrosoftTranslator:
         """
         return MicrosoftTranslator.supported_languages if not as_dict else MicrosoftTranslator._languages
 
-    def _map_language_to_code(self, language):
+    def _map_language_to_code(self, language, **kwargs):
         """
         map the language to its corresponding code (abbreviation) if the language was passed by its full name by the user
         @param language: a string (if 1 lang) or a list (if multiple langs)
@@ -82,7 +82,7 @@ class MicrosoftTranslator:
             else:
                 raise LanguageNotSupportedException(lang)
 
-    def is_language_supported(self, language):
+    def is_language_supported(self, language, **kwargs):
         """
         check if the language is supported by the translator
         @param language: a string (if 1 lang) or a list (if multiple langs)
@@ -96,7 +96,7 @@ class MicrosoftTranslator:
                     raise LanguageNotSupportedException(lang)
         return True
 
-    def translate(self, text):
+    def translate(self, text, **kwargs):
         """
         function that uses microsoft translate to translate a text
         @param text: desired text to translate
@@ -124,7 +124,7 @@ class MicrosoftTranslator:
             all_translations = [i['text'] for i in requested.json()[0]['translations']]
             return "\n".join(all_translations)
 
-    def translate_file(self, path):
+    def translate_file(self, path, **kwargs):
         """
         translate from a file
         @param path: path to file
@@ -137,10 +137,10 @@ class MicrosoftTranslator:
         except Exception as e:
             raise e
 
-    def translate_batch(self, batch):
+    def translate_batch(self, batch, **kwargs):
         """
         translate a batch of texts
         @param batch: list of texts to translate
         @return: list of translations
         """
-        return [self.translate(text) for text in batch]
+        return [self.translate(text, **kwargs) for text in batch]

deep_translator/mymemory.py

@@ -41,7 +41,7 @@ class MyMemoryTranslator(BaseTranslator):
                                                  langpair='{}|{}'.format(self._source, self._target))
 
     @staticmethod
-    def get_supported_languages(as_dict=False):
+    def get_supported_languages(as_dict=False, **kwargs):
         """
          return the supported languages by the mymemory translator
          @param as_dict: if True, the languages will be returned as a dictionary mapping languages to their abbreviations
@@ -158,7 +158,7 @@ class MyMemoryTranslator(BaseTranslator):
         except Exception as e:
             raise e
 
-    def translate_batch(self, batch=None):
+    def translate_batch(self, batch=None, **kwargs):
         """
         translate a list of texts
         @param batch: list of texts you want to translate
@@ -169,7 +169,7 @@ class MyMemoryTranslator(BaseTranslator):
 
         arr = []
         for text in batch:
-            translated = self.translate(text)
+            translated = self.translate(text, **kwargs)
             arr.append(translated)
             sleep(2)
 

deep_translator/papago.py

@@ -16,7 +16,7 @@ class PapagoTranslator(object):
     _languages = PAPAGO_LANGUAGE_TO_CODE
     supported_languages = list(_languages.keys())
 
-    def __init__(self, client_id=None, secret_key=None, source="auto", target="en"):
+    def __init__(self, client_id=None, secret_key=None, source="auto", target="en", **kwargs):
         """
         @param source: source language to translate from
         @param target: target language to translate to
@@ -31,7 +31,7 @@ class PapagoTranslator(object):
             self._source, self._target = self._map_language_to_code(source.lower(), target.lower())
 
     @staticmethod
-    def get_supported_languages(as_dict=False):
+    def get_supported_languages(as_dict=False, **kwargs):
         """
         return the supported languages by the google translator
         @param as_dict: if True, the languages will be returned as a dictionary mapping languages to their abbreviations
@@ -136,7 +136,7 @@ class PapagoTranslator(object):
         except Exception as e:
             raise e
 
-    def translate_batch(self, batch=None):
+    def translate_batch(self, batch=None, **kwargs):
         """
         translate a list of texts
         @param batch: list of texts you want to translate
@@ -147,7 +147,7 @@ class PapagoTranslator(object):
         arr = []
         for i, text in enumerate(batch):
 
-            translated = self.translate(text)
+            translated = self.translate(text, **kwargs)
             arr.append(translated)
         return arr
 

deep_translator/pons.py

@@ -21,7 +21,7 @@ class PonsTranslator(BaseTranslator):
     _languages = PONS_LANGUAGES_TO_CODES
     supported_languages = list(_languages.keys())
 
-    def __init__(self, source, target="en", proxies=None):
+    def __init__(self, source, target="en", proxies=None, **kwargs):
         """
         @param source: source language to translate from
         @param target: target language to translate to
@@ -40,7 +40,7 @@ class PonsTranslator(BaseTranslator):
                          )
 
     @staticmethod
-    def get_supported_languages(as_dict=False):
+    def get_supported_languages(as_dict=False, **kwargs):
         """
           return the supported languages by the linguee translator
           @param as_dict: if True, the languages will be returned as a dictionary mapping languages to their abbreviations
@@ -131,6 +131,6 @@ class PonsTranslator(BaseTranslator):
 
         translated_words = []
         for word in words:
-            translated_words.append(self.translate(word=word))
+            translated_words.append(self.translate(word=word, **kwargs))
         return translated_words
 

deep_translator/qcri.py

@@ -10,7 +10,7 @@ class QCRI(object):
     class that wraps functions, which use the QRCI translator under the hood to translate word(s)
     """
 
-    def __init__(self, api_key=None, source="en", target="en"):
+    def __init__(self, api_key=None, source="en", target="en", **kwargs):
         """
         @param api_key: your qrci api key. Get one for free here https://mt.qcri.org/api/v1/ref
         """
@@ -57,7 +57,7 @@ class QCRI(object):
     def domains(self):
         return self.get_domains()
 
-    def translate(self, text, domain):
+    def translate(self, text, domain, **kwargs):
         params = {
             "key": self.api_key,
             "langpair": "{}-{}".format(self.source, self.target),
@@ -79,12 +79,12 @@ class QCRI(object):
                     raise TranslationNotFound(text)
                 return translation
 
-    def translate_batch(self, batch, domain):
+    def translate_batch(self, batch, domain, **kwargs):
         """
         translate a batch of texts
         @domain: domain
         @param batch: list of texts to translate
         @return: list of translations
         """
-        return [self.translate(domain, text) for text in batch]
+        return [self.translate(domain, text, **kwargs) for text in batch]
 

deep_translator/yandex.py

@@ -12,7 +12,7 @@ class YandexTranslator(object):
     class that wraps functions, which use the yandex translator under the hood to translate word(s)
     """
 
-    def __init__(self, api_key=None, source="en", target="de"):
+    def __init__(self, api_key=None, source="en", target="de", **kwargs):
         """
         @param api_key: your yandex api key
         """
@@ -80,7 +80,7 @@ class YandexTranslator(object):
             raise ServerException(501)
         return language
 
-    def translate(self, text, proxies=None):
+    def translate(self, text, proxies=None, **kwargs):
         params = {
             "text": text,
             "format": "plain",
@@ -106,7 +106,7 @@ class YandexTranslator(object):
 
         return response['text']
 
-    def translate_file(self, path):
+    def translate_file(self, path, **kwargs):
         """
         translate from a file
         @param path: path to file
@@ -120,10 +120,10 @@ class YandexTranslator(object):
         except Exception as e:
             raise e
 
-    def translate_batch(self, batch):
+    def translate_batch(self, batch, **kwargs):
         """
         translate a batch of texts
         @param batch: list of texts to translate
         @return: list of translations
         """
-        return [self.translate(text) for text in batch]
+        return [self.translate(text, **kwargs) for text in batch]