Примечания к выпуску Django 5.2¶

Автоматический импорт моделей в shell¶

Автоматический импорт моделей в <<<0>> --verbosity >

$ python -Wall manage.py shell --verbosity=2
6 objects imported automatically, including:

  from django.contrib.admin.models import LogEntry
  from django.contrib.auth.models import Group, Permission, User
  from django.contrib.contenttypes.models import ContentType
  from django.contrib.sessions.models import Session

...\> py -Wall manage.py shell --verbosity=2
6 objects imported automatically, including:

  from django.contrib.admin.models import LogEntry
  from django.contrib.auth.models import Group, Permission, User
  from django.contrib.contenttypes.models import ContentType
  from django.contrib.sessions.models import Session

Это behavior can be customized для добавления или удаления автоматического импорта.

Составной первичный источник¶

:class:`django.db.models.CompositePrimaryKey`Составной первичный источник

pk``Составной ``CompositePrimaryKey первичный источник

from django.db import models


class Release(models.Model):
    pk = models.CompositePrimaryKey("version", "name")
    version = models.IntegerField()
    name = models.CharField(max_length=20)

:doc:`/topics/composite-primary-key`Составной первичный источник

:class:`~django.forms.BoundField`Составной первичный источник¶

До версии 5.2 переопределение Field.get_bound_field() было единственной возможностью использовать пользовательский BoundField. Django теперь поддерживает указание следующих атрибутов для настройки отображения формы:

• BaseRenderer.bound_field_class на уровне проекта,
• Form.bound_field_class на уровне формы, и
• Field.bound_field_class на полевом уровне.

Например, для настройки BoundField класса Form:

from django import forms


class CustomBoundField(forms.BoundField):

    custom_class = "custom"

    def css_classes(self, extra_classes=None):
        result = super().css_classes(extra_classes)
        if self.custom_class not in result:
            result += f" {self.custom_class}"
        return result.strip()


class CustomForm(forms.Form):
    bound_field_class = CustomBoundField

    name = forms.CharField(
        label="Your Name",
        max_length=100,
        required=False,
        widget=forms.TextInput(attrs={"class": "name-input-class"}),
    )
    email = forms.EmailField(label="Your Email")

При рендеринге экземпляра CustomForm включается следующий HTML-код:

<div class="custom">
  <label for="id_name">Your Name:</label>
  <input type="text" name="name" class="name-input-class" maxlength="100" id="id_name">
</div>

<div class="custom">
  <label for="id_email">Your Email:</label>
  <input type="email" name="email" maxlength="320" required="" id="id_email">
</div>

Смотрите Настройка BoundField для получения более подробной информации об этой функции.

Незначительные особенности¶

API бэкенда базы данных¶

В этом разделе описаны изменения, которые могут потребоваться в бэкендах баз данных сторонних производителей.

• Новый метод Model._is_pk_set() позволяет проверить, определен ли первичный ключ экземпляра модели.
• BaseDatabaseOperations.adapt_decimalfield_value() теперь не требуется, просто возвращается заданное значение.

django.contrib.gis¶

• Поддержка PostGIS 3.0 удалена.
• Поддержка GDAL 3.0 удалена.

Прекращена поддержка PostgreSQL 13¶

Предварительная поддержка PostgreSQL 13 завершится в ноябре 2025 года. Django 5.2 поддерживает PostgreSQL 14 и выше.

Изменен набор символов для подключения к MySQL по умолчанию¶

Для подключений к MySQL теперь по умолчанию используется набор символов utf8mb4 вместо utf8, который является псевдонимом для устаревшего набора символов utf8mb3. utf8mb3 может быть указан в OPTIONS часть параметра DATABASES, если это необходимо для устаревших баз данных.

Разное¶

• Добавление EmailMultiAlternatives.alternatives теперь поддерживается только с помощью метода attach_alternative().
• Минимальная поддерживаемая версия gettext увеличена с 0,15 до 0,19.
• HttpRequest.accepted_types теперь сортируется по предпочтениям клиента на основе заголовка запроса Accept.
• Атрибуты UniqueConstraint.violation_error_code и UniqueConstraint.violation_error_message теперь используются всегда, если они указаны. Ранее они игнорировались, если UniqueConstraint.fields был задан без UniqueConstraint.condition.
• Контекстный процессор debug() больше не включен в шаблон проекта по умолчанию.
• Для следующих методов теперь установлен alters_data=True, чтобы предотвратить побочные эффекты при rendering a template context:
  • UserManager.create_user()
  • UserManager.acreate_user()
  • UserManager.create_superuser()
  • UserManager.acreate_superuser()
  • QuerySet.create()
  • QuerySet.acreate()
  • QuerySet.bulk_create()
  • QuerySet.abulk_create()
  • QuerySet.get_or_create()
  • QuerySet.aget_or_create()
  • QuerySet.update_or_create()
  • QuerySet.aupdate_or_create()
• Минимальная поддерживаемая версия oracledb увеличена с 1.3.2 до 2.3.0.
• Встроенные агрегатные функции, принимающие только один аргумент (Avg, Count, Max, Min, StdDev, Sum, и Variance), теперь вызывают TypeError при вызове с неправильным количеством аргументов.

Разное¶

• Аргумент all для функции django.contrib.staticfiles.finders.find() считается устаревшим в пользу аргумента find_all.
• Резервный вариант для request.user, когда user является None в django.contrib.auth.login() и django.contrib.auth.alogin(), будет удален.
• Аргумент ordering ключевого слова для функций агрегации, специфичных для PostgreSQL django.contrib.postgres.aggregates.ArrayAgg, django.contrib.postgres.aggregates.JSONBAgg, и django.contrib.postgres.aggregates.StringAgg, устарел в пользу аргумента order_by.