Translators is a library which aims to bring free, multiple, enjoyable translation to individuals and students in Python.
Project description
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, Microsoft(Bing), Baidu, Alibaba, Tencent, NetEase(Youdao), Sogou, Deepl, etc.
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 library
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, use_domain='general')) # ("general","message","offer")
print(ts.baidu(wyw_text, use_domain='common')) # ('common','medicine','electronics','mechanics')
# property
print(dir(ts._tencent))
print(ts._tencent.query_count)
# 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)
# help
help(ts.deepl)
Issues
Linux Runtime Environment
- To support javascript runtime environment, you should
sudo yum -y install nodejs
. - PS,
ts.baidu()
does not work on Linux.
Supported Country and Region Service
- If you have requests error, please check whether this service is provided in your country or region.
- Check the website about
help(ts.*your_translator*)
.
HTTPError 4xx
- First, check whether you made high frequency requests.
- Second, check whether this service is provided in your country or region.
- Third, detail to solve HTTPError itself.
More About Translators
Features
Translator | Supported Language Count | Advantage |
---|---|---|
104 | support the most languages in the world | |
Bing | 71 | support more languages in the world |
Sogou | 61 | support more languages in the world |
Baidu | 28 | support more languages; support professional field |
Alibaba | 21 | support more languages; support professional field |
Tencent | 17 | support more languages |
Youdao | 13 | support more languages |
Deepl | 11 | high quality to translate but response slowly |
Support Language
Language | Language of Translator | Bing | Baidu | Alibaba | Tencent | Youdao | Sogou | Deepl | |
---|---|---|---|---|---|---|---|---|---|
english | en | Y | Y | Y | Y | Y | Y | Y | Y |
chinese | zh | Y | Y | Y | Y | Y | Y | Y | Y |
arabic | ar | Y | Y | Y(ara) | Y | Y | Y | Y | |
russian | ru | Y | Y | Y | Y | Y | Y | Y | Y |
french | fr | Y | Y | Y(fra) | Y | Y | Y | Y | Y |
german | de | Y | Y | Y | Y | Y | Y | Y | Y |
spanish | es | Y | Y | Y(spa) | Y | Y | Y | Y | Y |
portuguese | pt | Y | Y(pt/pt-pt) | Y | Y | Y | Y | Y | Y |
italian | it | Y | Y | Y | Y | Y | Y | Y | Y |
japanese | ja | Y | Y | Y(jp) | Y | Y | Y | Y | Y |
korean | ko | Y | Y | Y(kor) | Y | Y | Y | Y | |
greek | el | Y | Y | Y | Y | ||||
dutch | nl | Y | Y | Y | Y | Y | Y | ||
hindi | hi | Y | Y | Y | Y | Y | |||
turkish | tr | Y | Y | Y | Y | Y | |||
malay | ms | Y | Y | Y | Y | Y | |||
thai | th | Y | Y | Y | Y | Y | Y | ||
vietnamese | vi | Y | Y | Y(vie) | Y | Y | Y | Y | |
indonesian | id | Y | Y | Y | Y | Y | Y | ||
hebrew | he | Y(iw) | Y | Y | Y | ||||
polish | pl | Y | Y | Y | Y | Y | Y | ||
mongolian | mn | Y | |||||||
czech | cs | Y | Y | Y | Y | ||||
hungarian | hu | Y | Y | Y | Y | ||||
estonian | et | Y | Y | Y(est) | Y | ||||
bulgarian | bg | Y | Y | Y(bul) | Y | ||||
danish | da | Y | Y | Y(dan) | Y | ||||
finnish | fi | Y | Y | Y(fin) | Y | ||||
romanian | ro | Y | Y | Y(rom) | Y | ||||
swedish | sv | Y | Y | Y(swe) | Y | ||||
slovenian | sl | Y | Y | Y(slo) | Y | ||||
persian/farsi | fa | Y | Y | Y | |||||
bosnian | bs | Y | Y(bs-Latn) | Y(bs-Latn) | |||||
serbian | sr | Y | Y(sr-Latn/sr-Cyrl) | Y(sr-Latn/sr-Cyrl) | |||||
fijian | fj | Y | Y | ||||||
filipino | tl | Y | Y(fil) | Y(fil) | |||||
haitiancreole | ht | Y | Y | Y | |||||
catalan | ca | Y | Y | Y | |||||
croatian | hr | Y | Y | Y | |||||
latvian | lv | Y | Y | Y | |||||
lithuanian | lt | Y | Y | Y | |||||
urdu | ur | Y | Y | Y | |||||
ukrainian | uk | Y | Y | Y | |||||
welsh | cy | Y | Y | Y | |||||
tahiti | ty | Y | Y | ||||||
tongan | to | Y | Y | ||||||
swahili | sw | Y | Y | Y | |||||
samoan | sm | Y | Y | Y | |||||
slovak | sk | Y | Y | Y | |||||
afrikaans | af | Y | Y | Y | |||||
norwegian | no | Y | Y | Y | |||||
bengali | bn | Y | Y(bn-BD) | Y | |||||
malagasy | mg | Y | Y | Y | |||||
maltese | mt | Y | Y | Y | |||||
queretaro otomi | otq | Y | Y | ||||||
klingon/tlhingan hol | tlh | Y | Y | ||||||
gujarati | gu | Y | Y | ||||||
tamil | ta | Y | Y | ||||||
telugu | te | Y | Y | ||||||
punjabi | pa | Y | Y | ||||||
... | ... |
More supported language:
print(ts._*your_translator*.language_map)
About Chinese Language
Language | Language of Translator | Bing | Baidu | Alibaba | Tencent | Youdao | Sogou | Deepl | |
---|---|---|---|---|---|---|---|---|---|
chinese(简体) | zh-CHS | Y(zh-CN) | Y(zh-Hans) | Y(zh) | Y(zh) | Y(zh) | Y | Y | Y(zh) |
chinese(繁体) | zh-CHT | Y(zh-TW) | Y(zh-Hant) | Y(cht) | Y(zh-TW) | Y | |||
chinese(文言文) | wyw | Y | |||||||
chinese(粤语) | yue | Y | Y | Y | |||||
chinese(白苗文) | mww | Y | Y |
License
-
Prohibition of commercial use !
This library is designed to help students and individuals with translation services. For commercial use, please purchase API services from translation suppliers.
-
Don't make high frequency requests !
Enterprises provide free services, we should keep grateful, but not cause trouble.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for translators-4.5.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 82fd5edf76c6604438d5d37cbc4e8fb0f40c235b6d8588a3e7dd76f570be0d48 |
|
MD5 | 2ec9b01f8ea28385857a9c411991ab9d |
|
BLAKE2b-256 | 25ddef9d44bdb248b04ecf82f0b7269b92e9a48387be38498ac9d8cfe5b2ee8c |