htmy 0.3.2__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,11 +5,9 @@ import asyncio
 import enum
 from collections.abc import Callable, Container
 from pathlib import Path
-from typing import Any, ClassVar, Generic, TypedDict, cast, overload
+from typing import TYPE_CHECKING, Any, ClassVar, Generic, TypedDict, cast, overload
 from xml.sax.saxutils import escape as xml_escape
 
-from typing_extensions import Self
-
 from .io import open_file
 from .typing import (
     AsyncFunctionComponent,
@@ -26,6 +24,11 @@ from .typing import (
 )
 from .utils import join_components
 
+if TYPE_CHECKING:
+    from typing_extensions import Self
+else:
+    Self = Any
+
 # -- Utility components
 
 
@@ -240,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,10 +1,13 @@
 from collections.abc import Callable
-from typing import Any, TypeAlias, TypedDict
-
-from typing_extensions import NotRequired
+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.2.dist-info → htmy-0.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: htmy
-Version: 0.3.2
+Version: 0.3.3
 Summary: Async, pure-Python rendering engine.
 License: MIT
 Author: Peter Volf

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

@@ -1,17 +1,17 @@
-htmy/__init__.py,sha256=_hffMH5lgK2E8cV62Fr90dF2fjfdjM5WMPgWMe9EP4M,1782
-htmy/core.py,sha256=bVnIgyw5ED6c7CMIafFpaWeweuMyGFPwgRxOH48hSUI,18592
+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=VNUmrJILyX9NsytUA72BlXnVF7Ak7MIV4fp3eZVS0TQ,672
+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.2.dist-info/LICENSE,sha256=rFtoGU_3c_rlacXgOZapTHfMErN-JFPT5Bq_col4bqI,1067
-htmy-0.3.2.dist-info/METADATA,sha256=KwUfX4_DDWIkWBGhcFOLfi7xHaQCI5lz70cn2Z0y7pg,16261
-htmy-0.3.2.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-htmy-0.3.2.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,,