Столкнувшись с исключением, иногда не понимаешь: «divizion by zero» — что это? Начинающие разработчики часто не могут понять причину ошибки из‑за неправильного понимания её а русском языке. Опытные разработчики также сталкиваются с неизвестными им исключениями, а часто лезть в переводчик для понимания ошибки не хочется. Сегодня я напишу модуль для быстрого перевода таких ошибок, и все непойманные исключения и предупреждения в Python будут выводиться на русском языке.

Для начала установим библиотеку, которая будет обращаться к Google Translator для перевода всех ошибок и предупреждений в Python:

pip install deep_translator

Также нам потребуется работать с цветами для вывода ошибок, поэтому нам потребуется установить colorama. Вот команда:

pip install colorama

Теперь приступим к написанию кода! Я разбил код модуля на несколько файлов, каждый из которых направлен на выполнение совей задачи. Вот код:

error_translator.py:

import sys
import warnings
import os
import json
import time
import re
from deep_translator import GoogleTranslator

SOURCE_LANG = 'auto'
TARGET_LANG = 'ru'
CACHE_DIR = os.path.join(os.path.dirname(__file__), 'error_cache')
CACHE_FILE = os.path.join(CACHE_DIR, 'translations.json')
MAX_CACHE_ENTRIES = 100000

translator = GoogleTranslator(source=SOURCE_LANG, target=TARGET_LANG)

def _load_cache():
    if not os.path.exists(CACHE_FILE):
        return {}
    try:
        with open(CACHE_FILE, 'r', encoding='utf-8') as f:
            return json.load(f)
    except:
        return {}

def _save_cache(cache):
    os.makedirs(CACHE_DIR, exist_ok=True)
    if len(cache) > MAX_CACHE_ENTRIES:
        sorted_items = sorted(cache.items(), key=lambda x: x[1].get('timestamp', 0))
        cache = dict(sorted_items[-MAX_CACHE_ENTRIES:])
    with open(CACHE_FILE, 'w', encoding='utf-8') as f:
        json.dump(cache, f, ensure_ascii=False, indent=2)

def cached_translate(text):
    if not text:
        return text
    cache = _load_cache()
    if text in cache:
        return cache[text]['translation']
    try:
        translated = translator.translate(text)
    except Exception:
        return text
    cache[text] = {'translation': translated, 'timestamp': time.time()}
    _save_cache(cache)
    return translated

def translate_exc_message(msg):
    cleaned = re.sub(r'0x[0-9a-fA-F]+', '...', msg)
    return cached_translate(cleaned)

original_excepthook = sys.excepthook

def translating_excepthook(exc_type, exc_value, exc_tb):
    if exc_value is not None:
        translated = translate_exc_message(str(exc_value))
        try:
            new_exc = exc_type(translated)
        except Exception:
            new_exc = exc_value
    else:
        new_exc = exc_value
    original_excepthook(exc_type, new_exc, exc_tb)

original_showwarning = warnings.showwarning

def translating_showwarning(message, category, filename, lineno, file=None, line=None):
    translated = translate_exc_message(str(message))
    original_showwarning(translated, category, filename, lineno, file, line)

sys.excepthook = translating_excepthook
warnings.showwarning = translating_showwarning

run.py:

import sys
import subprocess
import re
import os
from pathlib import Path
import colorama

colorama.init()

sys.path.insert(0, str(Path(__file__).parent))
from error_translator import cached_translate

sys.stdout.reconfigure(encoding='utf-8', errors='replace')
sys.stderr.reconfigure(encoding='utf-8', errors='replace')

RED = colorama.Fore.RED
RESET = colorama.Style.RESET_ALL

error_header_pattern = re.compile(
    r'^(Traceback \(most recent call last\):|Exception in|During handling of|The above exception was)'
)

in_error_block = False
pending_warning_source = False

def translate_line(line):
    global in_error_block, pending_warning_source

    if pending_warning_source:
        pending_warning_source = False
        if line.startswith('  ') or line.startswith('\t'):
            return RED + line.rstrip('\n') + RESET + '\n'
        else:
            in_error_block = False
            return line

    if error_header_pattern.match(line):
        in_error_block = True
        return RED + line.rstrip('\n') + RESET + '\n'

    if not in_error_block and line.startswith('  File '):
        in_error_block = True
        return RED + line.rstrip('\n') + RESET + '\n'

    warning_match = re.search(r'(:\d+:)\s*(\w+Warning):\s*(.*)', line)
    if warning_match:
        if not in_error_block:
            in_error_block = True
        pending_warning_source = True
        prefix = line[:warning_match.start(1)]
        lineno = warning_match.group(1)
        category = warning_match.group(2)
        msg = warning_match.group(3)
        if msg:
            translated_msg = cached_translate(msg)
            return f"{RED}{prefix}{lineno} {category}: {translated_msg}{RESET}\n"
        else:
            return RED + line.rstrip('\n') + RESET + '\n'

    if in_error_block:
        if line.startswith('  File ') or line.startswith('    ') or line.startswith('\t'):
            return RED + line.rstrip('\n') + RESET + '\n'

        m = re.match(r'^(\s*(?:\w+\.)*\w*(?:Error|Warning|Exception)):\s*(.*)', line)
        if m:
            exc_part, msg = m.groups()
            if msg:
                translated = f"{RED}{exc_part}: {cached_translate(msg)}{RESET}\n"
            else:
                translated = RED + line.rstrip('\n') + RESET + '\n'
            in_error_block = False
            return translated

        if line.strip() == '':
            return RED + '\n'

        in_error_block = False
        return line

    return line

def run_target(target_script):
    env = os.environ.copy()
    env['PYTHONUNBUFFERED'] = '1'

    p = subprocess.Popen(
        [sys.executable, target_script],
        stdout=subprocess.PIPE,
        stderr=subprocess.STDOUT,
        text=True,
        encoding='utf-8',
        errors='replace',
        env=env,
        bufsize=1
    )

    for line in p.stdout:
        sys.stdout.write(translate_line(line))
        sys.stdout.flush()

    p.wait()
    sys.exit(p.returncode)

translate_errors.py:

TARGET = "test.py"; from run import run_target; run_target(TARGET)

Работает это так: при запуске модуля translate_errors.py он запускает наш основной скрипт, название которого мы указали в константе TARGET в отдельном процессе. После выполнения скрипта программиста наш модуль проверяет каждую строчку вывода. Как только модуль натыкается на ошибку, он отправляет её в Google для перевода. Переведённый текст ошибки встаёт на место старого английского, после чего программа выводит переведённую на русский ошибку в консоль.

Не стоит забывать, что это работает не только с ошибками, но и с предупреждениями. Создадим скрипт test_warning.py и вставим приведённый ниже код, а затем запускаем translate_errors.py:

import warnings

warnings.warn("This is a test warning")

В модуле также предусмотрено автоматические кэширование всех переведённых ошибок на диск (ограничение: до 100 000 записей, однако его можно изменять в коде модуля). Для того, чтобы переводчик работал, нужно стабильное интернет‑соединение. Если интернет будет отсутствовать, перевод выполняться не будет (за исключением случаев, когда ошибка уже записана на диск и берётся из кэшированных записей)!

Если что‑то не будет работать, пишите в комментарии — разберёмся. Ниже можно пройти опрос. Он поможет найти баги в работе проекта и улучшить его для всех. По итогам опроса мы обновим код, исправив все баги и выполним предложения по улучшению. Надеюсь, эта статья была полезной!