reverso_context_api

Simple Python API for Reverso Context

Installation

pip install reverso-context-api

Entry point

All operations are implemented in class Client.

from reverso_context_api import Client

It takes source and target languages ("de"/"en"/"ru"/etc) as required arguments. They will be used as defaults, but you can set another pair for each operation.

client = Client("de", "en")

Also you can pass login credentials to be able to work with your favorites:

client = Client("en", "ru", credentials=("email", "password"))

Supported features

• Getting translations:
  

  >>> list(client.get_translations("braucht"))
  ['needed', 'required', 'need', 'takes', 'requires', 'take', 'necessary'...]

• Getting translation samples (context):
  

  >>> client = Client("en", "ru")
  >>> for context in client.get_translation_samples("shenanigans", cleanup=True):
  ...     print(context)
  ("The simple fact is the city is going broke cleaning up after Homer's drunken shenanigans...", 
  "Простой факт: город разорится, восстанавливаясь после пьяных проделок Гомера...")
  ("You need a 12-step program for shenanigans addicts.", 
  "Тебе нужно пройти 12-ти ступенчатую программу зависимости от проделок.")

• Getting search suggestions:
  

  >>> list(Client("de", "en").get_search_suggestions("bew")))
  ['Bewertung', 'Bewegung', 'bewegen', 'bewegt', 'bewusst', 'bewirkt', 'bewertet'...]

• Getting your saved favorites (you'll have to pass login credentials):

  >>> client = Client("en", "de", credentials=("email", "password"))
  >>> next(client.get_favorites())
  {'source_lang': 'de', 'source_text': 'imstande', 'source_context': 'Ich würde lachen, doch ich bin biologisch nicht imstande dazu.', 
  'target_lang': 'ru', 'target_text': 'способен', 'target_context': 'Я бы посмеялся, но мой вид на это не способен.'}

All the methods return iterators (to hide paging and to not request more results than needed)