htmy 0.7.1__py3-none-any.whl → 0.7.3__py3-none-any.whl

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/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/io.py

@@ -1 +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/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.dist-info → htmy-0.7.3.dist-info}/METADATA

@@ -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.dist-info → htmy-0.7.3.dist-info}/RECORD

@@ -1,10 +1,10 @@
 htmy/__init__.py,sha256=Us5P9Y6ZSp38poIz88bsAh2Hxuze5jE3V_uMtMyuH-E,1880
-htmy/core.py,sha256=OoL11j2V-CfePC0dbkC2A5GbdK942b5Huszw3rLo7fc,15124
+htmy/core.py,sha256=mvNbxTRS8HNnjMSwe4NEJdL1KF19pJImF4Ciip6837I,15484
 htmy/etree.py,sha256=yKxom__AdsJY-Q1kbU0sdTMr0ZF5dMSVBKxayntNFyQ,3062
 htmy/function_component.py,sha256=iSp5cGrErmIsc-VfNq053_J2m-Nuu_k2xK9UxvEnlw8,12431
 htmy/html.py,sha256=7UohfPRtl-3IoSbOiDxazsSHQpCZ0tyRdNayQISPM8A,21086
-htmy/i18n.py,sha256=brNazQjObBFfbnViZCpcnxa0qgxQbJfX7xJAH-MqTW8,5124
-htmy/io.py,sha256=iebJOZp7L0kZ9SWdqMatKtW5VGRIkEd-eD0_vTAldH8,41
+htmy/i18n.py,sha256=Kobvm9mFoNcJas52KQbheiRIzJF1Ad1azOhtfm_k0BE,5123
+htmy/io.py,sha256=oEXXVnpdbjs2NzAGi36Pept-pyvXshEGHrbBFzcHYio,344
 htmy/md/__init__.py,sha256=lxBJnYplkDuxYuiese6My9KYp1DeGdzo70iUdYTvMnE,334
 htmy/md/core.py,sha256=Xu-8xGAOGqSYLGPOib0Wn-blmyQBHl3MrAOza_w__Y8,4456
 htmy/md/typing.py,sha256=LF-AEvo7FCW2KumyR5l55rsXizV2E4AHVLKFf6lApgM,762
@@ -12,10 +12,10 @@ htmy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 htmy/renderer/__init__.py,sha256=xnP_aaoK-pTok-69wi8O_xlsgjoKTzWd2lIIeHGcuaY,226
 htmy/renderer/baseline.py,sha256=hHb7CoQhFFdD7Sdw0ltR1-XLGwE9pqmfL5yKFeF2rCg,4288
 htmy/renderer/default.py,sha256=G6K5YptvH9QvEvMQZdLPtgUblO_zTv4Eo6TETHZDlX8,10869
-htmy/snippet.py,sha256=dkHEOuULGsgawIMnSz99hghvNu8pLVGAQMQSlrn9ibY,10260
+htmy/snippet.py,sha256=9-ltfs4rugv6kFNzAY0PYNP3YI3xvJG8lkxEnYcCYWw,10538
 htmy/typing.py,sha256=0spTpz_JWql2yy_lSlRx0uqgXar7fxwyBqWeIzltvKU,3111
 htmy/utils.py,sha256=Kp0j9G8CBeRiyFGmz-CoDiLtXHfpvHzlTVsWeDhIebM,1935
-htmy-0.7.1.dist-info/LICENSE,sha256=rFtoGU_3c_rlacXgOZapTHfMErN-JFPT5Bq_col4bqI,1067
-htmy-0.7.1.dist-info/METADATA,sha256=-1VV-vjHWSTWiqNq1bi_E8sKy3PGSLMmauuuKscc70A,18459
-htmy-0.7.1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-htmy-0.7.1.dist-info/RECORD,,
+htmy-0.7.3.dist-info/LICENSE,sha256=rFtoGU_3c_rlacXgOZapTHfMErN-JFPT5Bq_col4bqI,1067
+htmy-0.7.3.dist-info/METADATA,sha256=T3hOzzQL_Al4cNT_Fruj-IM1pbMMkvKFCX9KBUdJlcY,18714
+htmy-0.7.3.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+htmy-0.7.3.dist-info/RECORD,,