translate 3.4.0

google-translate-python
=======================

Now google has stop providing free translation API. So I have to switch to
http://mymemory.translated.net/, which has a limit for 1000 words/day free
usage. Please let me know if there's any other better free translation API.

The default from language is English (en).
The default to language is Simplified Chinese (zh). Of course, you can specify it
in the parameter or commandline.

利用google
translate实现的命令行工具（translate），也可以当做Python模块用在你的代码中。

Installation
------------

::

pip install translate

Or, you can download the source and

::

python setup.py install

Add sudo in the beginning if you met problem.

Command-Line Usage
------------------

In your command-line:

::

translate-cli "This is a pen."

Or

::

translate-cli -f zh -t ja 我是谁？

Use As A Python Module
----------------------

::

from translate import Translator
translator= Translator(to_lang="zh")
translation = translator.translate("This is a pen.")

The result is in translation, and it’s usually a unicode string.

Change Default Languages
----------------------

In ~/.python-translate.cfg:

::

[DEFAULT]
from_lang = auto
to_lang = 'de'

The cfg is not for using as a Python module.
The country code, as far as I know, is following https://en.wikipedia.org/wiki/ISO_639-1.


Use a different translation provider
-----------------------------------

::
from translate import Translator
from translate.providers import MicrosoftProvider
from_lang = 'en'
secret = '<your secret from Microsoft>'
translator = Translator(provider=MicrosoftProvider, from_lang=from_lang, to_lang=to_lang, secret_access_key=secret)
translator.translate('the book is on the table')

> '碗是在桌子上。'

Contribution
-----------------------

Please send pull requests, very much appriciated.

If you find an incorrect translation, one thing you can do is to create an account at http://mymemory.translated.net/ and fix their data.


Changelog
---------

3.4.0
-----

* Refactor: Create a folder to add all providers instead to let in a single file
* Add Microsoft provider
* Add more documentation to all providers (Translated-MyMemory and Microsoft Translator)
* Add arguments to change the default provider using translate-cli


3.3.0
-----

* Refactor translate-cli (command line interface) Using Click library instead of ArgParser
* Unify translate-cli and main to avoid duplicate code
* Add documentation to be used on helper commands on translate-cli
* Remove unnecessary code
* Refactor setup to complete information in the PKG-INFO used by PyPI


3.2.1
-----

* Change the license from "BEER-WARE" to MIT

3.2.0
-----

* Add multiple providers suport

3.1.0
-----

* Apply Solid Principles
* Organize Project
* Add pre-commit, pytest
* Add new Make file
* Add new test cases

3.0.0
-----

* General Refactor
* Remove urllib to use requests
* Refactor methods names removing google from then
* Apply PEP8
* Change contructor to keep it the code simple

2.0.0 (2017-11-08)
------------------

* initial release using changes file