mtr_go

Mtr-go

Multi language translator api wrapper in Go, translate or compare strings or arrays of strings with language pairs supported by multiple services.

Install

Download the bin from the release page.

Or get the package

go get github.com/untoreh/mtr-go

Usage

The binary has no flags atm, so just run it

./mtr

Client

GET / request:

// query params
sl=sourceLanguage
tl=targetLanguage
q=textToTranslate
sv=serviceToUse

response:

"translatedText"

POST / request:

// query params
sl=sourceLanguage
tl=targetLanguage
sv=serviceToUse

// body json encoded
{"index": "textToTranslate"}

response:

"translatedText"

POST /multi request (one source language to multiple target languages):

http
// query params
sl=sourceLanguage
sv=serviceToUse

// body json encoded
{
    "mtl": [ "targetLanguage1", "targetLanguage2", ... ],
    "text": "textToTranslate"
}

response:

{
  "targetLanguage1" : "translatedText1"
  "targetLanguage2" : "translatedText2"
  ...
}

Package

For using directly into code

Pass source/target language and a string or array of strings

import "github.com/untoreh/mtr-go"
m := mtr_go.New(nil)

m.Tr("en", "fr", "the fox hides quickly", nil)
// returns : Le renard se cache rapidement

Map keys are preserved.

List of base usable language codes, the priority is to google codes which means if you want to translate chinese you should use zh-TW or zh-CN

m.SupLangs()
// returns : [ "en", "fr", ... ]

Choose which services to use

m.Tr("en", "fr", "the fox hides quickly", {"google", "bing"});

Add a weight to it to specify how many times a service should be chosen over the others

m.Tr("en", "fr", "the fox hides quickly", {"google" : 50, "bing" : 5})

Custom http options

m := new(mtr_go.New( {"httpClient" : http.Client{}})

Api keys

m = new Mtr({"systran_key" : key});

Conventions

• It is recommended to not rely on the translation to return consistent punctuation, therefore input text should be as atomic as possible.
• Some services arbitrarily encode/decode html or even add html tags themselves, such aggressive services have active decoding before the output.

Notes

• Requests are limited to 1000~ chars, strings and arrays get split or merged up to this size to try to make uniform requests.
• All the parts of a request are run concurrently, pools are not used (yet).
• Default services weight is 30 for google, bing, yandex and 10 for the rest.
• Cached keys start with mtr_
• Because services may be fickle, they will be dropped as they go down or block access.
• Not all services supports all the languages, the group of services used is transparently trimmed to the ones that support the requested language pair.

TODO/Improvements

In the issues

Credits

• Stichoza/google-translate-php - google token generator
• leodido/langcode-conv - base for the language code converter