Django废弃时间表
See the Django 4.0 release notes for more details on these changes.
- The test setting will be removed.
- The undocumented
django.utils.baseconv
module will be removed. - The undocumented
django.utils.datetime_safe
module will be removed. - The default value of the
USE_TZ
setting will change fromFalse
toTrue
. - The default sitemap protocol for sitemaps built outside the context of a request will change from
'http'
to'https'
. - The
extra_tests
argument forDiscoverRunner.build_suite()
andDiscoverRunner.run_tests()
will be removed. - The
django.contrib.postgres.aggregates.ArrayAgg
,JSONBAgg
, andStringAgg
aggregates will returnNone
when there are no rows instead of[]
,[]
, and''
respectively. - The
USE_L10N
setting will be removed. - The
USE_DEPRECATED_PYTZ
transitional setting will be removed. - Support for
pytz
timezones will be removed. - The
is_dst
argument will be removed from:QuerySet.datetimes()
django.utils.timezone.make_aware()
django.db.models.functions.Trunc()
django.db.models.functions.TruncSecond()
django.db.models.functions.TruncMinute()
django.db.models.functions.TruncHour()
django.db.models.functions.TruncDay()
django.db.models.functions.TruncWeek()
django.db.models.functions.TruncMonth()
django.db.models.functions.TruncQuarter()
django.db.models.functions.TruncYear()
- The
django.contrib.gis.admin.GeoModelAdmin
andOSMGeoAdmin
classes will be removed. - The undocumented
BaseForm._html_output()
method will be removed. - The ability to return a
str
, rather than aSafeString
, when rendering anErrorDict
andErrorList
will be removed.
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_checks
won’t support boolean values.- The
whitelist
argument anddomain_whitelist
attribute ofdjango.core.validators.EmailValidator
will be removed. - The
default_app_config
module variable will be removed. TransactionTestCase.assertQuerysetEqual()
will no longer automatically callrepr()
on a queryset when compared to string values.django.core.cache.backends.memcached.MemcachedCache
will be removed.- Support for the pre-Django 3.2 format of messages used by
django.contrib.messages.storage.cookie.CookieStorage
will be removed.
4.0
See the Django 3.0 release notes for more details on these changes.
django.utils.http.urlquote()
,urlquote_plus()
,urlunquote()
, andurlunquote_plus()
will be removed.django.utils.encoding.force_text()
andsmart_text()
will be removed.django.utils.translation.ugettext()
,ugettext_lazy()
,ugettext_noop()
,ungettext()
, andungettext_lazy()
will be removed.django.views.i18n.set_language()
will no longer set the user language inrequest.session
(keydjango.utils.translation.LANGUAGE_SESSION_KEY
).alias=None
will be required in the signature ofdjango.db.models.Expression.get_group_by_cols()
subclasses.django.utils.text.unescape_entities()
will be removed.django.utils.http.is_safe_url()
will be removed.
See the for more details on these changes.
- The
PASSWORD_RESET_TIMEOUT_DAYS
setting will be removed. - The undocumented usage of the isnull lookup with non-boolean values as the right-hand side will no longer be allowed.
- The
django.db.models.query_utils.InvalidQuery
exception class will be removed. - The
django-admin.py
entry 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.CookieStorage
will 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.Signer
signatures (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_response
argument fordjango.utils.deprecation.MiddlewareMixin.__init__()
will be required and won’t acceptNone
. - The
providing_args
argument fordjango.dispatch.Signal
will be removed. - The
length
argument fordjango.utils.crypto.get_random_string()
will be required. - The
list
message forModelMultipleChoiceField
will be removed. - Support for passing raw column aliases to
QuerySet.order_by()
will be removed. - The model
NullBooleanField
will be removed. A stub field will remain for compatibility with historical migrations. django.conf.urls.url()
will be removed.- The model
django.contrib.postgres.fields.JSONField
will 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.KeyTextTransform
will be removed.- The
{% ifequal %}
and{% ifnotequal %}
template tags will be removed. - The
DEFAULT_HASHING_ALGORITHM
transitional setting will be removed.
3.1
See the Django 2.2 release notes for more details on these changes.
django.utils.timezone.FixedOffset
will be removed.django.core.paginator.QuerySetPaginator
will be removed.- A model’s
Meta.ordering
will no longer affectGROUP BY
queries. django.contrib.postgres.fields.FloatRangeField
anddjango.contrib.postgres.forms.FloatRangeField
will be removed.- The
FILE_CHARSET
setting will be removed. django.contrib.staticfiles.storage.CachedStaticFilesStorage
will be removed.RemoteUserBackend.configure_user()
will requirerequest
as the first positional argument.- Support for
SimpleTestCase.allow_database_queries
andTransactionTestCase.multi_db
will be removed.
3.0
- The
django.db.backends.postgresql_psycopg2
module will be removed. django.shortcuts.render_to_response()
will be removed.- The
DEFAULT_CONTENT_TYPE
setting will be removed. HttpRequest.xreadlines()
will be removed.- Support for the
context
argument ofField.from_db_value()
andExpression.convert_value()
will be removed. - The
field_name
keyword argument ofQuerySet.earliest()
andlatest()
will be removed.
See the Django 2.1 release notes for more details on these changes.
django.contrib.gis.db.models.functions.ForceRHR
will be removed.django.utils.http.cookie_date()
will be removed.- The
staticfiles
andadmin_static
template tag libraries will be removed. django.contrib.staticfiles.templatetags.static()
will be removed.- The shim to allow
InlineModelAdmin.has_add_permission()
to be defined without anobj
argument will be removed.
See the for more details on these changes.
contrib.auth.views.login()
,logout()
,password_change()
,password_change_done()
,password_reset()
,password_reset_done()
,password_reset_confirm()
, andpassword_reset_complete()
will be removed.- The
extra_context
parameter ofcontrib.auth.views.logout_then_login()
will be removed. django.test.runner.setup_databases()
will be removed.django.utils.translation.string_concat()
will be removed.django.core.cache.backends.memcached.PyLibMCCache
will no longer support passingpylibmc
behavior settings as top-level attributes ofOPTIONS
.- The
host
parameter ofdjango.utils.http.is_safe_url()
will be removed. - Silencing of exceptions raised while rendering the
{% include %}
template tag will be removed. DatabaseIntrospection.get_indexes()
will be removed.- The
authenticate()
method of authentication backends will requirerequest
as the first positional argument. - The
django.db.models.permalink()
decorator will be removed. - The
USE_ETAGS
setting will be removed.CommonMiddleware
anddjango.utils.cache.patch_response_headers()
will no longer set ETags. - The
Model._meta.has_auto_field
attribute will be removed. url()
‘s support for inline flags in regular expression groups ((?i)
,(?L)
,(?m)
,(?s)
, and(?u)
) will be removed.- Support for
Widget.render()
methods without therenderer
argument will be removed.
2.0
See the for more details on these changes.
- The
weak
argument todjango.dispatch.signals.Signal.disconnect()
will be removed. django.db.backends.base.BaseDatabaseOperations.check_aggregate_support()
will be removed.- The
django.forms.extras
package will be removed. - The
assignment_tag
helper will be removed. - The
host
argument toassertsRedirects
will be removed. The compatibility layer which allows absolute URLs to be considered equal to relative ones when the path is identical will also be removed. Field.rel
will be removed.Field.remote_field.to
attribute will be removed.- The
on_delete
argument forForeignKey
andOneToOneField
will be required. django.db.models.fields.add_lazy_relation()
will be removed.- When time zone support is enabled, database backends that don’t support time zones won’t convert aware datetimes to naive values in UTC anymore when such values are passed as parameters to SQL queries executed outside of the ORM, e.g. with
cursor.execute()
. - The
django.contrib.auth.tests.utils.skipIfCustomUser()
decorator will be removed. - The
GeoManager
andGeoQuerySet
classes will be removed. - The
django.contrib.gis.geoip
module will be removed. - The
supports_recursion
check for template loaders will be removed from: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()
- The
load_template()
andload_template_sources()
template loader methods will be removed. - The
template_dirs
argument for template loaders will be removed: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()
- The
django.template.loaders.base.Loader.__call__()
method will be removed. - Support for custom error views with a single positional parameter will be dropped.
- The
mime_type
attribute ofdjango.utils.feedgenerator.Atom1Feed
anddjango.utils.feedgenerator.RssFeed
will be removed in favor ofcontent_type
. - The
app_name
argument todjango.conf.urls.include()
will be removed. - Support for passing a 3-tuple as the first argument to
include()
will be removed. - Support for setting a URL instance namespace without an application namespace will be removed.
Field._get_val_from_obj()
will be removed in favor ofField.value_from_object()
.django.template.loaders.eggs.Loader
will be removed.- The
current_app
parameter to thecontrib.auth
views will be removed. - The
callable_obj
keyword argument toSimpleTestCase.assertRaisesMessage()
will be removed. - Support for the
allow_tags
attribute onModelAdmin
methods will be removed. - The
enclosure
keyword argument toSyndicationFeed.add_item()
will be removed. - The
django.template.loader.LoaderOrigin
anddjango.template.base.StringOrigin
aliases fordjango.template.base.Origin
will be removed.
See the Django 1.10 release notes for more details on these changes.
- The
makemigrations --exit
option will be removed. - Support for direct assignment to a reverse foreign key or many-to-many relation will be removed.
- The
get_srid()
and methods ofdjango.contrib.gis.geos.GEOSGeometry
will be removed. - The
get_x()
,set_x()
,get_y()
,set_y()
,get_z()
, andset_z()
methods ofdjango.contrib.gis.geos.Point
will be removed. - The
get_coords()
andset_coords()
methods ofdjango.contrib.gis.geos.Point
will be removed. - The
cascaded_union
property ofdjango.contrib.gis.geos.MultiPolygon
will be removed. django.utils.functional.allow_lazy()
will be removed.- The
shell --plain
option will be removed. - The
django.core.urlresolvers
module will be removed. - The model
CommaSeparatedIntegerField
will be removed. A stub field will remain for compatibility with historical migrations. - Support for the template
Context.has_key()
method will be removed. - Support for the
django.core.files.storage.Storage.accessed_time()
,created_time()
, andmodified_time()
methods will be removed. - Support for query lookups using the model name when
Meta.default_related_name
is set will be removed. - The
__search
query lookup and theDatabaseOperations.fulltext_search_sql()
method will be removed. - The shim for supporting custom related manager classes without a
_apply_rel_filters()
method will be removed. - Using
User.is_authenticated()
andUser.is_anonymous()
as methods will no longer be supported. - The private attribute
virtual_fields
ofModel._meta
will be removed. - The private keyword arguments
virtual_only
inField.contribute_to_class()
andvirtual
inModel._meta.add_field()
will be removed. - The
javascript_catalog()
andjson_catalog()
views will be removed. - The
django.contrib.gis.utils.precision_wkt()
function will be removed. - In multi-table inheritance, implicit promotion of a
OneToOneField
to aparent_link
will be removed. - Support for
Widget._format_value()
will be removed. FileField
methodsget_directory_name()
andget_filename()
will be removed.- The
mark_for_escaping()
function and the classes it uses:EscapeData
,EscapeBytes
,EscapeText
,EscapeString
, andEscapeUnicode
will be removed. - The
escape
filter will change to usedjango.utils.html.conditional_escape()
. Manager.use_for_related_fields
will be removed.- Model
Manager
inheritance will follow MRO inheritance rules and theMeta.manager_inheritance_from_future
to opt-in to this behavior will be removed. - Support for old-style middleware using
settings.MIDDLEWARE_CLASSES
will be removed.
1.10
See the Django 1.8 release notes for more details on these changes.
- Support for calling a
SQLCompiler
directly as an alias for calling itsquote_name_unless_alias
method will be removed. cycle
andfirstof
template tags will be removed from thefuture
template tag library (used during the 1.6/1.7 deprecation period).django.conf.urls.patterns()
will be removed.- Support for the
prefix
argument todjango.conf.urls.i18n.i18n_patterns()
will be removed. SimpleTestCase.urls
will be removed.- Using an incorrect count of unpacked values in the
for
template tag will raise an exception rather than fail silently. - The ability to reverse URLs using a dotted Python path will be removed.
- The ability to use a dotted Python path for the
LOGIN_URL
andLOGIN_REDIRECT_URL
settings will be removed. - Support for will be dropped for custom management commands (replaced by argparse).
- The class
django.core.management.NoArgsCommand
will be removed. Use instead, which takes no arguments by default. django.core.context_processors
module will be removed.django.db.models.sql.aggregates
module will be removed.django.contrib.gis.db.models.sql.aggregates
module will be removed.- The following methods and properties of
django.db.sql.query.Query
will be removed:- Properties:
aggregates
andaggregate_select
- Methods:
add_aggregate
,set_aggregate_mask
, andappend_aggregate_mask
.
- Properties:
django.template.resolve_variable
will be removed.- The following private APIs will be removed from 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()
- The
error_message
argument ofdjango.forms.RegexField
will be removed. - The
unordered_list
filter will no longer support old style lists. - Support for string
view
arguments tourl()
will be removed. - The backward compatible shim to rename
django.forms.Form._has_changed()
tohas_changed()
will be removed. - The
removetags
template filter will be removed. - The
remove_tags()
andstrip_entities()
functions indjango.utils.html
will be removed. - The
is_admin_site
argument todjango.contrib.auth.views.password_reset()
will be removed. django.db.models.field.subclassing.SubfieldBase
will be removed.django.utils.checksums
will be removed; its functionality is included indjango-localflavor
1.1+.- The
original_content_type_id
attribute ondjango.contrib.admin.helpers.InlineAdminForm
will be removed. - The backwards compatibility shim to allow
FormMixin.get_form()
to be defined with no default value for itsform_class
argument will be removed. - The following settings will be removed:
ALLOWED_INCLUDE_ROOTS
TEMPLATE_CONTEXT_PROCESSORS
TEMPLATE_DEBUG
TEMPLATE_DIRS
TEMPLATE_LOADERS
TEMPLATE_STRING_IF_INVALID
- The backwards compatibility alias
django.template.loader.BaseLoader
will be removed. - Django template objects returned by and select_template() won’t accept a in their render() method anymore.
- will enforce the use of dict and backend-dependent template objects instead of and Template respectively.
- The
current_app
parameter for the following function and classes will be removed:django.shortcuts.render()
django.template.Context()
django.template.RequestContext()
django.template.response.TemplateResponse()
- The
dictionary
andcontext_instance
parameters for the following functions will be removed:django.shortcuts.render()
django.shortcuts.render_to_response()
django.template.loader.render_to_string()
- The
dirs
parameter for the following functions will be removed:django.template.loader.get_template()
django.template.loader.select_template()
django.shortcuts.render()
django.shortcuts.render_to_response()
- Session verification will be enabled regardless of whether or not
'django.contrib.auth.middleware.SessionAuthenticationMiddleware'
is inMIDDLEWARE_CLASSES
. - Private attribute
django.db.models.Field.related
will be removed. - The
--list
option of themigrate
management command will be removed. - The
ssi
template tag will be removed. - Support for the
=
comparison operator in theif
template tag will be removed. - The backwards compatibility shims to allow
Storage.get_available_name()
andStorage.save()
to be defined without amax_length
argument will be removed. - Support for the legacy
%(<foo>)s
syntax inModelFormMixin.success_url
will be removed. GeoQuerySet
aggregate methodscollect()
,extent()
,extent3d()
,make_line()
, andunionagg()
will be removed.- Ability to specify
ContentType.name
when creating a content type instance will be removed. - Support for the old signature of
allow_migrate
will be removed. It changed fromallow_migrate(self, db, model)
toallow_migrate(self, db, app_label, model_name=None, **hints)
. - Support for the syntax of
{% cycle %}
that uses comma-separated arguments will be removed. - The warning that issues when given an invalid separator will become an exception.
1.9
django.utils.dictconfig
will be removed.django.utils.importlib
will be removed.django.utils.tzinfo
will be removed.django.utils.unittest
will be removed.- The
syncdb
command will be removed. django.db.models.signals.pre_syncdb
anddjango.db.models.signals.post_syncdb
will be removed.allow_syncdb
on database routers will no longer automatically becomeallow_migrate
.- Automatic syncing of apps without migrations will be removed. Migrations will become compulsory for all apps unless you pass the
--run-syncdb
option tomigrate
. - The SQL management commands for apps without migrations,
sql
,sqlall
,sqlclear
,sqldropindexes
, andsqlindexes
, will be removed. - Support for automatic loading of
initial_data
fixtures and initial SQL data will be removed. - All models will need to be defined inside an installed application or declare an explicit . Furthermore, it won’t be possible to import them before their application is loaded. In particular, it won’t be possible to import models inside the root package of their application.
- The model and form
IPAddressField
will be removed. A stub field will remain for compatibility with historical migrations. AppCommand.handle_app()
will no longer be supported.RequestSite
andget_current_site()
will no longer be importable fromdjango.contrib.sites.models
.- FastCGI support via the
runfcgi
management command will be removed. Please deploy your project using WSGI. django.utils.datastructures.SortedDict
will be removed. Use collections.OrderedDict from the Python standard library instead.ModelAdmin.declared_fieldsets
will be removed.- Instances of
util.py
in the Django codebase have been renamed toutils.py
in an effort to unify all util and utils references. The modules that provided backwards compatibility will be removed:django.contrib.gis.db.backends.util
django.db.backends.util
django.forms.util
ModelAdmin.get_formsets
will be removed.- The backward compatibility shim introduced to rename the
BaseMemcachedCache._get_memcache_timeout()
method toget_backend_timeout()
will be removed. - The
--natural
and-n
options for will be removed. - The
use_natural_keys
argument forserializers.serialize()
will be removed. - Private API
django.forms.forms.get_declared_fields()
will be removed. - The ability to use a
SplitDateTimeWidget
withDateTimeField
will be removed. - The
WSGIRequest.REQUEST
property will be removed. - The class
django.utils.datastructures.MergeDict
will be removed. - The
zh-cn
andzh-tw
language codes will be removed and have been replaced by thezh-hans
andzh-hant
language code respectively. - The internal
django.utils.functional.memoize
will be removed. django.core.cache.get_cache
will be removed. Add suitable entries to CACHES and use instead.django.db.models.loading
will be removed.- Passing callable arguments to querysets will no longer be possible.
BaseCommand.requires_model_validation
will be removed in favor ofrequires_system_checks
. Admin validators will be replaced by admin checks.- The
ModelAdmin.validator_class
anddefault_validator_class
attributes will be removed. ModelAdmin.validate()
will be removed.django.db.backends.DatabaseValidation.validate_field
will be removed in favor of thecheck_field
method.- The
validate
management command will be removed. django.utils.module_loading.import_by_path
will be removed in favor ofdjango.utils.module_loading.import_string
.- and
url
template tags will be removed from thefuture
template tag library (used during the 1.3/1.4 deprecation period). django.utils.text.javascript_quote
will be removed.- Database test settings as independent entries in the database settings, prefixed by
TEST_
, will no longer be supported. - The
cache_choices
option to ModelChoiceField and will be removed. - The default value of the RedirectView.permanent attribute will change from
True
toFalse
. django.contrib.sitemaps.FlatPageSitemap
will be removed in favor ofdjango.contrib.flatpages.sitemaps.FlatPageSitemap
.- Private API
django.test.utils.TestTemplateLoader
will be removed. - The
django.contrib.contenttypes.generic
module will be removed. - Private APIs
django.db.models.sql.where.WhereNode.make_atom()
anddjango.db.models.sql.where.Constraint
will be removed.
1.8
See the Django 1.6 release notes for more details on these changes.
django.contrib.comments
will be removed.- The following transaction management APIs will be removed:
TransactionMiddleware
,- the decorators and context managers
autocommit
,commit_on_success
, andcommit_manually
, defined indjango.db.transaction
, - the functions
commit_unless_managed
androllback_unless_managed
, also defined indjango.db.transaction
, - the
TRANSACTIONS_MANAGED
setting.
- The and firstof template tags will auto-escape their arguments. In 1.6 and 1.7, this behavior is provided by the version of these tags in the
future
template tag library. - The
SEND_BROKEN_LINK_EMAILS
setting will be removed. Add the middleware to yourMIDDLEWARE_CLASSES
setting instead. django.middleware.doc.XViewMiddleware
will be removed. Usedjango.contrib.admindocs.middleware.XViewMiddleware
instead.Model._meta.module_name
was renamed tomodel_name
.- Remove the backward compatible shims introduced to rename
get_query_set
and similar queryset methods. This affects the following classes:BaseModelAdmin
,ChangeList
,BaseCommentNode
,GenericForeignKey
,Manager
,SingleRelatedObjectDescriptor
andReverseSingleRelatedObjectDescriptor
. - Remove the backward compatible shims introduced to rename the attributes
ChangeList.root_query_set
andChangeList.query_set
. django.views.defaults.shortcut
will be removed, as part of the goal of removing alldjango.contrib
references from the core Django codebase. Instead usedjango.contrib.contenttypes.views.shortcut
.django.conf.urls.shortcut
will also be removed.- Support for the Python Imaging Library (PIL) module will be removed, as it no longer appears to be actively maintained & does not work on Python 3.
- The following private APIs will be removed:
django.db.backend
django.db.close_connection()
django.db.backends.creation.BaseDatabaseCreation.set_autocommit()
django.db.transaction.is_managed()
django.db.transaction.managed()
django.forms.widgets.RadioInput
will be removed in favor ofdjango.forms.widgets.RadioChoiceInput
.- The module
django.test.simple
and the classdjango.test.simple.DjangoTestSuiteRunner
will be removed. Instead usedjango.test.runner.DiscoverRunner
. - The module
django.test._doctest
will be removed. Instead use the doctest module from the Python standard library. - The
CACHE_MIDDLEWARE_ANONYMOUS_ONLY
setting will be removed. - Usage of the hard-coded Hold down “Control”, or “Command” on a Mac, to select more than one. string to override or append to user-provided
help_text
in forms for ManyToMany model fields will not be performed by Django anymore either at the model or forms layer. - The
Model._meta.get_(add|change|delete)_permission
methods will be removed. - The session key
django_language
will no longer be read for backwards compatibility. - Geographic Sitemaps will be removed (
django.contrib.gis.sitemaps.views.index
anddjango.contrib.gis.sitemaps.views.sitemap
). django.utils.html.fix_ampersands
, thefix_ampersands
template filter anddjango.utils.html.clean_html
will be removed following an accelerated deprecation.
See the Django 1.5 release notes for more details on these changes.
- The module
django.utils.simplejson
will be removed. The standard library provides which should be used instead. - The function
django.utils.itercompat.product
will be removed. The Python builtin version should be used instead. - Auto-correction of INSTALLED_APPS and TEMPLATE_DIRS settings when they are specified as a plain string instead of a tuple will be removed and raise an exception.
- The
mimetype
argument to the__init__
methods of HttpResponse, , and TemplateResponse, will be removed.content_type
should be used instead. This also applies to therender_to_response()
shortcut and the sitemap views, and sitemap(). - When is instantiated with an iterator, or when content is set to an iterator, that iterator will be immediately consumed.
- The
AUTH_PROFILE_MODULE
setting, and theget_profile()
method on the User model, will be removed. - The
cleanup
management command will be removed. It’s replaced byclearsessions
. - The
daily_cleanup.py
script will be removed. - The
depth
keyword argument will be removed from . - The undocumented
get_warnings_state()
/restore_warnings_state()
functions from django.test.utils and thesave_warnings_state()
/restore_warnings_state()
methods are deprecated. Use the warnings.catch_warnings context manager available starting with Python 2.6 instead. - The undocumented
check_for_test_cookie
method in will be removed following an accelerated deprecation. Users subclassing this form should remove calls to this method, and instead ensure that their auth related views are CSRF protected, which ensures that cookies are enabled. - The version of
django.contrib.auth.views.password_reset_confirm()
that supports base36 encoded user IDs (django.contrib.auth.views.password_reset_confirm_uidb36
) will be removed. If your site has been running Django 1.6 for more thanPASSWORD_RESET_TIMEOUT_DAYS
, this change will have no effect. If not, then any password reset links generated before you upgrade to Django 1.7 won’t work after the upgrade. - The
django.utils.encoding.StrAndUnicode
mix-in will be removed.
1.6
See the for more details on these changes.
django.contrib.databrowse
将来会被移除。django.contrib.localflavor
将会被加快移除。django.contrib.markup
将会被加快移除。- 兼容性模块
django.utils.copycompat
和django.utils.hashcompat
以及函数django.utils.itercompat.all
和django.utils.itercompat.any
将会被移除。应该使用Python内置版本。 csrf_response_exempt
和csrf_view_exempt
装饰器将被删除。 从1.4开始,csrf_response_exempt
已成为空操作(它返回相同的功能),而csrf_view_exempt
已成为django.views.decorators.csrf.csrf_exempt
的同义词以取代它。- 原有缓存后端
django.core.cache.backends.memcached.CacheClass
后端在Django 1.3中分为两个,以引入对PyLibMC的支持。历史悠久的CacheClass
将会被删除,取而代之的是缓存后端django.core.cache.backends.memcached.MemcachedCache
。 django.contrib.localflavor.uk
的英国前缀对象只能通过其GB前缀名称来访问(GB是英国的正确ISO 3166代码)。- The
IGNORABLE_404_STARTS
andIGNORABLE_404_ENDS
settings have been superseded by IGNORABLE_404_URLS in the 1.4 release. They will be removed. - The form wizard has been refactored to use class-based views with pluggable backends in 1.4. The previous implementation will be removed.
- 删除 缓存的旧版调用方式。
- 向后兼容的填充程序会自动向
'mail_admins'
日志记录处理程序中添加一个debug-false过滤器。 如果需要的话,日志配置 LOGGING 配置应该显式地包括这个过滤器。 - The builtin truncation functions
django.utils.text.truncate_words()
anddjango.utils.text.truncate_html_words()
will be removed in favor of thedjango.utils.text.Truncator
class. - The
django.contrib.gis.geoip.GeoIP
class was moved todjango.contrib.gis.geoip
in 1.4 — the shortcut indjango.contrib.gis.utils
will be removed. django.conf.urls.defaults
will be removed. The functionsinclude()
,patterns()
, andurl()
, plus and handler500 are now available throughdjango.conf.urls
.- The functions
setup_environ()
andexecute_manager()
will be removed from . This also means that the old (pre-1.4) style ofmanage.py
file will no longer work. - Setting the
is_safe
andneeds_autoescape
flags as attributes of template filter functions will no longer be supported. - The attribute
HttpRequest.raw_post_data
was renamed toHttpRequest.body
in 1.4. The backward compatibility will be removed —HttpRequest.raw_post_data
will no longer work. - The value for the
post_url_continue
parameter inModelAdmin.response_add()
will have to be eitherNone
(to redirect to the newly created object’s edit page) or a pre-formatted url. String formats, such as the previous default'../%s/'
, will not be accepted any more.
1.5
See the for more details on these changes.
- Starting Django without a SECRET_KEY will result in an exception rather than a
DeprecationWarning
. (This is accelerated from the usual deprecation path; see the .) - The
mod_python
request handler will be removed. Themod_wsgi
handler should be used instead. - The
template
attribute ondjango.test.client.Response
objects returned by the test client will be removed. The attribute should be used instead. - The
django.test.simple.DjangoTestRunner
will be removed. Instead use aunittest
-native class. The features of thedjango.test.simple.DjangoTestRunner
(including fail-fast and Ctrl-C test termination) can be provided by unittest.TextTestRunner. - The undocumented function
django.contrib.formtools.utils.security_hash
will be removed, instead usedjango.contrib.formtools.utils.form_hmac
- The function-based generic view modules will be removed in favor of their class-based equivalents, outlined .
- The
django.core.servers.basehttp.AdminMediaHandler
will be removed. In its place usedjango.contrib.staticfiles.handlers.StaticFilesHandler
. - The template tags library
adminmedia
and the template tag{% admin_media_prefix %}
will be removed in favor of the generic static files handling. (This is faster than the usual deprecation path; see the Django 1.4 release notes.) - The
url
andssi
template tags will be modified so that the first argument to each tag is a template variable, not an implied string. In 1.4, this behavior is provided by a version of the tag in thefuture
template tag library. - The
reset
andsqlreset
management commands will be removed. - Authentication backends will need to support an inactive user being passed to all methods dealing with permissions. The
supports_inactive_user
attribute will no longer be checked and can be removed from custom backends. - will raise a GEOSException when called on a geometry with no SRID value.
django.http.CompatCookie
will be removed in favor ofdjango.http.SimpleCookie
.django.core.context_processors.PermWrapper
anddjango.core.context_processors.PermLookupDict
will be removed in favor of the correspondingdjango.contrib.auth.context_processors.PermWrapper
anddjango.contrib.auth.context_processors.PermLookupDict
, respectively.- The or STATIC_URL settings will be required to end with a trailing slash to ensure there is a consistent way to combine paths in templates.
django.db.models.fields.URLField.verify_exists
will be removed. The feature was deprecated in 1.3.1 due to intractable security and performance issues and will follow a slightly accelerated deprecation timeframe.- Translations located under the so-called project path will be ignored during the translation building process performed at runtime. The setting can be used for the same task by including the filesystem path to a
locale
directory containing non-app-specific translations in its value. - The Markup contrib app will no longer support versions of Python-Markdown library earlier than 2.1. An accelerated timeline was used as this was a security related deprecation.
- The
CACHE_BACKEND
setting will be removed. The cache backend(s) should be specified in the CACHES setting.
1.4
See the Django 1.2 release notes for more details on these changes.
CsrfResponseMiddleware
andCsrfMiddleware
will be removed. Use the{% csrf_token %}
template tag inside forms to enable CSRF protection.CsrfViewMiddleware
remains and is enabled by default.- The old imports for CSRF functionality (
django.contrib.csrf.*
), which moved to core in 1.2, will be removed. - The
django.contrib.gis.db.backend
module will be removed in favor of the specific backends. SMTPConnection
will be removed in favor of a generic email backend API.- The many to many SQL generation functions on the database backends will be removed.
- The ability to use the
DATABASE_*
family of top-level settings to define database connections will be removed. - The ability to use shorthand notation to specify a database backend (i.e.,
sqlite3
instead ofdjango.db.backends.sqlite3
) will be removed. - The
get_db_prep_save
,get_db_prep_value
andget_db_prep_lookup
methods will have to support multiple databases. - The
Message
model (indjango.contrib.auth
), its related manager in theUser
model (user.message_set
), and the associated methods (user.message_set.create()
anduser.get_and_delete_messages()
), will be removed. The should be used instead. The relatedmessages
variable returned by the auth context processor will also be removed. Note that this means that the admin application will depend on the messages context processor. - Authentication backends will need to support the
obj
parameter for permission checking. Thesupports_object_permissions
attribute will no longer be checked and can be removed from custom backends. - Authentication backends will need to support the
AnonymousUser
class being passed to all methods dealing with permissions. Thesupports_anonymous_user
variable will no longer be checked and can be removed from custom backends. - The ability to specify a callable template loader rather than a
Loader
class will be removed, as will theload_template_source
functions that are included with the built in template loaders for backwards compatibility. django.utils.translation.get_date_formats()
anddjango.utils.translation.get_partial_date_formats()
. These functions will be removed; use the locale-awaredjango.utils.formats.get_format()
to get the appropriate formats.- In
django.forms.fields
, the constants:DEFAULT_DATE_INPUT_FORMATS
,DEFAULT_TIME_INPUT_FORMATS
andDEFAULT_DATETIME_INPUT_FORMATS
will be removed. Usedjango.utils.formats.get_format()
to get the appropriate formats. - The ability to use a function-based test runner will be removed, along with the
django.test.simple.run_tests()
test runner. - The
views.feed()
view andfeeds.Feed
class indjango.contrib.syndication
will be removed. The class-based viewviews.Feed
should be used instead. django.core.context_processors.auth
. This release will remove the old method in favor of the new method indjango.contrib.auth.context_processors.auth
.- The
postgresql
database backend will be removed, use thepostgresql_psycopg2
backend instead. - The
no
language code will be removed and has been replaced by thenb
language code. - Authentication backends will need to define the boolean attribute
supports_inactive_user
until version 1.5 when it will be assumed that all backends will handle inactive users. django.db.models.fields.XMLField
will be removed. This was deprecated as part of the 1.3 release. An accelerated deprecation schedule has been used because the field hasn’t performed any role beyond that of a simpleTextField
since the removal ofoldforms
. All uses ofXMLField
can be replaced withTextField
.- The undocumented
mixin
parameter to theopen()
method ofdjango.core.files.storage.Storage
(and subclasses) will be removed.
1.3
AdminSite.root()
. This method of hooking up the admin URLs will be removed in favor of includingadmin.site.urls
.