Online translation as a Python module & command line tool. No key, no authentication needed.
Online translation as a Python module & command line tool. No key, no authentication needed.
|PyPI latest| |PyPI Version| |PyPI License| |Docs| |Travis Build Status|
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, DeepL's free and pro APIs, and Yandex Translate API
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
.. code-block:: bash
$ pip install translate
Or, you can download the source and
.. code-block:: bash
$ python setup.py install
Prefix 'sudo' if you encounter a problem.
In your command-line:
.. code-block:: bash
$ translate-cli -t zh "This is a pen."
Translated by: MyMemory
Or
.. code-block:: bash
$ translate-cli -t zh "This is a pen." -o 这是一支笔
Options
.. code-block:: bash
$ 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.
Change Default LanguagesIn ~/.python-translate.cfg:
.. code-block:: bash
[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:
.. code-block:: bash
$ translate-cli --generate-config-file
Translate from [autodetect]:
Translate to:
Provider [mymemory]:
Secret Access Key []:.. code-block:: python
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.
Use a different translation provider
.. code-block:: python
In [1]: from translate import Translator
In [2]: to_lang = 'zh'
In [3]: secret = ''
In [4]: translator = Translator(provider='', to_lang=to_lang, secret_access_key=secret)
In [5]: translator.translate('the book is on the table')
Out [5]: '碗是在桌子上。'
The DeepL Provider
~~~~~~~~~~~~~~~~~~
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
.. code-block:: python
In: translator = Translator(provider='deepl', to_lang=to_lang, secret_access_key=secret, pro=True)
The Yandex Provider
~~~~~~~~~~~~~~~~~~~
Yandex Translate API supports both API key and IAM token authentication. To use IAM token authentication, pass the is_iam parameter set to True. You may also need to provide a folder_id for your Yandex Cloud project.
.. code-block:: python
In: translator = Translator(provider='yandex', to_lang=to_lang, secret_access_key='your_api_key', folder_id='your_folder_id')
In: translator = Translator(provider='yandex', to_lang=to_lang, secret_access_key='your_iam_token', folder_id='your_folder_id', is_iam=True)
Documentation
-------------
Check out the latest ``translate`` documentation at `Read the Docs `_
Contributing
------------
Please send pull requests, very much appreciated.
1. Fork the `repository `_ on GitHub.
2. 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
4. Install requirements. ``pip install -r requirements-dev.txt``
5. Install pre-commit. ``pre-commit install``
6. Run the tests with ``py.test -vv -s``
7. Create a Pull Request with your contribution.
.. |Docs| image:: https://readthedocs.org/projects/translate-python/badge/?version=latest
:target: http://translate-python.readthedocs.org/en/latest/?badge=latest
.. |Travis Build Status| image:: https://api.travis-ci.org/terryyin/translate-python.png?branch=master
:target: https://travis-ci.org/terryyin/translate-python
.. |PyPI Version| image:: https://img.shields.io/pypi/pyversions/translate.svg?maxAge=2592000
:target: https://pypi.python.org/pypi/translate
.. |PyPI License| image:: https://img.shields.io/pypi/l/translate.svg?maxAge=2592000
:target: https://github.com/terryyin/translate-python/blob/master/LICENSE
.. |PyPI latest| image:: https://img.shields.io/pypi/v/translate.svg?maxAge=360
:target: https://pypi.python.org/pypi/translateNo open issues yet, or sync has not completed.