htmy 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

htmy/__init__.py

@@ -28,6 +28,7 @@ from .typing import ContextProvider as ContextProvider
 from .typing import ContextValue as ContextValue
 from .typing import FunctionComponent as FunctionComponent
 from .typing import HTMYComponentType as HTMYComponentType
+from .typing import MutableContext as MutableContext
 from .typing import Properties as Properties
 from .typing import PropertyValue as PropertyValue
 from .typing import SyncComponent as SyncComponent

htmy/core.py

@@ -5,7 +5,7 @@ import asyncio
 import enum
 from collections.abc import Callable, Container
 from pathlib import Path
-from typing import Any, ClassVar, Generic, Self, TypedDict, cast, overload
+from typing import TYPE_CHECKING, Any, ClassVar, Generic, TypedDict, cast, overload
 from xml.sax.saxutils import escape as xml_escape
 
 from .io import open_file
@@ -24,6 +24,11 @@ from .typing import (
 )
 from .utils import join_components
 
+if TYPE_CHECKING:
+    from typing_extensions import Self
+else:
+    Self = Any
+
 # -- Utility components
 
 
@@ -238,7 +243,7 @@ class ContextAware:
         if isinstance(result, cls):
             return result
 
-        raise TypeError("Incorrectly context data type.")
+        raise TypeError(f"Invalid context data type for {cls.__name__}.")
 
 
 # -- Function components

htmy/md/typing.py

@@ -1,8 +1,13 @@
 from collections.abc import Callable
-from typing import Any, NotRequired, TypeAlias, TypedDict
+from typing import TYPE_CHECKING, Any, TypeAlias, TypedDict
 
 from htmy.typing import Component
 
+if TYPE_CHECKING:
+    from typing_extensions import NotRequired
+else:
+    from typing import Optional as NotRequired
+
 MarkdownMetadataDict: TypeAlias = dict[str, Any]
 
 

htmy/typing.py

@@ -1,4 +1,4 @@
-from collections.abc import Callable, Coroutine, Mapping
+from collections.abc import Callable, Coroutine, Mapping, MutableMapping
 from typing import Any, Protocol, TypeAlias, TypeGuard, TypeVar, runtime_checkable
 
 T = TypeVar("T")
@@ -23,6 +23,14 @@ ContextValue: TypeAlias = Any
 Context: TypeAlias = Mapping[ContextKey, ContextValue]
 """Context mapping."""
 
+MutableContext: TypeAlias = MutableMapping[ContextKey, ContextValue]
+"""
+Mutable context mapping.
+
+It can be helpful when the created context should be marked as mutable for static type analysis
+(usually the created context is a plain `dict`).
+"""
+
 # -- Components
 
 

{htmy-0.3.1.dist-info → htmy-0.3.3.dist-info}/METADATA

@@ -1,13 +1,14 @@
 Metadata-Version: 2.1
 Name: htmy
-Version: 0.3.1
+Version: 0.3.3
 Summary: Async, pure-Python rendering engine.
 License: MIT
 Author: Peter Volf
 Author-email: do.volfp@gmail.com
-Requires-Python: >=3.11,<4.0
+Requires-Python: >=3.10,<4.0
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13

{htmy-0.3.1.dist-info → htmy-0.3.3.dist-info}/RECORD

@@ -1,17 +1,17 @@
-htmy/__init__.py,sha256=_hffMH5lgK2E8cV62Fr90dF2fjfdjM5WMPgWMe9EP4M,1782
-htmy/core.py,sha256=9BvzVMc3ZL94It6Yw4qxodbxLvw_PolJO1uzzxW4Rbo,18562
+htmy/__init__.py,sha256=My_Dmh9JNQpQekTO6CEbdbV7Ux7MD9Pz-L2M3KMZjGQ,1835
+htmy/core.py,sha256=6_mFrJ1GdMQv3lrIgUWa0-41NhSKGtgwrXrxYr7BHQY,18666
 htmy/etree.py,sha256=zZkKY82t5fX85unS9oHuG6KEBsJY_iz6E7SJto8lSVQ,3097
 htmy/html.py,sha256=pxmE-KU5OgwNp6MyxOfdS0Ohpzu2RNYCeGGFlHLDGUM,20940
 htmy/i18n.py,sha256=brNazQjObBFfbnViZCpcnxa0qgxQbJfX7xJAH-MqTW8,5124
 htmy/io.py,sha256=iebJOZp7L0kZ9SWdqMatKtW5VGRIkEd-eD0_vTAldH8,41
 htmy/md/__init__.py,sha256=lxBJnYplkDuxYuiese6My9KYp1DeGdzo70iUdYTvMnE,334
 htmy/md/core.py,sha256=-EKucDFKMUtGgs9k_q9134oXY2GXtdKX1KOJXG4YmKc,3342
-htmy/md/typing.py,sha256=LbsoAJ8OnZod9UbFiNVvWAEyFDqGRKhGmRpLWqbi8VY,642
+htmy/md/typing.py,sha256=LF-AEvo7FCW2KumyR5l55rsXizV2E4AHVLKFf6lApgM,762
 htmy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 htmy/renderer.py,sha256=vIY-_IFonctEHgl6kOL3586Peve2Lz7Ly8jpf9WOlqQ,3706
-htmy/typing.py,sha256=QdqbObdnrVvHjIpVlEH4ylZtvZCuOYU9XygF3oI1IQ8,2672
+htmy/typing.py,sha256=iUZQjMU-DHMV1Mv-ugW26eSPlrFO-KVhWfkLod7dig4,2937
 htmy/utils.py,sha256=7_CyA39l2m6jzDqparPKkKgRB2wiGuBZXbiPgiZOXKA,1093
-htmy-0.3.1.dist-info/LICENSE,sha256=rFtoGU_3c_rlacXgOZapTHfMErN-JFPT5Bq_col4bqI,1067
-htmy-0.3.1.dist-info/METADATA,sha256=hNSmkwmwBGr0xfVSrOsp6BPfNZ-kCX6m0gGN5I7WqSo,16210
-htmy-0.3.1.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-htmy-0.3.1.dist-info/RECORD,,
+htmy-0.3.3.dist-info/LICENSE,sha256=rFtoGU_3c_rlacXgOZapTHfMErN-JFPT5Bq_col4bqI,1067
+htmy-0.3.3.dist-info/METADATA,sha256=MPbERjyHqKdhtcWZyM2rUeHHwTL3uzfY-O5zUB1IjBY,16261
+htmy-0.3.3.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+htmy-0.3.3.dist-info/RECORD,,