Translate is a simple but powerful translation tool written in python with with support for multiple translation providers. By now we offer integration with Microsoft Translation API, Translated MyMemory API, LibreTranslate, and DeepL's free and pro APIs
The biggest reason to use translate is to make translations in a simple way without the need of bigger effort and can be used as a translation tool like command line
$ pip install translateOr, you can download the source and
$ python setup.py installPrefix 'sudo' if you encounter a problem.
- Translate your output in real time
- Do translation in your terminal using the command line
In your command-line:
$ translate-cli -t zh "This is a pen."
Translation: 这是一支笔
-------------------------
Translated by: MyMemoryOr
$ translate-cli -t zh "This is a pen." -o
这是一支笔$ translate-cli --help
Usage: __main__.py [OPTIONS] TEXT...
Python command line tool to make online translations
Example:
$ translate-cli -t zh the book is on the table
碗是在桌子上。
Available languages:
https://en.wikipedia.org/wiki/ISO_639-1
Examples: (e.g. en, ja, ko, pt, zh, zh-TW, ...)
Options:
--version Show the version and exit.
--generate-config-file Generate the config file using a Wizard and exit.
-f, --from TEXT Sets the language of the text being translated.
The default value is 'autodetect'.
-t, --to TEXT Set the language you want to translate.
-p, --provider TEXT Set the provider you want to use. The default
value is 'mymemory'.
--secret_access_key TEXT Set the secret access key used to get provider
oAuth token.
-o, --output_only Set to display the translation only.
-r, --region TEXT Set to pass a region in to API calls that require it.
--help Show this message and exit.In ~/.python-translate.cfg:
[DEFAULT]
from_lang = autodetect
to_lang = de
provider = mymemory
secret_access_key =The cfg is not for use as a Python module.
or run the command line and follow the steps:
$ translate-cli --generate-config-file
Translate from [autodetect]:
Translate to: <language you want to translate>
Provider [mymemory]:
Secret Access Key []:In [1]: from translate import Translator
In [2]: translator = Translator(to_lang="zh")
In [3]: translation = translator.translate("This is a pen.")
Out [3]: 这是一支笔The result is usually a unicode string.
In [1]: from translate import Translator
In [2]: to_lang = 'zh'
In [3]: secret = '<your secret from Microsoft or DeepL>'
In [4]: translator = Translator(provider='<the name of the provider, eg. microsoft or deepl>', to_lang=to_lang, secret_access_key=secret)
In [5]: translator.translate('the book is on the table')
Out [5]: '碗是在桌子上。'To use DeepL's pro API, pass an additional parameter named pro to the Translator object and set it to True and use your pro authentication key as the secret_access_key
In: translator = Translator(provider='microsoft', to_lang=to_lang, secret_access_key=secret, pro=True)Check out the latest translate documentation at Read the Docs
Please send pull requests, very much appreciated.
- Fork the repository on GitHub.
- Make a branch off of master and commit your changes to it.
3. (Optional) if you want an isolated environment, you can install nixOS (https://nixos.org) and run nix-shell --pure under the project folder
3. Install requirements. pip install -r requirements-dev.txt
4. Install pre-commit. pre-commit install
5. Run the tests with py.test -vv -s
6. Create a Pull Request with your contribution.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent