This document outlines when various pieces of Django will be removed or altered in a backward incompatible way, following their deprecation, as per the deprecation policy. More details about each item can often be found in the release notes of two versions prior.
See the Django 2.0 release notes for more details on these changes.
django.db.backends.postgresql_psycopg2 module will be removed.django.shortcuts.render_to_response() will be removed.DEFAULT_CONTENT_TYPE setting will be removed.HttpRequest.xreadlines() will be removed.context argument of Field.from_db_value() and
Expression.convert_value() will be removed.field_name keyword argument of QuerySet.earliest() and
latest() will be removed.See the Django 1.11 release notes for more details on these changes.
contrib.auth.views.login(), logout(), password_change(),
password_change_done(), password_reset(), password_reset_done(),
password_reset_confirm(), and password_reset_complete() will be
removed.extra_context parameter of contrib.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
passing pylibmc behavior settings as top-level attributes of OPTIONS.host parameter of django.utils.http.is_safe_url() will be
removed.{% include %} template
tag will be removed.DatabaseIntrospection.get_indexes() will be removed.authenticate() method of authentication backends will require
request as the first positional argument.django.db.models.permalink() decorator will be removed.USE_ETAGS setting will be removed. CommonMiddleware and
django.utils.cache.patch_response_headers() will no longer set ETags.Model._meta.has_auto_field attribute will be removed.iLmsu# in url() will be
removed.Widget.render() methods without the renderer argument
will be removed.See the Django 1.9 release notes for more details on these changes.
weak argument to django.dispatch.signals.Signal.disconnect() will
be removed.django.db.backends.base.BaseDatabaseOperations.check_aggregate_support()
will be removed.django.forms.extras package will be removed.assignment_tag helper will be removed.host argument to assertsRedirects 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.on_delete argument for ForeignKey and OneToOneField will be
required.django.db.models.fields.add_lazy_relation() will be removed.cursor.execute().django.contrib.auth.tests.utils.skipIfCustomUser() decorator will be
removed.GeoManager and GeoQuerySet classes will be removed.django.contrib.gis.geoip module will be removed.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()load_template() and load_template_sources() template loader
methods will be removed.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()django.template.loaders.filesystem.Loader.get_template_sources()django.template.loaders.base.Loader.__call__() method will be
removed.mime_type attribute of django.utils.feedgenerator.Atom1Feed and
django.utils.feedgenerator.RssFeed will be removed in favor of
content_type.app_name argument to django.conf.urls.include() will be
removed.include() will
be removed.Field._get_val_from_obj() will be removed in favor of
Field.value_from_object().django.template.loaders.eggs.Loader will be removed.current_app parameter to the contrib.auth views will be removed.callable_obj keyword argument to
SimpleTestCase.assertRaisesMessage() will be removed.allow_tags attribute on ModelAdmin methods will be
removed.enclosure keyword argument to SyndicationFeed.add_item() will be
removed.django.template.loader.LoaderOrigin and
django.template.base.StringOrigin aliases for
django.template.base.Origin will be removed.See the Django 1.10 release notes for more details on these changes.
makemigrations --exit option will be removed.get_srid() and set_srid() methods of
django.contrib.gis.geos.GEOSGeometry will be removed.get_x(), set_x(), get_y(), set_y(), get_z(), and
set_z() methods of django.contrib.gis.geos.Point will be removed.get_coords() and set_coords() methods of
django.contrib.gis.geos.Point will be removed.cascaded_union property of django.contrib.gis.geos.MultiPolygon
will be removed.django.utils.functional.allow_lazy() will be removed.shell --plain option will be removed.django.core.urlresolvers module will be removed.CommaSeparatedIntegerField will be removed. A stub field will
remain for compatibility with historical migrations.Context.has_key() method will be removed.django.core.files.storage.Storage.accessed_time(),
created_time(), and modified_time() methods will be removed.Meta.default_related_name is set will be removed.__search query lookup and the
DatabaseOperations.fulltext_search_sql() method will be removed._apply_rel_filters() method will be removed.User.is_authenticated() and User.is_anonymous() as methods
will no longer be supported.virtual_fields of Model._meta will be removed.virtual_only in
Field.contribute_to_class() and virtual in
Model._meta.add_field() will be removed.javascript_catalog() and json_catalog() views will be removed.django.contrib.gis.utils.precision_wkt() function will be removed.OneToOneField to a
parent_link will be removed.Widget._format_value() will be removed.FileField methods get_directory_name() and get_filename() will be
removed.mark_for_escaping() function and the classes it uses: EscapeData,
EscapeBytes, EscapeText, EscapeString, and EscapeUnicode will
be removed.escape filter will change to use
django.utils.html.conditional_escape().Manager.use_for_related_fields will be removed.Manager inheritance will follow MRO inheritance rules and the
Meta.manager_inheritance_from_future to opt-in to this behavior will be
removed.settings.MIDDLEWARE_CLASSES will
be removed.See the Django 1.8 release notes for more details on these changes.
SQLCompiler directly as an alias for calling its
quote_name_unless_alias method will be removed.cycle and firstof template tags will be removed from the future
template tag library (used during the 1.6/1.7 deprecation period).django.conf.urls.patterns() will be removed.prefix argument to
django.conf.urls.i18n.i18n_patterns() will be removed.SimpleTestCase.urls will be removed.for template tag
will raise an exception rather than fail silently.LOGIN_URL and
LOGIN_REDIRECT_URL settings will be removed.optparse will be dropped for custom management commands
(replaced by argparse).django.core.management.NoArgsCommand will be removed. Use
BaseCommand 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.django.db.sql.query.Query will
be removed:aggregates and aggregate_selectadd_aggregate, set_aggregate_mask, and
append_aggregate_mask.django.template.resolve_variable will be removed.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()error_message argument of django.forms.RegexField will be removed.unordered_list filter will no longer support old style lists.view arguments to url() will be removed.django.forms.Form._has_changed()
to has_changed() will be removed.removetags template filter will be removed.remove_tags() and strip_entities() functions in
django.utils.html will be removed.is_admin_site argument to
django.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
in django-localflavor 1.1+.original_content_type_id attribute on
django.contrib.admin.helpers.InlineAdminForm will be removed.FormMixin.get_form() to be
defined with no default value for its form_class argument will be removed.ALLOWED_INCLUDE_ROOTSTEMPLATE_CONTEXT_PROCESSORSTEMPLATE_DEBUGTEMPLATE_DIRSTEMPLATE_LOADERSTEMPLATE_STRING_IF_INVALIDdjango.template.loader.BaseLoader will
be removed.get_template() and
select_template() won't accept a
Context in their
render() method anymore.dict and backend-dependent template objects instead of
Context and Template
respectively.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()dictionary and context_instance parameters for the following
functions will be removed:django.shortcuts.render()django.shortcuts.render_to_response()django.template.loader.render_to_string()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()'django.contrib.auth.middleware.SessionAuthenticationMiddleware' is in
MIDDLEWARE_CLASSES.django.db.models.Field.related will be removed.--list option of the migrate management command will be removed.ssi template tag will be removed.= comparison operator in the if template tag will be
removed.Storage.get_available_name()
and Storage.save() to be defined without a max_length argument will
be removed.%(<foo>)s syntax in ModelFormMixin.success_url
will be removed.GeoQuerySet aggregate methods collect(), extent(), extent3d(),
make_line(), and unionagg() will be removed.ContentType.name when creating a content type instance
will be removed.allow_migrate will be removed. It changed
from allow_migrate(self, db, model) to
allow_migrate(self, db, app_label, model_name=None, **hints).{% cycle %} that uses comma-separated arguments
will be removed.Signer issues when given an
invalid separator will become an exception.See the Django 1.7 release notes for more details on these changes.
django.utils.dictconfig will be removed.django.utils.importlib will be removed.django.utils.tzinfo will be removed.django.utils.unittest will be removed.syncdb command will be removed.django.db.models.signals.pre_syncdb and
django.db.models.signals.post_syncdb will be removed.allow_syncdb on database routers will no longer automatically become
allow_migrate.--run-syncdb option to
migrate.sql, sqlall,
sqlclear, sqldropindexes, and sqlindexes, will be removed.initial_data fixtures and initial SQL
data will be removed.app_label.
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.IPAddressField will be removed. A stub field will
remain for compatibility with historical migrations.AppCommand.handle_app() will no longer be supported.RequestSite and get_current_site() will no longer be importable from
django.contrib.sites.models.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.util.py in the Django codebase have been renamed to
utils.py in an effort to unify all util and utils references.
The modules that provided backwards compatibility will be removed:django.contrib.admin.utildjango.contrib.gis.db.backends.utildjango.db.backends.utildjango.forms.utilModelAdmin.get_formsets will be removed.BaseMemcachedCache._get_memcache_timeout() method to
get_backend_timeout() will be removed.--natural and -n options for dumpdata will be removed.use_natural_keys argument for serializers.serialize() will be
removed.django.forms.forms.get_declared_fields() will be removed.SplitDateTimeWidget with DateTimeField will be
removed.WSGIRequest.REQUEST property will be removed.django.utils.datastructures.MergeDict will be removed.zh-cn and zh-tw language codes will be removed and have been
replaced by the zh-hans and zh-hant language code respectively.django.utils.functional.memoize will be removed.django.core.cache.get_cache will be removed. Add suitable entries
to CACHES and use django.core.cache.caches instead.django.db.models.loading will be removed.BaseCommand.requires_model_validation will be removed in favor of
requires_system_checks. Admin validators will be replaced by admin
checks.ModelAdmin.validator_class and default_validator_class attributes
will be removed.ModelAdmin.validate() will be removed.django.db.backends.DatabaseValidation.validate_field will be removed in
favor of the check_field method.validate management command will be removed.django.utils.module_loading.import_by_path will be removed in favor of
django.utils.module_loading.import_string.ssi and url template tags will be removed from the future template
tag library (used during the 1.3/1.4 deprecation period).django.utils.text.javascript_quote will be removed.TEST_, will no longer be supported.ModelChoiceField and
ModelMultipleChoiceField will be removed.RedirectView.permanent
attribute will change from True to False.django.contrib.sitemaps.FlatPageSitemap will be removed in favor of
django.contrib.flatpages.sitemaps.FlatPageSitemap.django.test.utils.TestTemplateLoader will be removed.django.contrib.contenttypes.generic module will be removed.django.db.models.sql.where.WhereNode.make_atom() and
django.db.models.sql.where.Constraint will be removed.See the Django 1.6 release notes for more details on these changes.
django.contrib.comments will be removed.TransactionMiddleware,autocommit, commit_on_success,
and commit_manually, defined in django.db.transaction,commit_unless_managed and rollback_unless_managed,
also defined in django.db.transaction,TRANSACTIONS_MANAGED setting.cycle 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.SEND_BROKEN_LINK_EMAILS setting will be removed. Add the
django.middleware.common.BrokenLinkEmailsMiddleware middleware to
your MIDDLEWARE_CLASSES setting instead.django.middleware.doc.XViewMiddleware will be removed. Use
django.contrib.admindocs.middleware.XViewMiddleware instead.Model._meta.module_name was renamed to model_name.get_query_set
and similar queryset methods. This affects the following classes:
BaseModelAdmin, ChangeList, BaseCommentNode,
GenericForeignKey, Manager, SingleRelatedObjectDescriptor and
ReverseSingleRelatedObjectDescriptor.ChangeList.root_query_set and ChangeList.query_set.django.views.defaults.shortcut will be removed, as part of the
goal of removing all django.contrib references from the core
Django codebase. Instead use
django.contrib.contenttypes.views.shortcut. django.conf.urls.shortcut
will also be removed.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.RadioInput will be removed in favor of
django.forms.widgets.RadioChoiceInput.django.test.simple and the class
django.test.simple.DjangoTestSuiteRunner will be removed. Instead use
django.test.runner.DiscoverRunner.django.test._doctest will be removed. Instead use the doctest
module from the Python standard library.CACHE_MIDDLEWARE_ANONYMOUS_ONLY setting will be removed.help_text in
forms for ManyToMany model fields will not be performed by Django anymore
either at the model or forms layer.Model._meta.get_(add|change|delete)_permission methods will
be removed.django_language will no longer be read for backwards
compatibility.django.contrib.gis.sitemaps.views.index and
django.contrib.gis.sitemaps.views.sitemap).django.utils.html.fix_ampersands, the fix_ampersands template filter and
django.utils.html.clean_html will be removed following an accelerated deprecation.See the Django 1.5 release notes for more details on these changes.
django.utils.simplejson will be removed. The standard library
provides json which should be used instead.django.utils.itercompat.product will be removed. The Python
builtin version should be used instead.mimetype argument to the __init__ methods of
HttpResponse,
SimpleTemplateResponse, and
TemplateResponse, will be removed.
content_type should be used instead. This also applies to the
render_to_response() shortcut and the sitemap views,
index() and
sitemap().HttpResponse is instantiated with an iterator,
or when content is set to an iterator,
that iterator will be immediately consumed.AUTH_PROFILE_MODULE setting, and the get_profile() method on
the User model, will be removed.cleanup management command will be removed. It's replaced by
clearsessions.daily_cleanup.py script will be removed.depth keyword argument will be removed from
select_related().get_warnings_state()/restore_warnings_state()
functions from django.test.utils and the save_warnings_state()/
restore_warnings_state()
django.test.*TestCase methods are
deprecated. Use the warnings.catch_warnings context manager
available starting with Python 2.6 instead.check_for_test_cookie method in
AuthenticationForm 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.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 than
PASSWORD_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.django.utils.encoding.StrAndUnicode mix-in will be removed.
Define a __str__ method and apply the
python_2_unicode_compatible() decorator instead.See the Django 1.4 release notes for more details on these changes.
django.contrib.databrowse will be removed.django.contrib.localflavor will be removed following an accelerated
deprecation.django.contrib.markup will be removed following an accelerated
deprecation.django.utils.copycompat and
django.utils.hashcompat as well as the functions
django.utils.itercompat.all and django.utils.itercompat.any will
be removed. The Python builtin versions should be used instead.csrf_response_exempt and csrf_view_exempt decorators will
be removed. Since 1.4 csrf_response_exempt has been a no-op (it
returns the same function), and csrf_view_exempt has been a
synonym for django.views.decorators.csrf.csrf_exempt, which should
be used to replace it.django.core.cache.backends.memcached.CacheClass backend
was split into two in Django 1.3 in order to introduce support for
PyLibMC. The historical CacheClass will be removed in favor of
django.core.cache.backends.memcached.MemcachedCache.django.contrib.localflavor.uk will only
be accessible through their GB-prefixed names (GB is the correct
ISO 3166 code for United Kingdom).IGNORABLE_404_STARTS and IGNORABLE_404_ENDS settings have been
superseded by IGNORABLE_404_URLS in the 1.4 release. They will be
removed.cache_page() will be removed.'mail_admins' logging handler will be removed. The
LOGGING setting should include this filter explicitly if
it is desired.django.utils.text.truncate_words()
and django.utils.text.truncate_html_words() will be removed in
favor of the django.utils.text.Truncator class.django.contrib.gis.geoip.GeoIP class was moved to
django.contrib.gis.geoip in 1.4 -- the shortcut in
django.contrib.gis.utils will be removed.django.conf.urls.defaults will be removed. The functions
include(), patterns(), and url(), plus
handler404 and handler500
are now available through django.conf.urls.setup_environ() and execute_manager() will be removed
from django.core.management. This also means that the old (pre-1.4)
style of manage.py file will no longer work.is_safe and needs_autoescape flags as attributes of
template filter functions will no longer be supported.HttpRequest.raw_post_data was renamed to HttpRequest.body
in 1.4. The backward compatibility will be removed --
HttpRequest.raw_post_data will no longer work.post_url_continue parameter in
ModelAdmin.response_add() will have to be either None (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.See the Django 1.3 release notes for more details on these changes.
SECRET_KEY will result in an exception
rather than a DeprecationWarning. (This is accelerated from the usual
deprecation path; see the Django 1.4 release notes.)mod_python request handler will be removed. The mod_wsgi
handler should be used instead.template attribute on django.test.client.Response
objects returned by the test client will be removed.
The templates attribute should be
used instead.django.test.simple.DjangoTestRunner will be removed.
Instead use a unittest-native class. The features of the
django.test.simple.DjangoTestRunner (including fail-fast and
Ctrl-C test termination) can currently be provided by the unittest-native
TextTestRunner.django.contrib.formtools.utils.security_hash will be removed,
instead use django.contrib.formtools.utils.form_hmacdjango.core.servers.basehttp.AdminMediaHandler will be
removed. In its place use
django.contrib.staticfiles.handlers.StaticFilesHandler.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.)url and ssi 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 the future template
tag library.reset and sqlreset management commands will be removed.supports_inactive_user attribute will no longer be checked
and can be removed from custom backends.transform() will raise
a GEOSException when called
on a geometry with no SRID value.django.http.CompatCookie will be removed in favor of
django.http.SimpleCookie.django.core.context_processors.PermWrapper and
django.core.context_processors.PermLookupDict will be removed in
favor of the corresponding
django.contrib.auth.context_processors.PermWrapper and
django.contrib.auth.context_processors.PermLookupDict, respectively.MEDIA_URL 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.LOCALE_PATHS 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.CACHE_BACKEND setting will be removed. The cache backend(s) should be
specified in the CACHES setting.See the Django 1.2 release notes for more details on these changes.
CsrfResponseMiddleware and CsrfMiddleware will be removed. Use
the {% csrf_token %} template tag inside forms to enable CSRF
protection. CsrfViewMiddleware remains and is enabled by default.django.contrib.csrf.*),
which moved to core in 1.2, will be removed.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.DATABASE_* family of top-level settings to
define database connections will be removed.sqlite3 instead of django.db.backends.sqlite3) will be
removed.get_db_prep_save, get_db_prep_value and
get_db_prep_lookup methods will have to support multiple databases.Message model (in django.contrib.auth), its related
manager in the User model (user.message_set), and the
associated methods (user.message_set.create() and
user.get_and_delete_messages()), will be removed. The
messages framework should be used
instead. The related messages 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.obj parameter for
permission checking. The supports_object_permissions attribute
will no longer be checked and can be removed from custom backends.AnonymousUser class
being passed to all methods dealing with permissions. The
supports_anonymous_user variable will no longer be checked and can be
removed from custom backends.Loader class will be removed, as will the load_template_source
functions that are included with the built in template loaders for
backwards compatibility.django.utils.translation.get_date_formats() and
django.utils.translation.get_partial_date_formats(). These functions
will be removed; use the locale-aware
django.utils.formats.get_format() to get the appropriate formats.django.forms.fields, the constants: DEFAULT_DATE_INPUT_FORMATS,
DEFAULT_TIME_INPUT_FORMATS and
DEFAULT_DATETIME_INPUT_FORMATS will be removed. Use
django.utils.formats.get_format() to get the appropriate
formats.django.test.simple.run_tests() test runner.views.feed() view and feeds.Feed class in
django.contrib.syndication will be removed. The class-based view
views.Feed should be used instead.django.core.context_processors.auth. This release will
remove the old method in favor of the new method in
django.contrib.auth.context_processors.auth.postgresql database backend will be removed, use the
postgresql_psycopg2 backend instead.no language code will be removed and has been replaced by the
nb language code.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 simple TextField since the removal of oldforms.
All uses of XMLField can be replaced with TextField.mixin parameter to the open() method of
django.core.files.storage.Storage (and subclasses) will be removed.See the Django 1.1 release notes for more details on these changes.
AdminSite.root(). This method of hooking up the admin URLs will be
removed in favor of including admin.site.urls.supports_object_permissions and supports_anonymous_user until
version 1.4, at which point it will be assumed that all backends will
support these options.8월 01, 2018