--- title: "Catatan terbitan Django 1.6" version: 5.2 locale: id source: https://docs.djangoproject.com/id/5.2/releases/1.6/ canonical: https://djangodocs.dev/id/5.2/releases/1.6/ --- # Catatan terbitan Django 1.6 > **Note** > > Dipersembahkan kepada Malcolm Tredinnick > > Pada 17 Maret 2013, proyek Django dan komunitas perangkat lunak bebas kehilangan teman dan pengembang. > > Malcom adalah pembantu lama pada Django, sebuah model anggota komunitas, pikiran cemerlang, dan seorang teman. Bantuannya pada Django - dan ke banyak proyek sumber terbuka lainnya - hampir tidak mungkin menghitung. Banyak pada tim Django inti mempunyai tambalan pertama mereka ditinjau oleh dia; bimbingannya memperkaya kami. Pertimbangan dia, kesabaran, dan pengabdian akan selalu menjadi inspirasi untuk kami. > > Terbitan Django ini untuk Malcolm. > > -- Pengembang Django *November 6, 2013* Selamat datang di Django 1.6! Catatan terbitan ini mencangkupi [new features](#whats-new-1-6), sama halnya beberapa [backwards incompatible changes](#backwards-incompatible-1-6) anda akan ingin menjadi waspada ketika meningkatkan dari Django 1.5 atau versi terlama. Kami telah membuang beberapa fitur, yang rinciannya di [our deprecation plan](/id/5.2/internals/deprecation/#deprecation-removed-in-1-6), dan kami telah [begun the deprecation process for some features](#deprecated-features-1-6). ## Kesesuaian Python Django 1.6, seperti Django 1.5, membutuhkan Python 2.6.5 atau diatasnya. Python 3 juga secara resmi didukung. Kami **sangat menganjurkan** terbitan kecil terakhir untuk setiap rangkaian Python yang didukung (2.6.X, 2.7.X, 3.2.X, and 3.3.X). Django 1.6 akan menjadi rangkaian terbitan terakhir untuk mendukung Python 2.6; dimulai dengan Django 1.7, minimal dukungan versi Python akan menjadi 2.7. Python 3.4 tidak didukung, tetapi dukungan akan ditambahkan di Django 1.7. ## Apa yang baru di Django 1.6 ### Sederhanakan proyek awal dan cetakan aplikasi Cetakan awalan digunakan oleh [`startproject`](/id/5.2/ref/django-admin/#django-admin-startproject) dan [`startapp`](/id/5.2/ref/django-admin/#django-admin-startapp) telah disederhanakan dan dimodernisasikan. [admin](/id/5.2/ref/contrib/admin/) sekarng diadakan secara awalan di proyek baru; kerangka kerja [sites](/id/5.2/ref/contrib/sites/) tidak lagi. [clickjacking prevention](/id/5.2/ref/clickjacking/#clickjacking-prevention) sekarang di dan awalan basisdata pada SQLite. Jika awalan cetakan tidak cocok dengan rasa anda, anda dapat menggunakan [custom project and app templates](/id/5.2/ref/django-admin/#custom-app-and-project-templates). ### Perbaikan pengelolaan transaksi Pengelolaan transaksi Django dirombak. Tingkat-basisdata pembenaran otomatis sekarang nyala sebagai awalan. Ini membuat penanganan transaksi lebih jelas dan harus meningkatkan penampilan. API yang ada diusangkan, dan API baru telah diperkenalkan, sebagai digambarkan di [transaction management docs](/id/5.2/topics/db/transactions/). ### Hubungan basisdata gigih Django now supports reusing the same database connection for several requests. This avoids the overhead of reestablishing a connection at the beginning of each request. For backwards compatibility, this feature is disabled by default. See [Hubungan tetap](/id/5.2/ref/databases/#persistent-database-connections) for details. ### Penemuan percobaan di tiap modul percobaan Django 1.6 dibekali dengan pejalan percobaan baru yang mengizinkan lebih keluwesan di tempat dari percobaan. Pejalan sebelumnya (`django.test.simple.DjangoTestSuiteRunner`) menemukan percobaan hanya di modul `models.py` dan `tests.py` dari paket Python di [`INSTALLED_APPS`](/id/5.2/ref/settings/#std-setting-INSTALLED_APPS). Pejalan baru (`django.test.runner.DiscoverRunner`) menggunakan fitur penemuan percobaan dibangun kedalam `unittest2` (versi dari `unittest` di pustaka standar Python 2.7+, dan digabung dengan Django). Dengan penemuan percobaan, percobaan dapat ditempatkan di tiap modul yang namanya cocok dengan pola `test*.py`. Sebagai tambahan, label percobaan disediakan pada `./manage.py test` untuk menunjuk percobaan khusus untuk berjalan harus sekarang menjadi jalur bertitik Python penuh (atau jalur direktori), daripada halur-semu `applabel.TestCase.test_method_name`. Ini mengizinkan menjalankan percobaan ditempatkan dimana saja di basis kode anda, daripada hanya di [`INSTALLED_APPS`](/id/5.2/ref/settings/#std-setting-INSTALLED_APPS). Untuk rincian lebih, lihat [Percobaan di Django](/id/5.2/topics/testing/). Perubahan ini adalah kesesuaian-kebelakang; lihat [backwards-incompatibility notes](#new-test-runner). ### Mengetahui pengumpulan zona waktu Dukungan untuk [time zones](/id/5.2/topics/i18n/timezones/) diperkenalkan di DJango 1.4 tidak bekerja baik dengan [`QuerySet.dates()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.dates): pengumpulan selalu dilakukan di UTC. Batasan ini telah diangkat di Django 1.6. Gunakan ``QuerySet.datetimes() `untuk melakukan mengetahui pengumpulan zona waktu di :class:`~django.db.models.DateTimeField()``. ### Dukungan untuk savepoint di SQLite Django 1.6 menambahkan dukungan untuk savepoint di SQLite, dengan beberapa [limitations](/id/5.2/topics/db/transactions/#savepoints-in-sqlite). ### Bidang model `BinaryField` Bidang model [`django.db.models.BinaryField`](/id/5.2/ref/models/fields/#django.db.models.BinaryField) baru mengizinkan penyimpanan dari data biner mentah di basisdata. ### GeoDjango dari widget GeoDjango sekarang menyediakan [form fields and widgets](/id/5.2/ref/contrib/gis/forms-api/) untuk bidang khusus-geo nya. Mereka adalah berdasarkan-OpenLayer secara awalan, tetapi mereka dapat disesuaiakan untuk menggunakan apapun kerangka kerja JS lain. ### Perintah pengelolaan `check` ditambahkan untuk mengecek kesesuaian Sebuah perintah pengelolaan [`check`](/id/5.2/ref/django-admin/#django-admin-check) telah ditambahkan, mengadakan anda untuk memeriksa jika konfigurasi anda saat ini (saat ini bertujuan pada pengaturan) adalah cocok dengan versi saat ini dari Django. ### Algoritma [`Model.save()`](/id/5.2/ref/models/instances/#django.db.models.Model.save) berubah Metode [`Model.save()`](/id/5.2/ref/models/instances/#django.db.models.Model.save) sekarang mencoba secara langsung `UPDATE` basisdata jika instance mempunyai sebuah nilai primary key. Sebelumnya `SELECT` telah dilakukan untuk menentukan jika `UPDATE` atau `INSERT` dibutuhkan. Algoritma baru dibutuhkan jika hanya satu permintaan untuk memperbaharui baris yang ada selagi algoritma lama membutuhkan dua. Lihat [`Model.save()`](/id/5.2/ref/models/instances/#django.db.models.Model.save) untuk lebih rinci. Di beberapa kasus yang jarang basisdata tidak melaporkan bahwa sebuah baris yang cocok telah ditemukan ketika melakukan sebuah `UPDATE`. Sebuah contoh adalah pemicu `ON UPDATE` PostgreSQL yang mengembalikan `NULL`. Dalam kasus tersebut itu memungkinkan menyetel bendera [`django.db.models.Options.select_on_save`](/id/5.2/ref/models/options/#django.db.models.Options.select_on_save) untuk memaksa menyimpan menggunakan algoritma lama. ### Fitur kecil - Backend otentifikasi dapat memunculkan `PermissionDenied` untuk segera menggagalkan rantai otentifikasi. - Bendera `HttpOnly` dapat disetel di kue CSRF dengan [`CSRF_COOKIE_HTTPONLY`](/id/5.2/ref/settings/#std-setting-CSRF_COOKIE_HTTPONLY). - The `assertQuerysetEqual()` now checks for undefined order and raises [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) if undefined order is spotted. The order is seen as undefined if the given `QuerySet` isn't ordered and there is more than one ordered value to compare against. - Ditambahkan [`earliest()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.earliest) untuk simetri dengan [`latest()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.latest). - Sebagai tambahan pada [`year`](/id/5.2/ref/models/querysets/#std-fieldlookup-year), [`month`](/id/5.2/ref/models/querysets/#std-fieldlookup-month) dan [`day`](/id/5.2/ref/models/querysets/#std-fieldlookup-day), ORM sekarang mendukung pencarian [`hour`](/id/5.2/ref/models/querysets/#std-fieldlookup-hour), [`minute`](/id/5.2/ref/models/querysets/#std-fieldlookup-minute) dan [`second`](/id/5.2/ref/models/querysets/#std-fieldlookup-second). - Django sekarang membungkus semua pengecualian [**PEP 249**](https://peps.python.org/pep-0249/). - Widget awalan untuk [`EmailField`](/id/5.2/ref/forms/fields/#django.forms.EmailField), [`URLField`](/id/5.2/ref/forms/fields/#django.forms.URLField), [`IntegerField`](/id/5.2/ref/forms/fields/#django.forms.IntegerField), [`FloatField`](/id/5.2/ref/forms/fields/#django.forms.FloatField) dan [`DecimalField`](/id/5.2/ref/forms/fields/#django.forms.DecimalField) menggunakan atribut jenis baru tersedia di HTML5 (`type='email'`, `type='url'`, `type='number'`). Catat bagwa karena dukungan tak menentu dari jenis masukan `number` dengan angka lokal di peramban saat ini, Django hanya menggunakannya ketika bidang numerik tidak di lokalkan. - Argumen `number` untuk [lazy plural translations](/id/5.2/topics/i18n/translation/#lazy-plural-translations) dapat disediakan pada waktu terjemahan daripada saat waktu penentuan. - For custom management commands: Verification of the presence of valid settings in commands that ask for it by using the `BaseCommand.can_import_settings` internal option is now performed independently from handling of the locale that should be active during the execution of the command. The latter can now be influenced by the new `BaseCommand.leave_locale_alone` internal option. See [Pengelolaan perintah dan lokal](/id/5.2/howto/custom-management-commands/#management-commands-and-locales) for more details. - [`success_url`](/id/5.2/ref/class-based-views/mixins-editing/#django.views.generic.edit.DeletionMixin.success_url) dari [`DeletionMixin`](/id/5.2/ref/class-based-views/mixins-editing/#django.views.generic.edit.DeletionMixin) sekarang ditambahkan dengan `__dict__` `object` nya. - [`HttpResponseRedirect`](/id/5.2/ref/request-response/#django.http.HttpResponseRedirect) dan [`HttpResponsePermanentRedirect`](/id/5.2/ref/request-response/#django.http.HttpResponsePermanentRedirect) sekarang menyediakan sebuah atribut `url` (setara dengan tanggapan URL akan dialihkan). - Backend penyimpanan sementara `MemcachedCache` sekarang menggunakan protokol [`pickle`](https://docs.python.org/3/library/pickle.html#module-pickle) yang terakhir tersedia. - Ditambahkan [`SuccessMessageMixin`](/id/5.2/ref/contrib/messages/#django.contrib.messages.views.SuccessMessageMixin) yang menyediakan sebuah atribut `success_message` untuk [`FormView`](/id/5.2/ref/class-based-views/generic-editing/#django.views.generic.edit.FormView) berdasarkan kelas-kelas. - Ditambahkan pilihan [`django.db.models.ForeignKey.db_constraint`](/id/5.2/ref/models/fields/#django.db.models.ForeignKey.db_constraint) dan [`django.db.models.ManyToManyField.db_constraint`](/id/5.2/ref/models/fields/#django.db.models.ManyToManyField.db_constraint). - Pustaka jQuery ditanam di admin telah ditingkatkan ke versi 1.9.1. - Umpan kongsi ([`django.contrib.syndication`](/id/5.2/ref/contrib/syndication/#module-django.contrib.syndication)) sekarang dapat melewatkan konteks tambahan melalui cetakan umpan menggunakan callback [`Feed.get_context_data()`](/id/5.2/ref/contrib/syndication/#django.contrib.syndication.Feed.get_context_data) baru. - Kolom daftar admin mempunyai sebuah kelas `column-` di HTML jadi kepalakolom dapat digaya dengan CSS, sebagai contoh untuk menyetel lebar kolom. - [isolation level](/id/5.2/ref/databases/#database-isolation-level) dapat disesuaikan dibawah PostgreSQL. - Etiket cetakan [`blocktrans`](/id/5.2/topics/i18n/translation/#std-templatetag-blocktrans) sekarang mematuhi `TEMPLATE_STRING_IF_INVALID` untuk variabel tidak hadir di konteks, sama seprti penyusunan cetakan lain. - `SimpleLazyObject` sekarang akan menghadirkan gambaran lebih membantu dalam keadaan mencari kesalahan shell. - Generic [`GeometryField`](/id/5.2/ref/contrib/gis/model-api/#django.contrib.gis.db.models.GeometryField) is now editable with the OpenLayers widget in the admin. - Dokumentasi mengandung [deployment checklist](/id/5.2/howto/deployment/checklist/). - Perintah [`diffsettings`](/id/5.2/ref/django-admin/#django-admin-diffsettings) mendapatkan pilihan `--all`. - `django.forms.fields.Field.__init__` sekarang memanggil `super()`, mengizinkan campuran bidang untuk menerapkan metode `__init__()` yang akan dapat dihandalkan dipanggil. - Parameter `validate_max` telah ditambahkan ke `BaseFormSet` dan [`formset_factory()`](/id/5.2/ref/forms/formsets/#django.forms.formsets.formset_factory), dan `ModelForm` dan versi berderet dari yang sama. Perilaku dari pengesahan untuk formset dengan `max_num` telah dijelaskan. Sebelumnya perilaku tidak terdokumentasi yang mengeraskan formset terhadap serangan kelelahan ingatan telah didokumentasikan, dan tidak terdokumentasi terbatas dari lebih tinggi 1000 atau `max_num` formulir telah dirubah jadi itu selalu 1000 lebih daripada `max_num`. - Ditambahkan `BCryptSHA256PasswordHasher` untuk menyelesaikan masalah pemotongan sandi dengan bcrypt. - [Pillow](https://pypi.org/project/Pillow/) is now the preferred image manipulation library to use with Django. [PIL](https://pypi.org/project/PIL/) is pending deprecation (support to be removed in Django 1.8). To upgrade, you should **first** uninstall PIL, **then** install Pillow. - [`ModelForm`](/id/5.2/topics/forms/modelforms/#django.forms.ModelForm) menerima beberapa pilihan `Meta` baru. - Bidang-bidang disertakan dalam daftar `localized_fields` akan dilokalkan (dengan menyetel `localize` pada bidang formulir). - Pilihan `labels`, `help_texts` dan `error_messages` mungkin digunakan untuk menyesuaikan bidang awalan, lihat [Mengesampingan nilai awal](/id/5.2/topics/forms/modelforms/#modelforms-overriding-default-fields) untuk rincian. - Argumen `choices` pada bidang model sekarang menerima sebuah perulangan dari perulangan sebagai gantinya membutuhkan sebuah perulangan dari daftar atau tuple. - Alasan frase dapat disesuaikan di tanggapan HTTP menggunakan [`reason_phrase`](/id/5.2/ref/request-response/#django.http.HttpResponse.reason_phrase). - When giving the URL of the next page for `django.contrib.auth.views.logout()`, `django.contrib.auth.views.password_reset()`, `django.contrib.auth.views.password_reset_confirm()`, and `django.contrib.auth.views.password_change()`, you can now pass URL names and they will be resolved. - Pilihan [`dumpdata --pks`](/id/5.2/ref/django-admin/#cmdoption-dumpdata-pks) baru menentukan primary key dari obyek untuk membuang. Pilihan ini dapat hanya digunakan dengan satu model. - Ditambahkan metode `QuerySet` [`first()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.first) dan [`last()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.last) yang metode kenyamanan mengembalikan obyek pertama atau terakhir mencocokkan saringan. Mengembalikan `None` jika tidak ada pencocokan obyek. - [`View`](/id/5.2/ref/class-based-views/base/#django.views.generic.base.View) dan [`RedirectView`](/id/5.2/ref/class-based-views/base/#django.views.generic.base.RedirectView) sekarang mendukung metode HTTP `PATCH`. - `GenericForeignKey` sekarang mengambil sebuah pilihan argumen `for_concrete_model`, yang ketika disetel ke `False` mengizinkan bidang untuk mengacu model proxy. Awalan adalah `True` untuk memelihara perilaku lama. - [`LocaleMiddleware`](/id/5.2/ref/middleware/#django.middleware.locale.LocaleMiddleware) sekarang menyimpan bahasa aktif di sesi jika itu tidak hadir disana. Ini mencegah kehilangan dari pengaturan bahasa setelah menyiram sesi, sebagai contoh keluar. - [`SuspiciousOperation`](/id/5.2/ref/exceptions/#django.core.exceptions.SuspiciousOperation) telah dibedakan menjadi sejumlah subkelas, dan setiap akan masuk untuk mencocokan pencatat bernama dibawah hirarki pencatatan `django.security`. Bersama dengan perubahan ini, sebuah mekanisme `handler400` dan tampilan awal digunakan ketika kapanpun `SuspiciousOperation` mencapai penangan WSGI untuk mengembalikan sebuah `HttpResponseBadRequest`. - Pengecualian [`DoesNotExist`](/id/5.2/ref/models/class/#django.db.models.Model.DoesNotExist) sekarang menyertakan sebuah pesan yang menunjukkan nama dari atribut digunakan untuk pencarian. - Metode [`get_or_create()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.get_or_create) tidak lagi membutuhkan setidaknya satu argumen katakunci. - The [`SimpleTestCase`](/id/5.2/topics/testing/tools/#django.test.SimpleTestCase) class includes a new assertion helper for testing formset errors: `django.test.SimpleTestCase.assertFormsetError()`. - Daftar dari bidang-bidang terkait ditambahkan pada [`QuerySet`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet) oleh [`select_related()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.select_related) dapat dibersihkan menggunakan `select_related(None)`. - Metode [`get_extra()`](/id/5.2/ref/contrib/admin/#django.contrib.admin.InlineModelAdmin.get_extra) dan [`get_max_num()`](/id/5.2/ref/contrib/admin/#django.contrib.admin.InlineModelAdmin.get_max_num) pada [`InlineModelAdmin`](/id/5.2/ref/contrib/admin/#django.contrib.admin.InlineModelAdmin) mungkin dikesampingkan untuk menyesuaikan jumlah tambahan dan maksimal dari formulir berderet. - Formset sekarang mempunyai sebuah metode [`total_error_count()`](/id/5.2/topics/forms/formsets/#django.forms.formsets.BaseFormSet.total_error_count). - Bidang-bidang [`ModelForm`](/id/5.2/topics/forms/modelforms/#django.forms.ModelForm) sekarang dapat menimpa pesan-pesan kesalahan ditentukan di bidang model dengan menggunakan argumen [`error_messages`](/id/5.2/ref/forms/fields/#django.forms.Field.error_messages) dari pembangun `Field`. Untuk mengambil kesimpulan dari fitur ini dengan bidang penyesuaian anda, [see the updated recommendation](/id/5.2/ref/forms/validation/#raising-validation-error) untuk memunculkan `ValidationError`. - [`ModelAdmin`](/id/5.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin) sekarang mempertahankan penyaring pada daftar tampilan setelah membuat, menyunting atau menghapus sebuah obyek. Itu memungkinkan menyimpan kembali perilaku sebelumnya dari membersihkan penyaring dengan mengatur atribut [`preserve_filters`](/id/5.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin.preserve_filters) menjadi `False`. - Ditambahkan [`FormMixin.get_prefix`](/id/5.2/ref/class-based-views/mixins-editing/#django.views.generic.edit.FormMixin.get_prefix) (yang mengembalikan [`FormMixin.prefix`](/id/5.2/ref/class-based-views/mixins-editing/#django.views.generic.edit.FormMixin.prefix) secara awalan) untuk mengizinkan menyesuaikan [`prefix`](/id/5.2/ref/forms/api/#django.forms.Form.prefix) dari formulir. - Permintaan mentah (`Manager.raw()` atau `cursor.execute()`) sekarang dapat menggunakan gaya parameter "pyformat", dimana placeholder dalam permintaan diberikan sebagai `'%(name)s'` dan parameter dilewatkan sebagai sebuah kamus daripada sebuah daftar (kecuali di SQLite). Ini telam lama mungkin (tetapi bukan secara resmi didukung) di MySQL dan PostgreSQL, dan sekarang juga tersedia di Oracle. - Perhitungan putaran awal untuk pengacak sandi PBKDF2 telah ditingkatkan oleh 20%. Perubahan kesesuaian kebelakang tidak akan mempengaruhi sandi atau pengguna yang mempunyai disubkelaskan `django.contrib.auth.hashers.PBKDF2PasswordHasher` untuk merubah nilai awal. Sandi [will be upgraded](/id/5.2/topics/auth/passwords/#password-upgrades) untuk menggunakan perhitungan putaran baru sesuai kebutuhan. ## Perubahan bertentangan kebelakang di 1.6 > **Warning** > > Sebagai tambahan pada perubahan diuraikan di bagian ini, pastikan untuk meninjau kembali [deprecation plan](/id/5.2/internals/deprecation/#deprecation-removed-in-1-6) untuk setiap fitur yang telah dipindahkan. Jika anda belum memperbaharui kode anda dalam linimasa pengusangan untuk fitur yang diberikan, perpindahannya mugkin muncul sebagai perubahan ketidaksesuaian kebelakang. ### Model pengelolaan transaksi baru #### Perubahan perilaku Pembenaran otomatis tingkat-basisdata diadakan secara awalan di Django 1.6. Selagi ini tidak merubah jiwa umum dari pengelolaan transaksi Django, ada sedikit ketidaksesuaian-kebelakang. #### Savepoints dan `assertNumQueries` Perubahan di pengelolaan transaksi dapat menghasilkan di pernyataan tambahan untuk membuat, menerbitkan atau menyimpan kembali titik penyimpanan sampai terbitan ini. Jika percobaan menggunakan [`assertNumQueries()`](/id/5.2/topics/testing/tools/#django.test.TransactionTestCase.assertNumQueries) gagal karena dari angka tertinggi dari permintaan daripada diharapkan, periksa bahwa permintaan tambahan dikaitkan ke titik penyimpanan, dan menyesuaikan angka yang diharapkan dari permintaan sesuai dengan itu. #### Pilihan perbaikan otomatis untuk PostgreSQL Di versi sebelumnya, perbaikan otomatis tingkatan-basisdata hanya sebuah pilihan untuk PostgreSQL, dan itu ditiadakan secara awalan. Pilihan ini sekarang diabaikan dan dapat dipindah. ### Pejalan percobaan baru In order to maintain greater consistency with Python's `unittest` module, the new test runner (`django.test.runner.DiscoverRunner`) does not automatically support some types of tests that were supported by the previous runner: - Percobaan di berkas `models.py` dan `tests/__init__.py` tidak lagi ditemukan dan berjalan. Pindahkan mereka ke sebuah berkas yang namanya dimulai dengan `test`. - Doctest tidak akan lagi secara otomatis ditemukan. Untuk memadukan doctest ke deretan percobaan anda, ikuti [recommendations in the Python documentation](https://docs.python.org/3/library/doctest.html#doctest-unittest-api). Django bundles a modified version of the [`doctest`](https://docs.python.org/3/library/doctest.html#module-doctest) module from the Python standard library (in `django.test._doctest`) and includes some additional doctest utilities. These utilities are deprecated and will be removed in Django 1.8; doctest suites should be updated to work with the standard library's doctest module (or converted to `unittest`-compatible tests). Jika anda berharap menunda perbaharuan ke deretan percobaan anda, anda dapat menyetel pengaturan [`TEST_RUNNER`](/id/5.2/ref/settings/#std-setting-TEST_RUNNER) anda menjadi `django.test.simple.DjangoTestSuiteRunner` untuk sepenuhnya menyimpan kembali perilaku percobaan lama. `DjangoTestSuiteRunner` diusangkan tetapi tidak akan dipindahkan dari Django sampai versi 1.8. ### Perpindahan dari pejalan percobaan penyesuaian GeoDjango `django.contrib.gis.tests.GeoDjangoTestSuiteRunner` Ini adalah untuk pengembang yang bekerja pada aplikasi GeoDjango itu sendiri dan terkait ke barang diatas tentang perubahan di penjalan percobaan: Penjalan percobaan `django.contrib.gis.tests.GeoDjangoTestSuiteRunner` telah dipindahkan dan setelan pengerjaan percobaan GeoDajngo berdiri sendiri itu terapkan tidak didukung lagi. Untuk menjalankan percobaan GeoDjango cukup gunakan `DiscoverRunner` baru dan tentukan aplikasi `django.contrib.gis`. ### Menyesuaikan model user di percobaan Perkenalan dari pejalan percobaan baru juga sedikit merubah cara dimana model percobaan diimpor. Sebagai hasilnya, percobaan apapun yang menimpa `AUTH_USER_MODEL` untuk mencoba perilaku dengan satu dari model pengguna percobaan Dajngo ( `django.contrib.auth.tests.custom_user.CustomUser` dan `django.contrib.auth.tests.custom_user.ExtensionUser`) harus sekarang secara eksplisit impor model User di modul percobaan anda: ``` from django.contrib.auth.tests.custom_user import CustomUser @override_settings(AUTH_USER_MODEL="auth.CustomUser") class CustomUserFeatureTests(TestCase): def test_something(self): # Test code here ... ``` This import forces the custom user model to be registered. Without this import, the test will be unable to swap in the custom user model, and you will get an error reporting: ```pytb ImproperlyConfigured: AUTH_USER_MODEL refers to model 'auth.CustomUser' that has not been installed ``` ### Sadar-zona waktu pencarian `day`, `month`, dan `week_day` Django 1.6 memperkenalkan dukungan zona waktu untuk pencarian [`day`](/id/5.2/ref/models/querysets/#std-fieldlookup-day), [`month`](/id/5.2/ref/models/querysets/#std-fieldlookup-month), dan [`week_day`](/id/5.2/ref/models/querysets/#std-fieldlookup-week_day) ketika [`USE_TZ`](/id/5.2/ref/settings/#std-setting-USE_TZ) adalah `True`. Pencarian ini sebelumnya dilakukan di UTC tanpa memperhatikan dari zona waktu sekarang. Ini membutuhkan [time zone definitions in the database](/id/5.2/ref/models/querysets/#database-time-zone-definitions). Jika anda sedang menggunakan SQLite, anda harus memasang [pytz](http://pytz.sourceforge.net/). Jika anda sedang menggunakan MySQL, anda harus memasang [pytz](http://pytz.sourceforge.net/) dan memuat tabel zona waktu dengan [mysql\_tzinfo\_to\_sql](https://dev.mysql.com/doc/refman/en/mysql-tzinfo-to-sql.html). ### Tambahan dari `QuerySet.datetimes()` Ketika [time zone support](/id/5.2/topics/i18n/timezones/) ditambahkan di Django 1.4 telah aktif, pencarian [`QuerySet.dates()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.dates) mengembalikan hasil tidak diharapkan, karena pengumpulan telah dilakukan dalam UTC. Untuk memperbaiki ini, Django 1.6 memperkenalkan API baru, [`QuerySet.datetimes()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.datetimes). Ini membutuhkan sedikit perubahan di kode anda. #### `QuerySet.dates()` mengembalikan obyek `date` [`QuerySet.dates()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.dates) sekarang mengemblikan sebuah daftar dari [`date`](https://docs.python.org/3/library/datetime.html#datetime.date). Itu digunakan untuk mengembalikan sebuah daftar [`datetime`](https://docs.python.org/3/library/datetime.html#datetime.datetime). [`QuerySet.datetimes()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.datetimes) mengembalikan sebuah daftar dari [`datetime`](https://docs.python.org/3/library/datetime.html#datetime.datetime). #### `QuerySet.dates()` tidak lagi digunakan pada `DateTimeField` [`QuerySet.dates()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.dates) memunculkan sebuah kesalahan jika itu digunakan di [`DateTimeField`](/id/5.2/ref/models/fields/#django.db.models.DateTimeField) ketika dukungan zona waktu aktif. Gunakan [`QuerySet.datetimes()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.datetimes) sebagai gantinya. #### `date_hierarchy` membutuhkan penentuan zona waktu Fitur [`date_hierarchy`](/id/5.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin.date_hierarchy) dari admin sekarang bergantung pada [`QuerySet.datetimes()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.datetimes) ketika itu digunakan di [`DateTimeField`](/id/5.2/ref/models/fields/#django.db.models.DateTimeField). Ini membutuhkan penentuan zona waktu di basisdata ketika [`USE_TZ`](/id/5.2/ref/settings/#std-setting-USE_TZ) adalah `True`. [Learn more](/id/5.2/ref/models/querysets/#database-time-zone-definitions). #### `date_list` dalam tampilan umum membutuhkan penentuan zona waktu Untuk alasan sama, mengakses `date_list` di konteks dari tampilan umum berdasarkan-tanggal membutuhkan penentuan zona waktu di basisdata ketika tampilan berdasarkan pada [`DateTimeField`](/id/5.2/ref/models/fields/#django.db.models.DateTimeField) dan [`USE_TZ`](/id/5.2/ref/settings/#std-setting-USE_TZ) adalah `True`. [Learn more](/id/5.2/ref/models/querysets/#database-time-zone-definitions). ### Pencarian baru mungkin bertabrakan dengan bidang-bidang model Django 1.6 memperkenalkan pencarian `hour`, `minute`, dan `second` di [`DateTimeField`](/id/5.2/ref/models/fields/#django.db.models.DateTimeField). Jika anda mempunyai bidang model dipanggil `hour`, `minute`, atau `second`, pencarian baru akan bentrok dengan nama bidang anda. Tambahkan sebuah pencarian [`exact`](/id/5.2/ref/models/querysets/#std-fieldlookup-exact) jelas jika ini adalah sebuah masalah. ### `BooleanField` tidak lagi disetel ke `False` Ketika sebuah [`BooleanField`](/id/5.2/ref/models/fields/#django.db.models.BooleanField) tidak mempunyai [`default`](/id/5.2/ref/models/fields/#django.db.models.Field.default) jelas, nilai awalan tersirat adalah `None`. Dalam versi sebelumnya dari Django, itu adalah `False`, tetapi itu tidak mewakili secara akurat kekurangan dari sebuah nilai. Kode yang bergantung pada nilai awalan menjadi `False` mungkin memunculkan sebuah pengecualian ketika menyimpan instance model baru ke basisdata, karena `None` bukan sebuah nilai yang dapat diterima untuk sebuah [`BooleanField`](/id/5.2/ref/models/fields/#django.db.models.BooleanField). Anda harus juga menentukan `default=False` di penentuan bidang, atau memastikan bidang disetel ke `True` atau `False` sebelum menyimpan obyek. ### Terjemahan dan komentar dalam cetakan #### Pengeluaran dari terjemahan setelah komentar Pengeluaran dari harfiah dapat diterjemahkan dari cetakan dengan perintah [`makemessages`](/id/5.2/ref/django-admin/#django-admin-makemessages) sekarang dengan benar mengenali gagasan i18n ketika mereka ditempatkan setelah sebuah `{#` / `#}`\- ketik komentar di baris sama. Sebagai contoh: ```html+django {# A comment #}{% trans "This literal was incorrectly ignored. Not anymore" %} ``` #### Tempat untuk komentar penterjemah [Komentar untuk penterjemah dalam cetakan](/id/5.2/topics/i18n/translation/#translator-comments-in-templates) ditentukan menggunakan `{#` / `#}` harus pada akhir dari sebuah baris. Jika mereka tidak, komentar diabaikan dan [`makemessages`](/id/5.2/ref/django-admin/#django-admin-makemessages) akan membangkitkan sebuah peringatan. Sebagai contoh: ```html+django {# Translators: This is ignored #}{% trans "Translate me" %} {{ title }}{# Translators: Extracted and associated with 'Welcome' below #}

{% trans "Welcome" %}

``` ### Mengutip dalam `reverse()` Ketika membalikkan URL, Django tidak memberlakukan `django.utils.http.urlquote` pada argumen-argumen sebelum menyisipkan mereka dalam pola URL. Kesalahan ini diperbaiki di Django 1.6. Jika anda bekerja disekitar kesalahan ini dengan memberlakukan kutipan URL sebelum melewatkan argumen pada `reverse()`, ini mungkin menghasilkan kutipan-ganda. Jika ini terjadi, cukup pindahkan kutipan URL dari kode anda. Ini akan juga mengganti karakter khusus dalam URL digunakan dalam [`assertRedirects()`](/id/5.2/topics/testing/tools/#django.test.SimpleTestCase.assertRedirects) dengan versi tersandikan mereka. ### Penyimpanan dari alamat IP dalam aplikasi komentar Aplikasi komentar sekarang menggunakan sebuah `GenericIPAddressField` untuk menyimpan alamat IP komentar, untuk mendukung komentar diajukan dari alamat IPv6. Sampai sekarang, itu menyimpan mereka di sebuah `IPAddressField`, yang hanya berarti mendukung IPv4. Ketika menyimpan sebuah komentar yang dibuat dari alamat IPv6, alamat akan secara diam dipotong di basisdata MySQL, dan memunculkan sebuah pengecualian di Oracle. Anda akan butuh merubah jenis kolom di basisdata anda untuk mengambil keuntungan dari perubahan ini. Untuk MySQL, jalankan permintaan ini di basisdata proyek anda: ```sql ALTER TABLE django_comments MODIFY ip_address VARCHAR(39); ``` Untuk Oracle, jalankan permintaan ini: ```sql ALTER TABLE DJANGO_COMMENTS MODIFY (ip_address VARCHAR2(39)); ``` Jika anda tidak memberlakukan perubahan ini, perilaku tidak berubah: di MySQL, alamat IPv6 secara diam dipotong; di Oracle, sebuah pengecualian dibangkitkan. Tidak ada perubahan basisdata dibutuhkan untuk basisdata SQLite atau PostgreSQL. ### Harfiah persen di permintaan `cursor.execute` Ketika anda sedang menjalankan permintaan SQL mentah melalui metode [cursor.execute](/id/5.2/topics/db/sql/#executing-custom-sql), aturan mengenai hardiah persen ganda (`%`) didalam permintaan telah kompak. Perilaku lama bergantung di backend basisdata. Sekarang, lintas semua backend, anda hanya butuh menggandakan karakter persen harfiah jika anda sedang juga menyediakan parameter pengganti. Sebagai contoh: ``` # No parameters, no percent doubling cursor.execute("SELECT foo FROM bar WHERE baz = '30%'") # Parameters passed, non-placeholders have to be doubled cursor.execute("SELECT foo FROM bar WHERE baz = '30%%' and id = %s", [self.id]) ``` Pengguna `SQLite` butuh memeriksa dan memperbaharui permintaan tersebut. ### Teks bantuan dari bidang formulir model untuk bidang ManyToManyField Membangun HTML dari bidang formulir model sesuai pada bidang model [`ManyToManyField`](/id/5.2/ref/models/fields/#django.db.models.ManyToManyField) digunakan untuk mendapatkan kalimat kode-keras: > *Tekan "Control", atau "Command" pada Mac, untuk memilih lebih dari satu.* (atau terjemahannya pada lokal aktif) dikenakan sebagai bantuan lagenda ditampilkan bersama mereka jika tak ada [`model`](/id/5.2/ref/models/fields/#django.db.models.Field.help_text) maupun [`form`](/id/5.2/ref/forms/fields/#django.forms.Field.help_text) atribut `help_text` telah ditentukan oleh pengguna (atau string ini telah ditambahkan ke setiap `help_text` yang telah disediakan). Sejak ini terjadi di lapisan model, tidak ada cara mencegah teks dari muncul di kasus-kasus domana itu tidak berlaku seperti bidang formulir yang menerapkan interaksi pengguna yang anda tidak melibatkan papan kunci dan/atau sebuah tetikus. Dimulai dengan Django 1.6, sebagai sebuah ketentuan kesesuaian-kebelakang sementara ad-hoc, logika untuk menambahkan kalimat "Hold down..." telah dipindahkan ke lapisan bidang formulir model dan dirubah untuk menambahkan hanya teks ketika widget terkait adalah [`SelectMultiple`](/id/5.2/ref/forms/widgets/#django.forms.SelectMultiple) atau subkelas terpilih. Perubahan ini dapat mempengaruhi anda di cara ketidaksesuaian kebelakang jika anda menggunakan bidang formulir model penyesuaian dan/atau widget untuk bidang model `ManyToManyField` yang UI nya bergantung pada ketentuan otomatis dari kalimat kode-kerasyang disebutkan. Penerapan bidang formulir ini butuh menyesuaikan ke skenario baru dengan menyediakan penanganan milik mereka dari atribut `help_text`. Apliaksi yang menggunakan fasilitas [model form](/id/5.2/topics/forms/modelforms/) Django bersama-sama dengan formulir siap-pakai Django [fields](/id/5.2/ref/forms/fields/) dan [widgets](/id/5.2/ref/forms/widgets/) tidak terpengaruh tetapi butuh disadari dari apa digambarkan dalam [Mung dari teks bantuan dari bidang formulir model untuk bidang-bidang ManyToManyField](#m2m-help-text-deprecation) dibawah. ### Perulangan QuerySet Perulangan `QuerySet` telah berubah untuk segera merubah semua baris yang diambil pada obyek `Model`. Di Django 1.5 dan lebih awal untuk mengambil baris telah dirubah ke obyek `Model` dalam 100 potongan. Kode yang ada akan bekerja, tetapi sejumlah baris dirubah ke obyek mungkin berubah dalam kasus penggunaan tertentu. Penggunaan seperti itu termasuk sebagian berulang terhadap sebuah queryset atau penggunaan apapun yang mengakhiri melakukan `__bool__` atau `__contains__`. Terutama kebanyakan backend basisdata melakukan pengambilan semua baris dalam satu pergi sudah di 1.5. Itu masih memungkinkan merubah barisan diambil pada obyek `Model` lazily dengan menggunakan metode [`iterator()`](/id/5.2/ref/models/querysets/#django.db.models.query.QuerySet.iterator). ### [`BoundField.label_tag`](/id/5.2/ref/forms/api/#django.forms.BoundField.label_tag) sekarang menyertakan [`label_suffix`](/id/5.2/ref/forms/api/#django.forms.Form.label_suffix) formulir Ini adalah konsisten dengan bagaimana metode seperti [`Form.as_p`](/id/5.2/ref/forms/api/#django.forms.Form.as_p) dan [`Form.as_ul`](/id/5.2/ref/forms/api/#django.forms.Form.as_ul) membangun label. Jika anda secara manual membangun `label_tag` dalam cetakan anda: ```html+django {{ form.my_field.label_tag }}: {{ form.my_field }} ``` anda akan ingin memindahkan titik dua (atau apapun pemisah lainnya anda mungkin gunakan) untuk menghindari penggandaan itu ketika meningkatkan ke Django 1.6. Cetakan berikut di Django 1.6 akan membangun secara mirip ke cetakan diatas di Django 1.5, kecuali bahwa titik koma akan muncul didalam unsur `