You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
93 lines
2.8 KiB
93 lines
2.8 KiB
|
|
import requests
|
|
from .constants import BASE_URLS, QCRI_LANGUAGE_TO_CODE
|
|
from .exceptions import (ServerException, TranslationNotFound)
|
|
|
|
|
|
class QCRI(object):
|
|
"""
|
|
class that wraps functions, which use the QRCI translator under the hood to translate word(s)
|
|
"""
|
|
|
|
def __init__(self, api_key=None, source="en", target="en", **kwargs):
|
|
"""
|
|
@param api_key: your qrci api key. Get one for free here https://mt.qcri.org/api/v1/ref
|
|
"""
|
|
|
|
if not api_key:
|
|
raise ServerException(401)
|
|
self.__base_url = BASE_URLS.get("QCRI")
|
|
self.source = source
|
|
self.target = target
|
|
self.api_key = api_key
|
|
self.api_endpoints = {
|
|
"get_languages": "getLanguagePairs",
|
|
"get_domains": "getDomains",
|
|
"translate": "translate",
|
|
}
|
|
|
|
self.params = {
|
|
"key": self.api_key
|
|
}
|
|
|
|
def _get(self, endpoint, params=None, return_text=True):
|
|
if not params:
|
|
params = self.params
|
|
try:
|
|
res = requests.get(self.__base_url.format(endpoint=self.api_endpoints[endpoint]), params=params)
|
|
return res.text if return_text else res
|
|
except Exception as e:
|
|
raise e
|
|
|
|
@staticmethod
|
|
def get_supported_languages(as_dict=False, **kwargs):
|
|
# Have no use for this as the format is not what we need
|
|
# Save this for whenever
|
|
# pairs = self._get("get_languages")
|
|
# Using a this one instead
|
|
return [*QCRI_LANGUAGE_TO_CODE.keys()] if not as_dict else QCRI_LANGUAGE_TO_CODE
|
|
|
|
@property
|
|
def languages(self):
|
|
return self.get_supported_languages()
|
|
|
|
def get_domains(self):
|
|
domains = self._get("get_domains")
|
|
return domains
|
|
|
|
@property
|
|
def domains(self):
|
|
return self.get_domains()
|
|
|
|
def translate(self, text, domain, **kwargs):
|
|
params = {
|
|
"key": self.api_key,
|
|
"langpair": "{}-{}".format(self.source, self.target),
|
|
"domain": domain,
|
|
"text": text
|
|
}
|
|
try:
|
|
response = self._get("translate", params=params, return_text=False)
|
|
except ConnectionError:
|
|
raise ServerException(503)
|
|
|
|
else:
|
|
if response.status_code != 200:
|
|
ServerException(response.status_code)
|
|
else:
|
|
res = response.json()
|
|
translation = res.get("translatedText")
|
|
if not translation:
|
|
raise TranslationNotFound(text)
|
|
return translation
|
|
|
|
def translate_batch(self, batch, domain, **kwargs):
|
|
"""
|
|
translate a batch of texts
|
|
@domain: domain
|
|
@param batch: list of texts to translate
|
|
@return: list of translations
|
|
"""
|
|
return [self.translate(domain, text, **kwargs) for text in batch]
|
|
|