Welcome to the section on deleting records by ID using Django ORM. In our previous lessons, we learned to retrieve and update records from the database. Now, we'll focus on how to delete specific records. This is vital for applications where data cleanup is essential, such as task management systems and user databases.

In this lesson, you'll learn how to delete a record from the database using its ID. This allows you to remove specific items, whether they are old tasks, outdated user profiles, or any other data that needs to be cleaned up.

We will continue to use the Todo model from our previous lessons:

Python
Copy to clipboard
1from django.db import models
2
3class Todo(models.Model):
4    task = models.CharField(max_length=200)
5    completed = models.BooleanField(default=False)
6
7    def __str__(self):
8        return self.task

To delete a Todo item by its ID, we'll add a new view function in views.py. This function will handle DELETE requests to remove the Todo object:

Python
Copy to clipboard
1from django.http import JsonResponse
2from django.views.decorators.csrf import csrf_exempt
3from django.shortcuts import get_object_or_404
4from .models import Todo
5
6@csrf_exempt
7def delete_todo(request, id):
8    if request.method == 'DELETE':
9        try:
10            todo = get_object_or_404(Todo, id=id) # Alternative: Todo.objects.get(id=id)
11            todo.delete()
12            return JsonResponse({'message': 'Todo deleted'})
13        except:
14            return JsonResponse({'message': 'Todo not found'}, status=404)
15    return JsonResponse({'message': 'Invalid request'}, status=400)

This function retrieves the Todo object by its ID, deletes it from the database, and returns a JSON response confirming the deletion. If the Todo object is not found, it returns an appropriate error message. Note, we use the get_object_or_404 shortcut to retrieve the object by its ID. Alternatively, you can use Todo.objects.get(id=id) to achieve the same result.

Understanding how to delete records is a fundamental part of web development. Here are some practical scenarios where this knowledge is indispensable:

• Task Management: In a to-do list application, users should be able to delete tasks that are no longer relevant.
• User Management: In user management systems, administrators may need to delete user accounts that are inactive or violate terms of service.
• Data Cleanup: Applications often need to periodically remove old or unnecessary data to optimize performance and storage.

By mastering the skill of deleting records, you ensure that your application remains efficient and user-friendly. Users expect the ability to manage their data seamlessly, and your capabilities will help you deliver that experience.

Excited to put this into practice? Let's move to the practice section where you can apply what you've learned and fine-tune your skills. Happy coding!