zoneinfo реализация часового пояса по умолчанию¶

zoneinfo стандартной библиотеки Python теперь является реализацией часового пояса по умолчанию в Django.

Это следующий шаг в переходе от использования pytz к использованию zoneinfo. Django 3.2 позволял использовать часовые пояса, отличные от pytz. Django 4.0 делает Zoneinfo реализацией по умолчанию. Поддержка pytz устарела и будет удалена в Django 5.0.

zoneinfo является частью стандартной библиотеки Python версии Python 3.9. Пакет backports.zoneinfo автоматически устанавливается вместе с Django, если вы используете Python 3.8.

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

Однако, если вы работаете с часовыми поясами, отличными от UTC, и используете API-интерфейсы pytz,normalize() и localize(), возможно, с настройкой TIME_ZONE, вам потребуется провести аудит вашего кода, поскольку pytz иzoneinfo не полностью эквивалентны.

Чтобы дать время для такого аудита, переходная настройка USE_DEPRECATED_PYTZ позволяет продолжать использовать pytz в течение цикла выпуска 4.x. Этот параметр будет удален в Django 5.0.

Кроме того, пакет pytz_deprecation_shim, созданный автором Zoneinfo, может использоваться для облегчения перехода с pytz. Этот пакет предоставляет прокладки, которые помогут вам безопасно удалить pytz, а также содержит подробное руководство по миграции, показывающее, как перейти на новые API zoneinfo.

Использование pytz_deprecation_shim и переходной настройки USE_DEPRECATED_PYTZ рекомендуется, если вам нужен путь постепенного обновления.

Функциональные уникальные ограничения¶

Новый *expressions позиционный аргумент UniqueConstraint() позволяет создавать функциональные уникальные ограничения для выражений и функций базы данных. Например:

from django.db import models
from django.db.models import UniqueConstraint
from django.db.models.functions import Lower


class MyModel(models.Model):
    first_name = models.CharField(max_length=255)
    last_name = models.CharField(max_length=255)

    class Meta:
        constraints = [
            UniqueConstraint(
                Lower("first_name"),
                Lower("last_name").desc(),
                name="first_last_name_unique",
            ),
        ]

Функциональные уникальные ограничения добавляются в модели с помощью опции Meta.constraints.

scrypt хэшер паролей¶

Новый хэшер паролей :ref:scrypt <scrypt-usage>` более безопасен и рекомендуется по сравнению с PBKDF2. Однако это не вариант по умолчанию, поскольку для него требуется OpenSSL 1.1+ и больше памяти.

Серверная часть кэша Redis¶

Новый механизм кэширования django.core.cache.backends.redis.RedisCache обеспечивает встроенную поддержку кэширования с помощью Redis. redis-py 3.0.0 или выше. Для получения более подробной информации см. документацию по кэшированию с помощью Redis в Django.

Рендеринг форм на основе шаблонов¶

Forms, Formsets и ErrorList теперь отображаются с использованием механизма шаблонов для улучшения настройки. См. новые render(), get_context() и template_name для Form и formset rendering для Formset.

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

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

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

• Методы DatabaseOperations.year_lookup_bounds_for_date_field() иyear_lookup_bounds_for_datetime_field() теперь принимают необязательный аргумент iso_year для поддержки границ для лет с нумерацией недель ISO-8601.

• Вторым аргументом методов DatabaseSchemaEditor._unique_sql() и _create_unique_sql() теперь являются поля вместо столбцы.

django.contrib.gis¶

• Поддержка PostGIS 2.3 удалена.

• Поддержка GDAL 2.0 и GEOS 3.5 удалена.

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

Поддержка исходной версии PostgreSQL 9.6 заканчивается в ноябре 2021 года. Django 4.0 поддерживает PostgreSQL 10 и выше.

Кроме того, минимальная поддерживаемая версия psycopg2 увеличена с 2.5.4 до 2.8.4, поскольку psycopg2 2.8.4 является первой версией, поддерживающей Python 3.8.

Прекращена поддержка Oracle 12.2 и 18c.¶

Восходящая поддержка Oracle 12.2 заканчивается в марте 2022 года, а Oracle 18c — в июне 2021 года. Django 3.2 будет поддерживаться до апреля 2024 года. Django 4.0 официально поддерживает Oracle 19c.

CSRF_TRUSTED_ORIGINS изменения¶

SecurityMiddleware больше не устанавливает заголовок X-XSS-Protection.¶

SecurityMiddleware больше не устанавливает заголовок X-XSS-Protection, если для параметра SECURE_BROWSER_XSS_FILTER установлено значение True. Настройка удалена.

Большинство современных браузеров не учитывают HTTP-заголовок X-XSS-Protection. Вы можете использовать Content-Security-Policy, не разрешая вместо этого сценарии unsafe-inline.

Если вы хотите поддерживать устаревшие браузеры и устанавливать заголовок, используйте эту строку в пользовательском промежуточном программном обеспечении:

response.headers.setdefault("X-XSS-Protection", "1; mode=block")

Изменения автодетектора миграций¶

Автодетектор миграций теперь использует состояния модели вместо классов модели. Кроме того, операции миграции для полей «ForeignKey» и «ManyToManyField» больше не указывают атрибуты, которые не были переданы в поля во время инициализации.

В качестве побочного эффекта запуск makemigrations может в некоторых случаях генерировать неактивные операции AlterField для полей ManyToManyField и ForeignKey.

Изменения DeleteView¶

DeleteView теперь использует FormMixin для обработки POST-запросов. Как следствие, любая пользовательская логика удаления в обработчиках delete() должна быть перенесена в form_valid() или в общий вспомогательный метод, если это необходимо.

Изменения в схеме именования таблиц и столбцов в Oracle¶

Django 4.0 случайно изменил схему именования таблиц и столбцов в Oracle. Это вызывает ошибки для моделей и полей с именами длиной более 30 символов. К сожалению, необходимо переименовать некоторые таблицы и столбцы Oracle. Используйте сценарий обновления в 33789 для создания операторов RENAME для изменения схемы именования.

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

• Поддержка cx_Oracle < 7.0 удалена.

• Чтобы разрешить обслуживание сайта Django по подпути без изменения значения STATIC_URL, из этого параметра (теперь 'static/') в шаблоне startproject по умолчанию удаляется начальная косая черта.

• Метод AdminSite для представления index администратора больше не украшается never_cache при прямом доступе, а не через рекомендуемое свойство AdminSite.urls или метод AdminSite.get_urls().

• Неподдерживаемые операции с фрагментированным набором запросов теперь вызывают ошибку TypeError вместо AssertionError.

• Недокументированная функция django.test.runner.reorder_suite() переименована в reorder_tests(). Теперь он принимает итерацию тестов, а не набор тестов, и возвращает итератор тестов.

• Вызов FileSystemStorage.delete() с пустым именем теперь вызывает ValueError вместо AssertionError.

• Вызов EmailMultiAlternatives.attach_alternative() или EmailMessage.attach() с недопустимыми аргументами content или mimetype теперь вызывает ValueError вместо AssertionError.

• assertHTMLEqual() больше не рассматривает нелогический атрибут без значения, равного атрибуту с тем же именем и значением.

• Тесты, которые не загружаются, например, из-за синтаксических ошибок, теперь всегда совпадают при использовании test --tag.

• Недокументированная функция django.contrib.admin.utils.lookup_needs_distinct() переименована вlookup_spawns_duulates().

• Недокументированный метод HttpRequest.get_raw_uri() удален. Подходящей альтернативой может быть метод HttpRequest.build_absolute_uri().

• Аргумент object недокументированных методов ModelAdmin.log_addition(), log_change() и log_deletion() переименован в obj.

• RssFeed, Atom1Feed и их подклассы теперь выдают элементы без содержимого в виде самозакрывающихся тегов.

• NodeList.render() больше не преобразует вывод метода render() для отдельных узлов в строку. Node.render() всегда должен возвращать строку, как описано в документации.

• Свойствоwhere_class`` django.db.models.sql.query.Query`` и аргумент where_class частного метода get_extra_restriction() ForeignObject и ForeignObjectRel удалены. При необходимости вместо этого инициализируйте django.db.models.sql.where.WhereNode.

• Аргумент filter_clause недокументированного метода Query.add_filter() заменяется двумя позиционными аргументами filter_lhs и filter_rhs.

• CsrfViewMiddleware теперь использует request.META['CSRF_COOKIE_NEEDS_UPDATE'] вместо request.META['CSRF_COOKIE_USED'], request.csrf_cookie_needs_reset, и response.csrf_cookie_set для отслеживания того, следует ли отправлять файл cookie CSRF. Это недокументированный частный API.

• Недокументированная константа TRANSLATOR_COMMENT_MARK перемещена из django.template.base в django.utils.translation.template.

• Аргумент real_apps недокументированного метода django.db.migrations.state.ProjectState.__init__() теперь должен быть установлен, если он указан.

• Виджеты RadioSelect и CheckboxSelectMultiple теперь отображаются в тегах <div>, поэтому программы чтения с экрана объявляют их более кратко. Если вам нужно предыдущее поведение, переопределите шаблон виджета соответствующим шаблоном из Django 3.2.

• Фильтр шаблона floatformat больше не зависит от настройки USE_L10N и всегда возвращает локализованный вывод. Используйте суффикс u, чтобы отключить локализацию.

• Значение по умолчанию параметра USE_L10N изменено на True. Дополнительную информацию см. в разделе «Локализация <use_l10n_deprecation>» выше.

• В рамках move tozoneinfo django.utils.timezone.utc заменяется на псевдоним datetime.timezone.utc.

• Минимальная поддерживаемая версия asgiref увеличена с 3.3.2 до 3.4.1.

Использование часовых поясов pytz¶

В рамках перехода на Zoneinfo <whats-new-4.0> использование часовых поясов pytz устарело.

Соответственно, аргументы is_dst для следующих команд также считаются устаревшими:

• django.db.models.query.QuerySet.datetimes()

• django.db.models.functions.Trunc()

• django.db.models.functions.TruncSecond()

• django.db.models.functions.TruncMinute()

• django.db.models.functions.TruncHour()

• django.db.models.functions.TruncDay()

• django.db.models.functions.TruncWeek()

• django.db.models.functions.TruncMonth()

• django.db.models.functions.TruncQuarter()

• django.db.models.functions.TruncYear()

• django.utils.timezone.make_aware()

Поддержка использования pytz будет удалена в Django 5.0.

Поддержка часовых поясов¶

Чтобы следовать передовой практике, значение по умолчанию параметра USE_TZ изменится с False на True, а поддержка часовых поясов будет включена по умолчанию в Django 5.0.

Обратите внимание, что файл settings.py по умолчанию, созданный django-admin startproject, включает USE_TZ = True, начиная с Django 1.4.

Вы можете установить для USE_TZ значение False в настройках вашего проекта, прежде чем отказаться от участия.

Локализация¶

Чтобы следовать передовой практике, значение по умолчанию параметра USE_L10N изменено с False на True.

Более того, USE_L10N устарел с этой версии. Начиная с Django 5.0, по умолчанию любая дата или число, отображаемые Django, будут локализованы.

Тег {% localize %} и фильтры localize/ unlocalize по-прежнему будут учитываться Django.

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

• Тестовая настройка SERIALIZE устарела, поскольку ее можно получить из databases с включенной опцией serialized_rollback.

• Недокументированный модуль django.utils.baseconv устарел.

• Недокументированный модуль django.utils.datetime_safe устарел.

• Протокол карты сайта по умолчанию для карт сайта, созданных вне контекста запроса, изменится с «http» на «https» в Django 5.0.

• Аргумент extra_tests для DiscoverRunner.build_suite() и DiscoverRunner.run_tests() устарел.

• Агрегаты ArrayAgg, JSONBAgg и StringAgg будут возвращать None, если вместо [], [], нет строк, и '' соответственно в Django 5.0. Если вам нужно предыдущее поведение, явно установите для default значение Value([]), Value('[]') или Value('').

• Классы django.contrib.gis.admin.GeoModelAdmin и OSMGeoAdmin устарели. Вместо этого используйте ModelAdmin и GISModelAdmin.

• Поскольку рендеринг формы теперь использует механизм шаблонов, недокументированный вспомогательный метод BaseForm._html_output() считается устаревшим.

• Возможность возвращать str из ErrorList и ErrorDict устарела. Ожидается, что эти методы возвращают SafeString.