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.0.8

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.0.8
File	Size	Uploaded
auto_i18n_lib-1.0.8.tar.gz	18.2 kB	Aug 21, 2026	Details

Built distribution (wheel)

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

Total release size: 37.7 kB

Release files / auto_i18n_lib-1.0.8.tar.gz

Download URL	auto_i18n_lib-1.0.8.tar.gz
Size	18.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`5982823c1cdb27da0cf37400cfc40fced66a0b13d1ce39f474958b0f8c5b41bf`
BLAKE2b-256 checksum How to use checksums	`81dc90266bf2db392d21140280a5852a8e9f38c5717c19af630b354a1b3921cc`
Upload date	Aug 21, 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.0.8-py3-none-any.whl

Download URL	auto_i18n_lib-1.0.8-py3-none-any.whl
Size	19.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`feb1450521d65e0ca572032eb9fbffac2e7d6865acb8b4c179d70bf8c8842bed`
BLAKE2b-256 checksum How to use checksums	`ca4e41b3d5ac3938d22eb638f85e255ec6e01767fe3275e9b2a39540ca9b181f`
Upload date	Aug 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.0`