fastlifeweb 0.17.0__py3-none-any.whl → 0.19.0__py3-none-any.whl

fastlife/services/translations.py

@@ -1,18 +1,21 @@
 import pathlib
-from collections.abc import Iterator
+from collections import defaultdict
+from collections.abc import Callable, Iterator
+from gettext import GNUTranslations
+from io import BufferedReader
 from typing import TYPE_CHECKING
 
-from babel.support import NullTranslations, Translations
-
 from fastlife.shared_utils.resolver import resolve_path
 
 if TYPE_CHECKING:
     from fastlife import Request  # coverage: ignore
 
-locale_name = str
+LocaleName = str
+Domain = str
+CONTEXT_ENCODING = "%s\x04%s"
 
 
-def find_mo_files(root_path: str) -> Iterator[tuple[str, str, pathlib.Path]]:
+def find_mo_files(root_path: str) -> Iterator[tuple[LocaleName, Domain, pathlib.Path]]:
     """
     Find .mo files in a locales directory.
 
@@ -30,30 +33,54 @@ def find_mo_files(root_path: str) -> Iterator[tuple[str, str, pathlib.Path]]:
             yield locale_dir.name, mo_file.stem, mo_file
 
 
+def _default_plural(n: int) -> int:
+    return int(n != 1)  # germanic plural by default
+
+
+class MergedTranslations(GNUTranslations):
+    _catalog: dict[str, str]
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._catalog = {}
+        self.plural: Callable[[int], int] = _default_plural
+
+    def merge(self, other: GNUTranslations) -> None:
+        if hasattr(other, "_catalog"):
+            self._catalog.update(other._catalog)  # type: ignore
+        if hasattr(other, "plural"):
+            self.plural = other.plural  # type: ignore
+
+
 class Localizer:
-    def __init__(
-        self, request: "Request", translations: Translations | NullTranslations
-    ) -> None:
-        self.locale_name = request.locale_name
-        self.translations = translations
+    def __init__(self) -> None:
+        self.translations: dict[Domain, MergedTranslations] = defaultdict(
+            MergedTranslations
+        )
+        self.global_translations = MergedTranslations()
+
+    def register(self, domain: str, file: BufferedReader) -> None:
+        trans = GNUTranslations(file)
+        self.translations[domain].merge(trans)
+        self.global_translations.merge(trans)
 
     def gettext(self, message: str, mapping: dict[str, str] | None = None) -> str:
-        ret = self.translations.gettext(message)
-        if mapping is not None:
+        ret = self.global_translations.gettext(message)
+        if mapping:
             ret = ret.format(**mapping)
         return ret
 
     def ngettext(
         self, singular: str, plural: str, n: int, mapping: dict[str, str] | None = None
     ) -> str:
-        ret = self.translations.ngettext(singular, plural, n)
+        ret = self.global_translations.ngettext(singular, plural, n)
         mapping_num = {"num": n, **(mapping or {})}
         return ret.format(**mapping_num)
 
     def dgettext(
         self, domain: str, message: str, mapping: dict[str, str] | None = None
     ) -> str:
-        ret = self.translations.dgettext(domain, message)
+        ret = self.translations[domain].gettext(message)
         if mapping:
             ret = ret.format(**mapping)
         return ret
@@ -66,14 +93,14 @@ class Localizer:
         n: int,
         mapping: dict[str, str] | None = None,
     ) -> str:
-        ret = self.translations.dngettext(domain, singular, plural, n)
+        ret = self.translations[domain].ngettext(singular, plural, n)
         mapping_num = {"num": n, **(mapping or {})}
         return ret.format(**mapping_num)
 
     def pgettext(
         self, context: str, message: str, mapping: dict[str, str] | None = None
     ) -> str:
-        ret = str(self.translations.pgettext(context, message))
+        ret = self.global_translations.pgettext(context, message)
         if mapping:
             ret = ret.format(**mapping)
         return ret
@@ -85,7 +112,7 @@ class Localizer:
         message: str,
         mapping: dict[str, str] | None = None,
     ) -> str:
-        ret = str(self.translations.dpgettext(domain, context, message))
+        ret = self.translations[domain].pgettext(context, message)
         if mapping:
             ret = ret.format(**mapping)
         return ret
@@ -99,18 +126,33 @@ class Localizer:
         n: int,
         mapping: dict[str, str] | None = None,
     ) -> str:
-        ret = self.translations.dnpgettext(domain, context, singular, plural, n)
+        ret = self.translations[domain].npgettext(context, singular, plural, n)
         mapping_num = {"num": n, **(mapping or {})}
         return ret.format(**mapping_num)
 
 
+class TranslationDictionary:
+    def __init__(self) -> None:
+        self.translations: dict[LocaleName, Localizer] = defaultdict(Localizer)
+
+    def load(self, root_path: str) -> None:
+        for locale_name, domain, file_ in find_mo_files(root_path):
+            with file_.open("rb") as stream:
+                self.translations[locale_name].register(domain, stream)
+
+    def get(self, locale_name: LocaleName) -> Localizer:
+        return self.translations[locale_name]
+
+    def __contains__(self, other: LocaleName) -> bool:
+        return other in self.translations
+
+
 class LocalizerFactory:
     """Initialize the proper translation context per request."""
 
-    _translations: dict[locale_name, Translations]
-
     def __init__(self) -> None:
-        self._translations = {}
+        self._translations = TranslationDictionary()
+        self.null_localizer = Localizer()
 
     def load(self, path: str) -> None:
         """
@@ -118,21 +160,10 @@ class LocalizerFactory:
         :param path: a python module and the locales dir separated by a `:`
         """
         root_path = resolve_path(path)
-        for locale_name, domain, file_ in find_mo_files(root_path):
-            with file_.open("rb") as f:
-                t = Translations(f, domain)
-                if locale_name not in self._translations:
-                    self._translations[locale_name] = Translations()
-                self._translations[locale_name].add(t)
-                self._translations[locale_name].merge(t)
+        self._translations.load(root_path)
 
     def __call__(self, request: "Request") -> Localizer:
         """Create the translation context for the given request."""
-        trans: Translations | NullTranslations | None = self._translations.get(
-            request.locale_name
-        )
-        if not trans:
-            trans = self._translations.get(request.registry.settings.default_locale)
-        if not trans:
-            trans = NullTranslations()
-        return Localizer(request, trans)
+        if request.locale_name not in self._translations:
+            return self.null_localizer
+        return self._translations.get(request.locale_name)

fastlife/templates/__init__.py

@@ -3,8 +3,10 @@ Utilities for rendering HTML templates for page and components as FastAPI depend
 """
 
 from .binding import Template, template
+from .inline import InlineTemplate
 
 __all__ = [
     "Template",
     "template",
+    "InlineTemplate",
 ]

fastlife/templates/inline.py

@@ -0,0 +1,19 @@
+"""Inline templates."""
+
+from typing import ClassVar
+
+from pydantic import BaseModel
+
+
+class InlineTemplate(BaseModel):
+    """
+    Inline templates are used to encourage the location of behavior and the view typing.
+
+    Pages produce templates that are not reusable and don't need to be reusable
+    in there essence, they don't need to be in a component library.
+    They use a component lirary to stay small but contains a view logic
+    tighly coupled with the view and its code can stay in the same module of that view.
+    """
+
+    template: ClassVar[str]
+    """The template string to render."""

{fastlifeweb-0.17.0.dist-info → fastlifeweb-0.19.0.dist-info}/METADATA

@@ -1,35 +1,38 @@
 Metadata-Version: 2.1
 Name: fastlifeweb
-Version: 0.17.0
+Version: 0.19.0
 Summary: High-level web framework
-Home-page: https://github.com/mardiros/fastlife
-License: BSD-derived
-Author: Guillaume Gauvrit
-Author-email: guillaume@gauvr.it
-Requires-Python: >=3.11,<4.0
+Author-Email: Guillaume Gauvrit <guillaume@gauvr.it>
+License: MIT License
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: AsyncIO
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: BSD License
-Classifier: License :: Other/Proprietary License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP
+Project-URL: Homepage, https://mardiros.github.io/fastlife
+Project-URL: Documentation, https://mardiros.github.io/fastlife
+Project-URL: Repository, https://github.com/mardiros/fastlife.git
+Project-URL: Issues, https://github.com/mardiros/fastlife/issues
+Project-URL: Changelog, https://mardiros.github.io/fastlife/user/changelog.html
+Requires-Python: >=3.11
+Requires-Dist: fastapi[standard]<1,>=0.115.0
+Requires-Dist: itsdangerous<3,>=2.1.2
+Requires-Dist: jinjax<0.45,>=0.44
+Requires-Dist: markupsafe<3,>=2.1.3
+Requires-Dist: multidict<7,>=6.0.5
+Requires-Dist: pydantic<3,>=2.5.3
+Requires-Dist: pydantic-settings<3,>=2.0.3
+Requires-Dist: python-multipart<1,>=0.0.9
+Requires-Dist: venusian<4,>=3.0.0
 Provides-Extra: testing
-Requires-Dist: babel (>=2.16.0,<3.0.0)
-Requires-Dist: beautifulsoup4 (>=4.12.2,<5.0.0) ; extra == "testing"
-Requires-Dist: fastapi[standard] (>=0.115.0,<0.116.0)
-Requires-Dist: itsdangerous (>=2.1.2,<3.0.0)
-Requires-Dist: jinjax (>=0.44,<0.45)
-Requires-Dist: markupsafe (>=2.1.3,<3.0.0)
-Requires-Dist: multidict (>=6.0.5,<7.0.0)
-Requires-Dist: pydantic (>=2.5.3,<3.0.0)
-Requires-Dist: pydantic-settings (>=2.0.3,<3.0.0)
-Requires-Dist: python-multipart (>=0.0.9,<0.0.10)
-Requires-Dist: venusian (>=3.0.0,<4.0.0)
-Project-URL: Repository, https://github.com/mardiros/fastlife
+Requires-Dist: beautifulsoup4; extra == "testing"
+Provides-Extra: docs
+Requires-Dist: furo>=2024.5.6; extra == "docs"
+Requires-Dist: linkify-it-py<3,>=2.0.3; extra == "docs"
+Requires-Dist: myst-parser<5,>=4.0.0; extra == "docs"
+Requires-Dist: sphinx<8,>=7.0.1; extra == "docs"
+Requires-Dist: sphinx-autodoc2<1,>=0.5.0; extra == "docs"
 Description-Content-Type: text/markdown
 
 # Fastlife
@@ -83,4 +86,3 @@ The package is available on pypi with the name fastlifeweb.
 ```bash
 pip install fastlifeweb
 ```
-