fastlifeweb 0.25.2__py3-none-any.whl → 0.26.1__py3-none-any.whl

CHANGELOG.md

@@ -1,3 +1,10 @@
+## 0.26.1  - Released on 2025-04-20
+* Add new helpers for the webtestclient element.
+
+## 0.26.0  - Released on 2025-03-08
+* Add a new method to the configuration to customize the request class.
+  See [Configurator.set_request_factory](#fastlife.config.configurator.GenericConfigurator.set_request_factory)
+
 ## 0.25.2  - Released on 2025-03-03
 * Update deps and fix related bugs in JinjaX components.
 

fastlife/__init__.py

@@ -23,6 +23,7 @@ from .config import (
     resource_view,
     view_config,
 )
+from .domain.model.asgi import ASGIRequest, ASGIResponse
 from .domain.model.form import FormModel
 from .domain.model.request import GenericRequest
 from .domain.model.security_policy import (
@@ -36,6 +37,8 @@ from .domain.model.security_policy import (
     NoMFAAuthenticationState,
     PendingMFA,
     PreAuthenticated,
+    TClaimedIdentity,
+    TIdentity,
     Unauthenticated,
     Unauthorized,
 )
@@ -43,6 +46,7 @@ from .domain.model.template import JinjaXTemplate
 
 # from .request.form_data import model
 from .service.registry import DefaultRegistry, GenericRegistry, TRegistry, TSettings
+from .service.request_factory import RequestFactory
 from .service.security_policy import (
     AbstractNoMFASecurityPolicy,
     AbstractSecurityPolicy,
@@ -75,6 +79,10 @@ __all__ = [
     "AnyRequest",
     "Request",
     "get_request",
+    # Request Factory
+    "ASGIRequest",
+    "ASGIResponse",
+    "RequestFactory",
     # Response
     "Response",
     "RedirectResponse",
@@ -94,6 +102,8 @@ __all__ = [
     "Authenticated",
     "AuthenticationState",
     "NoMFAAuthenticationState",
+    "TClaimedIdentity",
+    "TIdentity",
     # Template
     "JinjaXTemplate",
     # i18n

fastlife/adapters/fastapi/routing/route.py

@@ -4,10 +4,8 @@ from collections.abc import Callable, Coroutine
 from typing import TYPE_CHECKING, Any
 
 from fastapi.routing import APIRoute
-from starlette.requests import Request as StarletteRequest
-from starlette.responses import Response
 
-from fastlife.domain.model.request import GenericRequest
+from fastlife.domain.model.asgi import ASGIRequest, ASGIResponse
 
 if TYPE_CHECKING:
     from fastlife.service.registry import DefaultRegistry  # coverage: ignore
@@ -34,14 +32,14 @@ class Route(APIRoute):
 
     def get_route_handler(
         self,
-    ) -> Callable[[StarletteRequest], Coroutine[Any, Any, Response]]:
+    ) -> Callable[[ASGIRequest], Coroutine[Any, Any, ASGIResponse]]:
         """
         Replace the request object by the fastlife request associated with the registry.
         """
         orig_route_handler = super().get_route_handler()
 
-        async def route_handler(request: StarletteRequest) -> Response:
-            req = GenericRequest[Any, Any, Any](self._registry, request)
+        async def route_handler(request: ASGIRequest) -> ASGIResponse:
+            req = self._registry.request_factory(request)
             return await orig_route_handler(req)
 
         return route_handler

fastlife/assets/dist.css

@@ -1,4 +1,5 @@
-/*! tailwindcss v4.0.9 | MIT License | https://tailwindcss.com */
+/*! tailwindcss v4.1.4 | MIT License | https://tailwindcss.com */
+@layer properties;
 @layer theme, base, components, utilities;
 @layer theme {
   :root, :host {
@@ -6,20 +7,20 @@
     'Noto Color Emoji';
     --font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New',
     monospace;
-    --color-red-50: oklch(0.971 0.013 17.38);
-    --color-red-400: oklch(0.704 0.191 22.216);
-    --color-red-700: oklch(0.505 0.213 27.518);
-    --color-orange-500: oklch(0.705 0.213 47.604);
-    --color-neutral-50: oklch(0.985 0 0);
-    --color-neutral-100: oklch(0.97 0 0);
-    --color-neutral-200: oklch(0.922 0 0);
-    --color-neutral-300: oklch(0.87 0 0);
-    --color-neutral-400: oklch(0.708 0 0);
-    --color-neutral-500: oklch(0.556 0 0);
-    --color-neutral-600: oklch(0.439 0 0);
-    --color-neutral-700: oklch(0.371 0 0);
-    --color-neutral-800: oklch(0.269 0 0);
-    --color-neutral-900: oklch(0.205 0 0);
+    --color-red-50: oklch(97.1% 0.013 17.38);
+    --color-red-400: oklch(70.4% 0.191 22.216);
+    --color-red-700: oklch(50.5% 0.213 27.518);
+    --color-orange-500: oklch(70.5% 0.213 47.604);
+    --color-neutral-50: oklch(98.5% 0 0);
+    --color-neutral-100: oklch(97% 0 0);
+    --color-neutral-200: oklch(92.2% 0 0);
+    --color-neutral-300: oklch(87% 0 0);
+    --color-neutral-400: oklch(70.8% 0 0);
+    --color-neutral-500: oklch(55.6% 0 0);
+    --color-neutral-600: oklch(43.9% 0 0);
+    --color-neutral-700: oklch(37.1% 0 0);
+    --color-neutral-800: oklch(26.9% 0 0);
+    --color-neutral-900: oklch(20.5% 0 0);
     --color-white: #fff;
     --spacing: 0.25rem;
     --text-sm: 0.875rem;
@@ -48,11 +49,7 @@
     --default-transition-duration: 150ms;
     --default-transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
     --default-font-family: var(--font-sans);
-    --default-font-feature-settings: var(--font-sans--font-feature-settings);
-    --default-font-variation-settings: var(--font-sans--font-variation-settings);
     --default-mono-font-family: var(--font-mono);
-    --default-mono-font-feature-settings: var(--font-mono--font-feature-settings);
-    --default-mono-font-variation-settings: var(--font-mono--font-variation-settings);
   }
 }
 @layer base {
@@ -66,14 +63,11 @@
     line-height: 1.5;
     -webkit-text-size-adjust: 100%;
     tab-size: 4;
-    font-family: var( --default-font-family, ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji' );
+    font-family: var(--default-font-family, ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji');
     font-feature-settings: var(--default-font-feature-settings, normal);
     font-variation-settings: var(--default-font-variation-settings, normal);
     -webkit-tap-highlight-color: transparent;
   }
-  body {
-    line-height: inherit;
-  }
   hr {
     height: 0;
     color: inherit;
@@ -96,7 +90,7 @@
     font-weight: bolder;
   }
   code, kbd, samp, pre {
-    font-family: var( --default-mono-font-family, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace );
+    font-family: var(--default-mono-font-family, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace);
     font-feature-settings: var(--default-mono-font-feature-settings, normal);
     font-variation-settings: var(--default-mono-font-variation-settings, normal);
     font-size: 1em;
@@ -162,7 +156,14 @@
   }
   ::placeholder {
     opacity: 1;
-    color: color-mix(in oklab, currentColor 50%, transparent);
+  }
+  @supports (not (-webkit-appearance: -apple-pay-button))  or (contain-intrinsic-size: 1px) {
+    ::placeholder {
+      color: currentcolor;
+      @supports (color: color-mix(in lab, red, red)) {
+        color: color-mix(in oklab, currentcolor 50%, transparent);
+      }
+    }
   }
   textarea {
     resize: vertical;
@@ -215,24 +216,6 @@
   .static {
     position: static;
   }
-  .container {
-    width: 100%;
-    @media (width >= 40rem) {
-      max-width: 40rem;
-    }
-    @media (width >= 48rem) {
-      max-width: 48rem;
-    }
-    @media (width >= 64rem) {
-      max-width: 64rem;
-    }
-    @media (width >= 80rem) {
-      max-width: 80rem;
-    }
-    @media (width >= 96rem) {
-      max-width: 96rem;
-    }
-  }
   .m-3 {
     margin: calc(var(--spacing) * 3);
   }
@@ -263,9 +246,6 @@
   .inline {
     display: inline;
   }
-  .table {
-    display: table;
-  }
   .h-4 {
     height: calc(var(--spacing) * 4);
   }
@@ -303,7 +283,7 @@
     rotate: 90deg;
   }
   .transform {
-    transform: var(--tw-rotate-x) var(--tw-rotate-y) var(--tw-rotate-z) var(--tw-skew-x) var(--tw-skew-y);
+    transform: var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,);
   }
   .cursor-pointer {
     cursor: pointer;
@@ -494,18 +474,19 @@
   }
   .focus\:ring-2 {
     &:focus {
-      --tw-ring-shadow: var(--tw-ring-inset,) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color, currentColor);
+      --tw-ring-shadow: var(--tw-ring-inset,) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color, currentcolor);
       box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
     }
   }
   .focus\:ring-4 {
     &:focus {
-      --tw-ring-shadow: var(--tw-ring-inset,) 0 0 0 calc(4px + var(--tw-ring-offset-width)) var(--tw-ring-color, currentColor);
+      --tw-ring-shadow: var(--tw-ring-inset,) 0 0 0 calc(4px + var(--tw-ring-offset-width)) var(--tw-ring-color, currentcolor);
       box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
     }
   }
   .focus\:outline-hidden {
     &:focus {
+      --tw-outline-style: none;
       outline-style: none;
       @media (forced-colors: active) {
         outline: 2px solid transparent;
@@ -618,27 +599,22 @@
 @property --tw-rotate-x {
   syntax: "*";
   inherits: false;
-  initial-value: rotateX(0);
 }
 @property --tw-rotate-y {
   syntax: "*";
   inherits: false;
-  initial-value: rotateY(0);
 }
 @property --tw-rotate-z {
   syntax: "*";
   inherits: false;
-  initial-value: rotateZ(0);
 }
 @property --tw-skew-x {
   syntax: "*";
   inherits: false;
-  initial-value: skewX(0);
 }
 @property --tw-skew-y {
   syntax: "*";
   inherits: false;
-  initial-value: skewY(0);
 }
 @property --tw-space-y-reverse {
   syntax: "*";
@@ -707,6 +683,19 @@
   syntax: "*";
   inherits: false;
 }
+@property --tw-drop-shadow-color {
+  syntax: "*";
+  inherits: false;
+}
+@property --tw-drop-shadow-alpha {
+  syntax: "<percentage>";
+  inherits: false;
+  initial-value: 100%;
+}
+@property --tw-drop-shadow-size {
+  syntax: "*";
+  inherits: false;
+}
 @property --tw-duration {
   syntax: "*";
   inherits: false;
@@ -720,6 +709,11 @@
   syntax: "*";
   inherits: false;
 }
+@property --tw-shadow-alpha {
+  syntax: "<percentage>";
+  inherits: false;
+  initial-value: 100%;
+}
 @property --tw-inset-shadow {
   syntax: "*";
   inherits: false;
@@ -729,6 +723,11 @@
   syntax: "*";
   inherits: false;
 }
+@property --tw-inset-shadow-alpha {
+  syntax: "<percentage>";
+  inherits: false;
+  initial-value: 100%;
+}
 @property --tw-ring-color {
   syntax: "*";
   inherits: false;
@@ -766,3 +765,48 @@
   inherits: false;
   initial-value: 0 0 #0000;
 }
+@layer properties {
+  @supports ((-webkit-hyphens: none) and (not (margin-trim: inline))) or ((-moz-orient: inline) and (not (color:rgb(from red r g b)))) {
+    *, ::before, ::after, ::backdrop {
+      --tw-rotate-x: initial;
+      --tw-rotate-y: initial;
+      --tw-rotate-z: initial;
+      --tw-skew-x: initial;
+      --tw-skew-y: initial;
+      --tw-space-y-reverse: 0;
+      --tw-border-style: solid;
+      --tw-leading: initial;
+      --tw-font-weight: initial;
+      --tw-tracking: initial;
+      --tw-outline-style: solid;
+      --tw-blur: initial;
+      --tw-brightness: initial;
+      --tw-contrast: initial;
+      --tw-grayscale: initial;
+      --tw-hue-rotate: initial;
+      --tw-invert: initial;
+      --tw-opacity: initial;
+      --tw-saturate: initial;
+      --tw-sepia: initial;
+      --tw-drop-shadow: initial;
+      --tw-drop-shadow-color: initial;
+      --tw-drop-shadow-alpha: 100%;
+      --tw-drop-shadow-size: initial;
+      --tw-duration: initial;
+      --tw-shadow: 0 0 #0000;
+      --tw-shadow-color: initial;
+      --tw-shadow-alpha: 100%;
+      --tw-inset-shadow: 0 0 #0000;
+      --tw-inset-shadow-color: initial;
+      --tw-inset-shadow-alpha: 100%;
+      --tw-ring-color: initial;
+      --tw-ring-shadow: 0 0 #0000;
+      --tw-inset-ring-color: initial;
+      --tw-inset-ring-shadow: 0 0 #0000;
+      --tw-ring-inset: initial;
+      --tw-ring-offset-width: 0px;
+      --tw-ring-offset-color: #fff;
+      --tw-ring-offset-shadow: 0 0 #0000;
+    }
+  }
+}

fastlife/config/configurator.py

@@ -44,13 +44,15 @@ from fastlife.shared_utils.resolver import (
 )
 
 if TYPE_CHECKING:
+    from fastlife.service.locale_negociator import LocaleNegociator  # coverage: ignore
+    from fastlife.service.request_factory import (
+        RequestFactoryBuilder,  # coverage: ignore
+    )
     from fastlife.service.security_policy import AbstractSecurityPolicy
     from fastlife.service.templates import (
         AbstractTemplateRendererFactory,  # coverage: ignore
     )
 
-from fastlife.service.locale_negociator import LocaleNegociator
-
 log = logging.getLogger(__name__)
 VENUSIAN_CATEGORY = "fastlife"
 
@@ -175,7 +177,7 @@ class GenericConfigurator(Generic[TRegistry]):
         """
 
         # register our main template renderer at then end, to ensure that
-        # if settings have been manipulated, everythins is taken into account.
+        # if settings have been manipulated, everything is taken into account.
         self.add_renderer(
             self.registry.settings.jinjax_file_ext,
             resolve("fastlife.adapters.jinjax.renderer:JinjaxEngine")(
@@ -260,7 +262,14 @@ class GenericConfigurator(Generic[TRegistry]):
             self._route_prefix = old
         return self
 
-    def set_locale_negociator(self, locale_negociator: LocaleNegociator) -> Self:
+    def set_request_factory(
+        self, request_factory: "RequestFactoryBuilder[TRegistry]"
+    ) -> Self:
+        """Install a request factory, to use a custom request classes."""
+        self.registry.request_factory = request_factory(self.registry)
+        return self
+
+    def set_locale_negociator(self, locale_negociator: "LocaleNegociator") -> Self:
         """Install a locale negociator for the app."""
         self.registry.locale_negociator = locale_negociator
         return self

fastlife/domain/model/asgi.py

@@ -1,3 +1,21 @@
+"""ASGI types from Starlette."""
+
+from starlette.requests import Request
+from starlette.responses import Response
 from starlette.types import ASGIApp, Message, Receive, Scope, Send
 
-__all__ = ["ASGIApp", "Message", "Receive", "Scope", "Send"]
+ASGIRequest = Request
+"""Starlette request class used as ASGI Protocol base HTTP Request representation."""
+
+ASGIResponse = Response
+"""Starlette request class used as ASGI Protocol base HTTP Response representation."""
+
+__all__ = [
+    "ASGIApp",
+    "ASGIRequest",
+    "ASGIResponse",
+    "Message",
+    "Receive",
+    "Scope",
+    "Send",
+]

fastlife/domain/model/request.py

@@ -2,8 +2,7 @@
 
 from typing import TYPE_CHECKING, Any, Generic
 
-from starlette.requests import Request as BaseRequest
-
+from fastlife.domain.model.asgi import ASGIRequest
 from fastlife.domain.model.csrf import CSRFToken, create_csrf_token
 from fastlife.domain.model.security_policy import TClaimedIdentity, TIdentity
 from fastlife.service.registry import TRegistry
@@ -15,7 +14,7 @@ if TYPE_CHECKING:
     )
 
 
-class GenericRequest(BaseRequest, Generic[TRegistry, TIdentity, TClaimedIdentity]):
+class GenericRequest(ASGIRequest, Generic[TRegistry, TIdentity, TClaimedIdentity]):
     """HTTP Request representation."""
 
     registry: TRegistry
@@ -30,7 +29,7 @@ class GenericRequest(BaseRequest, Generic[TRegistry, TIdentity, TClaimedIdentity
 
     renderer_globals: dict[str, Any]
 
-    def __init__(self, registry: TRegistry, request: BaseRequest) -> None:
+    def __init__(self, registry: TRegistry, request: ASGIRequest) -> None:
         super().__init__(request.scope, request.receive)
         self.registry = registry
         self.locale_name = registry.locale_negociator(self)

fastlife/service/__init__.py

@@ -0,0 +1 @@
+"""A collection of service."""

fastlife/service/check_permission.py

@@ -1,4 +1,4 @@
-"""Security policy."""
+"""Security policy permission routine."""
 
 from collections.abc import Callable, Coroutine
 from typing import Any

fastlife/service/locale_negociator.py

@@ -8,12 +8,10 @@ from fastlife.settings import Settings
 LocaleName = str
 """The LocaleName is a locale such as en, fr that will be consume for translations."""
 
-from fastlife.adapters.fastapi.request import GenericRequest  # coverage: ignore
+from fastlife.adapters.fastapi.request import GenericRequest
 
-LocaleNegociator = Callable[
-    [GenericRequest[Any, Any, Any]], LocaleName
-]  # coverage: ignore
-"""Interface to implement to negociate a locale"""  # coverage: ignore
+LocaleNegociator = Callable[[GenericRequest[Any, Any, Any]], LocaleName]
+"""Interface to implement to negociate a locale"""
 
 
 def default_negociator(settings: Settings) -> LocaleNegociator:

fastlife/service/registry.py

@@ -1,3 +1,5 @@
+"""Application registry."""
+
 from collections.abc import AsyncIterator, Mapping
 from contextlib import asynccontextmanager
 from typing import TYPE_CHECKING, Any, Generic, TypeVar
@@ -6,6 +8,7 @@ from fastapi import FastAPI
 
 if TYPE_CHECKING:
     from fastlife.service.locale_negociator import LocaleNegociator  # coverage: ignore
+    from fastlife.service.request_factory import RequestFactory  # coverage: ignore
     from fastlife.service.templates import (  # coverage: ignore
         AbstractTemplateRendererFactory,  # coverage: ignore
     )  # coverage: ignore
@@ -33,15 +36,18 @@ class GenericRegistry(Generic[TSettings]):
     """Used to fine the best language for the response."""
     localizer: "LocalizerFactory"
     """Used to localized message."""
+    request_factory: "RequestFactory"
 
     def __init__(self, settings: TSettings) -> None:
         from fastlife.service.locale_negociator import default_negociator
+        from fastlife.service.request_factory import default_request_factory
         from fastlife.service.translations import LocalizerFactory
 
         self.settings = settings
         self.locale_negociator = default_negociator(self.settings)
         self.renderers = {}
         self.localizer = LocalizerFactory()
+        self.request_factory = default_request_factory(self)
 
     def get_renderer(self, template: str) -> "AbstractTemplateRendererFactory":
         for key, val in self.renderers.items():

fastlife/service/request_factory.py

@@ -0,0 +1,26 @@
+"""Customize the request class."""
+
+from collections.abc import Callable
+from typing import Any
+
+from fastlife.domain.model.asgi import ASGIRequest
+from fastlife.domain.model.request import GenericRequest
+from fastlife.service.registry import DefaultRegistry, TRegistry
+
+RequestFactory = Callable[[ASGIRequest], GenericRequest[Any, Any, Any]]
+"""
+Transform the [ASGIRequest](#fastlife.domain.model.asgi.ASGIRequest)
+object to the fastlife [GenericRequest](#fastlife.domain.model.request.GenericRequest).
+"""
+
+RequestFactoryBuilder = Callable[[TRegistry], RequestFactory]
+"""Interface to implement to create a request factory"""
+
+
+def default_request_factory(registry: DefaultRegistry) -> RequestFactory:
+    """The default request factory the return the generic request."""
+
+    def request(request: ASGIRequest) -> GenericRequest[Any, Any, Any]:
+        return GenericRequest[Any, Any, Any](registry, request)
+
+    return request

fastlife/service/translations.py

@@ -1,3 +1,5 @@
+"""Implement i18n."""
+
 import pathlib
 from collections import defaultdict
 from collections.abc import Callable, Iterator
@@ -15,7 +17,7 @@ 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.
+    {class}`fastlife.service.translations.TranslatableStringFactory` class.
     """
 
     __slots__ = ("domain",)

fastlife/testing/dom.py

@@ -2,7 +2,7 @@
 
 import re
 from collections.abc import Iterator, Sequence
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Literal, overload
 
 import bs4
 
@@ -82,10 +82,19 @@ class Element:
             el = el.parent
         return None
 
-    def by_text(self, text: str, *, node_name: str | None = None) -> "Element | None":
+    def by_text(
+        self, text: str, *, node_name: str | None = None, position: int | None = None
+    ) -> "Element | None":
         """Find the first element that match the text."""
         nodes = self.iter_all_by_text(text, node_name=node_name)
-        return next(nodes, None)
+        ret = list(nodes)
+        if not ret:
+            return None
+        if position is None:
+            assert len(ret) == 1, f"Should have 1 element, got {len(ret)} in {self}"
+        else:
+            assert len(ret) > position, "Not enough element found"
+        return ret[position or 0]
 
     def iter_all_by_text(
         self, text: str, *, node_name: str | None = None
@@ -121,17 +130,60 @@ class Element:
         assert not isinstance(resp, bs4.NavigableString)
         return Element(self._client, resp) if resp else None
 
+    def by_id(self, id: str) -> "Element | None":
+        """Find the element having the given id."""
+        resp = self._tag.find_all(id=id)
+        assert not isinstance(resp, bs4.NavigableString)
+        if not resp:
+            return None
+        assert len(resp) == 1
+        return Element(self._client, resp[0]) if resp else None
+
+    @overload
+    def by_node_name(
+        self,
+        node_name: str,
+        *,
+        attrs: dict[str, str] | None = None,
+        multiple: Literal[False],
+    ) -> "Element": ...
+
+    @overload
+    def by_node_name(
+        self,
+        node_name: str,
+        *,
+        attrs: dict[str, str] | None = None,
+        multiple: Literal[True],
+    ) -> "list[Element]": ...
+
+    @overload
+    def by_node_name(
+        self,
+        node_name: str,
+        *,
+        attrs: dict[str, str] | None = None,
+    ) -> "list[Element]": ...
+
     def by_node_name(
-        self, node_name: str, *, attrs: dict[str, str] | None = None
-    ) -> list["Element"]:
+        self,
+        node_name: str,
+        *,
+        attrs: dict[str, str] | None = None,
+        multiple: bool = True,
+    ) -> "list[Element] | Element":
         """
         Return the list of elements with the given node_name.
 
         An optional set of attributes may given and must match if passed.
         """
-        return [
+        ret = [
             Element(self._client, e) for e in self._tag.find_all(node_name, attrs or {})
         ]
+        if not multiple:
+            assert len(ret) == 1
+            return ret[0]
+        return ret
 
     def __repr__(self) -> str:
         return f"<{self.node_name}>"

fastlife/testing/testclient.py

@@ -79,9 +79,11 @@ class WebResponse:
             self._form = WebForm(self._client, self._origin, form)
         return self._form
 
-    def by_text(self, text: str, *, node_name: str | None = None) -> Element | None:
+    def by_text(
+        self, text: str, *, node_name: str | None = None, position: int | None = None
+    ) -> Element | None:
         """Search a dom element by its text."""
-        return self.html.by_text(text, node_name=node_name)
+        return self.html.by_text(text, node_name=node_name, position=position)
 
     def by_label_text(self, text: str) -> Element | None:
         """Search a dom element by its associated label text."""

{fastlifeweb-0.25.2.dist-info → fastlifeweb-0.26.1.dist-info}/METADATA

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

{fastlifeweb-0.25.2.dist-info → fastlifeweb-0.26.1.dist-info}/RECORD

@@ -1,5 +1,5 @@
-CHANGELOG.md,sha256=lrPhY2hvBQErCpC_v376kDsXv_K2LTj4DgK7XWC_dsk,8373
-fastlife/__init__.py,sha256=nXWE4AbhkhG_yBjPJU-XnKDMTsU9ebv7Vj4eIciWQI0,2219
+CHANGELOG.md,sha256=T96sQ3Cf4MXmutaDj0-js6kwr0hVzDJA9krCjrV557g,8680
+fastlife/__init__.py,sha256=IZ9VQvlBduZ3WjfDk05rZNdCKNxWWqPaMvG0ZWtMTpU,2489
 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
@@ -7,7 +7,7 @@ fastlife/adapters/fastapi/form_data.py,sha256=2DQ0o-RvY6iROUKQjS-UJdNYEVSsNPd-Aj
 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
+fastlife/adapters/fastapi/routing/route.py,sha256=33nk0mf9eTOrdyQfeoOGOs5153TzT227sem0THWvr8k,1367
 fastlife/adapters/fastapi/routing/router.py,sha256=jzrnU_Lyywu21e3spPaWQw8ujZh_Yy_EJOojcCi6ew4,499
 fastlife/adapters/itsdangerous/__init__.py,sha256=7ocGY7v0cxooZBKQYjA2JkmzRqiBvcU1uzA84UsTVAI,84
 fastlife/adapters/itsdangerous/session.py,sha256=9h_WRsXqZbytHZOv5B_K3OWD5mbfYzxHulXoOf6D2MI,1685
@@ -42,7 +42,7 @@ fastlife/adapters/jinjax/widgets/model.py,sha256=YBIEWa_6mnmrBnesXjLTrpJ4drUS2CI
 fastlife/adapters/jinjax/widgets/sequence.py,sha256=dVoHQmHloaRuU1Sd82b2jnO8WDfdwM2FaZlLCJCps1o,2566
 fastlife/adapters/jinjax/widgets/text.py,sha256=TfmlJU233aZWIl-4cmm-f-pFxp6ycHWHnbiluOvRDgM,3040
 fastlife/adapters/jinjax/widgets/union.py,sha256=roCoFA82dLjF1XFW6UYaV7SCQWdFsSAT8Ux7KEB6_Us,2602
-fastlife/assets/dist.css,sha256=BkGYK48Fmy7t3-KMKlpGnpjmpJpxQ4D6QUNlfmtVbU8,18432
+fastlife/assets/dist.css,sha256=d2ez-igscOaeYtJQc2FQuXlN17cYX13sUansFdg_kdA,19753
 fastlife/assets/source.css,sha256=0KtDcsKHj9LOcqNR1iv9pACwNBaNWkieEDqqjkgNL_s,47
 fastlife/components/A.jinja,sha256=MDNJ2auIeYbpNeErvJdlGid4nIKfbi85ArmMgChsCJU,1384
 fastlife/components/Button.jinja,sha256=itKU-ct45XissU33yfmTekyHsNe00fr4RQL-e9cxbgU,2305
@@ -1690,17 +1690,17 @@ fastlife/components/pydantic_form/FatalError.jinja,sha256=ADtQvmo-e-NmDcFM1E6wZV
 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=wlgSfbKoeBzk5kmCnftmrgVV8CWQhxoioBZeuRTPZ64,24779
+fastlife/config/configurator.py,sha256=2LkPXoarMTk40S7AVlxODPAckDllE0G8u27jtPmvGM8,25188
 fastlife/config/exceptions.py,sha256=9MdBnbfy-Aw-KaIFzju0Kh8Snk41-v9LqK2w48Tdy1s,1169
 fastlife/config/openapiextra.py,sha256=rYoerrn9sni2XwnO3gIWqaz7M0aDZPhVLjzqhDxue0o,514
 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
-fastlife/domain/model/asgi.py,sha256=RSTnfTsofOmCaWzHNuRGowjlyHYmoDCrXFbvNY_B55k,129
+fastlife/domain/model/asgi.py,sha256=Cz45TZOtrh2pBVZr37aJ9jpnJH9BeNHrsvk9bq1nBc0,526
 fastlife/domain/model/csrf.py,sha256=BUiWK-S7rVciWHO1qTkM8e_KxzpF6gGC4MMJK1v6iDo,414
 fastlife/domain/model/form.py,sha256=JP6uumlZBYhiPxzcdxOsfsFm5BRfvkDFvlUCD6Vy8dI,3275
-fastlife/domain/model/request.py,sha256=ZRHZW_MOmtO_DFHt2UYu_aUmtoMdD14085A8Z8_eS8s,2678
+fastlife/domain/model/request.py,sha256=HgUSnUu3q18e07y57PadN3pPQwYrIZS1YEhYkBZ_Zfg,2674
 fastlife/domain/model/security_policy.py,sha256=f9SLi54vvRU-KSPJ5K0unoqYpkxIyzuZjKf2Ylwf5Rg,4796
 fastlife/domain/model/template.py,sha256=z9oxdKme1hMPuvk7mBiKR_tuVY8TqH77aTYqMgvEGl8,876
 fastlife/domain/model/types.py,sha256=64jJKFAi5x0e3vr8naHU1m_as0Qy8MS-s9CG0z6K1qc,381
@@ -1712,29 +1712,29 @@ fastlife/middlewares/session/__init__.py,sha256=ZhXWXs53A__F9wJKBJ87rW8Qyt5Mn866
 fastlife/middlewares/session/middleware.py,sha256=tzaJHLT3ri9sstrppATu8MWXUALTq54PsNKU0v5DTBI,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/__init__.py,sha256=SfM2eSrMjDx6safjBc2LVFty4Wy2H1ZsHQSHeDcZ7dU,31
+fastlife/service/check_permission.py,sha256=WodiDVTnY-dZmTfbQV-YmJfPOLtE07mfqvG6jvL0xeA,1828
 fastlife/service/csrf.py,sha256=wC1PaKOmZ3il0FF_kevxnlg9PxDqruRdLrNnOA3ZHrU,1886
-fastlife/service/locale_negociator.py,sha256=JUqzTukxDqTJVOR-CNI7Vqo6kvdvwxYvZQe8P3V9S2U,796
-fastlife/service/registry.py,sha256=3lm7aUD7FdlV1lQUS73OuBlL55-O1DulPJdE0n6Epks,2648
+fastlife/service/locale_negociator.py,sha256=4HifgNkyI7DxR3_IdSUMG0UUY-JZeQsJ_MMSqiyFzgc,730
+fastlife/service/registry.py,sha256=0r8dVCF44JUugRctL9sDQjnHDV7SepH06OfkV6KE-4s,2937
+fastlife/service/request_factory.py,sha256=9o4B_78qrKPXQAq8A_RDhzAqCHdt6arV96Bq_JByyIM,931
 fastlife/service/security_policy.py,sha256=qYXs4mhfz_u4x59NhUkirqKYKQbFv9YrzyRuXj7mxE0,4688
 fastlife/service/templates.py,sha256=xNMKH-jNkEoCscO04H-QlzTqg-0pYbF_fc65xG-2rzs,2575
-fastlife/service/translatablestring.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-fastlife/service/translations.py,sha256=s6qFZSXR-1vYxSr7RRH-mS-VjNaa8OTxR7-k6Ib7h0E,6878
+fastlife/service/translations.py,sha256=cAfvUlLM3KcgQjlD9PtEpZpTMctXKM_CUAmUeKw9n4M,6901
 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
 fastlife/shared_utils/resolver.py,sha256=Wb9cO2MWavpti63hju15xmwFMgaD5DsQaxikRpB39E8,3713
 fastlife/template_globals.py,sha256=bKcj6kSnQlzuOeoILA5oRxxzy6CsrBFMZv9S0w5XlTQ,9021
 fastlife/testing/__init__.py,sha256=VpxkS3Zp3t_hH8dBiLaGFGhsvt511dhBS_8fMoFXdmU,99
-fastlife/testing/dom.py,sha256=dVzDoZokn-ii681UaEwAr-khM5KE-CHgXSSLSo24oH0,4489
+fastlife/testing/dom.py,sha256=q2GFrHWjwKMMTR0dsP3J-rXSxojZy8rOQ-07h2gfLKA,5869
 fastlife/testing/form.py,sha256=diiGfVMfNt19JTNUxlnbGfcbskR3ZMpk0Y-A57vfShc,7871
 fastlife/testing/session.py,sha256=LEFFbiR67_x_g-ioudkY0C7PycHdbDfaIaoo_G7GXQ8,2226
-fastlife/testing/testclient.py,sha256=Id1tlA1ZapyW-8kUh2_U3lLteL64m3ERqOO7NAN7HEY,6922
+fastlife/testing/testclient.py,sha256=4LLw_QchEzdcdIobtIEzCABNebzyzVPEMj1tjdXQU_Y,6984
 fastlife/views/__init__.py,sha256=zG8gveL8e2zBdYx6_9jtZfpQ6qJT-MFnBY3xXkLwHZI,22
 fastlife/views/pydantic_form.py,sha256=o7EUItciAGL1OSaGNHo-3BTrYAk34GuWE7zGikjiAGY,1486
-fastlifeweb-0.25.2.dist-info/METADATA,sha256=szZ9s9Rv4714GIS8XeM0PAWN9EbGfZ5qX7T6TcjaMhE,3690
-fastlifeweb-0.25.2.dist-info/WHEEL,sha256=thaaA2w1JzcGC48WYufAs8nrYZjJm8LqNfnXFOFyCC4,90
-fastlifeweb-0.25.2.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
-fastlifeweb-0.25.2.dist-info/licenses/LICENSE,sha256=JFWuiKYRXKKMEAsX0aZp3hBcju-HYflJ2rwJAGwbCJo,1080
-fastlifeweb-0.25.2.dist-info/RECORD,,
+fastlifeweb-0.26.1.dist-info/METADATA,sha256=ZrtYyrVue0a2wbR9S0wALG-3COPtbvSZVKHitRfu3t4,3690
+fastlifeweb-0.26.1.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
+fastlifeweb-0.26.1.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+fastlifeweb-0.26.1.dist-info/licenses/LICENSE,sha256=JFWuiKYRXKKMEAsX0aZp3hBcju-HYflJ2rwJAGwbCJo,1080
+fastlifeweb-0.26.1.dist-info/RECORD,,

{fastlifeweb-0.25.2.dist-info → fastlifeweb-0.26.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: pdm-backend (2.4.3)
+Generator: pdm-backend (2.4.4)
 Root-Is-Purelib: true
 Tag: py3-none-any

fastlife/service/translatablestring.py

@@ -1 +0,0 @@
-