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

{% querystring %} тег шаблона¶

В Django 5.1 введен тег шаблона {% querystring %}, упрощающий изменение параметров запроса в URL-адресах и упрощающий создание ссылок, которые поддерживают существующие параметры запроса при добавлении или изменении определенных.

Например, разбивка навигации по страницам и строки запросов в шаблонах могут быть громоздкими. Рассмотрим этот фрагмент шаблона, который динамически генерирует URL-адрес для перехода к следующей странице в представлении с разбивкой на страницы:

{# Linebreaks added for readability, this should be one, long line. #}
<a href="?{% for key, values in request.GET.iterlists %}
  {% if key != "page" %}
    {% for value in values %}
      {{ key }}={{ value }}&amp;
    {% endfor %}
  {% endif %}
{% endfor %}page={{ page.next_page_number }}">Next page</a>

При переключении на использование этого нового тега шаблона вышеуказанное волшебным образом становится:

<a href="{% querystring page=page.next_page_number %}">Next page</a>

Пулы подключений PostgreSQL¶

В Django 5.1 также добавлена поддержка connection pool для PostgreSQL. Поскольку время установления нового соединения может быть относительно длительным, поддержание соединений открытыми может сократить задержку.

Чтобы использовать пул соединений с psycopg, вы можете установить параметр "pool" внутри OPTIONS в качестве параметра, который будет передаваться в ConnectionPool, или в True для используйте значения ConnectionPool по умолчанию:

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql",
        # ...
        "OPTIONS": {
            "pool": {
                "min_size": 2,
                "max_size": 4,
                "timeout": 10,
            }
        },
    },
}

Промежуточное программное обеспечение, требующее проверки подлинности по умолчанию¶

Новый LoginRequiredMiddleware перенаправляет все запросы, не прошедшие проверку подлинности, на страницу входа в систему. Просмотры могут разрешить запросы, не прошедшие проверку подлинности, с помощью нового login_not_required() декоратора.

LoginRequiredMiddleware соответствует значениям login_url и redirect_field_name, заданным с помощью login_required() декоратора, но не поддерживает установку login_url или redirect_field_name с помощью LoginRequiredMixin.

Чтобы включить это, добавьте "django.contrib.auth.middleware.LoginRequiredMiddleware" к вашим настройкам MIDDLEWARE.

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

django.contrib.gis¶

• Поддержка PostGIS 2.5 удалена.
• Поддержка PROJ < 6 удалена.
• Поддержка GDAL 2.4 удалена.
• GeoIP2 больше не открываются базы данных по городам и странам, если указан путь к каталогу, предпочтение отдается базе данных по городам, если она доступна. База данных по странам является подмножеством базы данных по городам, и обе они обычно не требуются. Если вам требуется использовать базу данных по странам, находящуюся в том же каталоге, что и база данных по городам, явно передайте конструктору путь к базе данных по странам.

Отменена поддержка MariaDB 10.4¶

Предварительная поддержка MariaDB 10.4 заканчивается в июне 2024 года. Django 5.1 поддерживает MariaDB 10.5 и выше.

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

Предварительная поддержка PostgreSQL 12 завершится в ноябре 2024 года. Django 5.1 поддерживает PostgreSQL 13 и выше.

Разное¶

• Чтобы улучшить доступность, фильтр списка изменений администратора теперь отображается в теге <nav> вместо <div>.
• Чтобы улучшить доступность, нижний колонтитул администратора теперь отображается в виде тега <footer> вместо тега <div>, а также перемещен под элемент <div id="main">.
• В целях улучшения доступности расширяемый виджет, используемый для ModelAdmin.fieldsets и InlineModelAdmin.fieldsets, когда набор полей имеет имя и используется класс collapse, теперь включает в себя <details> и <summary> элементы.
• Файл JavaScript collapse.js удален, так как он больше не нужен на сайте администратора Django.
• SimpleTestCase.assertURLEqual() и assertInHTML() теперь добавьте ": " к msg_prefix. Это согласуется с поведением других утверждений.
• django.utils.text.Truncator используется в truncatechars_html и truncatewords_html фильтрах шаблонов, теперь используются подклассы html.parser.HTMLParser. Это обеспечивает более надежную и быструю работу, но выходные данные могут незначительно отличаться.
• Недокументированная функция django.urls.converters.get_converter() удалена.
• Минимальная поддерживаемая версия SQLite увеличена с 3.27.0 до 3.31.0.
• FileField теперь вызывает FieldError при сохранении файла без name.
• ImageField.update_dimension_fields(force=True) больше не вызывается после сохранения изображения в хранилище. Если серверная часть хранилища изменит размеры изображений, width_field и height_field не будут соответствовать ширине и высоте изображения.
• Минимальная поддерживаемая версия asgiref увеличена с 3.7.0 до 3.8.1.
• Для повышения производительности действие администратора delete_selected теперь использует QuerySet.bulk_create() при создании нескольких объектов LogEntry. В результате сигналы pre_save и post_save для LogEntry не отправляются при удалении нескольких объектов с помощью этого действия администратора.

Разное¶

• Методы ModelAdmin.log_deletion() и LogEntryManager.log_action() считаются устаревшими. Вместо них подклассы должны реализовывать ModelAdmin.log_deletions() и LogEntryManager.log_actions().
• Недокументированная функция django.utils.itercompat.is_iterable() и модуль django.utils.itercompat являются устаревшими. Вместо этого используйте isinstance(..., collections.abc.Iterable).
• Метод django.contrib.gis.geoip2.GeoIP2.coords() признан устаревшим. Вместо него используйте django.contrib.gis.geoip2.GeoIP2.lon_lat().
• Метод django.contrib.gis.geoip2.GeoIP2.open() признан устаревшим. Вместо него используйте конструктор GeoIP2.
• Передача позиционных аргументов в Model.save() и Model.asave() не рекомендуется в пользу аргументов, содержащих только ключевые слова.
• Установка django.contrib.gis.gdal.OGRGeometry.coord_dim не рекомендуется. Вместо этого используйте set_3d().
• Переопределение существующих преобразователей с помощью django.urls.register_converter() не рекомендуется.
• Аргумент ключевого слова check в CheckConstraint устарел в пользу condition.
• Недокументированное свойство OS_OPEN_FLAGS в FileSystemStorage не рекомендуется. Чтобы разрешить перезапись файлов в хранилище, установите для нового параметра allow_overwrite значение True.
• Метод get_cache_name() из FieldCacheMixin устарел в пользу кэшированного свойства cache_name.