Django 4.1 release notes¶

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

Подклассы представления теперь могут определять асинхронные обработчики HTTP-методов:

import asyncio
from django.http import HttpResponse
from django.views import View

class AsyncView(View):
    async def get(self, request, *args, **kwargs):
        # Perform view logic using await.
        await asyncio.sleep(1)
        return HttpResponse("Hello async world!")

Более подробную информацию см. в разделе Asynchronous class-based views.

Асинхронный интерфейс ORM¶

QuerySet теперь предоставляет асинхронный интерфейс для всех операций доступа к данным. Они называются так же, как и существующие синхронные операции, но с префиксом a, например acreate(), aget() и так далее.

Новый интерфейс позволяет писать асинхронный код без необходимости оборачивать операции ORM в sync_to_async():

async for author in Author.objects.filter(name__startswith="A"):
    book = await author.books.afirst()

Обратите внимание, что на данном этапе базовые операции с базой данных остаются синхронными, при этом продолжается работа по внедрению асинхронной поддержки в компилятор SQL и интеграции драйверов асинхронных баз данных. Новый асинхронный интерфейс queryset в настоящее время инкапсулирует необходимые операции sync_to_async() для вас, и позволит вашему коду использовать преимущества развития асинхронной поддержки ORM по мере его развития.

Подробности и ограничения см. в разделе Асинхронные запросы.

Валидация ограничений¶

Ограничения Check, unique и exclusion, определенные в опции Meta.constraints, теперь проверяются во время model validation.

Доступность рендеринга формы¶

Чтобы помочь пользователям с программами чтения с экрана и другими вспомогательными технологиями, в этом выпуске доступны новые шаблоны форм на основе <div>. Они обеспечивают более доступную навигацию, чем старые шаблоны, и способны правильно группировать связанные элементы управления, такие как радиосписки, в наборы полей.

Новые шаблоны рекомендованы и станут стилем рендеринга формы по умолчанию при выводе формы, как {{ form }} в шаблоне, начиная с Django 5.0.

Чтобы облегчить принятие нового стиля вывода, шаблоны форм и наборов форм по умолчанию теперь настраиваются на уровне проекта с помощью параметра FORM_RENDERER.

Подробную информацию см. в разделе the Forms section (below).

CSRF_COOKIE_MASKED установка¶

Новый переходный параметр CSRF_COOKIE_MASKED позволяет указать, нужно ли маскировать CSRF-куки.

CsrfViewMiddleware больше не маскирует CSRF cookie, как это делает CSRF token в DOM. Если вы обновляете несколько экземпляров одного и того же проекта до Django 4.1, вам следует установить CSRF_COOKIE_MASKED на True во время перехода, чтобы обеспечить совместимость со старыми версиями Django. После завершения перехода на 4.1 вы можете перестать переопределять CSRF_COOKIE_MASKED.

This setting is deprecated as of this release and will be removed in Django 5.0.

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

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

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

• BaseDatabaseFeatures.has_case_insensitive_like изменено с True на False, чтобы отразить поведение большинства баз данных.
• DatabaseIntrospection.get_key_columns() удаляется. Вместо этого используйте DatabaseIntrospection.get_relations().
• Метод DatabaseOperations.ignore_conflicts_suffix_sql() заменяется на DatabaseOperations.on_conflict_suffix_sql(), который принимает аргументы fields, on_conflict, update_fields и unique_fields.
• Аргумент ignore_conflicts метода DatabaseOperations.insert_statement() заменяется на on_conflict, который принимает django.db.models.constants.OnConflict.
• DatabaseOperations._convert_field_to_tz() заменяется на DatabaseOperations._convert_sql_to_tz(), который принимает аргументы sql, params и tzname.
• Несколько методов даты и времени на DatabaseOperations теперь принимают аргументы sql и params вместо field_name и возвращают кортеж, содержащий некоторый SQL и параметры, которые должны быть интерполированы в этот SQL. Измененные методы имеют новые сигнатуры:
  • DatabaseOperations.date_extract_sql(lookup_type, sql, params)
  • DatabaseOperations.datetime_extract_sql(lookup_type, sql, params, tzname)
  • DatabaseOperations.time_extract_sql(lookup_type, sql, params)
  • DatabaseOperations.date_trunc_sql(lookup_type, sql, params, tzname=None)
  • DatabaseOperations.datetime_trunc_sql(self, lookup_type, sql, params, tzname)
  • DatabaseOperations.time_trunc_sql(lookup_type, sql, params, tzname=None)
  • DatabaseOperations.datetime_cast_date_sql(sql, params, tzname)
  • DatabaseOperations.datetime_cast_time_sql(sql, params, tzname)

django.contrib.gis¶

• Удалена поддержка GDAL 2.1.
• Удалена поддержка PostGIS 2.4.

Dropped support for PostgreSQL 10¶

Upstream support for PostgreSQL 10 ends in November 2022. Django 4.1 supports PostgreSQL 11 and higher.

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

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

Поиск изменений в списке изменений администратора, охватывающий изменения многозначных отношений¶

Поиск в списке изменений администратора с использованием нескольких поисковых запросов теперь выполняется в одном вызове filter(), а не в последовательных вызовах filter().

Для многозначных отношений это означает, что строки из связанной модели должны соответствовать всем терминам, а не любому из них. Например, если search_fields установлен на ['child__name', 'child__age'], а пользователь ищет 'Jamal 17', строки о родителях будут возвращены только в том случае, если есть связь с каким-то 17-летним ребенком по имени Джамал, вместо того, чтобы возвращать родителям, у которых просто есть младший или старший ребенок по имени Джамал в дополнение к какому-то другому 17-летнему.

См. тему Охватывающие многозначные отношения для более подробного обсуждения этого различия. В Django 4.0 и более ранних версиях get_search_results() следовал второму примеру запроса, но это недокументированное поведение приводило к запросам с избыточными соединениями.

Обратное изменение внешних ключей для несохраненных экземпляров модели¶

Чтобы унифицировать поведение с отношениями «многие ко многим» для несохраненных экземпляров модели, обратный внешний ключ теперь поднимает ValueError при вызове related managers для несохраненных объектов.

Разное¶

• Related managers for ForeignKey, ManyToManyField, and GenericRelation are now cached on the Model instance to which they belong. This change was reverted in Django 4.1.2.
• Бегунок тестирования Django теперь возвращает ненулевой код ошибки при неожиданных успехах тестов, помеченных unittest.expectedFailure().
• CsrfViewMiddleware больше не маскирует CSRF cookie, как это делает CSRF токен в DOM.
• CsrfViewMiddleware теперь использует request.META['CSRF_COOKIE'] для хранения незамаскированного CSRF-секрета, а не замаскированной версии. Это недокументированный, частный API.
• Атрибуты ModelAdmin.actions и inlines теперь по умолчанию используют пустой кортеж, а не пустой список, чтобы предотвратить непреднамеренную мутацию.
• Атрибут type="text/css" больше не включается в теги <link> для CSS form media.
• События JavaScript formset:added и formset:removed теперь являются событиями чистого JavaScript и не зависят от jQuery. Более подробно об этом изменении смотрите События встроенной формы.
• Аргумент exc_info недокументированной функции django.utils.log.log_response() заменяется на exception.
• Аргумент size недокументированной функции django.views.static.was_modified_since() удален.
• В пользовательском интерфейсе выхода из системы администратора теперь используются запросы POST.
• Недокументированное свойство InlineAdminFormSet.non_form_errors заменено методом non_form_errors(). Это соответствует BaseFormSet.
• Согласно above, загрузчик кэшированных шаблонов теперь включен в разработке. Вы можете указать OPTIONS['loaders'], чтобы отменить это, если необходимо.
• Недокументированный миксин django.contrib.auth.views.SuccessURLAllowedHostsMixin заменен на RedirectURLMixin.
• Подклассы BaseConstraint должны реализовать метод validate(), чтобы эти ограничения можно было использовать для проверки.
• Недокументированные URLResolver._is_callback(), URLResolver._callback_strs и URLPattern.lookup_str() перемещены в django.contrib.admindocs.utils.
• Метод Model.full_clean() теперь преобразует значение exclude в set. Также предпочтительнее передавать значение exclude в виде set методам Model.clean_fields(), Model.full_clean(), Model.validate_unique() и Model.validate_constraints().
• Минимальная поддерживаемая версия asgiref увеличена с 3.4.1 до 3.5.2.
• Комбинированные выражения больше не используют опасное для ошибок поведение угадывания output_field при совпадении типов аргументов. Как следствие, разрешение output_field для функций базы данных и комбинированных выражений теперь может привести к сбою при смешанных типах. В таких случаях необходимо явно задать output_field.

Выход из системы через GET¶

Выход из системы через GET запросы к built-in logout view устарел. Вместо этого используйте запросы POST.

Если вы хотите сохранить удобство использования HTML-ссылки, вы можете использовать форму, которая будет выглядеть как ссылка:

<form id="logout-form" method="post" action="{% url 'admin:logout' %}">
  {% csrf_token %}
  <button type="submit">{% translate "Log out" %}</button>
</form>

#logout-form {
  display: inline;
}
#logout-form button {
  background: none;
  border: none;
  cursor: pointer;
  padding: 0;
  text-decoration: underline;
}

Разное¶

• Контекст для шаблонов индексов sitemap, представляющий собой плоский список URL-адресов, устарел. Пользовательские шаблоны индекса sitemap должны быть обновлены для настроенного context variables, ожидая список объектов с location и необязательными атрибутами lastmod.

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

• Аргумент name в django.utils.functional.cached_property() является устаревшим, так как начиная с Python 3.6 в нем нет необходимости.

• Аргумент opclasses в django.contrib.postgres.constraints.ExclusionConstraint устарел в пользу использования OpClass() в ExclusionConstraint.expressions. Чтобы использовать его, вам нужно добавить 'django.contrib.postgres' в ваш INSTALLED_APPS.

  После внесения этого изменения makemigrations создаст новую миграцию с двумя операциями: RemoveConstraint и AddConstraint. Поскольку это изменение не влияет на схему базы данных, операцию SeparateDatabaseAndState можно использовать только для обновления состояния миграции без выполнения какого-либо SQL. Переместите сгенерированные операции в аргумент state_operations в SeparateDatabaseAndState. Например:

  class Migration(migrations.Migration):
      ...
  
      operations = [
          migrations.SeparateDatabaseAndState(
              database_operations=[],
              state_operations=[
                  migrations.RemoveConstraint(
                      ...
                  ),
                  migrations.AddConstraint(
                      ...
                  ),
              ],
          ),
      ]
  

• The undocumented ability to pass errors=None to SimpleTestCase.assertFormError() and assertFormsetError() is deprecated. Use errors=[] instead.

• django.contrib.sessions.serializers.PickleSerializer является устаревшим из-за риска удаленного выполнения кода.

• Использование QuerySet.iterator() в наборе запросов, который выполняет предварительную выборку связанных объектов без предоставления аргумента chunk_size, устарело. В старых версиях предварительная выборка не производилась. Предоставление значения для chunk_size означает, что дополнительный запрос на чанк, необходимый для предварительной выборки, желателен.

• Передача несохраненных экземпляров модели в связанные фильтры устарела. В Django 5.0 будет возникать исключение.

• created=True добавляется к сигнатуре RemoteUserBackend.configure_user(). Поддержка подклассов RemoteUserBackend, которые не принимают этот аргумент, устарела.

• Псевдоним django.utils.timezone.utc для datetime.timezone.utc устарел. Используйте datetime.timezone.utc напрямую.

• Передача объекта ответа и имени формы/формсета в SimpleTestCase.assertFormError() и assertFormsetError() устарела. Используйте:

  assertFormError(response.context['form_name'], …)
  assertFormsetError(response.context['formset_name'], …)
  

  или передать объект формы/formset напрямую.

• Недокументированный django.contrib.gis.admin.OpenLayersWidget является устаревшим.

• django.contrib.auth.hashers.CryptPasswordHasher устарел.

• Возможность передавать nulls_first=False или nulls_last=False в методы Expression.asc() и Expression.desc(), а также выражение OrderBy является устаревшей. Вместо этого используйте None.

• Шаблоны "django/forms/default.html" и "django/forms/formsets/default.html", которые являются прокси для шаблонов на основе таблиц, устарели. Вместо них используйте конкретный шаблон.

• Недокументированный метод LogoutView.get_next_page() переименован в get_success_url().