✨ Add Advanced Filtering and Search to Task API

[mohammad-hussein-dev]

🚀 Task: Add Advanced Filtering and Search to Task API

📌 Goal

Enhance the Task API to support advanced filtering (by status, priority, category, date) and search (by title and description) using django-filter.

---

🧩 Why This Matters

• Makes the API more powerful and user-friendly.
• Reduces frontend processing by moving filtering logic to the backend.
• Follows REST API best practices.

---

🧩 Subtasks

• Add django-filter to requirements.txt
• Create api/filters.py with TaskFilter class
• Integrate filter into TaskListView (using FilterSet)
• Add search functionality using SearchFilter (search in title and description)
• Add ordering support (by created_at, deadline, priority)
• Write unit tests for all filtering, search, and ordering scenarios
• Update API documentation in README (or Swagger)

---

✅ Acceptance Criteria

• API supports filtering by status, priority, category, created_at, deadline
• API supports search by title and description
• API supports ordering by created_at, deadline, priority
• All new features are covered by unit tests
• API documentation is updated
• No existing functionality is broken

---

🧪 Testing Checklist

• Test filtering by status (exact match)
• Test filtering by priority (numeric)
• Test filtering by category (case-insensitive)
• Test filtering by created_at (date range)
• Test filtering by deadline (date range)
• Test search by title (partial match)
• Test search by description (partial match)
• Test ordering by created_at
• Test ordering by deadline
• Test ordering by priority
• Test combined filters (status + priority + search)
• Test empty results (no matching tasks)

---

📚 Resources

• django-filter Docs
• DRF Filtering Guide
• DRF SearchFilter

---

✅ Example Implementation (for reference)

# api/filters.py
import django_filters
from tasks.models import Task

class TaskFilter(django_filters.FilterSet):
    status = django_filters.CharFilter(lookup_expr='iexact')
    priority = django_filters.NumberFilter()
    category = django_filters.CharFilter(field_name='category__name', lookup_expr='iexact')
    created_at = django_filters.DateFromToRangeFilter()
    deadline = django_filters.DateFromToRangeFilter()

    class Meta:
        model = Task
        fields = ['status', 'priority', 'category', 'created_at', 'deadline']

# api/views.py
from django_filters.rest_framework import DjangoFilterBackend
from rest_framework.filters import SearchFilter, OrderingFilter

class TaskListView(generics.ListCreateAPIView):
    queryset = Task.objects.all()
    serializer_class = TaskSerializer
    filter_backends = [DjangoFilterBackend, SearchFilter, OrderingFilter]
    filterset_class = TaskFilter
    search_fields = ['title', 'description']
    ordering_fields = ['created_at', 'deadline', 'priority']

---

🗓️ Deadline

No rush — take your time and focus on quality.

💬 Questions?

Feel free to ask anytime. I'm here to help.

---

🏷️ Labels

good first issue, enhancement, help wanted

[SAKTHIMARAN-VENOM]

hi, I would like to work on this issue. @mohammad-hussein-dev

[mohammad-hussein-dev]

hey @SAKTHIMARAN-VENOM apologies for the delayed response and thank you for your interest in contributing to this project

absolutely you are more than welcome to take this on its a brilliant enhancement that will make the task api significantly more powerful and user friendly

to summarise what this issue involves we need to add advanced filtering capabilities using django filter for status priority category and date ranges alongside search functionality for title and description fields and ordering support for created_at deadline and priority fields the goal is to move all this logic to the backend so the frontend doesnt have to process large datasets

the example implementation in the issue description should give you a solid starting point and the acceptance criteria outline exactly what needs to be covered including comprehensive unit tests

feel free to ask any questions along the way im here to help and looking forward to seeing your pull request

brilliant to have you on board