django-bulk-hooks 0.2.103__tar.gz → 0.3.3__tar.gz

{django_bulk_hooks-0.2.103 → django_bulk_hooks-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: django-bulk-hooks
-Version: 0.2.103
+Version: 0.3.3
 Summary: Hook-style hooks for Django bulk operations like bulk_create and bulk_update.
 License: MIT
 Keywords: django,bulk,hooks
@@ -32,6 +32,7 @@ Description-Content-Type: text/markdown
 - **NEW**: `HookModelMixin` for individual model lifecycle events
 - Hook chaining, hook deduplication, and atomicity
 - Class-based hook handlers with DI support
+- Register hooks against abstract models; they apply to all concrete subclasses
 - Support for both bulk and individual model operations
 
 ## 🚀 Quickstart
@@ -178,6 +179,7 @@ Django's `bulk_` methods bypass signals and `save()`. This package fills that ga
 
 - Hooks that behave consistently across creates/updates/deletes
 - **NEW**: Individual model lifecycle hooks that work with `save()` and `delete()`
+- **NEW**: Abstract-base hook registration; MTI support removed for simplicity and stability
 - Scalable performance via chunking (default 200)
 - Support for `@hook` decorators and centralized hook classes
 - **NEW**: Automatic hook hooking for admin operations and other Django features
@@ -314,6 +316,28 @@ Execute them in priority order
 Pass ChangeSet to them
 Handle errors (rollback on failure)
 
+## 🔄 Migration (1.0.0)
+
+- MTI (Multi-Table Inheritance) support has been removed.
+- Register hooks against abstract base models to have them apply to all concrete subclasses.
+- Example:
+
+```python
+class AbstractBusiness(models.Model):
+    class Meta:
+        abstract = True
+
+class Business(AbstractBusiness):
+    name = models.CharField(max_length=100)
+
+class BusinessHook(Hook):
+    @hook(AFTER_UPDATE, model=AbstractBusiness)
+    def on_update(self, new_records, old_records, **kwargs):
+        ...
+```
+
+If any model inherits from a concrete parent (true MTI), an error is raised at import time. Convert parents to abstract models instead.
+
 ## 📝 License
 
 MIT © 2024 Augend / Konrad Beck

{django_bulk_hooks-0.2.103 → django_bulk_hooks-0.3.3}/README.md

@@ -13,6 +13,7 @@
 - **NEW**: `HookModelMixin` for individual model lifecycle events
 - Hook chaining, hook deduplication, and atomicity
 - Class-based hook handlers with DI support
+- Register hooks against abstract models; they apply to all concrete subclasses
 - Support for both bulk and individual model operations
 
 ## 🚀 Quickstart
@@ -159,6 +160,7 @@ Django's `bulk_` methods bypass signals and `save()`. This package fills that ga
 
 - Hooks that behave consistently across creates/updates/deletes
 - **NEW**: Individual model lifecycle hooks that work with `save()` and `delete()`
+- **NEW**: Abstract-base hook registration; MTI support removed for simplicity and stability
 - Scalable performance via chunking (default 200)
 - Support for `@hook` decorators and centralized hook classes
 - **NEW**: Automatic hook hooking for admin operations and other Django features
@@ -295,6 +297,28 @@ Execute them in priority order
 Pass ChangeSet to them
 Handle errors (rollback on failure)
 
+## 🔄 Migration (1.0.0)
+
+- MTI (Multi-Table Inheritance) support has been removed.
+- Register hooks against abstract base models to have them apply to all concrete subclasses.
+- Example:
+
+```python
+class AbstractBusiness(models.Model):
+    class Meta:
+        abstract = True
+
+class Business(AbstractBusiness):
+    name = models.CharField(max_length=100)
+
+class BusinessHook(Hook):
+    @hook(AFTER_UPDATE, model=AbstractBusiness)
+    def on_update(self, new_records, old_records, **kwargs):
+        ...
+```
+
+If any model inherits from a concrete parent (true MTI), an error is raised at import time. Convert parents to abstract models instead.
+
 ## 📝 License
 
 MIT © 2024 Augend / Konrad Beck

{django_bulk_hooks-0.2.103 → django_bulk_hooks-0.3.3}/django_bulk_hooks/__init__.py

@@ -1,14 +1,23 @@
+"""
+Django Bulk Hooks - Salesforce-style hooks for Django bulk operations.
+
+Architecture:
+    Following Salesforce's trigger context pattern, each bulk operation
+    gets an isolated dispatcher context that's automatically cleaned up.
+    This prevents memory leaks in long-lived processes (web servers).
+"""
+
 import logging
 
 from django_bulk_hooks.changeset import ChangeSet
 from django_bulk_hooks.changeset import RecordChange
 from django_bulk_hooks.constants import DEFAULT_BULK_UPDATE_BATCH_SIZE
 from django_bulk_hooks.dispatcher import HookDispatcher
-from django_bulk_hooks.dispatcher import get_dispatcher
 from django_bulk_hooks.factory import clear_hook_factories
 from django_bulk_hooks.factory import configure_hook_container
 from django_bulk_hooks.factory import configure_nested_container
 from django_bulk_hooks.factory import create_hook_instance
+from django_bulk_hooks.factory import dishka_hook_resolver
 from django_bulk_hooks.factory import is_container_configured
 from django_bulk_hooks.factory import set_default_hook_factory
 from django_bulk_hooks.factory import set_hook_factory
@@ -20,34 +29,36 @@ from django_bulk_hooks.helpers import dispatch_hooks_for_operation
 from django_bulk_hooks.manager import BulkHookManager
 from django_bulk_hooks.operations import BulkExecutor
 
-# Service layer (NEW architecture)
+# Service layer (composition-based architecture)
 from django_bulk_hooks.operations import BulkOperationCoordinator
 from django_bulk_hooks.operations import ModelAnalyzer
-from django_bulk_hooks.operations import MTIHandler
 
 __all__ = [
+    # Manager and Hook base class
     "BulkHookManager",
     "HookClass",
+    # Dependency injection
     "set_hook_factory",
     "set_default_hook_factory",
     "configure_hook_container",
     "configure_nested_container",
+    "dishka_hook_resolver",
     "clear_hook_factories",
     "create_hook_instance",
     "is_container_configured",
+    # Constants
     "DEFAULT_BULK_UPDATE_BATCH_SIZE",
-    # Dispatcher-centric architecture
+    # Changeset (Salesforce-style context)
     "ChangeSet",
     "RecordChange",
-    "get_dispatcher",
-    "HookDispatcher",
     "build_changeset_for_create",
     "build_changeset_for_update",
     "build_changeset_for_delete",
+    # Dispatcher (per-operation context)
+    "HookDispatcher",
     "dispatch_hooks_for_operation",
     # Service layer (composition-based architecture)
     "BulkOperationCoordinator",
     "ModelAnalyzer",
     "BulkExecutor",
-    "MTIHandler",
 ]