Skip to content

OliMations/MicroTranslator

Repository files navigation

GitHub release (latest by date) PyPI GitHub file size in bytes PyPI - Python Version PyPI - Downloads Total Downloads

Microsoft Translate Wrapper

A lightweight, simple Python wrapper for the Microsoft (Bing) Translation API that does the API call and returns the raw, unmanipulated result.

Why Should I Use This?

It saves you time whilst adding no more code to your project than necessary

Installation

Just run pip install MicroTranslator in your command prompt of choice (e.g. Windows CMD or Powershell)

Setup

from microtranslator import Translator

tr = Translator(client_key="key")

Translate

tr.translate("Hello World!", "de")
# [{'detectedLanguage': {'language': 'en', 'score': 1.0}, 'translations': [{'text': 'Hallo Welt!', 'to': 'de'}]}]

Detect

tr.detect("Hallo Welt!")
#[{'language': 'de', 'score': 1.0, 'isTranslationSupported': True, 'isTransliterationSupported': False}]

Dictionary

tr.dictionary("test", "it", "en")
# text, to lang, from lang

# [{'normalizedTarget': 'fuoco', 'displayTarget': 'fuoco', 'posTag': 'OTHER', 'confidence': 0.8043, 'prefixWord': '', 'backTranslations': 
#   [{'normalizedText': 'fire', 'displayText': 'fire', 'numExamples': 1, 'frequencyCount': 33741}, 
#    {'normalizedText': 'firing', 'displayText': 'firing', 'numExamples': 0, 'frequencyCount': 559}
#   ]
# }]
# etc...

Languages

tr.languages()

# {'af': {'name': 'Afrikaans', 'nativeName': 'Afrikaans', 'dir': 'ltr'}, 
#   'am': {'name': 'Amharic', 'nativeName': 'አማርኛ', 'dir': 'ltr'}}
# etc...

See it in the wild

View my discord bot which uses this exact package for all the free translations!

Have something to contribute?

Go ahead and make a pull request! I should always be around to review them!

Issues?

Make an issue! Try to add as much detail as possible, including screenshots and tracebacks are super useful