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

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

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

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

Рендеринг HTML-компонентов на основе шаблонов ¶

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

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

Выражения Subquery ¶

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

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

django.contrib.gis ¶

• Чтобы упростить кодовую базу и поскольку теперь его проще установить, чем когда contrib.gis он был представлен, GDAL теперь является обязательной зависимостью 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 прекращена.
• Компоненты Forms в администрировании contrib.gis.forms.widgets и OpenLayersWidget администрировании используют API-интерфейс Forms Renderer вместо 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 установил 9.3 как минимальную официально поддерживаемую версию PostgreSQL.

Поддержка 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, когда приложение работает под HTTPS.

QuerySet.get_or_create() и update_or_create() проверить их параметры ¶

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

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

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

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

from tzlocal import get_localzone

TIME_ZONE = get_localzone().zone

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

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

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

Поля, доступные только для чтения, заключаются в оболочку вместо того, чтобы разрешить включение любого HTML-кода в содержимое поля.<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-интерфейсами загрузчика шаблонов, такими как by 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 , SyndicationFeed.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 продукты, создаваемые компонентами формы, теперь используют логический синтаксис HTML 5 вместо 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

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

• В команде прекращена поддержка 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 .
• Скрытие исключений, возникающих при рендеринге тега шаблона, не рекомендуется, поскольку такое поведение иногда сбивало с толку. В Django 2.1 исключения будут распространяться.{% include %}
• DatabaseIntrospection.get_indexes() был заменен устаревшим на DatabaseIntrospection.get_constraints() .
• authenticate() теперь передает параметр request методу authenticate() механизмов аутентификации. Поддержка методов, которые не принимают позицию request в качестве первого параметра, будет удалена в Django 2.1.
• Этот параметр USE_ETAGS устарел, и ConditionalGetMiddleware теперь он добавляет заголовок ETag к ответам независимо от параметра. CommonMiddleware и django.utils.cache.patch_response_headers() больше не будет устанавливать заголовок ETag в конце периода устаревания.
• Model._meta.has_auto_field был устаревшим в пользу контроля .Model._meta.auto_field is not None
• Использование групп регулярных выражений с iLmsu# in url() не рекомендуется. Единственная полезная группа - (?i) для URL-адресов без учета регистра; однако использование этих URL-адресов не рекомендуется, так как они создают, например, несколько записей для поисковых систем. Альтернативным решением может быть создание функции, которая handler404 ищет символы верхнего регистра в URL-адресе и перенаправляет на эквивалент в нижнем регистре.
• Параметр renderer добавлен в метод Widget.render() . Методы, которые не принимают этот параметр, все равно будут работать в период устаревания.