| =============== | |
| deep_translator | |
| =============== | |
| .. image:: https://img.shields.io/pypi/v/deep_translator.svg | |
| :target: https://pypi.python.org/pypi/deep_translator | |
| .. image:: https://img.shields.io/travis/nidhaloff/deep_translator.svg | |
| :target: https://travis-ci.com/nidhaloff/deep_translator | |
| .. image:: https://readthedocs.org/projects/deep-translator/badge/?version=latest | |
| :target: https://deep-translator.readthedocs.io/en/latest/?badge=latest | |
| :alt: Documentation Status | |
| A flexible python tool to translate between different languages in a simple way. | |
| * Free software: MIT license | |
| * Documentation: https://deep-translator.readthedocs.io. | |
| Motivation | |
| ----------- | |
| I needed to translate a text using python. It was hard to find a simple way to do it. | |
| There are other libraries that can be used for this task, but somehow,most of them | |
| are buggy, not supported anymore or complex. | |
| Therefore, I decided to build this simple tool, it is clean and easy to use and provide | |
| support for all languages since it uses google translate under the hood. | |
| More features are coming soon, mainly support for the PONS translator and others. | |
| Basically, my goal is to integrate support for multiple famous translators | |
| in this tool starting with google translate | |
| Features | |
| -------- | |
| * deep-translator uses google translate to translate a text. Therefore, all languages are supported | |
| * TODO: add support for the PONS translator (pons.com) | |
| Usage | |
| ===== | |
| To use deep_translator in a project:: | |
| from deep_translator import GoogleTranslator | |
| english_text = 'happy coding' | |
| # first create a GoogleTranslator object with source and target language | |
| # then use the translate function to translate a text. | |
| # All language are supported. Basic example: | |
| result_german = GoogleTranslator(source='auto', target='de').translate(payload=english_text) | |
| # Alternatively, you can pass languages by their name: | |
| result_german = GoogleTranslator(source='english', target='german').translate(payload=english_text) | |
| # soon also support for the PONS translator. Take a look in the examples folder for more :) | |