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

Модельные индексы на основе классов¶

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

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

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

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

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

Subquery выражения¶

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

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

django.contrib.gis¶

• Для упрощения кодовой базы и потому, что его легче установить, чем когда contrib.gis был впервые выпущен, GDAL теперь является обязательной зависимостью для GeoDjango. В старых версиях она требовалась только для SQLite.
• contrib.gis.maps удален, поскольку он взаимодействует с устаревшей версией API Google Maps и, похоже, не поддерживается. Если вы используете его, let us know.
• Оператор равенства 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 используют form rendering 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 может быть либо 'hour', 'minute', либо 'second'.
• Метод 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, не относящиеся к HTTPS next, когда приложение работает через 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']. Let us know если в каком-то случае вы обнаружите, что не можете адаптировать свой код для установки TIME_ZONE.

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

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

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

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

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

• SubWidget
• 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(), как описано в writing your own migration operation.

Курсоры на стороне сервера в PostgreSQL¶

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

Более подробное обсуждение см. в разделе Объединение транзакций и курсоры на стороне сервера.

Разное¶

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

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

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

• Использование id внешнего ключа (например, 'field_id') в ModelAdmin.list_display отображает ID связанного объекта. Удалите суффикс _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 boolean, а не XHTML checked='checked' и selected='selected'.

• RelatedManager.add(), remove(), clear() и set() теперь очищают кэш prefetch_related().

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

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

• Теперь cached template loader включается, если не указано OPTIONS['loaders'], а OPTIONS['debug'] - False (последний параметр по умолчанию имеет значение DEBUG). Это может быть обратно несовместимо, если у вас есть некоторые template tags that aren’t thread safe.

• После выполнения команды 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, этот заголовок бесполезен наряду с другими заголовками кэширования, которые предоставляют явное время истечения срока действия, например, Expires или 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.

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

• Подпись частного 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), а не стандартный umask системы (часто 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])

Разное¶

• Представления contrib.auth на основе функций login() и logout() устарели в пользу новых представлений LoginView и LogoutView на основе классов.
• Неиспользуемый параметр extra_context contrib.auth.views.logout_then_login() является устаревшим.
• Функциональные представления contrib.auth, password_change(), password_change_done(), password_reset(), password_reset_done(), password_reset_confirm() и password_reset_complete() устарели в пользу новых представлений на основе классов 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() бэкендов аутентификации. Поддержка методов, которые не принимают request в качестве первого позиционного аргумента, будет удалена в Django 2.1.
• Настройка USE_ETAGS устарела в пользу ConditionalGetMiddleware, которая теперь добавляет заголовок ETag к ответам независимо от настройки. CommonMiddleware и django.utils.cache.patch_response_headers() больше не будут устанавливать ETags, когда устаревание закончится.
• Model._meta.has_auto_field устарело в пользу проверки наличия Model._meta.auto_field is not None.
• Использование групп регулярных выражений с iLmsu# в url() является неактуальным. Единственной полезной группой является (?i) для URL, не чувствительных к регистру, однако URL, не чувствительные к регистру, не являются хорошей практикой, поскольку они создают множество записей, например, для поисковых систем. Альтернативным решением может быть создание handler404, который ищет в URL символы верхнего регистра и перенаправляет на эквивалент в нижнем регистре.
• Аргумент renderer добавляется к методу Widget.render(). Методы, не принимающие этот аргумент, будут работать через период устаревания.