djhtmx 1.2.0__tar.gz → 1.2.1__tar.gz

{djhtmx-1.2.0 → djhtmx-1.2.1}/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.1] - 2025-10-01
+
+### Added
+- **Literal Type Support in Query Objects**: Query objects can now use `Literal` type annotations for parameters. The introspection system now recognizes `Literal` types with simple values (str, int, float, bool, etc.) as basic types, enabling more precise type constraints in HTMX component queries.
+
 ## [1.2.0] - 2025-09-29
 
 ### Added

{djhtmx-1.2.0 → djhtmx-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: djhtmx
-Version: 1.2.0
+Version: 1.2.1
 Summary: Interactive UI Components for Django using HTMX
 Project-URL: Homepage, https://github.com/edelvalle/djhtmx
 Project-URL: Documentation, https://github.com/edelvalle/djhtmx#readme

{djhtmx-1.2.0 → djhtmx-1.2.1}/src/djhtmx/__init__.py

@@ -1,4 +1,4 @@
 from .middleware import middleware
 
-__version__ = "1.2.0"
+__version__ = "1.2.1"
 __all__ = ("middleware",)

{djhtmx-1.2.0 → djhtmx-1.2.1}/src/djhtmx/introspection.py

@@ -13,6 +13,7 @@ from typing import (
     Annotated,
     Any,
     Generic,
+    Literal,
     TypedDict,
     TypeVar,
     Union,
@@ -381,6 +382,11 @@ infallible_bool_adapter = TypeAdapter(
 )
 
 
+def is_literal_annotation(ann):
+    """Returns True if the annotation is a Literal type with simple values."""
+    return get_origin(ann) is Literal and all(type(arg) in _SIMPLE_TYPES for arg in get_args(ann))
+
+
 def is_basic_type(ann):
     """Returns True if the annotation is a simple type.
 
@@ -395,6 +401,8 @@ def is_basic_type(ann):
 
     - Instances of dict, tuple, list or set
 
+    - Literal types with simple values
+
     """
     return (
         ann in _SIMPLE_TYPES
@@ -402,6 +410,7 @@ def is_basic_type(ann):
         or issubclass_safe(getattr(ann, "__origin__", None), models.Model)
         or issubclass_safe(ann, (enum.IntEnum, enum.StrEnum))
         or is_collection_annotation(ann)
+        or is_literal_annotation(ann)
     )
 
 

{djhtmx-1.2.0 → djhtmx-1.2.1}/src/djhtmx/utils.py

@@ -129,6 +129,7 @@ def autodiscover_htmx_modules():
     - htmx.py files (like standard autodiscover_modules("htmx"))
     - All Python files under htmx/ directories in apps (recursively)
     """
+
     def _import_modules_recursively(module_name):
         """Recursively import a module and all its submodules."""
         with contextlib.suppress(ImportError):