pygtrans 1.0.2

Google Translate, support APIKEY

pygtrans

谷歌翻译, 支持 APIKEY

• github

• pypi

• 文档

基本功能

• 获取语言支持列表
• 自动检测语言, 支持批量
• 文本/HTML 翻译, 支持批量

安装

环境要求: >= python 3.7

pip install pygtrans

快速入门

from pygtrans import Translate

client = Translate()
text = client.translate('Google Translate')
print(text.translatedText)  # 谷歌翻译

基本介绍

pygtrans包中有两个需要关心的模块

1. Translate: 通过谷歌翻译API接口实现, 可直接使用, 但可能不稳定
2. ApiKeyTranslate: 通过Google Cloud Translate APIs实现, 需要提供一个有效的APIKEY, 谷歌提供免费试用

二者的差异

	缺点	优点
Translate	可能不稳定(使用频率), 需要更换User-Agent或者使用IP代理	可直接使用, 无需梯子
ApiKeyTranslate	无论如何都需要梯子, 并且试用结束后, 需要money	无使用限制

关于不稳定的问题

1. 首先这是一个无法避免的问题, 任何类似工具都会存在这样的问题;
2. 在我测试(根本没请求几次)的过程中, 出现 429 Too Many Requests 的情况, 检查后发现是 User-Agent 没有设置上去, 修正后, 再没出现过. 如果大家后续碰到此种情况, 可放到 issues 中讨论, 因为我目前还不知道多高的频率会被限制, 只测试过几次循环 100 次请求, 期间未出现问题.

关于Null模块

表示一个失败的结果, 如果想判断翻译是否成功, 判断返回是否为Null对象即可

from pygtrans import Translate, Null

client = Translate()
text = client.translate('Hello')
if isinstance(text, Null):
    print("翻译失败")
else:
    print("翻译成功")

建议按需判断, 一般直接使用

基本使用

使用Translate

• 获取支持语言: 该功能从代码中删除, 以 语言支持列表 方式提供
• 语言检测: 方法detect不支持批量检测, 如需批量检测请使用 translate_and_detect 方法

from pygtrans import Translate

client = Translate()
d = client.detect('你好')
assert d.language == 'zh-CN'

• 文本翻译: 使用translate方法, 默认就是HTML模式翻译, 详细参数设置请移步至 pygtrans文档

from pygtrans import Translate

client = Translate()
text1 = client.translate('English')
assert text1.translatedText == '英语'

text2 = client.translate('喜欢', target='en')
assert text2.translatedText == 'love'

# 批量翻译
texts = client.translate(['Hello', 'World'])
for text in texts:
    print(text.translatedText)
# 你好
# 世界

• 修改默认语言, 请移步至 pygtrans文档

使用ApiKeyTranslate

请参考 pygtrans文档

本文档可能会有所滞后, pip install pygtrans 亲自尝试下吧~

有问题?

欢迎大家反馈和建议

MIT License

Copyright (c) 2021 foyoux

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.