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

Ограничения¶

Новые классы CheckConstraint и UniqueConstraint позволяют добавлять пользовательские ограничения базы данных. Ограничения добавляются в модели с помощью опции Meta.constraints.

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

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

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

• Бэкенды баз данных сторонних производителей должны реализовать поддержку ограничений проверки таблиц или установить DatabaseFeatures.supports_table_check_constraints в False.
• Сторонние бэкенды баз данных должны реализовать поддержку игнорирования ограничений или ошибок уникальности при вставке или установить DatabaseFeatures.supports_ignore_conflicts в False.
• Сторонние бэкенды баз данных должны реализовать интроспекцию для DurationField или установить DatabaseFeatures.can_introspect_duration_field в False.
• DatabaseFeatures.uses_savepoints теперь по умолчанию True.
• Сторонние бэкенды баз данных должны реализовать поддержку частичных индексов или установить DatabaseFeatures.supports_partial_indexes в False.
• DatabaseIntrospection.table_name_converter() и column_name_converter() удалены. Сторонним бэкендам баз данных может понадобиться вместо этого реализовать DatabaseIntrospection.identifier_converter(). В этом случае имена ограничений, которые возвращает DatabaseIntrospection.get_constraints(), должны быть нормализованы по identifier_converter().
• Генерация SQL для индексов перенесена с Index на SchemaEditor и добавлены эти методы SchemaEditor:
  • _create_primary_key_sql() и _delete_primary_key_sql().
  • _delete_index_sql() (в паре с _create_index_sql())
  • _delete_unique_sql (в паре с _create_unique_sql())
  • _delete_fk_sql() (в паре с _create_fk_sql())
  • _create_check_sql() и _delete_check_sql().
• Третий аргумент DatabaseWrapper.__init__(), allow_thread_sharing, удаляется.

Действия администратора больше не собираются из базовых классов ModelAdmin¶

Например, в старых версиях Django:

from django.contrib import admin

class BaseAdmin(admin.ModelAdmin):
    actions = ['a']

class SubAdmin(BaseAdmin):
    actions = ['b']

SubAdmin будет иметь действия 'a' и 'b'.

Теперь actions следует стандартному наследованию Python. Чтобы получить тот же результат, что и раньше:

class SubAdmin(BaseAdmin):
    actions = BaseAdmin.actions + ['b']

django.contrib.gis¶

• Поддержка GDAL 1.9 и 1.10 прекращена.

TransactionTestCase загрузка сериализованных данных¶

Начальные миграции данных теперь загружаются в TransactionTestCase в конце теста, после промывки базы данных. В старых версиях эти данные загружались в начале теста, но это не позволяло опции test --keepdb работать правильно (база данных была пустой в конце всего набора тестов). Это изменение не должно повлиять на ваши тесты, если только вы не изменили внутреннее устройство TransactionTestCase.

sqlparse является обязательной зависимостью¶

Чтобы упростить некоторые части работы Django с базой данных, sqlparse 0.2.2+ теперь является обязательной зависимостью. Она автоматически устанавливается вместе с Django.

cached_property псевдонимы¶

В использовании, например:

from django.utils.functional import cached_property

class A:

    @cached_property
    def base(self):
        return ...

    alias = base

alias не кэшируется. Там, где проблема может быть обнаружена (Python 3.6 и более поздние версии), такое использование теперь вызывает TypeError: Cannot assign the same cached_property to two different names ('base' and 'alias')..

Вместо этого используйте следующее:

import operator

class A:

    ...

    alias = property(operator.attrgetter('base'))

Разрешения для прокси-моделей¶

Permissions for proxy models теперь создаются с использованием типа содержимого прокси-модели, а не типа содержимого конкретной модели. При выполнении migrate миграция обновит существующие разрешения.

В админке изменение прозрачно для прокси-моделей, имеющих тот же app_label, что и их конкретная модель. Однако в старых версиях пользователи с правами на прокси-модель с отличным app_label, чем у ее конкретной модели, не могли получить доступ к модели в админке. Теперь это исправлено, но вы, возможно, захотите проверить назначения прав для таких прокси-моделей ([add|view|change|delete]_myproxy) перед обновлением, чтобы убедиться, что новый доступ соответствует требованиям.

Наконец, строки разрешений прокси-модели должны быть обновлены, чтобы использовать свои собственные app_label. Например, для app.MyProxyModel, наследующего от other_app.ConcreteModel, обновите user.has_perm('other_app.add_myproxymodel') до user.has_perm('app.add_myproxymodel').

Слияние формы Media активов¶

Активы Form Media теперь объединяются с помощью алгоритма топологической сортировки, так как старый алгоритм попарного объединения недостаточен для некоторых случаев. Файлы CSS и JavaScript, не включающие свои зависимости, теперь могут быть отсортированы неправильно (там, где старый алгоритм по совпадению выдавал правильные результаты).

Проверьте все классы Media на наличие отсутствующих зависимостей. Например, виджеты, зависящие от django.jQuery, должны указать js=['admin/js/jquery.init.js', ...], когда declaring form media assets.

Разное¶

• Для улучшения читабельности поле формы UUIDField теперь отображает значения с тире, например, 550e8400-e29b-41d4-a716-446655440000 вместо 550e8400e29b41d4a716446655440000.

• На SQLite, PositiveIntegerField и PositiveSmallIntegerField теперь включают проверочное ограничение для предотвращения отрицательных значений в базе данных. Если у вас есть недопустимые данные и вы запустили миграцию, которая воссоздает таблицу, вы увидите CHECK constraint failed.

• Для согласованности с серверами WSGI тестовый клиент теперь устанавливает заголовок Content-Length в строку, а не в целое число.

• Возвращаемое значение django.utils.text.slugify() больше не помечено как HTML-безопасное.

• Символ усечения, используемый по умолчанию фильтрами шаблонов urlizetrunc, truncatechars, truncatechars_html, truncatewords и truncatewords_html, теперь представляет собой настоящий символ многоточия (…) вместо трех точек. Возможно, вам придется адаптировать некоторые тестовые сравнения вывода.

• Устранена поддержка байтовых путей в загрузчике файловой системы шаблона.

• django.utils.http.urlsafe_base64_encode() теперь возвращает строку, а не байтовую строку, а django.utils.http.urlsafe_base64_decode() больше не может быть передана байтовая строка.

• Удалена поддержка cx_Oracle < 6.0.

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

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

• В попытке обеспечить более семантические данные запроса, NullBooleanSelect теперь выдает <option> значения unknown, true и false вместо 1, 2 и 3. Для обратной совместимости старые значения по-прежнему принимаются в качестве данных.

• Group.name max_length увеличивается с 80 до 150 символов.

• Тесты, нарушающие откладываемые ограничения базы данных, теперь ошибаются при выполнении на SQLite 3.20+, как и на других бэкендах, поддерживающих такие ограничения.

• Чтобы отловить ошибки использования, тесты Client и django.utils.http.urlencode() теперь выдают ошибку TypeError, если в качестве значения для кодирования передается None, поскольку None не может быть закодировано в данных GET и POST. Либо передайте пустую строку, либо опустите значение.

• Команда управления ping_google теперь по умолчанию использует https вместо http для URL карты сайта. Если ваш сайт использует http, используйте новую опцию ping_google --sitemap-uses-http. Если вы используете функцию ping_google(), установите новый аргумент sitemap_uses_https в значение False.

• runserver больше не поддерживает pyinotify (заменен на Watchman).

• Агрегатные функции Avg, StdDev и Variance теперь возвращают Decimal вместо float, когда на вход подается Decimal.

• Тесты не будут работать на SQLite, если приложения без миграций имеют отношения к приложениям с миграциями. Это было документированное ограничение с тех пор, как миграции были добавлены в Django 1.7, но теперь оно работает более надежно. Вы увидите, что тесты завершаются с ошибками типа no such table: <app_label>_<model>. Это наблюдалось в нескольких сторонних приложениях, которые имели модели в тестах без миграций. Вы должны добавить миграции для таких моделей.

• Предоставление целого числа в аргументе key для cache.delete() или cache.get() теперь приводит к появлению ValueError.

• Уравнения множественного числа для некоторых языков изменены, так как включены последние версии от Transifex.

  Примечание

  В Django 2.2.12 была добавлена возможность обрабатывать файлы .po, содержащие различные множественные числа для одного и того же языка.

Модель Meta.ordering больше не будет влиять на запросы GROUP BY¶

Запросы модели Meta.ordering, влияющие на запросы GROUP BY (например, .annotate().values()), являются распространенным источником путаницы. Теперь такие запросы выдают предупреждение об устаревании с советом добавить order_by(), чтобы сохранить текущий запрос. Meta.ordering будет игнорироваться в таких запросах, начиная с Django 3.1.

Разное¶

• django.utils.timezone.FixedOffset устарело в пользу datetime.timezone.
• Недокументированный псевдоним QuerySetPaginator django.core.paginator.Paginator является устаревшим.
• Поля модели и формы FloatRangeField в django.contrib.postgres устарели в пользу нового названия DecimalRangeField, чтобы соответствовать основному типу данных numrange, используемому в базе данных.
• Параметр FILE_CHARSET устарел. Начиная с Django 3.1, файлы, считываемые с диска, должны быть в кодировке UTF-8.
• django.contrib.staticfiles.storage.CachedStaticFilesStorage является устаревшим из-за неразрешимых проблем. Вместо него используйте ManifestStaticFilesStorage или стороннее облачное хранилище.
• RemoteUserBackend.configure_user() теперь передается request в качестве первого позиционного аргумента, если он его принимает. Поддержка переопределений, которые его не принимают, будет удалена в Django 3.1.
• Атрибуты SimpleTestCase.allow_database_queries, TransactionTestCase.multi_db и TestCase.multi_db устарели в пользу SimpleTestCase.databases, TransactionTestCase.databases и TestCase.databases. Эти новые атрибуты позволяют объявлять зависимости баз данных, чтобы предотвратить неожиданные запросы к базам данных не по умолчанию для утечки состояния между тестами. Прежнее поведение allow_database_queries=True и multi_db=True может быть достигнуто установкой databases='__all__'.