<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Django Deprecation Timeline — Django 1.8.19 documentation</title>
<link rel="stylesheet" href="../_static/default.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '1.8.19',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="top" title="Django 1.8.19 documentation" href="../contents.html" />
<link rel="up" title="Django internals" href="index.html" />
<link rel="next" title="The Django source code repository" href="git.html" />
<link rel="prev" title="Django’s release process" href="release-process.html" />
<script type="text/javascript" src="../templatebuiltins.js"></script>
<script type="text/javascript">
(function($) {
if (!django_template_builtins) {
// templatebuiltins.js missing, do nothing.
return;
}
$(document).ready(function() {
// Hyperlink Django template tags and filters
var base = "../ref/templates/builtins.html";
if (base == "#") {
// Special case for builtins.html itself
base = "";
}
// Tags are keywords, class '.k'
$("div.highlight\\-html\\+django span.k").each(function(i, elem) {
var tagname = $(elem).text();
if ($.inArray(tagname, django_template_builtins.ttags) != -1) {
var fragment = tagname.replace(/_/, '-');
$(elem).html("<a href='" + base + "#" + fragment + "'>" + tagname + "</a>");
}
});
// Filters are functions, class '.nf'
$("div.highlight\\-html\\+django span.nf").each(function(i, elem) {
var filtername = $(elem).text();
if ($.inArray(filtername, django_template_builtins.tfilters) != -1) {
var fragment = filtername.replace(/_/, '-');
$(elem).html("<a href='" + base + "#" + fragment + "'>" + filtername + "</a>");
}
});
});
})(jQuery);
</script>
</head>
<body role="document">
<div class="document">
<div id="custom-doc" class="yui-t6">
<div id="hd">
<h1><a href="../index.html">Django 1.8.19 documentation</a></h1>
<div id="global-nav">
<a title="Home page" href="../index.html">Home</a> |
<a title="Table of contents" href="../contents.html">Table of contents</a> |
<a title="Global index" href="../genindex.html">Index</a> |
<a title="Module index" href="../py-modindex.html">Modules</a>
</div>
<div class="nav">
« <a href="release-process.html" title="Django&#8217;s release process">previous</a>
|
<a href="index.html" title="Django internals" accesskey="U">up</a>
|
<a href="git.html" title="The Django source code repository">next</a> »</div>
</div>
<div id="bd">
<div id="yui-main">
<div class="yui-b">
<div class="yui-g" id="internals-deprecation">
<div class="section" id="s-django-deprecation-timeline">
<span id="django-deprecation-timeline"></span><h1>Django Deprecation Timeline<a class="headerlink" href="#django-deprecation-timeline" title="Permalink to this headline">¶</a></h1>
<p>This document outlines when various pieces of Django will be removed or altered
in a backward incompatible way, following their deprecation, as per the
<a class="reference internal" href="release-process.html#internal-release-deprecation-policy"><span class="std std-ref">deprecation policy</span></a>. More details
about each item can often be found in the release notes of two versions prior.</p>
<div class="section" id="s-deprecation-removed-in-1-10">
<span id="s-id1"></span><span id="deprecation-removed-in-1-10"></span><span id="id1"></span><h2>1.10<a class="headerlink" href="#deprecation-removed-in-1-10" title="Permalink to this headline">¶</a></h2>
<p>See the <a class="reference internal" href="../releases/1.8.html#deprecated-features-1-8"><span class="std std-ref">Django 1.8 release notes</span></a> for more
details on these changes.</p>
<ul class="simple">
<li>Support for calling a <code class="docutils literal"><span class="pre">SQLCompiler</span></code> directly as an alias for calling its
<code class="docutils literal"><span class="pre">quote_name_unless_alias</span></code> method will be removed.</li>
<li><code class="docutils literal"><span class="pre">cycle</span></code> and <code class="docutils literal"><span class="pre">firstof</span></code> template tags will be removed from the <code class="docutils literal"><span class="pre">future</span></code>
template tag library (used during the 1.6/1.7 deprecation period).</li>
<li><code class="docutils literal"><span class="pre">django.conf.urls.patterns()</span></code> will be removed.</li>
<li>Support for the <code class="docutils literal"><span class="pre">prefix</span></code> argument to
<code class="docutils literal"><span class="pre">django.conf.urls.i18n.i18n_patterns()</span></code> will be removed.</li>
<li><code class="docutils literal"><span class="pre">SimpleTestCase.urls</span></code> will be removed.</li>
<li>Using an incorrect count of unpacked values in the <code class="docutils literal"><span class="pre">for</span></code> template tag
will raise an exception rather than fail silently.</li>
<li>The ability to <a class="reference internal" href="../ref/urlresolvers.html#django.core.urlresolvers.reverse" title="django.core.urlresolvers.reverse"><code class="xref py py-func docutils literal"><span class="pre">reverse()</span></code></a> URLs using a dotted
Python path will be removed.</li>
<li>The ability to use a dotted Python path for the <code class="docutils literal"><span class="pre">LOGIN_URL</span></code> and
<code class="docutils literal"><span class="pre">LOGIN_REDIRECT_URL</span></code> settings will be removed.</li>
<li>Support for <code class="xref py py-mod docutils literal"><span class="pre">optparse</span></code> will be dropped for custom management commands
(replaced by <code class="xref py py-mod docutils literal"><span class="pre">argparse</span></code>).</li>
<li>The class <a class="reference internal" href="../howto/custom-management-commands.html#django.core.management.NoArgsCommand" title="django.core.management.NoArgsCommand"><code class="xref py py-class docutils literal"><span class="pre">NoArgsCommand</span></code></a> will be removed. Use
<a class="reference internal" href="../howto/custom-management-commands.html#django.core.management.BaseCommand" title="django.core.management.BaseCommand"><code class="xref py py-class docutils literal"><span class="pre">BaseCommand</span></code></a> instead, which takes no arguments
by default.</li>
<li><code class="docutils literal"><span class="pre">django.core.context_processors</span></code> module will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.db.models.sql.aggregates</span></code> module will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.contrib.gis.db.models.sql.aggregates</span></code> module will be removed.</li>
<li>The following methods and properties of <code class="docutils literal"><span class="pre">django.db.sql.query.Query</span></code> will
be removed:<ul>
<li>Properties: <code class="docutils literal"><span class="pre">aggregates</span></code> and <code class="docutils literal"><span class="pre">aggregate_select</span></code></li>
<li>Methods: <code class="docutils literal"><span class="pre">add_aggregate</span></code>, <code class="docutils literal"><span class="pre">set_aggregate_mask</span></code>, and
<code class="docutils literal"><span class="pre">append_aggregate_mask</span></code>.</li>
</ul>
</li>
<li><code class="docutils literal"><span class="pre">django.template.resolve_variable</span></code> will be removed.</li>
<li>The following private APIs will be removed from
<a class="reference internal" href="../ref/models/meta.html#django.db.models.options.Options" title="django.db.models.options.Options"><code class="xref py py-class docutils literal"><span class="pre">django.db.models.options.Options</span></code></a> (<code class="docutils literal"><span class="pre">Model._meta</span></code>):<ul>
<li><code class="docutils literal"><span class="pre">get_field_by_name()</span></code></li>
<li><code class="docutils literal"><span class="pre">get_all_field_names()</span></code></li>
<li><code class="docutils literal"><span class="pre">get_fields_with_model()</span></code></li>
<li><code class="docutils literal"><span class="pre">get_concrete_fields_with_model()</span></code></li>
<li><code class="docutils literal"><span class="pre">get_m2m_with_model()</span></code></li>
<li><code class="docutils literal"><span class="pre">get_all_related_objects()</span></code></li>
<li><code class="docutils literal"><span class="pre">get_all_related_objects_with_model()</span></code></li>
<li><code class="docutils literal"><span class="pre">get_all_related_many_to_many_objects()</span></code></li>
<li><code class="docutils literal"><span class="pre">get_all_related_m2m_objects_with_model()</span></code></li>
</ul>
</li>
<li>The <code class="docutils literal"><span class="pre">error_message</span></code> argument of <code class="docutils literal"><span class="pre">django.forms.RegexField</span></code> will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">unordered_list</span></code> filter will no longer support old style lists.</li>
<li>Support for string <code class="docutils literal"><span class="pre">view</span></code> arguments to <code class="docutils literal"><span class="pre">url()</span></code> will be removed.</li>
<li>The backward compatible shim to rename <code class="docutils literal"><span class="pre">django.forms.Form._has_changed()</span></code>
to <code class="docutils literal"><span class="pre">has_changed()</span></code> will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">removetags</span></code> template filter will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">remove_tags()</span></code> and <code class="docutils literal"><span class="pre">strip_entities()</span></code> functions in
<code class="docutils literal"><span class="pre">django.utils.html</span></code> will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">is_admin_site</span></code> argument to
<code class="docutils literal"><span class="pre">django.contrib.auth.views.password_reset()</span></code> will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.db.models.field.subclassing.SubfieldBase</span></code> will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.utils.checksums</span></code> will be removed; its functionality is included
in django-localflavor 1.1+.</li>
<li>The <code class="docutils literal"><span class="pre">original_content_type_id</span></code> attribute on
<code class="docutils literal"><span class="pre">django.contrib.admin.helpers.InlineAdminForm</span></code> will be removed.</li>
<li>The backwards compatibility shim to allow <code class="docutils literal"><span class="pre">FormMixin.get_form()</span></code> to be
defined with no default value for its <code class="docutils literal"><span class="pre">form_class</span></code> argument will be removed.</li>
<li>The following settings will be removed:<ul>
<li><code class="docutils literal"><span class="pre">ALLOWED_INCLUDE_ROOTS</span></code></li>
<li><code class="docutils literal"><span class="pre">TEMPLATE_CONTEXT_PROCESSORS</span></code></li>
<li><code class="docutils literal"><span class="pre">TEMPLATE_DEBUG</span></code></li>
<li><code class="docutils literal"><span class="pre">TEMPLATE_DIRS</span></code></li>
<li><code class="docutils literal"><span class="pre">TEMPLATE_LOADERS</span></code></li>
<li><code class="docutils literal"><span class="pre">TEMPLATE_STRING_IF_INVALID</span></code></li>
</ul>
</li>
<li>The backwards compatibility alias <code class="docutils literal"><span class="pre">django.template.loader.BaseLoader</span></code> will
be removed.</li>
<li>Django template objects returned by
<a class="reference internal" href="../topics/templates.html#django.template.loader.get_template" title="django.template.loader.get_template"><code class="xref py py-func docutils literal"><span class="pre">get_template()</span></code></a> and
<a class="reference internal" href="../topics/templates.html#django.template.loader.select_template" title="django.template.loader.select_template"><code class="xref py py-func docutils literal"><span class="pre">select_template()</span></code></a> won’t accept a
<a class="reference internal" href="../ref/templates/api.html#django.template.Context" title="django.template.Context"><code class="xref py py-class docutils literal"><span class="pre">Context</span></code></a> in their
<a class="reference internal" href="../topics/templates.html#django.template.backends.base.Template.render" title="django.template.backends.base.Template.render"><code class="xref py py-meth docutils literal"><span class="pre">render()</span></code></a> method anymore.</li>
<li><a class="reference internal" href="../ref/template-response.html"><span class="doc">Template response APIs</span></a> will enforce the use
of <code class="xref py py-class docutils literal"><span class="pre">dict</span></code> and backend-dependent template objects instead of
<a class="reference internal" href="../ref/templates/api.html#django.template.Context" title="django.template.Context"><code class="xref py py-class docutils literal"><span class="pre">Context</span></code></a> and <a class="reference internal" href="../ref/templates/api.html#django.template.Template" title="django.template.Template"><code class="xref py py-class docutils literal"><span class="pre">Template</span></code></a>
respectively.</li>
<li>The <code class="docutils literal"><span class="pre">current_app</span></code> parameter for the following function and classes will be
removed:<ul>
<li><code class="docutils literal"><span class="pre">django.shortcuts.render()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.template.Context()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.template.RequestContext()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.template.response.TemplateResponse()</span></code></li>
</ul>
</li>
<li>The <code class="docutils literal"><span class="pre">dictionary</span></code> and <code class="docutils literal"><span class="pre">context_instance</span></code> parameters for the following
functions will be removed:<ul>
<li><code class="docutils literal"><span class="pre">django.shortcuts.render()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.shortcuts.render_to_response()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.template.loader.render_to_string()</span></code></li>
</ul>
</li>
<li>The <code class="docutils literal"><span class="pre">dirs</span></code> parameter for the following functions will be removed:<ul>
<li><code class="docutils literal"><span class="pre">django.template.loader.get_template()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.template.loader.select_template()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.shortcuts.render()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.shortcuts.render_to_response()</span></code></li>
</ul>
</li>
<li>Session verification will be enabled regardless of whether or not
<code class="docutils literal"><span class="pre">'django.contrib.auth.middleware.SessionAuthenticationMiddleware'</span></code> is in
<code class="docutils literal"><span class="pre">MIDDLEWARE_CLASSES</span></code>.</li>
<li>Private attribute <code class="docutils literal"><span class="pre">django.db.models.Field.related</span></code> will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">--list</span></code> option of the <code class="docutils literal"><span class="pre">migrate</span></code> management command will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">ssi</span></code> template tag will be removed.</li>
<li>Support for the <code class="docutils literal"><span class="pre">=</span></code> comparison operator in the <code class="docutils literal"><span class="pre">if</span></code> template tag will be
removed.</li>
<li>The backwards compatibility shims to allow <code class="docutils literal"><span class="pre">Storage.get_available_name()</span></code>
and <code class="docutils literal"><span class="pre">Storage.save()</span></code> to be defined without a <code class="docutils literal"><span class="pre">max_length</span></code> argument will
be removed.</li>
<li>Support for the legacy <code class="docutils literal"><span class="pre">%(<foo>)s</span></code> syntax in <code class="docutils literal"><span class="pre">ModelFormMixin.success_url</span></code>
will be removed.</li>
<li><code class="docutils literal"><span class="pre">GeoQuerySet</span></code> aggregate methods <code class="docutils literal"><span class="pre">collect()</span></code>, <code class="docutils literal"><span class="pre">extent()</span></code>, <code class="docutils literal"><span class="pre">extent3d()</span></code>,
<code class="docutils literal"><span class="pre">make_line()</span></code>, and <code class="docutils literal"><span class="pre">unionagg()</span></code> will be removed.</li>
<li>Ability to specify <code class="docutils literal"><span class="pre">ContentType.name</span></code> when creating a content type instance
will be removed.</li>
<li>Support for the old signature of <code class="docutils literal"><span class="pre">allow_migrate</span></code> will be removed. It changed
from <code class="docutils literal"><span class="pre">allow_migrate(self,</span> <span class="pre">db,</span> <span class="pre">model)</span></code> to
<code class="docutils literal"><span class="pre">allow_migrate(self,</span> <span class="pre">db,</span> <span class="pre">app_label,</span> <span class="pre">model_name=None,</span> <span class="pre">**hints)</span></code>.</li>
</ul>
</div>
<div class="section" id="s-deprecation-removed-in-1-9">
<span id="s-id2"></span><span id="deprecation-removed-in-1-9"></span><span id="id2"></span><h2>1.9<a class="headerlink" href="#deprecation-removed-in-1-9" title="Permalink to this headline">¶</a></h2>
<p>See the <a class="reference internal" href="../releases/1.7.html#deprecated-features-1-7"><span class="std std-ref">Django 1.7 release notes</span></a> for more
details on these changes.</p>
<ul class="simple">
<li><code class="docutils literal"><span class="pre">django.utils.dictconfig</span></code> will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.utils.importlib</span></code> will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.utils.tzinfo</span></code> will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.utils.unittest</span></code> will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">syncdb</span></code> command will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.db.models.signals.pre_syncdb</span></code> and
<code class="docutils literal"><span class="pre">django.db.models.signals.post_syncdb</span></code> will be removed.</li>
<li><code class="docutils literal"><span class="pre">allow_syncdb</span></code> on database routers will no longer automatically become
<code class="docutils literal"><span class="pre">allow_migrate</span></code>.</li>
<li>Automatic syncing of apps without migrations will be removed. Migrations will
become compulsory for all apps unless you pass the <code class="docutils literal"><span class="pre">--run-syncdb</span></code> option to
<code class="docutils literal"><span class="pre">migrate</span></code>.</li>
<li>Support for automatic loading of <code class="docutils literal"><span class="pre">initial_data</span></code> fixtures and initial SQL
data will be removed.</li>
<li>All models will need to be defined inside an installed application or
declare an explicit <a class="reference internal" href="../ref/models/options.html#django.db.models.Options.app_label" title="django.db.models.Options.app_label"><code class="xref py py-attr docutils literal"><span class="pre">app_label</span></code></a>.
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.</li>
<li>The model and form <code class="docutils literal"><span class="pre">IPAddressField</span></code> will be removed. A stub field will
remain for compatibility with historical migrations.</li>
<li><code class="docutils literal"><span class="pre">AppCommand.handle_app()</span></code> will no longer be supported.</li>
<li><code class="docutils literal"><span class="pre">RequestSite</span></code> and <code class="docutils literal"><span class="pre">get_current_site()</span></code> will no longer be importable from
<code class="docutils literal"><span class="pre">django.contrib.sites.models</span></code>.</li>
<li>FastCGI support via the <code class="docutils literal"><span class="pre">runfcgi</span></code> management command will be
removed. Please deploy your project using WSGI.</li>
<li><code class="docutils literal"><span class="pre">django.utils.datastructures.SortedDict</span></code> will be removed. Use
<code class="xref py py-class docutils literal"><span class="pre">collections.OrderedDict</span></code> from the Python standard library instead.</li>
<li><code class="docutils literal"><span class="pre">ModelAdmin.declared_fieldsets</span></code> will be removed.</li>
<li>Instances of <code class="docutils literal"><span class="pre">util.py</span></code> in the Django codebase have been renamed to
<code class="docutils literal"><span class="pre">utils.py</span></code> in an effort to unify all util and utils references.
The modules that provided backwards compatibility will be removed:<ul>
<li><code class="docutils literal"><span class="pre">django.contrib.admin.util</span></code></li>
<li><code class="docutils literal"><span class="pre">django.contrib.gis.db.backends.util</span></code></li>
<li><code class="docutils literal"><span class="pre">django.db.backends.util</span></code></li>
<li><code class="docutils literal"><span class="pre">django.forms.util</span></code></li>
</ul>
</li>
<li><code class="docutils literal"><span class="pre">ModelAdmin.get_formsets</span></code> will be removed.</li>
<li>The backward compatibility shim introduced to rename the
<code class="docutils literal"><span class="pre">BaseMemcachedCache._get_memcache_timeout()</span></code> method to
<code class="docutils literal"><span class="pre">get_backend_timeout()</span></code> will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">--natural</span></code> and <code class="docutils literal"><span class="pre">-n</span></code> options for <a class="reference internal" href="../ref/django-admin.html#django-admin-dumpdata"><code class="xref std std-djadmin docutils literal"><span class="pre">dumpdata</span></code></a> will be removed.
Use <a class="reference internal" href="../ref/django-admin.html#django-admin-option---natural-foreign"><code class="xref std std-djadminopt docutils literal"><span class="pre">--natural-foreign</span></code></a> instead.</li>
<li>The <code class="docutils literal"><span class="pre">use_natural_keys</span></code> argument for <code class="docutils literal"><span class="pre">serializers.serialize()</span></code> will be
removed. Use <code class="docutils literal"><span class="pre">use_natural_foreign_keys</span></code> instead.</li>
<li>Private API <code class="docutils literal"><span class="pre">django.forms.forms.get_declared_fields()</span></code> will be removed.</li>
<li>The ability to use a <code class="docutils literal"><span class="pre">SplitDateTimeWidget</span></code> with <code class="docutils literal"><span class="pre">DateTimeField</span></code> will be
removed.</li>
<li>The <code class="docutils literal"><span class="pre">WSGIRequest.REQUEST</span></code> property will be removed.</li>
<li>The class <code class="docutils literal"><span class="pre">django.utils.datastructures.MergeDict</span></code> will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">zh-cn</span></code> and <code class="docutils literal"><span class="pre">zh-tw</span></code> language codes will be removed and have been
replaced by the <code class="docutils literal"><span class="pre">zh-hans</span></code> and <code class="docutils literal"><span class="pre">zh-hant</span></code> language code respectively.</li>
<li>The internal <code class="docutils literal"><span class="pre">django.utils.functional.memoize</span></code> will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.core.cache.get_cache</span></code> will be removed. Add suitable entries
to <a class="reference internal" href="../ref/settings.html#std:setting-CACHES"><code class="xref std std-setting docutils literal"><span class="pre">CACHES</span></code></a> and use <a class="reference internal" href="../topics/cache.html#django.core.cache.caches" title="django.core.cache.caches"><code class="xref py py-data docutils literal"><span class="pre">django.core.cache.caches</span></code></a> instead.</li>
<li><code class="docutils literal"><span class="pre">django.db.models.loading</span></code> will be removed.</li>
<li>Passing callable arguments to querysets will no longer be possible.</li>
<li><code class="docutils literal"><span class="pre">BaseCommand.requires_model_validation</span></code> will be removed in favor of
<code class="docutils literal"><span class="pre">requires_system_checks</span></code>. Admin validators will be replaced by admin
checks.</li>
<li>The <code class="docutils literal"><span class="pre">ModelAdmin.validator_class</span></code> and <code class="docutils literal"><span class="pre">default_validator_class</span></code> attributes
will be removed.</li>
<li><code class="docutils literal"><span class="pre">ModelAdmin.validate()</span></code> will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.db.backends.DatabaseValidation.validate_field</span></code> will be removed in
favor of the <code class="docutils literal"><span class="pre">check_field</span></code> method.</li>
<li>The <code class="docutils literal"><span class="pre">validate</span></code> management command will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.utils.module_loading.import_by_path</span></code> will be removed in favor of
<code class="docutils literal"><span class="pre">django.utils.module_loading.import_string</span></code>.</li>
<li><code class="docutils literal"><span class="pre">ssi</span></code> and <code class="docutils literal"><span class="pre">url</span></code> template tags will be removed from the <code class="docutils literal"><span class="pre">future</span></code> template
tag library (used during the 1.3/1.4 deprecation period).</li>
<li><code class="docutils literal"><span class="pre">django.utils.text.javascript_quote</span></code> will be removed.</li>
<li>Database test settings as independent entries in the database settings,
prefixed by <code class="docutils literal"><span class="pre">TEST_</span></code>, will no longer be supported.</li>
<li>The <cite>cache_choices</cite> option to <a class="reference internal" href="../ref/forms/fields.html#django.forms.ModelChoiceField" title="django.forms.ModelChoiceField"><code class="xref py py-class docutils literal"><span class="pre">ModelChoiceField</span></code></a> and
<a class="reference internal" href="../ref/forms/fields.html#django.forms.ModelMultipleChoiceField" title="django.forms.ModelMultipleChoiceField"><code class="xref py py-class docutils literal"><span class="pre">ModelMultipleChoiceField</span></code></a> will be removed.</li>
<li>The default value of the
<a class="reference internal" href="../ref/class-based-views/base.html#django.views.generic.base.RedirectView.permanent" title="django.views.generic.base.RedirectView.permanent"><code class="xref py py-attr docutils literal"><span class="pre">RedirectView.permanent</span></code></a>
attribute will change from <code class="docutils literal"><span class="pre">True</span></code> to <code class="docutils literal"><span class="pre">False</span></code>.</li>
<li><code class="docutils literal"><span class="pre">django.contrib.sitemaps.FlatPageSitemap</span></code> will be removed in favor of
<code class="docutils literal"><span class="pre">django.contrib.flatpages.sitemaps.FlatPageSitemap</span></code>.</li>
<li>Private API <code class="docutils literal"><span class="pre">django.test.utils.TestTemplateLoader</span></code> will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">django.contrib.contenttypes.generic</span></code> module will be removed.</li>
<li>Private APIs <code class="docutils literal"><span class="pre">django.db.models.sql.where.WhereNode.make_atom()</span></code> and
<code class="docutils literal"><span class="pre">django.db.models.sql.where.Constraint</span></code> will be removed.</li>
</ul>
</div>
<div class="section" id="s-deprecation-removed-in-1-8">
<span id="s-id3"></span><span id="deprecation-removed-in-1-8"></span><span id="id3"></span><h2>1.8<a class="headerlink" href="#deprecation-removed-in-1-8" title="Permalink to this headline">¶</a></h2>
<p>See the <a class="reference internal" href="../releases/1.6.html#deprecated-features-1-6"><span class="std std-ref">Django 1.6 release notes</span></a> for more
details on these changes.</p>
<ul class="simple">
<li><code class="docutils literal"><span class="pre">django.contrib.comments</span></code> will be removed.</li>
<li>The following transaction management APIs will be removed:<ul>
<li><code class="docutils literal"><span class="pre">TransactionMiddleware</span></code>,</li>
<li>the decorators and context managers <code class="docutils literal"><span class="pre">autocommit</span></code>, <code class="docutils literal"><span class="pre">commit_on_success</span></code>,
and <code class="docutils literal"><span class="pre">commit_manually</span></code>, defined in <code class="docutils literal"><span class="pre">django.db.transaction</span></code>,</li>
<li>the functions <code class="docutils literal"><span class="pre">commit_unless_managed</span></code> and <code class="docutils literal"><span class="pre">rollback_unless_managed</span></code>,
also defined in <code class="docutils literal"><span class="pre">django.db.transaction</span></code>,</li>
<li>the <code class="docutils literal"><span class="pre">TRANSACTIONS_MANAGED</span></code> setting.</li>
</ul>
</li>
<li>The <a class="reference internal" href="../ref/templates/builtins.html#std:templatetag-cycle"><code class="xref std std-ttag docutils literal"><span class="pre">cycle</span></code></a> and <a class="reference internal" href="../ref/templates/builtins.html#std:templatetag-firstof"><code class="xref std std-ttag docutils literal"><span class="pre">firstof</span></code></a> 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 <code class="docutils literal"><span class="pre">future</span></code> template tag library.</li>
<li>The <code class="docutils literal"><span class="pre">SEND_BROKEN_LINK_EMAILS</span></code> setting will be removed. Add the
<a class="reference internal" href="../ref/middleware.html#django.middleware.common.BrokenLinkEmailsMiddleware" title="django.middleware.common.BrokenLinkEmailsMiddleware"><code class="xref py py-class docutils literal"><span class="pre">django.middleware.common.BrokenLinkEmailsMiddleware</span></code></a> middleware to
your <a class="reference internal" href="../ref/settings.html#std:setting-MIDDLEWARE_CLASSES"><code class="xref std std-setting docutils literal"><span class="pre">MIDDLEWARE_CLASSES</span></code></a> setting instead.</li>
<li><code class="docutils literal"><span class="pre">django.middleware.doc.XViewMiddleware</span></code> will be removed. Use
<code class="docutils literal"><span class="pre">django.contrib.admindocs.middleware.XViewMiddleware</span></code> instead.</li>
<li><code class="docutils literal"><span class="pre">Model._meta.module_name</span></code> was renamed to <code class="docutils literal"><span class="pre">model_name</span></code>.</li>
<li>Remove the backward compatible shims introduced to rename <code class="docutils literal"><span class="pre">get_query_set</span></code>
and similar queryset methods. This affects the following classes:
<code class="docutils literal"><span class="pre">BaseModelAdmin</span></code>, <code class="docutils literal"><span class="pre">ChangeList</span></code>, <code class="docutils literal"><span class="pre">BaseCommentNode</span></code>,
<code class="docutils literal"><span class="pre">GenericForeignKey</span></code>, <code class="docutils literal"><span class="pre">Manager</span></code>, <code class="docutils literal"><span class="pre">SingleRelatedObjectDescriptor</span></code> and
<code class="docutils literal"><span class="pre">ReverseSingleRelatedObjectDescriptor</span></code>.</li>
<li>Remove the backward compatible shims introduced to rename the attributes
<code class="docutils literal"><span class="pre">ChangeList.root_query_set</span></code> and <code class="docutils literal"><span class="pre">ChangeList.query_set</span></code>.</li>
<li><code class="docutils literal"><span class="pre">django.views.defaults.shortcut</span></code> will be removed, as part of the
goal of removing all <code class="docutils literal"><span class="pre">django.contrib</span></code> references from the core
Django codebase. Instead use
<code class="docutils literal"><span class="pre">django.contrib.contenttypes.views.shortcut</span></code>. <code class="docutils literal"><span class="pre">django.conf.urls.shortcut</span></code>
will also be removed.</li>
<li>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.
You are advised to install <a class="reference external" href="https://pypi.python.org/pypi/Pillow">Pillow</a>, which should be used instead.</li>
<li>The following private APIs will be removed:<ul>
<li><code class="docutils literal"><span class="pre">django.db.backend</span></code></li>
<li><code class="docutils literal"><span class="pre">django.db.close_connection()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.db.backends.creation.BaseDatabaseCreation.set_autocommit()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.db.transaction.is_managed()</span></code></li>
<li><code class="docutils literal"><span class="pre">django.db.transaction.managed()</span></code></li>
</ul>
</li>
<li><code class="docutils literal"><span class="pre">django.forms.widgets.RadioInput</span></code> will be removed in favor of
<code class="docutils literal"><span class="pre">django.forms.widgets.RadioChoiceInput</span></code>.</li>
<li>The module <code class="docutils literal"><span class="pre">django.test.simple</span></code> and the class
<code class="docutils literal"><span class="pre">django.test.simple.DjangoTestSuiteRunner</span></code> will be removed. Instead use
<code class="docutils literal"><span class="pre">django.test.runner.DiscoverRunner</span></code>.</li>
<li>The module <code class="docutils literal"><span class="pre">django.test._doctest</span></code> will be removed. Instead use the doctest
module from the Python standard library.</li>
<li>The <code class="docutils literal"><span class="pre">CACHE_MIDDLEWARE_ANONYMOUS_ONLY</span></code> setting will be removed.</li>
<li>Usage of the hard-coded <em>Hold down “Control”, or “Command” on a Mac, to select
more than one.</em> string to override or append to user-provided <code class="docutils literal"><span class="pre">help_text</span></code> in
forms for ManyToMany model fields will not be performed by Django anymore
either at the model or forms layer.</li>
<li>The <code class="docutils literal"><span class="pre">Model._meta.get_(add|change|delete)_permission</span></code> methods will
be removed.</li>
<li>The session key <code class="docutils literal"><span class="pre">django_language</span></code> will no longer be read for backwards
compatibility.</li>
<li>Geographic Sitemaps will be removed
(<code class="docutils literal"><span class="pre">django.contrib.gis.sitemaps.views.index</span></code> and
<code class="docutils literal"><span class="pre">django.contrib.gis.sitemaps.views.sitemap</span></code>).</li>
<li><code class="docutils literal"><span class="pre">django.utils.html.fix_ampersands</span></code>, the <code class="docutils literal"><span class="pre">fix_ampersands</span></code> template filter and
<code class="docutils literal"><span class="pre">django.utils.html.clean_html</span></code> will be removed following an accelerated deprecation.</li>
</ul>
</div>
<div class="section" id="s-deprecation-removed-in-1-7">
<span id="s-id4"></span><span id="deprecation-removed-in-1-7"></span><span id="id4"></span><h2>1.7<a class="headerlink" href="#deprecation-removed-in-1-7" title="Permalink to this headline">¶</a></h2>
<p>See the <a class="reference internal" href="../releases/1.5.html#deprecated-features-1-5"><span class="std std-ref">Django 1.5 release notes</span></a> for more
details on these changes.</p>
<ul class="simple">
<li>The module <code class="docutils literal"><span class="pre">django.utils.simplejson</span></code> will be removed. The standard library
provides <code class="xref py py-mod docutils literal"><span class="pre">json</span></code> which should be used instead.</li>
<li>The function <code class="docutils literal"><span class="pre">django.utils.itercompat.product</span></code> will be removed. The Python
builtin version should be used instead.</li>
<li>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.</li>
<li>The <code class="docutils literal"><span class="pre">mimetype</span></code> argument to the <code class="docutils literal"><span class="pre">__init__</span></code> methods of
<a class="reference internal" href="../ref/request-response.html#django.http.HttpResponse" title="django.http.HttpResponse"><code class="xref py py-class docutils literal"><span class="pre">HttpResponse</span></code></a>,
<a class="reference internal" href="../ref/template-response.html#django.template.response.SimpleTemplateResponse" title="django.template.response.SimpleTemplateResponse"><code class="xref py py-class docutils literal"><span class="pre">SimpleTemplateResponse</span></code></a>, and
<a class="reference internal" href="../ref/template-response.html#django.template.response.TemplateResponse" title="django.template.response.TemplateResponse"><code class="xref py py-class docutils literal"><span class="pre">TemplateResponse</span></code></a>, will be removed.
<code class="docutils literal"><span class="pre">content_type</span></code> should be used instead. This also applies to the
<a class="reference internal" href="../topics/http/shortcuts.html#django.shortcuts.render_to_response" title="django.shortcuts.render_to_response"><code class="xref py py-func docutils literal"><span class="pre">render_to_response()</span></code></a> shortcut and
the sitemap views, <a class="reference internal" href="../ref/contrib/sitemaps.html#django.contrib.sitemaps.views.index" title="django.contrib.sitemaps.views.index"><code class="xref py py-func docutils literal"><span class="pre">index()</span></code></a> and
<a class="reference internal" href="../ref/contrib/sitemaps.html#django.contrib.sitemaps.views.sitemap" title="django.contrib.sitemaps.views.sitemap"><code class="xref py py-func docutils literal"><span class="pre">sitemap()</span></code></a>.</li>
<li>When <a class="reference internal" href="../ref/request-response.html#django.http.HttpResponse" title="django.http.HttpResponse"><code class="xref py py-class docutils literal"><span class="pre">HttpResponse</span></code></a> is instantiated with an iterator,
or when <a class="reference internal" href="../ref/request-response.html#django.http.HttpResponse.content" title="django.http.HttpResponse.content"><code class="xref py py-attr docutils literal"><span class="pre">content</span></code></a> is set to an iterator,
that iterator will be immediately consumed.</li>
<li>The <code class="docutils literal"><span class="pre">AUTH_PROFILE_MODULE</span></code> setting, and the <code class="docutils literal"><span class="pre">get_profile()</span></code> method on
the User model, will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">cleanup</span></code> management command will be removed. It’s replaced by
<code class="docutils literal"><span class="pre">clearsessions</span></code>.</li>
<li>The <code class="docutils literal"><span class="pre">daily_cleanup.py</span></code> script will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">depth</span></code> keyword argument will be removed from
<a class="reference internal" href="../ref/models/querysets.html#django.db.models.query.QuerySet.select_related" title="django.db.models.query.QuerySet.select_related"><code class="xref py py-meth docutils literal"><span class="pre">select_related()</span></code></a>.</li>
<li>The undocumented <code class="docutils literal"><span class="pre">get_warnings_state()</span></code>/<code class="docutils literal"><span class="pre">restore_warnings_state()</span></code>
functions from <a class="reference internal" href="../topics/testing/advanced.html#module-django.test.utils" title="django.test.utils: Helpers to write custom test runners."><code class="xref py py-mod docutils literal"><span class="pre">django.test.utils</span></code></a> and the <code class="docutils literal"><span class="pre">save_warnings_state()</span></code>/
<code class="docutils literal"><span class="pre">restore_warnings_state()</span></code>
<a class="reference internal" href="../topics/testing/tools.html#django-testcase-subclasses"><span class="std std-ref">django.test.*TestCase</span></a> methods are
deprecated. Use the <code class="xref py py-class docutils literal"><span class="pre">warnings.catch_warnings</span></code> context manager
available starting with Python 2.6 instead.</li>
<li>The undocumented <code class="docutils literal"><span class="pre">check_for_test_cookie</span></code> method in
<a class="reference internal" href="../topics/auth/default.html#django.contrib.auth.forms.AuthenticationForm" title="django.contrib.auth.forms.AuthenticationForm"><code class="xref py py-class docutils literal"><span class="pre">AuthenticationForm</span></code></a> 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.</li>
<li>The version of <a class="reference internal" href="../topics/auth/default.html#django.contrib.auth.views.password_reset_confirm" title="django.contrib.auth.views.password_reset_confirm"><code class="xref py py-func docutils literal"><span class="pre">django.contrib.auth.views.password_reset_confirm()</span></code></a> that
supports base36 encoded user IDs
(<code class="docutils literal"><span class="pre">django.contrib.auth.views.password_reset_confirm_uidb36</span></code>) will be
removed. If your site has been running Django 1.6 for more than
<a class="reference internal" href="../ref/settings.html#std:setting-PASSWORD_RESET_TIMEOUT_DAYS"><code class="xref std std-setting docutils literal"><span class="pre">PASSWORD_RESET_TIMEOUT_DAYS</span></code></a>, 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.</li>
<li>The <code class="docutils literal"><span class="pre">django.utils.encoding.StrAndUnicode</span></code> mix-in will be removed.
Define a <code class="docutils literal"><span class="pre">__str__</span></code> method and apply the
<a class="reference internal" href="../ref/utils.html#django.utils.encoding.python_2_unicode_compatible" title="django.utils.encoding.python_2_unicode_compatible"><code class="xref py py-func docutils literal"><span class="pre">python_2_unicode_compatible()</span></code></a> decorator instead.</li>
</ul>
</div>
<div class="section" id="s-deprecation-removed-in-1-6">
<span id="s-id5"></span><span id="deprecation-removed-in-1-6"></span><span id="id5"></span><h2>1.6<a class="headerlink" href="#deprecation-removed-in-1-6" title="Permalink to this headline">¶</a></h2>
<p>See the <a class="reference internal" href="../releases/1.4.html#deprecated-features-1-4"><span class="std std-ref">Django 1.4 release notes</span></a> for more
details on these changes.</p>
<ul class="simple">
<li><code class="docutils literal"><span class="pre">django.contrib.databrowse</span></code> will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.contrib.localflavor</span></code> will be removed following an accelerated
deprecation.</li>
<li><code class="docutils literal"><span class="pre">django.contrib.markup</span></code> will be removed following an accelerated
deprecation.</li>
<li>The compatibility modules <code class="docutils literal"><span class="pre">django.utils.copycompat</span></code> and
<code class="docutils literal"><span class="pre">django.utils.hashcompat</span></code> as well as the functions
<code class="docutils literal"><span class="pre">django.utils.itercompat.all</span></code> and <code class="docutils literal"><span class="pre">django.utils.itercompat.any</span></code> will
be removed. The Python builtin versions should be used instead.</li>
<li>The <code class="docutils literal"><span class="pre">csrf_response_exempt</span></code> and <code class="docutils literal"><span class="pre">csrf_view_exempt</span></code> decorators will
be removed. Since 1.4 <code class="docutils literal"><span class="pre">csrf_response_exempt</span></code> has been a no-op (it
returns the same function), and <code class="docutils literal"><span class="pre">csrf_view_exempt</span></code> has been a
synonym for <code class="docutils literal"><span class="pre">django.views.decorators.csrf.csrf_exempt</span></code>, which should
be used to replace it.</li>
<li>The <code class="docutils literal"><span class="pre">django.core.cache.backends.memcached.CacheClass</span></code> backend
was split into two in Django 1.3 in order to introduce support for
PyLibMC. The historical <code class="docutils literal"><span class="pre">CacheClass</span></code> will be removed in favor of
<code class="docutils literal"><span class="pre">django.core.cache.backends.memcached.MemcachedCache</span></code>.</li>
<li>The UK-prefixed objects of <code class="docutils literal"><span class="pre">django.contrib.localflavor.uk</span></code> will only
be accessible through their GB-prefixed names (GB is the correct
ISO 3166 code for United Kingdom).</li>
<li>The <code class="docutils literal"><span class="pre">IGNORABLE_404_STARTS</span></code> and <code class="docutils literal"><span class="pre">IGNORABLE_404_ENDS</span></code> settings have been
superseded by <a class="reference internal" href="../ref/settings.html#std:setting-IGNORABLE_404_URLS"><code class="xref std std-setting docutils literal"><span class="pre">IGNORABLE_404_URLS</span></code></a> in the 1.4 release. They will be
removed.</li>
<li>The form wizard has been refactored to use class-based views with pluggable
backends in 1.4. The previous implementation will be removed.</li>
<li>Legacy ways of calling
<a class="reference internal" href="../topics/cache.html#django.views.decorators.cache.cache_page" title="django.views.decorators.cache.cache_page"><code class="xref py py-func docutils literal"><span class="pre">cache_page()</span></code></a> will be removed.</li>
<li>The backward-compatibility shim to automatically add a debug-false
filter to the <code class="docutils literal"><span class="pre">'mail_admins'</span></code> logging handler will be removed. The
<a class="reference internal" href="../ref/settings.html#std:setting-LOGGING"><code class="xref std std-setting docutils literal"><span class="pre">LOGGING</span></code></a> setting should include this filter explicitly if
it is desired.</li>
<li>The builtin truncation functions <code class="docutils literal"><span class="pre">django.utils.text.truncate_words()</span></code>
and <code class="docutils literal"><span class="pre">django.utils.text.truncate_html_words()</span></code> will be removed in
favor of the <code class="docutils literal"><span class="pre">django.utils.text.Truncator</span></code> class.</li>
<li>The <a class="reference internal" href="../ref/contrib/gis/geoip.html#django.contrib.gis.geoip.GeoIP" title="django.contrib.gis.geoip.GeoIP"><code class="xref py py-class docutils literal"><span class="pre">GeoIP</span></code></a> class was moved to
<a class="reference internal" href="../ref/contrib/gis/geoip.html#module-django.contrib.gis.geoip" title="django.contrib.gis.geoip: High-level Python interface for MaxMind's GeoIP C library."><code class="xref py py-mod docutils literal"><span class="pre">django.contrib.gis.geoip</span></code></a> in 1.4 – the shortcut in
<a class="reference internal" href="../ref/contrib/gis/utils.html#module-django.contrib.gis.utils" title="django.contrib.gis.utils: GeoDjango's collection of utilities."><code class="xref py py-mod docutils literal"><span class="pre">django.contrib.gis.utils</span></code></a> will be removed.</li>
<li><code class="docutils literal"><span class="pre">django.conf.urls.defaults</span></code> will be removed. The functions
<a class="reference internal" href="../ref/urls.html#django.conf.urls.include" title="django.conf.urls.include"><code class="xref py py-func docutils literal"><span class="pre">include()</span></code></a>, <a class="reference internal" href="../ref/urls.html#django.conf.urls.patterns" title="django.conf.urls.patterns"><code class="xref py py-func docutils literal"><span class="pre">patterns()</span></code></a> and
<a class="reference internal" href="../ref/urls.html#django.conf.urls.url" title="django.conf.urls.url"><code class="xref py py-func docutils literal"><span class="pre">url()</span></code></a> plus <a class="reference internal" href="../ref/urls.html#django.conf.urls.handler404" title="django.conf.urls.handler404"><code class="xref py py-data docutils literal"><span class="pre">handler404</span></code></a>,
<a class="reference internal" href="../ref/urls.html#django.conf.urls.handler500" title="django.conf.urls.handler500"><code class="xref py py-data docutils literal"><span class="pre">handler500</span></code></a>, are now available through
<a class="reference internal" href="../ref/urls.html#module-django.conf.urls" title="django.conf.urls"><code class="xref py py-mod docutils literal"><span class="pre">django.conf.urls</span></code></a> .</li>
<li>The functions <code class="docutils literal"><span class="pre">setup_environ()</span></code> and <code class="docutils literal"><span class="pre">execute_manager()</span></code> will be removed
from <a class="reference internal" href="../howto/custom-management-commands.html#module-django.core.management" title="django.core.management"><code class="xref py py-mod docutils literal"><span class="pre">django.core.management</span></code></a>. This also means that the old (pre-1.4)
style of <code class="file docutils literal"><span class="pre">manage.py</span></code> file will no longer work.</li>
<li>Setting the <code class="docutils literal"><span class="pre">is_safe</span></code> and <code class="docutils literal"><span class="pre">needs_autoescape</span></code> flags as attributes of
template filter functions will no longer be supported.</li>
<li>The attribute <code class="docutils literal"><span class="pre">HttpRequest.raw_post_data</span></code> was renamed to <code class="docutils literal"><span class="pre">HttpRequest.body</span></code>
in 1.4. The backward compatibility will be removed –
<code class="docutils literal"><span class="pre">HttpRequest.raw_post_data</span></code> will no longer work.</li>
<li>The value for the <code class="docutils literal"><span class="pre">post_url_continue</span></code> parameter in
<code class="docutils literal"><span class="pre">ModelAdmin.response_add()</span></code> will have to be either <code class="docutils literal"><span class="pre">None</span></code> (to redirect
to the newly created object’s edit page) or a pre-formatted url. String
formats, such as the previous default <code class="docutils literal"><span class="pre">'../%s/'</span></code>, will not be accepted any
more.</li>
</ul>
</div>
<div class="section" id="s-deprecation-removed-in-1-5">
<span id="s-id6"></span><span id="deprecation-removed-in-1-5"></span><span id="id6"></span><h2>1.5<a class="headerlink" href="#deprecation-removed-in-1-5" title="Permalink to this headline">¶</a></h2>
<p>See the <a class="reference internal" href="../releases/1.3.html#deprecated-features-1-3"><span class="std std-ref">Django 1.3 release notes</span></a> for more
details on these changes.</p>
<ul class="simple">
<li>Starting Django without a <a class="reference internal" href="../ref/settings.html#std:setting-SECRET_KEY"><code class="xref std std-setting docutils literal"><span class="pre">SECRET_KEY</span></code></a> will result in an exception
rather than a <code class="docutils literal"><span class="pre">DeprecationWarning</span></code>. (This is accelerated from the usual
deprecation path; see the <a class="reference internal" href="../releases/1.4.html"><span class="doc">Django 1.4 release notes</span></a>.)</li>
<li>The <code class="docutils literal"><span class="pre">mod_python</span></code> request handler will be removed. The <code class="docutils literal"><span class="pre">mod_wsgi</span></code>
handler should be used instead.</li>
<li>The <code class="docutils literal"><span class="pre">template</span></code> attribute on <code class="docutils literal"><span class="pre">django.test.client.Response</span></code>
objects returned by the <a class="reference internal" href="../topics/testing/tools.html#test-client"><span class="std std-ref">test client</span></a> will be removed.
The <a class="reference internal" href="../topics/testing/tools.html#django.test.Response.templates" title="django.test.Response.templates"><code class="xref py py-attr docutils literal"><span class="pre">templates</span></code></a> attribute should be
used instead.</li>
<li>The <code class="docutils literal"><span class="pre">django.test.simple.DjangoTestRunner</span></code> will be removed.
Instead use a unittest-native class. The features of the
<code class="docutils literal"><span class="pre">django.test.simple.DjangoTestRunner</span></code> (including fail-fast and
Ctrl-C test termination) can currently be provided by the unittest-native
<code class="xref py py-class docutils literal"><span class="pre">TextTestRunner</span></code>.</li>
<li>The undocumented function
<code class="docutils literal"><span class="pre">django.contrib.formtools.utils.security_hash</span></code> will be removed,
instead use <code class="docutils literal"><span class="pre">django.contrib.formtools.utils.form_hmac</span></code></li>
<li>The function-based generic view modules will be removed in favor of their
class-based equivalents, outlined <a class="reference internal" href="../topics/class-based-views/index.html"><span class="doc">here</span></a>.</li>
<li>The <code class="docutils literal"><span class="pre">django.core.servers.basehttp.AdminMediaHandler</span></code> will be
removed. In its place use
<code class="docutils literal"><span class="pre">django.contrib.staticfiles.handlers.StaticFilesHandler</span></code>.</li>
<li>The template tags library <code class="docutils literal"><span class="pre">adminmedia</span></code> and the template tag <code class="docutils literal"><span class="pre">{%</span>
<span class="pre">admin_media_prefix</span> <span class="pre">%}</span></code> will be removed in favor of the generic static files
handling. (This is faster than the usual deprecation path; see the
<a class="reference internal" href="../releases/1.4.html"><span class="doc">Django 1.4 release notes</span></a>.)</li>
<li>The <a class="reference internal" href="../ref/templates/builtins.html#std:templatetag-url"><code class="xref std std-ttag docutils literal"><span class="pre">url</span></code></a> and <a class="reference internal" href="../ref/templates/builtins.html#std:templatetag-ssi"><code class="xref std std-ttag docutils literal"><span class="pre">ssi</span></code></a> 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 <code class="docutils literal"><span class="pre">future</span></code> template tag library.</li>
<li>The <code class="docutils literal"><span class="pre">reset</span></code> and <code class="docutils literal"><span class="pre">sqlreset</span></code> management commands will be removed.</li>
<li>Authentication backends will need to support an inactive user
being passed to all methods dealing with permissions.
The <code class="docutils literal"><span class="pre">supports_inactive_user</span></code> attribute will no longer be checked
and can be removed from custom backends.</li>
<li><a class="reference internal" href="../ref/contrib/gis/geos.html#django.contrib.gis.geos.GEOSGeometry.transform" title="django.contrib.gis.geos.GEOSGeometry.transform"><code class="xref py py-meth docutils literal"><span class="pre">transform()</span></code></a> will raise
a <a class="reference internal" href="../ref/contrib/gis/geos.html#django.contrib.gis.geos.GEOSException" title="django.contrib.gis.geos.GEOSException"><code class="xref py py-class docutils literal"><span class="pre">GEOSException</span></code></a> when called
on a geometry with no SRID value.</li>
<li><code class="docutils literal"><span class="pre">django.http.CompatCookie</span></code> will be removed in favor of
<code class="docutils literal"><span class="pre">django.http.SimpleCookie</span></code>.</li>
<li><code class="docutils literal"><span class="pre">django.core.context_processors.PermWrapper</span></code> and
<code class="docutils literal"><span class="pre">django.core.context_processors.PermLookupDict</span></code> will be removed in
favor of the corresponding
<code class="docutils literal"><span class="pre">django.contrib.auth.context_processors.PermWrapper</span></code> and
<code class="docutils literal"><span class="pre">django.contrib.auth.context_processors.PermLookupDict</span></code>, respectively.</li>
<li>The <a class="reference internal" href="../ref/settings.html#std:setting-MEDIA_URL"><code class="xref std std-setting docutils literal"><span class="pre">MEDIA_URL</span></code></a> or <a class="reference internal" href="../ref/settings.html#std:setting-STATIC_URL"><code class="xref std std-setting docutils literal"><span class="pre">STATIC_URL</span></code></a> settings will be
required to end with a trailing slash to ensure there is a consistent
way to combine paths in templates.</li>
<li><code class="docutils literal"><span class="pre">django.db.models.fields.URLField.verify_exists</span></code> 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.</li>
<li>Translations located under the so-called <em>project path</em> will be ignored during
the translation building process performed at runtime. The
<a class="reference internal" href="../ref/settings.html#std:setting-LOCALE_PATHS"><code class="xref std std-setting docutils literal"><span class="pre">LOCALE_PATHS</span></code></a> setting can be used for the same task by including the
filesystem path to a <code class="docutils literal"><span class="pre">locale</span></code> directory containing non-app-specific
translations in its value.</li>
<li>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.</li>
<li>The <code class="docutils literal"><span class="pre">CACHE_BACKEND</span></code> setting will be removed. The cache backend(s) should be
specified in the <a class="reference internal" href="../ref/settings.html#std:setting-CACHES"><code class="xref std std-setting docutils literal"><span class="pre">CACHES</span></code></a> setting.</li>
</ul>
</div>
<div class="section" id="s-deprecation-removed-in-1-4">
<span id="s-id7"></span><span id="deprecation-removed-in-1-4"></span><span id="id7"></span><h2>1.4<a class="headerlink" href="#deprecation-removed-in-1-4" title="Permalink to this headline">¶</a></h2>
<p>See the <a class="reference internal" href="../releases/1.2.html#deprecated-features-1-2"><span class="std std-ref">Django 1.2 release notes</span></a> for more
details on these changes.</p>
<ul class="simple">
<li><code class="docutils literal"><span class="pre">CsrfResponseMiddleware</span></code> and <code class="docutils literal"><span class="pre">CsrfMiddleware</span></code> will be removed. Use
the <code class="docutils literal"><span class="pre">{%</span> <span class="pre">csrf_token</span> <span class="pre">%}</span></code> template tag inside forms to enable CSRF
protection. <code class="docutils literal"><span class="pre">CsrfViewMiddleware</span></code> remains and is enabled by default.</li>
<li>The old imports for CSRF functionality (<code class="docutils literal"><span class="pre">django.contrib.csrf.*</span></code>),
which moved to core in 1.2, will be removed.</li>
<li>The <code class="docutils literal"><span class="pre">django.contrib.gis.db.backend</span></code> module will be removed in favor
of the specific backends.</li>
<li><code class="docutils literal"><span class="pre">SMTPConnection</span></code> will be removed in favor of a generic Email backend API.</li>
<li>The many to many SQL generation functions on the database backends
will be removed.</li>
<li>The ability to use the <code class="docutils literal"><span class="pre">DATABASE_*</span></code> family of top-level settings to
define database connections will be removed.</li>
<li>The ability to use shorthand notation to specify a database backend
(i.e., <code class="docutils literal"><span class="pre">sqlite3</span></code> instead of <code class="docutils literal"><span class="pre">django.db.backends.sqlite3</span></code>) will be
removed.</li>
<li>The <code class="docutils literal"><span class="pre">get_db_prep_save</span></code>, <code class="docutils literal"><span class="pre">get_db_prep_value</span></code> and
<code class="docutils literal"><span class="pre">get_db_prep_lookup</span></code> methods will have to support multiple databases.</li>
<li>The <code class="docutils literal"><span class="pre">Message</span></code> model (in <code class="docutils literal"><span class="pre">django.contrib.auth</span></code>), its related
manager in the <code class="docutils literal"><span class="pre">User</span></code> model (<code class="docutils literal"><span class="pre">user.message_set</span></code>), and the
associated methods (<code class="docutils literal"><span class="pre">user.message_set.create()</span></code> and
<code class="docutils literal"><span class="pre">user.get_and_delete_messages()</span></code>), will be removed. The
<a class="reference internal" href="../ref/contrib/messages.html"><span class="doc">messages framework</span></a> should be used
instead. The related <code class="docutils literal"><span class="pre">messages</span></code> 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.</li>
<li>Authentication backends will need to support the <code class="docutils literal"><span class="pre">obj</span></code> parameter for
permission checking. The <code class="docutils literal"><span class="pre">supports_object_permissions</span></code> attribute
will no longer be checked and can be removed from custom backends.</li>
<li>Authentication backends will need to support the <code class="docutils literal"><span class="pre">AnonymousUser</span></code> class
being passed to all methods dealing with permissions. The
<code class="docutils literal"><span class="pre">supports_anonymous_user</span></code> variable will no longer be checked and can be
removed from custom backends.</li>
<li>The ability to specify a callable template loader rather than a
<code class="docutils literal"><span class="pre">Loader</span></code> class will be removed, as will the <code class="docutils literal"><span class="pre">load_template_source</span></code>
functions that are included with the built in template loaders for
backwards compatibility.</li>
<li><code class="docutils literal"><span class="pre">django.utils.translation.get_date_formats()</span></code> and
<code class="docutils literal"><span class="pre">django.utils.translation.get_partial_date_formats()</span></code>. These functions
will be removed; use the locale-aware
<code class="docutils literal"><span class="pre">django.utils.formats.get_format()</span></code> to get the appropriate formats.</li>
<li>In <code class="docutils literal"><span class="pre">django.forms.fields</span></code>, the constants: <code class="docutils literal"><span class="pre">DEFAULT_DATE_INPUT_FORMATS</span></code>,
<code class="docutils literal"><span class="pre">DEFAULT_TIME_INPUT_FORMATS</span></code> and
<code class="docutils literal"><span class="pre">DEFAULT_DATETIME_INPUT_FORMATS</span></code> will be removed. Use
<code class="docutils literal"><span class="pre">django.utils.formats.get_format()</span></code> to get the appropriate
formats.</li>
<li>The ability to use a function-based test runner will be removed,
along with the <code class="docutils literal"><span class="pre">django.test.simple.run_tests()</span></code> test runner.</li>
<li>The <code class="docutils literal"><span class="pre">views.feed()</span></code> view and <code class="docutils literal"><span class="pre">feeds.Feed</span></code> class in
<code class="docutils literal"><span class="pre">django.contrib.syndication</span></code> will be removed. The class-based view
<code class="docutils literal"><span class="pre">views.Feed</span></code> should be used instead.</li>
<li><code class="docutils literal"><span class="pre">django.core.context_processors.auth</span></code>. This release will
remove the old method in favor of the new method in
<code class="docutils literal"><span class="pre">django.contrib.auth.context_processors.auth</span></code>.</li>
<li>The <code class="docutils literal"><span class="pre">postgresql</span></code> database backend will be removed, use the
<code class="docutils literal"><span class="pre">postgresql_psycopg2</span></code> backend instead.</li>
<li>The <code class="docutils literal"><span class="pre">no</span></code> language code will be removed and has been replaced by the
<code class="docutils literal"><span class="pre">nb</span></code> language code.</li>
<li>Authentication backends will need to define the boolean attribute
<code class="docutils literal"><span class="pre">supports_inactive_user</span></code> until version 1.5 when it will be assumed that
all backends will handle inactive users.</li>
<li><code class="docutils literal"><span class="pre">django.db.models.fields.XMLField</span></code> 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 <code class="docutils literal"><span class="pre">TextField</span></code> since the removal of <code class="docutils literal"><span class="pre">oldforms</span></code>.
All uses of <code class="docutils literal"><span class="pre">XMLField</span></code> can be replaced with <code class="docutils literal"><span class="pre">TextField</span></code>.</li>
<li>The undocumented <code class="docutils literal"><span class="pre">mixin</span></code> parameter to the <code class="docutils literal"><span class="pre">open()</span></code> method of
<code class="docutils literal"><span class="pre">django.core.files.storage.Storage</span></code> (and subclasses) will be removed.</li>
</ul>
</div>
<div class="section" id="s-deprecation-removed-in-1-3">
<span id="s-id8"></span><span id="deprecation-removed-in-1-3"></span><span id="id8"></span><h2>1.3<a class="headerlink" href="#deprecation-removed-in-1-3" title="Permalink to this headline">¶</a></h2>
<p>See the <a class="reference internal" href="../releases/1.1.html#deprecated-features-1-1"><span class="std std-ref">Django 1.1 release notes</span></a> for more
details on these changes.</p>
<ul class="simple">
<li><code class="docutils literal"><span class="pre">AdminSite.root()</span></code>. This method of hooking up the admin URLs will be
removed in favor of including <code class="docutils literal"><span class="pre">admin.site.urls</span></code>.</li>
<li>Authentication backends need to define the boolean attributes
<code class="docutils literal"><span class="pre">supports_object_permissions</span></code> and <code class="docutils literal"><span class="pre">supports_anonymous_user</span></code> until
version 1.4, at which point it will be assumed that all backends will
support these options.</li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="yui-b" id="sidebar">
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="../contents.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Django Deprecation Timeline</a><ul>
<li><a class="reference internal" href="#deprecation-removed-in-1-10">1.10</a></li>
<li><a class="reference internal" href="#deprecation-removed-in-1-9">1.9</a></li>
<li><a class="reference internal" href="#deprecation-removed-in-1-8">1.8</a></li>
<li><a class="reference internal" href="#deprecation-removed-in-1-7">1.7</a></li>
<li><a class="reference internal" href="#deprecation-removed-in-1-6">1.6</a></li>
<li><a class="reference internal" href="#deprecation-removed-in-1-5">1.5</a></li>
<li><a class="reference internal" href="#deprecation-removed-in-1-4">1.4</a></li>
<li><a class="reference internal" href="#deprecation-removed-in-1-3">1.3</a></li>
</ul>
</li>
</ul>
<h3>Browse</h3>
<ul>
<li>Prev: <a href="release-process.html">Django’s release process</a></li>
<li>Next: <a href="git.html">The Django source code repository</a></li>
</ul>
<h3>You are here:</h3>
<ul>
<li>
<a href="../index.html">Django 1.8.19 documentation</a>
<ul><li><a href="index.html">Django internals</a>
<ul><li>Django Deprecation Timeline</li></ul>
</li></ul>
</li>
</ul>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/internals/deprecation.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="../search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<h3>Last update:</h3>
<p class="topless">Mar 10, 2018</p>
</div>
</div>
<div id="ft">
<div class="nav">
« <a href="release-process.html" title="Django&#8217;s release process">previous</a>
|
<a href="index.html" title="Django internals" accesskey="U">up</a>
|
<a href="git.html" title="The Django source code repository">next</a> »</div>
</div>
</div>
<div class="clearer"></div>
</div>
</body>
</html>
