py-translate 1.0.3

Description:

pytranslate 1.0.3

py-translate

A Translation Tool For Humans



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

Fast! Translate an entire book in less than 5 seconds.
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)
$ pip install py-translate


From Source at Github

Clone the repository

$ git clone https://github.com/jjangsangy/py-translate.git

Install with setup.py

$ 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
$ translate en zh-TW <<< 'Hello World!'
你好世界！



Hello World



Just as easily specify a source language by providing it as first
argument

# 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
$ translate fr <<< 'I think therefore I am'
Je pense donc je suis


Romanified Transliteration
$ 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
$ translate zh-TW < 'alice.txt'

阿麗思道：「你不是說你要告訴你的歷史嗎？告訴我你為甚麼恨—那個—那些—C和D，」
她末了兩個字母輕輕兒地說的，怕回來又得罪了牠。

那老鼠對著阿麗思嘆了一口氣道，「唉﹗我的身世說來可真是又長又苦又委屈呀—」

阿麗思聽了，瞧著那老鼠的尾巴說，「你這尾是曲啊﹗可是為甚麼又叫它苦呢﹗」
她就一頭聽著那老鼠說話，一頭在在心上納悶，所以她聽的那老鼠講的「尾曲」
的歷史是差不多像這個樣了的
....


Chaining together Pipes
# 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!
# 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

Fork us on Github.
Find a bug? Implemented a new feature? Send a pull request to get it
merged and published.
Feel free to send an e-mail to the code maintainer for questions or
help regarding the codebase.
[email protected]




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