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

Model._meta API ¶

В Django теперь есть формализованный API для Model._meta , обеспечивающий официально поддерживаемый способ извлечения полей и фильтрации полей на основе их атрибутов .

Этот Model._meta объект был частью Django со времен «Magic Removal» до версии 0.96 - это просто не был официальный стабильный API. Признавая это, мы постарались по возможности поддерживать обратную совместимость со старой конечной точкой API. Однако конечные точки API, которые не являются частью нового официального API, устарели и в конечном итоге будут удалены.

Несколько движков шаблонов ¶

Django 1.8 определяет стабильный API для интеграции бэкэндов шаблонов. Он включает встроенную поддержку языка шаблонов Django и для Jinja2 . Он поддерживает шаблоны рендеринга с несколькими движками в одном проекте. Узнайте больше о новых функциях в тематическом руководстве и ознакомьтесь с инструкциями по обновлению в более старых версиях документации.

Улучшения безопасности ¶

В Django интегрированы несколько функций сторонней библиотеки django-secure . django.middleware.security.SecurityMiddleware обеспечивает несколько улучшений безопасности для цикла запроса / ответа. Новая опция позволяет вам проверить файл производственных настроек на предмет способов повышения безопасности вашего сайта.check --deploy

Новые специфические функции PostgreSQL ¶

Django теперь имеет модуль с расширениями для специфических функций PostgreSQL, такие , как ArrayField , HStoreField , Range Fields и unaccent поиск. Полная разбивка функций доступна в документации .

Новые типы данных ¶

• В Django теперь есть UUIDField универсальные уникальные идентификаторы. Он хранится как собственный uuid тип данных в PostgreSQL и как символьное поле фиксированной длины на других серверах. Есть соответствующий .form field
• В Django теперь есть инструмент DurationField для хранения периодов времени - смоделированный на Python с помощью timedelta . Он хранится в собственном interval типе данных в PostgreSQL, как в Oracle и как в микросекундах на других серверах. Арифметика, связанная с датой и временем, также была улучшена на всех серверных ВМ. Есть соответствующий .INTERVAL DAY(9) TO SECOND(6) bigint form field

Выражения запросов, условные выражения и функции базы данных ¶

Выражения запроса позволяют создавать, настраивать и составлять сложные выражения SQL. Это позволило аннотации принимать выражения, отличные от агрегатов. Агрегаты теперь могут ссылаться на несколько полей, а также выполнять арифметические операции, аналогичныеF() объектам. order_by() также получил способность принимать выражения.

Условные выражения позволяют использоватьif ...elif ...else логика в запросах.

Коллекция функций базы данных также включены функциональные возможности, такие как Coalesce , Concat , и Substr .

TestCase настройка данных ¶

TestCase был переработан, чтобы обеспечить возможность инициализации данных на уровне класса с использованием транзакций и точек сохранения. Бэкенды баз данных, которые не поддерживают транзакции, такие как MySQL с механизмом хранения MyISAM, по-прежнему смогут запускать эти тесты, но не выиграют от улучшений. Теперь тесты выполняются в двух вложенных atomic() блоках: один для всего класса и по одному для каждого теста.

• Метод класса TestCase.setUpTestData() добавляет возможность настройки тестовых данных на уровне класса. Использование этой техники может ускорить тесты по сравнению с использованием setUp() .
• Загрузка приспособления внутри TestCase теперь выполняется один раз для всего TestCase .

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

Операции со связанными объектами выполняются в транзакции ¶

Некоторые операции со связанными объектами, такие как add() прямое присвоение, запускали несколько запросов на изменение данных, не заключая их в транзакции. Для того, чтобы снизить риск повреждения данных, все данные , изменяющие методы , которые влияют на несколько связанных объекты (то есть add() , remove() , clear() и прямое назначение) в настоящее время выполняют свои данные модифицирующих запросы из транзакции, при условии , ваша поддержка базы данных сделок.

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

При присвоении отношениям несохраненных объектов возникает ошибка ¶

>>> book = Book.objects.create(name="Django")
>>> book.author = Author(name="John")
>>> book.save()
Traceback (most recent call last):
...
ValueError: save() prohibited to prevent data loss due to unsaved related object 'author'.

Назначение несохраненных объектов к ForeignKey , GenericForeignKey и в OneToOneField настоящее время поднимает ValueError .

Раньше присвоение несохраненного объекта игнорировалось. Например:

>>> book = Book.objects.create(name="Django")
>>> book.author = Author(name="John")
>>> book.author.save()
>>> book.save()

>>> Book.objects.get(name="Django")
>>> book.author
>>>

Теперь появится ошибка, чтобы предотвратить потерю данных:

>>> book.author = Author(name="john")
Traceback (most recent call last):
...
ValueError: Cannot assign "<Author: John>": "Author" instance isn't saved in the database.

Если вам требуется разрешить назначение несохраненных экземпляров (старое поведение) и вас не беспокоит возможность потери данных (например, вы никогда не сохраняете объекты в базе данных), вы можете отключить эту проверку с помощью ForeignKey.allow_unsaved_instance_assignment атрибута. (Этот атрибут был удален в 1.8.4, поскольку он больше не актуален.)

Команды управления, которые принимают только позиционные аргументы ¶

Если вы написали настраиваемую команду управления, которая принимает только позиционные аргументы, и вы не указали args командную переменную, вы можете получить сообщение об ошибке, например , поскольку анализ переменных теперь основан на том, что неявно не принимает позиционные аргументы. Вы можете сделать свою команду обратно совместимой, просто установив переменную класса. Однако, если вам не нужно поддерживать совместимость со старыми версиями Django, лучше реализовать новый метод, как описано в разделе Написание пользовательских команд django-admin .Error: unrecognized arguments: ... argparse args add_arguments()

Пользовательские аргументы команды управления тестами через средство запуска тестов ¶

test Изменился метод добавления настраиваемых аргументов в команду управления через средство запуска тестов. Раньше вы могли предоставить option_list переменную класса в средстве выполнения тестов для добавления дополнительных аргументов (а ля optparse ). Теперь, чтобы реализовать такое же поведение, вам нужно создать метод класса в средстве выполнения тестов и вызвать его для добавления любых настраиваемых аргументов, поскольку синтаксический анализатор теперь является экземпляром.add_arguments(cls, parser) parser.add_argument argparse.ArgumentParser

Проверка модели гарантирует, что автоматически сгенерированные имена столбцов находятся в пределах, определенных базой данных ¶

Имя поля длиннее, чем длина имени столбца, поддерживаемая базой данных, может вызвать проблемы. Например, в MySQL вы получите исключение при попытке создать столбец, а в PostgreSQL имя столбца усечено базой данных (вы можете увидеть предупреждение в журналах PostgreSQL).

Была введена проверка модели, чтобы лучше предупреждать пользователей об этом сценарии перед фактическим созданием таблиц базы данных.

Если у вас есть существующая модель, в которой эта проверка кажется ложноположительной, например, в PostgreSQL, где имя уже усекалось, просто используйте, db_column чтобы указать имя, которое используется.

Проверка также применяется к столбцам, созданным в неявной ManyToManyField.through модели. Если вы столкнетесь с проблемой там, используйте through для создания явной модели, а затем укажите db_column ее в столбцах по мере необходимости.

Поиск отношения запросов теперь проверяет типы объектов ¶

При запросе поиска модели теперь проверяется, является ли переданный объект правильным типом, и выдается, ValueError если нет. Раньше Django не заботился о том, был ли объект правильного типа; он просто использовал атрибут связанного поля объекта (например id ) для поиска. Теперь возникает ошибка, чтобы предотвратить неправильный поиск:

>>> book = Book.objects.create(name="Django")
>>> book = Book.objects.filter(author=book)
Traceback (most recent call last):
...
ValueError: Cannot query "<Book: Django>": Must be "Author" instance.

select_related() теперь проверяет данные поля ¶

select_related() теперь проверяет, что данные поля действительно существуют. Ранее несуществующие поля игнорировались. Теперь возникает ошибка:

>>> book = Book.objects.select_related('nonexistent_field')
Traceback (most recent call last):
...
FieldError: Invalid field name(s) given in select_related: 'nonexistent_field'

Проверка также гарантирует, что данное поле является реляционным:

>>> book = Book.objects.select_related('name')
Traceback (most recent call last):
...
FieldError: Non-relational field given in select_related: 'name'

По умолчанию EmailField.max_length увеличен до 254 ¶

Старый по умолчанию 75 символов max_length не мог хранить все возможные адреса электронной почты, соответствующие RFC3696 / 5321. Чтобы сохранить все возможные действующие адреса электронной почты, max_length размер был увеличен до 254 символов. Вам нужно будет создать и применить миграции базы данных для затронутых моделей (или добавить, max_length=75 если вы хотите сохранить длину в ваших текущих полях). Перенос для django.contrib.auth.models.User.email включен.

Поддержка версий PostgreSQL старше 9.0 ¶

Конец периода поддержки восходящего потока для PostgreSQL 8.4 был достигнут в июле 2014 года. Как следствие, Django 1.8 устанавливает 9.0 в качестве минимальной официально поддерживаемой версии PostgreSQL.

Это также включает отказ от поддержки PostGIS 1.3 и 1.4, поскольку эти версии не поддерживаются в версиях PostgreSQL позже 8.4.

Django теперь также требует использования Psycopg2 версии 2.4.5 или выше (или 2.5+, если вы хотите использовать django.contrib.postgres ).

Поддержка версий MySQL старше 5.5 ¶

Конец периода поддержки восходящего потока был достигнут в январе 2012 г. для MySQL 5.0 и в декабре 2013 г. для MySQL 5.1. Как следствие, Django 1.8 устанавливает 5.5 как минимальную официально поддерживаемую версию MySQL.

Поддержка версий Oracle старше 11.1 ¶

Периоды восходящей поддержки истекли в июле 2010 г. для Oracle 9.2, в январе 2012 г. для Oracle 10.1 и в июле 2013 г. для Oracle 10.2. Как следствие, Django 1.8 устанавливает 11.1 как минимальную официально поддерживаемую версию Oracle.

Конкретные привилегии, используемые вместо ролей для тестов в Oracle ¶

В более ранних версиях Django тестируемому пользователю Oracle предоставлялись роли CONNECT и RESOURCE. Эти роли устарели, поэтому Django 1.8 вместо них использует определенные базовые привилегии. Это изменяет привилегии, необходимые главному пользователю для запуска тестов (если проект не настроен так, чтобы не создавать тестового пользователя). Точные требуемые привилегии подробно описаны в примечаниях Oracle .

AbstractUser.last_login допускает нулевые значения ¶

AbstractUser.last_login Поле теперь позволяет нулевые значения. Ранее по умолчанию использовалось время создания пользователя, что вводило в заблуждение, если пользователь никогда не входил в систему. Если вы используете пользователя по умолчанию ( django.contrib.auth.models.User ), запустите миграцию базы данных, включенную в contrib.auth .

Если вы используете настраиваемую модель пользователя, которая наследуется от AbstractUser , вам необходимо запустить makemigrations и сгенерировать миграцию для вашего приложения, содержащего эту модель. Кроме того , если хотите , чтобы набор last_login для NULL пользователей , которые не вошли в систему , вы можете запустить этот запрос:

from django.db import models
from django.contrib.auth import get_user_model
from django.contrib.auth.models import AbstractBaseUser

UserModel = get_user_model()
if issubclass(UserModel, AbstractBaseUser):
    UserModel._default_manager.filter(
        last_login=models.F('date_joined')
    ).update(last_login=None)

django.contrib.gis ¶

• Поддержка GEOS 3.1 и GDAL 1.6 прекращена.
• Поддержка SpatiaLite <2.4 прекращена.
• Поисковые запросы, специфичные для ГИС, были переработаны для использования django.db.models.Lookup API.
• str Представление GEOSGeometry объектов по умолчанию было изменено с WKT на формат EWKT (включая SRID). Поскольку это представление используется в структуре сериализации, это означает, что dumpdata выходные данные теперь будут содержать значение SRID геометрических объектов.

Приоритет контекстных процессоров для TemplateResponse приведения в соответствие с render ¶

TemplateResponse Конструктор предназначен , чтобы быть заменой для render() функции. Однако у него была небольшая несовместимость, поскольку для TemplateResponse контекстных данных из переданного в контекстном словаре могли быть затенены данные контекста, возвращенные из контекстных процессоров, тогда как для render этого было наоборот. Это была ошибка, и поведение render более подходящее, так как оно позволяет глобально определенным процессорам контекста быть локально переопределенными в представлении. Если вы полагались на данные контекста факта, которые TemplateResponse можно было бы переопределить с помощью обработчика контекста, вам нужно будет изменить свой код.

Переопределение setUpClass / tearDownClass в тестовых примерах ¶

Декораторы override_settings() и modify_settings() теперь действуют на уровне класса при использовании в качестве декораторов классов. Как следствие, при переопределении setUpClass() или tearDownClass() , то super реализация всегда должна быть вызвана.

Удаление django.contrib.formtools ¶

Приложение formtools contrib было перемещено в отдельный пакет, а соответствующие страницы документации были обновлены или удалены.

Новый пакет доступен на GitHub и PyPI.

Перезагрузка соединения с базой данных между тестами ¶

Django ранее закрыл соединения с базой данных между каждым тестом в TestCase . Это уже не так, поскольку Django теперь оборачивает TestCase транзакцию целиком . Если некоторые из ваших тестов основывались на старом поведении, вы должны TransactionTestCase вместо этого унаследовать их от .

Очистка django.template пространства имен ¶

Если вы полагались на частные API, представленные в django.template модуле, возможно, вам придется импортировать их из django.template.base .

Также частные API - интерфейсы django.template.base.compile_string() , django.template.loader.find_template() и django.template.loader.get_template_from_string() были удалены.

model атрибут в частных модельных отношениях ¶

В более ранних версиях Django в модели с обратной связью по внешнему ключу (например) model._meta.get_all_related_objects() возвращалась связь как django.db.models.related.RelatedObject с model атрибутом, установленным для источника связи. Теперь этот метод возвращает отношение как django.db.models.fields.related.ManyToOneRel (частный API RelatedObject был удален), и для model атрибута устанавливается цель отношения, а не источник. related_model Вместо этого исходная модель доступна по атрибуту.

Рассмотрим этот пример из учебника по Django 1.8:

>>> p = Poll.objects.get(pk=1)
>>> p._meta.get_all_related_objects()
[<ManyToOneRel: polls.choice>]
>>> p._meta.get_all_related_objects()[0].model
<class 'polls.models.Poll'>
>>> p._meta.get_all_related_objects()[0].related_model
<class 'polls.models.Choice'>

и сравните его с поведением в более старых версиях:

>>> p._meta.get_all_related_objects()
[<RelatedObject: polls:choice related to poll>]
>>> p._meta.get_all_related_objects()[0].model
<class 'polls.models.Choice'>

Чтобы получить доступ к исходной модели, вы можете использовать подобный шаблон для написания кода, который будет работать как с Django 1.8, так и с более ранними версиями:

for relation in opts.get_all_related_objects():
    to_model = getattr(relation, 'related_model', relation.model)

Также обратите внимание, что get_all_related_objects() это устарело в версии 1.8.

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

Следующие изменения в API серверной части базы данных задокументированы, чтобы помочь тем, кто пишет сторонние серверные части, обновить свой код:

• BaseDatabaseXXX классы были перенесены в django.db.backends.base . Пожалуйста, импортируйте их из новых мест:

  from django.db.backends.base.base import BaseDatabaseWrapper
  from django.db.backends.base.client import BaseDatabaseClient
  from django.db.backends.base.creation import BaseDatabaseCreation
  from django.db.backends.base.features import BaseDatabaseFeatures
  from django.db.backends.base.introspection import BaseDatabaseIntrospection
  from django.db.backends.base.introspection import FieldInfo, TableInfo
  from django.db.backends.base.operations import BaseDatabaseOperations
  from django.db.backends.base.schema import BaseDatabaseSchemaEditor
  from django.db.backends.base.validation import BaseDatabaseValidation
  

• data_types , data_types_suffix И data_type_check_constraints атрибуты переместились из DatabaseCreation класса в DatabaseWrapper .

• Теперь SQLCompiler.as_sql() метод принимает subquery параметр ( # 24164 ).

• Теперь BaseDatabaseOperations.date_interval_sql() метод принимает только timedelta параметр.

django.contrib.admin ¶

• AdminSite больше не принимает app_name аргумент, и его app_name атрибут был удален. Имя приложения всегда admin (в отличие от имени экземпляра, которое вы все еще можете настроить, используя AdminSite(name="...") .
• ModelAdmin.get_object() Метод (частный API) принимает третий аргумент с именем from_field того , чтобы определить , какое поле должно соответствовать прилагаемому object_id .
• Теперь ModelAdmin.response_delete() метод принимает второй аргумент с именем, obj_id который представляет собой сериализованный идентификатор, используемый для извлечения объекта перед удалением.

Автоматическое экранирование функций по умолчанию в django.template.defaultfilters ¶

Чтобы встроенные фильтры шаблонов, выводящие HTML по умолчанию, были «безопасными по умолчанию» при их вызове в коде Python, следующие функции django.template.defaultfilters были изменены для автоматического экранирования входного значения:

• join
• linebreaksbr
• linebreaks_filter
• linenumbers
• unordered_list
• urlize
• urlizetrunc

Вы можете вернуться к старому поведению, указав autoescape=False , передаете ли вы доверенный контент. Это изменение не влияет на использование соответствующих фильтров в шаблонах.

Разное ¶

• connections.queries теперь атрибут только для чтения.

• Подключения к базе данных считаются равными, только если они являются одним и тем же объектом. Они больше не могут быть хешированы.

• GZipMiddleware используется для отключения сжатия для некоторых типов содержимого, когда запрос поступает из Internet Explorer, чтобы обойти ошибку в IE6 и более ранних версиях. Такое поведение может повлиять на производительность IE7 и более поздних версий. Он был удален.

• URLField.to_python больше не добавляет косую черту к URL без пути.

• length Шаблон фильтра теперь возвращается 0 к неопределенной переменной, а не пустая строка.

• ForeignKey.default_error_message['invalid'] был изменен с на Если вы используете это сообщение в своем собственном коде, обновите список интерполированных параметров. Внутри Django продолжит предоставлять параметр для обратной совместимости.'%(model)s instance with pk %(pk)r does not exist.' '%(model)s instance with %(field)s %(value)r does not exist.' pk params

• UserCreationForm.error_messages['duplicate_username'] больше не используется. Если вы хотите настроить это сообщение об ошибке, переопределите его в форме, используя 'unique' ключ в Meta.error_messages['username'] или, если у вас есть настраиваемое поле формы для 'username' , используя 'unique' ключ в его error_messages аргументе.

• Блок usertools в base.html шаблоне django.contrib.admin now требует установки has_permission переменной контекста. Если у вас есть какие-либо настраиваемые представления администратора, которые используют этот шаблон, обновите их, чтобы передать AdminSite.has_permission() как значение этой новой переменной, или просто включите AdminSite.each_context(request) в контекст.

• В ClearableFileInput виджет были внесены внутренние изменения, позволяющие расширить возможности настройки. Недокументированный url_markup_template атрибут был удален в пользу template_with_initial .

• Для согласованности с другими крупными поставщиками, в en_GB региональном стандарте теперь понедельник является первым днем ​​недели.

• Секунды были удалены из всех районов , которые имели их TIME_FORMAT , DATETIME_FORMAT или SHORT_DATETIME_FORMAT .

• По умолчанию максимальный размер тестового табличного пространства Oracle увеличился с 300 МБ (или 200 МБ, до версии 1.7.2) до 500 МБ.

• reverse() и reverse_lazy() теперь возвращают строки Unicode вместо строк байтов.

• CacheClass Прокладка была удалена из всех движков кэша. Эти псевдонимы были предоставлены для обратной совместимости с Django 1.3. Если вы все еще используете их, обновите свой проект, чтобы использовать настоящее имя класса, указанное в BACKEND ключе CACHES настройки.

• По умолчанию call_command() теперь всегда пропускает фреймворк проверки (если вы его не пропустите skip_checks=False ).

• При повторении строк File теперь использует универсальные символы новой строки . Следующие элементы считаются окончанием строки: соглашение'\n' оконце строки в Unix, соглашениеWindows '\r\n' и старое соглашение Macintosh'\r' .

• Кеш-память Memcached находится в бэкэнде MemcachedCache и PyLibMCCache в случае set() неудачи удалит ключ . Это необходимо для того, чтобы cache_db хранилище сеансов всегда извлекало самые свежие данные сеанса.

• Частные API override_template_loaders и override_with_test_loader в django.test.utils были удалены. Перекрыть TEMPLATES с override_settings вместо этого.

• Предупреждения от серверной части базы данных MySQL больше не преобразуются в исключения, если DEBUG это так True .

• HttpRequest теперь есть упрощенный repr (например ). Это не изменит поведения класса.<WSGIRequest: GET '/somepath/'> SafeExceptionReporterFilter

• Класс на основе представления, использование ModelFormMixin возбудит ImproperlyConfigured исключение , когда оба fields и form_class атрибуты определены. Раньше fields игнорировалось.

• При следовании перенаправлениям тестовый клиент теперь поднимается, RedirectCycleError если он обнаруживает цикл или достигает максимального предела перенаправления (вместо того, чтобы проходить тихо).

• Переводимые строки, заданные в качестве default параметра поля, позже преобразуются в конкретные строки, поэтому Field.get_default() в некоторых случаях возвращаемый тип отличается. Нет никаких изменений в значениях по умолчанию, которые являются результатом callable.

• GenericIPAddressField.empty_strings_allowed сейчас False . Бэкэнды базы данных, которые интерпретируют пустые строки как пустые (только Oracle среди бэкэндов, которые включает Django), больше не будут преобразовывать нулевые значения обратно в пустую строку. Это согласуется с другими бэкэндами.

• Когда BaseCommand.leave_locale_alone атрибут равен False , переводы теперь деактивируются вместо принудительного использования локали «en-us». Если ваши модели содержат неанглийские строки, и вы рассчитываете, что переводы на английский язык будут активированы в командах управления, этого больше не будет. Может случиться так, что новые миграции базы данных генерируются (один раз) после перехода на 1.8.

• django.utils.translation.get_language() теперь возвращается, None а не LANGUAGE_CODE когда переводы временно деактивированы.

• Если для определенного литерала не существует перевода, резервный вариант теперь берется из LANGUAGE_CODE языка (а не из непереведенного msgid сообщения).

• name Поле django.contrib.contenttypes.models.ContentType было удалено с помощью миграции и заменяется свойством. Это означает, что больше нельзя запрашивать или фильтровать ContentType по этому полю.

  Будьте осторожны, если вы обновитесь до Django 1.8 и пропустите Django 1.7. Если вы запустите , эта миграция будет пропущена, и вы увидите исключение, потому что столбец не будет удален из базы данных. Вместо этого используйте для имитации только первоначальной миграции.manage.py migrate --fake RuntimeError: Error creating new content types. name manage.py migrate --fake-initial

• Новая опция позволяет имитировать начальные миграции. В версии 1.7 первоначальные миграции всегда автоматически подделывались, если все таблицы, созданные при первоначальной миграции, уже существовали.migrate --fake-initial

• Приложение без миграции с a ForeignKey в приложение с миграциями теперь может привести к ошибке ограничения внешнего ключа при миграции базы данных или выполнении тестов. В Django 1.7 это могло произойти незаметно и привести к отсутствию ограничения. Чтобы устранить ошибку, добавьте в приложение миграции без них.

Избранные методы в django.db.models.options.Options ¶

В рамках формализации Model._meta API (из django.db.models.options.Options класса) ряд методов устарел и будет удален в Django 1.10:

• get_all_field_names()
• get_all_related_objects()
• get_all_related_objects_with_model()
• get_all_related_many_to_many_objects()
• get_all_related_m2m_objects_with_model()
• get_concrete_fields_with_model()
• get_field_by_name()
• get_fields_with_model()
• get_m2m_with_model()

Загрузка тегов cycle и firstof шаблонов из future библиотеки ¶

Django 1.6 введен и синтаксис для прямой совместимости и шаблонных тегов. Этот синтаксис устарел и будет удален в Django 1.10. Вы можете просто удалить теги.{% load cycle from future %} {% load firstof from future %} cycle firstof {% load ... from future %}

django.conf.urls.patterns() ¶

В былые времена Django рекомендовали ссылаться на представления как на строки в urlpatterns :

urlpatterns = patterns('',
    url('^$', 'myapp.views.myview'),
)

а Django волшебным образом импортировал бы myapp.views.myview внутри себя и превратил бы строку в реальную ссылку на функцию. Чтобы уменьшить повторение при обращении ко многим представлениям из одного и того же модуля, patterns() функция принимает требуемый начальный prefix аргумент, который добавляется ко всем представлениям как строкам в этом наборе urlpatterns :

urlpatterns = patterns('myapp.views',
    url('^$', 'myview'),
    url('^other/$', 'otherview'),
)

В современную эпоху мы обновили руководство, чтобы вместо этого рекомендовать импортировать модуль представления и напрямую ссылаться на функции представления (или классы). У этого есть ряд преимуществ, все они проистекают из того факта, что мы используем обычный Python вместо «Django String Magic»: ошибки, возникающие при неправильном вводе имени представления, менее неясны, IDE могут помочь с автозаполнением имен представлений и т. Д.

Итак, в наши дни вышеупомянутое использование prefix arg с большей вероятностью будет записано (и лучше написано) как:

from myapp import views

urlpatterns = patterns('',
    url('^$', views.myview),
    url('^other/$', views.otherview),
)

Таким образом, patterns() не имеет смысла и является обузой при обучении новых пользователей (отвечая на вопрос новичка «зачем мне эта пустая строка в качестве первого аргумента patterns() ?»). По этим причинам мы не рекомендуем его. Обновить ваш код так же просто, как убедиться, что urlpatterns это список django.conf.urls.url() экземпляров. Например:

from django.conf.urls import url
from myapp import views

urlpatterns = [
    url('^$', views.myview),
    url('^other/$', views.otherview),
]

Передача строки в качестве view до django.conf.urls.url() ¶

Как и в предыдущем пункте, ссылка на представления как на строки в url() функции устарела. Вместо этого передайте вызываемое представление, как описано в предыдущем разделе.

Настройки, связанные с шаблоном ¶

Вследствие рефакторинга нескольких механизмов шаблонов некоторые настройки устарели в пользу TEMPLATES :

• ALLOWED_INCLUDE_ROOTS
• TEMPLATE_CONTEXT_PROCESSORS
• TEMPLATE_DEBUG
• TEMPLATE_DIRS
• TEMPLATE_LOADERS
• TEMPLATE_STRING_IF_INVALID

django.core.context_processors ¶

Встроенные обработчики контекста шаблонов перемещены в django.template.context_processors .

django.test.SimpleTestCase.urls ¶

Атрибут SimpleTestCase.urls для указания конфигурации URLconf в тестах устарел и будет удален в Django 1.10. @override_settings(ROOT_URLCONF=...) Вместо этого используйте .

prefix аргумент ¶i18n_patterns()

Связанный с предыдущим элементом, prefix аргумент to django.conf.urls.i18n.i18n_patterns() устарел. django.conf.urls.url() Вместо этого просто передайте список экземпляров.

Использование неверного количества распакованных значений в for теге шаблона ¶

Использование неправильного количества распакованных значений в for теге вызовет исключение, а не завершит работу в Django 1.10.

Передача пунктирного пути к reverse() и ¶url

Обращение URL-адресов по пути Python - дорогостоящая операция, так как она приводит к импорту обратного пути. Такое поведение также привело к проблеме безопасности . Вместо этого используйте именованные шаблоны URL-адресов для реверсирования.

Если вы используете django.contrib.sitemaps , добавьте name аргумент к url этим ссылкам django.contrib.sitemaps.views.sitemap() :

from django.contrib.sitemaps.views import sitemap

url(r'^sitemap\.xml$', sitemap, {'sitemaps': sitemaps},
    name='django.contrib.sitemaps.views.sitemap')

для обеспечения совместимости при обращении по пути Python удален в Django 1.10.

Аналогично для карт сайта ГИС добавьте name='django.contrib.gis.sitemaps.views.kml' или name='django.contrib.gis.sitemaps.views.kmz' .

Если вы используете путь Python для параметра LOGIN_URL или LOGIN_REDIRECT_URL , используйте url() вместо него имя.

Агрегатные методы и модули ¶

В django.db.models.sql.aggregates и django.contrib.gis.db.models.sql.aggregates модули (как частные API), устарели , как django.db.models.aggregates и django.contrib.gis.db.models.aggregates в настоящее время также отвечает за генерацию SQL. Старые модули будут удалены в Django 1.10.

Если вы использовали старые модули, ознакомьтесь с инструкциями по переписыванию пользовательских агрегатов с помощью нового стабильного API в разделе « Выражения запроса» .

Следующие методы и свойства django.db.models.sql.query.Query также устарели, а прокладки обратной совместимости будут удалены в Django 1.10:

• Query.aggregates , заменено на annotations .
• Query.aggregate_select , заменено на annotation_select .
• Query.add_aggregate() , заменено на add_annotation() .
• Query.set_aggregate_mask() , заменено на set_annotation_mask() .
• Query.append_aggregate_mask() , заменено на append_annotation_mask() .

Расширение аргументов команды управления с помощью Command.option_list ¶

Команды управления теперь используются argparse вместо optparse анализа аргументов командной строки, переданных командам. Это также означает, что способ добавления настраиваемых аргументов к командам изменился: вместо расширения option_list списка классов теперь следует переопределить add_arguments() метод и добавить аргументы через argparse.add_argument() . См. Этот пример для более подробной информации.

django.core.management.NoArgsCommand ¶

Этот класс NoArgsCommand устарел и будет удален в Django 1.10. Используйте BaseCommand вместо этого, который по умолчанию не принимает аргументов.

Список всех миграций в проекте ¶

--list Вариант из migrate команды управления является устаревшим и будет удален в Django 1.10. showmigrations Вместо этого используйте .

cache_choices вариант ModelChoiceField и ModelMultipleChoiceField ¶

ModelChoiceField и ModelMultipleChoiceField выбрал недокументированный, непроверенный вариант cache_choices . Этот кешированный набор запросов между несколькими отрисовками одного и того же Form объекта. Эта опция подлежит ускоренной отмене и будет удалена в Django 1.9.

django.template.resolve_variable() ¶

Функция была неофициально отмечена как «Устаревшая» в течение некоторого времени. Заменить на .resolve_variable(path, context) django.template.Variable(path).resolve(context)

django.contrib.webdesign ¶

Он предоставил lorem тег шаблона, который теперь включен во встроенные теги. Просто удалите 'django.contrib.webdesign' из INSTALLED_APPS и от ваших шаблонов.{% load webdesign %}

error_message аргумент django.forms.RegexField ¶

Он обеспечивал обратную совместимость для кода до версии 1.0, но его функциональность избыточна. Field.error_messages['invalid'] Вместо этого используйте .

Старый unordered_list синтаксис ¶

Более старый (до 1.0), более строгий и подробный формат ввода для unordered_list фильтра шаблона объявлен устаревшим:

['States', [['Kansas', [['Lawrence', []], ['Topeka', []]]], ['Illinois', []]]]

Используя новый синтаксис, это становится:

['States', ['Kansas', ['Lawrence', 'Topeka'], 'Illinois']]

django.forms.Field._has_changed() ¶

Переименуйте этот метод в has_changed() , удалив ведущий символ подчеркивания. Старое имя будет работать до Django 1.10.

django.utils.html.remove_tags() и removetags шаблонный фильтр ¶

django.utils.html.remove_tags() а также шаблонный фильтр removetags устарели, поскольку они не могут гарантировать безопасный вывод. Их существование, вероятно, приведет к их использованию в контекстах, чувствительных к безопасности, где они на самом деле небезопасны.

Неиспользуемая и недокументированная django.utils.html.strip_entities() функция также устарела.

is_admin_site аргумент django.contrib.auth.views.password_reset() ¶

Это устаревший вариант, в котором больше нет необходимости.

SubfieldBase ¶

django.db.models.fields.subclassing.SubfieldBase устарела и будет удалена в Django 1.10. Исторически он использовался для обработки полей, где требовалось преобразование типов при загрузке из базы данных, но не использовался в .values() вызовах или агрегатах. Он был заменен на from_db_value() .

Новый подход не вызывает to_python() метод при назначении, как это было в случае с SubfieldBase . Если вам нужно такое поведение, переопределите Creator класс из исходного кода Django в своем проекте.

django.utils.checksums ¶

django.utils.checksums Модуль устарел и будет удален в Django 1.10. Предоставляемая им функция (проверка контрольной суммы с использованием алгоритма Луна) была недокументирована и не использовалась в Django. Модуль перемещен в пакет django-localflavor (версия 1.1+).

InlineAdminForm.original_content_type_id ¶

original_content_type_id Атрибут InlineAdminForm устарел и будет удален в Django 1.10. Исторически он использовался для создания URL «просмотра на сайте». Этот URL-адрес теперь доступен с помощью absolute_url атрибута формы.

django.views.generic.edit.FormMixin.get_form() «S form_class аргумент ¶

FormMixin подклассы, которые переопределяют get_form() метод, должны обеспечивать значение по умолчанию для form_class аргумента, поскольку теперь оно необязательно.

Визуализация шаблоны загружаются get_template() с ¶Context

В get_template() Django 1.8 тип возвращаемого значения изменился: вместо a django.template.Template он возвращает Template экземпляр, точный тип которого зависит от того, какой бэкэнд его загрузил.

Оба класса предоставляют render() метод, однако первый принимает django.template.Context в качестве аргумента, а второй ожидает dict . Это изменение осуществляется путем прекращения поддержки шаблонов Django.

Все это относится и к select_template() .

Template и Context классы в шаблонах ответов ¶

Некоторые методы SimpleTemplateResponse и TemplateResponse принимают django.template.Context и django.template.Template объекты в качестве аргументов. Теперь они должны получать dict объекты шаблонов, зависящие от серверной части, соответственно.

Это также относится к возвращаемым типам, если вы создали подкласс любого из классов ответа шаблона.

Дополнительную информацию см. В документации API ответа шаблона .

current_app аргумент API, связанных с шаблоном ¶

Следующие функции и классы больше не будут принимать current_app параметр для установки пространства имен URL в Django 1.10:

• django.shortcuts.render()
• django.template.Context()
• django.template.RequestContext()
• django.template.response.TemplateResponse()

request.current_app Вместо этого установите , где request является первым аргументом этих функций или классов. Если вы используете простой Context , используйте RequestContext вместо него.

dictionary и context_instance аргументы функций рендеринга ¶

Следующие функции больше не будут принять dictionary и context_instance параметры в Django 1.10:

• django.shortcuts.render()
• django.shortcuts.render_to_response()
• django.template.loader.render_to_string()

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

Если вы передаете Context в систему context_instance , передайте dict в context параметре вместо этого. Если вы передаете RequestContext , передайте запрос отдельно в request параметре.

dirs аргумент функций поиска шаблона ¶

Следующие функции больше не будут принимать dirs параметр для переопределения TEMPLATE_DIRS в Django 1.10:

• django.template.loader.get_template()
• django.template.loader.select_template()
• django.shortcuts.render()
• django.shortcuts.render_to_response()

Параметр не работал одинаково для разных загрузчиков шаблонов и не работал для включенных шаблонов.

django.template.loader.BaseLoader ¶

django.template.loader.BaseLoader был переименован в django.template.loaders.base.Loader . Если вы написали собственный загрузчик шаблонов, который наследует BaseLoader , вы должны Loader вместо этого наследовать .

django.test.utils.TestTemplateLoader ¶

Частный API django.test.utils.TestTemplateLoader устарел django.template.loaders.locmem.Loader и будет удален в Django 1.9.

Поддержка max_length аргумента о пользовательских Storage классах ¶

Storage подклассы должны добавить max_length=None в качестве параметра get_available_name() и / или save() если они переопределяют любой метод. Поддержка хранилищ, которые не принимают этот аргумент, будет удалена в Django 1.10.

qn заменено на compiler ¶

В предыдущих версиях Django различные внутренние методы ORM (в основном as_sql методы) принимали qn аргумент (для «имени цитаты»), который был ссылкой на функцию, которая цитировала идентификаторы для отправки в базу данных. В Django 1.8 этот аргумент был переименован в compiler и теперь является полным SQLCompiler экземпляром. Для обеспечения обратной совместимости при вызове SQLCompiler экземпляра выполняется то же цитирование имени, что и для qn функции. Однако эта прокладка обратной совместимости немедленно устарела: вы должны переименовать свои qn аргументы в compiler и вызвать то место, которое compiler.quote_name_unless_alias(...) вы вызывали ранее qn(...) .

Значение по умолчанию RedirectView.permanent ¶

Значение RedirectView.permanent атрибута по умолчанию изменится с True на False в Django 1.9.

Использование AuthenticationMiddleware без SessionAuthenticationMiddleware ¶

django.contrib.auth.middleware.SessionAuthenticationMiddleware был добавлен в Django 1.7. В Django 1.7.2 его функциональность была перенесена auth.get_user() и, для обратной совместимости, включалась, только если она 'django.contrib.auth.middleware.SessionAuthenticationMiddleware' появилась в MIDDLEWARE_CLASSES .

В Django 1.10 проверка сеанса будет включена независимо от того SessionAuthenticationMiddleware , включена она или нет (в этот момент не SessionAuthenticationMiddleware будет иметь значения). Вы можете добавить его в свое время MIDDLEWARE_CLASSES до этого, чтобы зарегистрироваться. Пожалуйста, прочтите сначала рекомендации по обновлению .

django.contrib.sitemaps.FlatPageSitemap ¶

django.contrib.sitemaps.FlatPageSitemap переехал в django.contrib.flatpages.sitemaps.FlatPageSitemap . Старое местоположение импорта устарело и будет удалено в Django 1.9.

Модель Field.related ¶

Приватный атрибут django.db.models.Field.related устарел и заменен Field.rel . Последний экземпляр django.db.models.fields.related.ForeignObjectRel которого заменяет django.db.models.related.RelatedObject . django.db.models.related Модуль был удален , и Field.related атрибут будет удален в Django 1.10.

ssi тег шаблона ¶

ssi Шаблонный тег позволяет файлы , которые будут включены в шаблон по абсолютному пути. Это ограниченное использование в большинстве ситуаций развертывания, и include тег часто имеет больше смысла. Этот тег устарел и будет удален в Django 1.10.

= как оператор сравнения в if теге шаблона ¶

Использование единственного знака равенства с тегом шаблона для проверки на равенство было недокументировано и непроверено. Теперь он устарел и заменен на .{% if %} ==

%(<foo>)s синтаксис в ModelFormMixin.success_url ¶

Устаревший %(<foo>)s синтаксис ModelFormMixin.success_url устарел и будет удален в Django 1.10.

GeoQuerySet агрегированные методы ¶

collect() , extent() , extent3d() , make_line() , И unionagg() совокупные методы устарели и должны быть заменены на их основе функциональных эквивалентов совокупности ( Collect , Extent , Extent3D , MakeLine , и Union ).

Подпись allow_migrate метода роутера ¶

Сигнатура allow_migrate() метода маршрутизаторов баз данных изменена с на .allow_migrate(db, model) allow_migrate(db, app_label, model_name=None, **hints)

Когда model_name установлено, значение, которое ранее было задано через model позиционный аргумент, теперь может быть найдено внутри hints словаря под ключом 'model' .

После перехода к новой подписи маршрутизатора будет также называться по RunPython и RunSQL операциям.