Why signals enable decoupled communication in Django - See It in Action

Why signals enable decoupled communication

📖 Scenario: You are building a Django app where different parts need to react when a user registers. Instead of tightly linking code, you want a clean way to notify other parts without direct calls.

🎯 Goal: Create a Django signal setup that sends a notification when a new user is created, demonstrating how signals allow decoupled communication between app components.

📋 What You'll Learn

Create a Django model called CustomUser with a username field

Define a signal receiver function called welcome_email that listens to post_save of CustomUser

Connect the welcome_email function to the post_save signal for CustomUser

In the receiver, check if the user instance was just created and simulate sending a welcome email

💡 Why This Matters

🌍 Real World

In real Django projects, signals help different app parts respond to events like user creation, order placement, or data updates without tightly coupling code.

💼 Career

Understanding Django signals is valuable for backend developers to write clean, maintainable, and scalable web applications.

1

DATA SETUP: Create the CustomUser model

Create a Django model called CustomUser with a single field username as a CharField with max length 100.

Django

# Define the CustomUser model with a username field
# Your code here

Need a hint?

Use models.CharField(max_length=100) for the username field inside the model class.

2

CONFIGURATION: Import post_save signal and receiver decorator

Import post_save from django.db.models.signals and receiver from django.dispatch.

Django

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

class CustomUser(models.Model):
    username = models.CharField(max_length=100)

# Your code here

Need a hint?

Import post_save and receiver to prepare for signal handling.

3

CORE LOGIC: Define the signal receiver function

Define a function called welcome_email decorated with @receiver(post_save, sender=CustomUser). Inside, check if created is True and simulate sending a welcome email by assigning message = f"Welcome {instance.username}!".

Django

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

class CustomUser(models.Model):
    username = models.CharField(max_length=100)

# Define the welcome_email receiver function here
# Your code here

Need a hint?

Use the @receiver decorator with post_save and sender=CustomUser. Check the created flag inside the function.

4

COMPLETION: Connect the signal and finalize

Ensure the welcome_email function is connected to the post_save signal for CustomUser using the @receiver decorator as done. This completes the decoupled communication setup.

Django

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

class CustomUser(models.Model):
    username = models.CharField(max_length=100)

@receiver(post_save, sender=CustomUser)
def welcome_email(sender, instance, created, **kwargs):
    if created:
        message = f"Welcome {instance.username}!"

# Finalize the signal connection
# Your code here

Need a hint?

The @receiver decorator already connects the function to the signal. No extra code needed here.