Упрощенный синтаксис маршрутизации 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, поэтому вы можете использовать from django.urls import include, path, re_path в ваших URLconfs.

Документ Менеджер URL-ов переписан, чтобы включить новый синтаксис и предоставить более подробную информацию.

Удобный для мобильных устройств contrib.admin¶

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

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

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

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

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

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

Например, 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() теперь является модель, а не таблица.

• Первым аргументом SchemaEditor._create_index_name() теперь является table_name, а не model.

• Чтобы включить поддержку FOR UPDATE OF, установите DatabaseFeatures.has_select_for_update_of = True. Если база данных требует, чтобы аргументами OF были столбцы, а не таблицы, установите DatabaseFeatures.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 для CharField, если аргумент max_length не указан.

• Первым аргументом DatabaseCreation._clone_test_db() и get_test_db_clone_settings() теперь является суффикс, а не номер (на тот случай, если вы хотите переименовать подписи в своем бэкэнде для обеспечения единообразия). 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() запрещены после нарезки.¶

Calling QuerySet.reverse() or last() on a sliced queryset leads to unexpected results due to the slice being applied after reordering. This is now prohibited, e.g.:

>>> 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.¶

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

Внешние ключи теперь создаются с использованием DEFERRABLE INITIALLY DEFERRED вместо DEFERRABLE 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 не существует.

• When USE_L10N is off, FloatField and DecimalField now respect DECIMAL_SEPARATOR and THOUSAND_SEPARATOR during validation. For example, with the settings:

  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 по умолчанию увеличен с 20 МБ до 50 МБ, а размер автоматического расширения по умолчанию увеличен с 10 МБ до 25 МБ.

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

  Book.objects.iterator(chunk_size=100)
  

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

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

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

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

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

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

• В более старых версиях формы и наборы форм объединяют свой «Медиа» с виджетом «Медиа», объединяя их. Объединение теперь пытается сохранить относительный порядок элементов в каждом списке. 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() принимает те же аргументы, за исключением того, что он также требует запроса.

• Параметр DEFAULT_CONTENT_TYPE устарел. Он плохо взаимодействует со сторонними приложениями и устарел, поскольку HTML5 в основном заменил XHTML.

• HttpRequest.xreadlines() устарел в пользу повторения запроса.

• Аргумент ключевого слова field_name для QuerySet.earliest() и QuerySet.latest() устарел в пользу передачи имен полей в качестве аргументов. Напишите .earliest('pub_date') вместо .earliest(field_name='pub_date').