Примечания к выпуску 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.