Django 1.0 memutus kesesuaian dengan 0.96 di beberapa kawasan.
\nPanduan ini akan membantu anda menghubungkan proyek 0.96 dan apliaksi ke 1.0. Bagian pertama dari dokumen ini termasuk perubahan umum dibutuhkan untuk berjalan dengan 1.0. Jika setelah melalui bagian pertama kode anda masih rusak, periksa bagian Less-common Changes untuk daftar ikatan masalah kesesuaian yang kurang umum.
\n\nBagian ini menggambarkan perubahan diantara 0.96 dan 1.0 yang paling pengguna butuhkan untuk dibuat.
\nMerubah harfiah deretan karakter ('foo') menjadi harfiah Unicode (u'foo'). Django sekarang menggunakan deretan karakter Unicode seluruhnya. Di kebanyakan tempat, deretan karakter mentah akan lanjut bekerja, tetapi memperbaharui untuk menggunakan harfiah Unicode akan mencegah pengaburan beberapa masalah.
Lihat Data Unicode untuk rincian penuh.
\nPerubahan umum ke berkas model anda:
\nmaxlength ke max_lengthLink to this heading#Namai kembali argumen maxlength anda ke max_length (ini dirubah agar selaras dengan bidang-bidang formulir):
__str__ dengan __unicode__Link to this heading#Ganti fungsi __str__ model anda dengan metode __unicode__, dan pastikan anda use Unicode (u'foo') di metode itu.
prepopulated_fromLink to this heading#Pindahkan argumen prepopulated_from pada bidang model. Itu tidak lagi sah dan telah dipindahkan ke kelas ModelAdmin di admin.py. Lihat the admin, dibawah ini, untuk rincian lebih tentang dirubah ke admin.
coreLink to this heading#Pindahkan argumen core dari bidang model anda. itu tidak lagi dibutuhkan, sejak kegunaan yang setara (bagian dari inline editing) ditangani dengan berbeda oleh antarmuka admin sekarang. Anda tidak harus khawatir tentang penyuntingan berderet sampai anda menuju bagian the admin, dibawah. Untuk sekarang, pindahkan semua acuan ke core.
class Admin: dengan admin.pyLink to this heading#Pindahkan semua pernyataan class Admin sebelah dalam dari model anda. Mereka tidak merusak apapun jika anda meninggalkan mereka, tetapi mereka juga tidak akan melakukan apapun. Untuk mendaftarkan aplikasi dengan admin anda akan pindahkan pernyataan itu ke berkas admin.py; lihat the admin dibawah untuk lebih rinci.
DIbawah ini adalah sebuah contoh berkas models.py dengan semua perubahan anda ingin buat:
Lama (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)\nBaru (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)\nBaru (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)\nSatu dari perubahan terbesar di 1.0 adalah admin baru. Antarmuka administratif Django (django.contrib.admin) telah sepenuhnya di refaktor; pengertian admin sekarang sepenuhnya dipisahkan dari pengertian model, kerangka kerja telah ditulis kembali untuk menggunakan pustaka penanganan formulir baru Django dan dirancang kembali dengan perpanjangan dan penyesuaian dalam pikiran.
Practically, this means you'll need to rewrite all of your class Admin\ndeclarations. You've already seen in models above how to replace your class\nAdmin with an admin.site.register() call in an admin.py file. Below are\nsome more details on how to rewrite that Admin declaration into the new\nsyntax.
Pilihan edit_inline baru semua telah dipindahkan ke admin.py. Ini adalah contoh:
Lama (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)\nBaru (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)\nLihat Obyek InlineModelAdmin untuk rinci.
\nfields, atau gunakan fieldsetsLink to this heading#Sintaksis fields lama sangat membingungkan, dan telah disederhanakan. Sintaksis lama masih bekerja, tetapi anda akan butuh menggunakan fieldsets sebagai gantinya.
Lama (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 )\nBaru (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 anda.Link to this heading#Jika anda menggunakan situs admin, anda butuh memperbaharui akar urls.py anda.
Lama (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)\nBaru (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)\ndjango.forms sebagai gantinya newformsLink to this heading#Ganti django.newforms dengan django.forms -- Django 1.0 dinamai kembali modul newforms (diperkenalkan di 0.96) untuk forms lama kosong. Modul oldforms juga dipindahkan.
Jika anda sudah menggunakan pustaka newforms, dan anda menggunakan anjuran kami sintaksis pernyataan import, semua anda harus lakukan adalah merubah pernyataan impor anda.
Lama:
\nfrom django import newforms as forms\nBaru:
\nfrom django import forms\nJika anda sedang menggunakan sistem formulir lama (dahulu dikenal sebagai django.forms dan django.oldforms), anda akan harus menuli skembali formulir anda. Tempat bagus untuk memulai adalah forms documentation
Rubah penggunaan berkas-berkas terunggah -- yaitu, masukan di request.FILES -- sebagai kamus sederhana dengan UploadedFile baru. Sintaksis kamus lama tidak lagi bekerja.
Jadi, dalam tampilan seperti:
\ndef my_view(request):\n f = request.FILES["file_field_name"]\n ...\n...anda butuh membuat perubahan berikut:
\nLama (0.96) | \nBaru (1.0) | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
Penerapan internal dari django.db.models.FileField telah berubah. Hasil nampak dari ini adalah bahwa cara anda mengakses atribut khusus (URL, berkas nama, ukuran gambar, dll.) dari bidang model ini telah berubah. Anda akan butuh membuat perubahan berikut, menganggap FileField model anda dipanggil myfile:
Lama (0.96) | \nBaru (1.0) | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
Catat bahwa atribut width dan height hanya masuk akal untuk bidang ImageField. Rincian lebih dapat ditemukan di dokumentasi model API.
Paginator daripada ObjectPaginatorLink to this heading#ObjectPaginator di 0.96 telah dipindahkan dan diganti dengan versi diperbaiki, django.core.paginator.Paginator.
Secara awal, sistem cetakan sekarang otomatis meloloskan HTML keluaran setiap variabel. Untuk mempelajari lebih, lihat Pelolosan HTML otomatis.
\nUntuk meniadakan pelolosan otomatis untuk variabel tersendiri, gunakan safe filter:
This will be escaped: {{ data }}\nThis will not be escaped: {{ data|safe }}\nUntuk meniadakan pelolosan otomatis untuk keseluruhan cetakan, bungkus cetakan (atau cukup bagian tertentu dari cetakan) di etiket autoescape:
{% autoescape off %}\n ... unescaped template content here ...\n{% endautoescape %}\nPerubahan berikut lebih kecil, lebih perubahan lokal. Mereka hanya berpengaruh lebih pengguna lanjutan, tetapi itu mungkin bernilai baik membaca melalui daftar dan memeriksa kode anda untuk hal-hal ini.
\nTambah **kwargs pada setiap penangan sinyal terdaftar.
Hubungkan, putuskan, dan kirim sinyal melalui metode pada obyek Signal daripada melalui modul metode di django.dispatch.dispatcher.
Pindahkan tiap penggunaan pilihan pengirim Anonymous dan Any; mereka tidak lagi ada. Anda masih dapat menerima sinyal dikirim oleh pengirim dengan menggunakan sender=None
Buat sinyal penyesuaian apa saja anda telah nyatakan kedalam instance dari django.dispatch.Signal sebagai ganti dari obyek anonim.
Berikut rekap dari perubahan kode yang perlu anda lakukan:
\nLama (0.96) | \nBaru (1.0) | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
Jika anda menggunakan aplikasi django.contrib.comments Django 0.96, anda akan btuuh meningkatkan ke aplikasi komentar baru diperkenalkan di 1.0. Lihat panduan peningkatan untuk rincian.
django.contrib.localflavor.usa telah dinamai kembali ke django.contrib.localflavor.us. Perubahan ini dibuat untuk mencocokan penamaan skema dari rasa lokal lainnya. Untuk memindahkan kode anda, anda yang butuh lakukan adalah merubah impor.
SessionBase.get_new_session_key() telah dinamai kembali menjadi _get_new_session_key(). get_new_session_object() tidak lagi ada.
save()Link to this heading#Sebelumnya, memuat sebuah baris secara otomatis menjalankan metode save() model. Ini bukan lagi kasus, jadi tiap bidang (sebagai contoh: timestamp) yang dikumpulkan otomatis oleh save() sekarang butuh nilai eksplisit di tiap perlengkapan tetap.
EnvironmentError lama telah dipisah menjadi ImportError ketika Django gagal menemukan modul pengaturan dan RuntimeError ketika anda mencoba mengkonfigurasi kembali pengaturan setelah selesai menggunakan mereka.
LOGIN_URL telah dipindahkanLink to this heading#Ketetapan LOGIN_URL dipindah dari django.contrib.auth kedalam modul settings. Daripada menggunakan from django.contrib.auth import LOGIN_URL mengacu pada settings.LOGIN_URL.
APPEND_SLASH telah diperbaharuiLink to this heading#Di 0.96, jika sebuah URL tidak berakhir di garis miring atau mempunyai titik di akhir komponen dari jalurnya, dan APPEND_SLASH adalah True, Django akan mengalihkan ke URL sama, tetapi dengan tanda miring ditambahkan pada akhir. Sekarang, Django memeriksa apakah pola tanpa ekor garis miring akan cocok oleh sesuatu di pola URL anda. Jika demikian, tidak ada pengalihan, karena itu dianggap anda sengaja ingin menangkap pola itu.
Untuk kebanyakan orang, ini tidak akan membutuhkan perubahan. Beberapa orang, meskipun, mempunyai pola URL yang terlihat seperti ini:
\nr"/some_prefix/(.*)$"\nSebelumnya, pola itu akan dialihkan untuk mempunyai sebuah ekor garis miring. Jika anda selalu ingin garis miring pada URL itu, tulis kembali pola sebagai:
\nr"/some_prefix/(.*/)$"\nget()Link to this heading#Pengelola sekarang mengembalikan pengecualian MultipleObjectsReturned daripada AssertionError:
Lama (0.96):
\ntry:\n Model.objects.get(...)\nexcept AssertionError:\n handle_the_error()\nBaru (1.0):
\ntry:\n Model.objects.get(...)\nexcept Model.MultipleObjectsReturned:\n handle_the_error()\nLazyDate telah dinyalakanLink to this heading#Kelas pembantu LazyDate tidak lagi ada.
Nilai bidang awalan dan permintaan argumen keduanya obyek callable, jadi instance dari LazyDate dapat diganti dengan acuan pada datetime.datetime.now:
Lama (0.96):
\nclass Article(models.Model):\n title = models.CharField(maxlength=100)\n published = models.DateField(default=LazyDate())\nBaru (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)\nDecimalField adalah baru, dan FloatField sekarang float tepat.Link to this heading#Lama (0.96):
\nclass MyModel(models.Model):\n field_name = models.FloatField(max_digits=10, decimal_places=3)\n ...\nBaru (1.0):
\nclass MyModel(models.Model):\n field_name = models.DecimalField(max_digits=10, decimal_places=3)\n ...\nJika anda lupa membuat perubahan ini, anda akan melihat kesalahan tentang FloatField bukan mengambil atribut max_digits di __init__, karena FloatField baru mengambil argumen terkait tidak teliti.
Jika anda sedang menggunakan MySQL atau PostgreSQL, tidak dibtuuhkan perubahan lebih lanjut. Jenis kolom basisdata untuk DecimalField adalah sama untuk FloatField lama.
Jika anda menggunakan SQLite, anda butuh memaksa basisdata melihat kolom yang sesuai sebagai jenis desimal, daripada float. untuk melakukan ini, anda akan butuh memuat kembali data anda. Lakukam ini setelah anda membuat perubahan untuk menggunakan DecimalField di kode anda dan kode Django diperbaharui.
Untuk meningkatkan setiap aplikasi untuk menggunakan sebuah DecimalField, anda dapat melakukan berikut, mengganti <app> di kode dibawah ini dengan setiap nama aplikasi:
$ ./manage.py dumpdata --format=xml <app> > data-dump.xml\n$ ./manage.py reset <app>\n$ ./manage.py loaddata data-dump.xml\nCatatan:
\nItu sangat penting bahwa anda mengingat untuk menggunakan bentuk XML dalam langkah pertama dari pengolahan ini. Kami sedang menggunakan fitur dari data buangan XML yang membuat belokan float ke desimal dengan SQLite memungkinkan.
In the second step you will be asked to confirm that you are prepared to\nlose the data for the application(s) in question. Say yes; we'll restore\nthis data in the third step.
DecimalField tidak digunakan di tiap aplikasi yang dibekali dengan Django sebelum perubahan ini dibuat, jadi anda tidak butuh khawatir tentang melakukan prosedur ini untuk tiap model Django standar.
Jika sesuatu berjalan salah di pengolahan diatas, cukup salin berkas basisdata sokongan anda terhadap berkas asli dan mulai kembali.
\ndjango.views.i18n.set_language() sekarang membutuhkan permintaan POSTLink to this heading#Sebelumnya, permintaan GET telah digunakan. Perilaku lama berarti bahwa keadaan (lokal digunakan untuk menampilkan situs) dapat berubah dengan permintaan GET, yaitu terhadap anjuran spesifikasi HTTP. Kode memanggil tampilan ini harus memastikan bahwa permintaan POST sekaragn dibuat, sebagai gantinya GET. Ini berarti anda tidak dapat lagi menggunakan tautan mengakses tampilan, tetapi harus menggunakan pengajuan formulir dari sejenis (sebagai contoh tombol).
\n_() tidak lagi siap pakaiLink to this heading#_() (obyek callable yang namanya adalah garis bawah tunggal) tidak lagi monkeypatch kedalam siap pakai -- yaitu, itu tidak lagi tersedia secara ajaib di setiap modul.
Jika anda sebelumnya bergantung pada _() selalu menjadi hadir, anda harus sekarang secara eksplisit mengimpor ugettext atau ugettext_lazy, jika sesuai, dan namai itu menjadi _ anda sendiri:
from django.utils.translation import ugettext as _\nHttpRequestLink to this heading#Obyek HttpRequest tidak lagi langsung mendukung akses gaya kamus; sebelumnya, kedua data GET dan POST langsung tersedia pada obyek HttpRequest (sebagai contoh, anda dapat memeriksa untuk potongan dari formulir data dengan menggunakan if 'some_form_key' in request atau dengan membaca request['some_form_key']. Ini tidak lagi didukung; jika anda butuh akses untuk mengkombinasikan data GET dan POST, gunakan request.REQUEST sebagai gantinya.
Itu sangat disarankan, bagaimanapun, bahwa anda selalu secara eksplisit mencari di kamus yang sesuai untuk jenis dari permintaan anda harapkan untuk menerima (request.GET or request.POST); bergantung pada gabungan kamus request.REQUEST dapat menutup data datang asli.
HTTPResponseLink to this heading#django.http.HttpResponse.headers telah dinamai kembali ke _headers dan HttpResponse sekarang mendukung penahanan pemeriksaan secara langsung. Jadi gunakan if header in response: daripada if header in response.headers:.
Kelas-kelas hubungan umum -- GenericForeignKey dan GenericRelation -- telah dipindahkan kedalam modul django.contrib.contenttypes.
Lama (0.96):
\nfrom django.test import Client\n\nc = Client()\nc.login("/path/to/login", "myuser", "mypassword")\nBaru (1.0):
\n# ... same as above, but then:\nc.login(username="myuser", password="mypassword")\ndjango.core.management telah direfaktor.
Panggilan pada pengelolaan pelayanan di kode anda sekarang butuh untuk menggunakan call_command. Sebagai contoh, jika anda mempunyai beberapa percobaan yang memanggil flush dan load_data:
from django.core import management\n\nmanagement.flush(verbosity=0, interactive=False)\nmanagement.load_data(["test_data"], verbosity=0)\n...anda akan butuh merubah kdoe ini untuk dibaca:
\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 dan manage.py sekarang membutuhkan sub perintah untuk mendahulukan pilihan. Jadi:
$ django-admin.py --settings=foo.bar runserver\n...tidak lagi bekerja dan harus dirubah menjadi:
\n$ django-admin.py runserver --settings=foo.bar\ndjango.newforms.forms.SortedDictFromList telah dipindahkan. django.utils.datastructures.SortedDict sekarang dapat membuat obyek dengan urutan dari tuple-tuple.
Untuk memperbaharui kode anda:
\nGunakan django.utils.datastructures.SortedDict dimanapun anda menggunakan django.newforms.forms.SortedDictFromList.
Karena django.utils.datastructures.SortedDict.copy tidak mengemblikan salinan dalam sebagai SortedDictFromList.copy() lakukan, anda akan butuh memperbaharui kode anda jika anda bergantung pada saliann dalam. Lakukan ini dengan menggunakan copy.deepcopy secara langsung.
Hampir semua dari fungsi tingkatan backend basisdata telah dinamai kembali dan/atau ditempatkan kembali. Tidak ada dari ini didokumentasikan, tetapi anda akan butuh merubah kode anda jika anda sedang menggunakan tiap fungsi ini, semua dari yang berada di django.db:
Lama (0.96) | \nBaru (1.0) | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \nconnection.ops.fulltext_search_sql` | \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