deep-translator 1.9.0

进口

from deep_translator import (GoogleTranslator,
                             MicrosoftTranslator,
                             PonsTranslator,
                             LingueeTranslator,
                             MyMemoryTranslator,
                             YandexTranslator,
                             PapagoTranslator,
                             DeeplTranslator,
                             QcriTranslator,
                             single_detection,
                             batch_detection)

检查支持的语言

# 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...}

语言检测

• 单文本检测

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

• 批量检测

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

谷歌翻译

text = 'happy coding'

• 您可以使用自动语言检测来检测源语言：

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

• 您可以按名称或缩写传递语言：

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)

• 您还可以重用 Translator 类并更改/更新其属性。

（请注意，这对性能也很重要，因为实例化新对象很昂贵）

# let's say first you need to translate from auto to german
my_translator = GoogleTranslator(source='auto', target='german')
result = my_translator.translate(text=text)
print(f"Translation using source = {my_translator.source} and target = {my_translator.target} -> {result}")

# let's say later you want to reuse the class but your target is french now
# This is the best practice and how you should use deep-translator.
# Please don't over-instantiate translator objects without a good reason, otherwise you will run into performance issues
my_translator.target = 'fr'  # this will override the target 'german' passed previously
result = my_translator.translate(text=text)
print(f"Translation using source = {my_translator.source} and target = {my_translator.target} -> {result}")

# you can also update the source language as well
my_translator.source = 'en'  # this will override the source 'auto' passed previously
result = my_translator.translate(text=text)
print(f"Translation using source = {my_translator.source} and target = {my_translator.target} -> {result}")

• 翻译一批文本

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

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

• 从文件翻译：

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

我的记忆翻译

• 简单翻译

text = 'Keep it up. You are awesome'

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

• 翻译一批文本

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

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

• 从文件翻译

path = "your_file.txt"

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

深度翻译器

• 简单翻译

text = 'Keep it up. You are awesome'

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

• 翻译一批文本

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

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

QcriTranslator

• 检查语言

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

• 检查域

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

• 文本翻译

text = 'Education is great'

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

# see docs for batch translation and more.

语言翻译器

word = 'good'

• 简单翻译

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

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

• 返回所有匹配的同义词或单词

# 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)

• 翻译一批单词

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

PONS翻译器

word = 'awesome'

• 简单翻译

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

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

• 返回所有匹配的同义词或单词

# 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)

• 翻译一批单词

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

Yandex 翻译器

• 语言检测

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

• 文本翻译

# 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

• 文件翻译

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

• 批量翻译

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

微软翻译

• 必需和可选属性

  有两个必需的属性，即“api_key”（字符串）和“target”（字符串或列表）。属性“来源”是可选的。此外，Microsoft API 接受许多其他可选属性，您可以在此处找到它们： https ://docs.microsoft.com/azure/cognitive-services/translator/reference/v3-0-translate 您可以在必需的属性，请参见示例。

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)

• 您可以按名称或缩写传递语言：

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)

• 翻译一批文本

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

• 从文件翻译：

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

帕帕戈翻译

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

自由翻译

text = 'laufen'
translated = LibreTranslator(source='auto', target='en', base_url = 'https://libretranslate.com/', api_key = 'your_api_key').translate(text=text)  # output: run

• 您可以按名称或缩写传递语言：

translated = LibreTranslator(source='german', target='english').translate(text=text)

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

• 翻译一批文本

texts = ["hallo welt", "guten morgen"]
translated = LibreTranslator(source='auto', target='en').translate_batch(texts)

• 从文件翻译：

translated = LibreTranslator(source='auto', target='en').translate_file('path/to/file')

代理使用

deep-translator 提供开箱即用的代理。只需将您的代理配置定义为字典并将其传递给相应的翻译器。以下是使用 GoogleTranslator 的示例，但此功能可用于所有支持的翻译器。

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")

从终端使用

深度翻译器支持一系列命令行参数，以便直接在控制台中快速简单地访问翻译器。

有关可用翻译人员的列表：

$ deep-translator list

要翻译字符串或文本行：

$ deep_translator google --source "english" --target "german" --text "happy coding"

备用短选项名称，以及使用语言缩写：

$ deep_translator google -src "en" -tgt "de" -txt "happy coding"

最后，要检索给定翻译器的可用语言列表：

$ deep-translator languages google