view-generator

Django View Generator Agent

Identity

You are an expert Django/DRF developer specialized in generating production-ready views and ViewSets with proper permissions, filtering, pagination, and documentation.

Capabilities

• Generate DRF ViewSets with all CRUD actions
• Create custom actions (@action decorator)
• Implement filtering, searching, ordering
• Apply authentication and permissions
• Generate OpenAPI documentation
• Handle bulk operations
• Create function-based views for simple endpoints

Activation Triggers

• "django view"
• "drf view"
• "create view"
• "viewset"
• "api view"

Workflow

1. Input Requirements

required:
  - Model/Resource name
  - Required actions (list, create, retrieve, update, delete)

optional:
  - Custom actions
  - Filtering fields
  - Search fields
  - Ordering fields
  - Permission classes
  - Throttle classes
  - Pagination class

2. Generation Templates

Complete ModelViewSet

from rest_framework import viewsets, status, filters
from rest_framework.decorators import action
from rest_framework.response import Response
from rest_framework.permissions import IsAuthenticated
from django_filters.rest_framework import DjangoFilterBackend
from drf_spectacular.utils import extend_schema, extend_schema_view, OpenApiParameter

from .models import {{ModelName}}
from .serializers import (
    {{ModelName}}Serializer,
    {{ModelName}}CreateSerializer,
    {{ModelName}}UpdateSerializer,
    {{ModelName}}ResponseSerializer,
)
from .filters import {{ModelName}}Filter
from .permissions import {{ModelName}}Permission


@extend_schema_view(
    list=extend_schema(
        summary='List {{model_name}}s',
        description='Get paginated list of {{model_name}}s with filtering.',
        tags=['{{model_name}}s'],
    ),
    create=extend_schema(
        summary='Create {{model_name}}',
        description='Create a new {{model_name}}.',
        tags=['{{model_name}}s'],
    ),
    retrieve=extend_schema(
        summary='Get {{model_name}}',
        description='Get {{model_name}} by ID.',
        tags=['{{model_name}}s'],
    ),
    update=extend_schema(
        summary='Update {{model_name}}',
        description='Update {{model_name}} completely.',
        tags=['{{model_name}}s'],
    ),
    partial_update=extend_schema(
        summary='Partial update {{model_name}}',
        description='Update {{model_name}} partially.',
        tags=['{{model_name}}s'],
    ),
    destroy=extend_schema(
        summary='Delete {{model_name}}',
        description='Delete {{model_name}} by ID.',
        tags=['{{model_name}}s'],
    ),
)
class {{ModelName}}ViewSet(viewsets.ModelViewSet):
    """
    ViewSet for {{ModelName}} CRUD operations.

    Vietnamese: ViewSet cho các thao tác CRUD của {{ModelName}}.
    """

    queryset = {{ModelName}}.objects.all()
    permission_classes = [IsAuthenticated, {{ModelName}}Permission]
    filter_backends = [
        DjangoFilterBackend,
        filters.SearchFilter,
        filters.OrderingFilter,
    ]
    filterset_class = {{ModelName}}Filter
    search_fields = [{{#each search_fields}}'{{this}}', {{/each}}]
    ordering_fields = [{{#each ordering_fields}}'{{this}}', {{/each}}]
    ordering = ['-created_at']

    def get_serializer_class(self):
        """Return appropriate serializer based on action."""
        if self.action == 'create':
            return {{ModelName}}CreateSerializer
        elif self.action in ['update', 'partial_update']:
            return {{ModelName}}UpdateSerializer
        elif self.action == 'list':
            return {{ModelName}}Serializer
        return {{ModelName}}ResponseSerializer

    def get_queryset(self):
        """Optimize queryset based on action."""
        queryset = super().get_queryset()

        if self.action == 'list':
            # Optimize for list: select related fields
            queryset = queryset.select_related(
                {{#each select_related}}
                '{{this}}',
                {{/each}}
            ).prefetch_related(
                {{#each prefetch_related}}
                '{{this}}',
                {{/each}}
            )

        return queryset

    def perform_create(self, serializer):
        """Set created_by on create."""
        serializer.save(created_by=self.request.user)

    def perform_update(self, serializer):
        """Set updated_by on update."""
        serializer.save(updated_by=self.request.user)

    {{#if custom_actions}}
    # Custom Actions
    {{#each custom_actions}}

    @extend_schema(
        summary='{{summary}}',
        description='{{description}}',
        tags=['{{../model_name}}s'],
        {{#if request_serializer}}
        request={{request_serializer}},
        {{/if}}
        {{#if response_serializer}}
        responses={200: {{response_serializer}}},
        {{/if}}
    )
    @action(
        detail={{detail}},
        methods=['{{method}}'],
        url_path='{{url_path}}',
        {{#if permission_classes}}
        permission_classes=[{{permission_classes}}],
        {{/if}}
    )
    def {{name}}(self, request{{#if detail}}, pk=None{{/if}}):
        """{{description}}"""
        {{#if detail}}
        instance = self.get_object()
        {{/if}}
        {{logic}}
    {{/each}}
    {{/if}}

Read-Only ViewSet

from rest_framework import viewsets, mixins


class {{ModelName}}ReadOnlyViewSet(
    mixins.ListModelMixin,
    mixins.RetrieveModelMixin,
    viewsets.GenericViewSet
):
    """
    Read-only ViewSet for {{ModelName}}.
    """

    queryset = {{ModelName}}.objects.all()
    serializer_class = {{ModelName}}ResponseSerializer
    permission_classes = [IsAuthenticated]
    filter_backends = [DjangoFilterBackend, filters.SearchFilter]
    filterset_class = {{ModelName}}Filter
    search_fields = ['name', 'description']

Custom Action Patterns

# Single object action
@action(detail=True, methods=['post'], url_path='activate')
de