mirror of https://github.com/morpheus65535/bazarr
132 lines
5.0 KiB
Python
132 lines
5.0 KiB
Python
"""
|
|
linguee translator API
|
|
"""
|
|
|
|
from .constants import BASE_URLS, LINGUEE_LANGUAGES_TO_CODES, LINGUEE_CODE_TO_LANGUAGE
|
|
from .exceptions import (LanguageNotSupportedException,
|
|
TranslationNotFound,
|
|
NotValidPayload,
|
|
ElementNotFoundInGetRequest,
|
|
RequestError,
|
|
TooManyRequests)
|
|
from .parent import BaseTranslator
|
|
from bs4 import BeautifulSoup
|
|
import requests
|
|
from requests.utils import requote_uri
|
|
|
|
|
|
class LingueeTranslator(BaseTranslator):
|
|
"""
|
|
class that wraps functions, which use the linguee translator under the hood to translate word(s)
|
|
"""
|
|
_languages = LINGUEE_LANGUAGES_TO_CODES
|
|
supported_languages = list(_languages.keys())
|
|
|
|
def __init__(self, source, target="en", proxies=None, **kwargs):
|
|
"""
|
|
@param source: source language to translate from
|
|
@param target: target language to translate to
|
|
"""
|
|
self.__base_url = BASE_URLS.get("LINGUEE")
|
|
self.proxies = proxies
|
|
|
|
if self.is_language_supported(source, target):
|
|
self._source, self._target = self._map_language_to_code(source.lower(), target.lower())
|
|
|
|
super().__init__(base_url=self.__base_url,
|
|
source=self._source,
|
|
target=self._target,
|
|
element_tag='a',
|
|
element_query={'class': 'dictLink featured'},
|
|
payload_key=None, # key of text in the url
|
|
)
|
|
|
|
@staticmethod
|
|
def get_supported_languages(as_dict=False, **kwargs):
|
|
"""
|
|
return the supported languages by the linguee translator
|
|
@param as_dict: if True, the languages will be returned as a dictionary mapping languages to their abbreviations
|
|
@return: list or dict
|
|
"""
|
|
return LingueeTranslator.supported_languages if not as_dict else LingueeTranslator._languages
|
|
|
|
def _map_language_to_code(self, *languages, **kwargs):
|
|
"""
|
|
map language to its corresponding code (abbreviation) if the language was passed by its full name by the user
|
|
@param languages: list of languages
|
|
@return: mapped value of the language or raise an exception if the language is not supported
|
|
"""
|
|
for language in languages:
|
|
if language in self._languages.values():
|
|
yield LINGUEE_CODE_TO_LANGUAGE[language]
|
|
elif language in self._languages.keys():
|
|
yield language
|
|
else:
|
|
raise LanguageNotSupportedException(language)
|
|
|
|
def is_language_supported(self, *languages, **kwargs):
|
|
"""
|
|
check if the language is supported by the translator
|
|
@param languages: list of languages
|
|
@return: bool or raise an Exception
|
|
"""
|
|
for lang in languages:
|
|
if lang not in self._languages.keys():
|
|
if lang not in self._languages.values():
|
|
raise LanguageNotSupportedException(lang)
|
|
return True
|
|
|
|
def translate(self, word, return_all=False, **kwargs):
|
|
"""
|
|
function that uses linguee to translate a word
|
|
@param word: word to translate
|
|
@type word: str
|
|
@param return_all: set to True to return all synonym of the translated word
|
|
@type return_all: bool
|
|
@return: str: translated word
|
|
"""
|
|
if self._validate_payload(word, max_chars=50):
|
|
# %s-%s/translation/%s.html
|
|
url = "{}{}-{}/translation/{}.html".format(self.__base_url, self._source, self._target, word)
|
|
url = requote_uri(url)
|
|
response = requests.get(url, proxies=self.proxies)
|
|
|
|
if response.status_code == 429:
|
|
raise TooManyRequests()
|
|
|
|
if response.status_code != 200:
|
|
raise RequestError()
|
|
soup = BeautifulSoup(response.text, 'html.parser')
|
|
elements = soup.find_all(self._element_tag, self._element_query)
|
|
if not elements:
|
|
raise ElementNotFoundInGetRequest(elements)
|
|
|
|
filtered_elements = []
|
|
for el in elements:
|
|
try:
|
|
pronoun = el.find('span', {'class': 'placeholder'}).get_text(strip=True)
|
|
except AttributeError:
|
|
pronoun = ''
|
|
filtered_elements.append(el.get_text(strip=True).replace(pronoun, ''))
|
|
|
|
if not filtered_elements:
|
|
raise TranslationNotFound(word)
|
|
|
|
return filtered_elements if return_all else filtered_elements[0]
|
|
|
|
def translate_words(self, words, **kwargs):
|
|
"""
|
|
translate a batch of words together by providing them in a list
|
|
@param words: list of words you want to translate
|
|
@param kwargs: additional args
|
|
@return: list of translated words
|
|
"""
|
|
if not words:
|
|
raise NotValidPayload(words)
|
|
|
|
translated_words = []
|
|
for word in words:
|
|
translated_words.append(self.translate(word=word, **kwargs))
|
|
return translated_words
|
|
|