polyadmin 0.1.0b1__py3-none-any.whl

polyadmin/i18n/setup.py

@@ -0,0 +1,81 @@
+"""I18n: an Admin's internationalisation setup, built once at mount."""
+
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping, Sequence
+from dataclasses import dataclass
+from typing import Any
+
+from polyadmin.i18n.negotiation import match_accept_language, match_locale
+from polyadmin.i18n.translator import (
+    DEFAULT_LOCALE,
+    PSEUDO_LOCALE,
+    GettextTranslator,
+    PseudoTranslator,
+    Translator,
+)
+
+BUILTIN_LOCALE_NAMES = {
+    "en": "English",
+    "fr": "Français",
+    "ru": "Русский",
+    PSEUDO_LOCALE: "Pseudo (en-XA)",
+}
+
+
+@dataclass(frozen=True)
+class LocaleOption:
+    code: str
+    name: str
+
+
+class I18n:
+    def __init__(self, *, translator: Translator, default: str, supported: Sequence[str], names: Mapping[str, str]) -> None:
+        self.translator = translator
+        self.default = default
+        self.supported = list(supported)
+        self._names = {**BUILTIN_LOCALE_NAMES, **names}
+
+    @classmethod
+    def from_admin(cls, admin: Any) -> I18n:
+        default = admin.default_locale or DEFAULT_LOCALE
+        translator = admin.translator
+        available = [DEFAULT_LOCALE]
+        if translator is None:
+            translator = GettextTranslator(admin.catalogs)
+            available = translator.locales()
+        supported = available
+        if admin.locales:
+            if admin.translator is None:
+                missing = [locale for locale in admin.locales if locale not in available]
+                if missing:
+                    raise ValueError(f"polyadmin: locale {missing[0]!r} has no catalog")
+            supported = list(admin.locales)
+        if default not in supported:
+            raise ValueError(f"polyadmin: default locale {default!r} is not among the supported locales {supported}")
+        if admin.pseudo_locale:
+            supported = [*supported, PSEUDO_LOCALE]
+            translator = PseudoTranslator(translator)
+        return cls(translator=translator, default=default, supported=supported, names=admin.locale_names or {})
+
+    def match(self, candidate: str | None) -> str | None:
+        return match_locale(self.supported, candidate)
+
+    def resolve(self, cookie: str | None, resolver: Callable[[], str | None] | None, accept_language: str | None) -> str:
+        """Cookie, then the host's resolver, then Accept-Language, then the
+        default. `resolver` is a thunk so a cookie that decides never costs
+        an authentication."""
+        locale = self.match(cookie)
+        if locale:
+            return locale
+        if resolver is not None:
+            locale = self.match(resolver())
+            if locale:
+                return locale
+        return match_accept_language(self.supported, accept_language) or self.default
+
+    def name(self, code: str) -> str:
+        return self._names.get(code) or code
+
+    def options(self) -> list[LocaleOption]:
+        return [LocaleOption(code, self.name(code)) for code in self.supported]

polyadmin/i18n/translator.py

@@ -0,0 +1,124 @@
+"""The Translator: framework and host strings, keyed by the English text."""
+
+from __future__ import annotations
+
+import gettext as _stdlib
+import re
+from collections.abc import Iterable
+from pathlib import Path
+from typing import Protocol
+
+DEFAULT_LOCALE = "en"
+PSEUDO_LOCALE = "en-XA"
+DOMAIN = "polyadmin"
+FRAMEWORK_LOCALE_DIR = Path(__file__).resolve().parent.parent / "locale"
+
+
+class Translator(Protocol):
+    def gettext(self, locale: str, message: str) -> str: ...
+    def ngettext(self, locale: str, singular: str, plural: str, n: int) -> str: ...
+
+
+def _catalog_locales(localedir: Path, domain: str) -> set[str]:
+    if not localedir.is_dir():
+        return set()
+    return {
+        entry.name.replace("_", "-")
+        for entry in localedir.iterdir()
+        if (entry / "LC_MESSAGES" / f"{domain}.mo").is_file()
+    }
+
+
+class GettextTranslator:
+    """The default Translator: gettext catalogs, host ahead of framework.
+
+    `catalogs` are (localedir, domain) pairs layered over the framework's
+    own: a later entry overrides an earlier one with the same msgid, and
+    every host catalog overrides the framework's, so a host can translate
+    its strings and reword ours.
+    """
+
+    def __init__(self, catalogs: Iterable[tuple[str | Path, str]] = ()) -> None:
+        # Lookup order: the last host catalog first, the framework's last.
+        sources = [(Path(localedir), domain) for localedir, domain in catalogs][::-1]
+        sources.append((FRAMEWORK_LOCALE_DIR, DOMAIN))
+        found = {DEFAULT_LOCALE}
+        for localedir, domain in sources:
+            found |= _catalog_locales(localedir, domain)
+        self._locales = [DEFAULT_LOCALE, *sorted(found - {DEFAULT_LOCALE})]
+        self._chains: dict[str, _stdlib.NullTranslations] = {}
+        for locale in self._locales:
+            chain = None
+            for localedir, domain in sources:
+                translation = _stdlib.translation(
+                    domain, localedir=localedir, languages=[locale.replace("-", "_")], fallback=True
+                )
+                if chain is None:
+                    chain = translation
+                else:
+                    chain.add_fallback(translation)
+            self._chains[locale] = chain
+
+    def locales(self) -> list[str]:
+        return list(self._locales)
+
+    def gettext(self, locale: str, message: str) -> str:
+        chain = self._chains.get(locale)
+        # gettext("") returns the catalog's header block.
+        if chain is None or not message:
+            return message
+        return chain.gettext(message)
+
+    def ngettext(self, locale: str, singular: str, plural: str, n: int) -> str:
+        chain = self._chains.get(locale)
+        if chain is None:
+            return singular if n == 1 else plural
+        return chain.ngettext(singular, plural, n)
+
+
+_PLACEHOLDER = re.compile(r"%(\([^)]*\))?[-+# 0]*\d*(\.\d+)?[a-zA-Z%]")
+_ACCENTS = str.maketrans("aeiouycnszAEIOUYCNSZ", "àéîöüýçñšžÀÉÎÖÜÝÇÑŠŽ")
+
+
+def pseudo(text: str) -> str:
+    """Accent a string's letters and bracket it -- "Save" becomes "[Šàvé]" --
+    leaving %-placeholders intact so the result still formats."""
+    out, last = ["["], 0
+    for match in _PLACEHOLDER.finditer(text):
+        out.append(text[last : match.start()].translate(_ACCENTS))
+        out.append(match.group())
+        last = match.end()
+    out.append(text[last:].translate(_ACCENTS))
+    out.append("]")
+    return "".join(out)
+
+
+def _is_pseudo(text: str) -> bool:
+    """Whether text already looks like pseudo()'s output -- bracketed
+    top to bottom, not merely containing a bracketed run somewhere."""
+    return len(text) >= 2 and text.startswith("[") and text.endswith("]")
+
+
+class PseudoTranslator:
+    """Wraps another Translator, rewriting PSEUDO_LOCALE only."""
+
+    def __init__(self, inner: Translator) -> None:
+        self._inner = inner
+
+    def gettext(self, locale: str, message: str) -> str:
+        if locale != PSEUDO_LOCALE:
+            return self._inner.gettext(locale, message)
+        if _is_pseudo(message):
+            # Already pseudo-translated -- an adapter re-translating a
+            # host string returned from code (an action's message
+            # becoming a flash, a rendered validation error). Wrapping
+            # it again would double-bracket it.
+            return message
+        return pseudo(self._inner.gettext(DEFAULT_LOCALE, message)) if message else message
+
+    def ngettext(self, locale: str, singular: str, plural: str, n: int) -> str:
+        if locale != PSEUDO_LOCALE:
+            return self._inner.ngettext(locale, singular, plural, n)
+        if _is_pseudo(singular):
+            return singular
+        return pseudo(self._inner.ngettext(DEFAULT_LOCALE, singular, plural, n))

polyadmin/locale/fr/LC_MESSAGES/polyadmin.po

@@ -0,0 +1,486 @@
+# French translations of PolyAdmin's framework strings.
+#
+# DRAFT: machine-assisted and not yet reviewed by a native speaker.
+# Corrections are welcome; docs/i18n.md ("Maintaining the framework
+# catalogs") describes how to regenerate and test this file.
+msgid ""
+msgstr ""
+"Project-Id-Version: PolyAdmin 0.1.0\n"
+"Report-Msgid-Bugs-To: https://github.com/MagicRodri/polyadmin/issues\n"
+"POT-Creation-Date: 2026-09-21 18:34+0500\n"
+"PO-Revision-Date: 2026-09-14 22:04+0500\n"
+"Last-Translator: Draft, awaiting native review\n"
+"Language: fr\n"
+"Language-Team: French (unreviewed draft)\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.18.0\n"
+
+#, python-format
+msgid "%(label)s (%(num)d)"
+msgstr "%(label)s (%(num)d)"
+
+#, python-format
+msgid "%(label)s applied to %(num)d record."
+msgid_plural "%(label)s applied to %(num)d records."
+msgstr[0] "%(label)s appliqué à %(num)d enregistrement."
+msgstr[1] "%(label)s appliqué à %(num)d enregistrements."
+
+#, python-format
+msgid "%(label)s is required."
+msgstr "« %(label)s » est obligatoire."
+
+#, python-format
+msgid "%(n)s of %(num)d row selected"
+msgid_plural "%(n)s of %(num)d rows selected"
+msgstr[0] "%(n)s sur %(num)d ligne sélectionnée"
+msgstr[1] "%(n)s sur %(num)d lignes sélectionnées"
+
+#. Translators: %(name)s is the model's name. French and Russian
+#. nouns carry gender, so phrase around agreement.
+#, python-format
+msgid "%(name)s created."
+msgstr "« %(name)s » : enregistrement créé."
+
+#. Translators: %(name)s is the model's name. French and Russian
+#. nouns carry gender, so phrase around agreement.
+#, python-format
+msgid "%(name)s deleted."
+msgstr "« %(name)s » : enregistrement supprimé."
+
+#. Translators: %(name)s is the model's name. French and Russian
+#. nouns carry gender, so phrase around agreement.
+#, python-format
+msgid "%(name)s updated."
+msgstr "« %(name)s » : enregistrement mis à jour."
+
+#, python-format
+msgid "%(num)d row"
+msgid_plural "%(num)d rows"
+msgstr[0] "%(num)d ligne"
+msgstr[1] "%(num)d lignes"
+
+#, python-format
+msgid "%(num)d you can't view"
+msgid_plural "%(num)d you can't view"
+msgstr[0] "%(num)d enregistrement que vous ne pouvez pas voir"
+msgstr[1] "%(num)d enregistrements que vous ne pouvez pas voir"
+
+msgid "Action…"
+msgstr "Action…"
+
+msgid "Add"
+msgstr "Ajouter"
+
+msgid "Admin"
+msgstr "Administration"
+
+msgid "All"
+msgstr "Tous"
+
+msgid "Anonymous"
+msgstr "Anonyme"
+
+msgid "Any date"
+msgstr "Toutes les dates"
+
+msgid "Apply"
+msgstr "Appliquer"
+
+msgid "Asc"
+msgstr "Croissant"
+
+msgid "Back to the admin"
+msgstr "Retour à l'administration"
+
+msgid "Breadcrumb"
+msgstr "Fil d'Ariane"
+
+msgid "CSV"
+msgstr "CSV"
+
+msgid "Cancel"
+msgstr "Annuler"
+
+msgid "Clear all"
+msgstr "Tout effacer"
+
+msgid "Clear selection"
+msgstr "Effacer la sélection"
+
+msgid "Close"
+msgstr "Fermer"
+
+msgid "Close filters"
+msgstr "Fermer les filtres"
+
+msgid "Confirm"
+msgstr "Confirmer"
+
+#, python-format
+msgid "Couldn't save %(name)s"
+msgstr "Impossible d'enregistrer « %(name)s »"
+
+msgid "Custom range"
+msgstr "Période personnalisée"
+
+msgid "Dark mode"
+msgstr "Mode sombre"
+
+msgid "Dashboard"
+msgstr "Tableau de bord"
+
+msgid "Delete"
+msgstr "Supprimer"
+
+#, python-format
+msgid "Delete %(name)s"
+msgstr "Supprimer %(name)s"
+
+#, python-format
+msgid "Delete %(num)d record?"
+msgid_plural "Delete %(num)d records?"
+msgstr[0] "Supprimer %(num)d enregistrement ?"
+msgstr[1] "Supprimer %(num)d enregistrements ?"
+
+msgid "Delete selected"
+msgstr "Supprimer la sélection"
+
+msgid "Delete the selected records? This cannot be undone."
+msgstr "Supprimer les enregistrements sélectionnés ? Cette action est irréversible."
+
+#, python-format
+msgid "Delete this %(name)s?"
+msgstr "Supprimer « %(name)s » ?"
+
+#, python-format
+msgid "Delete «%(label)s»?"
+msgstr "Supprimer « %(label)s » ?"
+
+#. Translators: a bulk delete stopped part-way. %(deleted)d of
+#. %(total)d records were deleted; %(error)s is the underlying error.
+#, python-format
+msgid "Deleted %(deleted)d of %(total)d, then failed: %(error)s"
+msgstr "%(deleted)d sur %(total)d supprimé(s), puis échec : %(error)s"
+
+#, python-format
+msgid "Deleted %(num)d record."
+msgid_plural "Deleted %(num)d records."
+msgstr[0] "%(num)d enregistrement supprimé."
+msgstr[1] "%(num)d enregistrements supprimés."
+
+msgid "Desc"
+msgstr "Décroissant"
+
+msgid "Drag to reorder"
+msgstr "Glisser pour réorganiser"
+
+msgid "Drag to reorder (not saved)"
+msgstr "Glisser pour réorganiser (non enregistré)"
+
+msgid "Edit"
+msgstr "Modifier"
+
+msgid "Email"
+msgstr "E-mail"
+
+msgid "Empty"
+msgstr "Vide"
+
+msgid "Everything is selected."
+msgstr "Tout est sélectionné."
+
+msgid "Export"
+msgstr "Exporter"
+
+msgid "Filters"
+msgstr "Filtres"
+
+msgid "First page"
+msgstr "Première page"
+
+msgid "From"
+msgstr "Du"
+
+msgid "History"
+msgstr "Historique"
+
+msgid "Language"
+msgstr "Langue"
+
+msgid "Last page"
+msgstr "Dernière page"
+
+msgid "Light mode"
+msgstr "Mode clair"
+
+msgid "New"
+msgstr "Nouveau"
+
+msgid "Next month"
+msgstr "Mois suivant"
+
+msgid "Next page"
+msgstr "Page suivante"
+
+msgid "No"
+msgstr "Non"
+
+#, python-format
+msgid "No %(label)s."
+msgstr "Aucun %(label)s."
+
+msgid "No data."
+msgstr "Aucune donnée."
+
+msgid "No items selected."
+msgstr "Aucun élément sélectionné."
+
+msgid "No matches."
+msgstr "Aucun résultat."
+
+msgid "No options."
+msgstr "Aucune option."
+
+msgid "No panels configured."
+msgstr "Aucun panneau configuré."
+
+msgid "No recent activity."
+msgstr "Aucune activité récente."
+
+msgid "No records."
+msgstr "Aucun enregistrement."
+
+msgid "No resources registered."
+msgstr "Aucune ressource enregistrée."
+
+msgid "No widgets configured."
+msgstr "Aucun widget configuré."
+
+msgid "Not empty"
+msgstr "Non vide"
+
+msgid "Not found"
+msgstr "Introuvable"
+
+msgid "Notifications"
+msgstr "Notifications"
+
+msgid "Open calendar"
+msgstr "Ouvrir le calendrier"
+
+msgid "Open menu"
+msgstr "Ouvrir le menu"
+
+msgid "Page"
+msgstr "Page"
+
+#, python-format
+msgid "Page %(page)d of %(pages)d"
+msgstr "Page %(page)d sur %(pages)d"
+
+msgid "Password"
+msgstr "Mot de passe"
+
+msgid "Past 7 days"
+msgstr "7 derniers jours"
+
+msgid "Permission denied"
+msgstr "Accès refusé"
+
+msgid "Platform"
+msgstr "Plateforme"
+
+msgid "PolyAdmin"
+msgstr "PolyAdmin"
+
+msgid "Previous month"
+msgstr "Mois précédent"
+
+msgid "Previous page"
+msgstr "Page précédente"
+
+msgid "Remove"
+msgstr "Retirer"
+
+#, python-format
+msgid "Remove %(label)s"
+msgstr "Retirer %(label)s"
+
+#, python-format
+msgid "Remove this %(label)s?"
+msgstr "Retirer « %(label)s » ?"
+
+msgid "Rows per page"
+msgstr "Lignes par page"
+
+msgid "Save"
+msgstr "Enregistrer"
+
+msgid "Save and add another"
+msgstr "Enregistrer et ajouter un autre"
+
+msgid "Save and continue editing"
+msgstr "Enregistrer et continuer la modification"
+
+msgid "Save as new"
+msgstr "Enregistrer comme nouveau"
+
+#, python-format
+msgid "Save to add %(label)s."
+msgstr "Enregistrer pour ajouter %(label)s."
+
+msgid "Search…"
+msgstr "Rechercher…"
+
+msgid "Security check failed"
+msgstr "Échec de la vérification de sécurité"
+
+msgid "Select all"
+msgstr "Tout sélectionner"
+
+msgid "Select row"
+msgstr "Sélectionner la ligne"
+
+#, python-format
+msgid "Select the %(num)d matching"
+msgid_plural "Select all %(num)d matching"
+msgstr[0] "Sélectionner le %(num)d élément correspondant"
+msgstr[1] "Sélectionner tous les %(num)d éléments correspondants"
+
+msgid "Selected records"
+msgstr "Enregistrements sélectionnés"
+
+msgid "Select…"
+msgstr "Sélectionner…"
+
+msgid "Sign in"
+msgstr "Se connecter"
+
+#, python-format
+msgid "Sign in to %(site)s"
+msgstr "Se connecter à %(site)s"
+
+msgid "Sign out"
+msgstr "Se déconnecter"
+
+msgid "Sign-in could not be completed. Please try again."
+msgstr "La connexion n'a pas pu aboutir. Veuillez réessayer."
+
+msgid "Sign-in required"
+msgstr "Connexion requise"
+
+msgid "Signed in"
+msgstr "Connecté"
+
+msgid "Superuser"
+msgstr "Superutilisateur"
+
+msgid "That email and password don't match an account."
+msgstr "Cette adresse e-mail et ce mot de passe ne correspondent à aucun compte."
+
+msgid "That record doesn't exist, or it was deleted."
+msgstr "Cet enregistrement n'existe pas, ou a été supprimé."
+
+#, python-format
+msgid "The %(num)d matching this filter is selected."
+msgid_plural "All %(num)d matching this filter are selected."
+msgstr[0] "Le %(num)d élément correspondant à ce filtre est sélectionné."
+msgstr[1] "Tous les %(num)d éléments correspondant à ce filtre sont sélectionnés."
+
+#, python-format
+msgid "The %(num)d on this page is selected."
+msgid_plural "All %(num)d on this page are selected."
+msgstr[0] "Le %(num)d de cette page est sélectionné."
+msgstr[1] "Tous les %(num)d de cette page sont sélectionnés."
+
+msgid "The selection changed since you reviewed it."
+msgstr "La sélection a changé depuis votre vérification."
+
+msgid "These records must be removed first:"
+msgstr "Ces enregistrements doivent d'abord être supprimés :"
+
+msgid "This action cannot be undone."
+msgstr "Cette action est irréversible."
+
+msgid "This can't be deleted"
+msgstr "Suppression impossible"
+
+msgid "This month"
+msgstr "Ce mois-ci"
+
+msgid "This page expired before the form was submitted. Reload and try again."
+msgstr "Cette page a expiré avant l'envoi du formulaire. Rechargez la page et réessayez."
+
+msgid "This will also delete"
+msgstr "Seront aussi supprimés"
+
+msgid "This year"
+msgstr "Cette année"
+
+msgid "To"
+msgstr "Au"
+
+msgid "Today"
+msgstr "Aujourd'hui"
+
+msgid "Toggle dark mode"
+msgstr "Basculer le mode sombre"
+
+msgid "Toggle sidebar"
+msgstr "Basculer la barre latérale"
+
+msgid "Total"
+msgstr "Total"
+
+msgid "View"
+msgstr "Voir"
+
+msgid "Welcome back"
+msgstr "Bon retour"
+
+msgid "XLSX"
+msgstr "XLSX"
+
+msgid "Yes"
+msgstr "Oui"
+
+msgid "You have been signed out."
+msgstr "Vous avez été déconnecté."
+
+msgid "You need to be signed in to view this page."
+msgstr "Vous devez être connecté pour voir cette page."
+
+#, python-format
+msgid "Your account doesn't have permission to delete: %(types)s"
+msgstr "Votre compte n'a pas le droit de supprimer : %(types)s"
+
+msgid "Your account doesn't have permission to do that."
+msgstr "Votre compte n'a pas la permission d'effectuer cette action."
+
+msgid "create"
+msgstr "création"
+
+msgid "delete"
+msgstr "suppression"
+
+msgid "m@example.com"
+msgstr "m@example.com"
+
+msgid "no change"
+msgstr "aucun changement"
+
+msgid "system"
+msgstr "système"
+
+msgid "update"
+msgstr "modification"
+
+#, python-format
+msgid "…and %(num)d more"
+msgid_plural "…and %(num)d more"
+msgstr[0] "…et %(num)d autre"
+msgstr[1] "…et %(num)d autres"
+