Linimasa Pengusangan Django¶
Ringkasan dokumen ini ketika beragam potongan Django akan dipindahkan atau diubah dalam cara kesesuaian kebelakang, mengikuti pengusangan mereka, sebagai per deprecation policy. Lebih rinci tentang setiap barang dapat sering ditemukan dalam catatan terbitan dari dua versi sebelumnya.
4.1¶
See the Django 3.2 release notes for more details on these changes.
- Support for assigning objects which don't support creating deep copies with
copy.deepcopy()to class attributes inTestCase.setUpTestData()will be removed. BaseCommand.requires_system_checkswon't support boolean values.- The
whitelistargument anddomain_whitelistattribute ofdjango.core.validators.EmailValidatorwill be removed. - The
default_app_configmodule variable will be removed. TransactionTestCase.assertQuerysetEqual()will no longer automatically callrepr()on a queryset when compared to string values.django.core.cache.backends.memcached.MemcachedCachewill be removed.- Support for the pre-Django 3.2 format of messages used by
django.contrib.messages.storage.cookie.CookieStoragewill be removed.
4.0¶
Lihat Django 3.0 release notes untuk rincian lebih pada perubahan ini.
django.utils.http.urlquote(),urlquote_plus(),urlunquote(), danurlunquote_plus()akan dipindahkan.django.utils.encoding.force_text()dansmart_text()akan dipindahkan.django.utils.translation.ugettext(),ugettext_lazy(),ugettext_noop(),ungettext(), danungettext_lazy()akan dipindahkan.django.views.i18n.set_language()akan tidak lama lagi menyetel bahasa pengguna dalamrequest.session(keydjango.utils.translation.LANGUAGE_SESSION_KEY).alias=Noneakan diperlukan dalam tanda tangan dari subkelasdjango.db.models.Expression.get_group_by_cols().django.utils.text.unescape_entities()akan dipindahkan.django.utils.http.is_safe_url()akan dipindahkan.
See the Django 3.1 release notes for more details on these changes.
- The
PASSWORD_RESET_TIMEOUT_DAYSsetting will be removed. - The undocumented usage of the
isnulllookup with non-boolean values as the right-hand side will no longer be allowed. - The
django.db.models.query_utils.InvalidQueryexception class will be removed. - The
django-admin.pyentry point will be removed. - The
HttpRequest.is_ajax()method will be removed. - Support for the pre-Django 3.1 encoding format of cookies values used by
django.contrib.messages.storage.cookie.CookieStoragewill be removed. - Support for the pre-Django 3.1 password reset tokens in the admin site (that use the SHA-1 hashing algorithm) will be removed.
- Support for the pre-Django 3.1 encoding format of sessions will be removed.
- Support for the pre-Django 3.1
django.core.signing.Signersignatures (encoded with the SHA-1 algorithm) will be removed. - Support for the pre-Django 3.1
django.core.signing.dumps()signatures (encoded with the SHA-1 algorithm) indjango.core.signing.loads()will be removed. - Support for the pre-Django 3.1 user sessions (that use the SHA-1 algorithm) will be removed.
- The
get_responseargument fordjango.utils.deprecation.MiddlewareMixin.__init__()will be required and won't acceptNone. - The
providing_argsargument fordjango.dispatch.Signalwill be removed. - The
lengthargument fordjango.utils.crypto.get_random_string()will be required. - The
listmessage forModelMultipleChoiceFieldwill be removed. - Support for passing raw column aliases to
QuerySet.order_by()will be removed. - The model
NullBooleanFieldwill be removed. A stub field will remain for compatibility with historical migrations. django.conf.urls.url()akan dipindahkan.- The model
django.contrib.postgres.fields.JSONFieldwill be removed. A stub field will remain for compatibility with historical migrations. django.contrib.postgres.forms.JSONField,django.contrib.postgres.fields.jsonb.KeyTransform, anddjango.contrib.postgres.fields.jsonb.KeyTextTransformwill be removed.- The
{% ifequal %}and{% ifnotequal %}template tags will be removed. - The
DEFAULT_HASHING_ALGORITHMtransitional setting will be removed.
3.1¶
Lihat Django 2.2 release notes untuk rincian lebih pada perubahan ini.
django.utils.timezone.FixedOffsetakan dipindahkan.django.core.paginator.QuerySetPaginatorakan dipindahkan.- Sebuah model
Meta.orderingakan tidak lagi mempengaruhi permintaanGROUP BY. django.contrib.postgres.fields.FloatRangeFielddandjango.contrib.postgres.forms.FloatRangeFieldakan dipindahkan.- Pengaturan
FILE_CHARSETakan dipindahkan. django.contrib.staticfiles.storage.CachedStaticFilesStorageakan dipindahkan.RemoteUserBackend.configure_user()akan membutuhkanrequestsebagai argumen penempatan pertama.- Dukungan untuk
SimpleTestCase.allow_database_queriesdanTransactionTestCase.multi_dbakan dipindahkan.
3.0¶
Lihat Django 2.0 release notes untuk rincian lebih pada perubahan-perubahan ini.
- Modul
django.db.backends.postgresql_psycopg2akan dipindahkan. django.shortcuts.render_to_response()akan dipindahkan.- Pengaturan
DEFAULT_CONTENT_TYPEakan dipindahkan. HttpRequest.xreadlines()akan dipindahkan.- Dukungan untuk argumen
contextdariField.from_db_value()danExpression.convert_value()akan dipindahkan. - Argumen katakunci
field_namedariQuerySet.earliest()andlatest()akan dipindahkan.
Lihat Django 2.1 release notes untuk rincian lebih pada perubahan ini.
django.contrib.gis.db.models.functions.ForceRHRakan dipindahkan.django.utils.http.cookie_date()akan dipindahkan.- Pustaka etiket cetakan
staticfilesdanadmin_staticakan dipindahkan. django.contrib.staticfiles.templatetags.static()akan dipindahkan.- Shim ini mengizinkan
InlineModelAdmin.has_add_permission()ditentukan tanpa sebuah argumenobjakan dipindahkan.
2.1¶
Lihat Django 1.11 release notes untuk lebih rinci pada perubahan ini.
contrib.auth.views.login(),logout(),password_change(),password_change_done(),password_reset(),password_reset_done(),password_reset_confirm(), danpassword_reset_complete()akan dipindahkan.- Parameter
extra_contextdaricontrib.auth.views.logout_then_login()akan dipindahkan. django.test.runner.setup_databases()akan dipindahkan.django.utils.translation.string_concat()akan dipindahkan.django.core.cache.backends.memcached.PyLibMCCachetidak akan lagi mengukung melewatkan pengaturan perilakupylibmcsebagai atribut tingkat-atas dariOPTIONS.- Parameter
hostdaridjango.utils.http.is_safe_url()akan dipindahkan. - Mendiamkan dari pengecualian dimunculkan selagi membangun etiket cetakan
{% include %}akan dipindahkan. DatabaseIntrospection.get_indexes()akan dipindahkan.- Metode
authenticate()dari backend autentifikasi akan membutuhkanrequestsebagai argumen penempatan pertama. - Penghias
django.db.models.permalink()akan dipindahkan. - Pengaturan
USE_ETAGSakan dipindahkan.CommonMiddlewareanddjango.utils.cache.patch_response_headers()tidak akan lagi menyetel ETag. - Atribut
Model._meta.has_auto_fieldakan dipindahkan. url()mendukugn dibarisan bendera dalam kelompok regular expression ((?i),(?L),(?m),(?s), and(?u)) akan dipindahkan.- Mendukung untuk metode
Widget.render()tanpa argumenrendererakan dipindahkan.
2.0¶
Lihat Django 1.9 release notes untuk lebih rinci pada perubahan ini.
- Argumen
weakpadadjango.dispatch.signals.Signal.disconnect()akan dipindahkan. django.db.backends.base.BaseDatabaseOperations.check_aggregate_support()akan dipindahkan.- Paket
django.forms.extrasakan dipindahkan. - Pembantu
assignment_tagakan dipindahkan. - Argumen
hostpadaassertsRedirectsakan dipindahkan. Lapisan kesesuaian yang mengizinkan URL mutlak untuk di pertimbangkan sama pada yang relatif ketika jalur sama akan juga dipindahkan. Field.relakan dipindahkan.- Atribut
Field.remote_field.toakan dipindahkan. - Argumen
on_deleteuntukForeignKeydanOneToOneFieldakan dibutuhkan. django.db.models.fields.add_lazy_relation()akan dipindahkan.- Ketika dukungan zona waktu diadakan, backend basisdata yang tidak mendukung zona waktu tidak akan merubah tanggal waktu ke nilai naif dalam UTC lagi ketika nilai-nilai tersebut dilewatkan sebagai parameter pada permintaan SQl dijalankan diluar dari ORM, yaitu dengan
cursor.execute(). - Penghias
django.contrib.auth.tests.utils.skipIfCustomUser()akan dipindahkan. - Kelas
GeoManagerdanGeoQuerySetakan dipindahkan. - Modul
django.contrib.gis.geoipakan dipindahkan. - Pemeriksaan
supports_recursionuntuk pemuat cetakan akan dipindahkan dari:django.template.engine.Engine.find_template()django.template.loader_tags.ExtendsNode.find_template()django.template.loaders.base.Loader.supports_recursion()django.template.loaders.cached.Loader.supports_recursion()
- Cara pemuat cetakan
load_template()danload_template_sources()akan dipindahkan. - Argumen
template_dirsuntuk pemuat cetakan akan dipindahkan:django.template.loaders.base.Loader.get_template()django.template.loaders.cached.Loader.cache_key()django.template.loaders.cached.Loader.get_template()django.template.loaders.cached.Loader.get_template_sources()django.template.loaders.filesystem.Loader.get_template_sources()
- Cara django.template.loaders.base.Loader.__call__()` akan dipindahkan.
- Dukungan untuk tampilan penyesuaian kesalahan dengan parameter penempatan tunggal akan dihilangkan.
- Atribut
mime_typedaridjango.utils.feedgenerator.Atom1Feeddandjango.utils.feedgenerator.RssFeedakan dipindahkan mendukung daricontent_type. - Argumen
app_namepadadjango.conf.urls.include()akan dipindahkan. - Dukungan untuk melewatkan 3-tuple sebagai argumen eprtama untuk
include()akan dipindahkan. - Dukungan untuk pengaturan namespace instance URL tanpa sebuah aplikasi namescpae akan dipindahkan.
Field._get_val_from_obj()akan dipindahkan mendukungField.value_from_object().django.template.loaders.eggs.Loaderakan dipindahkan.- Parameter
current_appke tampilancontrib.authakan dipindahkan. - Argumen katakunci
callable_objpadaSimpleTestCase.assertRaisesMessage()akan dipindahkan. - Dukungan untuk atribut
allow_tagspada caraModelAdminakan dipindahkan. - Argumen katakunci
enclosurepadaSyndicationFeed.add_item()akan dipindahkan. - Nama lain
django.template.loader.LoaderOrigindandjango.template.base.StringOriginuntukdjango.template.base.Originakan dipindahkan.
Lihat Django 1.10 release notes untuk rincian lebih pada perubahan ini.
- Pilihan
makemigrations --exitakan dipindahkan. - Dukungan untuk penugasan langsung untuk membalikkan foreign key atau hubungan many-to-many akan dipindahkan.
- Cara
get_srid()danset_srid()daridjango.contrib.gis.geos.GEOSGeometryakan dipindahkan. - Cara
get_x(),set_x(),get_y(),set_y(),get_z(), danset_z()daridjango.contrib.gis.geos.Pointakan dipindahkan. - Cara
get_coords()danset_coords()daridjango.contrib.gis.geos.Pointakan dipindahkan. cascaded_unionmilik daridjango.contrib.gis.geos.MultiPolygonakan dipindahkan.django.utils.functional.allow_lazy()akan dipindahkan.- Pilihan
shell --plainakan dipindahkan. - Modul
django.core.urlresolversakan dipindahkan. - Model
CommaSeparatedIntegerFieldakan dipindahkan. Potongan bidang akan tetap untuk kesesuaian dengan riwayat perpindahan. - Dukungan untuk cetakan cara
Context.has_key()akan dipindahkan. - Dukungan untuk cara
django.core.files.storage.Storage.accessed_time(),created_time(), danmodified_time()akan dipindahkan. - Dukungan untuk pencarian permintaan menggunakan nama model ketika
Meta.default_related_namedisetel akan dipindahkan. - Permintaan pencarian
__searchdan caraDatabaseOperations.fulltext_search_sql()akan dipindahkan. - Shim untuk mendukung penyesuaian kelas-kelas pengelola terkait tanpa metode
_apply_rel_filters()akan dipindahkan. - Menggunakan
User.is_authenticated()danUser.is_anonymous()sebagai cara tidak akan lagi didukung. - Atribut pribadi
virtual_fieldsdariModel._metaakan dipindahkan. - Argumen katakunci pribadi
virtual_onlydalamField.contribute_to_class()danvirtualdalamModel._meta.add_field()akan dipindahkan. - Tampilan
javascript_catalog()danjson_catalog()akan dipindahkan. - Fungsi
django.contrib.gis.utils.precision_wkt()akan dipindahkan. - Dalam warisan banyak-tabel, promosi tersirat dari
OneToOneFieldke aparent_linkakan dipindahkan. - Dukungan untuk
Widget._format_value()akan dipindahkan. - Cara
FileFieldget_directory_name()danget_filename()akan dipindahkan. - Fungsi
mark_for_escaping()dan kelas-kelas dia gunakan:EscapeData,EscapeBytes,EscapeText,EscapeString, danEscapeUnicodeakan dipindahkan. - Penyaring
escapeakan berubah untuk menggunakandjango.utils.html.conditional_escape(). Manager.use_for_related_fieldsakan dipindahkan.- Warisan model
managerakan mengikuti aturan warisan MRO danMeta.manager_inheritance_from_futureuntuk di daftarkan pada kebiasaan ini akan dipindahkan. - Dukungan untuk middleware gaya-lama menggunakan
settings.MIDDLEWARE_CLASSESakan dipindahkan.
1.10¶
Lihat Django 1.8 release notes untuk lebih rinci pada perubahan ini.
- Dukungan untuk memanggil
SQLCompilersecara langsung sebagai nama lain untuk memanggil caraquote_name_unless_aliasnya akan dipindahkan. - Etiket cetakan
cycledanfirstofakan dipindahkan dari pustaka etiket cetakanfuture(digunakan selama masa pengusangan 1.6/1.7). - django.conf.urls.patterns()` akan dipindahkan.
- Dukungan untuk argumen
prefixpadadjango.conf.urls.i18n.i18n_patterns()akan dipindahkan. SimpleTestCase.urlsakan dipindahkan.- Menggunakan jumlah tidak benar dari nilai-nilai dibongkar etiket cetakan
forakan memunculkan pengecualian dari pada gagal diam-diam. - Kemampuan untuk membalikkan URL menggunakan jalur Python bertitik akan dipindahkan.
- Kemampuan menggunakan jalur Python bertitik untuk pengaturan
LOGIN_URLdanLOGIN_REDIRECT_URLakan dipindahkan. - Dukungan untuk
optparseakan dihilangkan untuk perintah pengelolaan penyesuaian (diganti olehargparse). - Kelas
django.core.management.NoArgsCommandakan dipindahkan. GunakanBaseCommandsebagai gantinya, yang tidak mengambil argumen secara permulaan. - Modul
django.core.context_processorsakan dipindahkan. - Modul
django.db.models.sql.aggregatesakan dipindahkan. - Modul
django.contrib.gis.db.models.sql.aggregatesakan dipindahkan. - Cara dan properti berikut dari
django.db.sql.query.Queryakan dipindahkan:- Properti:
aggregatesdanaggregate_select - Cara:
add_aggregate,set_aggregate_mask, danappend_aggregate_mask.
- Properti:
django.template.resolve_variableakan dipindahkan.- API pribadi berikut akan dipindahkan dari
django.db.models.options.Options(Model._meta):get_field_by_name()get_all_field_names()get_fields_with_model()get_concrete_fields_with_model()get_m2m_with_model()get_all_related_objects()get_all_related_objects_with_model()get_all_related_many_to_many_objects()get_all_related_m2m_objects_with_model()
- Argumen
error_messagedaridjango.forms.RegexFieldakan dipindahkan. - Penyaring
unordered_listtidak akan mendukung lagi daftar gaya lama. - Dukungan untuk deretan karakter argumen
viewpadaurl()akan dipindahkan. - Shim kesesuaian kebelakang untuk dinamai kembali
django.forms.Form._has_changed()menjadihas_changed()telah dipindahkan. - Penyaring cetakan
removetagsakan dipindahkan. - Fungsi
remove_tags()danstrip_entities()didjango.utils.htmlakan dipindahkan. - Argumen
is_admin_sitepadadjango.contrib.auth.views.password_reset()akan dipindahkan. django.db.models.field.subclassing.SubfieldBaseakan dipindahkan.django.utils.checksumsakan dipindahkan; kegunaannya disertakan didjango-localflavor1.1+- Atribut
original_content_type_idpadadjango.contrib.admin.helpers.InlineAdminFormakan dipindahkan. - Shim kesesuaian kebelakang mengizinkan
FormMixin.get_form()untuk ditentukan dengan tidak ada nilai awalan untuk argumenform_classnya akan dipindahkan. - Pengaturan berikut akan dipindahkan:
ALLOWED_INCLUDE_ROOTSTEMPLATE_CONTEXT_PROCESSORSTEMPLATE_DEBUGTEMPLATE_DIRSTEMPLATE_LOADERSTEMPLATE_STRING_IF_INVALID
- Nama lain kesesuaian kebelakang
django.template.loader.BaseLoaderakan dipindahkan. - Obyek cetakan Django dikembalikan oleh func:~django.template.loader.get_template dan
select_template()tidak akan menerimaContextdalam cararender()mereka lagi. - Template response APIs akan melaksanakan penggunaan dari obyek cetakan
dictdan backend-dependent daripadaContextdanTemplatemasing-masing. - Parameter
current_appuntuk fungsi dan kelas berikut akan dipindahkan:django.shortcuts.render()django.template.Context()django.template.RequestContext()django.template.response.TemplateResponse()
- Parameter
dictionarydancontext_instanceuntuk fungsi berikut akan dipindakan:django.shortcuts.render()django.shortcuts.render_to_response()django.template.loader.render_to_string()
- Parameter
dirsuntuk fungsi berikut akan dipindahkan:django.template.loader.get_template()django.template.loader.select_template()django.shortcuts.render()django.shortcuts.render_to_response()
- Pembuktian sesi akan diadakan tanpa memerhatikan dari apakah atau tidak
'django.contrib.auth.middleware.SessionAuthenticationMiddleware'diMIDDLEWARE_CLASSES. - Atribut pribadi
django.db.models.Field.relatedakan dipindahkan. - Pilihan
--listdari perintah pengelolaanmigrateakan dipindahkan. - Etiket cetakan
ssiakan dipindahkan. - Dukungan untuk
=penghubung perbandingan di etiket cetakanifakan dipindahkan. - Shim kesesuaian kebelakang mengizinkan
Storage.get_available_name()danStorage.save()untuk ditentukan tanpa sebuah argumenmax_lengthakan dipindahkan. - Dukungan untuk warisan sintaksis
%(<foo>)sdiModelFormMixin.success_urlakan dipindahkan. GeoQuerySetkumpulan caracollect(),extent(),extent3d(),make_line(), danunionagg()akan dipindahkan.- Kemampuan untuk menentukan
ContentType.nameketika membuat instance jenis isi akan dipindahkan. - Dukungan untuk tanda tangan lama dari
allow_migrateakan dipindahkan. Dia dirubah dariallow_migrate(self, db, model)menjadiallow_migrate(self, db, app_label, model_name=None, **hints). - Dukungan untuk sintaksis
{% cycle %}yang menggunakan argumen dipisah-koma akan dipindahkan. - Peringatan yang
Signermuncul ketika pemisah tidak sah yang diberikan akan menjadi sebuah pengecualian.
1.9¶
Lihat Django 1.7 release notes untuk rincian lebih pada perubahan ini.
django.utils.dictconfigakan dipindahkan.django.utils.importlibakan dipindahkan.django.utils.tzinfoakan dipindahkan.django.utils.unittestakan dipindahkan.- Perintah
syncdbakan dipindahkan. django.db.models.signals.pre_syncdbdandjango.db.models.signals.post_syncdbakan dipindahkan.allow_syncdbpada router basisdata tidak lagi otomatis menjadiallow_migrate.- Sinkronisasi otomatis dari aplikasi tanpa perpindahan akan dipindahkan. Perpindahan akan menjadi wajib untuk semua aplikasi meskipun anda melewati pilihan
--run-syncdbuntukmigrate. - Perintah pengelolaan SQL untuk aplikasi tanpa perpindahan,
sql,sqlall,sqlclear,sqldropindexes, dansqlindexes, akan dipindahkan. - Dukungan untuk memuat otomatis dari perlengkapan
initial_datadan data SQL awal akan dipindahkan. - Semua model akan butuh ditentukan didalam aplikasi terpasang atau menyatakan eksplisit
app_label. Lebih jauh, dia tidak akan memungkinkan untuk mengimpor didalam paket akar dari apliaksi mereka. - Model dan formulir
IPAddressFieldakan dipindahkan. Bidang potongan akan tetap untuk kesesuaian dengan riwayat perpindahan. AppCommand.handle_app()tidak lama lagi didukung.RequestSitedanget_current_site()tidak akan lagi dapat diimpor daridjango.contrib.sites.models.- Dukungan FastCGI melalui perintah pengelolaan
runfcgiakan dipindahkan. Harap sebarkan proyek anda menggunakan WSGI. django.utils.datastructures.SortedDictakan dipindahkan. Gunakancollections.OrderedDictdari pustaka standar Python.ModelAdmin.declared_fieldsetsakan dipindahkan.- Instance dari
util.pydi kode basis Django telah dinamai kembali ke utils.py` dalam sebuah usaha untuk menyatukan semua acuan alat dan alat-alat. Modul-modul yang menyediakan kesesuaian kebelakang akan dipindahkan:django.contrib.admin.utildjango.contrib.gis.db.backends.utildjango.db.backends.utildjango.forms.util
ModelAdmin.get_formsetsakan dipindahkan.- Shim kesesuaian kebelakang diperkenalkan untuk menamai kembali metode
BaseMemcachedCache._get_memcache_timeout()padaget_backend_timeout()akan dipindahkan. - Pilihan
--naturaldan-nuntukdumpdataakan dipindahkan. - Argumen
use_natural_keysuntukserializers.serialize()akan dipindahkan. - API pribadi
django.forms.forms.get_declared_fields()akan dipindahkan. - Kemampuan untuk menggunakan
SplitDateTimeWidgetdenganDateTimeFieldakan dipindahkan. - Properti
WSGIRequest.REQUESTakan dipindahkan. - Kelas
django.utils.datastructures.MergeDictakan dipindahkan. - Kode bahasa
zh-cndanzh-twakan dipindahkan dan telah digantikan oleh kode bahasazh-hansandzh-hantmasing-masing. - Internal
django.utils.functional.memoizeakan dipindahkan. django.core.cache.get_cacheakan dipindahkan. Tambah masukan yang cocok untukCACHESdan gunakandjango.core.cache.caches.django.db.models.loadingakan dipindahkan.- Melewatkan argumen callable ke queryset tidak akan lagi memungkinkan.
BaseCommand.requires_model_validationakan dipindahkan mendukungrequires_system_checks. Pengesah admin akan diganti dengan admin pemeriksa.- Atribut ModelAdmin.validator_class` dan
default_validator_classakan dipindahkan. ModelAdmin.validate()akan dipindahkan.django.db.backends.DatabaseValidation.validate_fieldakan dipindahkan mundukung caracheck_field.- Perintah pengelolaan
validateakan dipindahkan. django.utils.module_loading.import_by_pathakan dipindahkan mendukung django.utils.module_loading.import_string`.- Etiket cetakan
ssidanurlakan dipindahkan dari pustaka etiket cetakanfuture(digunakan selama masa pengusangan 1.3/1.4). django.utils.text.javascript_quoteakan dipindahkan.- Pengaturan percobaan basisdata sebagai masukan berdiri sendiri dalam pengaturan basisdata, diawali dengan
TEST_, tidak lagi didukung. - The
cache_choicesoption toModelChoiceFieldandModelMultipleChoiceFieldwill be removed. - Nilai awal dari atribut
RedirectView.permanentakan berubah dariTruemenjadiFalse. django.contrib.sitemaps.FlatPageSitemapakan dipindahkan mendukungdjango.contrib.flatpages.sitemaps.FlatPageSitemap.- API pribadi
django.test.utils.TestTemplateLoaderakan dipindahkan. - Modul
django.contrib.contenttypes.genericakan dipindahkan. - API Pribadi
django.db.models.sql.where.WhereNode.make_atom()dandjango.db.models.sql.where.Constraintakan dipindahkan.
1.8¶
Lihat Django 1.6 release notes untuk rincian lebih pada perubahan ini.
django.contrib.commentsakan dipindahkan.- Transaksi pengelolaan API berikut akan dipindahkan:
TransactionMiddleware,- Penghias dan pengelola konteks
autocommit,commit_on_success, dancommit_manually, ditentukan dalamdjango.db.transaction, - Fungsi
commit_unless_manageddanrollback_unless_managed, juga ditentukan dalamdjango.db.transaction, - Pengaturan
TRANSACTIONS_MANAGED.
- Etiket cetakan
cycledanfirstofakan meloloskan-otomatis argumen mereka. Dalam 1.6 dan 1.7, kebiasaan ini disediakan oleh versi dari etiket ini di pustaka etiket cetakanfuture. - Pengaturan
SEND_BROKEN_LINK_EMAILSakan dipindahkan. Tambah middlewaredjango.middleware.common.BrokenLinkEmailsMiddlewareke pengaturanMIDDLEWARE_CLASSESsebagai gantinya. django.middleware.doc.XViewMiddlewareakan dipindahkan. Lebih baik gunakandjango.contrib.admindocs.middleware.XViewMiddleware.Model._meta.module_nametelah dinamai kembali menjadimodel_name.- Memindahkan shim kesesuaian kebelakang diperkenalkan untuk menamai kembali
get_query_setdan metode queryset yang mirip dipindahkan. Ini mempengaruhi kelas-kelas berikut:BaseModelAdmin,ChangeList,BaseCommentNode,GenericForeignKey,Manager,SingleRelatedObjectDescriptordanReverseSingleRelatedObjectDescriptor. - Memindahkan shim kesesuaian kebelakang diperkenalkan untuk menamai kembali atribut
ChangeList.root_query_setdanChangeList.query_set. django.views.defaults.shortcutakan dipindahkan, sebagai bagian dari tujuan memindahkan semua acuandjango.contribdari basiskode inti Django. Daripada menggunakandjango.contrib.contenttypes.views.shortcut.django.conf.urls.shortcutakan juga dipindahkan.- Dukungan untuk modul Python Imaging Library (PIL) akan dipindahkan, saat itu tidak lagi muncul secara aktif dirawat & tidak bekerja pada Python 3.
- API pribadi berikut akan dipindahkan:
django.db.backenddjango.db.close_connection()django.db.backends.creation.BaseDatabaseCreation.set_autocommit()django.db.transaction.is_managed()django.db.transaction.managed()
django.forms.widgets.RadioInputakan dipindahkan mendukungdjango.forms.widgets.RadioChoiceInput.- Modul
django.test.simpledan kelasdjango.test.simple.DjangoTestSuiteRunnerakan dipindahkan. Sebagai gantinya gunakandjango.test.runner.DiscoverRunner. - Modul
django.test._doctestakan dipindahkan. Sebagai gantinya gunakan modul doctest dari pustaka biasa Python. - Pengaturan
CACHE_MIDDLEWARE_ANONYMOUS_ONLYakan dipindahkan. - Penggunaan dari kode keras Menekan "Control", atau "Command" pada Mac, untuk memilih lebih dari satu. deretan karakter untuk dikesampingkan atau ditambah ke
help_textdisediakan pengguna dalam formulir untuk model bidang ManyToMany tidak akan dilakukan oleh Django lagi pada model atau lapisan formulir. - Cara
Model._meta.get_(add|change|delete)_permissionakan dipindahkan. - Kunci sesi
django_languagetidak lama lagi dapat dibaca untuk kesesuaian kebelakang. - Petasitus Geografis akan dipindahkan (
django.contrib.gis.sitemaps.views.indexdandjango.contrib.gis.sitemaps.views.sitemap). django.utils.html.fix_ampersands, penyaring cetakanfix_ampersandsdandjango.utils.html.clean_htmlakan dipindahkan mengikuti pengusangan yang dipercepat.
1.7¶
Lihat Django 1.5 release notes untuk lebih rinci pada perubahan ini.
- Modul
django.utils.simplejsonakan dipindahkan. Pustaka standar menyediakanjsonyang harus digunakan sebagai gantinya. - Fungsi
django.utils.itercompat.productakan dipindahkan. Versi terpasang tetap Python harus digunakan sebagai gantinya. - Pembenaran-otomatis dari pengaturan INSTALLED_APPS dan TEMPLATE_DIRS ketika mereka ditentukan sebagai deretan karakter kosong daripada sebuah tuple akan dipindahkan dan menerbitkan pengecualian.
- Argumen
mimetypepada cara__init__dariHttpResponse,SimpleTemplateResponse, danTemplateResponse, akan dipindahkan.content_typeharus digunakan sebagai gantinya. Ini juga berlaku pada jalan pintasrender_to_response()dan tampilan peta situs,index()dansitemap(). - Ketika
HttpResponsedipakai dengan sebuah pengulang, atau ketikacontentdisetel ke sebuah pengulang, yang pengulang akan segera dikonsumsi. - Pengaturan
AUTH_PROFILE_MODULE, dan caraget_profile()pada model User akan dipindahkan. - Perintah pengelolaan
cleanupakan dipindahkan. Dia diganti olehclearsessions. - Tulisan
daily_cleanup.pyakan dipindahkan. - Argumen katakunci
depthakan dipindahkan dariselect_related(). - Fungsi
get_warnings_state()/restore_warnings_state()tidak terdokumentasikan dari caradjango.test.utilsdansave_warnings_state()/restore_warnings_state()django.test.*TestCase diusangkan. Gunakan pengelola kontekswarnings.catch_warningstersedia dimulai dengan Python 2.6 sebagai gantinya. - Cara
check_for_test_cookietidak terdokumentasi diAuthenticationFormakan dipindahkan mengikuti pengusangan dipercepat. Pengguna mensubkelaskan formulir ini harus memindahkan panggilan pada cara ini, dan malahan memastikan bahwa otentifikasi terkait tampilan mereka dilindungi CSRF, yang memastikan bahwa kue diadakan. - Versi dari
django.contrib.auth.views.password_reset_confirm()yang mendukung penyandian base36 ID pengguna (django.contrib.auth.views.password_reset_confirm_uidb36) akan dipindahkan. Jika situs anda telah menjalankan Django 1.6 untuk lebih dariPASSWORD_RESET_TIMEOUT_DAYS, perubahan ini tidak akan memiliki pengaruh. Jika tidak, kemudian tautan menyetel kembali sandi apapun dibangkitkan sebelum anda meningkatkan ke Django 1.7 tidak akan bekerja setelah ditingkatkan. - Mix-in
django.utils.encoding.StrAndUnicodeakan dipindahkan.
1.6¶
Lihat Django 1.4 release notes untuk lebih rinci pada perubahan ini.
django.contrib.databrowseakan dipindahkan.django.contrib.localflavorakan dipindahkan mengikuti pengusangan yang dipercepat.django.contrib.markupakan dipindahkan mengikuti pengusangan yang dipercepat.- Modul kesesuaian
django.utils.copycompatdandjango.utils.hashcompatsama dan juga fungsidjango.utils.itercompat.alldandjango.utils.itercompat.anyakan dipindahkan. Versi pasang tetap Python harus digunakan sebagai gantinya. - Penghias
csrf_response_exemptandcsrf_view_exemptakan dipindahkan. Sejak 1.4csrf_response_exempttelah menjadi tidak beroperasi (dia mengembalikan fungsi sama), dancsrf_view_exempttelah menjadi sinonim untukdjango.views.decorators.csrf.csrf_exempt, yang harus digunakan untuk menggantinya. - Backend
django.core.cache.backends.memcached.CacheClasstelah dipisah menjadi dua di Django 1.3 agar memperkenalkan dukungan untuk PyLibMC. RiwayatCacheClassakan dipindahkan mendukungdjango.core.cache.backends.memcached.MemcachedCache. - Obyek awalan UK dari
django.contrib.localflavor.ukhanya akan diakses melalui nama-nama awalan GB mereka (GB adalah kode benar ISO 3166 untuk Inggris). - Pengaturan
IGNORABLE_404_STARTSdanIGNORABLE_404_ENDStelah digantikan olehIGNORABLE_404_URLSdi terbitan 1.4. Mereka akan dipindahkan. - Wizard formulir telah direfaktorisasi untuk menggunakan tampilan berdasar kelas dengan backend dapat tertanam di 1.4. Penerapan sebelumnya akan dipindahkan.
- Cara warisan dari memanggil
cache_page()akan dipindahkan. - Shim kesesuaian-kebelakang untuk otomatis menambah penyaring slah-pencari kesalahan pada penangan pencatatan
'mail_admins'akan dipindahkan. PengaturanLOGGINGharus menyertakan penyaring ini secara ekplisit jika itu diminta. - Fungsi pemotongan pasang tetap
django.utils.text.truncate_words()dandjango.utils.text.truncate_html_words()akan dipindahkan mendukung kelasdjango.utils.text.Truncator. - Kelas
django.contrib.gis.geoip.GeoIPtelah dipindahkan kedjango.contrib.gis.geoipdi 1.4 -- jalan pintas didjango.contrib.gis.utilsakan dipindahkan. django.conf.urls.defaultsakan dipindahkan. Fungsi-fungsiinclude(),patterns(), andurl(), plushandler404danhandler500sekarang tersedia melaluidjango.conf.urls.- Fungsi
setup_environ()danexecute_manager()akan dipindahkan daridjango.core.management. Ini juga berarti bahwa gaya lama (pra-1.4) dari berkasmanage.pytidak lama akan bekerja lagi. - Pengaturan bendera
is_safedanneeds_autoescapesebagai atribut dari fungsi penyaring penyesuaian tidak lagi didukung. - Atribut
HttpRequest.raw_post_datatelah dinamai kembali keHttpRequest.bodydi 1.4. Kesesuaian kebelakang akan dipindahkan --HttpRequest.raw_post_datatidak lagi bekerja. - Nilai untuk parameter
post_url_continuedalamModelAdmin.response_add()akan harus menjadi antaraNone(untuk mengalihkan ke halaman penyuntingan obyek baru dibuat) atau url pra dibentuk. Bentuk deretan karakter, seperti awal sebelumnya'../%s/', tidak akan diterima lagi.
1.5¶
Lihat Django 1.3 release notes untuk lebih rinci pada perubahan ini.
- Memulai Django tanpa
SECRET_KEYakan menghasilkan sebuah pengecualian daripadaDeprecationWarning. (Ini dipercepat dari jalur pengusangan biasa; lihat Django 1.4 release notes.) - Penanganan permintaan
mod_pythonakan dipindahkan. Penangananmod_wsgiharus digunakan. - Atribut
templatepada obyekdjango.test.client.Responsedikembalikan oleh test client akan dipindahkan. Atributtemplatesharus digunakan sebagai gantinya. django.test.simple.DjangoTestRunnerakan dipindahkan. Daripada menggunakan kelas asli-unittest. Fitur-fitur daridjango.test.simple.DjangoTestRunner(termasuk gagal-cepat dan pengujian penghentian Ctrl-C) dapat disediakan olehunittest.TextTestRunner.- Fungsi tidak didokumentasi
django.contrib.formtools.utils.security_hashakan dipindahkan, sebagai gantinya gunakandjango.contrib.formtools.utils.form_hmac - Modul tampilan umum berbasis-fungsi akan dipindahkan mendukung setara berbasis-kelas mereka, diuraikan here.
django.core.servers.basehttp.AdminMediaHandlerakan dipindahkan. Dalam tempatnya gunakandjango.contrib.staticfiles.handlers.StaticFilesHandler.- Pustaka etiket cetakan
adminmediadan etiket cetakan{% admin_media_prefix %}akan dipindahkan mendukung penanganan berkas-berkas tetap umum. (Ini lebih cepat daripada jalur pengusangan biasa; lihat Django 1.4 release notes.) - Etiket cetakan
urldanssiakan dirubah sehingga argumen eprtama pada setiap etiket adalah sebuah variabel cetakan, bukan sebuah deretan karakter sisipan. - Perintah pengelolaan
resetdansqlresetakan dipindahkan. - Backend otentifikasi akan butuh mendukung pengguna tidak aktif sedang diloloskan ke semua cara berurusan dengan perizinan. Atribut
supports_inactive_userakan tidak lagi dicentang dan dapat dipindahkan dari backend penyesuaian. transform()akan menimbulkanGEOSExceptionketika dipanggil pada geometri dengan tidak ada nilai SRID.django.http.CompatCookieakan dipindahkan mendukungdjango.http.SimpleCookie.- django.core.context_processors.PermWrapper` dan
django.core.context_processors.PermLookupDictakan dipindahkan mendukung terhubungdjango.contrib.auth.context_processors.PermWrapperdandjango.contrib.auth.context_processors.PermLookupDict, masing-masing. - Pengaturan
MEDIA_URLatauSTATIC_URLakan diwajibkan untuk mengakhiri dengan garis miring untuk memastikan ada cara selaras untuk menggabungkan jalur-jalur di cetakan. django.db.models.fields.URLField.verify_existsakan dipindahkan. Fitur telah diusangkan di 1.3.1 karena masalah keamanan dan penampilan dan akan mengikuti sedikit penyesuaian kerangka waktu pengusangan.- Terjemahan bertempat dibawah yang disebut jalur proyek akan diabaikan selama pengolahan membangun terjemahan dilakukan pada waktu lari. Pengaturan
LOCALE_PATHSdapat digunakan untuk tugas sama dengan menyertakan jalur sistem berkas ke pelipatlocalemengandung terjemahan bukan aplikasi tertensi di nilainya. - Aplikasi bantuah markah tidak lagi mendukung versi pustaka Python-Markdown lebih awal dari 2.1. Sebuah linimasa dipercepat telah digunakan seperti ini adalah hubungan keamanan pengusangan.
- Pengaturan
CACHE_BACKENDakan dipindahkan. Tembolok backend harus ditentukan di pengaturanCACHES.
1.4¶
Lihat Catatan terbitan Django 1.2 untuk lebih rinci di perubahan ini.
CsrfResponseMiddlewaredanCsrfMiddlewareakan dipindahkan. Gunakan etiket cetakan{% csrf_token %}didalam formulir untuk mengadakan perlindungan CSRF.CsrfViewMiddlewaretetap dan diadakan secara awal.- Impor lama untuk fungsi CSRF (
django.contrib.csrf.*), yang dipindahkan ke inti di 1.2, akan dipindahkan. - Modul
django.contrib.gis.db.backendakan dipindahkan mendukung backend khusus. SMTPConnectionakan dipindahkan mendukung API backend Email umum.- Fungsi pembangkitan SQL banyak ke banyak pada backend basisdata akan dipindahkan.
- Kemampuan menggunakan keluarga
DATABASE_*dari pengaturan tingkat-atas untuk menentukan hubungan basisdata akan dipindahkan. - Kemampuan menggunakan catatan stenografi untuk menentukan backend basisdata (yaitu,
sqlite3daripadadjango.db.backends.sqlite3) akan dipindahkan. - Cara
get_db_prep_save,get_db_prep_valuedanget_db_prep_lookupakan mempunyai dukungan banyak basisdata. - Model
Message(didjango.contrib.auth), pengelola terhubungnya di modelUser(user.message_set), dan cara-cara terkait (user.message_set.create()danuser.get_and_delete_messages()), akan dipindahkan. messages framework harus digunakan sebagai gantinya. Variabelmessagesterhubung dikembalikan oleh pengolah konteks asli akan juga dipindahkan. Catat bahwa ini berarti bahwa aplikasi admin akan bergantung pada pengolah konteks pesan. - Backend otentifikasi akan butuh mendukung parameter
objuntuk pemeriksaan perizinan. Atributsupports_object_permissionsakan tidak lagi dicentang dan dapat dipindahkan dari backend penyesuaian. - Backend otentifikasi akan butuh mendukung kelas
AnonymousUserdilewatkan ke semua cara berurusan dengan perizinan. Variabelsupports_anonymous_usertidak lagi dicentang dan dapat dipindahkan dari backend penyesuaian. - Kemampuan menentukan pemuat cetakan callable daripada kelas
Loaderakan dipindahkan, seperti yang akan fungsiload_template_sourceyang disertakan dengan pemuat cetakan pasang tetap untuk kesesuaian kebelakang. django.utils.translation.get_date_formats()dandjango.utils.translation.get_partial_date_formats(). Fungsi ini telah dipindahkan; gunakan locale-awaredjango.utils.formats.get_format()untuk mendapatkan bentuk yang sesuai.- Dalam
django.forms.fields, ketetapan:DEFAULT_DATE_INPUT_FORMATS,DEFAULT_TIME_INPUT_FORMATSdanDEFAULT_DATETIME_INPUT_FORMATSakan dipindahkan. Gunakandjango.utils.formats.get_format()untuk mendapatkan bentuk yang sesuai. - Kemampuan menggunakan percobaan berbasis-fungsi akan dipindahkan, bersama dengan penjalan percobaan
django.test.simple.run_tests(). - Tampilan
views.feed()dan kelasfeeds.Feeddidjango.contrib.syndicationakan dipindahkan. Tampilan berbasis-kelasviews.Feedharus digunakan sebagai gantinya. django.core.context_processors.auth. Terbitan ini akan memindahkan cara lama dalam mendukung cara baru didjango.contrib.auth.context_processors.auth.- Backend basisdata
postgresqlakan dipindahkan, gunakan backendpostgresql_psycopg2sebagai gantinya. - kode bahasa
noakan dipindahkan dan telah diganti oleh kode bahasanb. - Backend otentifikasi akan butuh menentukan atrobut boolean
supports_inactive_usersampai versi 1.5 ketika dia akan dianggap bahwa semua backend akan menangani pengguna tidak aktif. django.db.models.fields.XMLFieldakan dipindahkan. Ini telah diusangkan sebagai bagian dari terbitan 1.3. Jadwal pengusangan dipercepat telah digunakan karena bidang belum melakukan aturan apapun lebih dari itu dariTextFieldsederhana sejak perpindahan darioldforms. Semua penggunaan dariXMLFielddapat diganti denganTextField.- Parameter
mixintidak terdokumentasi pada caraopen()daridjango.core.files.storage.Storage(dan subkelas) akan dipindahkan.
1.3¶
Lihat Catatan terbitan Django 1.1 untuk rincian lebih pada perubahan ini.
AdminSite.root(). Cara ini dari mengaitkan URL admin akan dipindahkan mendukung termasukadmin.site.urls.- Backend otentifikasi butuh menentukan atribut boolean
supports_object_permissionsdansupports_anonymous_usersampai versi 1.4, dimana menunjuk itu akan dianggap bahwa semua backend akan mendukung pilihan ini.