htmy 0.3.2__tar.gz → 0.3.3__tar.gz

{htmy-0.3.2 → htmy-0.3.3}/PKG-INFO

@@ -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 → htmy-0.3.3}/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-0.3.2 → htmy-0.3.3}/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-0.3.2 → htmy-0.3.3}/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-0.3.2 → htmy-0.3.3}/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 → htmy-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "htmy"
-version = "0.3.2"
+version = "0.3.3"
 description = "Async, pure-Python rendering engine."
 authors = ["Peter Volf <do.volfp@gmail.com>"]
 license = "MIT"