Catatan terbitan Django 1.11¶

Indeks model berdasarkan-kelas¶

Modul django.db.models.indexes baru mengandung kelas-kelas yang memudahkan membuat indeks basisdata. Indeks-indeks ditambahkan ke model-model menggunakan pilihan Meta.indexes.

Kelas Index membuat sebuah indeks b-tree, seolah-olah anda menggunakan db_index pada bidang model atau index_together pada model kelas Meta. Itu dapat disubkelaskan untuk mendukung jenis-jenis indeks berbeda, seperti GinIndex. Itu juga mengizinkan menentukan urutan (ASC/DEC) untuk kolom-kolom dari indeks.

Membangun widget berdasarkan-cetakan¶

Untuk memudahkan menyesuaian widget, membangun widget formulir sekarang selesai menggunakan sistem cetakan daripada dalam Python. Lihat Formulir membangun API.

Anda mungkin butuh menyesuaikan widget penyesuaian apapun yang anda telah tulis untuk sedikit backwards incompatible changes.

Ungkapan Subquery¶

Pernyataan basisdata Subquery and Exists baru mengizinkan membuat sub permintaan jelas. Sub permintaan mungkin mengacu ke bidang-bidang dari queryset terluar menggunakan kelas OuterRef.

Fitur kecil¶

django.contrib.gis¶

• Untuk memudahkan basiskode dan karena itu lebih mudah memasang daripada ketika contrib.gis terbitan pertama, GDAL sekarang membutuhkan ketergantungan untuk GeoDjango. Dalam versi terlama, itu hanya dibutuhkan untuk SQLite.
• contrib.gis.maps dipindahkan ketika itu mengantarmukakan dengan versi pensiun dari Google Maps API dan kelihatan untuk tidak dirawat. Jika anda sedang menggunakan itu, let us know.
• Penghubung persamaan GEOSGeometry sekarang juga membandingkan SRID.
• Widget formulir berdasarkan-OpenLayer sekarang menggunakan OpenLayer 3, dan cetakan gis/openlayers.html dan gis/openlayers-osm.html telah diperbaharui. Periksa proyek anda jika anda mensubkelaskan widget-widget ini atau memperpanjang cetakan. Juga, widget baru bekerja sedikit berbeda daripada satu yang lama. Daripada menggunakan sebuah alat batang dalam widget, anda klik untuk menggambar, klik dan seret untuk memindahkan peta, dan klik dan seret titik, vertex/sudut untuk memindahkan itu.
• Dukungan untuk SpatiaLite < 4.0 telah dibuang.
• Dukungan untuk GDAL 1.7 dan 1.8 telah dibuang.
• Widget dalam contrib.gis.forms.widgets dan OpenLayersWidget admin menggunakan form rendering API 1 daripada daripada loader.render_to_string(). Jika anda sedang menggunakan cetakan widget penyesuaian, anda akan butuh memastikan formulir anda dibangun dapat menempatkan itu. Sebagai contoh, anda dapat juga menggunakan pembangun TemplatesSetting.

django.contrib.staticfiles¶

• collectstatic mungkin sekarang gagal selama penempatan-pengolahan ketika menggunakan sebuah penyimpanan berkas statis dicampur jika perulangan terkait ada (sebagai contoh 'foo.css' mengacu 'bar.css' yang itu sendiri mengacu 'foo.css') atau jika rantai dari berkas-berkas mengacu berkas-berkas lain terlalu dalam untuk dipecahkan dalam beberapa perlewatan. Dalam kasus terakhir, meningkatkan sejumlah perlewatan menggunakan ManifestStaticFilesStorage.max_post_process_passes.
• Ketika menggunakan ManifestStaticFilesStorage, berkas-berkas statis tidak ditemukan dalam manifest pada waktu berjalan sekarang memunculkan ValueError daripada mengembalikan jalur tidak berubah. Anda dapat merubah ke perilaku lama dengan mengatur ManifestStaticFilesStorage.manifest_strict menjadi False.

API backend basisdata¶

• Metode DatabaseOperations.time_trunc_sql() ditambahkan untuk mendukung pemotongan TimeField. Itu menerima argumen lookup_type dan field_name dan mengembalikan SQL sesuai untuk memotong bidang waktu yang diberikan pada sebuah obyek waktu dengan hanya diberikan kekhususan. Argumen lookup_type dapat salsah satu 'hour', 'minute', atau 'second'.
• Metode DatabaseOperations.datetime_cast_time_sql() ditambahkan untuk mendukung pencarian time. Itu menerima argumen field_name dan tzname dan mengembalikan SQL yang dibutuhkan untuk membuang nilai datetime menjadi nilai waktu.
• Untuk mengadakan dukungan FOR UPDATE SKIP LOCKED, setel DatabaseFeatures.has_select_for_update_skip_locked = True.
• Atribut DatabaseFeatures.supports_index_column_ordering baru menentukan jika sebuah basisdata mengizinkan menentukan urutan untuk kolom-kolom dalam indeks. Nilai awalan adalah True dan metode DatabaseIntrospection.get_constraints() harus menyertakan kunci 'orders' dalam setiap dari kamus-kamus yang dikembalikan dengan daftar dari nilai-nilai 'ASC' dan/atau 'DESC' berhubungan ke urutan dari setiap kolom dalam indeks.
• inspectdb tidak lagi memanggil DatabaseIntrospection.get_indexes() yang diusangkan. Backend basisdata penyesuaian harus memastikan semua jenis dari indeks dikembalikan oleh DatabaseIntrospection.get_constraints().
• Namai kembali fitur ignores_quoted_identifier_case untuk ignores_table_name_case untuk lebih akurat mencerminkan bagaimana itu digunakan.
• Argumen kata kunci name ditambahkan ke metode DatabaseWrapper.create_cursor(self, name=None) untuk mengizinkan penggunaan dari kursor sisi-peladen pada backend yang mendukung itu.

Dibuang dukungan untuk PostgreSQL 9.2 dan PostGIS 2.0¶

Dukungan hulu untuk PostgreSQL 9.2 berakhir dalam September 2017. Sebagai konsekuensinya, Django 1.11 menyetel PostgreSQL 9.3 sebagai versi minimal itu secara resmi dukung.

Dukungan untuk PostGIS 2.0 juga dipindahkan sebagai PostgreSQL 9.2 adalah versi terakhir untuk mendukung itu.

Juga, versi didukung minimal dari psycopg2 ditingkatkan dari 2.4.5 menjadi 2.5.4.

LiveServerTestCase mengikat ke port nol¶

Daripada mengambil jangkauan port dan mengulang menemukan port bebas, LiveServerTestCase mengikat port ke nol dan bergantung pada sistem operasi untuk memberikan port bebas. Variabel lingkungan DJANGO_LIVE_TEST_SERVER_ADDRESS tidak lagi digunakan, dan ketika itu tidak lagi digunakan, pilihan manage.py test --liveserver dipindahkan.

Jika anda butuh mengikat LiveServerTestCase pada port khusus, gunakan atribut port ditambahkan dalam Django 1.11.2.

Perlindungan terhadap pengalihan tidak aman dalam tampilan django.contrib.auth dan i18n¶

LoginView, LogoutView (dan setara berdasarkan-fungsi diusangkan), dan set_language() melindungi pengguna dari sedang dialigkan ke bukan-HTTPS url next ketika aplikasi sedang berjalan terhadap HTTPS.

Argumen pengecekan QuerySet.get_or_create() dan update_or_create()¶

Untuk mencegah salah ketik dari melewatkan secara diam, get_or_create() dan update_or_create() memeriksa bahwa argumen mereka adalah bidang model. Ini harus berupa ketidaksesuaian-kebelakang hanya dalam fakta bahwa itu mungkin mengungkapkan kesalahan dalam proyek anda.

pytz adalah ketergantungan diwajibkan dan mendukung untuk settings.TIME_ZONE = None dipindahkan¶

Untuk menyerdahanakan penanganan zona waktu Django, pytz sekarang membutuhkan ketergantungan. Itu otomatis memasang bersama dengan Django.

Dukungan untuk settings.TIME_ZONE = None dipindahkan ketika perilaku tidak umum digunakan dan berguna tanya. Jika anda ingin otomatis mengetahui zona waktu berdasarkan pada sistem zona waktu, anda dapat menggunakan tzlocal:

from tzlocal import get_localzone

TIME_ZONE = get_localzone().zone

Pekerjaan ini mirip pada settings.TIME_ZONE = None kecuali bahwa itu juga menyetel os.environ['TZ']. Let us know jika ada kasus penggunaan dimana anda menemukan anda tidak bisa menyesuaikan kode anda untuk disetel TIME_ZONE.

Perubahan HTML dalam cetakan admin¶

<p class="help"> diganti dengan etiket <div> untuk mengizinkan daftar di dalam teks bantuan.

Bidang-bidang hanya-baca dibungkus dalam 1...1 daripada 2...2 untuk mengizinkan apapun dari HTML sebagai isi bidang.

Perubahan karena perkenalan dari membangun widget berdasarkan-cetakan¶

Beberapa kelas-kelas tidak terdokumentasi dalam django.forms.widgets dipindahkan:

• SubWidget
• RendererMixin, ChoiceFieldRenderer, RadioFieldRenderer, CheckboxFieldRenderer
• ChoiceInput, RadioChoiceInput, CheckboxChoiceInput

Metode Select.render_option() tidak didokumentasikan dipindahkan.

Metode Widget.format_output() dipindahkan. Gunakan cetakan widget penyesuaian sebagai gantinya.

Beberapa nilai widget, seperti pilihan 1, sekarang dipelokalan jika settings.USE_L10N=True. Anda dapat merubah ke perilaku lama dengan cetakan widget penyesuaian yang menggunakan etiket cetakan localize untuk mematikan pelokalan.

django.template.backends.django.Template.render() melarang konteks bukan-dict¶

Untuk kesesuaian dengan banyak cetakan mesin, django.template.backends.django.Template.render() (dikembalikan dari API pemuat cetakan tingkat-tinggi seperti loader.get_template()) harus menerima sebuah dictionary dari konteks daripada Context atau RequestContext. Jika anda sedang melewatkan antara dua kelas, lewatkan dictionary sebagai gantinya -- melakukan itu kesesuaian-kebelakang dengan versi terlama dari Django.

Perubahan keadaan model dalam tindakan perpindahan¶

Untuk meningkatkan kecepatan dari memberlakukan perpindahan, membangun dari model terkait ditunda sampai sebuah tindakan yang butuh mereka (sebagai contoh RunPython). Jika anda mempunyai tindakan penyesuaian yang bekerja dengan kelas-kelas model atau instance mode dari argumen from_state dalam database_forwards() atau database_backwards(), anda harus membangun keadaan model menggunakan metode clear_delayed_apps_cache() seperti digambarkan dalam writing your own migration operation 1.

Bermacam-macam¶

• Jika tidak ada barang dalam umpan mempunyai atribut pubdate atau updateddate, SyndicationFeed.latest_post_date() sekarang mengembalikan date/time UTC saat ini, daripada datetime tanpa informasi zona waktu apapun.

• Kegagalan CSRF dicatat ke pencatat django.security.csrf daripada django.request.

• Pengesahan ALLOWED_HOSTS  tidak lagi ditiadakan ketika menjalankan percobaan. Jika aplikasi anda termasuk percobaan dengan nama rumah penyesuaian, anda harus menyertakan nama rumah tersebut dalam ALLOWED_HOSTS. Lihat Tests and multiple host names.

• Menggunakan id foreign key (sebagai contoh 'field_id') dalam ModelAdmin.list_display menampilan ID obyek terkait. Pindahkan akhiran _id jika anda ingin perilaku lama dari string mewakili dari obyek.

• Dalam formulir model, CharField dengan null=True sekarang menyimpan nilai NULL daripada string kosong.

• Pada Oracle, Model.validate_unique() tidak lagi memeriksa string kosong untuk keunikan sebagai penafsir basisdata nilai sebagai NULL.

• Jika anda mensubkelaskan AbstractUser dan menimpa clean(), pastikan itu memanggil super(). BaseUserManager.normalize_email() dipanggil dalam sebuah metode AbstractUser.clean() baru sehingga nomarlisasi diberlakukan dalam kasus-kasus seperti pengesahan formulir model.

• EmailField dan URLField tidak lagi menerima argumen katakunci strip. Pindahkan itu karena itu tidak mempunyai pengaruh dalam versi terlama dari Django ketika bidang ini selalu menghilangkan ruang putih.

• Atribut checked and selected dibangun dengan widget formulir sekarang menggunakan sintaksis boolean HTML5 daripada checked='checked' and selected='selected' XHTML.

• RelatedManager.add(), remove(), clear(), dan set() sekarang membersihkan cache prefetch_related().

• Untuk mencegah kemungkinan kehilangan dari pengaturan disimpan, setup_test_environment() sekarang memunculkan sebuah pengecualian jika dipanggil satu detik sebelum memanggil teardown_test_environment().

• Nama lain DateTimeAwareJSONEncoder tidak terdokumentasi untuk DjangoJSONEncoder (dinamai kembali dalam Django 1.0) dipindahkan.

• cached template loader sekarang diadakan jika DEBUG adalah False dan OPTIONS['loaders'] 1 tidak ditentukan. Ini dapat berupa ketidaksesuaian-kebelakang jika anda mempunyai beberapa template tags that aren't thread safe 2.

• Penunjukan untuk penghapusan jenis isi basi tidak lagi muncul setelah menjalankan perintah migrate. Gunakan perintah remove_stale_contenttypes baru sebagai gantinya.

• Widget admin untuk IntegerField menggunakan type="number" daripada type="text".

• Kepala HTTP bersyarat sekarang diuraikan dan dibandingkan menurut rfc:7232 spesifikasi Permintaan Bersyarat daripada yang lama RFC 2616.

• patch_response_headers() tidak lagi menambah kepala Last-Modified. Menurut RFC 7234#section-4.2.2, kepala ini tidak berguna bersama kepala cache lain yang menyediakan sebuah waktu kadaluarsa yang jelas, sebagai contoh Expires atau Cache-Control. UpdateCacheMiddleware dan add_never_cache_headers() call patch_response_headers() dan maka dari itu juga dipengaruhi oleh perubahan ini.

• Dalam cetakan admin, 1 diganti dengan etiket 2 untuk mengizinkan menyertakan daftar didalam teks bantuan.

• ConditionalGetMiddleware tidak lagi menyetel kepala Date ketika peladen Jaringan menyetel kepala itu. Itu juga tidak lagi menyetel kepala Content-Length ketika ini diselesaikan oleh CommonMiddleware.

  If you have a middleware that modifies a response's content and appears before CommonMiddleware in the MIDDLEWARE or MIDDLEWARE_CLASSES settings, you must reorder your middleware so that responses aren't modified after Content-Length is set, or have the response modifying middleware reset the Content-Length header.

• get_model() dan get_models() sekarang memunculkan AppRegistryNotReady jika mereka dipanggil sebelum model dari semua aplikasi telah dimuat. Sebelumnya mereka hanya membutuhkan sasaran model aplikasi untuk dimuat dan demikian dapat mengembalikan model tanpa semua hubungan mereka disetel. Jika anda butuh perilaku lama dari get_model(), setel argumen require_ready menjadi False.

• Atribut BaseCommand.can_import_settings tidak digunakan dipindahkan.

• Internal django.utils.functional.lazy_property dipindahkan.

• Untuk ketetapan dengan permintaan bukan-banyak-bagian, MultiPartParser.parse() sekarang meninggalkan request.POST kekal. Jika anda sedang merubah QueryDict itu, anda harus sekarang pertama menyalin, sebagai contoh request.POST.copy().

• Dukungan untuk cx_Oracle < 5.2 telah dipindahkan.

• Dukungan untuk IPython < 1.0 telah dipindahkan dari perintah shell.

• Tanda tangan dari API pribadi Widget.build_attrs() berubah dari extra_attrs=None, **kwargs menjadi base_attrs, extra_attrs=None.

• Obyek seperti-berkas (sebagai contoh StringIO dan BytesIO) diunggah pada sebuah ImageField menggunakan klien percobaan sekarang membutuhkan sebuah atribut name dengan sebuah nilai yang melewatkan pengesah validate_image_file_extension. Lihat catatan dalam Client.post().

Penghias models.permalink()¶

Gunakan django.urls.reverse() sebagai gantinya. Sebagai contoh:

from django.db import models

class MyModel(models.Model):
    ...

    @models.permalink
    def url(self):
        return ('guitarist_detail', [self.slug])

menjadi:

from django.db import models
from django.urls import reverse

class MyModel(models.Model):
    ...

    def url(self):
        return reverse('guitarist_detail', args=[self.slug])

Bermacam-macam¶

• Tampilan berdasarkan-fungsi login() dan logout() contrib.auth diusangkan menduung dari tampilan berdasarkan-kelas baru LoginView dan LogoutView.
• Parameter extra_context tidak digunakan dari contrib.auth.views.logout_then_login() diusangkan.
• Tampilan berdasarkan-fungsi contrib.auth’s password_change(), password_change_done(), password_reset(), password_reset_done(), password_reset_confirm(), dan password_reset_complete() diusangkan mendukung dari tampilan berdasarkan-kelas baru PasswordChangeView, PasswordChangeDoneView, PasswordResetView, PasswordResetDoneView, PasswordResetConfirmView, dan PasswordResetCompleteView.
• django.test.runner.setup_databases() dipindahkan ke django.test.utils.setup_databases(). Tempat lama diusangkan.
• django.utils.translation.string_concat() diusangkan mendukung django.utils.text.format_lazy(). string_concat(*strings) dapat diganti oleh format_lazy('{}' * len(strings), *strings).
• Untuk backend cache PyLibMCCache, lewatkan pengaturan perilaku pylibmc sebagai atribut tingkat-atas dari OPTIONS diusangkan. Setel mereka dibawah kunci behaviors dalam OPTIONS sebagai gantinya.
• Parameter host dari django.utils.http.is_safe_url() diusangkan mendukung parameter allowed_hosts baru.
• Mendiamkan pengecualian yang muncul selagi membangun etiket cetakan {% include %} 1 diusangkan sebagai perilaku sering lebih membingungkan daripada membantu. Dalam Django 2.1, pengecualian akan dimunculkan.
• DatabaseIntrospection.get_indexes() diusangkan mendukung DatabaseIntrospection.get_constraints().
• authenticate() sekarang melewatkan sebuah argumen request pada metode authenticate() dari backend autentifikasi. Dukungan untuk metode-metode yang tidak menerima request sebagai argumen penempatan pertama akan dipindahkan dalam Django 2.1.
• Pengaturan USE_ETAGS diusangkan mendukung ConditionalGetMiddleware yang sekarang menambah kepala ETag pada tanggapan tanpa memperdulikan pengaturan. CommonMiddleware dan django.utils.cache.patch_response_headers() tidak akan lagi menyetel ETags ketika pengusangan berakhir.
• Model._meta.has_auto_field diusangkan mendukung dari pemeriksaan jika Model._meta.auto_field bukan None.
• Menggunakan kelompok regular expression dengan iLmsu# dalam url() diusangkan. Hanya kelompok yang berguna adalah (?i) untuk URL kasus-tidak-sensitif, bagaimanapun, URL kasus-tidak-sensitif bukan praktik bagus karena mereka membuat banyak masukan untuk setiap mesin pencari, sebagai contoh. Sebuah pemecahan lain dapat membuat handler404 yang mencari karakter huruf besar dalam URL dan pengalihkan ke setara huruf kecil.
• Argumen renderer ditambahkan pada metode Widget.render(). Metode-metode yang tidak menerima bahwa argumen akan bekerja melalui masa pengusangan.