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

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

• Асинхронные представления

• Асинхронное промежуточное ПО

• Асинхронные тесты и тестовый клиент

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

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

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

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

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

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

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

Django теперь включает models.JSONField и forms.JSONField, которые можно использовать во всех поддерживаемых базах данных. Оба поля поддерживают использование пользовательских кодировщиков и декодеров JSON. Поле модели поддерживает самоанализ, поиск и преобразование, которые ранее были доступны только для 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, а также связанное поле формы и преобразования, вам следует настроить использование новых полей, а также сгенерировать и применить миграцию базы данных. На данный момент старые поля и преобразования оставлены как ссылки на новые и устарели с этой версии.

Настройки DEFAULT_HASHING_ALGORITHM¶

The new DEFAULT_HASHING_ALGORITHM transitional setting allows specifying the default hashing algorithm to use for encoding cookies, password reset tokens in the admin site, user sessions, and signatures created by django.core.signing.Signer and django.core.signing.dumps().

Support for SHA-256 was added in Django 3.1. If you are upgrading multiple instances of the same project to Django 3.1, you should set DEFAULT_HASHING_ALGORITHM to 'sha1' during the transition, in order to allow compatibility with the older versions of Django. Note that this requires Django 3.1.1+. Once the transition to 3.1 is complete you can stop overriding DEFAULT_HASHING_ALGORITHM.

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

Минорные изменения¶

Серверный API базы данных¶

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

• DatabaseOperations.fetch_returned_insert_columns() теперь требует дополнительного аргумента returning_params.

• Свойство connection.timezone теперь имеет значение 'UTC' по умолчанию или значение TIME_ZONE, когда :setting:USE_TZ` имеет значение ``True в базах данных, поддерживающих часовые пояса. Раньше в базах данных, поддерживающих часовые пояса, это было «Нет».

• Свойство 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. См. Часто задаваемые вопросы для администраторов для получения подробной информации о поддерживаемых браузерах.

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, которые раньше были кортежами, теперь представляют собой списки.

• Виджет календаря администратора теперь обрабатывает двузначные годы в соответствии со спецификацией открытой группы, т. е. значения от 69 до 99 сопоставляются с предыдущим веком, а значения между 0 и 68 сопоставляются с текущим веком.

• Форматы только даты удалены из списка по умолчанию для DATETIME_INPUT_FORMATS.

• Виджет FileInput больше не отображается с HTML-атрибутом required при наличии исходных данных.

• Недокументированный класс django.views.debug.ExceptionReporterFilter удален. Согласно документации custom-error-reports, классы, которые будут использоваться с DEFAULT_EXCEPTION_REPORTER_FILTER, должны наследовать от django.views.debug.SafeExceptionReporterFilter.

• Тайм-аут кэша, установленный декоратором cache_page(), теперь имеет приоритет над директивой max-age из заголовка Cache-Control.

• Предоставление нелокального удаленного поля в аргументе ForeignKey.to_field теперь вызывает FieldError.

• SECURE_REFERRER_POLICY теперь по умолчанию имеет значение 'same-origin'. Дополнительную информацию см. в разделе Что нового Безопасность выше.

• Команда управления check теперь запускает системную проверку базы данных только для псевдонимов базы данных, указанных с помощью опции check --database.

• migrate команда управления теперь запускает систему база данных и проверяет только базу данных для миграции.

• Классы CSS администратора row1 и row2 удалены в пользу псевдоклассов :nth-child(odd) и :nth-child(even).

• Функция make_password() теперь требует, чтобы ее аргумент был строкой или байтами. Другие типы должны быть явно приведены к одному из них.

• Недокументированный параметр version для функции AsKML удален.

• Сериализаторы JSON и YAML, используемые dumpdata, теперь по умолчанию выгружают все данные в формате Unicode. Если вам нужно предыдущее поведение, передайте 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 <https://html.spec.whatwg.org/multipage/scripting.html#the-script-element>`_.

• ModelChoiceIterator, используемый ModelChoiceField и ModelMultipleChoiceField, теперь дает варианты из двух кортежей, содержащие экземпляры ModelChoiceIteratorValue в качестве первого элемент value в каждом выборе. В большинстве случаев это прозрачное проксирование, но если вам нужно само значение поля, используйте вместо него атрибут 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.

Новые JSONField, 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__() не рекомендуется.

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

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

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

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

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

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

• The NullBooleanField model field is deprecated in favor of BooleanField(null=True).

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

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

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