{% 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 также представлена ​​поддержка пула соединений <postgresql-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.

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

• Методы 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 устарел в пользу условия.

• Недокументированное свойство OS_OPEN_FLAGS FileSystemStorage устарело. Чтобы разрешить перезапись файлов в хранилище, вместо этого установите для новой опции allow_overwrite значение True.

• Метод get_cache_name() в FieldCacheMixin устарел в пользу кэшированного свойства cache_name.