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

CHANGELOG.md

@@ -1,3 +1,10 @@
+## 0.24.0  - Released on 2025-01-17
+* Add a way to hook the lifespan to the app
+
+## 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

@@ -191,6 +191,7 @@ class GenericConfigurator(Generic[TRegistry]):
             dependencies=[Depends(check_csrf())],
             docs_url=self.api_swagger_ui_url,
             redoc_url=self.api_redoc_url,
+            lifespan=self.registry.lifespan,
             openapi_tags=[tag.model_dump(by_alias=True) for tag in self.tags.values()]
             if self.tags
             else None,
@@ -473,7 +474,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/config/resources.py

@@ -124,13 +124,7 @@ def resource(
                             config, method, collection_path, getattr(api, method)
                         )
                     case (
-                        "get"
-                        | "post"
-                        | "put"
-                        | "patch"
-                        | "delete"
-                        | "head"
-                        | "options"
+                        "get" | "post" | "put" | "patch" | "delete" | "head" | "options"
                     ):
                         bind_config(config, method, path, getattr(api, method))
                     case _:

fastlife/middlewares/session/middleware.py

@@ -72,7 +72,7 @@ class SessionMiddleware(AbstractMiddleware):
                     headers = MutableHeaders(scope=message)
                     expires = "expires=Thu, 01 Jan 1970 00:00:00 GMT; "
                     header_value = (
-                        f"{self.cookie_name}=; " f"{expires}{self.security_flags}"
+                        f"{self.cookie_name}=; {expires}{self.security_flags}"
                     )
                     headers.append("set-cookie", header_value)
             await send(message)

fastlife/service/registry.py

@@ -1,5 +1,8 @@
-from collections.abc import Mapping
-from typing import TYPE_CHECKING, Generic, TypeVar
+from collections.abc import AsyncIterator, Mapping
+from contextlib import asynccontextmanager
+from typing import TYPE_CHECKING, Any, Generic, TypeVar
+
+from fastapi import FastAPI
 
 if TYPE_CHECKING:
     from fastlife.service.locale_negociator import LocaleNegociator  # coverage: ignore
@@ -22,7 +25,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 +34,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
 
@@ -46,6 +49,19 @@ class GenericRegistry(Generic[TSettings]):
                 return val
         raise RuntimeError(f"No renderer registered for template {template}")
 
+    @asynccontextmanager
+    async def lifespan(self, app: FastAPI) -> AsyncIterator[Any]:
+        """
+        hook to override the lifespan of the starlette app.
+
+        The [lifespan](https://asgi.readthedocs.io/en/latest/specs/lifespan.html)
+        is used to initialized and dispose the application state.
+
+        In fastlife the application state is the registry, it has to be overriden
+        to add an implementation.
+        """
+        yield
+
 
 DefaultRegistry = GenericRegistry[Settings]
 """

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/form.py

@@ -109,7 +109,7 @@ class WebForm:
             raise ValueError(f'"{fieldname}" does not exists')
         field = self._formfields[fieldname]
         if field.node_name != "select":
-            raise ValueError(f"{fieldname} is a {field!r}, " "use set() instead")
+            raise ValueError(f"{fieldname} is a {field!r}, use set() instead")
 
         for option in field.by_node_name("option"):
             if option.text == value.strip():

fastlife/testing/testclient.py

@@ -1,7 +1,7 @@
 """Testing your application."""
 
 from collections.abc import Mapping, MutableMapping
-from typing import Any, Literal
+from typing import Any, Literal, Self
 from urllib.parse import urlencode
 
 import bs4
@@ -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(
@@ -208,3 +208,10 @@ class WebTestClient:
             headers={"Content-Type": "application/x-www-form-urlencoded", **headers},
             max_redirects=int(follow_redirects) * 10,
         )
+
+    def __enter__(self) -> Self:
+        self.testclient.__enter__()
+        return self
+
+    def __exit__(self, *args: Any, **kwargs: Any) -> None:
+        self.testclient.__exit__()

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

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

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

@@ -1,10 +1,10 @@
-CHANGELOG.md,sha256=Ap14kfVx07rFhITGDmtQfwEsJowg5osxKETE0w478lU,7801
-fastlife/__init__.py,sha256=cx3BScbBelH-Tm63VPdAp5siW1fBZ0uOMwNW_SPs2xQ,2126
+CHANGELOG.md,sha256=1gHbqLrx79ltwysUaPw25Sp6Aqz5nbyZK_qcgJxc6Og,7952
+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,10 +1686,10 @@ 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=wlgSfbKoeBzk5kmCnftmrgVV8CWQhxoioBZeuRTPZ64,24779
 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
+fastlife/config/resources.py,sha256=EcPTM25pnHcGFTtXjeZnWn5Mo_-8rhJ72HJ6rxnjPg8,8389
 fastlife/config/views.py,sha256=9CZ0qNi8vKvQuGo1GgM6cwNK8WwHOxwIHqtikAOaOHY,2399
 fastlife/domain/__init__.py,sha256=3zDDos5InVX0el9OO0lgSDGzdUNYIhlA6w4uhBh2pF8,29
 fastlife/domain/model/__init__.py,sha256=aoBjaSpDscuFXvtknJHwiNyoJRUpE-v4X54h_wNuo2Y,27
@@ -1705,17 +1705,18 @@ fastlife/middlewares/base.py,sha256=7FZE_1YU7wNew2u1qdYXjamosk4CXJmg1mJWGp6Xhc0,
 fastlife/middlewares/reverse_proxy/__init__.py,sha256=g1SoVDmenKzpAAPYHTEsWgdBByOxtLg9fGx6RV3i0ok,846
 fastlife/middlewares/reverse_proxy/x_forwarded.py,sha256=PPDjcfwik5eoYaolSY1Y4x5QMKpDV0XrOP_i4Am0y30,1724
 fastlife/middlewares/session/__init__.py,sha256=ZhXWXs53A__F9wJKBJ87rW8Qyt5Mn866vhzKDxVZ4t0,1348
-fastlife/middlewares/session/middleware.py,sha256=ituZ5hNipDMkgCXNE4zbnmOcWEF151sucPo4I_FpY-I,3137
+fastlife/middlewares/session/middleware.py,sha256=MyZ0MobhlnGiqacYq0pPYBrlqCjTkWjpNXNeFyPD1fI,3133
 fastlife/middlewares/session/serializer.py,sha256=nbJGiCJ_ryZxkW1I28kmK6hD3U98D4ZlUQA7B8_tngQ,635
 fastlife/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fastlife/service/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 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=3lm7aUD7FdlV1lQUS73OuBlL55-O1DulPJdE0n6Epks,2648
 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
@@ -1723,14 +1724,14 @@ fastlife/shared_utils/resolver.py,sha256=Wb9cO2MWavpti63hju15xmwFMgaD5DsQaxikRpB
 fastlife/template_globals.py,sha256=rJ7XB9DlPubejs_GDlEyO9V98QZTJnmdTznlguYOyoc,8386
 fastlife/testing/__init__.py,sha256=VpxkS3Zp3t_hH8dBiLaGFGhsvt511dhBS_8fMoFXdmU,99
 fastlife/testing/dom.py,sha256=dVzDoZokn-ii681UaEwAr-khM5KE-CHgXSSLSo24oH0,4489
-fastlife/testing/form.py,sha256=ST0xNCoUqz_oD92cWHzQ6CbJ5hFopvu_NNKpOfiuYWY,7874
+fastlife/testing/form.py,sha256=diiGfVMfNt19JTNUxlnbGfcbskR3ZMpk0Y-A57vfShc,7871
 fastlife/testing/session.py,sha256=LEFFbiR67_x_g-ioudkY0C7PycHdbDfaIaoo_G7GXQ8,2226
-fastlife/testing/testclient.py,sha256=JTIgeMKooA8L4gEodeC3gy4Lo27y3WNswSEIKLlVVPs,6745
+fastlife/testing/testclient.py,sha256=Id1tlA1ZapyW-8kUh2_U3lLteL64m3ERqOO7NAN7HEY,6922
 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.24.0.dist-info/METADATA,sha256=a4Pp2mA7yCIvBnvF7Jrrt0jzQRX7ousymKDpb1slGfY,3663
+fastlifeweb-0.24.0.dist-info/WHEEL,sha256=thaaA2w1JzcGC48WYufAs8nrYZjJm8LqNfnXFOFyCC4,90
+fastlifeweb-0.24.0.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+fastlifeweb-0.24.0.dist-info/licenses/LICENSE,sha256=NlRX9Z-dcv8X1VFW9odlIQBbgNN9pcO94XzvKp2R16o,1075
 tailwind.config.js,sha256=EN3EahBDmQBbmJvkw3SdGWNOkfkzw0cg-QvBikOhkrw,1348
-fastlifeweb-0.23.0.dist-info/RECORD,,
+fastlifeweb-0.24.0.dist-info/RECORD,,