Metadata-Version: 2.1
Name: translators
Version: 4.5.6
Summary: Translators is a library which aims to bring free, multiple, enjoyable translation to individuals and students in Python.
Home-page: https://github.com/uliontse/translators
Author: UlionTse
Author-email: shinalone@outlook.com
License: MIT
Keywords: translate,translator,fanyi,Google,Baidu,Alibaba,Tencent,Youdao,Bing,Sogou,Deepl
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
Requires-Dist: requests (>=2.23.0)
Requires-Dist: PyExecJS (>=1.5.1)
Requires-Dist: lxml (>=4.5.0)
Requires-Dist: loguru (>=0.4.1)

[translators](https://github.com/uliontse/translators/blob/master/README.md)
================================================================================

[![PyPI - Version](https://img.shields.io/badge/pypi-v4.5.6-blue.svg)](https://pypi.org/project/translators/)
[![PyPI - License](https://img.shields.io/pypi/l/translators.svg)](https://github.com/shinalone/translators/blob/master/LICENSE)
[![PyPI - Python](https://img.shields.io/badge/python-3.5+-blue.svg)](https://docs.python.org/3/)
[![PyPI - Status](https://img.shields.io/pypi/status/translators.svg)](https://pypi.org/project/translators/)
[![PyPI - Wheel](https://img.shields.io/badge/wheel-yes-brightgreen.svg)](https://pypi.org/project/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, Microsoft(Bing), Baidu, Alibaba, Tencent, NetEase(Youdao), Sogou, Deepl, etc.

- [Installation](#installation)
  - [From PyPI](#from-PyPI)
  - [From Source](#from-source)
- [Getting Started](#getting-started)
    - [Import library](#Import-library)
    - [Language](#Language)
    - [Professional Field](#Professional-Field)
    - [Property](#Property)
    - [Requests](#Requests)
    - [Host](#Host)
    - [Detail Result](#Detail-Result)
    - [Help](#Help)
- [Issues]()
    - [Linux Runtime Environment](#linux-runtime-environment)
    - [Supported Country and Region Service](#supported-country-and-region-service)
    - [HTTPError 4xx](#httperror-4xx)
- [More About Translators](#more-about-translators)
    - [Features](#features)
    - [Support Language](#support-language)
    - [About Chinese Language](#about-Chinese-language)
- [License](#License)



## Installation

### From PyPI

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

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

### From Source

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

## Getting Started

```python
# 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(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

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

### 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 `help(ts.your_translator)`.

### HTTPError 4xx

1. First, ensure whether you made high frequency requests.
2. Second, check whether this service is provided in your country or region.
3. Third, detail to solve HTTPError self.

## More About Translators

### Features

| Translator\Feature | Supported Language Count | Advantage                                                    |
| ------------------ | ------------------------ | ------------------------------------------------------------ |
| Google             | 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 Europe & Asia languages; support professional field |
| Alibaba            | 21                       | support more Europe & Asia languages; support professional field |
| Tencent            | 17                       | support more Europe & Asia languages                         |
| Youdao             | 13                       | support more Europe & Asia languages                         |
| Deepl              | 11                       | high quality to translate but response slowly                |



### Support Language

| Language             | Supported Language of Translator | Google | 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:

```python
print(ts._google.language_map)
```



### About Chinese Language

| Language        | Language \Translator | Google   | 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 remain grateful, not cause trouble.

[click the detail license.](https://github.com/uliontse/translators/blob/master/LICENSE)

