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

Разрешение на отображение ( view ) для моделей ¶

Разрешение на отображение ( view ) было добавлено к разрешениям Meta.default_permissions модели. Новые разрешения будут автоматически созданы при запуске migrate .

Это позволяет предоставить доступ к моделям только для чтения в интерфейсе администрирования. ModelAdmin.has_view_permission() это новый метод. Реализация обратно совместима в том смысле, что нет необходимости назначать разрешение, view чтобы пользователи, у которых есть разрешение на редактирование, могли редактировать объекты.

Однако существует ряд соображений обратной совместимости .

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

API ядра СУБД ¶

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

• Чтобы соответствовать PEP 249 , исключения, связанные с отсутствием поддержки функции базы данных, изменены сNotImplementedError наdjango.db.NotSupportedError .
• Флаг функциональности базы данных allow_sliced_subqueries был переименован в allow_sliced_subqueries_with_in .
• DatabaseOperations.distinct_sql() теперь требует дополнительного params аргумента и возвращает кортеж SQL и параметров вместо строки SQL.
• DatabaseFeatures.introspected_boolean_field_type был изменен, метод стал собственностью.

django.contrib.gis ¶

• Поддержка SpatiaLite 4.0 была удалена.

Прекращение поддержки MySQL 5.5 ¶

Обратная поддержка MySQL 5.5 прекращается в декабре 2018 года. Django 2.1 поддерживает MySQL 5.6 и новее.

Прекращение поддержки PostgreSQL 9.3 ¶

Обратная поддержка PostgreSQL 9.3 прекращается в сентябре 2018 года. Django 2.1 поддерживает PostgreSQL 9.4 и новее.

BCryptPasswordHasher был удален из настройки по PASSWORD_HASHERS умолчанию ¶

Если вы использовали bcrypt с Django 1.4 или 1.5 (до BCryptSHA256PasswordHasher того, как он был добавлен в Django 1.6), у вас могут быть пароли, использующие этот алгоритм BCryptPasswordHasher .

Вы можете проверить, так ли это

from django.contrib.auth import get_user_model
User = get_user_model()
User.objects.filter(password__startswith='bcrypt$$')

Если вы хотите и дальше разрешать использование этих паролей, вам нужно будет переопределить настройку PASSWORD_HASHERS (если вы еще этого не сделали) и включить 'django.contrib.auth.hashers.BCryptPasswordHasher' .

Перемещение контекстной переменной шаблона компонента wrap_label ¶

Чтобы исправить отсутствие <label> при использовании RadioSelect и CheckboxSelectMultiple with MultiWidget , переменная контекста wrap_label теперь отображается как атрибут всех параметров. Например, в настраиваемом трафарете input_option.html измените на .{% if wrap_label %} {% if widget.wrap_label %}

Файлы cookie SameSite ¶

Куки используются для django.contrib.sessions , django.contrib.messages и защита от CSRF Django теперь установить опцию SameSite к по умолчанию Lax . Браузеры, которые используют этот параметр, не будут отправлять эти файлы cookie в запросах другому источнику. Если вы полагаетесь на предыдущее поведение, установите настройки SESSION_COOKIE_SAMESITE и / или CSRF_COOKIE_SAMESITE на None .

Соображения по поводу нового разрешения на отображение моделей ( view ) ¶

class MyAdmin(admin.ModelAdmin):
    def get_form(self, request, obj=None, **kwargs):
        if not self.has_change_permission(request, obj):
            return super().get_form(request, obj, **kwargs)
        return CustomForm

Разное ¶

• Минимальная mysqlclient поддерживаемая версия изменена с 1.3.3 на 1.3.7.
• Поддержка SQLite <3.7.15 была удалена.
• Формат даты директивы Expires от Set-Cookie модифицировали подчинятьсяRFC 7231 # section-7.1.1.1 вместо стандарта файлов cookie Netscape. Штрихи в датах вродеудаляются. Эта модификация в основном косметическая, за исключением, возможно, очень старых браузеров, которые не анализируют новый формат.Tue, 25-Dec-2018 22:26:13 GMT
• allowed_hosts теперь является обязательным параметром частного API django.utils.http.is_safe_url() .
• Атрибут, multiple созданный компонентом, SelectMultiple теперь использует логический синтаксис HTML5, а не форму XHTML multiple="multiple" .
• HTML-код, созданный компонентами формы, больше не включает закрывающую косую черту для пустых элементов, например. <br> , Это несовместимо с XHTML, хотя некоторые компоненты уже использовали некоторые аспекты HTML5, такие как логические атрибуты.
• Значение пустых параметров SelectDateWidget es изменилось с 0 на пустую строку, что, по сути, может потребовать некоторой настройки тестов, сравнивающих HTML.
• meth: .User.has_usable_password, и функция is_password_usable() больше не возвращает, False если пароль None или пустая строка, или если пароль использует алгоритм, не указанный в настройке PASSWORD_HASHERS . Это недокументированное поведение было регрессом в Django 1.6 и не позволяло пользователям с такими паролями запрашивать сброс пароля. Изучите свой код, чтобы убедиться, что вы используете этот API не в соответствии со старым поведением.
• Поскольку миграции теперь также загружаются из файлов .pyc , может потребоваться их удаление, если вы работаете в смешанной среде Python 2 и Python 3.
• Использование None в качестве значения поиска JSONField теперь позволяет находить объекты, для которых указанный ключ равен нулю, а не объекты, не имеющие этого ключа.
• Класс Admin CSS field-box был переименован, чтобы fieldBox избежать конфликтов с классом, назначенным для именованных полей шаблона box .
• Так как админ actions.html , change_list_results.html , date_hierarchy.html , pagination.html , prepopulated_fields_js.html , search_form.html , и submit_line.html шаблоны теперь могут быть переопределены в приложении или на модель, вам нужно переименовать мая существующих шаблоны с именами тех , которые были написаны для разных целей.
• QuerySet.raw() теперь кэширует свои результаты, как и обычные наборы запросов. Используйте, iterator() если хотите избежать кеширования.
• Метод маршрутизатора базы данных allow_relation() вызывается в большем количестве ситуаций. Плохо написанные маршрутизаторы могут нуждаться в соответствующем обновлении.
• Переводы больше не отключаются перед запуском административных команд. Если ваша настраиваемая команда должна работать без переводов (например, для вставки непереведенного содержимого в базу данных), используйте новый декоратор @no_translations .
• Административные команды больше не позволяют использовать короткие формы параметров --settings и --pythonpath .
• Частная константа django.db.models.sql.constants.QUERY_TERMS была удалена. Методы get_lookup() и get_lookups() в " регистрации API поиск может быть хорошей альтернативой. По сравнению с константой QUERY_TERMS , они позволяют вашему коду также учитывать введенные персонализированные поисковые запросы.
• Совместимость с py-bcrypt удалена, так как этот пакет больше не поддерживается. Вместо этого используйте bcrypt .

Разное ¶

• Функция ГИС ForceRHR устарела в пользу новой ForcePolygonCW .
• django.utils.http.cookie_date() устарел в пользу http_date() , который соответствует формату самого последнего RFC.
• {% load staticfiles %} и устарели в пользу , которая выполняет ту же роль.{% load admin_static %} {% load static %}
• django.contrib.staticfiles.templatetags.static() устарело в пользу django.templatetags.static.static() .
• Поддержка методов, InlineModelAdmin.has_add_permission() которые не принимают obj в качестве второго позиционного параметра, будет удалена в Django 3.0.