Индексы моделей на основе классов¶

Новый модуль django.db.models.indexes содержит классы, упрощающие создание индексов базы данных. Индексы добавляются в модели с помощью опции Meta.indexes.

Класс Index создает индекс b-дерева, как если бы вы использовали db_index в поле модели или index_together в классе модели Meta. Его можно разделить на подклассы для поддержки различных типов индексов, например GinIndex. Это также позволяет определить порядок (ASC/DESC) для столбцов индекса.

Рендеринг виджетов на основе шаблонов¶

Чтобы упростить настройку виджетов, рендеринг виджетов форм теперь выполняется с использованием системы шаблонов, а не в Python. См. API рендеринга формы.

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

Выражения Подзапрос¶

Новые выражения базы данных Subquery и Exists позволяют создавать явные подзапросы. Подзапросы могут ссылаться на поля из внешнего набора запросов, используя класс OuterRef.

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

django.contrib.gis¶

• Чтобы упростить базу кода и потому, что ее проще установить, чем когда contrib.gis был впервые выпущен, ГДАЛ теперь является обязательной зависимостью для GeoDjango. В более старых версиях это требуется только для SQLite.

• contrib.gis.maps удален, поскольку он взаимодействует с устаревшей версией API Карт Google и, похоже, не поддерживается. Если вы его используете, дайте нам знать.

• Оператор равенства GEOSGeometry теперь также сравнивает SRID.

• Виджеты форм на основе OpenLayers теперь используют OpenLayers 3, а шаблоны gis/openlayers.html и gis/openlayers-osm.html были обновлены. Проверьте свой проект, если вы подклассифицируете эти виджеты или расширяете шаблоны. Кроме того, новые виджеты работают немного иначе, чем старые. Вместо использования панели инструментов в виджете вы щелкаете, чтобы нарисовать, щелкаете и перетаскиваете, чтобы переместить карту, а также щелкаете и перетаскиваете точку/вершину/угол, чтобы переместить ее.

• Поддержка SpatiaLite < 4.0 прекращена.

• Поддержка GDAL 1.7 и 1.8 прекращена.

• Виджеты в contrib.gis.forms.widgets и OpenLayersWidget администратора используют API рендеринга форм, а не loader.render_to_string(). Если вы используете собственный шаблон виджета, вам необходимо быть уверенным, что средство визуализации формы сможет его найти. Например, вы можете использовать средство рендеринга TemplatesSetting.

django.contrib.staticfiles¶

• collectstatic теперь может давать сбой во время постобработки при использовании хешированного хранилища статических файлов, если существует цикл ссылок (например, 'foo.css' ссылается на 'bar.css', который сам ссылается на 'foo.css') или если цепочка файлов, ссылающихся на другие файлы, слишком глубока, чтобы ее можно было разрешить за несколько проходов. В последнем случае увеличьте количество проходов, используя ManifestStaticFilesStorage.max_post_process_passes.

• При использовании ManifestStaticFilesStorage статические файлы, не найденные в манифесте во время выполнения, теперь вызывают ошибку ValueError вместо возврата неизмененного пути. Вы можете вернуться к старому поведению, установив для ManifestStaticFilesStorage.manifest_strict значение False.

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

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

• Добавлен метод DatabaseOperations.time_trunc_sql() для поддержки усечения TimeField. Он принимает аргументы lookup_type и field_name и возвращает соответствующий SQL для усечения заданного поля времени field_name до объекта времени только с заданной спецификой. Аргумент «lookup_type» может иметь значение «час», «минута» или «секунда».

• Добавлен метод DatabaseOperations.datetime_cast_time_sql() для поддержки поиска time. Он принимает аргументы field_name и tzname и возвращает SQL, необходимый для приведения значения даты и времени к значению времени.

• Чтобы включить поддержку FOR UPDATE SKIP LOCKED, установите DatabaseFeatures.has_select_for_update_skip_locked = True.

• Новый атрибут DatabaseFeatures.supports_index_column_ordering указывает, позволяет ли база данных определять порядок столбцов в индексах. Значением по умолчанию является True, а метод DatabaseIntrospection.get_constraints() должен включать ключorders в каждом из возвращаемых словарей со списком значений ASC и/или DESC, соответствующих порядку каждого столбца в индексе.

• inspectdb больше не вызывает DatabaseIntrospection.get_indexes(), который устарел. Пользовательские базы данных должны обеспечивать возврат всех типов индексов с помощью DatabaseIntrospection.get_constraints().

• Функция «ignores_quoted_identifier_case» переименована в «ignores_table_name_case», чтобы более точно отразить, как она используется.

• Аргумент ключевого слова name добавляется к методу DatabaseWrapper.create_cursor(self, name=None), чтобы разрешить использование курсоров на стороне сервера на бэкэндах, которые его поддерживают.

Прекращена поддержка PostgreSQL 9.2 и PostGIS 2.0.¶

Поддержка исходной версии PostgreSQL 9.2 заканчивается в сентябре 2017 года. Как следствие, Django 1.11 устанавливает PostgreSQL 9.3 как минимальную официально поддерживаемую версию.

Поддержка PostGIS 2.0 также удалена, поскольку PostgreSQL 9.2 — последняя версия, поддерживающая ее.

Кроме того, минимальная поддерживаемая версия psycopg2 увеличена с 2.4.5 до 2.5.4.

LiveServerTestCase привязывается к нулевому порту¶

Вместо того, чтобы брать диапазон портов и выполнять итерацию в поисках свободного порта, LiveServerTestCase привязывается к нулевому порту и полагается на то, что операционная система назначит свободный порт. Переменная среды DJANGO_LIVE_TEST_SERVER_ADDRESS больше не используется, а поскольку она также больше не используется, опция manage.py test –liveserver удалена.

Если вам нужно привязать LiveServerTestCase к определенному порту, используйте атрибут port, добавленный в Django 1.11.2.

Защита от небезопасных перенаправлений в представлениях django.contrib.auth и i18n.¶

LoginView, LogoutView (и устаревшие эквиваленты на основе функций) и set_language() защищают пользователей от перенаправления на URL-адреса next, отличные от HTTPS, когда приложение работает через HTTPS.

QuerySet.get_or_create() и update_or_create() проверяют аргументы¶

Чтобы предотвратить бесшумную передачу опечаток, get_or_create() и update_or_create() проверяют, что их аргументы являются полями модели. Это должно быть обратно несовместимо только в том случае, если оно может выявить ошибку в вашем проекте.

pytz является обязательной зависимостью, а поддержка settings.TIME_ZONE = None удалена.¶

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

Поддержка settings.TIME_ZONE = None удалена, поскольку такое поведение не часто используется и его полезность сомнительна. Если вы хотите автоматически определять часовой пояс на основе часового пояса системы, вы можете использовать tzlocal:

from tzlocal import get_localzone

TIME_ZONE = get_localzone().zone

Это работает аналогично settings.TIME_ZONE = None, за исключением того, что оно также устанавливает os.environ['TZ']. Сообщите нам, если возникнет случай использования, в котором вы обнаружите, что не можете адаптировать свой код для установки TIME_ZONE.

Изменения HTML в шаблонах администратора¶

<p class="help"> заменяется тегом <div>, позволяющим включать списки в текст справки.

Поля, доступные только для чтения, заключаются в <div class="readonly">...</div> вместо <p>...</p>, чтобы разрешить любой тип HTML в качестве содержимого поля.

Изменения в связи с введением рендеринга виджетов на основе шаблонов.¶

Некоторые недокументированные классы в django.forms.widgets удалены:

• Субвиджет

• RendererMixin, ChoiceFieldRenderer, RadioFieldRenderer, CheckboxFieldRenderer

• ChoiceInput, RadioChoiceInput, CheckboxChoiceInput

Недокументированный метод Select.render_option() удален.

Метод Widget.format_output() удален. Вместо этого используйте собственный шаблон виджета.

Некоторые значения виджета, такие как параметры <select>, теперь локализуются, если settings.USE_L10N=True. Вы можете вернуться к старому поведению с помощью пользовательских шаблонов виджетов, которые используют тег шаблона localize для отключения локализации.

django.template.backends.django.Template.render() запрещает контекст без диктовки.¶

Для совместимости с несколькими механизмами шаблонов django.template.backends.django.Template.render() (возвращаемый из API-интерфейсов загрузчика шаблонов высокого уровня, таких как loader.get_template()) должен получать словарь контекста, а не Context или RequestContext. Если вы передавали любой из двух классов, вместо этого передайте словарь — это обратно совместимо со старыми версиями Django.

Изменения состояния модели в операциях миграции¶

Чтобы повысить скорость применения миграций, рендеринг связанных моделей откладывается до тех пор, пока они не потребуются операции (например, «RunPython»). Если у вас есть пользовательская операция, которая работает с классами модели или экземплярами модели из аргумента from_state в database_forwards() или database_backwards(), вы должны визуализировать состояния модели с помощью метода clear_delayed_apps_cache(), как описано в написании собственной операции миграции.

Серверные курсоры в PostgreSQL¶

Изменение, позволяющее QuerySet.iterator() использовать серверные курсоры в PostgreSQL, предотвращает запуск Django с PgBouncer в режиме пула транзакций. Чтобы это реализовать, используйте настройку DISABLE_SERVER_SIDE_CURSORS (добавленную в Django 1.11.1) в DATABASES.

Дополнительную информацию см. в разделе Пул транзакций и курсоры на стороне сервера.

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

• Если ни один элемент в ленте не имеет атрибута pubdate или updateddate, SyndictionFeed.latest_post_date() теперь возвращает текущую дату/время в формате UTC вместо даты и времени без какой-либо информации о часовом поясе.

• Ошибки CSRF регистрируются в журнале django.security.csrf вместо django.request.

• ALLOWED_HOSTS проверка больше не отключается при запуске тестов. Если ваше приложение включает тесты с пользовательскими именами хостов, вы должны включить эти имена хостов в ALLOWED_HOSTS. См. Тесты и несколько имен хостов.

• Использование идентификатора внешнего ключа (например, 'field_id') в ModelAdmin.list_display отображает идентификатор связанного объекта. Удалите суффикс _id, если вы хотите сохранить старое поведение строкового представления объекта.

• В формах модели CharField с null=True теперь сохраняет NULL для пустых значений вместо пустых строк.

• В Oracle Model.validate_unique() больше не проверяет пустые строки на уникальность, поскольку база данных интерпретирует значение как NULL.

• Если вы создаете подкласс AbstractUser и переопределяете clean(), убедитесь, что он вызывает super(). BaseUserManager.normalize_email() вызывается в новом методе AbstractUser.clean(), чтобы нормализация применялась в таких случаях, как проверка формы модели.

• EmailField и URLField больше не принимают аргумент ключевого слова strip. Удалите его, потому что он не имеет эффекта в старых версиях Django, поскольку в этих полях всегда удаляются пробелы.

• Атрибуты checked и selected, отображаемые виджетами формы, теперь используют логический синтаксис HTML5, а не XHTML checked='checked' и selected='selected'.

• и set() теперь очищает кеш prefetch_related().

• Чтобы предотвратить возможную потерю сохраненных настроек, setup_test_environment() теперь вызывает исключение, если вызывается второй раз перед вызовом teardown_test_environment().

• Недокументированный псевдоним DateTimeAwareJSONEncoder для DjangoJSONEncoder (переименованный в Django 1.0) удален.

• кэшированный загрузчик шаблонов теперь включен, если OPTIONS['loaders'] не указан и OPTIONS['debug'] имеет значение False (последний параметр по умолчанию имеет значение DEBUG). Это может быть обратно несовместимо, если у вас есть некоторые теги шаблона, которые не являются потокобезопасными, <template_tag_thread_safety>`.

• Запрос на удаление устаревшего типа контента больше не появляется после запуска команды migrate. Вместо этого используйте новую команду remove_stale_contenttypes.

• Виджет администратора для IntegerField использует type=»number» вместо type=»text».

• Условные заголовки HTTP теперь анализируются и сравниваются в соответствии со спецификацией условных запросов RFC 7232, а не в соответствии со старой спецификацией RFC 2616.

• patch_response_headers() больше не добавляет заголовок Last-Modified. Согласно RFC 7234 Section 4.2.2, этот заголовок бесполезен наряду с другими заголовками кэширования, которые предоставляют явное время истечения срока действия, например. Истекает или Cache-Control. UpdateCacheMiddleware и add_never_cache_headers() вызывают patch_response_headers() и, следовательно, также затронуты этим изменением.

• В шаблонах администратора <p class="help"> заменяется тегом <div>, чтобы разрешить включение списков в текст справки.

• ConditionalGetMiddleware больше не устанавливает заголовок Date, поскольку этот заголовок устанавливают веб-серверы. Он также больше не устанавливает заголовок Content-Length, как это теперь делает CommonMiddleware.

  Если у вас есть промежуточное программное обеспечение, которое изменяет содержимое ответа и появляется перед CommonMiddleware в настройках MIDDLEWARE или MIDDLEWARE_CLASSES, вам необходимо изменить порядок вашего промежуточного программного обеспечения, чтобы ответы не изменялись после установки Content-Length, или чтобы промежуточное программное обеспечение, изменяющее ответ, сбрасывало заголовок Content-Length.

• get_model() и get_models() теперь вызывают AppRegistryNotReady, если они вызываются до загрузки моделей всех приложений. Раньше они требовали загрузки только моделей целевого приложения и, таким образом, могли возвращать модели без настройки всех их отношений. Если вам нужно старое поведение get_model(), установите для аргумента require_ready значение False.

• Неиспользуемый атрибут BaseCommand.can_import_settings удален.

• Недокументированное django.utils.functional.lazy_property удалено.

• Для согласованности с запросами, не состоящими из нескольких частей, MultiPartParser.parse() теперь оставляет request.POST неизменяемым. Если вы изменяете этот QueryDict, вам необходимо сначала скопировать его, например. request.POST.copy().

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

• Поддержка IPython < 1.0 удалена из команды shell.

• Подпись частного API Widget.build_attrs() изменена с extra_attrs=None, **kwargs на base_attrs, extra_attrs=None.

• Файлоподобные объекты (например, StringIO и BytesIO), загруженные в ImageField с помощью тестового клиента, теперь требуют атрибута name со значением, которое передает валидатор validate_image_file_extension. См. примечание в Client.post().

• FileField теперь перемещает, а не копирует полученный файл. При настройках загрузки файлов по умолчанию файлы размером более FILE_UPLOAD_MAX_MEMORY_SIZE теперь имеют те же разрешения, что и временные файлы (часто 0o600), а не стандартную системную маску (часто 0o6644). Установите FILE_UPLOAD_PERMISSIONS, если вам нужно одно и то же разрешение независимо от размера файла.

models.permalink() декоратор¶

Вместо этого используйте django.urls.reverse(). Например:

from django.db import models


class MyModel(models.Model):
    ...

    @models.permalink
    def url(self):
        return ("guitarist_detail", [self.slug])

становится:

from django.db import models
from django.urls import reverse


class MyModel(models.Model):
    ...

    def url(self):
        return reverse("guitarist_detail", args=[self.slug])

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

• Функциональные представления login() и logout() в contrib.auth устарели в пользу новых представлений на основе классов LoginView и LogoutView.

• Неиспользуемый параметр extra_context в contrib.auth.views.logout_then_login() устарел.

• Представления на основе функций password_change(), password_change_done(), password_reset(), password_reset_done(), password_reset_confirm() и password_reset_complete() в contrib.auth устарели в пользу новых представлений на основе классов. PasswordChangeView, PasswordChangeDoneView, PasswordResetView, PasswordResetDoneView, PasswordResetConfirmView и PasswordResetCompleteView.

• django.test.runner.setup_databases() перемещен в django.test.utils.setup_databases(). Старое местоположение устарело.

• django.utils.translation.string_concat() устарел в пользу django.utils.text.format_lazy(). string_concat(*strings) можно заменить на format_lazy('{}' * len(strings), *strings).

• Для бэкэнда кэша PyLibMCCache передача настроек поведения pylibmc в качестве атрибутов верхнего уровня OPTIONS устарела. Вместо этого установите их под ключом behaviors в OPTIONS.

• Параметр host в django.utils.http.is_safe_url() устарел в пользу нового параметра allowed_hosts.

• Отключение исключений, возникающих при отрисовке тега шаблона {% include %}, считается устаревшим, поскольку такое поведение часто больше сбивает с толку, чем помогает. В Django 2.1 будет создано исключение.

• DatabaseIntrospection.get_indexes() устарел в пользу DatabaseIntrospection.get_constraints().

• authenticate() теперь передает аргумент request в метод authenticate() серверной части аутентификации. Поддержка методов, которые не принимают запрос в качестве первого позиционного аргумента, будет удалена в Django 2.1.

• Параметр USE_ETAGS устарел в пользу ConditionalGetMiddleware, который теперь добавляет заголовок ETag к ответам независимо от настройки. CommonMiddleware и django.utils.cache.patch_response_headers() больше не будут устанавливать ETags, когда устаревание закончится.

• Model._meta.has_auto_field устарел в пользу проверки того, что Model._meta.auto_field не имеет значения None.

• Использование групп регулярных выражений с iLmsu# в url() устарело. Единственная полезная группа — это (?i) для URL-адресов без учета регистра, однако URL-адреса без учета регистра не являются хорошей практикой, поскольку они создают, например, несколько записей для поисковых систем. Альтернативным решением может быть создание handler404, который ищет символы верхнего регистра в URL-адресе и перенаправляет их на эквивалент в нижнем регистре.

• Аргумент renderer добавляется в метод Widget.render(). Методы, которые не принимают этот аргумент, будут работать в течение периода устаревания.