Easy sending of notifications using signals

notifications/__init__.py

+default_app_config = 'notifications.apps.Config'

notifications/apps.py

@@ -3,3 +3,8 @@ from django.apps import AppConfig
 
 class NotificationsConfig(AppConfig):
     name = 'notifications'
+
+    def ready(self):
+        super().ready()
+        import notifications.signals
+        notifications.notify = notifications.signals.notify

notifications/signals.py

+from django.dispatch import Signal
+
+notify = Signal(providing_args=[
+    'recipient', 'actor', 'verb', 'action_object', 'target', 'description',
+    'timestamp', 'level'
+])
+
+
+# Basic working method to send a notification to a user using signals:
+#   ---
+#     from notifications.signals import notify
+#     notify.send(user, recipient=user, verb='you reached level 10')
+#   ---