googletrans-curl 4.0.3__tar.gz

googletrans_curl-4.0.3/.gitignore

@@ -0,0 +1,66 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+.venv/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.testmondata
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+.DS_Store
+.python-version
+
+# IDE
+.idea
+.vscode

googletrans_curl-4.0.3/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 SuHun Han
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

googletrans_curl-4.0.3/PKG-INFO

@@ -0,0 +1,265 @@
+Metadata-Version: 2.5
+Name: googletrans-curl
+Version: 4.0.3
+Summary: A drop-in replacement for googletrans using curl-cffi to prevent HTTP 429 rate limits
+Project-URL: Homepage, https://github.com/kreier/googletrans-curl
+Project-URL: Repository, https://github.com/kreier/googletrans-curl
+Project-URL: Issues, https://github.com/kreier/googletrans-curl/issues
+Project-URL: Upstream, https://github.com/ssut/py-googletrans
+Author-email: Suhun Han <suhunhankr@gmail.com>
+Maintainer: Klaus Kreier
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Education
+Requires-Python: >=3.8
+Requires-Dist: curl-cffi>=0.7.0
+Requires-Dist: httpx[http2]>=0.27.2
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff>=0.7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# googletrans-curl
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
+[![GitHub Repo](https://img.shields.io/badge/github-kreier%2Fgoogletrans--curl-blue.svg)](https://github.com/kreier/googletrans-curl)
+
+**googletrans-curl** is a fast, drop-in replacement fork of [`googletrans`](https://github.com/ssut/py-googletrans) that integrates [`curl-cffi`](https://github.com/lexiforest/curl_cffi) to eliminate Google Translate **HTTP 429 Too Many Requests** and rate-limiting blocks via browser TLS fingerprint impersonation.
+
+---
+
+## Drop-in Replacement for googletrans
+
+The PyPI distribution package is named `googletrans-curl`, but the Python import namespace remains **`googletrans`**:
+
+```bash
+# Uninstall old package if present
+pip uninstall googletrans
+
+# Install drop-in replacement
+pip install googletrans-curl
+```
+
+Existing applications continue importing `googletrans` with **zero code modifications**:
+
+```python
+from googletrans import Translator
+```
+
+---
+
+## Why googletrans-curl?
+
+The upstream `googletrans` uses `httpx` for HTTP requests. Google Translate's web endpoints actively monitor client TLS handshakes and HTTP/2 settings, frequently rejecting automated Python HTTP clients with `HTTP 429 Too Many Requests` or `HTTP 403 Forbidden`.
+
+`googletrans-curl` solves this by introducing a flexible HTTP layer backed by `curl-cffi`. By impersonating real browser fingerprints (default: Chrome), requests match legitimate browser traffic and bypass fingerprint-based rate limiting.
+
+### Architecture
+
+```text
+                  Existing Application
+                          │
+                          │ from googletrans import Translator
+                          ▼
+                  ┌───────────────┐
+                  │  Translator   │
+                  │  Python API   │
+                  └───────┬───────┘
+                          │
+                  ┌───────▼───────┐
+                  │ HTTP Session  │
+                  │  Abstraction  │
+                  └───┬───────┬───┘
+                      │       │
+      transport="curl"│       │ transport="httpx"
+                      │       │
+                      ▼       ▼
+                  curl-cffi httpx
+                      │
+           (Chrome impersonation)
+                      │
+                      ▼
+            Google Translate Service
+```
+
+---
+
+## Features
+
+- **Drop-in Compatible**: 100% compatible with existing `googletrans` code.
+- **Anti-429 Protection**: Uses `curl-cffi` with Chrome TLS/HTTP2 impersonation.
+- **Pluggable Transports**: Switch between `curl` (anti-blocking) and standard `httpx`.
+- **Async First**: Native `async`/`await` support with async context manager.
+- **Bulk Translation**: Efficiently translate batches of text in a single request.
+- **Auto Language Detection**: Automatically detect language and confidence scores.
+- **CLI Tool Included**: Includes the command-line utility `translate`.
+- **Complete Type Annotations**: Fully typed for modern Python environments.
+
+---
+
+## Installation
+
+```bash
+pip install googletrans-curl
+```
+
+Requirements: Python 3.8 or newer.
+
+---
+
+## Quickstart
+
+### Basic Usage (Async)
+
+```python
+import asyncio
+from googletrans import Translator
+
+async def main():
+    async with Translator() as translator:
+        # Detect and translate to English (default)
+        result = await translator.translate("안녕하세요.")
+        print(result.text)  # "Hello."
+        print(result.src)   # "ko"
+
+        # Translate to Japanese
+        result = await translator.translate("안녕하세요.", dest="ja")
+        print(result.text)  # "こんにちは。"
+
+        # Specify source language
+        result = await translator.translate("veritas lux mea", src="la", dest="en")
+        print(result.text)  # "truth is my light"
+
+asyncio.run(main())
+```
+
+---
+
+## Transport Configuration
+
+By default, `Translator()` automatically uses `curl-cffi` with Chrome impersonation. You can customize the transport and browser fingerprint as needed:
+
+```python
+from googletrans import Translator
+
+# Default: automatic browser impersonation via curl-cffi
+translator = Translator()
+
+# Explicit curl transport with Safari impersonation
+translator = Translator(
+    transport="curl",
+    impersonate="safari",
+)
+
+# Standard httpx transport
+translator = Translator(
+    transport="httpx",
+)
+```
+
+Available impersonation presets for `curl-cffi` include: `"chrome"`, `"chrome110"`, `"chrome120"`, `"safari"`, `"safari15_3"`, `"safari15_5"`, `"edge99"`, `"edge101"`, etc.
+
+---
+
+## Advanced Usage
+
+### Bulk Translation
+
+Translate multiple strings in a single call:
+
+```python
+import asyncio
+from googletrans import Translator
+
+async def main():
+    async with Translator() as translator:
+        phrases = ["The quick brown fox", "jumps over", "the lazy dog"]
+        translations = await translator.translate(phrases, dest="ko")
+        for item in translations:
+            print(f"{item.origin} -> {item.text}")
+
+asyncio.run(main())
+```
+
+### Language Detection
+
+Detect the language of text with confidence scores:
+
+```python
+import asyncio
+from googletrans import Translator
+
+async def main():
+    async with Translator() as translator:
+        detection = await translator.detect("이 문장은 한글로 쓰여졌습니다.")
+        print(detection.lang)        # "ko"
+        print(detection.confidence)  # 0.27...
+
+asyncio.run(main())
+```
+
+### Custom Service URLs
+
+Use alternate Google Translate service endpoints:
+
+```python
+# Rotate across multiple domains
+translator = Translator(service_urls=[
+    "translate.google.com",
+    "translate.google.co.kr",
+])
+
+# Direct client API (no token acquirer needed)
+translator = Translator(service_urls=[
+    "translate.googleapis.com",
+])
+```
+
+---
+
+## Command-Line Tool
+
+`googletrans-curl` includes the `translate` CLI command:
+
+```bash
+# Translate text to English (default)
+translate "veritas lux mea" -s la -d en
+
+# Translate text to Korean
+translate "Hello world" -d ko
+
+# Detect language
+translate -c "안녕하세요."
+```
+
+---
+
+## Unofficial API Disclaimer
+
+> [!WARNING]
+> This library uses Google Translate's unofficial web endpoints (`translate.google.com`).
+> - While `curl-cffi` impersonation drastically reduces 429 blocks, Google may modify web endpoints at any time.
+> - Maximum character limit per single request is approximately 15,000 characters.
+> - For mission-critical production environments requiring guaranteed SLAs, please use [Google Cloud Translation API](https://cloud.google.com/translate/docs).
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+Upstream copyright (c) 2015 SuHun Han. Modifications copyright (c) 2026 Klaus Kreier and contributors.

googletrans_curl-4.0.3/README.md

@@ -0,0 +1,230 @@
+# googletrans-curl
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
+[![GitHub Repo](https://img.shields.io/badge/github-kreier%2Fgoogletrans--curl-blue.svg)](https://github.com/kreier/googletrans-curl)
+
+**googletrans-curl** is a fast, drop-in replacement fork of [`googletrans`](https://github.com/ssut/py-googletrans) that integrates [`curl-cffi`](https://github.com/lexiforest/curl_cffi) to eliminate Google Translate **HTTP 429 Too Many Requests** and rate-limiting blocks via browser TLS fingerprint impersonation.
+
+---
+
+## Drop-in Replacement for googletrans
+
+The PyPI distribution package is named `googletrans-curl`, but the Python import namespace remains **`googletrans`**:
+
+```bash
+# Uninstall old package if present
+pip uninstall googletrans
+
+# Install drop-in replacement
+pip install googletrans-curl
+```
+
+Existing applications continue importing `googletrans` with **zero code modifications**:
+
+```python
+from googletrans import Translator
+```
+
+---
+
+## Why googletrans-curl?
+
+The upstream `googletrans` uses `httpx` for HTTP requests. Google Translate's web endpoints actively monitor client TLS handshakes and HTTP/2 settings, frequently rejecting automated Python HTTP clients with `HTTP 429 Too Many Requests` or `HTTP 403 Forbidden`.
+
+`googletrans-curl` solves this by introducing a flexible HTTP layer backed by `curl-cffi`. By impersonating real browser fingerprints (default: Chrome), requests match legitimate browser traffic and bypass fingerprint-based rate limiting.
+
+### Architecture
+
+```text
+                  Existing Application
+                          │
+                          │ from googletrans import Translator
+                          ▼
+                  ┌───────────────┐
+                  │  Translator   │
+                  │  Python API   │
+                  └───────┬───────┘
+                          │
+                  ┌───────▼───────┐
+                  │ HTTP Session  │
+                  │  Abstraction  │
+                  └───┬───────┬───┘
+                      │       │
+      transport="curl"│       │ transport="httpx"
+                      │       │
+                      ▼       ▼
+                  curl-cffi httpx
+                      │
+           (Chrome impersonation)
+                      │
+                      ▼
+            Google Translate Service
+```
+
+---
+
+## Features
+
+- **Drop-in Compatible**: 100% compatible with existing `googletrans` code.
+- **Anti-429 Protection**: Uses `curl-cffi` with Chrome TLS/HTTP2 impersonation.
+- **Pluggable Transports**: Switch between `curl` (anti-blocking) and standard `httpx`.
+- **Async First**: Native `async`/`await` support with async context manager.
+- **Bulk Translation**: Efficiently translate batches of text in a single request.
+- **Auto Language Detection**: Automatically detect language and confidence scores.
+- **CLI Tool Included**: Includes the command-line utility `translate`.
+- **Complete Type Annotations**: Fully typed for modern Python environments.
+
+---
+
+## Installation
+
+```bash
+pip install googletrans-curl
+```
+
+Requirements: Python 3.8 or newer.
+
+---
+
+## Quickstart
+
+### Basic Usage (Async)
+
+```python
+import asyncio
+from googletrans import Translator
+
+async def main():
+    async with Translator() as translator:
+        # Detect and translate to English (default)
+        result = await translator.translate("안녕하세요.")
+        print(result.text)  # "Hello."
+        print(result.src)   # "ko"
+
+        # Translate to Japanese
+        result = await translator.translate("안녕하세요.", dest="ja")
+        print(result.text)  # "こんにちは。"
+
+        # Specify source language
+        result = await translator.translate("veritas lux mea", src="la", dest="en")
+        print(result.text)  # "truth is my light"
+
+asyncio.run(main())
+```
+
+---
+
+## Transport Configuration
+
+By default, `Translator()` automatically uses `curl-cffi` with Chrome impersonation. You can customize the transport and browser fingerprint as needed:
+
+```python
+from googletrans import Translator
+
+# Default: automatic browser impersonation via curl-cffi
+translator = Translator()
+
+# Explicit curl transport with Safari impersonation
+translator = Translator(
+    transport="curl",
+    impersonate="safari",
+)
+
+# Standard httpx transport
+translator = Translator(
+    transport="httpx",
+)
+```
+
+Available impersonation presets for `curl-cffi` include: `"chrome"`, `"chrome110"`, `"chrome120"`, `"safari"`, `"safari15_3"`, `"safari15_5"`, `"edge99"`, `"edge101"`, etc.
+
+---
+
+## Advanced Usage
+
+### Bulk Translation
+
+Translate multiple strings in a single call:
+
+```python
+import asyncio
+from googletrans import Translator
+
+async def main():
+    async with Translator() as translator:
+        phrases = ["The quick brown fox", "jumps over", "the lazy dog"]
+        translations = await translator.translate(phrases, dest="ko")
+        for item in translations:
+            print(f"{item.origin} -> {item.text}")
+
+asyncio.run(main())
+```
+
+### Language Detection
+
+Detect the language of text with confidence scores:
+
+```python
+import asyncio
+from googletrans import Translator
+
+async def main():
+    async with Translator() as translator:
+        detection = await translator.detect("이 문장은 한글로 쓰여졌습니다.")
+        print(detection.lang)        # "ko"
+        print(detection.confidence)  # 0.27...
+
+asyncio.run(main())
+```
+
+### Custom Service URLs
+
+Use alternate Google Translate service endpoints:
+
+```python
+# Rotate across multiple domains
+translator = Translator(service_urls=[
+    "translate.google.com",
+    "translate.google.co.kr",
+])
+
+# Direct client API (no token acquirer needed)
+translator = Translator(service_urls=[
+    "translate.googleapis.com",
+])
+```
+
+---
+
+## Command-Line Tool
+
+`googletrans-curl` includes the `translate` CLI command:
+
+```bash
+# Translate text to English (default)
+translate "veritas lux mea" -s la -d en
+
+# Translate text to Korean
+translate "Hello world" -d ko
+
+# Detect language
+translate -c "안녕하세요."
+```
+
+---
+
+## Unofficial API Disclaimer
+
+> [!WARNING]
+> This library uses Google Translate's unofficial web endpoints (`translate.google.com`).
+> - While `curl-cffi` impersonation drastically reduces 429 blocks, Google may modify web endpoints at any time.
+> - Maximum character limit per single request is approximately 15,000 characters.
+> - For mission-critical production environments requiring guaranteed SLAs, please use [Google Cloud Translation API](https://cloud.google.com/translate/docs).
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+Upstream copyright (c) 2015 SuHun Han. Modifications copyright (c) 2026 Klaus Kreier and contributors.

googletrans_curl-4.0.3/googletrans/__init__.py

@@ -0,0 +1,8 @@
+"""Free Google Translate API for Python. Translates totally free of charge."""
+
+__all__ = ("Translator",)
+__version__ = "4.0.3"
+
+
+from googletrans.client import Translator
+from googletrans.constants import LANGCODES, LANGUAGES  # noqa

googletrans_curl-4.0.3/googletrans/cli.py

@@ -0,0 +1,48 @@
+import argparse
+import asyncio
+import sys
+
+from googletrans.client import Translator
+
+
+async def _run_cli(args: argparse.Namespace) -> None:
+    async with Translator() as translator:
+        if args.detect:
+            result = await translator.detect(args.text)
+            print(f"[{result.lang}, {result.confidence}] {args.text}")
+            return
+
+        result = await translator.translate(args.text, dest=args.dest, src=args.src)
+        output = f"""[{result.src}] {result.origin}
+    ->
+[{result.dest}] {result.text}
+[pron.] {result.pronunciation}"""
+        print(output)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="Python Google Translator as a command-line tool"
+    )
+    parser.add_argument("text", help="The text you want to translate.")
+    parser.add_argument(
+        "-d",
+        "--dest",
+        default="en",
+        help="The destination language you want to translate. (Default: en)",
+    )
+    parser.add_argument(
+        "-s",
+        "--src",
+        default="auto",
+        help="The source language you want to translate. (Default: auto)",
+    )
+    parser.add_argument(
+        "-c", "--detect", action="store_true", default=False, help="Detect language"
+    )
+    args = parser.parse_args()
+    asyncio.run(_run_cli(args))
+
+
+if __name__ == "__main__":
+    main()