UlionTse / Translators

Translators is a library which aims to bring free, multiple, enjoyable translation to individuals and students in Python. It based on the translation interface of Google, Yandex, Microsoft(Bing), Baidu, Alibaba, Tencent, NetEase(Youdao), Sogou, Deepl, etc.

The old version is called translate-api , and it is updated synchronously now.

• Installation
  • From PyPI
  • From Source
• Getting Started
  • Import library
  • Language
  • Professional Field
  • Property
  • Requests
  • Host
  • Detail Result
  • Translate HTML
  • Help
• Issues
  • Linux Runtime Environment
  • Supported Country and Region Service
  • HTTPError 4xx
• More About Translators
  • Features
  • Support Language
  • About Chinese Language
• License

Installation

From PyPI

# Windows, Mac, Linux
pip install translators --upgrade

# Linux javascript runtime environment:
sudo yum -y install nodejs

From Source

git clone https://github.com/UlionTse/translators.git
cd translators
python setup.py install

Getting Started

import translators as ts

wyw_text = '季姬寂，集鸡，鸡即棘鸡。棘鸡饥叽，季姬及箕稷济鸡。'
chs_text = '季姬感到寂寞，罗集了一些鸡来养，鸡是那种出自荆棘丛中的野鸡。野鸡饿了唧唧叫，季姬就拿竹箕中的谷物喂鸡。'

# input languages
print(ts.deepl(wyw_text)) # default: from_language='auto', to_language='en'

## output language_map
print(ts._deepl.language_map)

# professional field
print(ts.alibaba(wyw_text, professional_field='general')) # ("general","message","offer")
print(ts.baidu(wyw_text, professional_field='common')) # ('common','medicine','electronics','mechanics')

# property
rs = [ts.tencent(x) for x in [wyw_text, chs_text]]
print(ts._tencent.query_count)
print(dir(ts._tencent))

# requests
print(ts.youdao(wyw_text, sleep_seconds=5, proxies={}))

# host service
print(ts.google(wyw_text, if_use_cn_host=True))
print(ts.bing(wyw_text, if_use_cn_host=False))

# detail result
print(ts.sogou(wyw_text, is_detail_result=True)
      
# translate html
print(ts.translate_html(html_text, translator=ts.google, to_language='en', translator_params={}))
      
# help
help(ts.deepl)

Issues

Linux Runtime Environment

1. To support javascript runtime environment, you should sudo yum -y install nodejs.
2. PS, ts.baidu() does not work on Linux without desktop.

Supported Country and Region Service

1. If you have requests error, please check whether this service is provided in your country or region.
2. Check the website about eg: help(ts.google).

HTTPError 4xx

1. Please check whether you made high frequency requests.
2. Please check whether this service is provided in your country or region.
3. Detail to solve HTTPError itself.
4. Please issue me, thanks.

More About Translators

Features

Support Language

More supported language, eg:

print(ts._google.language_map)

About Chinese Language

License

MIT Llicense