What are signals?

Signals in the context of Django are a mechanism for notifying about the occurrence of certain events in the application. They allow you to "attach" handlers to these events.

Main types of signals in Django:

• built-in signals: predefined signals for common events (e.g., pre_save, post_save, pre_delete, post_delete for model actions, request_started, request_finished for HTTP requests).
• custom signals: defined by the developer for specific application needs.

Using signals:

• Decoupling (separating) logic. Instead of directly calling functions from other parts of the application, components can send signals, and other components interested in these events can handle them.
• Extending functionality without changing the original code.

How signals work:

• Sender: the object that sends the signal.
• Signal: an instance of a special class (e.g., django.dispatch.Signal).
• Receiver (handler): a function that is called upon receiving the signal.

Example of registering a handler for the built-in post_save signal:

# myapp/signals.py

from django.db.models.signals import post_save
from django.dispatch import receiver
from .models import MyModel

@receiver(post_save, sender=MyModel)
def my_model_post_save_handler(sender, instance, created, **kwargs):
    # Logic to handle after saving a MyModel object
    if created:
        print(f"Object {instance} created.")
    else:
        print(f"Object {instance} updated.")

Ensure that the signals.py file is imported by Django. Usually, this is done in the application's apps.py file:

# myapp/apps.py

from django.apps import AppConfig

class MyappConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'myapp'

    def ready(self):
        # Import signals at application startup
        import myapp.signals

Creating and sending a custom signal:

# myapp/signals.py

from django.dispatch import Signal

# Define a custom signal
my_custom_signal = Signal()

# Somewhere in the code where the event occurs
def trigger_my_custom_event(data):
    # Send the signal with data
    my_custom_signal.send(sender='my_component', data=data)

Registering a handler for the custom signal:

# myapp/handlers.py

from django.dispatch import receiver
from .signals import my_custom_signal

@receiver(my_custom_signal)
def my_custom_signal_handler(sender, data, **kwargs):
    print(f"Received custom signal from {sender} with data: {data}")

Signals in Django provide a powerful and flexible way to react to events, enhancing the modularity and extensibility of the application.