Django 4.0 release notes¶

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, а также подробный migration guide, показывающий, как перейти на новые 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 хешер пароля¶

Новый scrypt password hasher является более безопасным и рекомендуется вместо PBKDF2. Однако он не используется по умолчанию, так как требует OpenSSL 1.1+ и больше памяти.

Бэкэнд кэша Redis¶

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

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

Forms, Formsets, and ErrorList are now rendered using the template engine to enhance customization. See the new render(), get_context(), and template_name for Form and formset rendering for 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() теперь является fields вместо columns.

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() с пустым name теперь повышает ValueError вместо AssertionError.
• Вызов EmailMultiAlternatives.attach_alternative() или EmailMessage.attach() с недопустимыми аргументами content или mimetype теперь вызывает ValueError вместо AssertionError.
• assertHTMLEqual() больше не считает небулевый атрибут без значения равным атрибуту с тем же именем и значением.
• Тесты, которые не загружаются, например, из-за синтаксических ошибок, теперь всегда совпадают при использовании test --tag.
• Недокументированная функция django.contrib.admin.utils.lookup_needs_distinct() переименована в lookup_spawns_duplicates().
• Недокументированный метод 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 у метода private 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 для отслеживания необходимости отправки CSRF cookie. Это недокументированный, частный API.
• Недокументированная константа TRANSLATOR_COMMENT_MARK перенесена из django.template.base в django.utils.translation.template.
• Аргумент real_apps недокументированного метода django.db.migrations.state.ProjectState.__init__() теперь должен быть множеством, если он указан.
• Виджеты RadioSelect и CheckboxSelectMultiple теперь отображаются в тегах <div>, поэтому они более лаконично объявляются программами чтения с экрана. Если вам нужно прежнее поведение, override the widget template с соответствующим шаблоном из Django 3.2.
• Фильтр шаблонов floatformat больше не зависит от настройки USE_L10N и всегда возвращает локализованный вывод. Для отключения локализации используйте суффикс u.
• Значение по умолчанию параметра USE_L10N изменяется на True. Более подробную информацию см. в разделе Localization section выше.
• Как часть move to zoneinfo, django.utils.timezone.utc изменяется на псевдоним datetime.timezone.utc.
• Минимальная поддерживаемая версия asgiref увеличена с 3.3.2 до 3.4.1.

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

В рамках move to zoneinfo использование часовых поясов 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.

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

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

Обратите внимание, что файл 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 является устаревшим.
• В Django 5.0 протокол по умолчанию для карт сайта, построенных вне контекста запроса, изменится с 'http' на 'https'.
• Аргумент 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.