Перенос ваших приложений с Django 0.96 на 1.0 ¶

Переименовать maxlengthв max_length¶

Переименуйте свой maxlengthаргумент в max_length(это было изменено, чтобы соответствовать полям формы):

Заменить __str__на __unicode__¶

Замените __str__функцию вашей модели на __unicode__метод и убедитесь, что вы используете Unicode ( u'foo') в этом методе.

Удалить prepopulated_from¶

Удалите prepopulated_fromаргумент в полях модели. Он больше не действителен и был перемещен в ModelAdminкласс в admin.py. См. Админку ниже, чтобы узнать больше об изменениях в админке.

Удалить core¶

Удалите coreаргумент из полей вашей модели. В этом больше нет необходимости, поскольку эквивалентная функциональность (часть встроенного редактирования ) теперь по-другому обрабатывается интерфейсом администратора. Вам не нужно беспокоиться о встроенном редактировании, пока вы не попадете в раздел администратора , расположенный ниже. А пока удалите все ссылки на core.

Заменить на ¶class Admin:admin.py

Удалите все ваши внутренние объявления из ваших моделей. Они ничего не сломают, если вы их оставите, но и ничего не сделают. Чтобы зарегистрировать приложения у администратора, вы переместите эти объявления в файл; см. подробности у администратора ниже.class Adminadmin.py

Пример ¶

Ниже приведен пример models.pyфайла со всеми необходимыми изменениями:

Старая версия (0.96) models.py:

class Author(models.Model):
    first_name = models.CharField(maxlength=30)
    last_name = models.CharField(maxlength=30)
    slug = models.CharField(maxlength=60, prepopulate_from=('first_name', 'last_name'))

    class Admin:
        list_display = ['first_name', 'last_name']

    def __str__(self):
        return '%s %s' % (self.first_name, self.last_name)

Новое (1.0) models.py:

class Author(models.Model):
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=30)
    slug = models.CharField(max_length=60)

    def __unicode__(self):
        return u'%s %s' % (self.first_name, self.last_name)

Новое (1.0) admin.py:

from django.contrib import admin
from models import Author

class AuthorAdmin(admin.ModelAdmin):
    list_display = ['first_name', 'last_name']
    prepopulated_fields = {
        'slug': ('first_name', 'last_name')
    }

admin.site.register(Author, AuthorAdmin)

Используйте новый встроенный синтаксис ¶

Все новые edit_inlineпараметры перенесены в admin.py. Вот пример:

Старая версия (0.96):

class Parent(models.Model):
    ...

class Child(models.Model):
    parent = models.ForeignKey(Parent, edit_inline=models.STACKED, num_in_admin=3)

Новое (1.0):

class ChildInline(admin.StackedInline):
    model = Child
    extra = 3

class ParentAdmin(admin.ModelAdmin):
    model = Parent
    inlines = [ChildInline]

admin.site.register(Parent, ParentAdmin)

Подробнее см. В объектах InlineModelAdmin .

Упростите fieldsили используйте fieldsets¶

Старый fieldsсинтаксис был довольно запутанным и был упрощен. Старый синтаксис по-прежнему работает, но вам нужно будет его использовать fieldsets.

Старая версия (0.96):

class ModelOne(models.Model):
    ...

    class Admin:
        fields = (
            (None, {'fields': ('foo','bar')}),
        )

class ModelTwo(models.Model):
    ...

    class Admin:
        fields = (
            ('group1', {'fields': ('foo','bar'),   'classes': 'collapse'}),
            ('group2', {'fields': ('spam','eggs'), 'classes': 'collapse wide'}),
        )

Новое (1.0):

class ModelOneAdmin(admin.ModelAdmin):
    fields = ('foo', 'bar')

class ModelTwoAdmin(admin.ModelAdmin):
    fieldsets = (
        ('group1', {'fields': ('foo','bar'),   'classes': 'collapse'}),
        ('group2', {'fields': ('spam','eggs'), 'classes': 'collapse wide'}),
    )

Обновите свой корень urls.py¶

Если вы используете сайт администратора, вам необходимо обновить свой корень urls.py.

Старая версия (0.96) urls.py:

from django.conf.urls.defaults import *

urlpatterns = patterns('',
    (r'^admin/', include('django.contrib.admin.urls')),

    # ... the rest of your URLs here ...
)

Новое (1.0) urls.py:

from django.conf.urls.defaults import *

# The next two lines enable the admin and load each admin.py file:
from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    (r'^admin/(.*)', admin.site.root),

    # ... the rest of your URLs here ...
)

Используйте django.formsвместо newforms¶

Заменить django.newformsна django.forms- Django 1.0 переименовал newformsмодуль (представленный в 0.96) на старый forms. oldformsМодуль был также удален.

Если вы уже используете newformsбиблиотеку и использовали рекомендованный нами importсинтаксис операторов, все, что вам нужно сделать, это изменить операторы импорта.

Старый:

from django import newforms as forms

Новый:

from django import forms

Если вы используете старую систему форм (ранее известную как django.formsи django.oldforms), вам придется переписать свои формы. Хорошее место для начала - документация по формам.

Обрабатывайте загруженные файлы с помощью нового API ¶

Замените использование загруженных файлов, то есть записей в, request.FILESкак простых словарей, на новые UploadedFile. Старый синтаксис словаря больше не работает.

Таким образом, в виде:

def my_view(request):
    f = request.FILES['file_field_name']
    ...

… Вам необходимо внести следующие изменения:

Работа с полями файлов с помощью нового API ¶

Изменилась внутренняя реализация django.db.models.FileField. Видимым результатом этого является то, что способ доступа к специальным атрибутам (URL, имя файла, размер изображения и т. Д.) Этих полей модели изменился. Вам нужно будет внести следующие изменения, если ваша модель FileFieldвызывается myfile:

Обратите внимание, что атрибуты widthи heightимеют смысл только для ImageFieldполей. Более подробную информацию можно найти в документации API модели .

Используйте Paginatorвместо ObjectPaginator¶

ObjectPaginatorВ 0,96 была удалена и заменена улучшенной версией, django.core.paginator.Paginator.

Научитесь любить автоэскейп ¶

По умолчанию система шаблонов теперь автоматически HTML-экранирует вывод каждой переменной. Чтобы узнать больше, см. Автоматическое экранирование HTML .

Чтобы отключить автоматическое экранирование для отдельной переменной, используйте safe фильтр:

This will be escaped: {{ data }}
This will not be escaped: {{ data|safe }}

Чтобы отключить автоматическое экранирование для всего шаблона, оберните шаблон (или только определенный раздел шаблона) в autoescapeтег:

{% autoescape off %}
   ... unescaped template content here ...
{% endautoescape %}

spacelessтег ¶

spacelessШаблон Теперь тег удаляет все пробелы между тегами HTML, а не сохранение единого пространства.

Местный колорит США ¶

django.contrib.localflavor.usaбыл переименован в django.contrib.localflavor.us. Это изменение было внесено, чтобы соответствовать схеме именования других местных вкусов. Чтобы перенести код, все, что вам нужно сделать, это изменить импорт.

Получение нового сеансового ключа ¶

SessionBase.get_new_session_key()был переименован в _get_new_session_key(). get_new_session_object()более не существует.

Загрузка строки больше не вызывает save()¶

Раньше при загрузке строки автоматически запускался метод модели save(). Это уже не так, поэтому любые поля (например, временные метки), которые были автоматически заполнены a, save()теперь нуждаются в явных значениях в любом приспособлении.

Лучшие исключения ¶

Старый EnvironmentErrorразделился на тот, ImportErrorкогда Django не может найти модуль настроек, и RuntimeErrorкогда вы пытаетесь изменить настройки после того, как их уже использовали.

LOGIN_URLпереехал ¶

LOGIN_URLКонстанта перемещается из django.contrib.authв settingsмодуль. Вместо использования ссылки .from django.contrib.auth import LOGIN_URLsettings.LOGIN_URL

APPEND_SLASHповедение было обновлено ¶

В версии 0.96, если URL-адрес не заканчивался косой чертой или не имел точки в последнем компоненте его пути и APPEND_SLASHбыл истинным, Django перенаправлял на тот же URL-адрес, но с добавленной косой чертой в конце. Теперь Django проверяет, соответствует ли шаблон без косой черты чему-то в ваших шаблонах URL. Если это так, перенаправления не происходит, потому что предполагается, что вы намеренно хотели поймать этот шаблон.

Для большинства людей это не потребует никаких изменений. Однако у некоторых людей шаблоны URL-адресов выглядят так:

r'/some_prefix/(.*)$'

Раньше эти шаблоны были бы перенаправлены на завершающую косую черту. Если вам всегда нужна косая черта на таких URL-адресах, перепишите шаблон следующим образом:

r'/some_prefix/(.*/)$'

Другое исключение из get()¶

Менеджеры теперь возвращают MultipleObjectsReturned исключение вместо AssertionError:

Старая версия (0.96):

try:
    Model.objects.get(...)
except AssertionError:
    handle_the_error()

Новое (1.0):

try:
    Model.objects.get(...)
except Model.MultipleObjectsReturned:
    handle_the_error()

LazyDateбыл уволен ¶

Не LazyDateвспомогательный класс больше не существует.

Значения полей по умолчанию и аргументы запроса могут быть вызываемыми объектами, поэтому экземпляры LazyDateмогут быть заменены ссылкой на datetime.datetime.now:

Старая версия (0.96):

class Article(models.Model):
    title = models.CharField(maxlength=100)
    published = models.DateField(default=LazyDate())

Новое (1.0):

import datetime

class Article(models.Model):
    title = models.CharField(max_length=100)
    published = models.DateField(default=datetime.datetime.now)

DecimalFieldявляется новым и FloatFieldтеперь является правильным поплавком ¶

Старая версия (0.96):

class MyModel(models.Model):
    field_name = models.FloatField(max_digits=10, decimal_places=3)
    ...

Новое (1.0):

class MyModel(models.Model):
    field_name = models.DecimalField(max_digits=10, decimal_places=3)
    ...

Если вы забудете внести это изменение, вы увидите ошибки о FloatField том, что max_digitsатрибут не используется __init__, потому что новый не FloatFieldпринимает аргументов, связанных с точностью.

Если вы используете MySQL или PostgreSQL, никаких дополнительных изменений не требуется. Типы столбцов базы данных DecimalFieldтакие же, как и для старого FloatField.

Если вы используете SQLite, вам нужно заставить базу данных просматривать соответствующие столбцы как десятичные типы, а не как числа с плавающей запятой. Для этого вам нужно перезагрузить данные. Сделайте это после того, как вы изменили использование DecimalFieldв своем коде и обновили код Django.

Чтобы обновить каждое приложение для использования DecimalField, вы можете сделать следующее, заменив <app>в приведенном ниже коде имя каждого приложения:

$ ./manage.py dumpdata --format=xml <app> > data-dump.xml
$ ./manage.py reset <app>
$ ./manage.py loaddata data-dump.xml

Заметки:

1. Важно не забыть использовать формат XML на первом этапе этого процесса. Мы используем функцию дампов XML-данных, которая позволяет переносить числа с плавающей запятой в десятичные с помощью SQLite.
2. На втором этапе вам будет предложено подтвердить, что вы готовы потерять данные для рассматриваемых приложений. Скажи да; мы восстановим эти данные на третьем шаге.
3. DecimalField не используется ни в одном из приложений, поставляемых с Django до внесения этого изменения, поэтому вам не нужно беспокоиться о выполнении этой процедуры для любой из стандартных моделей Django.

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

django.views.i18n.set_language()теперь требуется запрос POST ¶

Раньше использовался запрос GET. Старое поведение означало, что состояние (языковой стандарт, используемый для отображения сайта) можно было изменить с помощью запроса GET, что противоречит рекомендациям спецификации HTTP. Код, вызывающий это представление, должен гарантировать, что теперь выполняется запрос POST, а не GET. Это означает, что вы больше не можете использовать ссылку для доступа к представлению, но должны использовать какую-либо форму отправки (например, кнопку).

_()больше не во встроенных ¶

_() (вызываемый объект, имя которого состоит из одного символа подчеркивания) больше не используется во встроенных функциях обезьяны - то есть он больше не доступен волшебным образом в каждом модуле.

Если раньше вы полагались на _()постоянное присутствие, теперь вы должны явно импортировать ugettextили ugettext_lazy, при необходимости, присвоить ему псевдоним _:

from django.utils.translation import ugettext as _

Доступ к словарю HttpRequest¶

HttpRequestобъекты больше не поддерживают прямой доступ в стиле словаря; ранее, как GETи POSTданные были доступны непосредственно на HttpRequestобъекте (например, вы можете проверить на куске данных формы с использованием или с помощью чтения Это больше не поддерживается;. , если вам нужен доступ к комбинированной и данных, использование вместо этого.if 'some_form_key' in requestrequest['some_form_key']GETPOSTrequest.REQUEST

Однако настоятельно рекомендуется всегда явно искать в соответствующем словаре тип запроса, который вы ожидаете получить ( request.GETили request.POST); использование комбинированного request.REQUESTсловаря может маскировать происхождение входящих данных.

Доступ к HTTPResponseзаголовкам ¶

django.http.HttpResponse.headersбыл переименован в _headersи HttpResponseтеперь поддерживает проверку содержания напрямую. Так что используйте вместо .if header in response:if header in response.headers:

Родовые связи были перемещены из ядра ¶

Классы общих отношений - GenericForeignKeyи GenericRelation - перемещены в django.contrib.contenttypesмодуль.

django.test.Client.login()изменилось ¶

Старая версия (0.96):

from django.test import Client
c = Client()
c.login('/path/to/login','myuser','mypassword')

Новое (1.0):

# ... same as above, but then:
c.login(username='myuser', password='mypassword')

Запуск команд управления из вашего кода ¶

django.core.management был сильно отремонтирован.

Вызовы к службам управления в вашем коде теперь нужно использовать call_command. Например, если у вас есть тестовый код, который вызывает flush и load_data:

from django.core import management
management.flush(verbosity=0, interactive=False)
management.load_data(['test_data'], verbosity=0)

… Вам нужно изменить этот код, чтобы он читался:

from django.core import management
management.call_command('flush', verbosity=0, interactive=False)
management.call_command('loaddata', 'test_data', verbosity=0)

Подкоманды теперь должны предшествовать параметрам ¶

django-admin.pyи manage.pyтеперь требуются подкоманды перед параметрами. Так:

$ django-admin.py --settings=foo.bar runserver

… Больше не работает и должен быть изменен на:

$ django-admin.py runserver --settings=foo.bar

Feed.__init__изменилось ¶

__init__()Метод фреймворка объединения в синдикаты в Feedклассе в настоящее время принимает HttpRequestобъект в качестве второго параметра, вместо URL фида. Это позволяет фреймворку синдикации работать без фреймворка сайтов. Это влияет только на код, который создает подклассы Feedи переопределяет __init__()метод, и код, который вызывает Feed.__init__()напрямую.

SortedDictFromListушел ¶

django.newforms.forms.SortedDictFromListбыл удален. django.utils.datastructures.SortedDictтеперь можно создать экземпляр с последовательностью кортежей.

Чтобы обновить свой код:

1. Используйте django.utils.datastructures.SortedDictвезде, где вы использовали django.newforms.forms.SortedDictFromList.
2. Поскольку django.utils.datastructures.SortedDict.copyне возвращает глубокую копию, как SortedDictFromList.copy()это было, вам нужно будет обновить свой код, если вы полагались на глубокую копию. Сделайте это, используя copy.deepcopyнапрямую.

Бэкэнд-функции базы данных были переименованы ¶

Почти все функции базового уровня базы данных были переименованы и / или перемещены. Ничего из этого не было задокументировано, но вам нужно будет изменить свой код, если вы используете любую из этих функций, все из которых находятся в django.db: