Update translations for SQLAdmin: Added new phrases and updated existing translations in multiple languages (en, az, de, ru, tr). Generated new translations.json file for easier management of language strings.

Author: vahidzhe

Makefile

@@ -49,7 +49,7 @@ secure:
 # Extract translatable strings into the .pot template and sync every catalog.
 i18n-extract:
 	uv run python -c "import os; os.makedirs('sqladmin/translations', exist_ok=True)"
-	uv run pybabel extract -F babel.cfg -o sqladmin/translations/admin.pot .
+	uv run pybabel extract -F pyproject.toml -o sqladmin/translations/admin.pot .
 	uv run pybabel update -i sqladmin/translations/admin.pot -d sqladmin/translations -D admin
 
 # Create a catalog for a new locale, e.g. `make i18n-init LOCALE=fr`.

docs/internationalization.md

@@ -1,6 +1,6 @@
 SQLAdmin can translate its interface into multiple languages using
-[Babel](https://babel.pocoo.org/). Compiled catalogs for English (`en`), German (`de`),  Azerbaijani (`az`),
- Russian (`ru`) and Turkish (`tr`) ship with the
+[Babel](https://babel.pocoo.org/). Compiled catalogs for Azerbaijani (`az`),
+German (`de`), English (`en`), Russian (`ru`) and Turkish (`tr`) ship with the
 package.
 
 Translation is optional. Install the extra to enable it:
@@ -25,7 +25,7 @@ language switcher in the navigation:
         engine,
         i18n_config=I18nConfig(
             default_locale="en",
-            language_switcher=["en", "de", "az", "ru", "tr"],
+            language_switcher=["en", "az", "de", "ru", "tr"],
         ),
     )
     ```
@@ -146,4 +146,4 @@ and `.mo` (compiled) files.
 
     Model field labels and WTForms validation messages are not covered by this
     layer. Field labels come from your SQLAlchemy columns (use `column_labels`
-    to customise them), and WTForms ships its own validator translations.
+    to customise them), and WTForms ships its own validator translations.

pyproject.toml

@@ -111,3 +111,11 @@ exclude_lines = [
 fail_under = 95
 show_missing = true
 skip_covered = true
+
+[tool.babel]
+# Message extraction mapping for `pybabel extract -F pyproject.toml`.
+# Only Jinja templates are scanned; SQLAdmin marks UI strings with _("...").
+[[tool.babel.mappings]]
+method = "jinja2"
+pattern = "sqladmin/templates/**.html"
+extensions = "jinja2.ext.i18n"

scripts/seed_translations.py

@@ -1,306 +1,54 @@
-import copy
+import json
 import os
+import sys
+from typing import Dict
 
 from babel.messages.catalog import Catalog
 from babel.messages.mofile import write_mo
 from babel.messages.pofile import write_po
 
-ROOT = os.path.join("sqladmin", "translations")
+DEFAULT_MAPPINGS = os.path.join("scripts", "translations.json")
+OUTPUT_ROOT = os.path.join("sqladmin", "translations")
+DOMAIN = "admin"
 
-# Every translatable UI string (the msgids marked with _("...") in templates).
-MESSAGES = [
-    "Logout",
-    "Login",
-    "Login to",
-    "Username",
-    "Enter username",
-    "Password",
-    "Search",
-    "Filters",
-    "Apply Filter",
-    "Save",
-    "Save and continue editing",
-    "Save and add another",
-    "Save as new",
-    "Column",
-    "Value",
-    "Please confirm",
-    "Cancel",
-    "Delete",
-    "Delete selected items",
-    "Showing",
-    "Language",
-    "Export",
-    "Import CSV",
-    "New",
-    "Edit",
-    "Actions",
-    "View",
-    "to",
-    "of",
-    "items",
-    "prev",
-    "next",
-    "Show",
-    "Page",
-    "Go Back",
-    "Yes",
-    "Close",
-    "No file selected",
-    "Skip invalid rows and continue import",
-    "Import result",
-    "Missed rows",
-    "Import",
-    "Download CSV",
-    "Download TXT",
-    "Refresh list",
-    "Clear filter",
-    "Done",
-    "Select all",
-    "Select item",
-    "Import progress",
-]
 
-# locale -> {msgid: msgstr}. English is the source language (empty catalog).
-TRANSLATIONS: dict[str, dict[str, str]] = {
-    "en": {},
-    "az": {
-        "Logout": "Çıxış",
-        "Login": "Daxil ol",
-        "Login to": "Daxil ol:",
-        "Username": "İstifadəçi adı",
-        "Enter username": "İstifadəçi adını daxil edin",
-        "Password": "Şifrə",
-        "Search": "Axtarış",
-        "Filters": "Filtrlər",
-        "Apply Filter": "Filtri tətbiq et",
-        "Save": "Yadda saxla",
-        "Save and continue editing": "Yadda saxla və redaktəyə davam et",
-        "Save and add another": "Yadda saxla və başqasını əlavə et",
-        "Save as new": "Yeni kimi yadda saxla",
-        "Column": "Sütun",
-        "Value": "Dəyər",
-        "Please confirm": "Təsdiq edin",
-        "Cancel": "Ləğv et",
-        "Delete": "Sil",
-        "Delete selected items": "Seçilmiş elementləri sil",
-        "Showing": "Göstərilir",
-        "Language": "Dil",
-        "Export": "İxrac et",
-        "Import CSV": "CSV idxal et",
-        "New": "Yeni",
-        "Edit": "Redaktə et",
-        "Actions": "Əməliyyatlar",
-        "View": "Bax",
-        "to": "-",
-        "of": "/",
-        "items": "element",
-        "prev": "əvvəlki",
-        "next": "növbəti",
-        "Show": "Göstər",
-        "Page": "Səhifə",
-        "Go Back": "Geri qayıt",
-        "Yes": "Bəli",
-        "Close": "Bağla",
-        "No file selected": "Fayl seçilməyib",
-        "Skip invalid rows and continue import": "Yanlış sətirləri ötür və idxalı davam etdir",  # noqa: E501
-        "Import result": "İdxal nəticəsi",
-        "Missed rows": "Buraxılmış sətirlər",
-        "Import": "İdxal et",
-        "Download CSV": "CSV yüklə",
-        "Download TXT": "TXT yüklə",
-        "Refresh list": "Siyahını yenilə",
-        "Clear filter": "Filtri təmizlə",
-        "Done": "Hazır",
-        "Select all": "Hamısını seç",
-        "Select item": "Elementi seç",
-        "Import progress": "İdxal gedişatı",
-    },
-    "de": {
-        "Logout": "Abmelden",
-        "Login": "Anmelden",
-        "Login to": "Anmelden bei",
-        "Username": "Benutzername",
-        "Enter username": "Benutzername eingeben",
-        "Password": "Passwort",
-        "Search": "Suche",
-        "Filters": "Filter",
-        "Apply Filter": "Filter anwenden",
-        "Save": "Speichern",
-        "Save and continue editing": "Speichern und weiter bearbeiten",
-        "Save and add another": "Speichern und weiteres hinzufügen",
-        "Save as new": "Als neu speichern",
-        "Column": "Spalte",
-        "Value": "Wert",
-        "Please confirm": "Bitte bestätigen",
-        "Cancel": "Abbrechen",
-        "Delete": "Löschen",  # noqa: E501
-        "Delete selected items": "Ausgewählte Einträge löschen",
-        "Showing": "Anzeige",
-        "Language": "Sprache",
-        "Export": "Exportieren",
-        "Import CSV": "CSV importieren",
-        "New": "Neu",
-        "Edit": "Bearbeiten",
-        "Actions": "Aktionen",
-        "View": "Ansehen",
-        "to": "bis",
-        "of": "von",
-        "items": "Einträge",
-        "prev": "zurück",
-        "next": "weiter",  # noqa: E501
-        "Show": "Zeige",
-        "Page": "Seite",
-        "Go Back": "Zurück",
-        "Yes": "Ja",
-        "Close": "Schließen",
-        "No file selected": "Keine Datei ausgewählt",
-        "Skip invalid rows and continue import": "Ungültige Zeilen überspringen und Import fortsetzen",  # noqa: E501
-        "Import result": "Importergebnis",
-        "Missed rows": "Übersprungene Zeilen",
-        "Import": "Importieren",
-        "Download CSV": "CSV herunterladen",
-        "Download TXT": "TXT herunterladen",
-        "Refresh list": "Liste aktualisieren",
-        "Clear filter": "Filter löschen",
-        "Done": "Fertig",
-        "Select all": "Alle auswählen",
-        "Select item": "Eintrag auswählen",
-        "Import progress": "Importfortschritt",
-    },
-    "ru": {
-        "Logout": "Выход",
-        "Login": "Вход",
-        "Login to": "Вход в",
-        "Username": "Имя пользователя",
-        "Enter username": "Введите имя пользователя",
-        "Password": "Пароль",
-        "Search": "Поиск",
-        "Filters": "Фильтры",
-        "Apply Filter": "Применить фильтр",
-        "Save": "Сохранить",
-        "Save and continue editing": "Сохранить и продолжить редактирование",
-        "Save and add another": "Сохранить и добавить ещё",
-        "Save as new": "Сохранить как новое",
-        "Column": "Столбец",
-        "Value": "Значение",
-        "Please confirm": "Подтвердите",
-        "Cancel": "Отмена",
-        "Delete": "Удалить",
-        "Delete selected items": "Удалить выбранные элементы",
-        "Showing": "Показано",
-        "Language": "Язык",
-        "Export": "Экспорт",
-        "Import CSV": "Импорт CSV",
-        "New": "Создать",
-        "Edit": "Изменить",
-        "Actions": "Действия",
-        "View": "Просмотр",
-        "to": "–",
-        "of": "из",
-        "items": "элементов",
-        "prev": "назад",
-        "next": "вперёд",
-        "Show": "Показать",
-        "Page": "страница",
-        "Go Back": "Назад",
-        "Yes": "Да",
-        "Close": "Закрыть",
-        "No file selected": "Файл не выбран",
-        "Skip invalid rows and continue import": "Пропустить неверные строки и продолжить импорт",  # noqa: E501
-        "Import result": "Результат импорта",
-        "Missed rows": "Пропущенные строки",
-        "Import": "Импорт",
-        "Download CSV": "Скачать CSV",
-        "Download TXT": "Скачать TXT",  # noqa: E501
-        "Refresh list": "Обновить список",
-        "Clear filter": "Очистить фильтр",
-        "Done": "Готово",
-        "Select all": "Выбрать всё",
-        "Select item": "Выбрать элемент",
-        "Import progress": "Ход импорта",
-    },
-    "tr": {
-        "Logout": "Çıkış",
-        "Login": "Giriş",
-        "Login to": "Giriş:",
-        "Username": "Kullanıcı adı",
-        "Enter username": "Kullanıcı adını girin",
-        "Password": "Parola",
-        "Search": "Ara",
-        "Filters": "Filtreler",
-        "Apply Filter": "Filtreyi uygula",
-        "Save": "Kaydet",
-        "Save and continue editing": "Kaydet ve düzenlemeye devam et",
-        "Save and add another": "Kaydet ve başka ekle",
-        "Save as new": "Yeni olarak kaydet",
-        "Column": "Sütun",
-        "Value": "Değer",
-        "Please confirm": "Lütfen onaylayın",
-        "Cancel": "İptal",
-        "Delete": "Sil",
-        "Delete selected items": "Seçili öğeleri sil",
-        "Showing": "Gösteriliyor",
-        "Language": "Dil",
-        "Export": "Dışa aktar",
-        "Import CSV": "CSV içe aktar",
-        "New": "Yeni",
-        "Edit": "Düzenle",
-        "Actions": "İşlemler",
-        "View": "Görüntüle",
-        "to": "-",
-        "of": "/",
-        "items": "öğe",
-        "prev": "önceki",
-        "next": "sonraki",
-        "Show": "Göster",
-        "Page": "Sayfa",
-        "Go Back": "Geri dön",
-        "Yes": "Evet",
-        "Close": "Kapat",
-        "No file selected": "Dosya seçilmedi",
-        "Skip invalid rows and continue import": "Geçersiz satırları atla ve içe aktarmaya devam et",  # noqa: E501
-        "Import result": "İçe aktarma sonucu",
-        "Missed rows": "Atlanan satırlar",
-        "Import": "İçe aktar",
-        "Download CSV": "CSV indir",
-        "Download TXT": "TXT indir",
-        "Refresh list": "Listeyi yenile",
-        "Clear filter": "Filtreyi temizle",
-        "Done": "Tamam",
-        "Select all": "Tümünü seç",
-        "Select item": "Öğeyi seç",
-        "Import progress": "İçe aktarma ilerlemesi",
-    },
-}
+def build(mappings_path: str, output_root: str = OUTPUT_ROOT) -> None:
+    """Write ``.po``/``.mo`` catalogs (and the ``.pot`` template) from a mapping.
 
+    Args:
+        mappings_path: Path to the JSON file of ``{locale: {source: translation}}``.
+        output_root: Directory the ``gettext`` tree is written to.
+    """
+    with open(mappings_path, encoding="utf-8") as file:
+        mappings: Dict[str, Dict[str, str]] = json.load(file)
 
-def build() -> None:
-    os.makedirs(ROOT, exist_ok=True)
+    # The full source-string set is the union of every locale's keys, so a
+    # partially translated locale still lists all messages.
+    messages = sorted({message for entries in mappings.values() for message in entries})
+    os.makedirs(output_root, exist_ok=True)
 
-    template = Catalog(project="SQLAdmin", domain="admin")
-    for message in MESSAGES:
+    template = Catalog(project="SQLAdmin", domain=DOMAIN)
+    for message in messages:
         template.add(message, string="")
-    with open(os.path.join(ROOT, "admin.pot"), "wb") as f:
-        write_po(f, template, omit_header=False)
+    with open(os.path.join(output_root, "admin.pot"), "wb") as file:
+        write_po(file, template, omit_header=False)
 
-    for locale, mapping in TRANSLATIONS.items():
-        catalog = copy.deepcopy(template)
-        catalog.locale = locale
-        catalog.fuzzy = False
-        for message in catalog:  # type: ignore[assignment]
-            if message.id and message.id in mapping:  # type: ignore[attr-defined]
-                message.string = mapping[message.id]  # type: ignore[attr-defined]
+    for locale, entries in mappings.items():
+        catalog = Catalog(locale=locale, project="SQLAdmin", domain=DOMAIN)
+        for message in messages:
+            catalog.add(message, string=entries.get(message, ""))
 
-        directory = os.path.join(ROOT, locale, "LC_MESSAGES")
+        directory = os.path.join(output_root, locale, "LC_MESSAGES")
         os.makedirs(directory, exist_ok=True)
-        with open(os.path.join(directory, "admin.po"), "wb") as f:
-            write_po(f, catalog, omit_header=False, sort_output=False)
-        with open(os.path.join(directory, "admin.mo"), "wb") as f:
-            write_mo(f, catalog)
-        translated = sum(1 for m in catalog if m.id and m.string)
-        print(f"{locale}: {translated}/{len(MESSAGES)} translated")
+        with open(os.path.join(directory, "admin.po"), "wb") as file:
+            write_po(file, catalog, omit_header=False, sort_output=False)
+        with open(os.path.join(directory, "admin.mo"), "wb") as file:
+            write_mo(file, catalog)
+
+        translated = sum(1 for message in messages if entries.get(message))
+        print(f"{locale}: {translated}/{len(messages)} translated")
 
 
 if __name__ == "__main__":
-    build()
+    path = sys.argv[1] if len(sys.argv) > 1 else DEFAULT_MAPPINGS
+    build(path)