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

Поддержка Psycopg 3¶

Django теперь поддерживает psycopg версии 3.1.8 и выше. Для обновления кода установите psycopg library, ENGINE менять не нужно, так как django.db.backends.postgresql поддерживает обе библиотеки.

Поддержка psycopg2, скорее всего, будет устаревшей и удалена в будущем.

Следует иметь в виду, что в psycopg 3 внесены некоторые принципиальные изменения по сравнению с psycopg2. В связи с этим может потребоваться внести некоторые изменения для учета differences from psycopg2.

Комментарии к столбцам и таблицам¶

Новые опции Field.db_comment и Meta.db_table_comment позволяют создавать комментарии к столбцам и таблицам соответственно. Например:

from django.db import models


class Question(models.Model):
    text = models.TextField(db_comment="Poll question")
    pub_date = models.DateTimeField(
        db_comment="Date and time when the question was published",
    )

    class Meta:
        db_table_comment = "Poll questions"


class Answer(models.Model):
    question = models.ForeignKey(
        Question,
        on_delete=models.CASCADE,
        db_comment="Reference to a question",
    )
    answer = models.TextField(db_comment="Question answer")

    class Meta:
        db_table_comment = "Question answers"

Кроме того, новая операция AlterModelTableComment позволяет изменять комментарии к таблице, заданные в Meta.db_table_comment.

Защита от атаки BREACH¶

GZipMiddleware теперь включает в себя защиту от атаки BREACH. Оно добавляет до 100 случайных байтов в gzip-ответы, чтобы затруднить атаки BREACH. Подробнее о методе защиты от атак читайте в Heal The Breach (HTB) paper.

Файловое хранилище в памяти¶

Новый класс django.core.files.storage.InMemoryStorage предоставляет непостоянное хранилище, полезное для ускорения тестирования за счет отказа от обращения к диску.

Пользовательские файловые хранилища¶

Новый параметр STORAGES позволяет настраивать несколько пользовательских бэкендов хранения файлов. Она также управляет механизмами хранения для управления files (ключ "default") и static files (ключ "staticfiles").

Старые настройки DEFAULT_FILE_STORAGE и STATICFILES_STORAGE в этом выпуске устарели.

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

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

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

• DatabaseFeatures.allows_group_by_pk удален, поскольку он оставался только для того, чтобы соответствовать расширению MySQL, которое в MySQL 5.7.15 было вытеснено корректным определением функциональных зависимостей. Отметим, что DatabaseFeatures.allows_group_by_selected_pks по-прежнему поддерживается и должен быть включен, если ваш бэкэнд поддерживает обнаружение функциональных зависимостей в предложениях GROUP BY, как это предусмотрено стандартом SQL:1999.
• inspectdb теперь использует display_size из DatabaseIntrospection.get_table_description(), а не internal_size для CharField.

Прекращена поддержка MariaDB 10.3¶

Поддержка MariaDB 10.3 заканчивается в мае 2023 года. Django 4.2 поддерживает MariaDB 10.4 и выше.

Отказано в поддержке MySQL 5.7¶

Поддержка MySQL 5.7 заканчивается в октябре 2023 года. Django 4.2 поддерживает MySQL 8 и выше.

Отказ от поддержки PostgreSQL 11¶

Текущая поддержка PostgreSQL 11 заканчивается в ноябре 2023 года. Django 4.2 поддерживает PostgreSQL 12 и выше.

Теперь может потребоваться установка update_fields в Model.save()¶

Чтобы избежать обновления ненужных столбцов, QuerySet.update_or_create() теперь передает update_fields в вызовы Model.save(). Как следствие, любые поля, модифицированные в пользовательских методах save(), должны быть добавлены в аргумент ключевого слова update_fields перед вызовом super(). Более подробная информация приведена в разделе Переопределение методов модели.

Отказались от поддержки сырых агрегатов в MySQL¶

MySQL 8+ разрешает функциональные зависимости от GROUP BY столбцов, поэтому обходной путь группировки по первичным ключам главной таблицы, существовавший до версии Django 4.2, удален. Как следствие, использование агрегаций RawSQL() больше не поддерживается в MySQL, так как нет способа определить, нужны ли такие агрегации или допустимы ли они в предложении GROUP BY. Вместо этого используйте Агрегационные функции.

Разное¶

• Недокументированная функция django.http.multipartparser.parse_header() удалена. Вместо нее используйте django.utils.http.parse_header_parameters().
• Результат {% blocktranslate asvar … %} теперь помечен как безопасный для (HTML) вывода.
• HTML-атрибут autofocus в окне поиска администратора удален, так как он может сбивать с толку пользователей, читающих с экрана.
• Опция makemigrations --check больше не создает отсутствующие файлы миграции.
• Аргумент alias для Expression.get_group_by_cols() удален.
• Минимальная поддерживаемая версия sqlparse увеличена с 0.2.2 до 0.3.1.
• Недокументированный параметр negated выражения Exists удален.
• Аргумент is_summary недокументированного метода Query.add_annotation() удален.
• Минимальная поддерживаемая версия SQLite увеличена с 3.9.0 до 3.21.0.
• Минимальная поддерживаемая версия asgiref увеличена с 3.5.2 до 3.6.0.
• UserCreationForm теперь отвергает имена пользователей, отличающиеся только регистром. Если вам нужно прежнее поведение, используйте вместо него BaseUserCreationForm.
• Минимальная поддерживаемая версия mysqlclient увеличена с 1.4.0 до 1.4.3.
• Минимальная поддерживаемая версия argon2-cffi увеличена с 19.1.0 до 19.2.0.
• Минимальная поддерживаемая версия Pillow увеличена с 6.2.0 до 6.2.1.
• Минимальная поддерживаемая версия jinja2 увеличена с 2.9.2 до 2.11.0.
• Минимальная поддерживаемая версия redis-py увеличена с 3.0.0 до 3.4.0.
• Для объектов WSGIRequest, инстанцируемых вручную, должен быть предоставлен файлоподобный объект wsgi.input. Ранее Django был более мягким по сравнению с ожидаемым поведением, указанным в спецификации WSGI.
• Устранена поддержка PROJ < 5.
• EmailBackend теперь проверяет наличие hostname и certificates. Если вам нужно прежнее поведение, которое является менее ограничительным и не рекомендуется, подкласс EmailBackend и переопределите свойство ssl_context.

<<<Опция index_together устарела в пользу indexes.¶

Параметр Meta.index_together устарел в пользу параметра indexes.

Миграция существующих index_together должна обрабатываться как миграция. Например:

class Author(models.Model):
    rank = models.IntegerField()
    name = models.CharField(max_length=30)

    class Meta:
        index_together = [["rank", "name"]]

Должно стать:

class Author(models.Model):
    rank = models.IntegerField()
    name = models.CharField(max_length=30)

    class Meta:
        indexes = [models.Index(fields=["rank", "name"])]

Выполнение команды makemigrations приведет к генерации миграции, содержащей операцию RenameIndex, которая переименует существующий индекс. Далее следует рассмотреть возможность сминания миграций, чтобы удалить index_together из исторических миграций.

Операция миграции AlterIndexTogether теперь официально поддерживается только для файлов миграции, созданных до версии Django 4.2. По соображениям обратной совместимости она по-прежнему является частью общедоступного API, и ее отказ от использования или удаление не планируется, но ее не следует использовать для новых миграций. Вместо него используйте операции AddIndex и RemoveIndex.

Передача закодированных строковых литералов JSON в JSONField устарела¶

JSONField и связанные с ним lookups и aggregates раньше позволяли передавать строковые литералы в кодировке JSON, что вызывало неоднозначность в вопросе о том, закодированы ли уже строковые литералы с точки зрения бэкенда базы данных.

В течение периода обесценивания строковые литералы будут пытаться декодироваться в JSON, а при успехе будет выдаваться предупреждение, указывающее на передачу вместо них некодированных форм.

Код, используемый для передачи строковых литералов в кодировке JSON:

Document.objects.bulk_create(
    Document(data=Value("null")),
    Document(data=Value("[]")),
    Document(data=Value('"foo-bar"')),
)
Document.objects.annotate(
    JSONBAgg("field", default=Value("[]")),
)

Должно стать:

Document.objects.bulk_create(
    Document(data=Value(None, JSONField())),
    Document(data=[]),
    Document(data="foo-bar"),
)
Document.objects.annotate(
    JSONBAgg("field", default=[]),
)

Начиная с версии Django 5.1+ строковые литералы будут неявно интерпретироваться как строковые литералы JSON.

Разное¶

• Метод BaseUserManager.make_random_password() является устаревшим. См. recipes and best practices об использовании модуля Python secrets для генерации паролей.

• Шаблонный фильтр length_is устарел в пользу length и оператора == внутри тега {% if %}. Например

  {% if value|length == 4 %}…{% endif %}
  {% if value|length == 4 %}True{% else %}False{% endif %}
  

  вместо:

  {% if value|length_is:4 %}…{% endif %}
  {{ value|length_is:4 }}
  

• django.contrib.auth.hashers.SHA1PasswordHasher, django.contrib.auth.hashers.UnsaltedSHA1PasswordHasher и django.contrib.auth.hashers.UnsaltedMD5PasswordHasher являются устаревшими.

• django.contrib.postgres.fields.CICharField устарел в пользу CharField(db_collation="…") с нечувствительной к регистру недетерминированной сверткой.

• django.contrib.postgres.fields.CIEmailField устарел в пользу EmailField(db_collation="…") с нечувствительной к регистру недетерминированной сверткой.

• django.contrib.postgres.fields.CITextField устарел в пользу TextField(db_collation="…") с нечувствительной к регистру недетерминированной сверткой.

• Миксин django.contrib.postgres.fields.CIText устарел.

• Атрибуты map_height и map_width в BaseGeometryWidget устарели, вместо них используйте CSS для определения размеров виджетов карт.

• SimpleTestCase.assertFormsetError() устарел в пользу assertFormSetError().

• TransactionTestCase.assertQuerysetEqual() устарел в пользу assertQuerySetEqual().

• Передача позиционных аргументов в Signer и TimestampSigner устарела в пользу аргументов, состоящих только из ключевых слов.

• Настройка DEFAULT_FILE_STORAGE устарела в пользу STORAGES["default"].

• Настройка STATICFILES_STORAGE устарела в пользу STORAGES["staticfiles"].

• Функция django.core.files.storage.get_storage_class() является устаревшей.