translation 1.0.5
A translation package
License: MIT
Keywords: translate translation

translation
===========

|python27| |python35| `Chinese Version <https://github.com/littlecodersh/translation/blob/master/README.md>`__

translation is a python translation package based on website service.

It provids google, youdao, baidu, iciba translation service.

**Installation**

.. code:: bash

    pip install translation

**Usage**

.. code:: python

    from translation import baidu, google, youdao, iciba

    print(google('hello world!', dst = 'zh-CN'))
    print(google('hello world!', dst = 'ru'))
    print(baidu('hello world!', dst = 'zh'))
    print(baidu('hello world!', dst = 'ru'))
    print(youdao('hello world!', dst = 'zh-CN'))
    print(iciba('hello world!', dst = 'zh'))
    print(bing('hello world!', dst = 'zh-CHS'))

**Documents**

You may find document `here <http://translation.readthedocs.io/zh_CN/latest/>`__

**Advanced usage**

*Proxies*

You may not use some of the function without proxies.

Proxies can be set as following.

.. code:: python

    from translation import google, ConnectError

    # 127.0.0.1:1080 is a vaild proxies
    try:
        print(google('hello world!', dst = 'zh-CN', proxies = {'http': '127.0.0.1:1080'}))
    except ConnectError:
        print('Invaild proxy')

*Default*

You may change default setting such as:

* default source language (auto if not set)
* default destination language (zh-CN if not set)
* default translation (youdao if not set)
* default proxies (no proxy if not set)

.. code:: python

    from translation import (set_default_translation, set_default_language,
        set_default_proxies, get, ConnectError)

    set_default_translation('google')
    set_default_language('auto', 'zh-CN')
    set_default_proxies({'http': '127.0.0.1:1080'})
    try:
        print(get('hello world!'))
    except ConnectError:
        print('Invaild proxy')

**More**

More functions are introduced in the `document <http://translation.readthedocs.io/zh_CN/latest/>`__.

**Language**

Language list of all the translation are provided in `document <http://translation.readthedocs.io/zh_CN/latest/>`__.

Somehow, iciba and youdao can only provide English translation.

*Google*

.. code:: bash

    el    : Greek,
    eo    : Esperanto,
    en    : English,
    af    : Afrikaans,
    sw    : Swahili,
    ca    : Catalan,
    it    : Italian,
    iw    : Hebrew,
    sv    : Swedish,
    cs    : Czech,
    cy    : Welsh,
    ar    : Arabic,
    ur    : Urdu,
    ga    : Irish,
    eu    : Basque,
    et    : Estonian,
    az    : Azerbaijani,
    id    : Indonesian,
    es    : Spanish,
    ru    : Russian,
    gl    : Galician,
    nl    : Dutch,
    pt    : Portuguese,
    la    : Latin,
    tr    : Turkish,
    tl    : Filipino,
    lv    : Latvian,
    lt    : Lithuanian,
    th    : Thai,
    vi    : Vietnamese,
    gu    : Gujarati,
    ro    : Romanian,
    is    : Icelandic,
    pl    : Polish,
    ta    : Tamil,
    yi    : Yiddish,
    be    : Belarusian,
    fr    : French,
    bg    : Bulgarian,
    uk    : Ukrainian,
    hr    : Croatian,
    bn    : Bengali,
    sl    : Slovenian,
    ht    : Haitian Creole,
    da    : Danish,
    fa    : Persian,
    hi    : Hindi,
    fi    : Finnish,
    hu    : Hungarian,
    ja    : Japanese,
    ka    : Georgian,
    te    : Telugu,
    zh-TW : Chinese Traditional,
    sq    : Albanian,
    no    : Norwegian,
    ko    : Korean,
    kn    : Kannada,
    mk    : Macedonian,
    zh-CN : Chinese Simplified,
    sk    : Slovak,
    mt    : Maltese,
    de    : German,
    ms    : Malay,
    sr    : Serbian

**Comments**

If you have any problem or suggestion, you may contact me in this `issue <https://github.com/littlecodersh/translation/issues/1>`__.

.. |python27| image:: https://img.shields.io/badge/python-2.7-ff69b4.svg
.. |python35| image:: https://img.shields.io/badge/python-3.5-green.svg