fastlifeweb 0.23.0__py3-none-any.whl → 0.23.1__py3-none-any.whl

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.23.1  - Released on 2025-01-14
+* Fix typing issue
+* Update docs
+
 ## 0.23.0  - Released on 2024-12-04
 * Update Request type.
   * Breaking changes: Request[TUser, TRegistry] -> Request[TRegistry, TIdentity, TClaimedIdentity].

fastlife/__init__.py

@@ -48,6 +48,7 @@ from .service.security_policy import (
     AbstractSecurityPolicy,
     InsecurePolicy,
 )
+from .service.translations import TranslatableStringFactory
 from .settings import Settings
 
 __all__ = [
@@ -97,4 +98,5 @@ __all__ = [
     "JinjaXTemplate",
     # i18n
     "Localizer",
+    "TranslatableStringFactory",
 ]

fastlife/adapters/fastapi/localizer.py

@@ -8,7 +8,7 @@ from fastlife.service.translations import Localizer as RequestLocalizer
 
 def get_localizer(request: Request) -> RequestLocalizer:
     """Return the localizer for the given request."""
-    return request.registry.localizer(request)
+    return request.registry.localizer(request.locale_name)
 
 
 Localizer = Annotated[RequestLocalizer, Depends(get_localizer)]

fastlife/config/configurator.py

@@ -473,7 +473,7 @@ class GenericConfigurator(Generic[TRegistry]):
         * `gettext`, `ngettext`, `dgettext`, `dngettext`, `pgettext`, `dpgettext`,
         `npgettext`, `dnpgettext` methods are installed for i18n purpose.
         """
-        lczr = request.registry.localizer(request)
+        lczr = request.registry.localizer(request.locale_name)
         custom_globals = {}
         for key, (val, evaluate) in self._renderer_globals.items():
             if evaluate and callable(val):

fastlife/service/registry.py

@@ -22,7 +22,7 @@ class GenericRegistry(Generic[TSettings]):
     It is initialized by the configurator and accessed by the `fastlife.Registry`.
     """
 
-    settings: Settings
+    settings: TSettings
     """Application settings."""
     renderers: Mapping[str, "AbstractTemplateRendererFactory"]
     """Registered template engine."""
@@ -31,7 +31,7 @@ class GenericRegistry(Generic[TSettings]):
     localizer: "LocalizerFactory"
     """Used to localized message."""
 
-    def __init__(self, settings: Settings) -> None:
+    def __init__(self, settings: TSettings) -> None:
         from fastlife.service.locale_negociator import default_negociator
         from fastlife.service.translations import LocalizerFactory
 

fastlife/service/translatablestring.py

@@ -0,0 +1 @@
+

fastlife/service/translations.py

@@ -3,18 +3,52 @@ from collections import defaultdict
 from collections.abc import Callable, Iterator
 from gettext import GNUTranslations
 from io import BufferedReader
-from typing import TYPE_CHECKING
 
 from fastlife.shared_utils.resolver import resolve_path
 
-if TYPE_CHECKING:
-    from fastlife import Request  # coverage: ignore
-
 LocaleName = str
 Domain = str
 CONTEXT_ENCODING = "%s\x04%s"
 
 
+class TranslatableString(str):
+    """
+    Create a string made for translation associated to a domain.
+    This class is instanciated by the
+    :class:`fastlife.service.translations.TranslatableStringFactory` class.
+    """
+
+    __slots__ = ("domain",)
+
+    def __new__(cls, msgid: str, domain: str) -> "TranslatableString":
+        self = str.__new__(cls, msgid)
+        self.domain = domain  # type: ignore
+        return self
+
+
+class TranslatableStringFactory:
+    """Create a catalog of string associated to a domain."""
+
+    def __init__(self, domain: str):
+        self.domain = domain
+
+    def __call__(self, msgid: str) -> str:
+        """
+        Use to generate the translatable string.
+
+        usually:
+
+        ```python
+        _ = TranslatableStringFactory("mydomain")
+        mymessage = _("translatable")
+        ```
+
+        Note that the string is associated to mydomain, so the babel extraction has
+        to be initialized with that particular domain.
+        """
+        return TranslatableString(msgid, self.domain)
+
+
 def find_mo_files(root_path: str) -> Iterator[tuple[LocaleName, Domain, pathlib.Path]]:
     """
     Find .mo files in a locales directory.
@@ -68,7 +102,10 @@ class Localizer:
         return self.gettext(message, mapping)
 
     def gettext(self, message: str, mapping: dict[str, str] | None = None) -> str:
-        ret = self.global_translations.gettext(message)
+        if isinstance(message, TranslatableString):
+            ret = self.translations[message.domain].gettext(message)  # type: ignore
+        else:
+            ret = self.global_translations.gettext(message)
         if mapping:
             ret = ret.format(**mapping)
         return ret
@@ -177,8 +214,8 @@ class LocalizerFactory:
         root_path = resolve_path(path)
         self._translations.load(root_path)
 
-    def __call__(self, request: "Request") -> Localizer:
+    def __call__(self, locale_name: LocaleName) -> Localizer:
         """Create the translation context for the given request."""
-        if request.locale_name not in self._translations:
+        if locale_name not in self._translations:
             return self.null_localizer
-        return self._translations.get(request.locale_name)
+        return self._translations.get(locale_name)

fastlife/testing/testclient.py

@@ -126,7 +126,7 @@ class WebTestClient:
 
     @property
     def session(self) -> MutableMapping[str, Any]:
-        """Session shared between the server and the client."""
+        """Server session stored in a cookies."""
         return Session(self)
 
     def request(

{fastlifeweb-0.23.0.dist-info → fastlifeweb-0.23.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastlifeweb
-Version: 0.23.0
+Version: 0.23.1
 Summary: High-level web framework
 Author-Email: Guillaume Gauvrit <guillaume@gauvr.it>
 License: MIT License

{fastlifeweb-0.23.0.dist-info → fastlifeweb-0.23.1.dist-info}/RECORD

@@ -1,10 +1,10 @@
-CHANGELOG.md,sha256=Ap14kfVx07rFhITGDmtQfwEsJowg5osxKETE0w478lU,7801
-fastlife/__init__.py,sha256=cx3BScbBelH-Tm63VPdAp5siW1fBZ0uOMwNW_SPs2xQ,2126
+CHANGELOG.md,sha256=gvl1gBNgVNhdz4fSMSIsPwWpArqetbDebCW2PAB6yoE,7871
+fastlife/__init__.py,sha256=nXWE4AbhkhG_yBjPJU-XnKDMTsU9ebv7Vj4eIciWQI0,2219
 fastlife/adapters/__init__.py,sha256=imPD1hImpgrYkvUJRhHA5kVyGAua7VbP2WGkhSWKJT8,93
 fastlife/adapters/fastapi/__init__.py,sha256=1goV1FGFP04TGyskJBLKZam4Gvt1yoAvLMNs4ekWSSQ,243
 fastlife/adapters/fastapi/form.py,sha256=csxsDI6RK-g41pMwFhaVQCLDhF7dAZzgUp-VcrC3NFY,823
 fastlife/adapters/fastapi/form_data.py,sha256=2DQ0o-RvY6iROUKQjS-UJdNYEVSsNPd-AjpergI3w54,4473
-fastlife/adapters/fastapi/localizer.py,sha256=XD1kCJuAlkGevivmvAJEcGMCBWMef9rAfTOGmt3PVWU,436
+fastlife/adapters/fastapi/localizer.py,sha256=Efn6rrf-SnSfM4TqqE_5chacrxaPpupxbvIqXipXEEw,448
 fastlife/adapters/fastapi/request.py,sha256=COOoSMZAm4VhyJgM7dlqJ7YdGjeGI7qs93PtBsriEPc,1115
 fastlife/adapters/fastapi/routing/__init__.py,sha256=8EMnQE5n8oA4J9_c3nxzwKDVt3tefZ6fGH0d2owE8mo,195
 fastlife/adapters/fastapi/routing/route.py,sha256=XnDPvd5V0Zl7Ke6bBErEtUCjmNQPcV2U_w1dWpx6qM4,1476
@@ -1686,7 +1686,7 @@ fastlife/components/pydantic_form/FatalError.jinja,sha256=lFVlNrXzBR6ExMahq77h0t
 fastlife/components/pydantic_form/Hint.jinja,sha256=8leBpfMGDmalc_KAjr2paTojr_rwq-luS6m_1BGj7Tw,202
 fastlife/components/pydantic_form/Widget.jinja,sha256=PgguUpvhG6CY9AW6H8qQMjKqjlybjDCAaFFAOHzrzVQ,418
 fastlife/config/__init__.py,sha256=5qpuaVYqi-AS0GgsfggM6rFsSwXgrqrLBo9jH6dVroc,407
-fastlife/config/configurator.py,sha256=SURXmBrdTghHoG2f9R2BUF6TKZXg1lNmwP3ZbuApJ3M,24722
+fastlife/config/configurator.py,sha256=gxa3aTfBXvGqRLLAaZ0CoNAjwHlQIhx4yr1DfY_z2IQ,24734
 fastlife/config/exceptions.py,sha256=9MdBnbfy-Aw-KaIFzju0Kh8Snk41-v9LqK2w48Tdy1s,1169
 fastlife/config/openapiextra.py,sha256=rYoerrn9sni2XwnO3gIWqaz7M0aDZPhVLjzqhDxue0o,514
 fastlife/config/resources.py,sha256=u6OgnbHfGkC5idH-YPNkIPf8GJnZpJoGVZ-Ym022BCo,8533
@@ -1712,10 +1712,11 @@ fastlife/service/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,
 fastlife/service/check_permission.py,sha256=-TsI58YZJtWIw5bsm0fVpfuaCMUx4cmoLTKGXeyQPDk,1809
 fastlife/service/csrf.py,sha256=wC1PaKOmZ3il0FF_kevxnlg9PxDqruRdLrNnOA3ZHrU,1886
 fastlife/service/locale_negociator.py,sha256=JUqzTukxDqTJVOR-CNI7Vqo6kvdvwxYvZQe8P3V9S2U,796
-fastlife/service/registry.py,sha256=B6n5b_b0RgxJj0qFOpnrJFmG7_MPtvShwV6yH9V6vi0,2098
+fastlife/service/registry.py,sha256=sdLJ-1K7R1_RwVNpQUcyktPOORhDm_pyKw8jehhR5VM,2100
 fastlife/service/security_policy.py,sha256=qYXs4mhfz_u4x59NhUkirqKYKQbFv9YrzyRuXj7mxE0,4688
 fastlife/service/templates.py,sha256=QPAIUbbZiekazz_jV3q4JCwQd6Q4KA6a4RDek2RWuhE,2548
-fastlife/service/translations.py,sha256=D-1D3pVNytEcps1u-0K7FmgQ8Wo6Yu4XVHvZrPhBmAI,5795
+fastlife/service/translatablestring.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+fastlife/service/translations.py,sha256=s6qFZSXR-1vYxSr7RRH-mS-VjNaa8OTxR7-k6Ib7h0E,6878
 fastlife/settings.py,sha256=q-rz4CEF2RQGow5-m-yZJOvdh3PPb2c1Q_ZLJGnu4VQ,3647
 fastlife/shared_utils/__init__.py,sha256=i66ytuf-Ezo7jSiNQHIsBMVIcB-tDX0tg28-pUOlhzE,26
 fastlife/shared_utils/infer.py,sha256=0GflLkaWJ-4LZ1Ig3moR-_o55wwJ_p_vJ4xo-yi3lyA,1406
@@ -1725,12 +1726,12 @@ fastlife/testing/__init__.py,sha256=VpxkS3Zp3t_hH8dBiLaGFGhsvt511dhBS_8fMoFXdmU,
 fastlife/testing/dom.py,sha256=dVzDoZokn-ii681UaEwAr-khM5KE-CHgXSSLSo24oH0,4489
 fastlife/testing/form.py,sha256=ST0xNCoUqz_oD92cWHzQ6CbJ5hFopvu_NNKpOfiuYWY,7874
 fastlife/testing/session.py,sha256=LEFFbiR67_x_g-ioudkY0C7PycHdbDfaIaoo_G7GXQ8,2226
-fastlife/testing/testclient.py,sha256=JTIgeMKooA8L4gEodeC3gy4Lo27y3WNswSEIKLlVVPs,6745
+fastlife/testing/testclient.py,sha256=TWGbxagxwFEm7_SooItjLchhF5ptHwhyKUh7uhWN_CA,6731
 fastlife/views/__init__.py,sha256=zG8gveL8e2zBdYx6_9jtZfpQ6qJT-MFnBY3xXkLwHZI,22
 fastlife/views/pydantic_form.py,sha256=o7EUItciAGL1OSaGNHo-3BTrYAk34GuWE7zGikjiAGY,1486
-fastlifeweb-0.23.0.dist-info/METADATA,sha256=Eww8hBxH7oR5_EeqtALpdmUmJr2f1vs1E0EijXaxM30,3663
-fastlifeweb-0.23.0.dist-info/WHEEL,sha256=thaaA2w1JzcGC48WYufAs8nrYZjJm8LqNfnXFOFyCC4,90
-fastlifeweb-0.23.0.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
-fastlifeweb-0.23.0.dist-info/licenses/LICENSE,sha256=NlRX9Z-dcv8X1VFW9odlIQBbgNN9pcO94XzvKp2R16o,1075
+fastlifeweb-0.23.1.dist-info/METADATA,sha256=O3yeVKCL9s-zEyG6Gsl6Z8UmrX9T9cMwkkOgz0bkw58,3663
+fastlifeweb-0.23.1.dist-info/WHEEL,sha256=thaaA2w1JzcGC48WYufAs8nrYZjJm8LqNfnXFOFyCC4,90
+fastlifeweb-0.23.1.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+fastlifeweb-0.23.1.dist-info/licenses/LICENSE,sha256=NlRX9Z-dcv8X1VFW9odlIQBbgNN9pcO94XzvKp2R16o,1075
 tailwind.config.js,sha256=EN3EahBDmQBbmJvkw3SdGWNOkfkzw0cg-QvBikOhkrw,1348
-fastlifeweb-0.23.0.dist-info/RECORD,,
+fastlifeweb-0.23.1.dist-info/RECORD,,