Фасетные фильтры в админке¶

Количество фасетов теперь отображается для примененных фильтров в списке изменений администратора при включении через пользовательский интерфейс. Это поведение можно изменить с помощью нового атрибута ModelAdmin.show_facets. Для получения дополнительной информации см. Фасеты.

Упрощенные шаблоны для отрисовки полей формы.¶

В Django 5.0 представлена ​​концепция группы полей и шаблонов групп полей. Это упрощает отрисовку связанных элементов поля формы Django, таких как его метка, виджет, текст справки и ошибки.

Например, шаблон ниже:

<form>
...
<div>
  {{ form.name.label_tag }}
  {% if form.name.help_text %}
    <div class="helptext" id="{{ form.name.auto_id }}_helptext">
      {{ form.name.help_text|safe }}
    </div>
  {% endif %}
  {{ form.name.errors }}
  {{ form.name }}
  <div class="row">
    <div class="col">
      {{ form.email.label_tag }}
      {% if form.email.help_text %}
        <div class="helptext" id="{{ form.email.auto_id }}_helptext">
          {{ form.email.help_text|safe }}
        </div>
      {% endif %}
      {{ form.email.errors }}
      {{ form.email }}
    </div>
    <div class="col">
      {{ form.password.label_tag }}
      {% if form.password.help_text %}
        <div class="helptext" id="{{ form.password.auto_id }}_helptext">
          {{ form.password.help_text|safe }}
        </div>
      {% endif %}
      {{ form.password.errors }}
      {{ form.password }}
    </div>
  </div>
</div>
...
</form>

Теперь можно упростить до:

<form>
...
<div>
  {{ form.name.as_field_group }}
  <div class="row">
    <div class="col">{{ form.email.as_field_group }}</div>
    <div class="col">{{ form.password.as_field_group }}</div>
  </div>
</div>
...
</form>

as_field_group() отображает поля с помощью шаблона "django/forms/field.html" по умолчанию и может быть настроен для каждого проекта, для каждого поля или для каждого запроса. См. Многоразовые шаблоны групп полей.

Значения по умолчанию, вычисленные базой данных¶

Новый параметр Field.db_default устанавливает значение по умолчанию, вычисленное базой данных. Например:

from django.db import models
from django.db.models.functions import Now, Pi


class MyModel(models.Model):
    age = models.IntegerField(db_default=18)
    created = models.DateTimeField(db_default=Now())
    circumference = models.FloatField(db_default=2 * Pi())

Поле модели, созданное базой данных¶

Новый GeneratedField позволяет создавать столбцы, генерируемые базой данных. Это поле можно использовать во всех поддерживаемых базах данных для создания поля, которое всегда вычисляется на основе других полей. Например:

from django.db import models
from django.db.models import F


class Square(models.Model):
    side = models.IntegerField()
    area = models.GeneratedField(
        expression=F("side") * F("side"),
        output_field=models.BigIntegerField(),
        db_persist=True,
    )

Дополнительные возможности для объявления выбора полей¶

Field.choices (для полей модели) и ChoiceField.choices (для полей формы) обеспечивают большую гибкость при объявлении их значений. В предыдущих версиях Django choices должен был быть либо списком из двух кортежей, либо подклассом Типы перечислений, но последний требовал доступа к атрибуту .choices для предоставления значений в ожидаемой форме:

from django.db import models

Medal = models.TextChoices("Medal", "GOLD SILVER BRONZE")

SPORT_CHOICES = [
    ("Martial Arts", [("judo", "Judo"), ("karate", "Karate")]),
    ("Racket", [("badminton", "Badminton"), ("tennis", "Tennis")]),
    ("unknown", "Unknown"),
]


class Winner(models.Model):
    name = models.CharField(...)
    medal = models.CharField(..., choices=Medal.choices)
    sport = models.CharField(..., choices=SPORT_CHOICES)

В Django 5.0 добавлена ​​поддержка принятия сопоставления или вызываемого объекта вместо итерируемого, а также больше не требуется непосредственное использование .choices для расширения типов перечисления:

from django.db import models

Medal = models.TextChoices("Medal", "GOLD SILVER BRONZE")

SPORT_CHOICES = {  # Using a mapping instead of a list of 2-tuples.
    "Martial Arts": {"judo": "Judo", "karate": "Karate"},
    "Racket": {"badminton": "Badminton", "tennis": "Tennis"},
    "unknown": "Unknown",
}


def get_scores():
    return [(i, str(i)) for i in range(10)]


class Winner(models.Model):
    name = models.CharField(...)
    medal = models.CharField(..., choices=Medal)  # Using `.choices` not required.
    sport = models.CharField(..., choices=SPORT_CHOICES)
    score = models.IntegerField(choices=get_scores)  # A callable is allowed.

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

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

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

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

• Для DatabaseFeatures.supports_expression_defaults должно быть установлено значение False, если база данных не поддерживает использование функций базы данных по умолчанию.

• Для параметра DatabaseFeatures.supports_default_keyword_in_insert должно быть установлено значение False, если база данных не поддерживает ключевое слово DEFAULT в запросах INSERT.

• Для параметра DatabaseFeatures.supports_default_keyword_in_bulk_insert должно быть установлено значение False, если база данных не поддерживает ключевое слово DEFAULT в массовых запросах INSERT.

django.contrib.gis¶

• Поддержка GDAL 2.2 и 2.3 удалена.

• Поддержка GEOS 3.6 и 3.7 удалена.

django.contrib.sitemaps¶

• Функция django.contrib.sitemaps.ping_google() и команда управления ping_google удалены, поскольку конечная точка ping Google Sitemaps устарела и будет удалена в январе 2024 года.

• Класс исключений django.contrib.sitemaps.SitemapNotFound удален.

Прекращена поддержка MySQL <8.0.11.¶

Поддержка предварительных выпусков серии MySQL 8.0.x удалена. Django 5.0 поддерживает MySQL 8.0.11 и выше.

Использование create_defaults__exact теперь может потребоваться с QuerySet.update_or_create()¶

QuerySet.update_or_create() теперь поддерживает параметр create_defaults. Как следствие, любые модели, имеющие поле с именем create_defaults, которое используется с update_or_create(), должны указывать это поле в поиске с помощью create_defaults__exact.

Миграция существующего UUIDField в MariaDB 10.7+¶

В MariaDB 10.7+ UUIDField теперь создается как столбец UUID, а не столбец CHAR(32). Как следствие, любой UUIDField, созданный в Django < 5.0, должен быть заменен подклассом UUIDField, поддерживаемым CHAR(32):

class Char32UUIDField(models.UUIDField):
    def db_type(self, connection):
        return "char(32)"

    def get_db_prep_value(self, value, connection, prepared=False):
        value = super().get_db_prep_value(value, connection, prepared)
        if value is not None:
            value = value.hex
        return value

Например:

class MyModel(models.Model):
    uuid = models.UUIDField(primary_key=True, default=uuid.uuid4)

Должно стать:

class Char32UUIDField(models.UUIDField): ...


class MyModel(models.Model):
    uuid = Char32UUIDField(primary_key=True, default=uuid.uuid4)

Запуск команды makemigrations создаст миграцию, содержащую бездействующую операцию AlterField.

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

• Аргумент экземпляра недокументированного метода BaseModelFormSet.save_existing() переименован в obj.

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

• Целочисленные поля теперь проверяются как 64-битные целые числа в SQLite, чтобы соответствовать поведению sqlite3.

• Недокументированный атрибут Query.annotation_select_mask изменен с набора строк на упорядоченный список строк.

• ImageField.update_dimension_fields() больше не вызывается по сигналу post_init, если width_field и height_field не установлены.

• Now Функция базы данных теперь использует LOCALTIMESTAMP вместо CURRENT_TIMESTAMP в Oracle.

• AdminSite.site_header теперь отображается в теге <div> вместо <h1>. Пользователи программ чтения с экрана полагаются на элементы заголовков для навигации по странице. Наличие двух элементов <h1> сбивало с толку, а заголовок сайта был бесполезен, поскольку он повторяется на всех страницах.

• Чтобы улучшить доступность, основная область содержимого администратора и область содержимого заголовка теперь отображаются в тегах <main> и <header> вместо <div>.

• В базах данных без встроенной поддержки оператора SQL XOR оператор ^ в качестве исключающего оператора или (XOR) теперь возвращает строки, которым соответствует нечетное количество операндов, а не ровно один операнд. Это соответствует поведению MySQL, MariaDB и Python.

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

• Минимальная поддерживаемая версия Selenium увеличена с 3.8.0 до 4.8.0.

• Исключения AlreadyRegistered и NotRegistered перенесены из django.contrib.admin.sites в django.contrib.admin.Exceptions.

• Минимальная поддерживаемая версия SQLite увеличена с 3.21.0 до 3.27.0.

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

• Выполнение SQL-запросов до полного заполнения реестра приложений теперь вызывает RuntimeWarning.

• BadRequest вызывается для запросов в кодировке, отличной от UTF-8, с типом контента application/x-www-form-urlencoded. Дополнительную информацию см. в RFC 1866.

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

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

• Фильтрация наборов запросов по переполнению целочисленных значений теперь всегда возвращает пустой набор запросов. Как следствие, вам может потребоваться использовать ExpressionWrapper() для явного переноса арифметики <using-f-with-annotations>` против целочисленных полей в таких случаях.

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

• Средства визуализации переходных форм DjangoDivFormRenderer и Jinja2DivFormRenderer устарели.

• Передача позиционных аргументов name и violation_error_message в BaseConstraint устарела в пользу аргументов, содержащих только ключевые слова.

• request добавляется в подпись ModelAdmin.lookup_allowed(). Поддержка подклассов ModelAdmin, которые не принимают этот аргумент, устарела.

• Метод get_joining_columns() для ForeignObject и ForeignObjectRel устарел. Начиная с Django 6.0, django.db.models.sql.datastructures.Join больше не будет использовать get_joining_columns(). Вместо этого подклассы должны реализовать get_joining_fields().

• Метод «ForeignObject.get_reverse_joining_columns()» устарел.

• Схема по умолчанию для form.URLField изменится с «http» на «https» в Django 6.0. Установите для переходного параметра FORMS_URLFIELD_ASSUME_HTTPS значение True, чтобы принять использование https во время цикла выпуска Django 5.x.

• Переходная настройка FORMS_URLFIELD_ASSUME_HTTPS устарела.

• Поддержка вызова format_html() без передачи аргументов или kwargs устарела.

• Поддержка cx_Oracle устарела в пользу драйвера Python`oracledb`_ 1.3.2+.

• DatabaseOperations.field_cast_sql() устарел в пользу DatabaseOperations.lookup_cast(). Начиная с Django 6.0, BuiltinLookup.process_lhs() больше не будет вызывать field_cast_sql(). Вместо этого сторонние базы данных должны реализовывать lookup_cast().

• Метакласс django.db.models.enums.ChoicesMeta переименован в ChoicesType.

• Метод Prefetch.get_current_queryset() устарел.

• Метод get_prefetch_queryset() для связанных менеджеров и дескрипторов устарел. Начиная с Django 6.0, get_prefetcher() и prefetch_related_objects() больше не будут возвращаться к get_prefetch_queryset(). Вместо этого подклассы должны реализовать get_prefetch_querysets().