Metadata-Version: 2.1
Name: deepl-tr-async
Version: 0.0.5
Summary: deepl translate for free, based on pyppeteer
Home-page: https://github.com/ffreemt/deepl-tr-async
License: MIT
Keywords: mt,language,learning
Author: ffreemt
Requires-Python: >=3.7,<4.0
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: absl-py (>=0.9.0,<0.10.0)
Requires-Dist: environs (>=7.3.1,<8.0.0)
Requires-Dist: flake8 (>=3.7.9,<4.0.0)
Requires-Dist: fuzzywuzzy (>=0.18.0,<0.19.0)
Requires-Dist: get-ppbrowser (>=0.1.1,<0.2.0)
Requires-Dist: ipython (>=7.20.0,<8.0.0)
Requires-Dist: linetimer (>=0.1.4,<0.2.0)
Requires-Dist: logzero (>=1.5.0,<2.0.0)
Requires-Dist: polyglot (>=16.7.4,<17.0.0)
Requires-Dist: pycld2 (>=0.41,<0.42)
Requires-Dist: pyicu (>=2.6,<3.0)
Requires-Dist: pyinstaller (>=3.6,<4.0)
Requires-Dist: pyperclip (>=1.7.0,<2.0.0)
Requires-Dist: pyppeteer2 (>=0.2.2,<0.3.0)
Requires-Dist: pyquery (>=1.4.1,<2.0.0)
Requires-Dist: pytest-cov (>=2.8.1,<3.0.0)
Requires-Dist: tqdm (>=4.43.0,<5.0.0)
Project-URL: Repository, https://github.com/ffreemt/deepl-tr-async
Description-Content-Type: text/markdown

# deepl-tr-async [![build](https://github.com/ffreemt/deepl-tr-async/actions/workflows/build.yml/badge.svg)](https://github.com/ffreemt/deepl-tr-async/actions/workflows/build.yml)[![codecov](https://codecov.io/gh/ffreemt/deepl-tr-async/branch/master/graph/badge.svg)](https://codecov.io/gh/ffreemt/deepl-tr-async)[![PyPI version](https://badge.fury.io/py/deepl-tr-async.svg)](https://badge.fury.io/py/deepl-tr-async)

deepl translate for free with async and proxy support, based on pyppeteer

## Changes in v0.0.5
*   Python 3.6 is no longer supported.
*   `get_ppbrowser` is now an indepent package that `deepl-tr-async` depents on.

## Pre-installation of libicu

### For Linux/OSX

E.g.
* Ubuntu: `sudo apt install libicu-dev`
* Centos: `yum install libicu`
* OSX: `brew install icu4c`

### For Windows

Download and install the pyicu and pycld2 whl packages for your OS version from https://www.lfd.uci.edu/~gohlke/pythonlibs/#pyicu and https://www.lfd.uci.edu/~gohlke/pythonlibs/#pycld2

## Installation
```pip install deepl-tr-async```

Validate installation
```
python -c "import deepl_tr_async; print(deepl_tr_async.__version__)"
# 0.0.2 or other version info
```

## Usage

### from the command line 命令行调用
*   translate the system clipboad (not tested in Linux) 翻译系统剪贴板
  `deepl-tr`
*   translate text supplied from the command line 翻译终端提供的句子
  `deepl-tr --copyfrom=false this is a test`
    <!--img src="img\sample2.png" height="170px" /-->
  ![img](https://raw.githubusercontent.com/ffreemt/deepl-tr-async/master/img/copyfrom-false.png)
*   Help 帮助：

  `deepl-tr -?`

  or

  `deepl-tr --helpfull`
    <!--img src="https://github.com/ffreemt/deepl-tr-async/blob/master/img/copyfrom-false.png" height="170px" /-->
  ![img](https://raw.githubusercontent.com/ffreemt/deepl-tr-async/master/img/helpfull.png)

### Programmatic use 程序调用
```
import asyncio
from deepl_tr_async import deepl_tr_async
from deepl_tr_async.google_tr_async import google_tr_async

loop = asyncio.get_event_loop()

sent = 'Global coronavirus pandemic kills more than 30,000'

res = loop.run_until_complete(deepl_tr_async(sent, to_lang='zh'))
print(res)
# Alternatives:
# 全球冠状病毒大流行导致超过3万人死亡
# 全球冠状病毒大流行导致3万多人死亡
# 全球冠状病毒大流行导致超过30,000人死亡
# 全球冠状病毒大流行导致3万多人丧生

res = loop.run_until_complete(google_tr_async(sent, to_lang='zh'))
print(res)
# 全球冠状病毒大流行杀死超过30,000人

tasks = [deepl_tr_async(sent, to_lang='zh'), google_tr_async(sent, to_lang='zh')]
_ = asyncio.gather(*tasks)
res = loop.run_until_complete(_)
print(res)
['Alternatives:\n全球冠状病毒大流行导致超过3万人死亡\n全球冠状病毒大流行导致3万多人死亡\n全球冠状病毒大流行导致超过30,000人死亡\n全球冠状病毒大流行导致3万多人丧生', '全球冠状病毒大流行杀死超过30,000人']
```

## Environment variables: PPBROWSER_HEADFUL, PPBROWSER_DEBUG, PPBROWSER_PROXY
This version of `deep-tr-async` makes use of the package `get-ppbrowser`. `get-ppbrowser` is a headless browser based on `pyppeteer2`.

To turn off headless mode, i.e., to show the browser in action, set PPBROWSER_HEADFUL to 1 (or true or True) in the `.env` file, e.g.,
```bash
PPBROWSER_HEADFUL=1
```

or from the cmomand line, e.g.,
```bash
set PPBROWSER_HEADFUL=1
# export PPBROWSER_HEADFUL=1 in linux or iOS
```

or in a python script
```python
import os

os.environ["PPBROWSER_HEADFUL"]="1"  # note the quotes
```

PPBROWSER_DEBUG and PPBROWSER_PROXY can be set in a similar manner.

