auto-i18n-lib

Автоматическая библиотека для перевода интерфейсов без ручного сбора строк.

Что содержит библиотека

Класс Translator – публичное API для рендеринга и управления переводом.
Воркер – фоновый процесс, который:
- сканирует указанные файлы и папки (HTML, JS/JSX/TSX, UI-словари),
- извлекает все тексты интерфейса,
- переводит их через OpenAI,
- сохраняет в JSON-кэш,
- обновляет переводы при изменении кода.
Парсеры для HTML, JSX/TSX, UI-словарей (рекурсивный обход).
Клиентский рантайм – готовый JavaScript с функциями translateKey() и setLanguage() для динамического перевода DOM.
Storage – атомарное управление кэшем и очередями.

Что выполняет библиотека

В фоне – автоматически находит все строки в проекте, переводит на целевые языки, поддерживает кэш актуальным.
При рендеринге – методы translate_html, translate_dict, translate_key мгновенно отдают готовые переводы из локального кэша (без синхронных вызовов OpenAI).
На клиенте – смена языка подгружает новый JSON и перерисовывает интерфейс без перезагрузки страницы.

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

from autoi18n import Translator

t = Translator(
    api_key="YOUR_OPENAI_API_KEY",
    source_lang="ru",
    target_langs=["en", "uk", "az", "tr"],
    # Пути для сканирования
    js_globs=["frontend/src/**/*.{js,jsx,tsx}"],
    html_globs=["templates/**/*.html"],
)

# Запустить воркер (один раз или в фоновом потоке)
t.run_translation_loop(interval=300)  # каждые 5 минут

Методы рендеринга

Метод	Назначение
`translate_html(html, target_lang, page_name)`	Переводит готовый HTML (текст и атрибуты).
`translate_dict(page_name, dict_name, source_dict, target_lang)`	Переводит вложенный словарь (UI).
`translate_key(key, lang, default, dict_name)`	Возвращает перевод бэкенд-фразы по ключу.
`register_keys(items, dict_name)`	Регистрирует исходные бэкенд-фразы.
`build_frontend_runtime(lang)`	Генерирует JS-рантайм для клиента.

Пример интеграции с React

Настройте Translator с путями к вашему фронтенду.
Запустите воркер – он сам найдёт все строки в компонентах (включая JSX-тексты, атрибуты, вызовы t()).

Вставьте сгенерированный рантайм в index.html:

<script>
// Результат t.build_frontend_runtime('ru')
</script>

В компонентах используйте:

// Любой текст, обёрнутый в translateKey, будет автоматически переведён
<h1>{window.autoI18n.translateKey('dashboard_welcome', 'Добро пожаловать')}</h1>

Или атрибут data-i18n="dashboard_welcome" на любом элементе.

Переключение языка:
```
window.autoI18n.setLanguage('en');
```

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

Переменная	Описание
`OPENAI_API_KEY`	Обязательный API‑ключ
`SOURCE_LANG`	Исходный язык (по умолчанию `ru`)
`AUTO_I18N_TARGET_LANGS`	Целевые языки через запятую
`AUTO_I18N_JS_GLOBS`	Glob-паттерны для JS/JSX (JSON-массив)
`AUTO_I18N_HTML_GLOBS`	Glob-паттерны для HTML
`AUTO_I18N_CACHE_DIR`	Папка для кэша (по умолчанию `./cache`)
`AUTO_I18N_DYNAMIC_DOM_ENABLED`	Включить MutationObserver

Требования к доработке (ТЗ)

Чтобы библиотека работала полностью автоматически, необходимо:

Улучшенный JSX-парсер – должен находить все текстовые узлы в JSX, атрибуты (label, placeholder, title, aria-label), вызовы t() и translateKey() в любом синтаксисе (включая шаблонные строки и переменные).
Автоматическое обновление переводов – воркер должен пересканивать файлы при их изменении (watch mode) и переводить только новые/изменённые строки.
Клиентский рантайм – должен уметь подгружать переводы по требованию (lazy loading) и работать с React без дополнительных обёрток.
Поддержка динамических атрибутов – data-i18n должен работать для любых атрибутов, а не только для текста.

Лицензия

MIT

Release files for auto-i18n-lib 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for auto-i18n-lib 1.1.0
File	Size	Uploaded
auto_i18n_lib-1.1.0.tar.gz	24.0 kB	Aug 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for auto-i18n-lib 1.1.0
File	Interpreter	ABI	Platform	Reset
auto_i18n_lib-1.1.0-py3-none-any.whl 27.2 kB Aug 28, 2026	Python 3	none	any	Details

Total release size: 51.2 kB

Release files / auto_i18n_lib-1.1.0.tar.gz

Download URL	auto_i18n_lib-1.1.0.tar.gz
Size	24.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`858ebaf0ff95b90a120fc946f25eced3caf0d0a1a9c1ee6c12229d7a696adca6`
BLAKE2b-256 checksum How to use checksums	`2a335eb8777fd52be4160c9b9371cd2a467795eb2325d367123ff1a8cf0fb460`
Upload date	Aug 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.0`

Release files / auto_i18n_lib-1.1.0-py3-none-any.whl

Download URL	auto_i18n_lib-1.1.0-py3-none-any.whl
Size	27.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1429989dbcbc79d56ffc306b4f428a3f95180aef9d872fa38c26ac39830e9a63`
BLAKE2b-256 checksum How to use checksums	`5a3dd6e1edc8e8e73581ad88ab8be8d1aa28c6d3d16c78bc043cc33154d34681`
Upload date	Aug 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.0`