fastlifeweb 0.26.0__tar.gz → 0.26.2__tar.gz

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

@@ -1,3 +1,10 @@
+## 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.
+
+## 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)

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

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

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

@@ -14,7 +14,7 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
     "Typing :: Typed",
 ]
-version = "0.26.0"
+version = "0.26.2"
 requires-python = ">=3.11"
 dependencies = [
     "fastapi[standard] >=0.115.4,<0.116.0",
@@ -54,7 +54,6 @@ docs = [
 dev = [
     "babel >=2.16.0,<3",
     "beautifulsoup4 >= 4.12.2,<5",
-    "behave >= 1.2.6,<2",
     "email-validator >= 2.0.0.post2,<3",
     "heroicons >= 2.7.0,<3",
     "httpx >= 0.28.1,<0.29",
@@ -62,11 +61,13 @@ dev = [
     "mypy >= 1.4.0,<2",
     "pytailwindcss >= 0.2.0,<0.3",
     "pytest >= 8.2.0,<9",
-    "pytest-asyncio >= 0.21.0,<0.22",
+    "pytest-asyncio >=0.26.0",
     "pytest-cov >= 4.1.0,<5",
-    "pytest-playwright >= 0.4.3,<0.5",
+    "pytest-playwright-asyncio >= 0.7.0,<0.8",
     "sphinx >=7.0.1,<8",
-    "types-beautifulsoup4 >= 4.12.0.6,<5",
+    "tursu >=0.16.0,<1",
+    "types-beautifulsoup4 >=4.12.0.6,<5",
+    "uvicorn >=0.34.0,<1.0",
 ]
 doc = [
     "furo >=2024.5.6",
@@ -129,11 +130,22 @@ ignore = [
 profile = "black"
 
 [tool.pytest.ini_options]
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"
 asyncio_mode = "auto"
+markers = [
+    "experiment: experiment with some context",
+    "dev: developper helpers to exclude from func tests.",
+    "wip: work in progress.",
+    "icons: show icons.",
+    "openapi: open api tests.",
+]
 filterwarnings = [
     "error",
     "ignore:.*import python_multipart",
     "ignore:.*Deprecated call to `pkg_resources.declare_namespace:DeprecationWarning",
+    "ignore:.*websockets.legacy is deprecated.*",
+    "ignore:.*WebSocketServerProtocol.*",
     "ignore:.*find_module\\(\\) is deprecated.*:DeprecationWarning",
     "ignore:.*FileFinder.find_loader\\(\\) is deprecated.*:DeprecationWarning",
     "ignore:.*Pydantic serializer warnings.*:UserWarning",

{fastlifeweb-0.26.0 → fastlifeweb-0.26.2}/src/fastlife/__init__.py

@@ -2,8 +2,6 @@ from importlib import metadata
 
 __version__ = metadata.version("fastlifeweb")
 
-from fastapi import Response
-from fastapi.responses import RedirectResponse
 
 from .adapters.fastapi.form import form_model
 from .adapters.fastapi.localizer import Localizer
@@ -26,6 +24,7 @@ from .config import (
 from .domain.model.asgi import ASGIRequest, ASGIResponse
 from .domain.model.form import FormModel
 from .domain.model.request import GenericRequest
+from .domain.model.response import RedirectResponse, Response
 from .domain.model.security_policy import (
     Allowed,
     Anonymous,

{fastlifeweb-0.26.0 → fastlifeweb-0.26.2}/src/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;
+    }
+  }
+}

{fastlifeweb-0.26.0 → fastlifeweb-0.26.2}/src/fastlife/components/Form.jinja

@@ -6,7 +6,7 @@
 
   ::
 
-    <Form :hx-post="true">
+    <Form hx-post>
       <Input name="name" placeholder="Bob" />
       <Button>Submit</Button>
     </Form>

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

@@ -177,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")(

fastlifeweb-0.26.2/src/fastlife/domain/model/response.py

@@ -0,0 +1,40 @@
+from collections.abc import Mapping
+from urllib.parse import quote
+
+from starlette.background import BackgroundTask
+from starlette.datastructures import URL
+from starlette.responses import Response
+
+
+class RedirectResponse(Response):
+    """
+    A redirect response for Post/Redirect/Get pattern.
+
+    The starlette default value status code is 307, which means that it is used
+    as a way to replay the same query which is definitly not the most used case
+    in web applications.
+
+    This is why the redirect response here is using 303 see other which
+    ensure a GET request will be made for the redirection.
+
+    A new parameter hx_redirect exists in order to set the HX-Redirect header
+    to follow a browser redirection from an ajax query.
+    """
+
+    def __init__(
+        self,
+        url: str | URL,
+        hx_redirect: bool = False,
+        status_code: int = 303,
+        headers: Mapping[str, str] | None = None,
+        background: BackgroundTask | None = None,
+    ):
+        super().__init__(
+            content=b"", status_code=status_code, headers=headers, background=background
+        )
+        self.headers["HX-Redirect" if hx_redirect else "location"] = quote(
+            str(url), safe=":/%#?=@[]!$&'()*+,;"
+        )
+
+
+__all__ = ["Response", "RedirectResponse"]

{fastlifeweb-0.26.0 → fastlifeweb-0.26.2}/src/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}>"

{fastlifeweb-0.26.0 → fastlifeweb-0.26.2}/src/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."""
@@ -156,9 +158,14 @@ class WebTestClient:
                 method = "GET"
                 headers = None
                 content = None
+            url = resp.headers.get("location")
+            if "HX-Redirect" in resp.headers:
+                # Redirection requested to the browser from an AJAX request.
+                url = resp.headers["HX-Redirect"]
+            assert url, "Redirect response without a redirection"
             return self.request(
                 method=method,
-                url=resp.headers["location"],
+                url=url,
                 content=content,
                 headers=headers,
                 max_redirects=max_redirects - 1,