Django веб-фреймворк: практическое руководство по созданию сайтов

Вместо функций можно использовать встроенные class-based views (CBV). Для списка - ListView, для деталей - DetailView.

from django.views.generic import ListView, DetailView
from .models import Post

class PostListView(ListView):
    model = Post
    template_name = 'blog/post_list.html'
    context_object_name = 'posts'
    queryset = Post.objects.filter(published_date__lte=timezone.now()).order_by('-published_date')

class PostDetailView(DetailView):
    model = Post
    template_name = 'blog/post_detail.html'
  

Python manage py runserver (запуск сервера разработки django через manage.py runserver)

Маршруты обновляются:

from django.urls import path
from .views import PostListView, PostDetailView

urlpatterns = [
    path('', PostListView.as_view(), name='post_list'),
    path('post/<int:pk>/', PostDetailView.as_view(), name='post_detail'),
]
  

Для построения API используется Django REST Framework. Установка: pip install djangorestframework. Затем создаются сериализаторы и viewsets.

# serializers.py
from rest_framework import serializers
from .models import Post

class PostSerializer(serializers.ModelSerializer):
    class Meta:
        model = Post
        fields = ['id', 'title', 'content', 'published_date']
  

# views.py (rest)
from rest_framework import viewsets
from .models import Post
from .serializers import PostSerializer

class PostViewSet(viewsets.ModelViewSet):
    queryset = Post.objects.all()
    serializer_class = PostSerializer
  

Маршруты подключаются через DefaultRouter:

# urls.py (основной)
from rest_framework.routers import DefaultRouter
from blog.views import PostViewSet

router = DefaultRouter()
router.register(r'posts', PostViewSet)

urlpatterns += router.urls
  

После запуска сервера API доступно по адресам /posts/ (GET, POST) и /posts/{id}/ (GET, PUT, DELETE).

Кастомный менеджер модели позволяет инкапсулировать запросы. Например, чтобы получать только опубликованные посты.

from django.db import models
from django.utils import timezone

class PublishedManager(models.Manager):
    def get_queryset(self):
        return super().get_queryset().filter(published_date__lte=timezone.now())

class Post(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    published_date = models.DateTimeField(default=timezone.now)
    
    objects = models.Manager()  # стандартный
    published = PublishedManager()  # кастомный
  

Теперь Post.published.all() возвращает только опубликованные посты. Это упрощает представления и повышает читаемость.