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

Подклассы представления теперь могут определять обработчики асинхронных методов 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 и интеграцией асинхронных драйверов базы данных. Новый интерфейс асинхронного набора запросов в настоящее время инкапсулирует необходимые операции sync_to_async() и позволит вашему коду использовать преимущества асинхронной поддержки ORM по мере ее развития.

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

Проверка ограничений¶

Проверьте, unique и exclusion ограничения, определенные в Meta.constraints Параметры теперь проверяются во время проверки модели.

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

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

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

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

Подробную информацию смотрите в разделе «Формы» (ниже)<forms-4.1>.

Настройка CSRF_COOKIE_MASKED¶

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

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

Этот параметр устарел с этого выпуска и будет удален в Django 5.0.

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

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

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

• BaseDatabaseFeatures.has_case_insensitivity_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 и возвращают 2-кортеж, содержащий некоторый 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'], а пользователь ищет 'Джамал 17', родительские строки будут возвращены только в том случае, если существует связь с некоторым 17-летним ребенком по имени Джамал, а не возвращаются также родители, у которых просто есть младший или старший ребенок по имени Джамал в дополнение к какому-то другому 17-летнему ребенку.

Дополнительную информацию об этой разнице можно найти в теме Фильтрация по связям многие-ко-многим. В Django 4.0 и более ранних версиях get_search_results() следовал второму примеру запроса, но это недокументированное поведение приводило к запросам с чрезмерным количеством соединений.

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

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

Разнообразный¶

• Связанные менеджеры для ForeignKey, ManyToManyField и GenericRelation теперь кэшируются в экземпляре Model, которому они принадлежат. Это изменение было отменено в Django 4.1.2.

• DiscoverRunner теперь возвращает ненулевой код ошибки при неожиданных успехах тестов, отмеченных unittest.expectedFailure().

• CsrfViewMiddleware больше не маскирует файл cookie CSRF, как это делает токен 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() заменяется на исключение.

• Аргумент 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.

• Команда makemessages больше не изменяет файлы .po, если они обновлены. В старых версиях POT-Creation-Date всегда обновлялся.

Выйти через GET¶

Выход из системы с помощью запросов GET к встроенному представлению выхода из системы устарел. Вместо этого используйте запросы 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;
}

Разнообразный¶

• Контекст для шаблонов индекса карты сайта в виде плоского списка URL-адресов устарел. Пользовательские шаблоны индексов карты сайта должны быть обновлены для скорректированных контекстных переменных, ожидая список объектов с 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"], ...)
  

  или вместо этого передайте объект формы/набора форм напрямую.

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

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

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

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

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