Metadata-Version: 2.1
Name: cn-bing-translator
Version: 0.0.2
Summary: microsoft cn.bing translator
Home-page: https://github.com/minibear2021/cn_bing_translator
Author: minibear
License: MIT
Keywords: microsoft bing translator
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
License-File: LICENSE

# 微软bing翻译器python sdk

[![PyPI version](https://badge.fury.io/py/cn_bing_translator.svg)](https://badge.fury.io/py/cn_bing_translator)
[![Download count](https://img.shields.io/pypi/dm/cn_bing_translator)](https://img.shields.io/pypi/dm/cn_bing_translator)

## 介绍

微软cn.bing翻译器，建议轻量使用，欢迎star、follow、fork：

## 适用对象

无法或者不便使用微软Azaue Text Translation服务的用户轻量级用户可以使用bing提供的翻译能力。

## 源码

[github](https://github.com/minibear2021/cn_bing_translator)

[gitee](https://gitee.com/minibear2021/cn_bing_translator)

## 安装

```
pip install cn_bing_translator
```

## 使用方法

```python
from cn_bing_translator import Translator

if __name__ == "__main__":
    translator = Translator()
    source = "翻译器"
    result = translator.process(source)
    print(result)
```

默认情况下将自动检测源语言语种，并翻译为英语，如果需要指定其他语种，可以在初始化的时候传入对应的语言代码：

```python
# 传入以下参数初始化一个从英语到日语的翻译器
translator = Translator(fromLang='en', toLang='ja')
```

具体支持的语言类型和代码请参考[微软网站](https://learn.microsoft.com/en-us/azure/ai-services/translator/language-support)。

翻译器初始化的时候，也可以定制user agent：

```python
agent = 'Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_1 like Mac OS X) AppleWebKit/603.1.30 (KHTML, like Gecko) Version/10.0 Mobile/14E304 Safari/602.1 Edg/99.0.4844.51'
translator = Translator(agent=agent)
```

如果有使用代理的需求，可以指定proxy：

```python
proxy = {'https':'http://localhost:8080'}
translator = Translator(proxy=proxy)
```

## 注意事项

建议轻量级使用，微软bing翻译器默认带有防滥用措施，短时间频繁发起大量请求可能会触发拦截。
