django-bulk-hooks 0.1.77__py3-none-any.whl → 0.1.79__py3-none-any.whl

django_bulk_hooks/__init__.py

@@ -1,4 +1,32 @@
-from django_bulk_hooks.handler import Hook
-from django_bulk_hooks.manager import BulkHookManager
+from django_bulk_hooks.constants import (
+    AFTER_CREATE,
+    AFTER_DELETE,
+    AFTER_UPDATE,
+    BEFORE_CREATE,
+    BEFORE_DELETE,
+    BEFORE_UPDATE,
+    VALIDATE_CREATE,
+    VALIDATE_DELETE,
+    VALIDATE_UPDATE,
+)
+from django_bulk_hooks.engine import safe_get_related_object, safe_get_related_attr
+from django_bulk_hooks.handler import HookHandler
+from django_bulk_hooks.models import HookModelMixin
+from django_bulk_hooks.enums import Priority
 
-__all__ = ["BulkHookManager", "Hook"]
+__all__ = [
+    "HookHandler",
+    "HookModelMixin",
+    "BEFORE_CREATE",
+    "AFTER_CREATE",
+    "BEFORE_UPDATE",
+    "AFTER_UPDATE",
+    "BEFORE_DELETE",
+    "AFTER_DELETE",
+    "VALIDATE_CREATE",
+    "VALIDATE_UPDATE",
+    "VALIDATE_DELETE",
+    "safe_get_related_object",
+    "safe_get_related_attr",
+    "Priority",
+]

django_bulk_hooks/conditions.py

@@ -1,4 +1,32 @@
-from django_bulk_hooks.engine import safe_get_related_object
+from django.db import models
+
+
+def safe_get_related_object(instance, field_name):
+    """
+    Safely get a related object without raising RelatedObjectDoesNotExist.
+    Returns None if the foreign key field is None or the related object doesn't exist.
+    """
+    if not hasattr(instance, field_name):
+        return None
+    
+    # Get the foreign key field
+    try:
+        field = instance._meta.get_field(field_name)
+        if not field.is_relation or field.many_to_many or field.one_to_many:
+            return getattr(instance, field_name, None)
+    except models.FieldDoesNotExist:
+        return getattr(instance, field_name, None)
+    
+    # Check if the foreign key field is None
+    fk_field_name = f"{field_name}_id"
+    if hasattr(instance, fk_field_name) and getattr(instance, fk_field_name) is None:
+        return None
+    
+    # Try to get the related object, but catch RelatedObjectDoesNotExist
+    try:
+        return getattr(instance, field_name)
+    except field.related_model.RelatedObjectDoesNotExist:
+        return None
 
 
 def resolve_dotted_attr(instance, dotted_path):

django_bulk_hooks/decorators.py

@@ -4,6 +4,7 @@ from functools import wraps
 from django.core.exceptions import FieldDoesNotExist
 from django_bulk_hooks.enums import DEFAULT_PRIORITY
 from django_bulk_hooks.registry import register_hook
+from django_bulk_hooks.engine import safe_get_related_object
 
 
 def hook(event, *, model, condition=None, priority=DEFAULT_PRIORITY):
@@ -133,18 +134,13 @@ def select_related(*related_fields):
                     # Check if the foreign key field is set
                     fk_field_name = f"{field}_id"
                     if hasattr(obj, fk_field_name) and getattr(obj, fk_field_name) is not None:
-                        # The foreign key ID is set, so we can try to get the related object
-                        try:
-                            rel_obj = getattr(obj, field)
-                            if rel_obj is not None:
-                                # Ensure it's cached to prevent future queries
-                                if not hasattr(obj._state, 'fields_cache'):
-                                    obj._state.fields_cache = {}
-                                obj._state.fields_cache[field] = rel_obj
-                        except Exception:
-                            # If we can't get the related object, that's okay
-                            # The foreign key ID is set, so the relationship exists
-                            pass
+                        # The foreign key ID is set, so we can try to get the related object safely
+                        rel_obj = safe_get_related_object(obj, field)
+                        if rel_obj is not None:
+                            # Ensure it's cached to prevent future queries
+                            if not hasattr(obj._state, 'fields_cache'):
+                                obj._state.fields_cache = {}
+                            obj._state.fields_cache[field] = rel_obj
 
             return func(*bound.args, **bound.kwargs)
 

django_bulk_hooks/engine.py

@@ -3,38 +3,11 @@ import logging
 from django.core.exceptions import ValidationError
 from django.db import models
 from django_bulk_hooks.registry import get_hooks
+from django_bulk_hooks.conditions import safe_get_related_object
 
 logger = logging.getLogger(__name__)
 
 
-def safe_get_related_object(instance, field_name):
-    """
-    Safely get a related object without raising RelatedObjectDoesNotExist.
-    Returns None if the foreign key field is None or the related object doesn't exist.
-    """
-    if not hasattr(instance, field_name):
-        return None
-    
-    # Get the foreign key field
-    try:
-        field = instance._meta.get_field(field_name)
-        if not field.is_relation or field.many_to_many or field.one_to_many:
-            return getattr(instance, field_name, None)
-    except models.FieldDoesNotExist:
-        return getattr(instance, field_name, None)
-    
-    # Check if the foreign key field is None
-    fk_field_name = f"{field_name}_id"
-    if hasattr(instance, fk_field_name) and getattr(instance, fk_field_name) is None:
-        return None
-    
-    # Try to get the related object, but catch RelatedObjectDoesNotExist
-    try:
-        return getattr(instance, field_name)
-    except field.related_model.RelatedObjectDoesNotExist:
-        return None
-
-
 def safe_get_related_attr(instance, field_name, attr_name=None):
     """
     Safely get a related object or its attribute without raising RelatedObjectDoesNotExist.

django_bulk_hooks/handler.py

@@ -86,7 +86,7 @@ class HookMeta(type):
         return cls
 
 
-class Hook(metaclass=HookMeta):
+class HookHandler(metaclass=HookMeta):
     @classmethod
     def handle(
         cls,

django_bulk_hooks/registry.py

@@ -1,7 +1,7 @@
 from collections.abc import Callable
 from typing import Union
 
-from django_bulk_hooks.priority import Priority
+from django_bulk_hooks.enums import Priority
 
 _hooks: dict[tuple[type, str], list[tuple[type, str, Callable, int]]] = {}
 
@@ -17,8 +17,7 @@ def register_hook(
 
 
 def get_hooks(model, event):
-    hooks = _hooks.get((model, event), [])
-    return hooks
+    return _hooks.get((model, event), [])
 
 
 def list_all_hooks():

{django_bulk_hooks-0.1.77.dist-info → django_bulk_hooks-0.1.79.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: django-bulk-hooks
-Version: 0.1.77
+Version: 0.1.79
 Summary: Hook-style hooks for Django bulk operations like bulk_create and bulk_update.
 License: MIT
 Keywords: django,bulk,hooks
@@ -58,7 +58,7 @@ from django_bulk_hooks import hook, AFTER_UPDATE, Hook
 from django_bulk_hooks.conditions import WhenFieldHasChanged
 from .models import Account
 
-class AccountHooks(Hook):
+class AccountHooks(HookHandler):
     @hook(AFTER_UPDATE, model=Account, condition=WhenFieldHasChanged("balance"))
     def log_balance_change(self, new_records, old_records):
         print("Accounts updated:", [a.pk for a in new_records])
@@ -74,99 +74,10 @@ class AccountHooks(Hook):
         print("Accounts deleted:", [a.pk for a in old_records])
 ```
 
-## 🛠 Supported Hook Events
-
-- `BEFORE_CREATE`, `AFTER_CREATE`
-- `BEFORE_UPDATE`, `AFTER_UPDATE`
-- `BEFORE_DELETE`, `AFTER_DELETE`
-
-## 🔄 Lifecycle Events
-
-### Individual Model Operations
-
-The `HookModelMixin` automatically triggers hooks for individual model operations:
-
-```python
-# These will trigger BEFORE_CREATE and AFTER_CREATE hooks
-account = Account.objects.create(balance=100.00)
-account.save()  # for new instances
-
-# These will trigger BEFORE_UPDATE and AFTER_UPDATE hooks
-account.balance = 200.00
-account.save()  # for existing instances
-
-# This will trigger BEFORE_DELETE and AFTER_DELETE hooks
-account.delete()
-```
-
-### Bulk Operations
-
-Bulk operations also trigger the same hooks:
-
-```python
-# Bulk create - triggers BEFORE_CREATE and AFTER_CREATE hooks
-accounts = [
-    Account(balance=100.00),
-    Account(balance=200.00),
-]
-Account.objects.bulk_create(accounts)
-
-# Bulk update - triggers BEFORE_UPDATE and AFTER_UPDATE hooks
-for account in accounts:
-    account.balance *= 1.1
-Account.objects.bulk_update(accounts, ['balance'])
-
-# Bulk delete - triggers BEFORE_DELETE and AFTER_DELETE hooks
-Account.objects.bulk_delete(accounts)
-```
-
-### Queryset Operations
-
-Queryset operations are also supported:
-
-```python
-# Queryset update - triggers BEFORE_UPDATE and AFTER_UPDATE hooks
-Account.objects.update(balance=0.00)
-
-# Queryset delete - triggers BEFORE_DELETE and AFTER_DELETE hooks
-Account.objects.delete()
-```
-
-## 🧠 Why?
-
-Django's `bulk_` methods bypass signals and `save()`. This package fills that gap with:
-
-- Hooks that behave consistently across creates/updates/deletes
-- **NEW**: Individual model lifecycle hooks that work with `save()` and `delete()`
-- Scalable performance via chunking (default 200)
-- Support for `@hook` decorators and centralized hook classes
-- **NEW**: Automatic hook triggering for admin operations and other Django features
-
-## 📦 Usage Examples
-
-### Individual Model Operations
-
-```python
-# These automatically trigger hooks
-account = Account.objects.create(balance=100.00)
-account.balance = 200.00
-account.save()
-account.delete()
-```
-
-### Bulk Operations
-
-```python
-# These also trigger hooks
-Account.objects.bulk_create(accounts)
-Account.objects.bulk_update(accounts, ['balance'])
-Account.objects.bulk_delete(accounts)
-```
-
 ### Advanced Hook Usage
 
 ```python
-class AdvancedAccountHooks(Hook):
+class AdvancedAccountHooks(HookHandler):
     @hook(BEFORE_UPDATE, model=Account, condition=WhenFieldHasChanged("balance"))
     def validate_balance_change(self, new_records, old_records):
         for new_account, old_account in zip(new_records, old_records):
@@ -179,17 +90,3 @@ class AdvancedAccountHooks(Hook):
             # Send welcome email logic here
             pass
 ```
-
-## 🧩 Integration with Queryable Properties
-
-You can extend from `BulkHookManager` to support formula fields or property querying.
-
-```python
-class MyManager(BulkHookManager, QueryablePropertiesManager):
-    pass
-```
-
-## 📝 License
-
-MIT © 2024 Augend / Konrad Beck
-

django_bulk_hooks-0.1.79.dist-info/RECORD

@@ -0,0 +1,16 @@
+django_bulk_hooks/__init__.py,sha256=JU6GMrqIPDm1n8zc78iTd1I1pzubmdkBJwROMaecZPM,805
+django_bulk_hooks/conditions.py,sha256=o31qTnSfEkAKMVnFPF0JdkuvMFWb92Lc-o-WQ2CoWAk,8107
+django_bulk_hooks/constants.py,sha256=3x1H1fSUUNo0DZONN7GUVDuySZctTR-jtByBHmAIX5w,303
+django_bulk_hooks/context.py,sha256=HVDT73uSzvgrOR6mdXTvsBm3hLOgBU8ant_mB7VlFuM,380
+django_bulk_hooks/decorators.py,sha256=zstmb27dKcOHu3Atg7cauewCTzPvUmq03mzVKJRi56o,7230
+django_bulk_hooks/engine.py,sha256=ru6oxoXEj4eC8JM30hzLj-jcD-_Mcg-SaPqexxR87c0,2183
+django_bulk_hooks/enums.py,sha256=Zo8_tJzuzZ2IKfVc7gZ-0tWPT8q1QhqZbAyoh9ZVJbs,381
+django_bulk_hooks/handler.py,sha256=Qpg_zT6SsQiTlhduvzXxPdG6uynjyR2fBjj-R6HZiXI,4861
+django_bulk_hooks/manager.py,sha256=-V128ACxPAz82ua4jQRFUkjAKtKW4MN5ppz0bHcv5s4,7138
+django_bulk_hooks/models.py,sha256=7RG7GrOdHXFjGVPV4FPRZVNMIHHW-hMCi6hn9LH_hVI,3331
+django_bulk_hooks/queryset.py,sha256=7lLqhZ-XOYsZ1I3Loxi4Nhz79M8HlTYE413AW8nyeDI,1330
+django_bulk_hooks/registry.py,sha256=Vh78exKYcdZhM27120kQm-iXGOjd_kf9ZUYBZ8eQ2V0,683
+django_bulk_hooks-0.1.79.dist-info/LICENSE,sha256=dguKIcbDGeZD-vXWdLyErPUALYOvtX_fO4Zjhq481uk,1088
+django_bulk_hooks-0.1.79.dist-info/METADATA,sha256=MfSByYpJLtek9y5Vr8GjUt635pK0McIEZRCE2W0O0mA,3388
+django_bulk_hooks-0.1.79.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+django_bulk_hooks-0.1.79.dist-info/RECORD,,

django_bulk_hooks/priority.py

@@ -1,16 +0,0 @@
-from enum import IntEnum
-
-
-class Priority(IntEnum):
-    """
-    Named priorities for django-bulk-hooks hooks.
-
-    Lower values run earlier (higher priority).
-    Hooks are sorted in ascending order.
-    """
-
-    HIGHEST = 0  # runs first
-    HIGH = 25  # runs early
-    NORMAL = 50  # default ordering
-    LOW = 75  # runs later
-    LOWEST = 100  # runs last

django_bulk_hooks-0.1.77.dist-info/RECORD

@@ -1,17 +0,0 @@
-django_bulk_hooks/__init__.py,sha256=uUgpnb9AWjIAcWNpCMqBcOewSnpJjJYH6cjPbQkzoNU,140
-django_bulk_hooks/conditions.py,sha256=yPrWj1nA1ptpQFG5zhHmRwt4rswhnkKSWM4ZyicDF58,7094
-django_bulk_hooks/constants.py,sha256=3x1H1fSUUNo0DZONN7GUVDuySZctTR-jtByBHmAIX5w,303
-django_bulk_hooks/context.py,sha256=HVDT73uSzvgrOR6mdXTvsBm3hLOgBU8ant_mB7VlFuM,380
-django_bulk_hooks/decorators.py,sha256=QnZEHSR4JNek3DkTs8P5FZS3yEW9dKztuEEHeiKzqpg,7440
-django_bulk_hooks/engine.py,sha256=5zj7R2Pot6T17RCq9BZ8ajc7vgRJJYAUODA3qzwSAe0,3162
-django_bulk_hooks/enums.py,sha256=Zo8_tJzuzZ2IKfVc7gZ-0tWPT8q1QhqZbAyoh9ZVJbs,381
-django_bulk_hooks/handler.py,sha256=xZt8iNdYF-ACz-MnKMY0co6scWINU5V5wC1lyDn844k,4854
-django_bulk_hooks/manager.py,sha256=-V128ACxPAz82ua4jQRFUkjAKtKW4MN5ppz0bHcv5s4,7138
-django_bulk_hooks/models.py,sha256=7RG7GrOdHXFjGVPV4FPRZVNMIHHW-hMCi6hn9LH_hVI,3331
-django_bulk_hooks/priority.py,sha256=HG_2D35nga68lBCZmSXTcplXrjFoRgZFRDOy4ROKonY,376
-django_bulk_hooks/queryset.py,sha256=7lLqhZ-XOYsZ1I3Loxi4Nhz79M8HlTYE413AW8nyeDI,1330
-django_bulk_hooks/registry.py,sha256=-mQBizJ06nz_tajZBinViKx_uP2Tbc1tIpTEMv7lwKA,705
-django_bulk_hooks-0.1.77.dist-info/LICENSE,sha256=dguKIcbDGeZD-vXWdLyErPUALYOvtX_fO4Zjhq481uk,1088
-django_bulk_hooks-0.1.77.dist-info/METADATA,sha256=-6TsAFggFzX4j4ppWGCApRmWFy0E6TV8TTCaIfonV44,5930
-django_bulk_hooks-0.1.77.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-django_bulk_hooks-0.1.77.dist-info/RECORD,,