djhtmx 1.3.1__py3-none-any.whl → 1.3.3__py3-none-any.whl

djhtmx/__init__.py

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

djhtmx/introspection.py

@@ -78,12 +78,14 @@ class _LazyModelProxy(Generic[M]):  # noqa
     __pk: Any | None
     __select_related: Sequence[str] | None
     __prefetch_related: Sequence[str | Prefetch] | None
+    __allow_none: bool
 
     def __init__(
         self,
         model: type[M],
         value: Any,
         model_annotation: ModelConfig | None = None,
+        allow_none: bool = False,
     ):
         self.__model = model
         if value is None or isinstance(value, model):
@@ -98,12 +100,44 @@ class _LazyModelProxy(Generic[M]):  # noqa
         else:
             self.__select_related = None
             self.__prefetch_related = None
+        self.__allow_none = allow_none
+
+    def __bool__(self) -> bool:
+        """Check if the instance exists. Called when proxy is used in boolean context."""
+        if self.__instance is None:
+            self.__ensure_instance()
+            if self.__instance is None:
+                # Object doesn't exist
+                if not self.__allow_none:
+                    # Required field - raise exception
+                    from django.core.exceptions import ObjectDoesNotExist
+
+                    raise ObjectDoesNotExist(
+                        f"{self.__model.__name__} with pk={self.__pk} does not exist "
+                        "(object may have been deleted)"
+                    )
+                # Optional field - return False (proxy is falsy)
+                return False
+        return True
 
     def __getattr__(self, name: str) -> Any:
         if name == "pk":
             return self.__pk
         if self.__instance is None:
             self.__ensure_instance()
+            if self.__instance is None:
+                # Object doesn't exist (was deleted or never existed)
+                if self.__allow_none:
+                    # Optional field (Model | None) - return None gracefully
+                    return None
+                else:
+                    # Required field (Model) - raise explicit exception
+                    from django.core.exceptions import ObjectDoesNotExist
+
+                    raise ObjectDoesNotExist(
+                        f"{self.__model.__name__} with pk={self.__pk} does not exist "
+                        "(object may have been deleted)"
+                    )
         return getattr(self.__instance, name)
 
     def __ensure_instance(self):
@@ -143,9 +177,13 @@ class _ModelBeforeValidator(Generic[M]):  # noqa
             return None
         elif isinstance(value, _LazyModelProxy):
             instance = value._LazyModelProxy__instance or value._LazyModelProxy__pk
-            return _LazyModelProxy(self.model, instance, model_annotation=self.model_config)
+            return _LazyModelProxy(
+                self.model, instance, model_annotation=self.model_config, allow_none=self.allow_none
+            )
         else:
-            return _LazyModelProxy(self.model, value, model_annotation=self.model_config)
+            return _LazyModelProxy(
+                self.model, value, model_annotation=self.model_config, allow_none=self.allow_none
+            )
 
     def _get_instance(self, value):
         if value is None or isinstance(value, self.model):
@@ -254,7 +292,16 @@ def annotate_model(annotation, *, model_config: ModelConfig | None = None):
                 # Process the base type (first arg) and keep other metadata
                 base_type = args[0]
                 metadata = args[1:]
-                processed_base = annotate_model(base_type, model_config=model_config)
+
+                # Extract ModelConfig from metadata if present
+                extracted_model_config = next(
+                    (m for m in metadata if isinstance(m, ModelConfig)),
+                    None,
+                )
+                # Use extracted config, falling back to passed parameter
+                config_to_use = extracted_model_config or model_config
+
+                processed_base = annotate_model(base_type, model_config=config_to_use)
 
                 # If processed_base is also Annotated, merge the metadata
                 if get_origin(processed_base) is Annotated:
@@ -293,6 +340,8 @@ def annotate_model(annotation, *, model_config: ModelConfig | None = None):
                         return type_[
                             *(annotate_model(p, model_config=model_annotation) for p in params)
                         ]  # type: ignore
+        # Other generic types (list, dict, defaultdict, etc.) - return as-is
+        return annotation
     else:
         return annotation
 

{djhtmx-1.3.1.dist-info → djhtmx-1.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: djhtmx
-Version: 1.3.1
+Version: 1.3.3
 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
@@ -311,6 +311,23 @@ class TodoComponent(HtmxComponent):
     ]
 ```
 
+**Handling Deleted Objects:**
+
+Lazy models handle deleted database objects gracefully:
+
+```python
+class MyComponent(HtmxComponent):
+    # Required: raises ObjectDoesNotExist when checking if object was deleted
+    item: Annotated[Item, ModelConfig(lazy=True)]
+
+    # Optional: becomes falsy and returns None when object was deleted
+    archived_item: Annotated[Item | None, ModelConfig(lazy=True)]
+```
+
+- **Required lazy models**: Checking truthiness (`if component.item:`) raises `ObjectDoesNotExist` with a clear message
+- **Optional lazy models**: Checking truthiness returns `False`, field accesses return `None`
+- **Both**: Accessing `.pk` always works without triggering database queries
+
 ## Component nesting
 
 Components can contain components inside to decompose the behavior in more granular and specialized parts, for this you don't have to do anything but to a component inside the template of other component....

{djhtmx-1.3.1.dist-info → djhtmx-1.3.3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-djhtmx/__init__.py,sha256=sFHexB1yrCT8QBiug5AGMLj4zmcax_WDdxeUL6DYYoQ,84
+djhtmx/__init__.py,sha256=VL_7rY7fcdRsK0N7SZK5nteSMhURTdTtuExuNLQaZBs,84
 djhtmx/apps.py,sha256=hAyjzmInEstxLY9k8Qn58LvNlezgQLx5_NqyVL1WwYs,323
 djhtmx/command_queue.py,sha256=LSUkb2YMRt1lDyOg6WP7PoHsObynec0B55JyFtcshT0,5090
 djhtmx/commands.py,sha256=UxXbARd4Teetjh_zjvAWgI2KNbvdETH-WrGf4qD9Xr8,1206
@@ -7,7 +7,7 @@ djhtmx/consumer.py,sha256=0Yh8urgMH3khA6_pWeY049w3jqHWZL_K9dErOhNctQA,2898
 djhtmx/context.py,sha256=cWvz8Z0MC6x_G8sn5mvoH8Hu38qReY21_eNdThuba1A,214
 djhtmx/exceptions.py,sha256=UtyE1N-52OmzwgRM9xFxjUuhHTMDvD7Oy3rNpgthLcs,47
 djhtmx/global_events.py,sha256=bYb8WmQn_WsZ_Dadr0pGiGOPia01K-VanPpM97Lt324,342
-djhtmx/introspection.py,sha256=HGtKTFNG2FhJkLftQC7bUiJPhyyBZtix0BCOdlraTqE,17807
+djhtmx/introspection.py,sha256=s1hJ5EO-DcLOZwBiZSUAcnBsCi1ewwPlER1cFPO1QNo,19907
 djhtmx/json.py,sha256=7cjwWIJj7e0dk54INKYZJe6zKkIW7wlsNSlD05cbXfY,1374
 djhtmx/middleware.py,sha256=JuMtv9ZnpungTvQ1qD2Lg6LiFPB3knQlA1ERgH4iGl0,1274
 djhtmx/query.py,sha256=GKubKKZ1Z6krzLjG4GZpcxAyPy-pCMCtyfSVfXrpy90,6855
@@ -31,7 +31,7 @@ djhtmx/templates/htmx/headers.html,sha256=z7r9klwBDXDyjbHrzatZeHDvXB2DaZhgu55CFb
 djhtmx/templates/htmx/lazy.html,sha256=LfAThtKmFj-lCUZ7JWF_sC1Y6XsIpEz8A3IgWASn-J8,52
 djhtmx/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 djhtmx/templatetags/htmx.py,sha256=-qFqz4T9mCJocG9XIIey81cCYwk07XUd_DMpxNdmbsM,8397
-djhtmx-1.3.1.dist-info/METADATA,sha256=8ZRSOBEA730-0kym22awNPktiV6c715fDTvON-DI5o0,33050
-djhtmx-1.3.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-djhtmx-1.3.1.dist-info/licenses/LICENSE,sha256=kCi_iSBUGsRZInQn96w7LXYzjiRjZ8FXl6vP--mFRPk,1085
-djhtmx-1.3.1.dist-info/RECORD,,
+djhtmx-1.3.3.dist-info/METADATA,sha256=5UCGB6iJel1PhQxBnImgvcGp-n6jgfhWUEmNtz68Bck,33745
+djhtmx-1.3.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+djhtmx-1.3.3.dist-info/licenses/LICENSE,sha256=kCi_iSBUGsRZInQn96w7LXYzjiRjZ8FXl6vP--mFRPk,1085
+djhtmx-1.3.3.dist-info/RECORD,,