Skip to main content

API for Yandex Translate

Project description

Author:

James Axl

Version:
1.0
Date:
2017-05-10

VERSION

version 1.0

DESCRIPTION

This module uses the Yandex.Translate API for machine translation. A Yandex API key is required; see https://translate.yandex.com/developers for more information.

Note also that the “Yandex Terms of Use of API Yandex.Translate Service” at https://yandex.com/legal/translate_api/ must be observed.

Install

$ pip install yandex-translater

SYNOPSIS

Translate a Text

This is a simple example

>>> from yandex import Translater
>>> tr = Translater()
>>> tr.set_key('yandex_key') # Api key found on https://translate.yandex.com/developers/keys
>>> tr.set_from_lang('en')
>>> tr.set_to_lang('ru')
>>> tr.translate()
Привет

METHODS

Constructor

>>> tr = Translater(attributes)

This constructor returns a new object. Optional attributes include:

set_key

>>> tr.set_key('yandex_key')

This method is used to pass a Yandex API key (string), instead of passing it in Constructor. A tr object can be instantiated without any attributes.

set_text

>>> tr.set_text('text_to_translate')

This method is used to pass a text to translate (string).

set_from_lang

>>> tr.set_from_lang('zh')

This method is used to pass a source language (string). For example, Chinese would be given as zh.

set_to_lang

>>> tr.set_from_lang('ar')

This method is used to pass a destination language (string). For example, Arabic would be given as ar.

set_ui

>>> tr.set_ui('fr')

This method is used to set the user interface language (string). For example, French would be given as fr.

set_default_ui

>>> tr.set_default_ui('ru')

This method is used to set the default user interface language (string). Either ru (Russian) or en (English) or tr (Turkish) can be given.

set_hint

>>> tr.set_hint('es', 'pt')

This method is used to set the list of likely languages for detecting the text language (array reference). For example, Spanish and Portuguese would be given as attributes.

translate

>>> print tr.translate()

This method is used to get the translated text (string)

detect_lang

>>> print tr.detect_lang()

This method is used to detect the language of the text. It returns a string.

get_langs_list

>>> print tr.get_langs_list()

This method is used to get the list of supported translation directions. In array context, it returns an array of these directions; in scalar context, it returns the count of them.

SEE ALSO

For more information, please visit Yandex <https://translate.yandex.com/developers>.

SUPPORT

Bugs / Feature Requests

Please report any bugs or feature requests on my email or created in the website. yandex-translate-bugs <https://fossil.falseking.site/ticket>

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

https://fossil.falseking.site/

AUTHORS

James Axl <axlrose112@gmail.com>

COPYLEFT AND LICENSE

This software is copyleft © 2017 by James Axl.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

Project details


Download files

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

Source Distribution

yandex-translater-1.0.tar.gz (5.1 kB view hashes)

Uploaded Source

Built Distribution

yandex_translater-1.0-py2.py3-none-any.whl (3.7 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page