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

Асинхронные представления и поддержка промежуточного ПО¶

Django теперь поддерживает полностью асинхронный путь запроса, включая:

• Asynchronous views
• Asynchronous middleware
• Asynchronous tests and test client

Чтобы начать работу с асинхронными представлениями, необходимо объявить представление, используя async def:

async def my_view(request):
    await asyncio.sleep(0.5)
    return HttpResponse("Hello, async world!")

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

Вы можете смешивать async и sync представления, промежуточное ПО и тесты сколько угодно. Django позаботится о том, чтобы вы всегда получали правильный контекст выполнения. Мы ожидаем, что большинство проектов будут держать большинство своих представлений синхронными, и только некоторые будут работать в режиме async - но это полностью ваш выбор.

ORM, слой кэша и другие части кода Django, которые выполняют длительные сетевые вызовы, пока не поддерживают асинхронный доступ. Мы ожидаем добавить их поддержку в ближайших релизах. Асинхронные представления идеальны, однако, если вы выполняете много вызовов API или HTTP внутри вашего представления, теперь вы можете выполнять все эти HTTP вызовы параллельно, что значительно ускорит выполнение вашего представления.

Асинхронная поддержка должна быть полностью обратно совместима, и мы постарались сделать так, чтобы она не имела никаких регрессий в скорости для вашего существующего синхронного кода. Это не должно оказать заметного влияния на существующие проекты Django.

JSONField для всех поддерживаемых бэкендов баз данных¶

Django теперь включает models.JSONField и forms.JSONField, которые могут быть использованы на всех поддерживаемых бэкендах баз данных. Оба поля поддерживают использование пользовательских кодировщиков и декодировщиков JSON. Поле модели поддерживает интроспекцию, lookups, and transforms, которые ранее были только для PostgreSQL:

from django.db import models


class ContactInfo(models.Model):
    data = models.JSONField()


ContactInfo.objects.create(
    data={
        "name": "John",
        "cities": ["London", "Cambridge"],
        "pets": {"dogs": ["Rufus", "Meg"]},
    }
)
ContactInfo.objects.filter(
    data__name="John",
    data__pets__has_key="dogs",
    data__cities__contains="London",
).delete()

Если в вашем проекте используется django.contrib.postgres.fields.JSONField, а также связанные с ним поле формы и преобразования, вам следует перестроиться на использование новых полей, а также создать и применить миграцию базы данных. На данный момент старые поля и преобразования оставлены в качестве ссылки на новые и являются deprecated as of this release.

DEFAULT_HASHING_ALGORITHM настройки¶

Новый переходный параметр DEFAULT_HASHING_ALGORITHM позволяет указать алгоритм хэширования по умолчанию, который будет использоваться для кодирования cookies, токенов сброса пароля на сайте администратора, пользовательских сессий и подписей, созданных с помощью django.core.signing.Signer и django.core.signing.dumps().

Поддержка SHA-256 была добавлена в Django 3.1. Если вы обновляете несколько экземпляров одного и того же проекта до Django 3.1, вам следует установить DEFAULT_HASHING_ALGORITHM на 'sha1' во время перехода, чтобы обеспечить совместимость со старыми версиями Django. Обратите внимание, что для этого требуется Django 3.1.1+. После завершения перехода на 3.1 вы можете перестать переопределять DEFAULT_HASHING_ALGORITHM.

Этот параметр устарел в этом выпуске, поскольку поддержка токенов, cookies, сессий и подписей, использующих алгоритм SHA-1, будет удалена в Django 4.0.

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

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

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

• DatabaseOperations.fetch_returned_insert_columns() теперь требует дополнительного аргумента returning_params.
• Свойство connection.timezone теперь по умолчанию 'UTC', или TIME_ZONE, когда USE_TZ равно True на базах данных, поддерживающих часовые пояса. Ранее оно было None на базах данных, поддерживающих часовые пояса.
• Свойство connection._nodb_connection изменено на метод connection._nodb_cursor() и теперь возвращает менеджер контекста, который выдает курсор и автоматически закрывает курсор и соединение при выходе из оператора with.
• DatabaseClient.runshell() теперь требует дополнительный аргумент parameters как список дополнительных аргументов для передачи клиенту командной строки.
• Позиционный аргумент sequences в DatabaseOperations.sql_flush() заменяется булевым аргументом reset_sequences, содержащим только ключевое слово. Если True, последовательности усеченных таблиц будут сброшены.
• Аргумент allow_cascade в DatabaseOperations.sql_flush() теперь является аргументом только для ключевого слова.
• Позиционный аргумент using из DatabaseOperations.execute_sql_flush() удален. Теперь метод использует базу данных вызванного экземпляра.
• Бэкенды баз данных сторонних производителей должны реализовать поддержку JSONField или установить DatabaseFeatures.supports_json_field в False. Если хранение примитивов не поддерживается, установите DatabaseFeatures.supports_primitives_in_json_field в False. Если для JSON существует истинный тип данных, установите DatabaseFeatures.has_native_json_field в True. Если jsonfield.contains и jsonfield.contained_by не поддерживаются, установите DatabaseFeatures.supports_json_field_contains в False.
• Сторонние бэкенды баз данных должны реализовать интроспекцию для JSONField или установить can_introspect_json_field в False.

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

Поддержка MariaDB 10.1 заканчивается в октябре 2020 года. Django 3.1 поддерживает MariaDB 10.2 и выше.

contrib.admin поддержка браузера¶

Администратор больше не поддерживает устаревший браузер Internet Explorer. Подробную информацию о поддерживаемых браузерах смотрите в the admin FAQ.

AbstractUser.first_name max_length увеличено до 150¶

Миграция для django.contrib.auth.models.User.first_name включена. Если у вас есть пользовательская модель пользователя, наследующая от AbstractUser, вам необходимо создать и применить миграцию базы данных для вашей модели пользователя.

Если вы хотите сохранить ограничение в 30 символов для имен, используйте пользовательскую форму:

from django import forms
from django.contrib.auth.forms import UserChangeForm


class MyUserChangeForm(UserChangeForm):
    first_name = forms.CharField(max_length=30, required=False)

Если вы хотите сохранить это ограничение в админке при редактировании пользователей, установите UserAdmin.form для использования этой формы:

from django.contrib.auth.admin import UserAdmin
from django.contrib.auth.models import User


class MyUserAdmin(UserAdmin):
    form = MyUserChangeForm


admin.site.unregister(User)
admin.site.register(User, MyUserAdmin)

Разное¶

• Ключи кэша, используемые cache и генерируемые make_template_fragment_key(), отличаются от ключей, генерируемых в старых версиях Django. После обновления до Django 3.1 первый запрос к любому ранее кэшированному фрагменту шаблона будет пропуском кэша.
• Логика принятия решения о возврате обратного перенаправления или HTTP-ответа 204 из представления set_language() теперь основана на HTTP-заголовке Accept вместо наличия HTTP-заголовка X-Requested-With.
• Импорт совместимости django.core.exceptions.EmptyResultSet в django.db.models.query, django.db.models.sql и django.db.models.sql.datastructures удален.
• Импорт совместимости django.core.exceptions.FieldDoesNotExist в django.db.models.fields удален.
• Импорт совместимости django.forms.utils.pretty_name() и django.forms.boundfield.BoundField в django.forms.forms удален.
• Импорт совместимости Context, ContextPopException и RequestContext в django.template.base удален.
• Импорт совместимости django.contrib.admin.helpers.ACTION_CHECKBOX_NAME в django.contrib.admin удален.
• Параметры STATIC_URL и MEDIA_URL, установленные на относительные пути, теперь имеют префикс SCRIPT_NAME, предоставляемый сервером (или /, если он не установлен). Это изменение не должно повлиять на настройки, заданные для действительных URL или абсолютных путей.
• ConditionalGetMiddleware больше не добавляет заголовок ETag к ответам с пустым content.
• Декоратор django.utils.decorators.classproperty() стал общедоступным и перенесен в django.utils.functional.classproperty().
• Фильтр шаблона floatformat теперь выводит (положительное) 0 для отрицательных чисел, которые округляются до нуля.
• Опции Meta.ordering и Meta.unique_together для моделей в модулях django.contrib, которые раньше были кортежами, теперь стали списками.
• Виджет календаря администратора теперь обрабатывает двузначные годы в соответствии со спецификацией Open Group Specification, т.е. значения от 69 до 99 отображаются на предыдущий век, а значения от 0 до 68 отображаются на текущий век.
• Форматы только для даты удалены из списка по умолчанию для DATETIME_INPUT_FORMATS.
• Виджет FileInput больше не отображается с HTML-атрибутом required при наличии начальных данных.
• Недокументированный класс django.views.debug.ExceptionReporterFilter удален. Согласно документации Пользовательские отчеты об ошибках, классы, которые будут использоваться с DEFAULT_EXCEPTION_REPORTER_FILTER, должны наследоваться от django.views.debug.SafeExceptionReporterFilter.
• Таймаут кэша, установленный декоратором cache_page(), теперь имеет приоритет над директивой max-age из заголовка Cache-Control.
• Предоставление нелокального удаленного поля в аргументе ForeignKey.to_field теперь приводит к появлению FieldError.
• SECURE_REFERRER_POLICY теперь по умолчанию используется 'same-origin'. Подробнее см. в разделе Что нового Security section выше.
• Команда управления check теперь запускает системные проверки database только для псевдонимов баз данных, указанных с помощью опции check --database.
• Команда управления migrate теперь запускает системные проверки database только для базы данных, подлежащей миграции.
• Админские CSS-классы row1 и row2 удалены в пользу псевдоклассов :nth-child(odd) и :nth-child(even).
• Функция make_password() теперь требует, чтобы ее аргумент был строкой или байтом. Другие типы должны быть явно приведены к одному из этих типов.
• Удален недокументированный параметр version в функции AsKML.
• JSON and YAML serializers, используемый dumpdata, теперь по умолчанию передает все данные с Юникодом. Если вам нужно прежнее поведение, передайте ensure_ascii=True сериализатору JSON или allow_unicode=False сериализатору YAML.
• Автозагрузчик больше не отслеживает изменения во встроенных файлах переводов Django.
• Минимальная поддерживаемая версия mysqlclient увеличена с 1.3.13 до 1.4.0.
• Недокументированные django.contrib.postgres.forms.InvalidJSONInput и django.contrib.postgres.forms.JSONString перемещены в django.forms.fields.
• Недокументированный класс django.contrib.postgres.fields.jsonb.JsonAdapter удален.
• Тег {% localize off %} и фильтр unlocalize больше не уважают настройку DECIMAL_SEPARATOR.
• Минимальная поддерживаемая версия asgiref увеличена с 3.2 до 3.2.10.
• Класс Media теперь отображает теги <script> без атрибута type, следующие за WHATWG recommendations.
• ModelChoiceIterator, используемый ModelChoiceField и ModelMultipleChoiceField, теперь дает выбор из двух кортежей, содержащих экземпляры ModelChoiceIteratorValue в качестве первого value элемента в каждом выборе. В большинстве случаев это прозрачное проксирование, но если вам нужно само значение field, используйте атрибут ModelChoiceIteratorValue.value вместо него.

PostgreSQL JSONField¶

django.contrib.postgres.fields.JSONField и django.contrib.postgres.forms.JSONField устарели в пользу models.JSONField и forms.JSONField.

Недокументированные django.contrib.postgres.fields.jsonb.KeyTransform и django.contrib.postgres.fields.jsonb.KeyTextTransform также устарели в пользу преобразований в django.db.models.fields.json.

Новые JSONFields, KeyTransform и KeyTextTransform могут быть использованы на всех поддерживаемых бэкендах баз данных.

Разное¶

• Настройка PASSWORD_RESET_TIMEOUT_DAYS устарела в пользу PASSWORD_RESET_TIMEOUT.

• Недокументированное использование поиска isnull с небулевыми значениями в качестве правой части устарело, вместо этого используйте True или False.

• Мало документированный класс исключений django.db.models.query_utils.InvalidQuery устарел в пользу FieldDoesNotExist и FieldError.

• Точка входа django-admin.py устарела в пользу django-admin.

• Метод HttpRequest.is_ajax() устарел, так как он полагался на специфический для jQuery способ обозначения вызовов AJAX, в то время как в настоящее время используется JavaScript Fetch API. В зависимости от вашего случая использования, вы можете либо написать свой собственный метод обнаружения AJAX, либо использовать новый метод HttpRequest.accepts(), если ваш код зависит от HTTP-заголовка клиента Accept.

  Если вы пишете свой собственный метод обнаружения AJAX, request.is_ajax() можно воспроизвести точно так же, как request.headers.get('x-requested-with') == 'XMLHttpRequest'.

• Передача None в качестве первого аргумента в django.utils.deprecation.MiddlewareMixin.__init__() устарела.

• Формат кодировки значений cookies, используемый CookieStorage, отличается от формата, генерируемого старыми версиями Django. Поддержка старого формата сохраняется до версии Django 4.0.

• Формат кодировки сессий отличается от формата, генерируемого старыми версиями Django. Поддержка старого формата сохранится до версии Django 4.0.

• Чисто документальный аргумент providing_args для Signal является устаревшим. Если вы полагаетесь на этот аргумент как на документацию, вы можете переместить текст в комментарий к коду или в doc-строку.

• Вызов django.utils.crypto.get_random_string() без аргумента length является устаревшим.

• Сообщение list для ModelMultipleChoiceField устарело в пользу invalid_list.

• Передача необработанных псевдонимов столбцов в QuerySet.order_by() устарела. Того же результата можно добиться, передав псевдонимы в RawSQL заранее.

• Поле модели NullBooleanField устарело в пользу BooleanField(null=True, blank=True).

• django.conf.urls.url() псевдоним django.urls.re_path() является устаревшим.

• Теги шаблонов {% ifequal %} и {% ifnotequal %} устарели в пользу {% if %}. {% if %} покрывает все случаи использования, но если вам нужно продолжать использовать эти теги, они могут быть извлечены из Django в модуль и включены как встроенный тег в опцию 'builtins' в OPTIONS.

• DEFAULT_HASHING_ALGORITHM переходная установка устарела.