Metadata-Version: 1.1
Name: translate
Version: 3.4.0
Summary: This is a simple, yet powerful command line translator with google translate behind it. You can also use it as a Python module in your code.
Home-page: https://github.com/terryyin/google-translate-python
Author: Terry Yin
Author-email: terry.yinze@gmail.com
License: MIT
Description: 
        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
        
Keywords: translate translation command line
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python
Classifier: Topic :: Education
