Bing Translator, Microsoft Translator
A simple Elixir interface to Azure's translation API
Installation
If available in Hex, the package can be installed as:
Add bing_translator to your list of dependencies in mix.exs:
def deps do
[{:bing_translator, "~> 1.0"}]
end
Ensure bing_translator is started before your application:
def application do
[applications: [:bing_translator]]
end
Getting a Subscription Key
To sign up for the free tier (as of this writing), do the following:
Usage
spanish = BingTranslator.translate("Hello. This will be translated!", [from: "en", to: "es"])
# without :from for auto language detection
spanish = BingTranslator.translate("Hello. This will be translated!", to: "es")
locale = BingTranslator.detect("Hello. This will be translated!") # => "en"
languages = BingTranslator.supported_language_codes # => ["ar", "bs-Latn", "bg", "ca", "zh-CHS",,,,,]
# The speak method calls a text-to-speech interface in the supplied language.
# It does not translate the text. Format can be 'audio/mp3' or 'audio/wav'
audio = BingTranslator.speak("Hello. This will be spoken!", language: :en, format: "audio/mp3", options: "MaxQuality")
Configuration
The default behaviour is to configure using the application environment:
In config/config.exs, add:
config :bing_translator,
subscription_key: "Your-Subscription-Key",
http_client_options: [] # [ssl: [{:versions, [:"tlsv1.2"]}]]