API for Yandex Translate
Project description
- 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.
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
Built Distribution
Hashes for yandex_translater-1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4ff912f0d05d7b8a21eff50d03619aaff0843b7f779a7629ee0b86f70b1b4ac3 |
|
MD5 | 1ff71e4f8fd9504628f576a255af3bd0 |
|
BLAKE2b-256 | 3196e56c441059c6f1192d635d285478d6922157c83d1e3ae82ad729ad7d4829 |