In this lesson, we will enhance our To-Do API by adding filtering capabilities. Filtering is vital for any API as it allows users to retrieve specific subsets of data based on criteria like completion status or priority. Imagine you have a large list of tasks and you want to see only the completed ones or those with a specific priority. That's where filtering comes into play.

Let's dive into the process of incorporating filtering into our Django application, making our To-Do API more powerful and user-friendly.

Before we jump into adding filtering, let's briefly recap the essential components of our project setup. This will help you follow along better. First of all, we have a model and a serializer for it. This time, we will use a bit extended version of our Todo model which includes the priority field.

Next, we have a set of implemented CRUD operations with Django generics:

This code outlines the core components we built for our basic To-Do API. Next, we'll enhance it with filtering capabilities.

To add filtering to our Todo API, we'll follow these steps:

1. Install Django Filter: First, we need to install the django-filter library. If you're working on CodeSignal, this library is pre-installed, but for your local setup, you can install it using:

2. Update Project Settings: Now, let's update our Django settings to enable filtering:

   This tells Django to use the DjangoFilterBackend for filtering. In most of the tasks, you will have this pre-defined.

Let's add filtering to our TodoListCreate view. With django-filters, it is easy and straightforward: you just need to add two new fields to your view: filter_backends and filterset_fields.

• filter_backends: This attribute in the view is used to specify one or more backends that the view should use for filtering. By adding DjangoFilterBackend, we enable the use of django-filters.
• filterset_fields: This attribute is a list of model fields that we allow users to filter by. For each field specified, users can filter the queryset using query parameters in the URL.

The updated view will look like this:

Here, we import DjangoFilterBackend and specify filterset_fields to enable filtering by the completed field.

Now let's test our single-field filters using send_request.py:

• The requests.get method is used to make a GET request to an endpoint. We can pass query parameters using the params argument, which takes a dictionary. Each key of the dictionary is a model's field, and each value is the value that we want to filter with.
• The query parameters are appended to the URL in the format ?key=value. For example, if we set params={'completed': True}, the final URL will be http://0.0.0.0:3000/api/todos/?completed=True.
• django-filters automatically handle returning only instances that satisfy the provided query parameters.

To filter tasks by multiple fields, such as those that are completed and have a priority of 2, you can update filterset_fields to include more fields. Here is an example of an updated TodoListCreate view:

This code allows users to filter tasks by both completed status and priority.

Let's extend the testing to include multiple-field filters:

In this case, we include two fields into our params dictionary to filter using both. The resulting request will be http://0.0.0.0:3000/api/todos/?completed=True&priority=2. django-filters will handle two parameters concatenated with & in the query.

These examples show how the filtering works with your API endpoints.

In this lesson, we covered:

• How do you install and configure Django Filter?
• Adding single-field and multi-field filters to your To-Do API.
• Testing the filters to ensure they work correctly.

Now, it's time for you to practice these concepts. In the upcoming exercises, you'll solidify your filtering understanding by applying these techniques in different scenarios. Experiment with various filter combinations to become more comfortable with this powerful feature.

By enhancing your To-Do API with filtering capabilities, you've taken a significant step towards making your application more efficient and user-friendly. Congratulations on reaching this milestone!