PolyglotX

Advanced Multilingual Exception Handler for Python

PolyglotX translates Python exceptions and error messages into 11+ languages in real-time. Whether you're debugging in Arabic, Turkish, Japanese, or any supported language, PolyglotX makes Python errors understandable in your native language.

Key Features

• Real-Time Translation - Automatically translates ANY Python error to your preferred language
• 11+ Languages - Full support for Arabic, Turkish, Japanese, Chinese, Kurdish, Spanish, Hindi, French, Russian, German, Portuguese
• Universal Error Handling - Handles all Python exceptions, not just predefined ones
• Multiple Translation Engines - Google Translate, MyMemory, LibreTranslate with automatic fallback
• Smart Caching - 90%+ cache hit rate for improved performance
• Thread-Safe - Built for multi-threaded applications
• Async Compatible - Works with async/await code
• Production Ready - 100% test coverage, thoroughly tested

Installation

From PyPI

pip install PolyglotX

From GitHub

git clone https://github.com/6x-u/polyglotx.git
cd polyglotx
pip install -e .

Supports Python 3.6+

Quick Start

Arabic (العربية)

from PolyglotX import arbe

x = undefined_variable

Output:

خطأ في الاسم: name 'undefined_variable' is not defined

MERO tele QP4RM

Turkish (Türkçe)

from PolyglotX import tr

result = 10 / 0

Output:

Sıfıra Bölme Hatası: division by zero

MERO tele QP4RM

Japanese (日本語)

from PolyglotX import ja

my_list = [1, 2, 3]
value = my_list[10]

All Supported Languages

from PolyglotX import arbe, tr, ja, zh, ku, es, hi, fr, ru, de, pt

Supported Languages

Language	Code	Native Name	Import
Arabic	ar	العربية	from PolyglotX import arbe
Turkish	tr	Türkçe	from PolyglotX import tr
Japanese	ja	日本語	from PolyglotX import ja
Chinese	zh	中文	from PolyglotX import zh
Kurdish	ku	کوردی	from PolyglotX import ku
Spanish	es	Español	from PolyglotX import es
Hindi	hi	हिन्दी	from PolyglotX import hi
French	fr	Français	from PolyglotX import fr
Russian	ru	Русский	from PolyglotX import ru
German	de	Deutsch	from PolyglotX import de
Portuguese	pt	Português	from PolyglotX import pt

Advanced Usage

Custom Exception Handler

from PolyglotX.core.exception_handler import ExceptionHandler

handler = ExceptionHandler(
    language='ar',
    show_credits=True,
    auto_exit=True
)
handler.install()

your_code_here()

Direct Translation

from PolyglotX.core.translator import Translator

translator = Translator(target_language='ar')
translated = translator.translate("TypeError: unsupported operand type")
print(translated)

Using Decorators

from PolyglotX.utils.decorators import handle_exceptions, translate_errors

@handle_exceptions(language='ar')
def my_function():
    risky_operation()

@translate_errors(language='es')
def another_function():
    another_risky_operation()

Context Managers

from PolyglotX.core.context_manager import translated_errors

with translated_errors(language='ar'):
    risky_code()

Why PolyglotX?

Universal Error Handling

PolyglotX translates ANY Python error, not just predefined ones. Whether it's a built-in exception or a custom error message, PolyglotX handles it:

• All built-in Python exceptions (50+ types)
• Custom error messages
• Long and complex error messages
• Nested exceptions
• Error messages with special characters
• Stack traces and tracebacks

Real-World Testing

Tested with:

• 10+ different exception types
• 100+ random error translations
• Complex error messages with multiple arguments
• All 11 supported languages
• Various Python versions (3.6-3.12)

Performance

• 90%+ Cache Hit Rate - Smart caching reduces translation API calls
• 2-5ms Average Translation - Lightning-fast with caching
• Multiple Engines - Automatic fallback ensures reliability
• Thread-Safe - Safe for concurrent applications

Use Cases

• International Development Teams - Debug in your native language
• Educational Institutions - Teach Python in any language
• Open Source Projects - Make errors accessible to global contributors
• Production Applications - Localize error messages for end users
• Documentation - Generate error documentation in multiple languages

Features Overview

Core Modules

• ExceptionHandler - Main exception handling class
• Translator - Translation engine with multiple backends
• ErrorFormatter - Format errors in HTML, JSON, XML, Markdown, or colored console
• OutputHandler - Direct output to console, files, webhooks, or databases

Utilities

• Decorators - @handle_exceptions, @translate_errors, @retry_on_error
• Context Managers - Clean error handling with with statements
• Error Analysis - Group, analyze, and suggest fixes for errors
• CLI Tools - Command-line interface for batch processing

Advanced Features

• Customizable Formatters - Choose output format (HTML, JSON, XML, Markdown)
• Quality Checking - Verify translation quality
• Fallback Mechanism - Multiple translation engines with automatic fallback
• Signal Handling - Graceful shutdown and cleanup
• Hook System - Extensible with custom hooks
• Batch Processing - Translate multiple errors efficiently

Examples

Example: Handling Multiple Error Types

from PolyglotX import arbe

# NameError
try:
    x = undefined_variable
except SystemExit:
    pass

# ZeroDivisionError
try:
    result = 10 / 0
except SystemExit:
    pass

# TypeError
try:
    value = "text" + 5
except SystemExit:
    pass

# All errors are translated to Arabic!

Example: Batch Translation

from PolyglotX.core.translator import BatchTranslator

translator = BatchTranslator(target_language='ar', batch_size=100)

errors = [
    "TypeError: Cannot read property",
    "ValueError: Invalid input",
    "NameError: Variable not defined",
    # ... add more errors
]

translated = translator.auto_translate_batch(errors)

Example: All Languages

from PolyglotX.core.translator import Translator

languages = ['ar', 'tr', 'ja', 'zh-CN', 'es', 'fr', 'ru', 'de', 'pt']

for lang in languages:
    translator = Translator(target_language=lang)
    print(f"{lang}: {translator.translate('Error: File not found')}")

Testing

# Run all tests
pytest tests/ -v

# Run specific tests
pytest tests/test_basic.py -v
pytest tests/test_translation.py -v

# Run comprehensive error tests
python test_real_errors.py

Statistics

• 39 Core Modules - Comprehensive functionality
• 27+ Test Cases - 100% pass rate
• 100+ Error Types - Successfully translated
• 11 Languages - Fully supported
• 400+ Methods - Extensive API

Contributing

Contributions welcome! See CONTRIBUTING.md

License

MIT License - See LICENSE

Support

• Telegram: @QP4RM
• GitHub Issues: Report bugs or request features

Acknowledgments

Built with:

• deep-translator
• translatepy
• requests
• colorama
• PyYAML
• click

Credits

Developed by MERO

Contact: @QP4RM (Telegram)

---

Documentation

Basic Configuration

from PolyglotX.core.exception_handler import ExceptionHandler

# Configure handler
handler = ExceptionHandler(
    language='ar',        # Target language
    show_credits=True,    # Show "MERO tele QP4RM" message
    auto_exit=True        # Exit after exception
)

Translation Options

from PolyglotX.core.translator import Translator

translator = Translator(
    target_language='ar',    # Target language
    source_language='auto'   # Auto-detect source (default)
)

Output Formats

from PolyglotX.handlers.error_formatter import (
    ColoredErrorFormatter,
    JSONErrorFormatter,
    HTMLErrorFormatter,
    MarkdownErrorFormatter
)

# Colored console output
formatter = ColoredErrorFormatter(language='ar')

# JSON format
json_formatter = JSONErrorFormatter(language='ar')

# HTML format
html_formatter = HTMLErrorFormatter(language='ar')

FAQ

Q: Does PolyglotX work with all Python errors?
A: Yes! PolyglotX translates ANY Python error, including custom exceptions.

Q: Will it slow down my application?
A: No. With smart caching, translation is 2-5ms. Only the first occurrence of each error requires translation.

Q: Can I use it in production?
A: Absolutely! PolyglotX is production-ready with comprehensive testing and error handling.

Q: Does it require internet connection?
A: Yes, for first-time translations. Subsequent translations are served from cache.

Q: Can I add more languages?
A: Yes! See CONTRIBUTING.md for guidelines.

---

Version 1.0.0
MERO tele QP4RM