googletrans

To use the Solar theme in a Sphinx project, follow these steps:

1. Download and extract the theme archive.
2. Locate your Sphinx project's conf.py file.
3. Set the html_theme parameter to 'solar'.
4. Set the html_theme_path parameter to the absolute or relative path of the directory containing the extracted Solar theme files.

To install the library, use pip to install the googletrans package. It is compatible with Python 3.8+.

$ pip install googletrans

You can provide a list of service_urls to the Translator constructor. If multiple URLs are provided, the library randomly chooses one. You can also point to translate.googleapis.com to use the direct API instead of the webapp-based service, which may help avoid unstable token issues.

from googletrans import Translator

# Use multiple domains (randomly selected)
translator = Translator(service_urls=[
    'translate.google.com',
    'translate.google.co.kr',
])

# Use direct Google API domain to avoid token issues
translator = Translator(service_urls=[
    'translate.googleapis.com'
])

Limitations

• Character Limit: The maximum character limit for a single text is 15,000.
• Stability: This library uses the Google Translate Ajax API (web version), which does not guarantee 100% stability. For production-critical applications, use the official Google Cloud Translation API.
• IP Bans: If you encounter HTTP 5xx errors or specific error codes like #6, your client IP address may have been temporarily banned by Google.

Limitations

• Character Limit: The maximum character limit for a single text request is 15,000 characters.
• Stability: This is an unofficial library using the Google Translate web API. It does not guarantee stability and is not associated with Google.

Troubleshooting

• IP Bans: If you encounter HTTP 5xx errors or specific error codes (like #6), your client IP address may have been banned by Google. For stable production use, it is highly recommended to use the official Google Cloud Translation API.

The detect method identifies the language used in a given string and returns a Detected object containing the language code and confidence level.

import asyncio
from googletrans import Translator

async def detect_languages():
    async with Translator() as translator:
        result = await translator.detect('이 문장은 한글로 쓰여졌습니다.')
        print(result)  # <Detected lang=ko confidence=0.27041003>

asyncio.run(detect_languages())

You can pass a list of strings to the translate method to translate a batch of strings in a single method call and a single HTTP session.

import asyncio
from googletrans import Translator

async def translate_bulk():
    async with Translator() as translator:
        translations = await translator.translate(['The quick brown fox', 'jumps over', 'the lazy dog'], dest='ko')
        for translation in translations:
            print(translation.origin, ' -> ', translation.text)

asyncio.run(translate_bulk())

The library uses httpx and supports HTTP/2 by default. You can verify the HTTP version of a response by accessing the ._response.http_version attribute on the Translated or Detected object.

>>> translator.translate('테스트')._response.http_version
# 'HTTP/2'