Построение backend на Django: от проекта до развёртывания

Расширенные примеры кода для Django backend

1. Кастомная валидация сериализатора DRF

Пример проверки уникальности пары полей на уровне сериализатора.

from rest_framework import serializers
from .models import Book

class BookSerializer(serializers.ModelSerializer):
    class Meta:
        model = Book
        fields = ['title', 'author', 'published_date']

    def validate(self, data):
        # Проверка, что книга с таким названием и автором уже существует
        if Book.objects.filter(title=data['title'], author=data['author']).exists():
            raise serializers.ValidationError("Книга с таким названием и автором уже существует.")
        return data

# Пример запроса POST /api/books/
{
  "title": "Война и мир",
  "author": "Лев Толстой",
  "published_date": "1869-01-01"
}
# Ответ 400
{
  "non_field_errors": ["Книга с таким названием и автором уже существует."]
}

2. Аутентификация через JWT с помощью djangorestframework-simplejwt

Настройка получения и обновления токенов.

# Установка
pip install djangorestframework-simplejwt

# settings.py
REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': (
        'rest_framework_simplejwt.authentication.JWTAuthentication',
    )
}

from datetime import timedelta
SIMPLE_JWT = {
    'ACCESS_TOKEN_LIFETIME': timedelta(minutes=5),
    'REFRESH_TOKEN_LIFETIME': timedelta(days=1),
}

# urls.py
from rest_framework_simplejwt.views import TokenObtainPairView, TokenRefreshView

urlpatterns = [
    path('api/token/', TokenObtainPairView.as_view(), name='token_obtain_pair'),
    path('api/token/refresh/', TokenRefreshView.as_view(), name='token_refresh'),
]

# POST /api/token/ с данными {"username": "admin", "password": "123"}
{
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "access": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

3. Использование сигналов для обновления статистики

Автоматическое обновление количества книг у автора при сохранении новой книги.

# models.py
from django.db import models
from django.dispatch import receiver
from django.db.models.signals import post_save, post_delete

class Author(models.Model):
    name = models.CharField(max_length=100)
    book_count = models.IntegerField(default=0)

class Book(models.Model):
    title = models.CharField(max_length=200)
    author = models.ForeignKey(Author, on_delete=models.CASCADE, related_name='books')

@receiver(post_save, sender=Book)
def update_book_count_on_save(sender, instance, **kwargs):
    instance.author.book_count = instance.author.books.count()
    instance.author.save()

@receiver(post_delete, sender=Book)
def update_book_count_on_delete(sender, instance, **kwargs):
    instance.author.book_count = instance.author.books.count()
    instance.author.save()

# После создания книги для автора, поле book_count автоматически увеличится на 1

4. Кастомная команда управления для импорта данных из CSV

Пример команды, которая загружает книги из CSV-файла в базу.

# management/commands/import_books.py
from django.core.management.base import BaseCommand
from myapp.models import Book
import csv

class Command(BaseCommand):
    help = 'Импортирует книги из CSV файла'

    def add_arguments(self, parser):
        parser.add_argument('file_path', type=str, help='Путь к CSV файлу')

    def handle(self, *args, **options):
        file_path = options['file_path']
        with open(file_path, newline='', encoding='utf-8') as csvfile:
            reader = csv.DictReader(csvfile)
            for row in reader:
                Book.objects.create(
                    title=row['title'],
                    author=row['author'],
                    published_date=row['published_date']
                )
        self.stdout.write(self.style.SUCCESS('Книги успешно импортированы'))

# Вызов команды
python manage.py import_books books.csv
# Вывод: Книги успешно импортированы

5. Тестирование API с помощью pytest-django

Пример теста для эндпоинта книг.

# tests.py
import pytest
from rest_framework.test import APIClient
from myapp.models import Book

@pytest.mark.django_db
def test_get_books():
    Book.objects.create(title='Test', author='Author', published_date='2024-01-01')
    client = APIClient()
    response = client.get('/api/books/')
    assert response.status_code == 200
    assert len(response.data) == 1
    assert response.data[0]['title'] == 'Test'

# Запуск тестов
pytest -v
# Вывод: test_get_books PASSED