Metadata-Version: 1.1
Name: py-translate
Version: 1.0.2
Summary: A Translation Tool for Humans
Home-page: https://github.com/jjangsangy/py-translate
Author: Sang Han
Author-email: jjangsangy@gmail.com
License: Apache License 2.0
Description: py-translate
        ============
        
        |Documentation| |github| |travis| |pypi| |Wheel|
        
        A Translation Tool for Humans
        
        .. figure:: https://raw.githubusercontent.com/jjangsangy/py-translate/master/img/alice.gif
           :alt: Translate Lewis Carroll: Alice in Wonderland
        
           Translate Lewis Carroll: Alice in Wonderland
        
        --------------
        
        The end goal is a simple application for translating text in the
        terminal. Text can be generated interactively or programmatically in the
        shell environment. Through command line arguments, file descriptors or
        pipes generating translated output that can be piped to a file or
        displayed on the terminal.
        
        Features
        --------
        
        -  Made for Python 3 but still works on Python 2
        -  Fast and easy to install, easy to use
        -  Supports translation from any language
        -  Highly composable interface, the power of Unix pipes and filters.
        -  Simple API and documentation
        
        Installation
        ------------
        
        From PyPI with pip (easy)
        ~~~~~~~~~~~~~~~~~~~~~~~~~
        
        .. code:: sh
        
            $ pip install py-translate
        
        From Source at Github
        ~~~~~~~~~~~~~~~~~~~~~
        
        -  Clone the repository
        
        .. code:: sh
        
            $ git clone https://github.com/jjangsangy/py-translate.git
        
        -  Install with setup.py
        
        .. code:: sh
        
            $ python setup.py install
        
        Usage
        -----
        
        ``translate [--flags] [source] dest``
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        Arguments
        ~~~~~~~~~
        
        +------------------+-------------------------------------------------------+
        | **Positional**   |                                                       |
        +==================+=======================================================+
        | dest             | Destination language code                             |
        +------------------+-------------------------------------------------------+
        | source           | Source language code                                  |
        +------------------+-------------------------------------------------------+
        | **Optional**     |                                                       |
        +------------------+-------------------------------------------------------+
        | -h,--help        | Show this help message and exit                       |
        +------------------+-------------------------------------------------------+
        | -v, --version    | Show program’s version number and exit                |
        +------------------+-------------------------------------------------------+
        | -l,--list [code] | Enumerate the name of country and language code pair. |
        +------------------+-------------------------------------------------------+
        |                  | [ Optionally specify output language format ]         |
        +------------------+-------------------------------------------------------+
        | --translit       | Print out the transliteration of the text             |
        +------------------+-------------------------------------------------------+
        
        Examples
        --------
        
        Hello World from English to Traditional Chinese
        
        .. code:: sh
        
            $ translate en zh-TW <<< 'Hello World!'
            你好世界！
        
        .. figure:: https://raw.githubusercontent.com/jjangsangy/py-translate/master/img/helloworld.gif
           :alt: Hello World
        
           Hello World
        
        -  Just as easily specify a source language by providing it as first
           argument
        
        .. code:: sh
        
            # Translate Hello from French to English
            $ translate fr en <<< 'Bonjour, comment allez-vous!'
            Hello, how are you?
        
        Smart Language Detection
        ~~~~~~~~~~~~~~~~~~~~~~~~
        
        Omitting the source language will try to detect it based on the text
        content
        
        .. code:: sh
        
            $ translate fr <<< 'I think therefore I am'
            Je pense donc je suis
        
        Romanified Transliteration
        ~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        .. code:: sh
        
            $ translate --translit en ko <<< 'Want to fight!'
            ssaugo sip-eo!
        
            $ translate --translit en zh-TW <<< 'Kidding, we should be friends'
            Kāiwánxiào, wǒmen yīnggāi shì péngyǒu
        
        Redirect from File
        ~~~~~~~~~~~~~~~~~~
        
        .. code:: sh
        
            $ translate zh-TW < 'alice.txt'
        
            阿麗思道：「你不是說你要告訴你的歷史嗎？告訴我你為甚麼恨—那個—那些—C和D，」
            她末了兩個字母輕輕兒地說的，怕回來又得罪了牠。
        
            那老鼠對著阿麗思嘆了一口氣道，「唉﹗我的身世說來可真是又長又苦又委屈呀—」
        
            阿麗思聽了，瞧著那老鼠的尾巴說，「你這尾是曲啊﹗可是為甚麼又叫它苦呢﹗」
            她就一頭聽著那老鼠說話，一頭在在心上納悶，所以她聽的那老鼠講的「尾曲」
            的歷史是差不多像這個樣了的
            ....
        
        Chaining together Pipes
        ~~~~~~~~~~~~~~~~~~~~~~~
        
        .. code:: sh
        
            # Multiple Chaining
            $ echo 'What is love?' | translate en zh-TW | translate zh-TW ko | translate ko fr | translate fr en
            What is love?
        
        Be Creative!
        ~~~~~~~~~~~~
        
        .. code:: sh
        
            # Grocery List
            $ cat << BUY | translate ko
            Celery
            Milk
            Eggs
            Bread
            Cereal
            BUY
        
            셀러리
            우유
            달걀
            빵
            시리얼
        
        Support
        -------
        
        Here’s a list of Python platforms that are officially supported.
        
        -  Python 3.4
        -  Python 3.3
        -  Python 3.2
        -  Python 2.7
        -  Python 2.6
        -  PyPy 2 (Latest)
        -  PyPy 3 (latest)
        
        Documentation
        -------------
        
        Find the latest documentation http://pythonhosted.org/py-translate/
        
        Contribute
        ----------
        
        1. Fork us on `Github <https://github.com/jjangsangy/py-translate>`__.
        
        2. Find a bug? Implemented a new feature? Send a pull request to get it
           merged and published.
        
        3. Feel free to send an e-mail to the code maintainer for questions or
           help regarding the codebase.
           `jjangsangy@gmail.com <jjangsangy@gmail.com>`__
        
        
        .. |Documentation| image:: https://readthedocs.org/projects/py-translate/badge/?version=master
           :target: https://readthedocs.org/projects/py-translate/?badge=master
        
        .. |github| image:: https://badge.fury.io/gh/jjangsangy%2Fpy-translate.svg
           :target: http://badge.fury.io/gh/jjangsangy%2Fpy-translate
        
        .. |travis| image:: https://travis-ci.org/jjangsangy/py-translate.svg?branch=master
           :target: https://travis-ci.org/jjangsangy/py-translate
        
        .. |pypi| image:: https://badge.fury.io/py/py-translate.svg
           :target: http://badge.fury.io/py/py-translate
        
        .. |Wheel| image:: https://pypip.in/wheel/py-translate/badge.svg
           :target: https://pypi.python.org/pypi/py-translate/
        
        =================
        Release History
        =================
        
        1.0.2 (2015-01-02)
        ------------------
        - Happy New Year
        - Created quick benchmarking suite
        - Optimized thread utilization
        - Bug fixes and better IO performance
        
        1.0.1 (2014-12-30)
        ------------------
        - More efficient task processing using `map` over `submit`.
        - Seperated IO in coroutine exception blocks.
        - Bug Fixes and Improvements.
        
        1.0.0 (2014-12-18)
        ------------------
        - Bug fix with lines longer than 1000 chars
        - Fixed another unicode bug
        - Improved Python 2/3 Compatability
        - Implemented text transliteration where available
        - Implemented simple File IO
        - Better utilization of thread pools using futures module.
        - Vendorized dependencies
        - Swapped transport API from urllib2 with Requests
        - SSL/TLS integration for secure web requests
        
        
        0.2.3 (2014-12-08)
        -------------------
        - Bug fix with double output
        
        
        0.2.2 (2014-12-07)
        -------------------
        
        - Bug fixes
        - Decreased package size
        - Split `translator.py` into two seperate modules
        
        
        0.2.1 (2014-12-04)
        ------------------
        - Added Output Buffer Streaming
        - Utilized Cooperative Multitasking for Coroutines
        - Updated Documentation on API
        
        0.2.0 (2014-11-30)
        ------------------
        
        - Bug fixes
        - Implmented concurrency based on Asyncronous threads and coroutines
        - Up to 10x performance speedup
        
        0.1.6 (2014-11-30)
        -------------------
        
        - Bug Fixes
        - Re-implmenenting concurrency models
        - Python 3 is now the base implemntation
        
        
        0.1.5 (2014-07-18)
        -------------------
        
        - Language Code Generator Fix
        
        0.1.4 (2014-07-05)
        --------------------
        
        - General Bug Fixes
        - Speed Improvements
        - Length of multibyte characters correctly represented by spooler
        - Better support for utf-8.
        
        0.1.3 (2014-04-07)
        -------------------
        
        - Implemented language discovery arg
        - Bug Fixes
        
        0.1.2 (2014-04-04)
        -------------------
        
        - Documentation reorganization
        
        **Bug Fixes**
        
        - Fixed unicode encode/decode errors
        
        0.1.1 (2014-04-03)
        --------------------
        
        - PyPy-c v2.2 now support
        
        **Bug Fixes**
        
        - Quick fix PyPI distribution (huge package sizes)
        - MANIFEST.in now does it job
        - Assorted fixes with methods and scope
        
        0.1.0 (2014-04-02)
        --------------------
        
        - GTranslate is taken on PyPI.
        - Name changed to py-translate
        - Distributed through PyPI and Wheel
        - More documentation and autoparsing for module functions
        - Separated into logical modules in a package rather than one executable `__main__.py`
        
        0.0.0 (2014-03-31)
        --------------------
        
        - Support for Python 2.7 and 3.x
        - Sphinx Documentation hosted
        - Travis CI build passed!
        - Source released on Github
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Unix Shell
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Linguistic
Classifier: Topic :: Utilities
