Skip to main content
Help us improve Python packaging – donate today!

Microsoft Translator API wrapper

Project Description

Travis-ci: continuous integration status. PyPI version

Installation

Install with pip:

$ pip install mstranslator

Usage

1. Subscribe to the Translator API

To access Translator API you need a Microsoft Azure account. Note that subscriptions, up to 2 million characters a month, are free. Translating more than 2 million characters per month requires a payment.

2. Add Translator subscription to your Azure account

  1. Select the + New -> Intelligence + analytics -> Cognitive Services APIs.
  2. Select the API Type option.
  3. Select either Text Translation or Speech Translation.Select the pricing tier that fits your needs.
  4. Fill out the rest of the form, and press the Create button. You are now subscribed to Microsoft Translator.
  5. Now retrieve your subscription key for authentication. You can find it in All Resources -> Keys option.

That’s all. Now you have a Subscription Key and can use Microsoft Translator API.

Example Usage:

>>> from mstranslator import Translator
>>> translator = Translator('<Subscription Key>')
>>> print(translator.translate('Привет, мир!', lang_from='ru', lang_to='en'))
Hello World!

Testing

To run tests you need to set TEST_MSTRANSLATOR_SUBSCRIPTION_KEY environment variable and install tox package. After that run shell command:

$ tox

History

0.3.2 (2016-12-08)

0.2.6 (2016-10-02)

  • Translator API errors are now wrapped with python exceptions
  • Add translate_array2 method (by @kanghj)

0.2.5 (2013-07-23)

  • Fixed README formating

0.2.4 (2013-07-18)

  • Added translate_array and detect_langs methods (by @wjt)

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

Release history Release notifications

This version
History Node

0.3.2

History Node

0.2.6

History Node

0.2.5

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
mstranslator-0.3.2.tar.gz (5.3 kB) Copy SHA256 hash SHA256 Source None Dec 8, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page