microsofttranslator 0.8
Microsoft Translator V2 - Python API
License: BSD
Keywords: translation microsoft

Microsoft Translator V2 -- Python API
=====================================

:Version: 0.7
:Web: http://fulfil.io/
:keywords: Microsoft Translator
:copyright: Fulfil.IO, Openlabs Technologies & Consulting (P) LTD
:license: BSD

.. image:: https://secure.travis-ci.org/fulfilio/Microsoft-Translator-Python-API.png?branch=master
   :target: http://travis-ci.org/#!/fulfilio/Microsoft-Translator-Python-API

.. image:: https://coveralls.io/repos/fulfilio/Microsoft-Translator-Python-API/badge.png?branch=master
  :target: https://coveralls.io/r/fulfilio/Microsoft-Translator-Python-API


This python API implements the Microsoft Translator services which can be used 
in web or client applications to perform language translation operations. The 
services support users who are not familiar with the default language of a page 
or application, or those desiring to communicate with people of a different 
language group.


Example Usage:
::

        >>> from microsofttranslator import Translator
        >>> translator = Translator('<Your Client ID>', '<Your Client Secret>')
        >>> print translator.translate("Hello", "pt")
        "Olá"

Registering your application
----------------------------

To register your application with Azure DataMarket, 
visit https://datamarket.azure.com/developer/applications/ using the
LiveID credentials from step 1, and click on “Register”. In the
“Register your application” dialog box, you can define your own
Client ID and Name. The redirect URI is not used for the Microsoft
Translator API. However, the redirect URI field is a mandatory field,
and you must provide a URI to obtain the access code. A description is
optional.

Take a note of the client ID and the client secret value.

Installing
----------

::

      pip install microsofttranslator


Features
--------

Translation
+++++++++++

::

        >>> from microsofttranslator import Translator
        >>> translator = Translator('<Your Client ID>', '<Your Client Secret>')
        >>> print translator.translate("Hello", "pt")
        "Olá"

Translate multiple words at once
++++++++++++++++++++++++++++++++

::

        >>> from microsofttranslator import Translator
        >>> translator = Translator('<Your Client ID>', '<Your Client Secret>')
        >>> translator.translate_array(['apple', 'orange'], 'pt')
        [{u'TranslatedText': u'Apple', u'From': u'en', u'OriginalTextSentenceLengths': [5], u'TranslatedTextSentenceLengths': [5]}, {u'TranslatedText': u'laranja', u'From': u'en', u'OriginalTextSentenceLengths': [6], u'TranslatedTextSentenceLengths': [7]}]

Get supported languages
+++++++++++++++++++++++

::

        >>> from microsofttranslator import Translator
        >>> translator = Translator('<Your Client ID>', '<Your Client Secret>')
        >>> print translator.get_languages()
        [u'ar', u'bg', u'ca', u'zh-CHS', u'zh-CHT', u'cs', u'da', u'nl', u'en', u'et', u'fi', u'fr', u'de', u'el', u'ht', u'he', u'hi', u'mww', u'hu', u'id', u'it', u'ja', u'tlh', u'tlh-Qaak', u'ko', u'lv', u'lt', u'ms', u'mt', u'no', u'fa', u'pl', u'pt', u'ro', u'ru', u'sk', u'sl', u'es', u'sv', u'th', u'tr', u'uk', u'ur', u'vi', u'cy']

Detect Language
+++++++++++++++

::

        >>> from microsofttranslator import Translator
        >>> translator = Translator('<Your Client ID>', '<Your Client Secret>')
        >>> translator.detect_language('hello')
        u'en'


Bugs and Development on Github
------------------------------

https://github.com/fulfilio/Microsoft-Translator-Python-API