django-drf · gentleman-programming — скилл для Claude Code: API и установка
Скилл django-drf помогает проектировать REST API на Django: ViewSet, сериализаторы, фильтры и тесты. Пригодится при сборке нового API.
Apache-2.0 162 установок ★ 678 обновлён 2026-03-28
npx skills add Gentleman-Programming/Gentleman-Skills --skill django-drf -a claude-codeЧто делает django-drf
Скилл задаёт шаблоны для Django REST Framework. Он показывает ModelViewSet с разными сериализаторами для создания, обновления и чтения, дополнительным действием activate, разрешениями и фильтрацией через UserFilter.
Внутри есть примеры сериализаторов для чтения, создания и обновления пользователей, пагинации, маршрутизации через DefaultRouter и настроек REST_FRAMEWORK. Также разобраны проверки владельца объекта и доступ администратора к операциям записи.
Отдельный раздел посвящён тестам с pytest, APIClient и force_authenticate, а также базовым командам manage.py. Фильтрация в примере использует django_filters, поэтому без этой библиотеки UserFilter не заработает.
Какие задачи решает
- спроектировать ViewSet для REST API
- разделить сериализаторы чтения, создания и обновления
- добавить фильтры по email, статусу и датам
- настроить пагинацию и маршруты API
- проверить эндпоинты через APIClient
Примеры запросов агенту
- Собери
UserViewSetдля REST API с отдельными сериализаторами создания и обновления. - Добавь
UserFilterс поиском по email,is_activeи диапазономcreated_at. - Напиши тесты
pytestдля списка и создания пользователей черезAPIClient.
Как установить django-drf
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill django-drf -a claude-code2Вручную: положить файлы
~/.claude/skills/django-drf/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/django-drf/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill django-drf -a codex2Вручную: положить файлы
.agents/skills/django-drf/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill django-drf -a cursor2Вручную: положить файлы
.cursor/skills/django-drf/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Gentleman-Programming/Gentleman-Skills curated/django-drf/SKILL.md2Вручную: положить файлы
.github/skills/django-drf/SKILL.md1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill django-drf -a gemini-cli2Командой платформы
gemini skills install https://github.com/Gentleman-Programming/Gentleman-Skills --path curated/django-drfВручную: положить файлы
.devin/skills/django-drf/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill django-drf -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о django-drf
Как установить django-drf в Claude Code?
Выполните npx skills add Gentleman-Programming/Gentleman-Skills --skill django-drf -a claude-code, затем проверьте файл ~/.claude/skills/django-drf/SKILL.md.
Что делает django-drf?
Скилл даёт паттерны для REST API на Django REST Framework: ViewSet, сериализаторы, фильтры, разрешения, пагинацию, маршрутизацию и тесты.
Какие темы по тестированию есть в django-drf?
Примеры используют pytest, APIClient, фикстуры для аутентифицированного клиента и проверки ответов для списка и создания пользователей.
Исходный текст
SKILL.md · Apache-2.0
---
name: django-drf
description: >
Django REST Framework patterns.
Trigger: When building REST APIs with Django - ViewSets, Serializers, Filters.
license: Apache-2.0
metadata:
author: gentleman-programming
version: "1.0"
---
## ViewSet Pattern
```python
from rest_framework import viewsets, status
from rest_framework.response import Response
from rest_framework.decorators import action
class UserViewSet(viewsets.ModelViewSet):
queryset = User.objects.all()
serializer_class = UserSerializer
filterset_class = UserFilter
permission_classes = [IsAuthenticated]
def get_serializer_class(self):
if self.action == "create":
return UserCreateSerializer
if self.action in ["update", "partial_update"]:
return UserUpdateSerializer
return UserSerializer
@action(detail=True, methods=["post"])
def activate(self, request, pk=None):
user = self.get_object()
user.is_active = True
user.save()
return Response({"status": "activated"})
```
## Serializer Patterns
```python
from rest_framework import serializers
# Read Serializer
class UserSerializer(serializers.ModelSerializer):
full_name = serializers.SerializerMethodField()
class Meta:
model = User
fields = ["id", "email", "full_name", "created_at"]
read_only_fields = ["id", "created_at"]
def get_full_name(self, obj):
return f"{obj.first_name} {obj.last_name}"
# Create Serializer
class UserCreateSerializer(serializers.ModelSerializer):
password = serializers.CharField(write_only=True)
class Meta:
model = User
fields = ["email", "password", "first_name", "last_name"]
def create(self, validated_data):
password = validated_data.pop("password")
user = User(**validated_data)
user.set_password(password)
user.save()
return user
# Update Serializer
class UserUpdateSerializer(serializers.ModelSerializer):
class Meta:
model = User
fields = ["first_name", "last_name"]
```
## Filters
```python
from django_filters import rest_framework as filters
class UserFilter(filters.FilterSet):
email = filters.CharFilter(lookup_expr="icontains")
is_active = filters.BooleanFilter()
created_after = filters.DateTimeFilter(
field_name="created_at",
lookup_expr="gte"
)
created_before = filters.DateTimeFilter(
field_name="created_at",
lookup_expr="lte"
)
class Meta:
model = User
fields = ["email", "is_active"]
```
## Permissions
```python
from rest_framework.permissions import BasePermission
class IsOwner(BasePermission):
def has_object_permission(self, request, view, obj):
return obj.owner == request.user
class IsAdminOrReadOnly(BasePermission):
def has_permission(self, request, view):
if request.method in ["GET", "HEAD", "OPTIONS"]:
return True
return request.user.is_staff
```
## Pagination
```python
from rest_framework.pagination import PageNumberPagination
class StandardPagination(PageNumberPagination):
page_size = 20
page_size_query_param = "page_size"
max_page_size = 100
# settings.py
REST_FRAMEWORK = {
"DEFAULT_PAGINATION_CLASS": "api.pagination.StandardPagination",
}
```
## URL Routing
```python
from rest_framework.routers import DefaultRouter
router = DefaultRouter()
router.register(r"users", UserViewSet, basename="user")
router.register(r"posts", PostViewSet, basename="post")
urlpatterns = [
path("api/v1/", include(router.urls)),
]
```
## Testing
```python
import pytest
from rest_framework import status
from rest_framework.test import APIClient
@pytest.fixture
def api_client():
return APIClient()
@pytest.fixture
def authenticated_client(api_client, user):
api_client.force_authenticate(user=user)
return api_client
@pytest.mark.django_db
class TestUserViewSet:
def test_list_users(self, authenticated_client):
response = authenticated_client.get("/api/v1/users/")
assert response.status_code == status.HTTP_200_OK
def test_create_user(self, authenticated_client):
data = {"email": "[email protected]", "password": "pass123"}
response = authenticated_client.post("/api/v1/users/", data)
assert response.status_code == status.HTTP_201_CREATED
```
## Commands
```bash
python manage.py runserver
python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py shell
```
## Keywords
django, drf, rest framework, viewset, serializer, api, rest api
© gentleman-programming · Apache-2.0 · Gentleman-Programming/Gentleman-Skills
Похожие скиллы
Все скиллы по теме «Бэкенд и API» →Сначала — django-drf от других авторов.