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

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

Подклассы представления теперь могут определять асинхронные обработчики 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!")

Более подробную информацию см. в разделе Асинхронные представления на основе классов.

Асинхронный интерфейс 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.

Эта настройка устарела в этом выпуске и будет удалена в 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.

Прекращена поддержка PostgreSQL 10¶

Поддержка PostgreSQL 10 заканчивается в ноябре 2022 года. Django 4.1 поддерживает PostgreSQL 11 и выше.

Прекращена поддержка 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(
                      ...
                  ),
              ],
          ),
      ]
  

• Недокументированная возможность передавать errors=None в SimpleTestCase.assertFormError() и assertFormsetError() устарела. Вместо этого используйте errors=[].

• 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().