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

Автоматическое обнаружение AppConfig¶

Большинство подключаемых приложений определяют подкласс AppConfig в подмодуле apps.py. Многие определяют переменную default_app_config, указывающую на этот класс в своем __init__.py.

Когда подмодуль apps.py существует и определяет единственный подкласс AppConfig, Django теперь использует эту конфигурацию автоматически, поэтому вы можете удалить default_app_config.

default_app_config позволил объявлять только путь приложения в INSTALLED_APPS (например, 'django.contrib.admin'), а не путь конфигурации приложения (например, 'django.contrib.admin.apps.AdminConfig'). Это было введено для обратной совместимости с первым стилем, с намерением перевести экосистему на второй, но переход не произошел.

С автоматическим обнаружением AppConfig, default_app_config больше не нужен. Как следствие, он устарел.

Подробную информацию см. в разделе Настройка приложений.

Настройка типа автоматически создаваемых первичных ключей¶

При определении модели, если ни одно поле в модели не определено с помощью primary_key=True, добавляется неявный первичный ключ. Тип этого неявного первичного ключа теперь можно контролировать с помощью параметра DEFAULT_AUTO_FIELD и атрибута AppConfig.default_auto_field. Больше нет необходимости переопределять первичные ключи во всех моделях.

В соответствии с историческим поведением, значение по умолчанию для DEFAULT_AUTO_FIELD равно AutoField. Начиная с версии 3.2 новые проекты создаются с DEFAULT_AUTO_FIELD, установленным на BigAutoField. Также, новые приложения создаются с AppConfig.default_auto_field, установленным в BigAutoField. В будущем выпуске Django значение по умолчанию DEFAULT_AUTO_FIELD будет изменено на BigAutoField.

Чтобы избежать нежелательных миграций в будущем, либо явно установите DEFAULT_AUTO_FIELD в AutoField:

DEFAULT_AUTO_FIELD = "django.db.models.AutoField"

или настроить его для каждого приложения:

from django.apps import AppConfig


class MyAppConfig(AppConfig):
    default_auto_field = "django.db.models.AutoField"
    name = "my_app"

или по отдельным моделям:

from django.db import models


class MyModel(models.Model):
    id = models.AutoField(primary_key=True)

В преддверии изменения значения по умолчанию, проверка системы выдаст предупреждение, если у вас нет явной настройки для DEFAULT_AUTO_FIELD.

При изменении значения DEFAULT_AUTO_FIELD в настоящее время не могут быть созданы миграции для первичного ключа существующих автоматически создаваемых сквозных таблиц. Подробнее о миграции таких таблиц см. в документации DEFAULT_AUTO_FIELD.

Функциональные индексы¶

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

from django.db import models
from django.db.models import F, Index, Value
from django.db.models.functions import Lower, Upper


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

    class Meta:
        indexes = [
            Index(
                Lower("first_name"),
                Upper("last_name").desc(),
                name="first_last_name_idx",
            ),
            Index(
                F("height") / (F("weight") + Value(5)),
                name="calc_idx",
            ),
        ]

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

pymemcache поддержка¶

Новый бэкенд кэша django.core.cache.backends.memcached.PyMemcacheCache позволяет использовать библиотеку pymemcache для memcached. Требуется версия pymemcache 3.4.0 или выше. Более подробную информацию можно найти в documentation on caching in Django.

Новые декораторы для сайта администратора¶

Новый декоратор display() позволяет легко добавлять опции к пользовательским функциям отображения, которые могут использоваться с list_display или readonly_fields.

Аналогично, новый декоратор action() позволяет легко добавлять опции к функциям действия, которые могут быть использованы с actions.

Преимущество использования декоратора @display заключается в том, что теперь можно использовать декоратор @property, когда необходимо указать атрибуты пользовательского метода. До этого необходимо было использовать функцию property() после присвоения методу необходимых атрибутов.

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

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

API бэкенда базы данных¶

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

• Новое свойство DatabaseFeatures.introspected_field_types заменяет эти функции:
  • can_introspect_autofield
  • can_introspect_big_integer_field
  • can_introspect_binary_field
  • can_introspect_decimal_field
  • can_introspect_duration_field
  • can_introspect_ip_address_field
  • can_introspect_positive_integer_field
  • can_introspect_small_integer_field
  • can_introspect_time_field
  • introspected_big_auto_field_type
  • introspected_small_auto_field_type
  • introspected_boolean_field_type
• Чтобы включить поддержку покрывающих индексов (Index.include) и покрывающих уникальных ограничений (UniqueConstraint.include), установите DatabaseFeatures.supports_covering_indexes на True.
• Бэкенды баз данных сторонних производителей должны реализовать поддержку коллаций баз данных столбцов на CharFields и TextFields или установить DatabaseFeatures.supports_collation_on_charfield и DatabaseFeatures.supports_collation_on_textfield на False. Если недетерминированные колляции не поддерживаются, установите supports_non_deterministic_collations в False.
• DatabaseOperations.random_function_sql() удаляется в пользу новой функции базы данных Random.
• DatabaseOperations.date_trunc_sql() и DatabaseOperations.time_trunc_sql() теперь принимают необязательный аргумент tzname для усечения в определенном часовом поясе.
• DatabaseClient.runshell() теперь из метода DatabaseClient.settings_to_cmd_args_env() получает аргументы и необязательный словарь с переменными окружения для базового клиента командной строки. Бэкенды баз данных сторонних производителей должны реализовать DatabaseClient.settings_to_cmd_args_env() или переопределить DatabaseClient.runshell().
• Бэкенды баз данных сторонних производителей должны реализовать поддержку функциональных индексов (Index.expressions) или установить DatabaseFeatures.supports_expression_indexes в False. Если COLLATE не является частью оператора CREATE INDEX, установите DatabaseFeatures.collate_as_index_expression в True.

django.contrib.admin¶

• Ссылки пагинации в админке теперь 1-индексируются вместо 0-индексируемых, т.е. строка запроса для первой страницы ?p=1 вместо ?p=0.
• Новое представление для администраторов «catch-all view» будет нарушать шаблоны URL, направленные после URL-адресов администраторов и соответствующие префиксу URL-адреса администратора. Вы можете либо скорректировать порядок URL, либо, если необходимо, установить AdminSite.final_catch_all_view на False, отключив представление catch-all. Более подробную информацию см. в разделе Что нового в Django 3.2.
• Минифицированные файлы JavaScript больше не включаются в админку. Если вам требуется минифицировать эти файлы, воспользуйтесь сторонним приложением или внешним инструментом сборки. Минифицированные вендорные файлы JavaScript, упакованные с администратором (например, jquery.min.js), по-прежнему включены.
• ModelAdmin.prepopulated_fields больше не удаляет английские стоп-слова, такие как 'a' или 'an'.

django.contrib.gis¶

• Удалена поддержка PostGIS 2.2.
• Бэкэнд Oracle теперь клонирует полигоны (и коллекции геометрии, содержащие полигоны) перед их переориентацией и сохранением в базе данных. Они больше не мутируют на месте. Вы можете заметить это, если используете полигоны после сохранения модели.

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

Поддержка PostgreSQL 9.5 заканчивается в феврале 2021 года. Django 3.2 поддерживает PostgreSQL 9.6 и выше.

Прекращена поддержка MySQL 5.6¶

Окончание поддержки MySQL 5.6 приходится на апрель 2021 года. Django 3.2 поддерживает MySQL 5.7 и выше.

Разное¶

• Django теперь поддерживает не``pytz`` часовые пояса, например, модуль zoneinfo в Python 3.9+ и его бэкпорт.

• Недокументированный метод SpatiaLiteOperations.proj4_version() переименован в proj_version().

• slugify() теперь удаляет ведущие и последующие тире и знаки подчеркивания.

• Фильтры шаблонов intcomma и intword больше не зависят от настройки USE_L10N.

• Удалена поддержка argon2-cffi < 19.1.0.

• Ключи кэша больше не включают язык, когда интернационализация отключена (USE_I18N = False), а локализация включена (USE_L10N = True). После обновления до Django 3.2 в таких конфигурациях первый запрос к любому ранее кэшированному значению будет пропуском кэша.

• ForeignKey.validate() теперь использует _base_manager, а не _default_manager для проверки существования связанных экземпляров.

• Когда приложение определяет подкласс AppConfig в подмодуле apps.py, Django теперь использует эту конфигурацию автоматически, даже если она не включена с помощью default_app_config. Установите default = False в подклассе AppConfig, если вам нужно предотвратить такое поведение. Более подробную информацию смотрите в Что нового в Django 3.2.

• Инстанцирование абстрактной модели теперь вызывает TypeError.

• Аргументы ключевых слов в setup_databases() теперь только для ключевых слов.

• Недокументированная функция django.utils.http.limited_parse_qsl() удалена. Вместо нее используйте urllib.parse.parse_qsl().

• django.test.utils.TestContextDecorator теперь использует addCleanup(), чтобы очистка, зарегистрированная в методе setUp(), вызывалась перед TestContextDecorator.disable().

• SessionMiddleware теперь вызывает исключение SessionInterrupted вместо SuspiciousOperation, когда сессия уничтожается в параллельном запросе.

• Оператор равенства django.db.models.Field теперь правильно различает наследуемые экземпляры полей в разных моделях. Кроме того, теперь определено упорядочивание таких полей.

• Недокументированная функция django.core.files.locks.lock() теперь возвращает False, если файл не может быть заблокирован, вместо того, чтобы вызывать BlockingIOError.

• Механизм сброса пароля теперь аннулирует токены при изменении электронной почты пользователя.

• Команда makemessages больше не обрабатывает неверные локали, указанные с помощью опции makemessages --locale, если они содержат дефисы ('-').

• Поле формы django.contrib.auth.forms.ReadOnlyPasswordHashField теперь по умолчанию disabled. Поэтому UserChangeForm.clean_password() больше не требуется для возврата начального значения.

• Операции кэширования cache.get_many(), get_or_set(), has_key(), incr(), decr(), incr_version() и decr_version() теперь правильно обрабатывают None, хранящиеся в кэше, так же, как и любое другое значение, вместо того, чтобы вести себя так, как будто ключ не существует.

  В связи с ограничением python-memcached предыдущее поведение сохраняется для устаревшего бэкенда MemcachedCache.

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

• CookieStorage теперь хранит сообщения в RFC 6265 совместимом формате. Поддержка cookies, использующих старый формат, сохраняется до выхода Django 4.1.

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

Разное¶

• Назначение объектов, которые не поддерживают создание глубоких копий с помощью copy.deepcopy(), атрибутам класса в TestCase.setUpTestData() является устаревшим.
• Использование булевого значения в BaseCommand.requires_system_checks устарело. Используйте '__all__' вместо True, а [] (пустой список) вместо False.
• Аргумент whitelist и атрибут domain_whitelist в EmailValidator устарели. Используйте allowlist вместо whitelist, и domain_allowlist вместо domain_whitelist. Возможно, вам придется переименовать whitelist в существующих миграциях.
• Переменная конфигурации приложения default_app_config устарела из-за автоматического обнаружения AppConfig. См. раздел Что нового в Django 3.2 для более подробной информации.
• Автоматический вызов repr() на кверисете в TransactionTestCase.assertQuerysetEqual(), когда сравниваются строковые значения, является устаревшим. Если вам нужно прежнее поведение, явно установите transform в repr.
• Бэкэнд django.core.cache.backends.memcached.MemcachedCache устарел, поскольку python-memcached имеет некоторые проблемы и, похоже, не поддерживается. Вместо него используйте django.core.cache.backends.memcached.PyMemcacheCache или django.core.cache.backends.memcached.PyLibMCCache.
• Формат сообщений, используемый django.contrib.messages.storage.cookie.CookieStorage, отличается от формата, генерируемого старыми версиями Django. Поддержка старого формата сохраняется до версии Django 4.1.