googletrans-py-async

This is an asynchronous fork of the googletrans that fix issues about detecting language and translations.

In fact, the v3.1.0a0 had problems to detect some languages like chinese traditional, and the 4.0.0rc1 had problems to translate small words like this issue

Note: I have no intention to add features or to maintain this project except for a personal use. This is a temporary solution to a temporary a problem. If you have ideas to maintain this project, your help is welcome

Changes about original one :

• This version is running asynchronously, so the translate functions are all using await
• This version supports socks and https proxies
• This version accepts 243 languages, not 107 like the original one.

Installation

PyPI

Actually I have not posted this project on pypi. The better way is to use the git install from pip

Repository

You can install the project directly from this repository.

pip install git+https://github.com/UnBonWhisky/googletrans.git

How to use

This version is actually an asynchronous version of googletrans, with some functions from the version 3.1.0a0 and some functions from the version 4.0.0rc1. I have adapted it using my knowledges so it may not be the best code you can see.

Here is an example code of how to use it :

from googletrans import Translator
import asyncio

trad = Translator()

async def main():
    translation = await trad.translate("Here is my code example", dest="fr")
    print(translation.text) # Voici mon exemple de code
    translation = await trad.detect("Un texte français")
    print(translation.lang) # fr

if __name__ == "__main__":
    asyncio.run(main())

It may have issues when using trad.detect() or trad.translate() (like json.decoder.JSONDecodeError or TypeError, so I recommand to use it like this :

try :
    translation = await trad.translate("Here is my code example", dest="fr")
    detection = await trad.detect("Un texte français")
except :
    translation = await trad.translate_to_detect("Here is my code example", dest="fr")
    detection = await trad.detect_legacy("Un texte français")

FYI

A new Exception type have been added to the library, named RateLimitError.
It raises when google redirects you to the page with "Our systems have detected unusual traffic".

Credits

Original Author - Suhun Han

Original Repository - googletrans