deep-translator 1.5.4

Imports

from deep-translator import (GoogleTranslator,
                             MicrosoftTranslator,
                             PonsTranslator,
                             LingueeTranslator,
                             MyMemoryTranslator,
                             YandexTranslator,
                             PapagoTranslator,
                             DeepL,
                             QCRI,
                             single_detection,
                             batch_detection)

Check Supported Languages

# default return type is a list
langs_list = GoogleTranslator.get_supported_languages()  # output: [arabic, french, english etc...]

# alternatively, you can the dictionary containing languages mapped to their abbreviation
langs_dict = GoogleTranslator.get_supported_languages(as_dict=True)  # output: {arabic: ar, french: fr, english:en etc...}

Language Detection

• Single Text Detection

lang = single_detection('bonjour la vie', api_key='your_api_key')
print(lang) # output: fr

• Batch Detection

lang = batch_detection(['bonjour la vie', 'hello world'], api_key='your_api_key')
print(lang) # output: [fr, en]

Google Translate

text = 'happy coding'

• You can use automatic language detection to detect the source language:

translated = GoogleTranslator(source='auto', target='de').translate(text=text)

• You can pass languages by name or by abbreviation:

translated = GoogleTranslator(source='auto', target='german').translate(text=text)

# Alternatively, you can pass languages by their abbreviation:
translated = GoogleTranslator(source='en', target='de').translate(text=text)

• Translate batch of texts

texts = ["hallo welt", "guten morgen"]

# the translate_sentences function is deprecated, use the translate_batch function instead
translated = GoogleTranslator('de', 'en').translate_batch(texts)

• Translate from a file:

translated = GoogleTranslator(source='auto', target='german').translate_file('path/to/file')

Mymemory Translator

• Simple translation

text = 'Keep it up. You are awesome'

translated = MyMemoryTranslator(source='auto', target='french').translate(text)

• Translate batch of texts

texts = ["hallo welt", "guten morgen"]

# the translate_sentences function is deprecated, use the translate_batch function instead
translated = MyMemoryTranslator('de', 'en').translate_batch(texts)

• Translate from file

path = "your_file.txt"

translated = MyMemoryTranslator(source='en', target='fr').translate_file(path)

DeepL Translator

• Simple translation

text = 'Keep it up. You are awesome'

translated = DeepL(api_key="your_api_key", source="en", target="en", use_free_api=True).translate(text)

• Translate batch of texts

texts = ["hallo welt", "guten morgen"]

# the translate_sentences function is deprecated, use the translate_batch function instead
translated = DeepL("your_api_key").translate_batch(texts)

QCRI Translator

• Check languages

# as a property
print("language pairs: ", QCRI("your_api_key").languages)

• Check domains

# as a property
print("domains: ", QCRI("your_api_key").domains)

• Text translation

text = 'Education is great'

translated = QCRI("your_api_key").translate(source='en', target='ar', domain="news", text=text)
# output -> التعليم هو عظيم

# see docs for batch translation and more.

Linguee Translator

word = 'good'

• Simple Translation

translated_word = LingueeTranslator(source='english', target='french').translate(word)

# pass language by their abbreviation
translated_word = LingueeTranslator(source='en', target='fr').translate(word)

• Return all synonyms or words that matches

# set the argument return_all to True if you want to get all synonyms of the word to translate
translated_word = LingueeTranslator(source='english', target='french').translate(word, return_all=True)

• Translate a batch of words

translated_words = LingueeTranslator(source='english', target='french').translate_words(["good", "awesome"])

PONS Translator

word = 'awesome'

• Simple Translation

translated_word = PonsTranslator(source='english', target='french').translate(word)

# pass language by their abbreviation
translated_word = PonsTranslator(source='en', target='fr').translate(word)

• Return all synonyms or words that matches

# set the argument return_all to True if you want to get all synonyms of the word to translate
translated_word = PonsTranslator(source='english', target='french').translate(word, return_all=True)

• Translate a batch of words

translated_words = LingueeTranslator(source='english', target='french').translate_words(["good", "awesome"])

Yandex Translator

• Language detection

lang = YandexTranslator('your_api_key').detect('Hallo, Welt')
print(f"language detected: {lang}")  # output -> language detected: 'de'

• Text translation

# with auto detection | meaning provide only the target language and let yandex detect the source
translated = YandexTranslator('your_api_key').translate(source="auto", target="en", text='Hallo, Welt')
print(f"translated text: {translated}")  # output -> translated text: Hello world

# provide source and target language explicitly
translated = YandexTranslator('your_api_key').translate(source="de", target="en", text='Hallo, Welt')
print(f"translated text: {translated}")  # output -> translated text: Hello world

• File translation

translated = YandexTranslator('your_api_key').translate_file(source="auto", target="en", path="path_to_your_file")

• Batch translation

translated = YandexTranslator('your_api_key').translate_batch(source="auto", target="de", batch=["hello world", "happy coding"])

Microsoft Translator

• Required and optional attributes

  There are two required attributes, namely “api_key” (string) and “target” (string or list). Attribute “source” is optional. Also, Microsoft API accepts a number of other optional attributes, you can find them here: https://docs.microsoft.com/azure/cognitive-services/translator/reference/v3-0-translate You can simply add them after the required attributes, see the example.

text = 'happy coding'
translated = MicrosoftTranslator(api_key='some-key', target='de').translate(text=text)
translated_two_targets = MicrosoftTranslator(api_key='some-key', target=['de', 'ru']).translate(text=text)
translated_with_optional_attr = MicrosoftTranslator(api_key='some-key', target='de', textType='html']).translate(text=text)

• You can pass languages by name or by abbreviation:

translated = MicrosoftTranslator(api_key='some-key', target='german').translate(text=text)

# Alternatively, you can pass languages by their abbreviation:
translated = MicrosoftTranslator(api_key='some-key', target='de').translate(text=text)

• Translate batch of texts

texts = ["hallo welt", "guten morgen"]
translated = MicrosoftTranslator(api_key='some-key', target='english').translate_batch(texts)

• Translate from a file:

translated = MicrosoftTranslator(api_key='some-key', target='german').translate_file('path/to/file')

Papago Translator

text = 'happy coding'
translated = PapagoTranslator(client_id='your_client_id', secret_key='your_secret_key', source='en', target='ko').translate(text=text)  # output: 행복한 부호화

Proxy usage

deep-translator provide out of the box usage of proxies. Just define your proxies config as a dictionary and pass it to the corresponding translator. Below is an example using the GoogleTranslator but this feature can be used with all supported translators.

from deep-translator import GoogleTranslator

# define your proxy configs:
proxies_example = {
    "https": "your https proxy",  # example: 34.195.196.27:8080
    "http": "your http proxy if available"
}
translated = GoogleTranslator(source='auto', target='de', proxies=proxies_example).translate("this package is awesome")

Usage from Terminal

Deep-translator supports a series of command line arguments for quick and simple access to the translators directly in your console.

For a list of available translators:

$ deep-translator list

To translate a string or line of text:

$ deep-translator google --source "english" --target "german" --text "happy coding"

Alternate short option names, along with using language abbreviations:

$ deep-translator google -src "en" -tgt "de" -txt "happy coding"

Finally, to retrieve a list of available languages for a given translator:

$ deep-translator languages google