theastroscout/linguin-api-py

This is the official Python client library for Linguin, a paid online service that offers a multilingual dictionary, a reverse dictionary, text translation, and bulk translation for app interfaces. Rather than making raw web requests to Linguin's API yourself, you install this package and call a few simple Python functions to get the same results. The dictionary lookup can look up a word or phrase in any language, and you can choose between a fast mode that just gives you the definition or a deep mode that also returns pronunciation, example sentences, synonyms, word origin, and category information. There is also a reverse dictionary: instead of typing a word, you describe what you mean, like "a doctor for animals," and it returns the words that fit, such as "veterinarian." For translation, a fast mode gives a quick pass while a deep mode pays attention to context, idiom, and tone. There is an option to cross check the wording against how people currently use the language online, and another option that rewrites the output so it reads more naturally. For apps that need many short strings translated at once, like button labels or error messages, there is a bulk localize function that takes a list of strings and returns the same list translated, in the same order, so it lines up with your original keys. Some requests can take a while to process, so the library supports an optional webhook: instead of waiting for the response, you get an immediate ticket ID and Linguin sends the result to your own server when it is ready, or you can poll for it later using that ID. Using the library requires an API key from Linguin's website, since it is a paid, per word or per call service, though checking your account balance and usage reports does not cost anything. Errors from the API raise a Python exception with a specific error code you can check, like whether a word was not found or you were rate limited. The library has no external dependencies and requires Python 3.8 or newer. It is licensed under MIT, which allows free use including commercial use.