htmy 0.3.1__tar.gz → 0.3.3__tar.gz

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

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

@@ -1,13 +1,13 @@
 [tool.poetry]
 name = "htmy"
-version = "0.3.1"
+version = "0.3.3"
 description = "Async, pure-Python rendering engine."
 authors = ["Peter Volf <do.volfp@gmail.com>"]
 license = "MIT"
 readme = "README.md"
 
 [tool.poetry.dependencies]
-python = "^3.11"
+python = "^3.10"
 anyio = "^4.6.2.post1"
 async-lru = "^2.0.4"
 markdown = "^3.7"
@@ -22,6 +22,7 @@ pytest-asyncio = "^0.24.0"
 pytest-random-order = "^1.1.1"
 ruff = "^0.6.8"
 types-markdown = "^3.7.0.20240822"
+typing-extensions = "^4.12.2"
 
 [build-system]
 requires = ["poetry-core"]