Django 1.0은 일부 영역에서 0.96과 호환되지 않습니다.
\n이 가이드는 0.96 프로젝트 및 앱을 1.0으로 포팅하는 것을 알려드립니다. 이 문서의 첫 번째 부분에는 1.0에서 실행하는 데 필요한 일반적인 변경 사항이 포함되어 있습니다. 첫 번째 부분을 진행한 후에도 코드가 여전히 깨지면, 덜 일반적인 변경 사항 섹션에서 덜 일반적인 호환성 문제 목록을 확인하세요.
\n\n이 섹션에서는 대부분의 사용자가 수행해야 하는 0.96과 1.0 사이의 변경 사항에 대해 설명합니다.
\n문자열 리터럴('foo')을 유니코드 리터럴(u'foo')로 변경합니다. Django는 이제 전체적으로 유니코드 문자열을 사용합니다. 대부분의 경우, 원시 문자열은 계속 작동하지만 유니코드 리터럴을 사용하도록 업데이트하면 모호한 문제를 방지할 수 있습니다.
자세한 내용은 :doc:`/ref/unicode`를 참조하십시오.
\n모델 파일에 대한 일반적인 변경 사항:
\nmaxlength 인수의 이름을 ``max_length``로 바꾸십시오(양식 필드와 일치하도록 변경됨):
모델의 __str__ 함수를 __unicode__ 메서드로 바꾸고, 해당 메서드에서 유니코드를 사용`_(``u’foo’`)하고 있는지 확인하세요.
prepopulated_from 제거Link to this heading#모델 필드에서 prepopulated_from 인수를 제거하십시오. 이는 더 이상 유효하지 않으며, admin.py``의 ``ModelAdmin 클래스로 이동되었습니다. 관리자 변경에 대한 자세한 내용은 아래의 `관리자`_를 참조하십시오.
코어 제거Link to this heading#모델 필드에서 core 인수를 제거하십시오. 이는 동등한 기능(:ref:’인라인 편집 <admin-inlines>’의 일부)이 이제 관리자 인터페이스에서 다르게 처리되기 때문에 더 이상 필요하지 않습니다. 아래의 관리자 섹션에 도달할 때까지 인라인 편집에 대해 걱정할 필요가 없습니다. 지금은 ``core``에 대한 모든 참조를 제거합니다.
모델에서 모든 내부 class Admin 선언을 제거하십시오. 제거하지 않으면 문제가 되는 것은 아니지만, 아무 역할도 하지 않을 것입니다. 관리자에게 앱을 등록하려면 해당 선언을 admin.py 파일로 이동해야 합니다. 자세한 내용은 아래의 `관리자`_를 참조하십시오.
다음은 필요한 모든 변경 사항이 포함된 models.py 파일의 예입니다:
오래된 (0.96) models.py:
class Author(models.Model):\n first_name = models.CharField(maxlength=30)\n last_name = models.CharField(maxlength=30)\n slug = models.CharField(maxlength=60, prepopulate_from=("first_name", "last_name"))\n\n class Admin:\n list_display = ["first_name", "last_name"]\n\n def __str__(self):\n return "%s %s" % (self.first_name, self.last_name)\n신규 (1.0) models.py:
class Author(models.Model):\n first_name = models.CharField(max_length=30)\n last_name = models.CharField(max_length=30)\n slug = models.CharField(max_length=60)\n\n def __unicode__(self):\n return "%s %s" % (self.first_name, self.last_name)\n신규 (1.0) admin.py:
from django.contrib import admin\nfrom models import Author\n\n\nclass AuthorAdmin(admin.ModelAdmin):\n list_display = ["first_name", "last_name"]\n prepopulated_fields = {"slug": ("first_name", "last_name")}\n\n\nadmin.site.register(Author, AuthorAdmin)\n1.0의 가장 큰 변화 중 하나는 새로운 관리자입니다. Django 관리 인터페이스(django.contrib.admin)가 완전히 리팩토링되었습니다. 관리자 정의는 이제 모델 정의에서 완전히 분리되었으며, 프레임워크는 Django의 새로운 양식 처리 라이브러리를 사용하도록 재작성되었으며, 확장성과 사용자 지정을 염두에 두고 재설계되었습니다.
실질적으로, 이는 모든 class Admin 선언을 다시 작성해야 함을 의미합니다. 위의 models`_에서 ``admin.py` 파일에서 class Admin``을 ``admin.site.register() 호출로 대체하는 방법을 이미 보았습니다. 다음은 Admin 선언을 새 구문으로 다시 작성하는 방법에 대한 자세한 내용입니다.
새로운 edit_inline 옵션이 모두 ``admin.py``로 이동되었습니다. 예를 들면 다음과 같습니다:
이전 (0.96):
\nclass Parent(models.Model):\n ...\n\n\nclass Child(models.Model):\n parent = models.ForeignKey(Parent, edit_inline=models.STACKED, num_in_admin=3)\n신규 (1.0):
\nclass ChildInline(admin.StackedInline):\n model = Child\n extra = 3\n\n\nclass ParentAdmin(admin.ModelAdmin):\n model = Parent\n inlines = [ChildInline]\n\n\nadmin.site.register(Parent, ParentAdmin)\n자세한 내용은 :ref:`admin-inlines`을 참조하십시오.
\nfields 단순화 또는 fieldsets 사용Link to this heading#이전 fields 구문은 매우 혼란스러웠기 때문에 단순화되었습니다. 이전 구문은 여전히 작동하지만, 대신 ``fieldsets``를 사용해야 합니다.
이전 (0.96):
\nclass ModelOne(models.Model):\n ...\n\n class Admin:\n fields = ((None, {"fields": ("foo", "bar")}),)\n\n\nclass ModelTwo(models.Model):\n ...\n\n class Admin:\n fields = (\n ("group1", {"fields": ("foo", "bar"), "classes": "collapse"}),\n ("group2", {"fields": ("spam", "eggs"), "classes": "collapse wide"}),\n )\n신규 (1.0):
\nclass ModelOneAdmin(admin.ModelAdmin):\n fields = ("foo", "bar")\n\n\nclass ModelTwoAdmin(admin.ModelAdmin):\n fieldsets = (\n ("group1", {"fields": ("foo", "bar"), "classes": "collapse"}),\n ("group2", {"fields": ("spam", "eggs"), "classes": "collapse wide"}),\n )\nurls.py 업데이트Link to this heading#관리 사이트를 사용하는 경우, 루트 ``urls.py``를 업데이트해야 합니다.
\n이전(0.96) urls.py:
from django.conf.urls.defaults import *\n\nurlpatterns = patterns(\n "",\n (r"^admin/", include("django.contrib.admin.urls")),\n # ... the rest of your URLs here ...\n)\n신규 (1.0) urls.py:
from django.conf.urls.defaults import *\n\n# The next two lines enable the admin and load each admin.py file:\nfrom django.contrib import admin\n\nadmin.autodiscover()\n\nurlpatterns = patterns(\n "",\n (r"^admin/(.*)", admin.site.root),\n # ... the rest of your URLs here ...\n)\nnewforms 대신 django.forms 사용Link to this heading#django.newforms``를 ``django.forms``로 바꾸십시오 -- Django 1.0은 ``newforms 모듈(0.96에 도입됨)을 일반 이전 forms``로 이름을 바꿨습니다. ``oldforms 모듈도 제거되었습니다.
이미 newforms 라이브러리를 사용 중이고, 권장하는 import 문 구문을 사용했다면, import 문을 변경하기만 하면 됩니다.
이전:
\nfrom django import newforms as forms\n신규:
\nfrom django import forms\n이전 양식 시스템(이전의 django.forms 및 django.oldforms)을 사용하는 경우, 양식을 다시 작성해야 합니다. :doc:`양식 문서 </topics/forms/index>`을 통해 시작하는 것이 좋습니다.
업로드된 파일(즉, request.FILES 항목)의 사용을 새로운 :class:`~django.core.files.uploadedfile.UploadedFile`로 간단한 사전으로 대체하십시오. 이전 사전 구문은 더 이상 작동하지 않습니다.
따라서, 다음과 같은 뷰에서:
\ndef my_view(request):\n f = request.FILES["file_field_name"]\n ...\n…다음과 같이 변경해야 합니다:
\n이전 (0.96) | \n신규 (1.0) | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
:class:`django.db.models.FileField`의 내부 구현이 변경되었습니다. 모델 필드의 특수 속성(URL, 파일 이름, 이미지 크기 등)에 액세스하는 방식이 변경되었습니다. 모델의 :class:`~django.db.models.FileField`가 ``myfile``이라고 가정하고 다음과 같이 변경해야 합니다:
\n이전 (0.96) | \n신규 (1.0) | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
width 및 height 속성은 ImageField 필드에만 의미가 있습니다. 자세한 내용은 model API 문서에서 찾을 수 있습니다.
ObjectPaginator 대신 Paginator 사용Link to this heading#0.96의 ``ObjectPaginator``가 제거되고, 개선된 버전인 :class:`django.core.paginator.Paginator`로 대체되었습니다.
\n기본적으로, 템플릿 시스템은 이제 모든 변수의 출력을 자동으로 HTML 이스케이프 처리합니다. 자세한 내용은 :ref:`automatic-html-escaping`을 참조하십시오.
\n개별 변수에 대한 자동 이스케이프를 비활성화하려면 safe 필터를 사용하세요:
This will be escaped: {{ data }}\nThis will not be escaped: {{ data|safe }}\n전체 템플릿에 대해 자동 이스케이프를 비활성화하려면, 템플릿(또는 템플릿의 특정 섹션)을 autoescape 태그로 래핑합니다:
{% autoescape off %}\n ... unescaped template content here ...\n{% endautoescape %}\n다음 변경 사항은 더 작고 지역화된 변경 사항입니다. 고급 사용자에게만 영향을 주지만, 목록을 읽고 이러한 사항에 대한 코드를 확인하는 것이 좋습니다.
\n``django.dispatch.dispatcher``의 모듈 메서드 대신 Signal 객체의 메서드를 통해 신호를 연결, 연결 해제 및 전송합니다.
Anonymous 및 Any 발신자 옵션 사용을 제거하십시오. 그들은 더 이상 존재하지 않습니다. ``sender=None``을 사용하여 모든 보낸 사람이 보낸 신호를 계속 받을 수 있습니다.
익명 객체 대신 django.dispatch.Signal 인스턴스로 선언한 사용자 지정 시그널을 만듭니다.
다음은 수행해야 하는 코드 변경에 대한 간략한 요약입니다:
\n이전 (0.96) | \n신규 (1.0) | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
Django 0.96의 django.contrib.comments 앱을 사용하고 있었다면, 1.0에 도입된 새로운 코멘트 앱으로 업그레이드해야 합니다. 자세한 내용은 업그레이드 가이드를 참조하세요.
``django.contrib.localflavor.usa``는 ``django.contrib.localflavor.us``로 이름이 변경되었습니다. 이 변경은 다른 지역 풍미의 명명 체계와 일치하도록 만들어졌습니다. 코드를 마이그레이션하려면, import를 변경하기만 하면 됩니다.
\n``SessionBase.get_new_session_key()``는 ``_get_new_session_key()``로 이름이 변경되었습니다. ``get_new_session_object()``는 더 이상 존재하지 않습니다.
\n이전에는 행을 로드하면 모델의 save() 메서드가 자동으로 실행되었습니다. 이제는 실행되지 않으므로, ``save()``에 의해 자동으로 채워진 모든 필드(예: 타임스탬프)는 이제 모든 픽스처에 명시적인 값이 필요합니다.
이전 EnvironmentError`는 :exc:`ImportError (Django가 설정 모듈을 찾는 데 실패할 때)와, RuntimeError (이미 사용한 후에 설정을 재구성하려고 할 때)로 분할되었습니다.
LOGIN_URL 상수가 django.contrib.auth``에서 ``settings 모듈로 이동했습니다. ``from django.contrib.auth import LOGIN_URL``을 사용하는 대신 :setting:`settings.LOGIN_URL <LOGIN_URL>`을 참조하십시오.
APPEND_SLASH 동작이 업데이트되었습니다.Link to this heading#0.96에서 URL이 슬래시로 끝나지 않거나, 경로의 마지막 구성 요소에 마침표가 있고 :setting:`APPEND_SLASH`가 True인 경우 Django는 동일한 URL로 리디렉션되지만 끝에 슬래시가 추가됩니다. 이제 Django는 후행 슬래시가 없는 패턴이 URL 패턴의 무언가와 일치하는지 확인합니다. 만약 일치한다면 의도적으로 해당 패턴을 포착하려 했다고 가정하고 리디렉션이 발생하지 않습니다.
\n대부분의 경우, 아무런 변경이 필요하지 않습니다. 그러나 어떤 사람들은 다음과 같은 URL 패턴을 가지고 있습니다:
\nr"/some_prefix/(.*)$"\n이전에는 이러한 패턴이 후행 슬래시를 갖도록 리디렉션되었습니다. 이러한 URL에 항상 슬래시를 사용하고 싶다면, 패턴을 다음과 같이 다시 작성하세요:
\nr"/some_prefix/(.*/)$"\n매니저는 이제 AssertionError 대신 MultipleObjectsReturned 예외를 리턴합니다.
이전 (0.96):
\ntry:\n Model.objects.get(...)\nexcept AssertionError:\n handle_the_error()\n신규 (1.0):
\ntry:\n Model.objects.get(...)\nexcept Model.MultipleObjectsReturned:\n handle_the_error()\nLazyDate 헬퍼 클래스는 더 이상 존재하지 않습니다.
기본 필드 값과 쿼리 인수는 모두 콜러블 객체가 될 수 있으므로, LazyDate 인스턴스를 ``datetime.datetime.now``에 대한 레퍼런스로 대체할 수 있습니다:
이전 (0.96):
\nclass Article(models.Model):\n title = models.CharField(maxlength=100)\n published = models.DateField(default=LazyDate())\n신규 (1.0):
\nimport datetime\n\n\nclass Article(models.Model):\n title = models.CharField(max_length=100)\n published = models.DateField(default=datetime.datetime.now)\n이전 (0.96):
\nclass MyModel(models.Model):\n field_name = models.FloatField(max_digits=10, decimal_places=3)\n ...\n신규 (1.0):
\nclass MyModel(models.Model):\n field_name = models.DecimalField(max_digits=10, decimal_places=3)\n ...\n이 변경을 잊어버리면, FloatField``가 ``__init__``에서 ``max_digits 속성을 사용하지 않는다는 오류가 표시됩니다. 왜냐하면 새로운 ``FloatField``는 정밀도 관련 인수를 사용하지 않기 때문입니다.
MySQL 또는 PostgreSQL을 사용하는 경우, 아무런 추가 변경이 필요하지 않습니다. ``DecimalField``에 대한 데이터베이스 열 유형은 이전 ``FloatField``와 동일합니다.
\nSQLite를 사용하는 경우, 데이터베이스에서 적절한 열을 부동 소수점이 아닌 십진수 유형으로 다루도록 강제해야 합니다. 이렇게 하려면 데이터를 다시 로드해야 합니다. 코드에서 ``DecimalField``를 사용하도록 변경하고, Django 코드를 업데이트한 후에 이 작업을 수행하십시오.
\n\n``DecimalField``를 사용하도록 각 애플리케이션을 업그레이드하려면, 아래 코드에서 ``<app>``을 각 앱의 이름으로 대체하여 다음을 수행할 수 있습니다:
\n$ ./manage.py dumpdata --format=xml <app> > data-dump.xml\n$ ./manage.py reset <app>\n$ ./manage.py loaddata data-dump.xml\n각주:
\n이 프로세스의 첫 번째 단계에서 XML 형식을 사용하는 것을 기억하는 것이 중요합니다. 우리는 SQLite를 사용하여 부동 소수점을 십진법으로 이식할 수 있는 XML 데이터 덤프의 기능을 이용하고 있습니다.
두 번째 단계에서는 해당 응용 프로그램의 데이터를 잃을 준비가 되었는지 확인하라는 메시지가 표시됩니다. ‘네’라고 대답하십시오; 세 번째 단계에서 이 데이터를 복원할 것입니다.
``DecimalField``는 이 변경 이전에 Django와 함께 제공되는 앱에서는 일절 사용되지 않으므로, 표준 Django 모델에 대해 이 절차를 수행하는 것에 대해 걱정할 필요가 없습니다.
위의 과정에서 문제가 발생하면, 백업된 데이터베이스 파일을 원본 파일에 복사하고 다시 시작하면 됩니다.
\n이전에는 GET 요청이 사용되었습니다. 이전 동작은 상태(사이트를 표시하는 데 사용되는 로케일)가 HTTP 사양의 권장 사항에 위배되는 GET 요청에 의해 변경될 수 있음을 의미했습니다. 이 뷰를 호출하는 코드는 이제 GET 대신 POST 요청이 이루어지도록 해야 합니다. 즉, 더 이상 링크를 사용하여 뷰에 액세스할 수 없지만, 일종의 양식 제출(예: 버튼)을 사용해야 합니다.
\n``_()``(이름이 단일 밑줄인 호출 가능한 객체)는 더 이상 내장 함수들에 몽키패치되지 않습니다. 즉, 더 이상 모든 모듈에서 사용할 수 없습니다.
\n이전에 항상 존재하는 _()``에 의존했다면, 이제 적절하다면 ``ugettext 또는 ``ugettext_lazy``를 명시적으로 임포트하고 직접 ``_``에 별칭을 지정해야 합니다:
from django.utils.translation import ugettext as _\nHttpRequest 개체는 더 이상 사전 스타일 액세스를 직접 지원하지 않습니다. 이전에는 if 'some_form_key' in request``를 사용하거나 ``request['some_form_key']``를 읽음으로써 ``GET 및 POST 데이터 모두 HttpRequest 객체에서 직접 사용할 수 있었습니다. 이것은 더 이상 지원되지 않습니다. 결합된 GET 및 POST 데이터에 액세스해야 하는 경우, 대신 ``request.REQUEST``를 사용하십시오.
그러나 수신될 것으로 예상되는 요청 유형(request.GET 또는 request.POST)에 대해 항상 적절한 사전을 명시적으로 찾아볼 것을 강력하게 제안합니다. 결합된 request.REQUEST 사전에 의존하면 들어오는 데이터의 출처를 숨길 수 있습니다.
HTTPResponse 헤더 접근Link to this heading#django.http.HttpResponse.headers``는 ``_headers``로 이름이 바뀌었고 :class:`~django.http.HttpResponse`는 이제 포함 검사를 직접 지원합니다. 따라서 ``if header in response.headers: 대신 ``if header in response:``를 사용하십시오.
범용 관계 클래스 – GenericForeignKey 및 GenericRelation –은 django.contrib.contenttypes 모듈로 이동했습니다.
이전 (0.96):
\nfrom django.test import Client\n\nc = Client()\nc.login("/path/to/login", "myuser", "mypassword")\n신규 (1.0):
\n# ... same as above, but then:\nc.login(username="myuser", password="mypassword")\n:mod:`django.core.management`가 크게 리팩토링되었습니다.
\n코드에서 관리 서비스에 대한 호출은 이제 ``call_command``를 사용해야 합니다. 예를 들어, flush 및 load_data를 호출하는 테스트 코드가 있는 경우:
\nfrom django.core import management\n\nmanagement.flush(verbosity=0, interactive=False)\nmanagement.load_data(["test_data"], verbosity=0)\n…이 코드를 다음과 같이 변경해야 합니다:
\nfrom django.core import management\n\nmanagement.call_command("flush", verbosity=0, interactive=False)\nmanagement.call_command("loaddata", "test_data", verbosity=0)\ndjango-admin.py 및 ``manage.py``는 이제 옵션 앞에 하위 명령이 필요합니다. 그래서:
$ django-admin.py --settings=foo.bar runserver\n…더 이상 작동하지 않으며 다음으로 변경해야 합니다.
\n$ django-admin.py runserver --settings=foo.bar\nSortedDictFromList 사라짐Link to this heading#``django.newforms.forms.SortedDictFromList``가 제거되었습니다. ``django.utils.datastructures.SortedDict``는 이제 일련의 튜플로 인스턴스화될 수 있습니다.
\n코드를 업데이트하려면:
\n\n거의 모든 데이터베이스 백엔드 수준 함수들의 이름이 바뀌거나 재배치되었습니다. 이 중 어느 것도 문서화되지는 않았지만, 이러한 함수들을 사용하는 경우 코드를 변경해야 합니다. 이 함수들은 모두 :mod:`django.db`에 있습니다.
\n이전 (0.96) | \n신규 (1.0) | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n