Googletrans 项目技术文档

Googletrans 项目技术文档

py-googletrans (unofficial) Googletrans: Free and Unlimited Google translate API for Python. Translates totally free of charge. 项目地址: https://gitcode.com/gh_mirrors/py/py-googletrans

1. 安装指南

1.1 系统要求

• Python 3.6 及以上版本

1.2 安装步骤

你可以通过 pip 来安装 googletrans 库。打开终端或命令行界面，输入以下命令：

pip install googletrans

2. 项目使用说明

2.1 基本用法

googletrans 是一个免费的 Python 库，实现了 Google Translate API。它使用 Google Translate Ajax API 来进行语言检测和翻译。

2.1.1 导入库

首先，你需要导入 googletrans 库中的 Translator 类：

from googletrans import Translator

2.1.2 创建翻译器对象

创建一个 Translator 对象：

translator = Translator()

2.1.3 翻译文本

你可以使用 translate 方法来翻译文本。如果不指定源语言，Google Translate 会自动检测源语言。

translation = translator.translate('안녕하세요.')
print(translation.text)  # 输出: Good evening.

你也可以指定目标语言：

translation = translator.translate('안녕하세요.', dest='ja')
print(translation.text)  # 输出: こんにちは。

2.2 高级用法

2.2.1 批量翻译

你可以使用数组来批量翻译多个字符串：

translations = translator.translate(['The quick brown fox', 'jumps over', 'the lazy dog'], dest='ko')
for translation in translations:
    print(translation.origin, ' -> ', translation.text)

2.2.2 语言检测

你可以使用 detect 方法来检测文本的语言：

detected = translator.detect('이 문장은 한글로 쓰여졌습니다.')
print(detected.lang)  # 输出: ko

2.3 自定义服务URL

你可以使用不同的 Google Translate 域名来进行翻译。如果提供了多个 URL，库会随机选择一个域名。

translator = Translator(service_urls=[
    'translate.google.com',
    'translate.google.co.kr',
])

3. 项目API使用文档

3.1 Translator 类

3.1.1 translate(text, src=None, dest='en')

• text: 要翻译的文本。
• src: 源语言代码（可选，默认自动检测）。
• dest: 目标语言代码（可选，默认 'en'）。

返回一个 Translated 对象，包含翻译后的文本和其他信息。

3.1.2 detect(text)

• text: 要检测语言的文本。

返回一个 Detected 对象，包含检测到的语言代码和置信度。

3.2 Translated 对象

• src: 源语言代码。
• dest: 目标语言代码。
• text: 翻译后的文本。
• pronunciation: 翻译后的文本的发音（如果有）。

3.3 Detected 对象

• lang: 检测到的语言代码。
• confidence: 检测的置信度。

4. 项目安装方式

4.1 使用 pip 安装

最简单的方式是通过 pip 安装 googletrans 库：

pip install googletrans

4.2 手动安装

你也可以从 GitHub 下载项目，并将 googletrans 目录放入你的 Python 路径中。

---

通过以上步骤，你可以轻松地安装和使用 googletrans 库来进行文本翻译和语言检测。希望这篇文档能帮助你更好地理解和使用这个项目。

py-googletrans (unofficial) Googletrans: Free and Unlimited Google translate API for Python. Translates totally free of charge. 项目地址: https://gitcode.com/gh_mirrors/py/py-googletrans