tessl/pypi-pygtrans
Google Translate library with support for free and API key-based translation services
—
Pending
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Pending
The risk profile of this skill
index.mddocs/
pygtrans
Google Translate library with support for both free and API key-based translation services. pygtrans provides comprehensive translation capabilities including language detection, text translation, batch processing, and text-to-speech functionality, supporting 242 source languages and 243 target languages.
Package Information
- Package Name: pygtrans
- Language: Python
- Installation:
pip install pygtrans - Version: 0.0.1
- License: GPL-3.0
Core Imports
from pygtrans import Translate, ApiKeyTranslateCommon imports for response handling:
from pygtrans import TranslateResponse, DetectResponse, LanguageResponse, NullAccess to language constants:
from pygtrans import SOURCE_LANGUAGES, TARGET_LANGUAGESBasic Usage
Free Translation Client (requires proxy)
from pygtrans import Translate
# Configure with proxy (required for non-Chinese users)
client = Translate(proxies={'https': 'http://localhost:10809'})
# Language detection
detect_result = client.detect('Hello, world!')
print(detect_result.language) # 'en'
# Single translation
result = client.translate('Hello, world!', target='zh-CN')
print(result.translatedText) # '你好世界！'
# Batch translation
results = client.translate([
'Good morning',
'How are you?'
], target='zh-CN')
for result in results:
print(result.translatedText)
# Text-to-speech
audio_data = client.tts('你好', target='zh-CN')
with open('hello.mp3', 'wb') as f:
f.write(audio_data)API Key Client (paid service)
from pygtrans import ApiKeyTranslate
# Configure with Google Cloud API key
client = ApiKeyTranslate(api_key='your-api-key-here')
# Get supported languages
languages = client.languages()
print(languages[0].language, languages[0].name) # 'en' 'English'
# Translation with automatic source detection
result = client.translate('Hello, world!', target='zh-CN')
print(result.translatedText) # '你好世界！'
print(result.detectedSourceLanguage) # 'en'
# Batch translation
results = client.translate([
'Good morning',
'How are you?'
], target='zh-CN')Architecture
pygtrans provides two main translation approaches:
- Free Translation (
Translate): Uses Google Translate web interface, requires proxy for non-Chinese users, supports basic translation and TTS - API Key Translation (
ApiKeyTranslate): Uses Google Cloud Translation API, requires valid API key, provides enterprise features and reliability
Both clients support:
- Single string and batch list processing
- Automatic language detection
- Custom source/target language specification
- Configurable timeouts and proxy settings
- Error handling through
Nullresponse objects
Capabilities
Command Line Interface
Provides a command-line interface for quick translation tasks via the pygtrans command.
def main():
"""
Command-line interface entry point for pygtrans.
Usage: pygtrans (currently provides basic CLI functionality)
"""Free Translation Client
Complete free translation functionality using Google Translate web interface. Includes language detection, text translation, batch processing, and text-to-speech capabilities. Requires proxy configuration for users outside China.
class Translate:
def __init__(
self,
target: str = "zh-CN",
source: str = "auto",
fmt="html",
user_agent: str = None,
domain: str = "com",
proxies: dict = None,
timeout: int = None,
trust_env=False
): ...
def detect(self, q: str, timeout=...) -> Union[DetectResponse, Null]: ...
def translate(
self,
q: Union[str, List[str]],
target: str = None,
source: str = None,
fmt: str = None,
timeout=...
) -> Union[TranslateResponse, List[TranslateResponse], Null]: ...
def tts(self, q: str, target: str = None, timeout=...) -> Union[bytes, Null]: ...API Key Translation Client
Enterprise translation functionality using Google Cloud Translation API. Provides reliable translation services, batch processing, language enumeration, and language detection with proper API authentication.
class ApiKeyTranslate:
def __init__(
self,
api_key: str,
target: str = "zh-CN",
source: str = None,
fmt: str = "html",
model: str = "nmt",
proxies: dict = None,
timeout=None,
trust_env=False
): ...
def languages(
self,
target: str = None,
model: str = None,
timeout=...
) -> Union[List[LanguageResponse], Null]: ...
def detect(
self,
q: Union[str, List[str]],
timeout=...
) -> Union[DetectResponse, List[DetectResponse], Null]: ...
def translate(
self,
q: Union[str, List[str]],
target: str = None,
source: str = None,
fmt: str = None,
model: str = None,
timeout=...
) -> Union[TranslateResponse, List[TranslateResponse], Null]: ...Response Objects
Data structures for handling translation results, language detection outcomes, and error responses. These objects provide structured access to translation data and metadata.
class TranslateResponse:
def __init__(
self,
translatedText: str,
detectedSourceLanguage: str = None,
model: str = None
): ...
class DetectResponse:
def __init__(
self,
language: str,
isReliable: bool = True,
confidence: float = 1.0
): ...
class LanguageResponse:
def __init__(self, language: str, name: str = None): ...
class Null:
def __init__(self, response: requests.Response): ...Language Support
Comprehensive language support with 242 source languages and 243 target languages. Includes predefined dictionaries for language code mapping and validation.
SOURCE_LANGUAGES: dict[str, str] = {
"auto": "检测语言",
"en": "英语",
"zh-CN": "中文",
# ... 239 more languages
}
TARGET_LANGUAGES: dict[str, str] = {
"en": "英语",
"zh-CN": "中文（简体）",
"zh-TW": "中文（繁体）",
# ... 240 more languages
}Types
from typing import Union, List, Dict
import requests
# Union types for method returns
TranslateResult = Union[TranslateResponse, List[TranslateResponse], Null]
DetectResult = Union[DetectResponse, List[DetectResponse], Null]
LanguageResult = Union[List[LanguageResponse], Null]
TTSResult = Union[bytes, Null]
# Input types
TextInput = Union[str, List[str]]
ProxyConfig = Dict[str, str] # e.g., {'https': 'http://localhost:10809'}