Metadata-Version: 1.1
Name: mstranslator
Version: 0.2.3
Summary: Microsoft Translator API wrapper
Home-page: https://github.com/wronglink/mstranslator
Author: Michael Elovskikh
Author-email: wronglink@gmail.com
License: MIT
Description: ================================================
        mstranslator: Microsoft Translator API wrapper
        ================================================
        
        .. image:: https://travis-ci.org/wronglink/mstranslator.png?branch=master
           :target: https://travis-ci.org/wronglink/mstranslator
           :alt: Travis-ci: continuous integration status.
        
        .. image:: https://badge.fury.io/py/mstranslator.png
           :target: http://badge.fury.io/py/mstranslator
           :alt: PyPI version
        
        Installation
        ============
        
        Install with pip:
        
        .. code-block:: console
        
            $ pip install mstranslator
        
        Usage
        =====
        
        1. Subscribe to the Microsoft Translator API
        Subscribe to the `Microsoft Translator dataset`_ on Azure Marketplace. Note that subscriptions,
        up to 2 million characters a month, are free. Translating more than 2 million characters per
        month requires a payment.
        
        2. Register an application
        Register an application `here`__. As the redirect field is not used but it's marked as required
        you may enter any URI to pass validation.
        
        That's all. Now you have a Client ID and Client secret.
        
        Example Usage:
        
        .. code-block:: pycon
        
            >>> from mstranslator import Translator
            >>> translator = Translator('<Client ID>', '<Client secret>')
            >>> print(translator.translate('Привет, мир!', lang_from='ru', lang_to='en'))
            Hello World!
        
        Testing
        =======
        To run tests you need to set ``TEST_MSTRANSLATOR_CLIENT_ID`` and ``TEST_MSTRANSLATOR_CLIENT_SECRET`` environment variables
        and install `tox`_ package. After that run shell command:
        
        .. code-block:: console
        
            $ tox
        
        .. __: https://datamarket.azure.com/developer/applications/
        .. _Microsoft Translator dataset: https://datamarket.azure.com/dataset/bing/microsofttranslator
        .. _tox: http://tox.readthedocs.org/en/latest/
        
        
        History
        -------
        
        0.2.3 (2013-05-08)
        ++++++++++++++++++
        
        - Added get_translations method
        
        0.2.2 (2013-05-05)
        ++++++++++++++++++
        
        - Added break_sentences method
        - Added add_translation method
        
        0.2.1 (2013-05-04)
        ++++++++++++++++++
        
        - Added get_lang_names method
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
