fastlifeweb 0.26.2__tar.gz → 0.27.1__tar.gz

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.27.1  - Released on 2025-07-10
+* Add response_model to @resource_view in order to document views that use StreamResponse.
+
+## 0.27.0  - Released on 2025-04-24
+* Add i18n support on pydantic form.
+
 ## 0.26.2  - Released on 2025-04-20
 * Add a RedirectResponse class that is htmx friendly and P/R/G pattern friendly.
 * Fix documentation generation.

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastlifeweb
-Version: 0.26.2
+Version: 0.27.1
 Summary: High-level web framework
 Author-Email: Guillaume Gauvrit <guillaume@gauvr.it>
 License: MIT
@@ -77,7 +77,7 @@ to maintain and scale your project.
 
 ## Tests
 
-Fastlife come with [a test client](https://mardiros.github.io/fastlife/develop/fastlife/fastlife.testing.testclient.html) that can interact with html inside unit tests.
+Fastlife comes with [a test client](https://mardiros.github.io/fastlife/develop/fastlife/fastlife.testing.testclient.html) that can interact with html inside unit tests.
 
 
 ## Try it

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/README.md

@@ -39,7 +39,7 @@ to maintain and scale your project.
 
 ## Tests
 
-Fastlife come with [a test client](https://mardiros.github.io/fastlife/develop/fastlife/fastlife.testing.testclient.html) that can interact with html inside unit tests.
+Fastlife comes with [a test client](https://mardiros.github.io/fastlife/develop/fastlife/fastlife.testing.testclient.html) that can interact with html inside unit tests.
 
 
 ## Try it

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/pyproject.toml

@@ -14,7 +14,7 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
     "Typing :: Typed",
 ]
-version = "0.26.2"
+version = "0.27.1"
 requires-python = ">=3.11"
 dependencies = [
     "fastapi[standard] >=0.115.4,<0.116.0",

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/adapters/jinjax/widgets/base.py

@@ -55,7 +55,7 @@ class Widget(JinjaXTemplate, Generic[T]):
     aria_label: str | None = Field(default=None)
     "Non visible text alternative."
     token: str = Field(default="")
-    "unique token to ensure id are unique in the DOM."
+    "Unique token to ensure id are unique in the DOM."
     removable: bool = Field(default=False)
     "Indicate that the widget is removable from the dom."
 

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/adapters/jinjax/widgets/boolean.py

@@ -16,7 +16,7 @@ class BooleanWidget(Widget[bool]):
         <div class="flex items-center">
          <Checkbox :name="name" :id="id" :checked="value" value="1" />
          <Label :for="id" class="ms-2 text-base text-neutral-900 dark:text-white">
-            {{title|safe}}
+            {{ gettext(title)|safe }}
           </Label>
         </div>
        <pydantic_form.Error :text="error" />

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/adapters/jinjax/widgets/checklist.py

@@ -40,7 +40,7 @@ class ChecklistWidget(Widget[Sequence[Checkable]]):
       <div class="pt-4">
         <Details>
           <Summary :id="id + '-summary'">
-            <H3 :class="H3_SUMMARY_CLASS">{{title}}</H3>
+            <H3 :class="H3_SUMMARY_CLASS">{{ gettext(title) }}</H3>
             <pydantic_form.Error :text="error" />
           </Summary>
           <div>
@@ -52,7 +52,7 @@ class ChecklistWidget(Widget[Sequence[Checkable]]):
                     :checked="value.checked" />
                 <Label :for="value.id"
                     class="ms-2 text-base text-neutral-900 dark:text-white">
-                    {{- value.label -}}
+                    {{- gettext(value.label) -}}
                 </Label>
                 <pydantic_form.Error :text="value.error" />
             </div>

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/adapters/jinjax/widgets/dropdown.py

@@ -17,12 +17,12 @@ class DropDownWidget(Widget[str]):
     template = """
     <pydantic_form.Widget :widget_id="id" :removable="removable">
       <div class="pt-4">
-        <Label :for="id">{{title}}</Label>
+        <Label :for="id">{{ gettext(title) }}</Label>
         <Select :name="name" :id="id">
           {%- for opt in options -%}
           <Option :value="opt.value" id={{id + "-" + opt.value.replace(" ", " -")}}
             :selected="value==opt.value">
-            {{- opt.text -}}
+            {{- gettext(opt.text) -}}
           </Option>
           {%- endfor -%}
         </Select>

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/adapters/jinjax/widgets/mfa_code.py

@@ -11,7 +11,7 @@ class MFACodeWidget(Widget[str]):
     template = """
     <pydantic_form.Widget :widget_id="id" :removable="removable">
       <div class="pt-4">
-        <Label :for="id">{{title}}</Label>
+        <Label :for="id">{{ gettext(title) }}</Label>
         <pydantic_form.Error :text="error" />
         <Input :name="name" type="text" :id="id" inputmode="numeric"
             autocomplete="one-time-code" :autofocus="autofocus"

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/adapters/jinjax/widgets/model.py

@@ -17,7 +17,7 @@ class ModelWidget(Widget[Sequence[TWidget]]):
         {% if nested %}
         <Details>
         <Summary :id="id + '-summary'">
-            <H3 :class="H3_SUMMARY_CLASS">{{title}}</H3>
+            <H3 :class="H3_SUMMARY_CLASS">{{ gettext(title) }}</H3>
             <pydantic_form.Error :text="error" />
         </Summary>
         <div>

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/adapters/jinjax/widgets/sequence.py

@@ -14,7 +14,7 @@ class SequenceWidget(Widget[Sequence[TWidget]]):
     <pydantic_form.Widget :widget_id="id" :removable="removable">
       <Details :id="id">
         <Summary :id="id + '-summary'">
-          <H3 :class="H3_SUMMARY_CLASS">{{title}}</H3>
+          <H3 :class="H3_SUMMARY_CLASS">{{ gettext(title) }}</H3>
           <pydantic_form.Error :text="error" />
         </Summary>
         <div>

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/adapters/jinjax/widgets/text.py

@@ -15,7 +15,7 @@ class TextWidget(Widget[Builtins]):
     template = """
     <pydantic_form.Widget :widget_id="id" :removable="removable">
       <div class="pt-4">
-        <Label :for="id">{{title}}</Label>
+        <Label :for="id">{{ gettext(title) }}</Label>
         <pydantic_form.Error :text="error" />
         <Input :name="name" :value="value" :type="input_type" :id="id"
           :aria-label="aria_label" :placeholder="placeholder"
@@ -26,19 +26,22 @@ class TextWidget(Widget[Builtins]):
     """
 
     input_type: str = Field(default="text")
+    """type attribute for the Input component."""
     placeholder: str | None = Field(default=None)
+    """placeholder attribute for the Input component."""
     autocomplete: str | None = Field(default=None)
+    """autocomplete attribute for the Input component."""
 
 
 class PasswordWidget(Widget[SecretStr]):
     """
-    Widget for text like field (email, ...).
+    Widget for password fields.
     """
 
     template = """
     <pydantic_form.Widget :widget_id="id" :removable="removable">
       <div class="pt-4">
-        <Label :for="id">{{title}}</Label>
+        <Label :for="id">{{ gettext(title) }}</Label>
         <pydantic_form.Error :text="error" />
         <Password :name="name" :type="input_type" :id="id"
           autocomplete={{
@@ -51,8 +54,13 @@ class PasswordWidget(Widget[SecretStr]):
     """
 
     input_type: str = Field(default="password")
+    """type attribute for the Input component."""
     placeholder: str | None = Field(default=None)
+    """placeholder attribute for the Input component."""
     new_password: bool = Field(default=False)
+    """
+    Adapt autocomplete behavior for browsers to hint existing or generate password.
+    """
 
 
 class TextareaWidget(Widget[str | Sequence[str]]):
@@ -81,7 +89,7 @@ class TextareaWidget(Widget[str | Sequence[str]]):
     template = """
     <pydantic_form.Widget :widget_id="id" :removable="removable">
       <div class="pt-4">
-        <Label :for="id">{{title}}</Label>
+        <Label :for="id">{{ gettext(title) }}</Label>
         <pydantic_form.Error :text="error" />
         <Textarea :name="name" :id="id" :aria-label="aria_label">
             {%- if value is string -%}
@@ -94,5 +102,3 @@ class TextareaWidget(Widget[str | Sequence[str]]):
       </div>
     </pydantic_form.Widget>
     """
-
-    placeholder: str = Field(default="")

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/adapters/jinjax/widgets/union.py

@@ -23,7 +23,7 @@ class UnionWidget(Widget[TWidget]):
       <div id="{{id}}">
         <Details>
           <Summary :id="id + '-union-summary'">
-            <H3 :class="H3_SUMMARY_CLASS">{{title}}</H3>
+            <H3 :class="H3_SUMMARY_CLASS">{{ gettext(title) }}</H3>
             <pydantic_form.Error :text="error" />
           </Summary>
           <div hx-sync="this" id="{{id}}-child">
@@ -37,7 +37,7 @@ class UnionWidget(Widget[TWidget]):
                 :hx-vals="typ.params|tojson"
                 :id="typ.id"
                 onclick={{ "document.getElementById('" + id + "-remove-btn').hidden=false" }}
-              :class="SECONDARY_BUTTON_CLASS">{{typ.title}}</Button>
+              :class="SECONDARY_BUTTON_CLASS">{{ gettext(typ.title) }}</Button>
             {% endfor %}
             {% endif %}
           </div>

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/assets/dist.css

@@ -1,4 +1,4 @@
-/*! tailwindcss v4.1.4 | MIT License | https://tailwindcss.com */
+/*! tailwindcss v4.1.11 | MIT License | https://tailwindcss.com */
 @layer properties;
 @layer theme, base, components, utilities;
 @layer theme {
@@ -288,6 +288,9 @@
   .cursor-pointer {
     cursor: pointer;
   }
+  .appearance-none {
+    appearance: none;
+  }
   .items-center {
     align-items: center;
   }

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/components/A.jinja

@@ -20,13 +20,17 @@
     "specify how the response will be swapped in relative to the target of an AJAX request."
   ] = "innerHTML show:body:top",
   hx_push_url: Annotated[bool, "replace the browser url with the link."] = True,
+  hx_get: Annotated[
+    str | None,
+    "Override the target link only for htmx request for component rendering. href will be used if None."
+  ] = None,
   disable_htmx: Annotated[bool, "do not add any `hx-*` attibute to the link."] = False
 #}
 
 <a href="{{href}}"
   {%- if id %} id="{{ id }}" {%- endif %}
   {%- if not disable_htmx %}
-    hx-get="{{ href }}"
+    hx-get="{{ hx_get or href }}"
     hx-target="{{ hx_target }}"
     hx-swap="{{ hx_swap }}"
     {%- if hx_push_url %} hx-push-url="true" {%- endif %}

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/components/Input.jinja

@@ -42,8 +42,8 @@
 
 <input name="{{name}}" value="{{value|default('')}}" type="{{type}}"
   {%- if id %} id="{{id}}" {%- endif %}
-  {%- if aria_label %} aria-label="{{aria_label}}" {%- endif %}
-  {%- if placeholder %} placeholder="{{placeholder}}" {%- endif %}
+  {%- if aria_label %} aria-label="{{ gettext(aria_label) }}" {%- endif %}
+  {%- if placeholder %} placeholder="{{ gettext(placeholder) }}" {%- endif %}
   {%- if inputmode %} inputmode="{{inputmode}}" {%- endif %}
   {%- if autocomplete %} autocomplete="{{autocomplete}}" {%- endif %}
   class="{{attrs.class or INPUT_CLASS}}"

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/components/Label.jinja

@@ -14,5 +14,5 @@
     {%- if attrs.for %} for="{{attrs.for}}" {%- endif %}
     class="{{attrs.class or LABEL_CLASS}}"
     {%- if id %} id="{{id}}" {%- endif %}>
-  {{-content -}}
+  {{- content -}}
 </label>

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/config/configurator.py

@@ -368,7 +368,7 @@ class GenericConfigurator(Generic[TRegistry]):
         deprecated: bool | None = None,
         methods: list[str] | None = None,
         operation_id: str | None = None,
-        # response_model: Any = Default(None),
+        response_model: Any = None,
         response_model_include: IncEx | None = None,
         response_model_exclude: IncEx | None = None,
         response_model_by_alias: bool = True,
@@ -433,7 +433,7 @@ class GenericConfigurator(Generic[TRegistry]):
         self._current_router.add_api_route(
             path,
             endpoint,
-            # response_model=response_model,
+            response_model=response_model,
             status_code=status_code,
             tags=tags,
             dependencies=dependencies,
@@ -493,14 +493,7 @@ class GenericConfigurator(Generic[TRegistry]):
             custom_globals[key] = val
         return {
             "request": request,
-            "gettext": lczr.gettext,
-            "ngettext": lczr.ngettext,
-            "dgettext": lczr.dgettext,
-            "dngettext": lczr.dngettext,
-            "pgettext": lczr.pgettext,
-            "dpgettext": lczr.dpgettext,
-            "npgettext": lczr.npgettext,
-            "dnpgettext": lczr.dnpgettext,
+            **lczr.as_dict(),
             **custom_globals,
             **request.renderer_globals,
         }

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/config/resources.py

@@ -99,6 +99,7 @@ def resource(
                     response_description=endpoint.response_description,
                     deprecated=endpoint.deprecated,
                     operation_id=endpoint.operation_id,
+                    response_model=endpoint.response_model,
                     response_model_include=endpoint.response_model_include,
                     response_model_exclude=endpoint.response_model_exclude,
                     response_model_by_alias=endpoint.response_model_by_alias,
@@ -146,6 +147,7 @@ def resource_view(
     deprecated: bool | None = None,
     methods: list[str] | None = None,
     operation_id: str | None = None,
+    response_model: type[Any] | None = None,
     response_model_include: IncEx | None = None,
     response_model_exclude: IncEx | None = None,
     response_model_by_alias: bool = True,
@@ -155,7 +157,7 @@ def resource_view(
     include_in_schema: bool = True,
     openapi_extra: dict[str, Any] | None = None,
 ) -> Callable[..., Any]:
-    """ "
+    """
     Decorator to use on a method of a class decorated with {func}`resource` in order
     to add OpenAPI information.
 
@@ -177,8 +179,11 @@ def resource_view(
     :param include_in_schema: Expose or not the route in the OpenAPI schema and
     documentation.
 
-    :param response_model_include: customize fields list to include in repsonse.
-    :param response_model_exclude: customize fields list to exclude in repsonse.
+    :param response_model: class used for the api documentation for streaming response.
+        It may also be used to validate data in case the view return dict.
+        See [FastAPI doc](https://fastapi.tiangolo.com/tutorial/response-model/).
+    :param response_model_include: customize fields list to include in response.
+    :param response_model_exclude: customize fields list to exclude in response.
     :param response_model_by_alias: serialize fields by alias or by name if False.
     :param response_model_exclude_unset: exclude fields that are not explicitly
         set in response.
@@ -197,6 +202,7 @@ def resource_view(
         fn.deprecated = deprecated
         fn.methods = methods
         fn.operation_id = operation_id
+        fn.response_model = response_model
         fn.response_model_include = response_model_include
         fn.response_model_exclude = response_model_exclude
         fn.response_model_by_alias = response_model_by_alias

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/domain/model/request.py

@@ -69,3 +69,13 @@ class GenericRequest(ASGIRequest, Generic[TRegistry, TIdentity, TClaimedIdentity
             )
 
         return await self.security_policy.has_permission(permission)
+
+    def url_path_for(self, name: str, /, **path_params: Any) -> str:
+        """
+        Return the url pathinfo for the given route and route parameters.
+
+        :param name: the name of the route
+        :param path_params: parameters for the route.
+        """
+        url_path_provider: Any = self.scope.get("router") or self.scope.get("app")
+        return url_path_provider.url_path_for(name, **path_params)

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/service/translations.py

@@ -2,9 +2,10 @@
 
 import pathlib
 from collections import defaultdict
-from collections.abc import Callable, Iterator
+from collections.abc import Callable, Iterator, Mapping
 from gettext import GNUTranslations
 from io import BufferedReader
+from typing import Any
 
 from fastlife.shared_utils.resolver import resolve_path
 
@@ -100,10 +101,23 @@ class Localizer:
         self.translations[domain].merge(trans)
         self.global_translations.merge(trans)
 
-    def __call__(self, message: str, mapping: dict[str, str] | None = None) -> str:
-        return self.gettext(message, mapping)
-
-    def gettext(self, message: str, mapping: dict[str, str] | None = None) -> str:
+    def as_dict(self) -> Mapping[str, Callable[..., str]]:
+        return {
+            "_": self.gettext,
+            "gettext": self.gettext,
+            "ngettext": self.ngettext,
+            "dgettext": self.dgettext,
+            "dngettext": self.dngettext,
+            "pgettext": self.pgettext,
+            "dpgettext": self.dpgettext,
+            "npgettext": self.npgettext,
+            "dnpgettext": self.dnpgettext,
+        }
+
+    def __call__(self, message: str, /, **mapping: Any) -> str:
+        return self.gettext(message, **mapping)
+
+    def gettext(self, message: str, /, **mapping: Any) -> str:
         if isinstance(message, TranslatableString):
             ret = self.translations[message.domain].gettext(message)  # type: ignore
         else:
@@ -112,16 +126,12 @@ class Localizer:
             ret = ret.format(**mapping)
         return ret
 
-    def ngettext(
-        self, singular: str, plural: str, n: int, mapping: dict[str, str] | None = None
-    ) -> str:
+    def ngettext(self, singular: str, plural: str, n: int, /, **mapping: Any) -> str:
         ret = self.global_translations.ngettext(singular, plural, n)
-        mapping_num = {"num": n, **(mapping or {})}
+        mapping_num = {"num": n, **mapping}
         return ret.format(**mapping_num)
 
-    def dgettext(
-        self, domain: str, message: str, mapping: dict[str, str] | None = None
-    ) -> str:
+    def dgettext(self, domain: str, message: str, /, **mapping: Any) -> str:
         ret = self.translations[domain].gettext(message)
         if mapping:
             ret = ret.format(**mapping)
@@ -133,15 +143,14 @@ class Localizer:
         singular: str,
         plural: str,
         n: int,
-        mapping: dict[str, str] | None = None,
+        /,
+        **mapping: Any,
     ) -> str:
         ret = self.translations[domain].ngettext(singular, plural, n)
-        mapping_num = {"num": n, **(mapping or {})}
+        mapping_num = {"num": n, **mapping}
         return ret.format(**mapping_num)
 
-    def pgettext(
-        self, context: str, message: str, mapping: dict[str, str] | None = None
-    ) -> str:
+    def pgettext(self, context: str, message: str, /, **mapping: Any) -> str:
         ret = self.global_translations.pgettext(context, message)
         if mapping:
             ret = ret.format(**mapping)
@@ -152,7 +161,8 @@ class Localizer:
         domain: str,
         context: str,
         message: str,
-        mapping: dict[str, str] | None = None,
+        /,
+        **mapping: Any,
     ) -> str:
         ret = self.translations[domain].pgettext(context, message)
         if mapping:
@@ -165,10 +175,11 @@ class Localizer:
         singular: str,
         plural: str,
         n: int,
-        mapping: dict[str, str] | None = None,
+        /,
+        **mapping: Any,
     ) -> str:
         ret = self.global_translations.npgettext(context, singular, plural, n)
-        mapping_num = {"num": n, **(mapping or {})}
+        mapping_num = {"num": n, **mapping}
         return ret.format(**mapping_num)
 
     def dnpgettext(
@@ -178,10 +189,11 @@ class Localizer:
         singular: str,
         plural: str,
         n: int,
-        mapping: dict[str, str] | None = None,
+        /,
+        **mapping: Any,
     ) -> str:
         ret = self.translations[domain].npgettext(context, singular, plural, n)
-        mapping_num = {"num": n, **(mapping or {})}
+        mapping_num = {"num": n, **mapping}
         return ret.format(**mapping_num)
 
 

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/template_globals.py

@@ -29,6 +29,7 @@ class Globals(BaseModel):
     """Default css class for {jinjax:component}`A`."""
 
     BUTTON_CLASS: str = space_join(
+        "appearance-none",
         "bg-primary-600",
         "px-5",
         "py-2.5",
@@ -52,6 +53,7 @@ class Globals(BaseModel):
     """Default css class for {jinjax:component}`Details`."""
 
     SECONDARY_BUTTON_CLASS: str = space_join(
+        "appearance-none",
         "bg-neutral-300",
         "px-5",
         "py-2.5",
@@ -79,6 +81,7 @@ class Globals(BaseModel):
     """
 
     ICON_BUTTON_CLASS: str = space_join(
+        "appearance-none",
         "bg-white",
         "p-1",
         "rounded-xs",

{fastlifeweb-0.26.2 → fastlifeweb-0.27.1}/src/fastlife/views/pydantic_form.py

@@ -31,6 +31,11 @@ async def show_widget(
         field = FieldInfo(title=title)
     # FIXME: .jinja should not be hardcoded
     renderer = cast(JinjaxRenderer, request.registry.get_renderer(".jinja")(request))
+    lczr = request.registry.localizer(request.locale_name)
+    renderer.globals = {
+        "request": request,
+        **lczr.as_dict(),
+    }
     data = renderer.pydantic_form_field(
         model=model_cls,  # type: ignore
         name=name,