Примечания к выпуску 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 чтобы она могла писать в конфигурации URL.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 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 функции для 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 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 не существует.

• Когда 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') .