fastlifeweb 0.16.4__py3-none-any.whl → 0.18.0__py3-none-any.whl

fastlife/adapters/jinjax/widget_factory/literal_builder.py

@@ -0,0 +1,52 @@
+"""Handle Literal type."""
+
+from collections.abc import Mapping
+from typing import Any, Literal
+
+from pydantic.fields import FieldInfo
+
+from fastlife.adapters.jinjax.widget_factory.base import BaseWidgetBuilder
+from fastlife.adapters.jinjax.widgets.dropdown import DropDownWidget
+from fastlife.adapters.jinjax.widgets.hidden import HiddenWidget
+
+
+class LiteralBuilder(BaseWidgetBuilder[str]):  # str|int|bool
+    """Builder for Literal."""
+
+    def accept(self, typ: type[Any], origin: type[Any] | None) -> bool:
+        """True for Literal."""
+        return origin is Literal
+
+    def build(
+        self,
+        *,
+        field_name: str,
+        field_type: type[Any],  # a literal actually
+        field: FieldInfo | None,
+        value: str | None,
+        form_errors: Mapping[str, Any],
+        removable: bool,
+    ) -> HiddenWidget | DropDownWidget:
+        """Build the widget."""
+        choices: list[str] = field_type.__args__  # type: ignore
+        if len(choices) == 1:
+            return HiddenWidget(
+                field_name,
+                value=choices[0],
+                token=self.factory.token,
+            )
+        return DropDownWidget(
+            field_name,
+            options=choices,
+            removable=removable,
+            title=field.title if field else "",
+            hint=field.description if field else None,
+            aria_label=(
+                field.json_schema_extra.get("aria_label")  # type:ignore
+                if field and field.json_schema_extra
+                else None
+            ),
+            token=self.factory.token,
+            value=str(value),
+            error=form_errors.get(field_name),
+        )

fastlife/adapters/jinjax/widget_factory/model_builder.py

@@ -0,0 +1,64 @@
+"""Handle Pydantic BaseModel type."""
+
+from collections.abc import Mapping
+from typing import Any
+
+from pydantic import BaseModel
+from pydantic.fields import FieldInfo
+
+from fastlife.adapters.jinjax.widget_factory.base import BaseWidgetBuilder
+from fastlife.adapters.jinjax.widgets.base import Widget
+from fastlife.adapters.jinjax.widgets.model import ModelWidget
+
+
+class ModelBuilder(BaseWidgetBuilder[Mapping[str, Any]]):
+    """Builder for Pydantic BaseModel values."""
+
+    def accept(self, typ: type[Any], origin: type[Any] | None) -> bool:
+        """True for Pydantic BaseModel."""
+        return issubclass(typ, BaseModel)
+
+    def build(
+        self,
+        *,
+        field_name: str,
+        field_type: type[BaseModel],
+        field: FieldInfo | None,
+        value: Mapping[str, Any] | None,
+        form_errors: Mapping[str, Any],
+        removable: bool,
+    ) -> Widget[Any]:
+        """Build the widget."""
+        value = value or {}
+        ret: dict[str, Any] = {}
+        for key, child_field in field_type.model_fields.items():
+            child_key = f"{field_name}.{key}" if field_name else key
+            if child_field.exclude:
+                continue
+            if child_field.annotation is None:
+                raise ValueError(  # coverage: ignore
+                    f"Missing annotation for {child_field} in {child_key}"
+                )
+            ret[key] = self.factory.build(
+                child_field.annotation,
+                name=child_key,
+                field=child_field,
+                value=value.get(key),
+                form_errors=form_errors,
+                removable=False,
+            )
+        return ModelWidget(
+            field_name,
+            value=list(ret.values()),
+            removable=removable,
+            title=field.title if field and field.title else "",
+            hint=field.description if field else None,
+            aria_label=(
+                field.json_schema_extra.get("aria_label")  # type:ignore
+                if field and field.json_schema_extra
+                else None
+            ),
+            token=self.factory.token,
+            error=form_errors.get(field_name),
+            nested=field is not None,
+        )

fastlife/adapters/jinjax/widget_factory/secretstr_builder.py

@@ -0,0 +1,47 @@
+"""Handle Pydantic SecretStr type."""
+
+from collections.abc import Mapping
+from typing import Any
+
+from pydantic import SecretStr
+from pydantic.fields import FieldInfo
+
+from fastlife.adapters.jinjax.widget_factory.base import BaseWidgetBuilder
+from fastlife.adapters.jinjax.widgets.base import Widget
+from fastlife.adapters.jinjax.widgets.text import TextWidget
+
+
+class SecretStrBuilder(BaseWidgetBuilder[SecretStr]):
+    """Builder for Pydantic SecretStr."""
+
+    def accept(self, typ: type[Any], origin: type[Any] | None) -> bool:
+        """True for Pydantic SecretStr."""
+        return issubclass(typ, SecretStr)
+
+    def build(
+        self,
+        *,
+        field_name: str,
+        field_type: type[Any],
+        field: FieldInfo | None,
+        value: SecretStr | None,
+        form_errors: Mapping[str, Any],
+        removable: bool,
+    ) -> Widget[SecretStr]:
+        """Build the widget."""
+        return TextWidget(
+            field_name,
+            input_type="password",
+            placeholder=str(field.examples[0]) if field and field.examples else None,
+            removable=removable,
+            title=field.title if field else "",
+            hint=field.description if field else None,
+            aria_label=(
+                field.json_schema_extra.get("aria_label")  # type:ignore
+                if field and field.json_schema_extra
+                else None
+            ),
+            token=self.factory.token,
+            value=value.get_secret_value() if value else "",
+            error=form_errors.get(field_name),
+        )

fastlife/adapters/jinjax/widget_factory/sequence_builder.py

@@ -0,0 +1,58 @@
+"""Handle Sequence type."""
+
+from collections.abc import Mapping, MutableSequence, Sequence
+from typing import Any
+
+from pydantic.fields import FieldInfo
+
+from fastlife.adapters.jinjax.widget_factory.base import BaseWidgetBuilder
+from fastlife.adapters.jinjax.widgets.base import Widget
+from fastlife.adapters.jinjax.widgets.sequence import SequenceWidget
+
+
+class SequenceBuilder(BaseWidgetBuilder[Sequence[Any]]):
+    """Builder for Sequence values."""
+
+    def accept(self, typ: type[Any], origin: type[Any] | None) -> bool:
+        """True for Sequence, MutableSequence or list"""
+        return origin is Sequence or origin is MutableSequence or origin is list
+
+    def build(
+        self,
+        *,
+        field_name: str,
+        field_type: type[Any],
+        field: FieldInfo | None,
+        value: Sequence[Any] | None,
+        form_errors: Mapping[str, Any],
+        removable: bool,
+    ) -> Widget[Sequence[Any]]:
+        """Build the widget."""
+        typ = field_type.__args__[0]  # type: ignore
+        value = value or []
+        items: Sequence[Any] = [
+            self.factory.build(
+                typ,  # type: ignore
+                name=f"{field_name}.{idx}",
+                value=v,
+                field=field,
+                form_errors=form_errors,
+                removable=True,
+            )
+            for idx, v in enumerate(value)
+        ]
+        return SequenceWidget(
+            field_name,
+            title=field.title if field else "",
+            hint=field.description if field else None,
+            aria_label=(
+                field.json_schema_extra.get("aria_label")  # type:ignore
+                if field and field.json_schema_extra
+                else None
+            ),
+            value=items,
+            item_type=typ,  # type: ignore
+            token=self.factory.token,
+            removable=removable,
+            error=form_errors.get(field_name),
+        )

fastlife/adapters/jinjax/widget_factory/set_builder.py

@@ -0,0 +1,80 @@
+"""Handle Set type."""
+
+from collections.abc import Mapping
+from enum import Enum
+from typing import Any, Literal, get_origin
+
+from pydantic.fields import FieldInfo
+
+from fastlife.adapters.jinjax.widget_factory.base import BaseWidgetBuilder
+from fastlife.adapters.jinjax.widgets.base import Widget
+from fastlife.adapters.jinjax.widgets.checklist import Checkable, ChecklistWidget
+
+
+class SetBuilder(BaseWidgetBuilder[set[Any]]):
+    """Builder for Set."""
+
+    def accept(self, typ: type[Any], origin: type[Any] | None) -> bool:
+        """True for Set"""
+        return origin is set
+
+    def build(
+        self,
+        *,
+        field_name: str,
+        field_type: type[Any],
+        field: FieldInfo | None,
+        value: set[Any] | None,
+        form_errors: Mapping[str, Any],
+        removable: bool,
+    ) -> Widget[Any]:
+        """Build the widget."""
+        choice_wrapper = field_type.__args__[0]
+        choices = []
+        choice_wrapper_origin = get_origin(choice_wrapper)
+        if choice_wrapper_origin:
+            if choice_wrapper_origin is Literal:
+                litchoice: list[str] = choice_wrapper.__args__  # type: ignore
+                choices = [
+                    Checkable(
+                        label=c,
+                        value=c,
+                        checked=c in value if value else False,  # type: ignore
+                        name=field_name,
+                        token=self.factory.token,
+                        error=form_errors.get(f"{field_name}-{c}"),
+                    )
+                    for c in litchoice
+                ]
+
+            else:
+                raise NotImplementedError  # coverage: ignore
+        elif issubclass(choice_wrapper, Enum):
+            choices = [
+                Checkable(
+                    label=e.value,
+                    value=e.name,
+                    checked=e.name in value if value else False,  # type: ignore
+                    name=field_name,
+                    token=self.factory.token,
+                    error=form_errors.get(f"{field_name}-{e.name}"),
+                )
+                for e in choice_wrapper
+            ]
+        else:
+            raise NotImplementedError  # coverage: ignore
+
+        return ChecklistWidget(
+            field_name,
+            title=field.title if field else "",
+            hint=field.description if field else None,
+            aria_label=(
+                field.json_schema_extra.get("aria_label")  # type:ignore
+                if field and field.json_schema_extra
+                else None
+            ),
+            token=self.factory.token,
+            value=choices,
+            removable=removable,
+            error=form_errors.get(field_name),
+        )

fastlife/adapters/jinjax/widget_factory/simpletype_builder.py

@@ -0,0 +1,47 @@
+"""Handle simple types (str, int, float, ...)."""
+
+from collections.abc import Mapping
+from decimal import Decimal
+from typing import Any
+from uuid import UUID
+
+from pydantic.fields import FieldInfo
+
+from fastlife.adapters.jinjax.widget_factory.base import BaseWidgetBuilder
+from fastlife.adapters.jinjax.widgets.base import Widget
+from fastlife.adapters.jinjax.widgets.text import TextWidget
+
+
+class SimpleTypeBuilder(BaseWidgetBuilder[str | int | str | float | Decimal | UUID]):
+    """Builder for simple types."""
+
+    def accept(self, typ: type[Any], origin: type[Any] | None) -> bool:
+        """True for simple types: int, str, float, Decimal, UUID"""
+        return issubclass(typ, int | str | float | Decimal | UUID)
+
+    def build(
+        self,
+        *,
+        field_name: str,
+        field_type: type[Any],
+        field: FieldInfo | None,
+        value: int | str | float | Decimal | UUID | None,
+        form_errors: Mapping[str, Any],
+        removable: bool,
+    ) -> Widget[int | str | float | Decimal | UUID]:
+        """Build the widget."""
+        return TextWidget(
+            field_name,
+            placeholder=str(field.examples[0]) if field and field.examples else None,
+            title=field.title if field else "",
+            hint=field.description if field else None,
+            aria_label=(
+                field.json_schema_extra.get("aria_label")  # type:ignore
+                if field and field.json_schema_extra
+                else None
+            ),
+            removable=removable,
+            token=self.factory.token,
+            value=str(value) if value else "",
+            error=form_errors.get(field_name),
+        )

fastlife/adapters/jinjax/widget_factory/union_builder.py

@@ -0,0 +1,90 @@
+"""Handle Union type."""
+
+from collections.abc import Mapping
+from types import NoneType
+from typing import Any
+
+from pydantic import ValidationError
+from pydantic.fields import FieldInfo
+
+from fastlife.adapters.jinjax.widget_factory.base import BaseWidgetBuilder
+from fastlife.adapters.jinjax.widgets.base import Widget
+from fastlife.adapters.jinjax.widgets.union import UnionWidget
+from fastlife.shared_utils.infer import is_complex_type, is_union
+
+
+class UnionBuilder(BaseWidgetBuilder[Any]):
+    """Builder for Union."""
+
+    def accept(self, typ: type[Any], origin: type[Any] | None) -> bool:
+        """True for unions Union[A,B], A | B or event Optional[A], A | None"""
+        return is_union(typ)
+
+    def build(
+        self,
+        *,
+        field_name: str,
+        field_type: type[Any],
+        field: FieldInfo | None,
+        value: Any | None,
+        form_errors: Mapping[str, Any],
+        removable: bool,
+    ) -> Widget[Any]:
+        """Build the widget."""
+        types: list[type[Any]] = []
+        # required = True
+        for typ in field_type.__args__:  # type: ignore
+            if typ is NoneType:
+                # required = False
+                continue
+            types.append(typ)  # type: ignore
+
+        if (
+            not removable
+            and len(types) == 1
+            # if the optional type is a complex type,
+            and not is_complex_type(types[0])
+        ):
+            return self.factory.build(  # coverage: ignore
+                types[0],
+                name=field_name,
+                field=field,
+                value=value,
+                form_errors=form_errors,
+                removable=False,
+            )
+        child = None
+        if value:
+            for typ in types:
+                try:
+                    typ(**value)
+                except ValidationError:
+                    pass
+                else:
+                    child = self.factory.build(
+                        typ,
+                        name=field_name,
+                        field=field,
+                        value=value,
+                        form_errors=form_errors,
+                        removable=False,
+                    )
+
+        widget = UnionWidget(
+            field_name,
+            # we assume those types are BaseModel
+            value=child,
+            children_types=types,  # type: ignore
+            title=field.title if field else "",
+            hint=field.description if field else None,
+            aria_label=(
+                field.json_schema_extra.get("aria_label")  # type:ignore
+                if field and field.json_schema_extra
+                else None
+            ),
+            token=self.factory.token,
+            removable=removable,
+            error=form_errors.get(field_name),
+        )
+
+        return widget

fastlife/adapters/jinjax/widgets/hidden.py

@@ -1,3 +1,5 @@
+"""Hidden fields"""
+
 from typing import Any
 
 from .base import Widget

fastlife/adapters/jinjax/widgets/model.py

@@ -1,3 +1,5 @@
+"""Pydantic models"""
+
 from collections.abc import Sequence
 from typing import Any
 

fastlife/components/Form.jinja

@@ -22,6 +22,15 @@
   ] = None,
   method: Annotated[Literal["get", "post"] | None, "Http method used"] = None,
   action: Annotated[str | None, "url where the form will be submitted"] = None,
+  hx_target: Annotated[
+    str | None,
+    "target the element for swapping than the one issuing the AJAX request."
+  ] = None,
+  hx_select: Annotated[str | None, "select the content swapped from response of the AJAX request."] = None,
+  hx_swap: Annotated[
+    str | None,
+    "specify how the response will be swapped in relative to the target of an AJAX request."
+  ] = None,
   hx_post: Annotated[
     str | Literal[True] | None,
     "url where the form will be submitted using htmx. if ``True``, the current url is used."\
@@ -40,6 +49,9 @@
       {%- if hx_post is not none %}
         hx-post="{% if hx_post is not true %}{{hx_post}}{% endif %}"
       {%- endif %}
+      {%- if hx_select %} hx-select="{{ hx_select }}" {%- endif %}
+      {%- if hx_swap %} hx-swap="{{ hx_swap }}" {%- endif %}
+      {%- if hx_target %} hx-target="{{ hx_target }}" {%- endif %}
     {%- endif %}
     {%- if action is not none %} action="{{action}}" {%- endif %}
     {%- if method %} method="{{method}}" {%- endif -%}

fastlife/components/icons/AcademicCap.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/AdjustmentsHorizontal.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/AdjustmentsVertical.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArchiveBox.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArchiveBoxArrowDown.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArchiveBoxXMark.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArrowDown.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArrowDownCircle.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArrowDownLeft.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArrowDownOnSquare.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArrowDownOnSquareStack.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArrowDownRight.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArrowDownTray.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}
 

fastlife/components/icons/ArrowLeft.jinja

@@ -1,6 +1,9 @@
 {# def
-    id=None,
-    title=None,
+    id: Annotated[str | None, "identifier of the element."] = None,
+    title: Annotated[str | None, "title element of the svg"] = None,
+    class_: Annotated[
+        str | None, "css class applied to the svg element"
+    ] = None,
     mode: Literal["micro","mini","outline","solid"] = "solid"
 #}