translators

Translators is a library which aims to bring free, multiple, enjoyable translation to individuals and students in Python.

These details have not been verified by PyPI

Project links

GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

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, Yandex, Microsoft(Bing), Baidu, Alibaba, Tencent, NetEase(Youdao), Sogou, Kingsoft(Iciba), Iflytek, Niutrans, Lingvanex, Naver(Papago), Deepl, Reverso, Itranslate, Caiyun, TranslateCom, Mglip, Utibet, Argos, etc.

Installation
Getting Started
More About Translators
Debug Tips
License

Installation

From PyPI

pip install --upgrade translators

From Conda

conda install -c conda-forge translators

From Source

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

Getting Started

import translators as ts
import translators.server as tss

wyw_text = '季姬寂，集鸡，鸡即棘鸡。棘鸡饥叽，季姬及箕稷济鸡。'
chs_text = '季姬感到寂寞，罗集了一些鸡来养，鸡是出自荆棘丛中的野鸡。野鸡饿了唧唧叫，季姬就拿竹箕中的谷物喂鸡。'
chs_html = '''
<!DOCTYPE html>
<html>
<head>
    <title>《季姬击鸡记》</title>
</head>
<body>
<p>还有另一篇文章《施氏食狮史》。</p>
</body>
</html>
'''

### usage
print(ts.translators_pool)
print(ts.translate_text(chs_text))
print(ts.translate_html(chs_html, translator='iciba'))

### common parameters and functions
## query text
print(ts.translate_text(chs_text, if_ignore_empty_query=False, if_ignore_limit_of_length=False, limit_of_length=5000))

## language
# input language
from_language, to_language = 'zh', 'en'
print(tss.google(wyw_text, from_language, to_language))
# check input language with language_map
assert from_language in tss._google.language_map  # request once first, then

## detail result
print(tss.sogou(wyw_text, is_detail_result=True))

## professional field
print(tss.alibaba(wyw_text, professional_field='general'))  # ("general","message","offer")
print(tss.baidu(wyw_text, professional_field='common'))  # ('common','medicine','electronics','mechanics')
print(tss.caiyun(wyw_text, professional_field=None))  # (None,"medicine","law","machinery")

## host config
# cn
print(tss.google(wyw_text, if_use_cn_host=False))
print(tss.bing(wyw_text, if_use_cn_host=True))
# reset host
print(tss.google(wyw_text, reset_host_url=None))
print(tss.yandex(wyw_text, reset_host_url=None))
# host pool
print(tss._argos.host_pool)
print(tss.argos(wyw_text, reset_host_url=None))

## request config
print(tss.lingvanex(wyw_text, sleep_seconds=5, timeout=None, proxies=None))

## session update
print(tss.itranslate(wyw_text, update_session_after_seconds=1.5e3))

## time stat
print(tss.reverso(wyw_text, if_show_time_stat=True, show_time_stat_precision=4))

### property
print(dir(tss._deepl))
help(tss.papago)

More About Translators

Features

Translator	Number of Supported Languages	Advantage	Service	Status
Niutrans	302	support the most languages in the world	Northeastern University / Niutrans, China	/
Alibaba	221	support main languages, support professional field	Alibaba, China	stable
Iciba	187	support the most languages in the world	Kingsoft / Xiaomi, China	stable
Iflytek	140	support the most languages in the world	Iflytek, China	/
Google	134	support more languages in the world	Google, America	stable(offline in China on Oct 2022)
Lingvanex	117	support translation of different regions but the same language, such as en_US, en_GB, en_AU	Lingvanex, Cyprus	stable
Bing	110	support more languages in the world	Microsoft, America	stable
yandex	100	support more languages in the world, support word to emoji	Yandex, Russia	/
Itranslate	100	support translation of different regions but the same language, such as en-US, en-UK, en-AU	Itranslate, Austria	stable
Sogou	61	support more languages in the world	Sogou / tencent, China	stable
Reverso	42	popular on Mac and Iphone	Reverso, France	stable
Baidu	28	support main languages, support professional field, support Classical Chinese	Baidu, China	stable
Deepl	27	high quality to translate but response slowly	Deepl, Germany	stable
Tencent	17	support main languages	Tencent, China	stable
Argos	17	open-source but the effect is ordinary	P.J. Finlay, America	stable
Youdao	15	support main languages, high quality	Netease, China	stable
Papago	15	good at Korean translation	Naver, South Korea	stable
Caiyun	7	high quality to translate but response slowly, support professional field	ColorfulClouds, China	stable
Mglip	3	good at Mongolia translation	Inner Mongolia University, China	stable
Utibet	2	good at Tibet translation	Tibet University, China	stable
TranslateCom	-	~~from Microsoft~~	TranslateCom, America	stable

Supported Language

Language	Language of Translator	Google	Yandex	Bing	Baidu	Alibaba	Tencent	Youdao	Sogou	Deepl	Caiyun	Argos	others...
english	en	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y	...
chinese	zh	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y
arabic	ar	Y	Y	Y	Y(ara)	Y	Y	Y	Y			Y
russian	ru	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y
french	fr	Y	Y	Y	Y(fra)	Y	Y	Y	Y	Y	Y	Y
german	de	Y	Y	Y	Y		Y	Y	Y	Y		Y
spanish	es	Y	Y	Y	Y(spa)	Y	Y	Y	Y	Y	Y	Y
portuguese	pt	Y	Y	Y(pt/pt-pt)	Y	Y	Y	Y	Y	Y		Y
italian	it	Y	Y	Y	Y	Y	Y	Y	Y	Y		Y
japanese	ja	Y	Y	Y	Y(jp)		Y	Y	Y	Y	Y	Y
korean	ko	Y	Y	Y	Y(kor)		Y	Y	Y			Y
greek	el	Y	Y	Y	Y				Y	Y
dutch	nl	Y	Y	Y	Y			Y	Y	Y
hindi	hi	Y	Y	Y			Y		Y			Y
turkish	tr	Y	Y	Y		Y	Y		Y			Y
malay	ms	Y	Y	Y			Y		Y
thai	th	Y	Y	Y	Y	Y	Y		Y
vietnamese	vi	Y	Y	Y	Y(vie)	Y	Y	Y	Y			Y
indonesian	id	Y	Y	Y		Y	Y	Y	Y			Y
hebrew	he	Y(iw)	Y	Y					Y
polish	pl	Y	Y	Y	Y				Y	Y		Y
mongolian	mn	Y	Y
czech	cs	Y	Y	Y	Y				Y	Y
hungarian	hu	Y	Y	Y	Y				Y	Y
estonian	et	Y	Y	Y	Y(est)				Y	Y
bulgarian	bg	Y	Y	Y	Y(bul)				Y	Y
danish	da	Y	Y	Y	Y(dan)				Y	Y
finnish	fi	Y	Y	Y	Y(fin)				Y	Y
romanian	ro	Y	Y	Y	Y(rom)				Y	Y
swedish	sv	Y	Y	Y	Y(swe)				Y	Y
slovenian	sl	Y	Y	Y	Y(slo)				Y	Y
persian/farsi	fa	Y	Y	Y					Y
bosnian	bs	Y	Y	Y(bs-Latn)					Y(bs-Latn)
serbian	sr	Y	Y	Y(sr-Latn/sr-Cyrl)					Y(sr-Latn/sr-Cyrl)
fijian	fj			Y					Y
filipino	tl	Y	Y	Y(fil)					Y(fil)
haitiancreole	ht	Y	Y	Y					Y
catalan	ca	Y	Y	Y					Y
croatian	hr	Y	Y	Y					Y
latvian	lv	Y	Y	Y					Y	Y
lithuanian	lt	Y	Y	Y					Y	Y
urdu	ur	Y	Y	Y					Y
ukrainian	uk	Y	Y	Y					Y
welsh	cy	Y	Y	Y					Y
tahiti	ty			Y					Y
tongan	to			Y					Y
swahili	sw	Y	Y	Y					Y
samoan	sm	Y		Y					Y
slovak	sk	Y	Y	Y					Y	Y
afrikaans	af	Y	Y	Y					Y
norwegian	no	Y	Y	Y					Y
bengali	bn	Y	Y	Y(bn-BD)					Y
malagasy	mg	Y	Y	Y					Y
maltese	mt	Y	Y	Y					Y
queretaro otomi	otq			Y					Y
klingon/tlhingan hol	tlh			Y					Y
gujarati	gu	Y	Y	Y
tamil	ta	Y	Y	Y
telugu	te	Y	Y	Y
punjabi	pa	Y	Y	Y
amharic	am	Y	Y
azerbaijani	az	Y	Y
bashkir	ba		Y
belarusian	be	Y	Y
cebuano	ceb	Y	Y
chuvash	cv		Y
esperanto	eo	Y	Y
basque	eu	Y	Y
irish	ga	Y	Y	Y
emoji	emj		Y
...	...

About Chinese Language

Language	Language of Translator	Google	Yandex	Bing	Baidu	Alibaba	Tencent	Youdao	Sogou	Iciba	Iflytek	Caiyun	Deepl	Argos	Itranslate	Reverso	TranslateCom	Papago	Utibet
Chinese(简体)	zh-CHS	Y(zh-CN)	Y(zh)	Y(zh-Hans)	Y(zh)	Y(zh)	Y(zh)	Y	Y	Y(zh)	Y(zh)	Y(zh)	Y(zh)	Y(zh)	Y(zh-CN)	Y(zh/chi)	...	Y(zh-CN)	Y(zh)
Chinese(繁体)	zh-CHT	Y(zh-TW)		Y(zh-Hant)	Y(cht)	Y(zh-TW)			Y	Y(cnt)					Y(zh-TW)			Y(zh-TW)
Chinese(文言文)	wyw				Y
Chinese(粤语)	yue			Y	Y				Y	Y	Y				Y(zh-HK)
Chinese(内蒙语)	mn	N[外蒙]	N[外蒙]								Y[内蒙]				N[外蒙]
Chinese(维吾尔语)	uy									Y
Chinese(藏语)	ti									Y									Y
Chinese(白苗文)	mww			Y					Y	Y
Chinese(彝语)	ii										Y
Chinese(苗语)	hmn														Y
Chinese(壮语)	zyb

Debug Tips

Linux Runtime Environment

To support javascript runtime environment, you should download and install Node.js.
PS, ts.baidu() doesn't work on Linux without desktop.

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 eg: help(tss.google).

HttpError 4xx

Check whether you made high frequency requests.
Check whether this service is provided in your country or region.
Detail to solve HttpError itself.
Issue me, thanks.

NetworkError or ProxyError

Check whether the network is connected correctly.
Check the proxy are enabled on your computer. If it is enabled, try turning it off or otherwise.

License

MIT Llicense

Project details

These details have not been verified by PyPI

Project links

GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Release history Release notifications | RSS feed

5.9.1

Apr 3, 2024

5.9.0

Feb 23, 2024

5.8.9

Nov 13, 2023

5.8.8

Nov 6, 2023

5.8.7

Oct 7, 2023

5.8.6 yanked

Oct 7, 2023

Reason this release was yanked:

v5.8.7 fix sep of google result

5.8.5

Sep 20, 2023

5.8.4

Sep 19, 2023

5.8.3

Aug 27, 2023

5.8.2

Jul 26, 2023

5.8.0

Jul 10, 2023

5.7.9

Jul 2, 2023

5.7.8

Jun 29, 2023

5.7.7

Jun 29, 2023

5.7.6

May 19, 2023

5.7.5

May 15, 2023

5.7.4

May 15, 2023

5.7.1

Apr 30, 2023

5.7.0

Apr 13, 2023

5.6.3

Mar 13, 2023

5.6.2

Mar 10, 2023

5.6.1

Mar 10, 2023

5.6.0

Mar 8, 2023

5.5.6

Jan 24, 2023

5.5.5

Dec 12, 2022

5.5.4

Dec 10, 2022

This version

5.5.3

Dec 6, 2022

5.5.0

Nov 18, 2022

5.4.8

Oct 25, 2022

5.4.3

Oct 16, 2022

5.4.2

Aug 6, 2022

5.4.1

Jul 21, 2022

5.3.1

Jun 28, 2022

5.3.0

Jun 23, 2022

5.2.2

Jun 1, 2022

5.2.1

May 16, 2022

5.1.1

May 2, 2022

5.1.0

May 2, 2022

5.0.2

Mar 17, 2022

5.0.1

Jan 13, 2022

5.0.0

Jan 13, 2022

4.11.4

Jan 4, 2022

4.11.3

Dec 14, 2021

4.11.2

Dec 14, 2021

4.11.1

Dec 10, 2021

4.11.0

Nov 30, 2021

4.10.1

Nov 30, 2021

4.10.0

Nov 29, 2021

4.9.6

Nov 28, 2021

4.9.5

Aug 30, 2021

4.9.4

Aug 5, 2021

4.9.1

Jul 28, 2021

4.8.1

Jul 19, 2021

4.8.0

Jul 15, 2021

4.7.20

Jun 10, 2021

4.7.16

Mar 4, 2021

4.7.15

Feb 11, 2021

4.7.14

Feb 11, 2021

4.7.13

Dec 29, 2020

4.7.12

Dec 28, 2020

4.7.11

Nov 29, 2020

4.7.10

Nov 27, 2020

4.7.9

Nov 7, 2020

4.7.8

Nov 5, 2020

4.7.7

Nov 5, 2020

4.7.6

Nov 3, 2020

4.7.4

Sep 14, 2020

4.7.3

Sep 13, 2020

4.7.2

Sep 7, 2020

4.7.1

Aug 31, 2020

4.6.20

Aug 26, 2020

4.6.18

Jun 30, 2020

4.6.2

Jun 3, 2020

4.5.14

Jun 1, 2020

4.5.12

Jun 1, 2020

4.5.10

May 31, 2020

4.5.8

May 25, 2020

4.5.6

May 25, 2020

4.5.4

May 9, 2020

4.5.3

May 9, 2020

4.5.2

May 9, 2020

4.5.1

May 9, 2020

4.5.0

May 8, 2020

4.4.3

Apr 3, 2020

4.4.2

Mar 27, 2020

4.4.0

Feb 28, 2020

4.3.2

Feb 23, 2020

4.3.0

Feb 21, 2020

4.2.2

Jan 2, 2020

4.2.0

Oct 30, 2019

4.1.0

Sep 2, 2019

4.0.8

Sep 2, 2019

4.0.6

Sep 2, 2019

4.0.4

Jun 18, 2019

4.0.3

Apr 2, 2019

4.0.2

Mar 26, 2019

4.0.1

Mar 23, 2019

4.0.0

Mar 23, 2019

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

translators-5.5.3.tar.gz (46.0 kB view hashes)

Uploaded Dec 6, 2022 Source

Built Distribution

translators-5.5.3-py3-none-any.whl (31.3 kB view hashes)

Uploaded Dec 6, 2022 Python 3

Hashes for translators-5.5.3.tar.gz

Hashes for translators-5.5.3.tar.gz
Algorithm	Hash digest
SHA256	`db7754e792ce6450d057b707e9e691572b5d29f919e037e290158bc51f40eb5e`
MD5	`2eb0b4022c04aceabdbfc1eb0460eb56`
BLAKE2b-256	`1b81d1a181955d49a7c94a69dfac4642d9db4debb10b74ae89a4c6ed2db7c3ce`

Hashes for translators-5.5.3-py3-none-any.whl

Hashes for translators-5.5.3-py3-none-any.whl
Algorithm	Hash digest
SHA256	`fc4d72f200035d6f0bee3b78aee0cf7f4e16d0f81c9e966962e2bb7e63af4bd7`
MD5	`c256fdea680d120f638845ddb827c85f`
BLAKE2b-256	`6a5d4adc1c6516b90e870a17b00ccf399ea052ccd2916c846be17db6bdd6b3bf`