kortirso / yandex_translator

Elixir package for interaction with Yandex.Translate API

YandexTranslator

A simple Elixir interface to Yandex Translate's translation API

Installation

If available in Hex, the package can be installed by adding yandex_translator to your list of dependencies in mix.exs:

def deps do
  [
    {:yandex_translator, "~> 0.9.6"}
  ]
end

Get access to API

Getting a Cloud Key and Folder ID (for cloud API)

To sign up go here

Getting a Subscription Key (for old API)

To sign up go here

Configuration

The default behaviour is to configure using the application environment:

In config/config.exs, add:

  # for configuring access to cloud api
  config :yandex_translator, cloud_api_key: "API_KEY"
  config :yandex_translator, cloud_folder_id: "FOLDER_ID"

  # for configuring access to old api
  config :yandex_translator, api_key: "API_KEY"

Usage

Get IAM-token for cloud API access

Request for getting IAM-token for access to cloud API.

  # without params
  YandexTranslator.get_iam_token

  # or with key
  YandexTranslator.get_iam_token([key: "API_KEY"])

Options

key - API KEY, required or optional (if presented in configuration)

Supported languages

Request for getting list of supported languages is #langs. For using cloud api options must contain iam_token param.

  # cloud api request
  YandexTranslator.langs([iam_token: ""])

  # old api request
  YandexTranslator.langs([])

Options for cloud api

iam_token - IAM-token, required
folder_id - folder ID of your account at Yandex.Cloud, required or optional (if presented in configuration)

Options for old api

key - access key, required or optional (if presented in config)
format - one of the [xml|json], default - xml, optional
ui - language code for getting language translations, optional, example - "en"

Detection

Request for detecting language of text is #detect. For using cloud api options must contain iam_token param.

  # cloud api request
  YandexTranslator.detect([iam_token: "", text: "Hello"])

  # old api request
  YandexTranslator.detect([text: "Hello"])

Options for cloud api

iam_token - IAM-token, required
folder_id - folder ID of your account at Yandex.Cloud, required or optional (if presented in configuration)
text - text for detection, required
hint - list of possible languages, optional, example - "en,ru"

Options for old api

key - access key, required or optional (if presented in config)
format - one of the [xml|json], default - xml, optional
text - text, required
hint - list of possible languages, optional, example - "en,ru"

Translation

Request for translating text is #translate. For using cloud api options must contain iam_token param.

  # cloud api request
  YandexTranslator.translate([iam_token: "", text: "Hello", target: "ru"])

  # old api request
  YandexTranslator.translate([text: "Hello", lang: "en-ru"])

Options for cloud api

iam_token - IAM-token, required
folder_id - folder ID of your account at Yandex.Cloud, required or optional (if presented in configuration)
text - text for detection, required
source - source language, ISO 639-1 format (like "en"), optional
target - target language, ISO 639-1 format (like "ru"), required
format - text format, one of the [plain|html], default - plain, optional

Options for old api

key - access key, required or optional (if presented in config)
format - one of the [xml|json], default - xml, optional
text - text, required
lang - direction of translation, required, example - "from-to" or "to"

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/kortirso/yandex_translator.

License

The gem is available as open source under the terms of the MIT License.

Disclaimer

Use this package at your own peril and risk.

Documentation

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/yandex_translator.