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

Упрощенный синтаксис маршрутизации URL ¶

Новая django.urls.path()функция позволяет использовать более простой и понятный синтаксис маршрутизации URL-адресов. Например, этот пример из предыдущих выпусков Django:

url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),

можно было бы записать как:

path('articles/<int:year>/', views.year_archive),

Новый синтаксис поддерживает приведение типов параметров URL. В этом примере представление получит yearаргумент ключевого слова как целое число, а не как строку. Кроме того, URL-адреса, которые будут соответствовать, немного менее ограничены в перезаписанном примере. Например, 10000 год теперь будет соответствовать, поскольку целые числа года не ограничены точностью до четырех цифр, как в регулярном выражении.

django.conf.urls.url()Функция из предыдущих версий теперь доступна django.urls.re_path(). Старое расположение остается для обратной совместимости без неминуемого прекращения поддержки. Старая django.conf.urls.include()функция теперь может быть импортирована из, django.urls поэтому вы можете использовать ее в своих URLconfs.from django.urls import include, path, re_path

Документ диспетчера URL-адресов переписан с учетом нового синтаксиса и более подробной информации.

Мобильный дружественных contrib.admin¶

Администратор теперь реагирует и поддерживает все основные мобильные устройства. Старые браузеры могут испытывать различные уровни постепенной деградации.

Оконные выражения ¶

Новое Windowвыражение позволяет добавлять OVERпредложение в наборы запросов. В выражении можно использовать оконные функции и агрегатные функции .

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

Удалена поддержка байтовых строк в некоторых местах ¶

Для поддержки собственных строк Python 2 более старые версии Django должны были принимать как строки байтов, так и строки Unicode. Теперь, когда поддержка Python 2 прекращена, байтовые строки должны встречаться только вокруг границ ввода / вывода (например, обработка двоичных полей или HTTP-потоков). Возможно, вам придется обновить свой код, чтобы ограничить использование байтовых строк до минимума, поскольку Django больше не принимает байтовые строки в определенных путях кода. -bОпция Python может помочь обнаружить эту ошибку в вашем коде.

Например, reverse()теперь str()вместо force_text()принуждения используется, argsи kwargsон получает до их размещения в URL-адресе. Для байтовых строк это создает строку с нежелательным bпрефиксом, а также дополнительные кавычки ( str(b'foo')есть "b'foo'"). Для адаптации вызовите decode()байтовую строку перед ее передачей в reverse().

API серверной части базы данных ¶

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

• DatabaseOperations.datetime_cast_date_sql(), datetime_cast_time_sql(), datetime_trunc_sql(), datetime_extract_sql(), И date_interval_sql()методы теперь возвращают только SQL для выполнения операции вместо SQL и список параметров.
• Сторонние серверные части баз данных должны добавить DatabaseWrapper.display_name атрибут с именем базы данных, с которой работает ваш сервер. Django может использовать его в различных сообщениях, например, при проверке системы.
• Первый аргумент SchemaEditor._alter_column_type_sql()- это сейчас, modelа не table.
• Первый аргумент SchemaEditor._create_index_name()- это сейчас, table_nameа не model.
• Чтобы включить поддержку, установите . Если база данных требует, чтобы аргументы были столбцами, а не таблицами, установите .FOR UPDATE OFDatabaseFeatures.has_select_for_update_of = TrueOFDatabaseFeatures.select_for_update_of_column = True
• Чтобы включить поддержку Window выражений, установите DatabaseFeatures.supports_over_clauseзначение True. Возможно, вам потребуется настроить методы DatabaseOperations.window_start_rows_start_end() и / или window_start_range_start_end().
• Сторонние серверные части базы данных должны добавить DatabaseOperations.cast_char_field_without_max_lengthатрибут с типом данных базы данных, который будет использоваться в Castфункции для a, CharFieldесли max_lengthаргумент не указан.
• Первым аргументом DatabaseCreation._clone_test_db()и get_test_db_clone_settings()является now, suffixа не number(в случае, если вы хотите переименовать подписи в вашем бэкэнде для единообразия). django.testтакже теперь передает эти значения как строки, а не как целые числа.
• Сторонние серверные части баз данных должны добавить DatabaseIntrospection.get_sequences()метод, основанный на заглушке в BaseDatabaseIntrospection.

Прекращена поддержка Oracle 11.2 ¶

Окончание восходящей поддержки Oracle 11.2 - декабрь 2020 г. Django 1.11 будет поддерживаться до апреля 2020 г., который почти достигает этой даты. Django 2.0 официально поддерживает Oracle 12.1+.

Уровень изоляции MySQL по умолчанию - чтение зафиксировано ¶

Уровень изоляции MySQL по умолчанию, повторяющееся чтение, может вызвать потерю данных при типичном использовании Django. Чтобы предотвратить это и обеспечить согласованность с другими базами данных, уровень изоляции по умолчанию теперь считается подтвержденным. При необходимости вы можете использовать этот DATABASESпараметр, чтобы использовать другой уровень изоляции .

AbstractUser.last_name max_lengthувеличена до 150 ¶

Перенос для django.contrib.auth.models.User.last_nameвключен. Если у вас есть настраиваемая пользовательская модель, наследующая от AbstractUser, вам необходимо создать и применить миграцию базы данных для вашей пользовательской модели.

Если вы хотите сохранить ограничение в 30 символов для фамилий, используйте настраиваемую форму:

from django.contrib.auth.forms import UserChangeForm

class MyUserChangeForm(UserChangeForm):
    last_name = forms.CharField(max_length=30, required=False)

Если вы хотите сохранить это ограничение в админке при редактировании пользователей, установите UserAdmin.formдля использования эту форму:

from django.contrib.auth.admin import UserAdmin
from django.contrib.auth.models import User

class MyUserAdmin(UserAdmin):
    form = MyUserChangeForm

admin.site.unregister(User)
admin.site.register(User, MyUserAdmin)

QuerySet.reverse()и last()запрещены после нарезки ¶

Вызов QuerySet.reverse()или last()на срезанном наборе запросов приводит к неожиданным результатам из-за применения среза после переупорядочения. Сейчас это запрещено, например:

>>> Model.objects.all()[:2].reverse()
Traceback (most recent call last):
...
TypeError: Cannot reverse a query once a slice has been taken.

Поля формы больше не принимают необязательные аргументы в качестве позиционных аргументов ¶

Чтобы предотвратить ошибки времени выполнения из-за неправильного порядка аргументов полей формы, необязательные аргументы встроенных полей формы больше не принимаются в качестве позиционных аргументов. Например:

forms.IntegerField(25, 10)

вызывает исключение и должно быть заменено на:

forms.IntegerField(max_value=25, min_value=10)

call_command()проверяет полученные параметры ¶

call_command()теперь проверяет, что синтаксический анализатор аргументов вызываемой команды определяет все переданные параметры call_command().

Для настраиваемых команд управления, которые используют параметры, не созданные с помощью parser.add_argument(), добавьте stealth_optionsатрибут в команду:

class MyCommand(BaseCommand):
    stealth_options = ('option_name', ...)

Индексы больше не принимают позиционные аргументы ¶

Например:

models.Index(['headline', '-pub_date'], 'index_name')

вызывает исключение и должно быть заменено на:

models.Index(fields=['headline', '-pub_date'], name='index_name')

Ограничения внешнего ключа теперь включены в SQLite ¶

Это будет отображаться как обратная несовместимость change ( ) при попытке сохранить существующий экземпляр модели, который нарушает ограничение внешнего ключа.IntegrityError: FOREIGN KEY constraint failed

Внешние ключи теперь создаются с использованием вместо . Таким образом, может потребоваться перестройка таблиц для воссоздания внешних ключей с новым определением, особенно если вы используете такой шаблон:DEFERRABLE INITIALLY DEFERREDDEFERRABLE IMMEDIATE

from django.db import transaction

with transaction.atomic():
    Book.objects.create(author_id=1)
    Author.objects.create(id=1)

Если вы не воссоздадите внешний ключ как DEFERRED, первый create() не удастся теперь, когда ограничения внешнего ключа применяются.

Сначала сделайте резервную копию своей базы данных! После обновления до Django 2.0 вы можете перестроить таблицы, используя сценарий, подобный этому:

from django.apps import apps
from django.db import connection

for app in apps.get_app_configs():
    for model in app.get_models(include_auto_created=True):
        if model._meta.managed and not (model._meta.proxy or model._meta.swapped):
            for base in model.__bases__:
                if hasattr(base, '_meta'):
                    base._meta.local_many_to_many = []
            model._meta.local_many_to_many = []
            with connection.schema_editor() as editor:
                editor._remake_table(model)

Этот скрипт не прошел тщательного тестирования и нуждается в адаптации для различных случаев, например для нескольких баз данных. Не стесняйтесь вносить улучшения.

Кроме того, из - за стола переделки ограничения SQLite, это запрещено выполнять RenameModelи RenameFieldоперации на модели или поля , на которые ссылается другими моделями в сделке. Чтобы разрешить применение миграций, содержащих эти операции, вы должны установить для Migration.atomicатрибута значение False.

Разное ¶

• SessionAuthenticationMiddlewareКласс удаляется. Он не предоставлял никаких функций, поскольку аутентификация сеанса безусловно включена в Django 1.10.

• Обработчики ошибок HTTP по умолчанию ( handler404и т. Д.) Теперь являются вызываемыми вместо строк пути Python с точками. Django отдает предпочтение вызываемым ссылкам, поскольку они обеспечивают лучшую производительность и удобство отладки.

• RedirectViewбольше не заглушает, NoReverseMatchесли pattern_nameне существует.

• Когда USE_L10Nвыключен, FloatFieldа DecimalFieldтеперь уважаю DECIMAL_SEPARATOR и THOUSAND_SEPARATORво время валидации. Например, с настройками:

  USE_L10N = False
  USE_THOUSAND_SEPARATOR = True
  DECIMAL_SEPARATOR = ','
  THOUSAND_SEPARATOR = '.'
  

  "1.345"теперь ввод преобразуется в 1345вместо 1.345.

• Подклассы AbstractBaseUserбольше не требуются для реализации get_short_name()и get_full_name(). (Базовые реализации, которые вызывают повышение NotImplementedError, удаляются.) django.contrib.adminИспользует эти методы, если они реализованы, но не требует их. Сторонние приложения, использующие эти методы, могут захотеть применить аналогичный подход.

• FIRST_DAY_OF_WEEKИ NUMBER_GROUPINGнастройка формата теперь хранятся в виде целых чисел в JavaScript и JSON просмотреть i18n выходов.

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

• Размер по умолчанию тестового табличного пространства Oracle увеличен с 20M до 50M, а размер авторасширения по умолчанию увеличен с 10M до 25M.

• Чтобы повысить производительность при потоковой передаче больших наборов результатов из базы данных, QuerySet.iterator()теперь выбирает 2000 строк за раз вместо 100. Старое поведение можно восстановить с помощью chunk_sizeпараметра. Например:

  Book.objects.iterator(chunk_size=100)
  

• Предоставление неизвестных имен пакетов в packagesаргументе JavaScriptCatalogпредставления теперь возникает ValueError вместо передачи без уведомления.

• Первичный ключ экземпляра модели теперь отображается в Model.__str__() методе по умолчанию , например .Question object (1)

• makemigrationsтеперь обнаруживает изменения в limit_choices_to опции поля модели . Добавьте это к своим существующим миграциям или примите автоматически созданную миграцию для полей, которые его используют.

• Выполнение запросов, требующих автоматических пространственных преобразований, теперь возникает NotImplementedError в MySQL, вместо того, чтобы молча использовать непреобразованные геометрии.

• django.core.exceptions.DjangoRuntimeWarningустранен. Он использовался только в бэкэнде кеша как промежуточный класс в CacheKeyWarningнаследовании RuntimeWarning.

• Переименован BaseExpression._output_fieldв output_field. Возможно, вам потребуется обновить пользовательские выражения.

• В более старых версиях формы и наборы форм объединяют их Mediaс виджетами, объединяя их Media. Комбинирование теперь пытается сохранить относительный порядок элементов в каждом списке . MediaOrderConflictWarningвыдается, если заказ не может быть сохранен.

• django.contrib.gis.gdal.OGRExceptionустранен. Это псевдоним GDALExceptionс Django 1.8.

• Поддержка GEOS 3.3.x прекращена.

• Способ выбора данных GeometryFieldизменен для повышения производительности, и в необработанных SQL-запросах эти поля теперь должны быть заключены в оболочку connection.ops.select. См. Пример в примечании « Необработанные запросы» в руководстве по ГИС.

contextаргумент Field.from_db_value()и Expression.convert_value()¶

contextАргумент Field.from_db_value()и Expression.convert_value()не используется , поскольку это всегда пустой словарь. Сигнатура обоих методов теперь:

(self, value, expression, connection)

вместо:

(self, value, expression, connection, context)

Поддержка старой подписи в настраиваемых полях и выражениях сохраняется до Django 3.0.

Разное ¶

• django.db.backends.postgresql_psycopg2Модуль является устаревшим в пользу django.db.backends.postgresql. Это псевдоним с Django 1.9. Это влияет только на код, который напрямую импортируется из модуля. Этот DATABASESпараметр все еще можно использовать 'django.db.backends.postgresql_psycopg2', хотя вы можете упростить его, используя 'django.db.backends.postgresql'имя, добавленное в Django 1.9.
• django.shortcuts.render_to_response()устарел в пользу django.shortcuts.render(). render()принимает те же аргументы, за исключением того, что также требует request.
• Эта DEFAULT_CONTENT_TYPEнастройка устарела. Он плохо взаимодействует со сторонними приложениями и устарел, поскольку HTML5 в основном вытеснил XHTML.
• HttpRequest.xreadlines() устарел в пользу повторения запроса.
• field_nameКлючевое слово аргумента QuerySet.earliest()и QuerySet.latest()осуждаются в пользу прохождения имен полей в качестве аргументов. Пишите .earliest('pub_date')вместо .earliest(field_name='pub_date').