Расширенные примеры кода и команд

1. Использование Generic Class-Based Views с дополнительными контекстными данными

Пример добавления дополнительных данных в шаблон через переопределение get_context_data:

from django.views.generic import ListView
from .models import Article, Category

class ArticleListView(ListView):
    model = Article
    template_name = 'myapp/article_list.html'
    context_object_name = 'articles'
    paginate_by = 10

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        context['categories'] = Category.objects.all()
        context['current_category'] = self.request.GET.get('category', 'all')
        return context

В шаблоне можно использовать {{ categories }} и {{ current_category }}. Результат – список статей с пагинацией и боковой панелью категорий.

2. Форма с валидацией и сохранением данных (ModelForm)

# myapp/forms.py
from django import forms
from .models import Article

class ArticleForm(forms.ModelForm):
    class Meta:
        model = Article
        fields = ['title', 'content']
        widgets = {
            'title': forms.TextInput(attrs={'class': 'form-control'}),
            'content': forms.Textarea(attrs={'class': 'form-control', 'rows': 5}),
        }

Представление для создания статьи:

from django.shortcuts import render, redirect
from .forms import ArticleForm

def create_article(request):
    if request.method == 'POST':
        form = ArticleForm(request.POST)
        if form.is_valid():
            article = form.save()
            return redirect('article_detail', pk=article.pk)
    else:
        form = ArticleForm()
    return render(request, 'myapp/article_form.html', {'form': form})

Шаблон article_form.html:

  {% csrf_token %}
  {{ form.as_p }}
  Сохранить

Результат: после отправки формы создаётся запись в базе и происходит перенаправление.

3. Кастомная команда управления (management command)

Создаём задачу импорта статей из CSV. Структура: myapp/management/commands/import_articles.py:

import csv
from django.core.management.base import BaseCommand
from myapp.models import Article

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

    def add_arguments(self, parser):
        parser.add_argument('file_path', type=str)

    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:
                Article.objects.create(
                    title=row['title'],
                    content=row['content']
                )
        self.stdout.write(self.style.SUCCESS('Импорт завершён'))

Запуск команды:

python manage.py import_articles data/articles.csv

Результат: в консоли увидим сообщение об успешном импорте.

4. Асинхронная отправка письма с вложением через Celery

# myapp/tasks.py
from celery import shared_task
from django.core.mail import EmailMessage
from django.contrib.auth.models import User

@shared_task
def send_file_mail(user_id, file_path):
    user = User.objects.get(id=user_id)
    email = EmailMessage(
        subject='Ваш отчёт',
        body='Во вложении находится сгенерированный документ.',
        from_email='noreply@example.com',
        to=[user.email],
    )
    with open(file_path, 'rb') as f:
        email.attach('report.pdf', f.read(), 'application/pdf')
    email.send()
    return f'Email sent to {user.email}'

Вызов из представления:

send_file_mail.delay(request.user.id, '/tmp/report.pdf')

Worker выведет лог об отправке.

5. Работа с загрузкой файлов (изображения)

Модель:

class Article(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    image = models.ImageField(upload_to='articles/', blank=True, null=True)

Настройка в settings.py:

MEDIA_URL = '/media/'
MEDIA_ROOT = BASE_DIR / 'media'

В корневом urls.py для разработки:

from django.conf import settings
from django.conf.urls.static import static

urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

Форма с файлом:

class ArticleForm(forms.ModelForm):
    class Meta:
        model = Article
        fields = ['title', 'content', 'image']

В шаблоне enctype="multipart/form-data":

  {% csrf_token %}
  {{ form.as_p }}
  Сохранить

Результат: загруженные изображения будут доступны через /media/articles/имя_файла.

6. Кастомизация панели администратора с использованием ModelAdmin

class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title', 'pub_date', 'is_published')
    list_filter = ('pub_date', 'is_published')
    search_fields = ('title', 'content')
    date_hierarchy = 'pub_date'
    ordering = ('-pub_date',)
    actions = ['make_published']

    def make_published(self, request, queryset):
        queryset.update(is_published=True)
    make_published.short_description = 'Опубликовать выбранные статьи'

Результат: в админке появится кнопка массовой публикации и удобные фильтры.