django-webhook-subscriber 2.0.0__py3-none-any.whl → 2.1.0__py3-none-any.whl

django_webhook_subscriber/delivery.py

@@ -8,7 +8,7 @@ from django.utils import timezone
 from django.utils.module_loading import import_string
 
 from .conf import rest_webhook_settings as settings
-from .serializers import serialize_webhook_instance
+from .serializers import WebhookRawPayloadMixin, serialize_webhook_instance
 from .tasks import process_webhook_delivery_batch
 from .utils import (
     clear_content_type_cache,
@@ -184,14 +184,20 @@ class WebhookDeliveryProcessor:
             )
 
             # Build standard payload structure
-            payload = {
-                "pk": instance.pk,
-                "event_signal": event_name,
-                "source": f"{instance._meta.app_label}."
-                f"{instance._meta.model_name}",
-                "timestamp": timezone.now().isoformat(),
-                "fields": fields_data,
-            }
+            if serializer_class and issubclass(
+                serializer_class, WebhookRawPayloadMixin
+            ):
+                # Raw payload mixin - use fields data directly
+                payload = fields_data
+            else:
+                payload = {
+                    "pk": instance.pk,
+                    "event_signal": event_name,
+                    "source": f"{instance._meta.app_label}."
+                    f"{instance._meta.model_name}",
+                    "timestamp": timezone.now().isoformat(),
+                    "fields": fields_data,
+                }
 
             return payload
 

django_webhook_subscriber/serializers.py

@@ -39,3 +39,16 @@ def serialize_webhook_instance(instance, field_serializer=None):
     serialized_data = serializer.data
     # Return the serialized data
     return serialized_data
+
+
+class WebhookRawPayloadMixin:
+    """
+    Mixin to indicate that the webhook payload should be sent as raw data.
+
+    By default, the payload includes extra fields and the serialized
+    instance data goes inside a 'fields' key.
+    By having this mixin, the webhook payload will be just the
+    serialized instance data.
+    """
+
+    pass

django_webhook_subscriber/tests/test_delivery.py

@@ -220,6 +220,78 @@ class WebhookDeliveryProcessorTests(TestCase):
         self.assertIn("error", result)
         self.assertEqual(result["fields"], {})
 
+    @patch("django_webhook_subscriber.delivery.serialize_webhook_instance")
+    @patch("django_webhook_subscriber.delivery.import_string")
+    def test_generate_payload_with_raw_payload_mixin(
+        self, mock_import_string, mock_serialize
+    ):
+        """Test that WebhookRawPayloadMixin returns only serialized data."""
+        from rest_framework import serializers
+
+        from django_webhook_subscriber.serializers import (
+            WebhookRawPayloadMixin,
+        )
+
+        # Create a serializer class with WebhookRawPayloadMixin
+        class RawPayloadSerializer(
+            WebhookRawPayloadMixin, serializers.ModelSerializer
+        ):
+            class Meta:
+                model = models.WebhookDeliveryLog
+                fields = ["id", "payload"]
+
+        mock_import_string.return_value = RawPayloadSerializer
+        mock_serialize.return_value = {"id": 1, "payload": {"key": "value"}}
+
+        result = self.processor._generate_payload(
+            self.instance,
+            "created",
+            "some.path.RawPayloadSerializer",
+        )
+
+        # With WebhookRawPayloadMixin, the payload should be the serialized
+        # data directly, without metadata wrapper
+        self.assertEqual(result, {"id": 1, "payload": {"key": "value"}})
+        self.assertNotIn("pk", result)
+        self.assertNotIn("event_signal", result)
+        self.assertNotIn("source", result)
+        self.assertNotIn("timestamp", result)
+        self.assertNotIn("fields", result)
+
+    @patch("django_webhook_subscriber.delivery.serialize_webhook_instance")
+    @patch("django_webhook_subscriber.delivery.import_string")
+    def test_generate_payload_without_raw_payload_mixin(
+        self, mock_import_string, mock_serialize
+    ):
+        """Test that regular serializers return payload with metadata."""
+        from rest_framework import serializers
+
+        # Create a regular serializer without WebhookRawPayloadMixin
+        class RegularSerializer(serializers.ModelSerializer):
+            class Meta:
+                model = models.WebhookDeliveryLog
+                fields = ["id", "payload"]
+
+        mock_import_string.return_value = RegularSerializer
+        mock_serialize.return_value = {"id": 1, "payload": {"key": "value"}}
+
+        result = self.processor._generate_payload(
+            self.instance,
+            "created",
+            "some.path.RegularSerializer",
+        )
+
+        # Without WebhookRawPayloadMixin, the payload should include metadata
+        self.assertEqual(result["pk"], 1)
+        self.assertEqual(result["event_signal"], "created")
+        self.assertEqual(
+            result["source"], "django_webhook_subscriber.webhookdeliverylog"
+        )
+        self.assertIn("timestamp", result)
+        self.assertEqual(
+            result["fields"], {"id": 1, "payload": {"key": "value"}}
+        )
+
     def test_deliver_webhooks_on_no_subscriptions(self):
         result = self.processor._deliver_webhooks([])
 

{django_webhook_subscriber-2.0.0.dist-info → django_webhook_subscriber-2.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-webhook-subscriber
-Version: 2.0.0
+Version: 2.1.0
 Summary: A Django package designed to handle webhook creation, management, and delivery.
 Author-email: 42 Portugal <root@42porto.com>
 Classifier: Environment :: Web Environment
@@ -172,6 +172,53 @@ subscriber.serializer_class = "myapp.serializers.UserWebhookSerializer"
 subscriber.save()
 ```
 
+### 4. Raw Payload (No Metadata Wrapper)
+
+By default, webhook payloads include metadata and the serialized data is nested inside a `fields` key:
+
+```json
+{
+    "pk": 1,
+    "event_signal": "created",
+    "source": "auth.user",
+    "timestamp": "2026-02-05T10:30:00Z",
+    "fields": {
+        "id": 1,
+        "name": "John Doe",
+        "email": "john@example.com"
+    }
+}
+```
+
+If you prefer a raw payload containing only the serialized data (without the metadata wrapper), use the `WebhookRawPayloadMixin`:
+
+```python
+from rest_framework import serializers
+from django.contrib.auth import get_user_model
+from django_webhook_subscriber.serializers import WebhookRawPayloadMixin
+
+User = get_user_model()
+
+class UserRawWebhookSerializer(WebhookRawPayloadMixin, serializers.ModelSerializer):
+    class Meta:
+        model = User
+        fields = ["id", "name", "email"]
+
+# Update subscriber to use the raw payload serializer
+subscriber.serializer_class = "myapp.serializers.UserRawWebhookSerializer"
+subscriber.save()
+```
+
+With `WebhookRawPayloadMixin`, the webhook payload will be just the serialized data:
+
+```json
+{
+    "id": 1,
+    "name": "John Doe",
+    "email": "john@example.com"
+}
+```
+
 ## Configuration
 
 Configure the package in your Django settings:
@@ -632,6 +679,7 @@ Set up cron jobs for maintenance:
    ```
 
 3. **Monitor delivery performance:**
+
    ```bash
    # Regular performance testing
    python manage.py webhook_performance_test --model=myapp.User --event=test --object-count=10

{django_webhook_subscriber-2.0.0.dist-info → django_webhook_subscriber-2.1.0.dist-info}/RECORD

@@ -2,11 +2,11 @@ django_webhook_subscriber/__init__.py,sha256=t0izlsRXKHd46fRIwhDv8Cd59tb7MqAQ7DW
 django_webhook_subscriber/admin.py,sha256=BGFV-1-wymm_qUsOlG0HBUY3rmAqKH59PbKaFEtAEI4,30100
 django_webhook_subscriber/apps.py,sha256=U6GLuMB2xhtvUzn2IsK6rjaxN73LU3fvDoGGO1IZIr4,170
 django_webhook_subscriber/conf.py,sha256=0lFW2L_s_85UIszXnUnnMCdb0iy99WnenPWeixonf-I,1759
-django_webhook_subscriber/delivery.py,sha256=mjNtIMeVsXoVnWfEBmW8WsVDDPYfKcz8HIMkJ40PHjQ,15207
+django_webhook_subscriber/delivery.py,sha256=VQg2x9lQb49mNRKFK6-INTWaAh6O-IlLwp9nHIzv1vM,15502
 django_webhook_subscriber/http.py,sha256=0CoK1OMm7lCIJ3zzpNH3cdVuIgDnAB4KUqLRM_KRGQs,1191
 django_webhook_subscriber/managers.py,sha256=w2QZCYs858XMlcI-WSZJ0H8vN_IzpTvu5_H3bmiy7zM,2322
 django_webhook_subscriber/models.py,sha256=IdG0eBE3JPUmPLWqpR62GLtA4xVF8caIU92ourgRzVk,11528
-django_webhook_subscriber/serializers.py,sha256=9QHzlTXvk-PibMSoztaGsDoZkVhCXJkuQMDDTPCKjak,1416
+django_webhook_subscriber/serializers.py,sha256=1e1rqLLd9v3qiZwKMHJsO4TakF5FXfVc8lqk7QNt7KU,1758
 django_webhook_subscriber/tasks.py,sha256=jlE8Mdor387gcWfHlrMe8OGoegjt2xn8gsVVL8LkHDY,14269
 django_webhook_subscriber/utils.py,sha256=SdogR0VmeMMl7tgl-DD5_4yP7vt3OcgI8IpghoCIVXQ,2950
 django_webhook_subscriber/validators.py,sha256=_qlBi0rS3DaW3jKRhdpnfHzuqupqwaWtiNuZAWpIAkU,1848
@@ -24,15 +24,15 @@ django_webhook_subscriber/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeu
 django_webhook_subscriber/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 django_webhook_subscriber/tests/factories.py,sha256=z3fXJqt_3csAFrvM5qdKwzsVu0v_e72racLvMgejEKA,1277
 django_webhook_subscriber/tests/settings.py,sha256=jBy9X7QhmoQ9hnaJk4WDGWXqpRydpHlrROaXU5t7KZI,825
-django_webhook_subscriber/tests/test_delivery.py,sha256=W7JrNurpTb0TA0JDyumd6UMytaQYPJ6DohS0pDNjyJw,18380
+django_webhook_subscriber/tests/test_delivery.py,sha256=XWc7BTCXALCXn9uvqFlaQhbHlT1tyAcvQECtajeBfnY,21231
 django_webhook_subscriber/tests/test_http.py,sha256=-zBNRjpYxBDCC5NvWfdYc36aFdzCwN-1p8yuQsLGfz8,1262
 django_webhook_subscriber/tests/test_managers.py,sha256=z_c49z0UjkAnldXy-KU_XoECC66dr7orE77_xFvnM4A,3062
 django_webhook_subscriber/tests/test_models.py,sha256=RHE14IuaMtthiaRZ8g4h2EZ4VilWOrs9UrkArDbvcDg,15209
 django_webhook_subscriber/tests/test_serializers.py,sha256=UuN-cDDmsu8ZFB-aPesffT74Ck6uIuDo9ehkq8y43Mw,1831
 django_webhook_subscriber/tests/test_tasks.py,sha256=wcYlYqrRC9G3C4leEAKrt7x7D1uhlqx9mfwkfQYnb8c,20622
 django_webhook_subscriber/tests/test_utils.py,sha256=zFXDjr81wB8emeJKNjlwA8ezfJTfCMSw46-S2dB_fO0,4279
-django_webhook_subscriber-2.0.0.dist-info/licenses/LICENSE,sha256=Cqe_H97kNjzh70ZIee47TV5t0GQyath_iH2i0Yp47SU,1064
-django_webhook_subscriber-2.0.0.dist-info/METADATA,sha256=tzvYtcH4spdVL7BVftgDOBm_udSa3A3R--NFNcgdxlE,17789
-django_webhook_subscriber-2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-django_webhook_subscriber-2.0.0.dist-info/top_level.txt,sha256=t2_XjlYcTMLR9OfBGdsW0xucs3OeRWrJ7ypETMXqrvw,26
-django_webhook_subscriber-2.0.0.dist-info/RECORD,,
+django_webhook_subscriber-2.1.0.dist-info/licenses/LICENSE,sha256=Cqe_H97kNjzh70ZIee47TV5t0GQyath_iH2i0Yp47SU,1064
+django_webhook_subscriber-2.1.0.dist-info/METADATA,sha256=pAzJd6R07F-PNfZSM0HbZctK9sL1IIUafynDfVf09r4,18982
+django_webhook_subscriber-2.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+django_webhook_subscriber-2.1.0.dist-info/top_level.txt,sha256=t2_XjlYcTMLR9OfBGdsW0xucs3OeRWrJ7ypETMXqrvw,26
+django_webhook_subscriber-2.1.0.dist-info/RECORD,,

{django_webhook_subscriber-2.0.0.dist-info → django_webhook_subscriber-2.1.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any