htmy 0.7.1__tar.gz → 0.7.3__tar.gz

{htmy-0.7.1 → htmy-0.7.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.3
 Name: htmy
-Version: 0.7.1
-Summary: Async, pure-Python rendering engine.
+Version: 0.7.3
+Summary: Async, pure-Python server-side rendering engine.
 License: MIT
 Author: Peter Volf
 Author-email: do.volfp@gmail.com
@@ -28,7 +28,7 @@ Description-Content-Type: text/markdown
 
 # `htmy`
 
-**Async**, **pure-Python** rendering engine.
+**Async**, **pure-Python** server-side rendering engine.
 
 Unleash your creativity with the full power and Python, without the hassle of learning a new templating language or dealing with its limitations!
 
@@ -285,6 +285,7 @@ These are default tag attribute formatting rules:
 - `bool` attribute values are converted to strings (`"true"` and `"false"`).
 - `XBool.true` attributes values are converted to an empty string, and `XBool.false` values are skipped (only the attribute name is rendered).
 - `date` and `datetime` attribute values are converted to ISO strings.
+- Complex values such as lists, dictionaries, tuples, and sets are JSON serialized.
 
 ### Error boundary
 
@@ -308,6 +309,10 @@ FastAPI:
 
 - [FastHX](https://github.com/volfpeter/fasthx)
 
+## External examples
+
+- [lipsum-chat](https://github.com/volfpeter/lipsum-chat): A simple chat application using `FastAPI`, `htmx`, and `fasthx`.
+
 ## Why
 
 At one end of the spectrum, there are the complete application frameworks that combine the server (Python) and client (JavaScript) applications with the entire state management and synchronization into a single Python (an in some cases an additional JavaScript) package. Some of the most popular examples are: [Reflex](https://github.com/reflex-dev/reflex), [NiceGUI](https://github.com/zauberzeug/nicegui/), [ReactPy](https://github.com/reactive-python/reactpy), and [FastUI](https://github.com/pydantic/FastUI).

{htmy-0.7.1 → htmy-0.7.3}/README.md

@@ -9,7 +9,7 @@
 
 # `htmy`
 
-**Async**, **pure-Python** rendering engine.
+**Async**, **pure-Python** server-side rendering engine.
 
 Unleash your creativity with the full power and Python, without the hassle of learning a new templating language or dealing with its limitations!
 
@@ -266,6 +266,7 @@ These are default tag attribute formatting rules:
 - `bool` attribute values are converted to strings (`"true"` and `"false"`).
 - `XBool.true` attributes values are converted to an empty string, and `XBool.false` values are skipped (only the attribute name is rendered).
 - `date` and `datetime` attribute values are converted to ISO strings.
+- Complex values such as lists, dictionaries, tuples, and sets are JSON serialized.
 
 ### Error boundary
 
@@ -289,6 +290,10 @@ FastAPI:
 
 - [FastHX](https://github.com/volfpeter/fasthx)
 
+## External examples
+
+- [lipsum-chat](https://github.com/volfpeter/lipsum-chat): A simple chat application using `FastAPI`, `htmx`, and `fasthx`.
+
 ## Why
 
 At one end of the spectrum, there are the complete application frameworks that combine the server (Python) and client (JavaScript) applications with the entire state management and synchronization into a single Python (an in some cases an additional JavaScript) package. Some of the most popular examples are: [Reflex](https://github.com/reflex-dev/reflex), [NiceGUI](https://github.com/zauberzeug/nicegui/), [ReactPy](https://github.com/reactive-python/reactpy), and [FastUI](https://github.com/pydantic/FastUI).

{htmy-0.7.1 → htmy-0.7.3}/htmy/core.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import abc
 import enum
+import json
 from collections.abc import Callable, Container
 from typing import TYPE_CHECKING, Any, ClassVar, TypedDict, cast
 from xml.sax.saxutils import escape as xml_escape
@@ -251,6 +252,9 @@ class Formatter(ContextAware):
     """
     The default, context-aware property name and value formatter.
 
+    The formatter supports both primitive and (many) complex values, such as lists,
+    dictionaries, tuples, and sets. Complex values are JSON-serialized by default.
+
     Important: the default implementation looks up the formatter for a given value by checking
     its type, but it doesn't do this check with the base classes of the encountered type. For
     example the formatter will know how to format `datetime` object, but it won't know how to
@@ -258,7 +262,7 @@ class Formatter(ContextAware):
 
     One reason for this is efficiency: always checking the base classes of every single value is a
     lot of unnecessary calculation. The other reason is customizability: this way you could use
-    subclassing for fomatter selection, e.g. with `LocaleDatetime(datetime)`-like classes.
+    subclassing for formatter selection, e.g. with `LocaleDatetime(datetime)`-like classes.
 
     Property name and value formatters may raise a `SkipProperty` error if a property should be skipped.
     """
@@ -337,6 +341,10 @@ class Formatter(ContextAware):
             bool: lambda v: "true" if v else "false",
             date: lambda d: cast(date, d).isoformat(),
             datetime: lambda d: cast(datetime, d).isoformat(),
+            dict: lambda v: json.dumps(v),
+            list: lambda v: json.dumps(v),
+            tuple: lambda v: json.dumps(v),
+            set: lambda v: json.dumps(tuple(v)),
             XBool: lambda v: cast(XBool, v).format(),
             type(None): SkipProperty.format_property,
         }

{htmy-0.7.1 → htmy-0.7.3}/htmy/i18n.py

@@ -112,7 +112,7 @@ class I18n(ContextAware):
         return result
 
 
-@alru_cache(8)
+@alru_cache()
 async def load_translation_resource(path: Path) -> TranslationResource:
     """
     Loads the translation resource from the given path.

htmy-0.7.3/htmy/io.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from anyio import open_file as open_file
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+async def load_text_file(path: str | Path) -> str:
+    """Loads the text content from the given path."""
+    async with await open_file(path, "r") as f:
+        return await f.read()

{htmy-0.7.1 → htmy-0.7.3}/htmy/snippet.py

@@ -1,9 +1,13 @@
+from __future__ import annotations
+
 import re
 from collections.abc import Awaitable, Iterator, Mapping
-from pathlib import Path
+from typing import TYPE_CHECKING
+
+from async_lru import alru_cache
 
 from .core import SafeStr, Text
-from .io import open_file
+from .io import load_text_file
 from .typing import (
     Component,
     ComponentType,
@@ -13,6 +17,9 @@ from .typing import (
 )
 from .utils import as_component_sequence, as_component_type, is_component_sequence
 
+if TYPE_CHECKING:
+    from pathlib import Path
+
 # -- Components and utilities
 
 
@@ -248,8 +255,7 @@ class Snippet:
         if isinstance(path_or_text, Text):
             return path_or_text
         else:
-            async with await open_file(path_or_text, "r") as f:
-                return await f.read()
+            return await Snippet._load_text_file(path_or_text)
 
     def _render_text(self, text: str, context: Context) -> Component:
         """
@@ -257,3 +263,9 @@ class Snippet:
         and returns the corresponding component.
         """
         return SafeStr(text)
+
+    @staticmethod
+    @alru_cache()
+    async def _load_text_file(path: str | Path) -> str:
+        """Async text loader with an LRU cache."""
+        return await load_text_file(path)

{htmy-0.7.1 → htmy-0.7.3}/pyproject.toml

@@ -1,7 +1,7 @@
 [tool.poetry]
 name = "htmy"
-version = "0.7.1"
-description = "Async, pure-Python rendering engine."
+version = "0.7.3"
+description = "Async, pure-Python server-side rendering engine."
 authors = ["Peter Volf <do.volfp@gmail.com>"]
 license = "MIT"
 readme = "README.md"
@@ -14,7 +14,7 @@ markdown = "^3.7"
 
 [tool.poetry.group.dev.dependencies]
 mkdocs-material = "^9.5.39"
-mkdocstrings = {extras = ["python"], version = "^0.26.1"}
+mkdocstrings = { extras = ["python"], version = "^0.26.1" }
 mypy = "^1.15.0"
 poethepoet = "^0.29.0"
 pytest = "^8.3.3"
@@ -49,17 +49,17 @@ exclude = [
     "docs",
 ]
 lint.select = [
-    "B",  # flake8-bugbear
-    "C",  # flake8-comprehensions
-    "E",  # pycodestyle errors
-    "F",  # pyflakes
-    "I",  # isort
-    "S",  # flake8-bandit - we must ignore these rules in tests
-    "W",  # pycodestyle warnings
+    "B", # flake8-bugbear
+    "C", # flake8-comprehensions
+    "E", # pycodestyle errors
+    "F", # pyflakes
+    "I", # isort
+    "S", # flake8-bandit - we must ignore these rules in tests
+    "W", # pycodestyle warnings
 ]
 
 [tool.ruff.lint.per-file-ignores]
-"tests/**/*" = ["S101"]  # S101: use of assert detected
+"tests/**/*" = ["S101"] # S101: use of assert detected
 
 [tool.poe.tasks]
 check-format = "ruff format --check ."
@@ -70,4 +70,4 @@ mypy = "mypy ."
 test = "python -m pytest tests"
 static-checks.sequence = ["lint", "check-format", "mypy"]
 static-checks.ignore_fail = "return_non_zero"
-serve-docs = "mkdocs serve"
+serve-docs = "mkdocs serve"

htmy-0.7.1/htmy/io.py

@@ -1 +0,0 @@
-from anyio import open_file as open_file