Примечания к выпуску Django 4.2 - ПОД РАЗРАБОТКОЙ¶

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

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

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

Устранение последствий атаки BREACH¶

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

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

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

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

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

Прекращена поддержка 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(). Более подробную информацию см. в разделе Переопределение методов модели.

Разное¶

• Недокументированные SimpleTemplateResponse.rendering_attrs и TemplateResponse.rendering_attrs переименованы в non_picklable_attrs.
• Недокументированная функция django.http.multipartparser.parse_header() удалена. Вместо нее используйте django.utils.http.parse_header_parameters().
• Результат {% blocktranslate asvar … %} теперь помечен как безопасный для (HTML) вывода.
• HTML-атрибут autofocus в окне поиска администратора удален, так как он может сбивать с толку читателей экрана.
• The makemigrations --check option no longer creates missing migration files.
• Аргумент alias для Expression.get_group_by_cols() удаляется.
• T
• T
• T
• T
• <
• T

Опция 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, которая переименует существующий индекс.

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

Минимальная поддерживаемая версия JSONField увеличена с 3.5.2 до 3.6.0.¶

JSONField и связанные с ним поиск и агрегаты использовали возможность передачи строковых литералов в кодировке 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 устарела в пользу аргументов, содержащих только ключевые слова.