auto-i18n-lib

Библиотека для перевода HTML, UI-словарей и бэкенд-фраз без синхронных вызовов OpenAI во время рендеринга.

Установка

pip install auto-i18n-lib


Требуется Python 3.9+ и `OPENAI_API_KEY`.

---

## Быстрый старт

```python
from autoi18n import Translator

t = Translator(
    cache_dir="./translations",
    source_lang="ru",
    target_langs=["en", "az", "tr"],
)

Методы

Примеры

HTML

html = "<h1>Главная</h1><button>Сохранить</button>"
translated = t.translate_html(html, "en", "home")

UI-словарь

ui = {"title": "Грузы", "filters": {"search": "Поиск"}}
translated_ui = t.translate_dict("cargo", "table", ui, "en")

Бэкенд-ключи

t.register_keys({"bot.welcome": "Добро пожаловать"}, dict_name="bot")
text = t.translate_key("bot.welcome", "en", "Добро пожаловать", "bot")

React/JS

# Извлечь строки из кода
t.extract_js_keys(js_globs=["src/**/*.{js,jsx,tsx}"])
# Обработать очередь
t.process_all_translations()
# Сгенерировать рантайм
script = t.build_frontend_runtime("en")

В браузере:

window.autoI18n.translateKey('ui.title', 'Заголовок')

Структура кэша

translations/
  en.json               # общий кэш
  _pending.json         # очередь
  backend/
    bot.en.json         # бэкенд-словари
    _pending_bot.json

Переменные окружения

• OPENAI_API_KEY – обязательный
• SOURCE_LANG – исходный язык (по умолчанию ru)
• AUTO_I18N_TARGET_LANGS – список целевых языков через запятую
• AUTO_I18N_JS_SCAN_ENABLED – включить сканирование JS
• AUTO_I18N_JS_GLOBS – JSON-массив glob-паттернов
• AUTO_I18N_DYNAMIC_DOM_ENABLED – включить MutationObserver

Лицензия

MIT