| 1 |
=========================== |
| 2 |
Django Deprecation Timeline |
| 3 |
=========================== |
| 4 |
|
| 5 |
This document outlines when various pieces of Django will be removed or altered |
| 6 |
in a backward incompatible way, following their deprecation, as per the |
| 7 |
:ref:`deprecation policy <internal-release-deprecation-policy>`. More details |
| 8 |
about each item can often be found in the release notes of two versions prior. |
| 9 |
|
| 10 |
.. _deprecation-removed-in-6.1: |
| 11 |
|
| 12 |
6.1 |
| 13 |
--- |
| 14 |
|
| 15 |
See the :ref:`Django 5.2 release notes <deprecated-features-5.2>` for more |
| 16 |
details on these changes. |
| 17 |
|
| 18 |
* The ``all`` keyword argument of ``django.contrib.staticfiles.finders.find()`` |
| 19 |
will be removed. |
| 20 |
|
| 21 |
* Fallbacks to ``request.user`` and ``request.auser()`` when ``user`` is |
| 22 |
``None`` in ``django.contrib.auth.login()`` and |
| 23 |
``django.contrib.auth.alogin()``, respectively, will be removed. |
| 24 |
|
| 25 |
* The ``ordering`` keyword argument of the PostgreSQL specific aggregation |
| 26 |
functions ``django.contrib.postgres.aggregates.ArrayAgg``, |
| 27 |
``django.contrib.postgres.aggregates.JSONBAgg``, and |
| 28 |
``django.contrib.postgres.aggregates.StringAgg`` will be removed. |
| 29 |
|
| 30 |
* Support for subclasses of ``RemoteUserMiddleware`` that override |
| 31 |
``process_request()`` without overriding ``aprocess_request()`` will be |
| 32 |
removed. |
| 33 |
|
| 34 |
.. _deprecation-removed-in-6.0: |
| 35 |
|
| 36 |
6.0 |
| 37 |
--- |
| 38 |
|
| 39 |
See the :ref:`Django 5.0 release notes <deprecated-features-5.0>` for more |
| 40 |
details on these changes. |
| 41 |
|
| 42 |
* The ``DjangoDivFormRenderer`` and ``Jinja2DivFormRenderer`` transitional form |
| 43 |
renderers will be removed. |
| 44 |
|
| 45 |
* Support for passing positional arguments to ``BaseConstraint`` will be |
| 46 |
removed. |
| 47 |
|
| 48 |
* ``request`` will be required in the signature of |
| 49 |
``ModelAdmin.lookup_allowed()`` subclasses. |
| 50 |
|
| 51 |
* The ``django.db.models.sql.datastructures.Join`` will no longer fallback to |
| 52 |
``get_joining_columns()``. |
| 53 |
|
| 54 |
* The ``get_joining_columns()`` method of ``ForeignObject`` and |
| 55 |
``ForeignObjectRel`` will be removed. |
| 56 |
|
| 57 |
* The ``ForeignObject.get_reverse_joining_columns()`` method will be removed. |
| 58 |
|
| 59 |
* The default scheme for ``forms.URLField`` will change from ``"http"`` to |
| 60 |
``"https"``. |
| 61 |
|
| 62 |
* Support for calling ``format_html()`` without passing args or kwargs will be |
| 63 |
removed. |
| 64 |
|
| 65 |
* Support for ``cx_Oracle`` will be removed. |
| 66 |
|
| 67 |
* ``BaseDatabaseOperations.field_cast_sql()`` will be removed. |
| 68 |
|
| 69 |
* The ``ChoicesMeta`` alias to ``django.db.models.enums.ChoicesType`` will be |
| 70 |
removed. |
| 71 |
|
| 72 |
* The ``Prefetch.get_current_queryset()`` method will be removed. |
| 73 |
|
| 74 |
* The ``get_prefetch_queryset()`` method of related managers and descriptors |
| 75 |
will be removed. |
| 76 |
|
| 77 |
* ``get_prefetcher()`` and ``prefetch_related_objects()`` will no longer |
| 78 |
fallback to ``get_prefetch_queryset()``. |
| 79 |
|
| 80 |
* The ``FORMS_URLFIELD_ASSUME_HTTPS`` transitional setting will be removed. |
| 81 |
|
| 82 |
See the :ref:`Django 5.1 release notes <deprecated-features-5.1>` for more |
| 83 |
details on these changes. |
| 84 |
|
| 85 |
* The ``ModelAdmin.log_deletion()`` and ``LogEntryManager.log_action()`` |
| 86 |
methods will be removed. |
| 87 |
|
| 88 |
* The undocumented ``django.utils.itercompat.is_iterable()`` function and the |
| 89 |
``django.utils.itercompat`` module will be removed. |
| 90 |
|
| 91 |
* The ``django.contrib.gis.geoip2.GeoIP2.coords()`` method will be removed. |
| 92 |
|
| 93 |
* The ``django.contrib.gis.geoip2.GeoIP2.open()`` method will be removed. |
| 94 |
|
| 95 |
* Support for passing positional arguments to ``Model.save()`` and |
| 96 |
``Model.asave()`` will be removed. |
| 97 |
|
| 98 |
* The setter for ``django.contrib.gis.gdal.OGRGeometry.coord_dim`` will be |
| 99 |
removed. |
| 100 |
|
| 101 |
* ``django.urls.register_converter()`` will no longer allow overriding existing |
| 102 |
converters. |
| 103 |
|
| 104 |
* The ``check`` keyword argument of ``CheckConstraint`` will be removed. |
| 105 |
|
| 106 |
* The ``OS_OPEN_FLAGS`` attribute of |
| 107 |
:class:`~django.core.files.storage.FileSystemStorage` will be removed. |
| 108 |
|
| 109 |
* The ``get_cache_name()`` method of ``FieldCacheMixin`` will be removed. |
| 110 |
|
| 111 |
.. _deprecation-removed-in-5.1: |
| 112 |
|
| 113 |
5.1 |
| 114 |
--- |
| 115 |
|
| 116 |
See the :ref:`Django 4.2 release notes <deprecated-features-4.2>` for more |
| 117 |
details on these changes. |
| 118 |
|
| 119 |
* The ``BaseUserManager.make_random_password()`` method will be removed. |
| 120 |
|
| 121 |
* The model's ``Meta.index_together`` option will be removed. |
| 122 |
|
| 123 |
* The ``length_is`` template filter will be removed. |
| 124 |
|
| 125 |
* The ``django.contrib.auth.hashers.SHA1PasswordHasher``, |
| 126 |
``django.contrib.auth.hashers.UnsaltedSHA1PasswordHasher``, and |
| 127 |
``django.contrib.auth.hashers.UnsaltedMD5PasswordHasher`` will be removed. |
| 128 |
|
| 129 |
* The model ``django.contrib.postgres.fields.CICharField``, |
| 130 |
``django.contrib.postgres.fields.CIEmailField``, and |
| 131 |
``django.contrib.postgres.fields.CITextField`` will be removed. Stub fields |
| 132 |
will remain for compatibility with historical migrations. |
| 133 |
|
| 134 |
* The ``django.contrib.postgres.fields.CIText`` mixin will be removed. |
| 135 |
|
| 136 |
* The ``map_width`` and ``map_height`` attributes of ``BaseGeometryWidget`` |
| 137 |
will be removed. |
| 138 |
|
| 139 |
* The ``SimpleTestCase.assertFormsetError()`` method will be removed. |
| 140 |
|
| 141 |
* The ``TransactionTestCase.assertQuerysetEqual()`` method will be removed. |
| 142 |
|
| 143 |
* Support for passing encoded JSON string literals to ``JSONField`` and |
| 144 |
associated lookups and expressions will be removed. |
| 145 |
|
| 146 |
* Support for passing positional arguments to ``Signer`` and |
| 147 |
``TimestampSigner`` will be removed. |
| 148 |
|
| 149 |
* The ``DEFAULT_FILE_STORAGE`` and ``STATICFILES_STORAGE`` settings will be |
| 150 |
removed. |
| 151 |
|
| 152 |
* The ``django.core.files.storage.get_storage_class()`` function will be |
| 153 |
removed. |
| 154 |
|
| 155 |
.. _deprecation-removed-in-5.0: |
| 156 |
|
| 157 |
5.0 |
| 158 |
--- |
| 159 |
|
| 160 |
See the :ref:`Django 4.0 release notes <deprecated-features-4.0>` for more |
| 161 |
details on these changes. |
| 162 |
|
| 163 |
* The ``SERIALIZE`` test setting will be removed. |
| 164 |
|
| 165 |
* The undocumented ``django.utils.baseconv`` module will be removed. |
| 166 |
|
| 167 |
* The undocumented ``django.utils.datetime_safe`` module will be removed. |
| 168 |
|
| 169 |
* The default value of the ``USE_TZ`` setting will change from ``False`` to |
| 170 |
``True``. |
| 171 |
|
| 172 |
* The default sitemap protocol for sitemaps built outside the context of a |
| 173 |
request will change from ``'http'`` to ``'https'``. |
| 174 |
|
| 175 |
* The ``extra_tests`` argument for ``DiscoverRunner.build_suite()`` and |
| 176 |
``DiscoverRunner.run_tests()`` will be removed. |
| 177 |
|
| 178 |
* The ``django.contrib.postgres.aggregates.ArrayAgg``, ``JSONBAgg``, and |
| 179 |
``StringAgg`` aggregates will return ``None`` when there are no rows instead |
| 180 |
of ``[]``, ``[]``, and ``''`` respectively. |
| 181 |
|
| 182 |
* The ``USE_L10N`` setting will be removed. |
| 183 |
|
| 184 |
* The ``USE_DEPRECATED_PYTZ`` transitional setting will be removed. |
| 185 |
|
| 186 |
* Support for ``pytz`` timezones will be removed. |
| 187 |
|
| 188 |
* The ``is_dst`` argument will be removed from: |
| 189 |
|
| 190 |
* ``QuerySet.datetimes()`` |
| 191 |
* ``django.utils.timezone.make_aware()`` |
| 192 |
* ``django.db.models.functions.Trunc()`` |
| 193 |
* ``django.db.models.functions.TruncSecond()`` |
| 194 |
* ``django.db.models.functions.TruncMinute()`` |
| 195 |
* ``django.db.models.functions.TruncHour()`` |
| 196 |
* ``django.db.models.functions.TruncDay()`` |
| 197 |
* ``django.db.models.functions.TruncWeek()`` |
| 198 |
* ``django.db.models.functions.TruncMonth()`` |
| 199 |
* ``django.db.models.functions.TruncQuarter()`` |
| 200 |
* ``django.db.models.functions.TruncYear()`` |
| 201 |
|
| 202 |
* The ``django.contrib.gis.admin.GeoModelAdmin`` and ``OSMGeoAdmin`` classes |
| 203 |
will be removed. |
| 204 |
|
| 205 |
* The undocumented ``BaseForm._html_output()`` method will be removed. |
| 206 |
|
| 207 |
* The ability to return a ``str``, rather than a ``SafeString``, when rendering |
| 208 |
an ``ErrorDict`` and ``ErrorList`` will be removed. |
| 209 |
|
| 210 |
See the :ref:`Django 4.1 release notes <deprecated-features-4.1>` for more |
| 211 |
details on these changes. |
| 212 |
|
| 213 |
* The ``SitemapIndexItem.__str__()`` method will be removed. |
| 214 |
|
| 215 |
* The ``CSRF_COOKIE_MASKED`` transitional setting will be removed. |
| 216 |
|
| 217 |
* The ``name`` argument of ``django.utils.functional.cached_property()`` will |
| 218 |
be removed. |
| 219 |
|
| 220 |
* The ``opclasses`` argument of |
| 221 |
``django.contrib.postgres.constraints.ExclusionConstraint`` will be removed. |
| 222 |
|
| 223 |
* The undocumented ability to pass ``errors=None`` to |
| 224 |
``SimpleTestCase.assertFormError()`` and ``assertFormsetError()`` will be |
| 225 |
removed. |
| 226 |
|
| 227 |
* ``django.contrib.sessions.serializers.PickleSerializer`` will be removed. |
| 228 |
|
| 229 |
* The usage of ``QuerySet.iterator()`` on a queryset that prefetches related |
| 230 |
objects without providing the ``chunk_size`` argument will no longer be |
| 231 |
allowed. |
| 232 |
|
| 233 |
* Passing unsaved model instances to related filters will no longer be allowed. |
| 234 |
|
| 235 |
* ``created=True`` will be required in the signature of |
| 236 |
``RemoteUserBackend.configure_user()`` subclasses. |
| 237 |
|
| 238 |
* Support for logging out via ``GET`` requests in the |
| 239 |
``django.contrib.auth.views.LogoutView`` and |
| 240 |
``django.contrib.auth.views.logout_then_login()`` will be removed. |
| 241 |
|
| 242 |
* The ``django.utils.timezone.utc`` alias to ``datetime.timezone.utc`` will be |
| 243 |
removed. |
| 244 |
|
| 245 |
* Passing a response object and a form/formset name to |
| 246 |
``SimpleTestCase.assertFormError()`` and ``assertFormsetError()`` will no |
| 247 |
longer be allowed. |
| 248 |
|
| 249 |
* The ``django.contrib.gis.admin.OpenLayersWidget`` will be removed. |
| 250 |
|
| 251 |
* The ``django.contrib.auth.hashers.CryptPasswordHasher`` will be removed. |
| 252 |
|
| 253 |
* The ``"django/forms/default.html"`` and |
| 254 |
``"django/forms/formsets/default.html"`` templates will be removed. |
| 255 |
|
| 256 |
* The ability to pass ``nulls_first=False`` or ``nulls_last=False`` to |
| 257 |
``Expression.asc()`` and ``Expression.desc()`` methods, and the ``OrderBy`` |
| 258 |
expression will be removed. |
| 259 |
|
| 260 |
.. _deprecation-removed-in-4.1: |
| 261 |
|
| 262 |
4.1 |
| 263 |
--- |
| 264 |
|
| 265 |
See the :ref:`Django 3.2 release notes <deprecated-features-3.2>` for more |
| 266 |
details on these changes. |
| 267 |
|
| 268 |
* Support for assigning objects which don't support creating deep copies with |
| 269 |
``copy.deepcopy()`` to class attributes in ``TestCase.setUpTestData()`` will |
| 270 |
be removed. |
| 271 |
|
| 272 |
* ``BaseCommand.requires_system_checks`` won't support boolean values. |
| 273 |
|
| 274 |
* The ``whitelist`` argument and ``domain_whitelist`` attribute of |
| 275 |
``django.core.validators.EmailValidator`` will be removed. |
| 276 |
|
| 277 |
* The ``default_app_config`` module variable will be removed. |
| 278 |
|
| 279 |
* ``TransactionTestCase.assertQuerysetEqual()`` will no longer automatically |
| 280 |
call ``repr()`` on a queryset when compared to string values. |
| 281 |
|
| 282 |
* ``django.core.cache.backends.memcached.MemcachedCache`` will be removed. |
| 283 |
|
| 284 |
* Support for the pre-Django 3.2 format of messages used by |
| 285 |
``django.contrib.messages.storage.cookie.CookieStorage`` will be removed. |
| 286 |
|
| 287 |
.. _deprecation-removed-in-4.0: |
| 288 |
|
| 289 |
4.0 |
| 290 |
--- |
| 291 |
|
| 292 |
See the :ref:`Django 3.0 release notes <deprecated-features-3.0>` for more |
| 293 |
details on these changes. |
| 294 |
|
| 295 |
* ``django.utils.http.urlquote()``, ``urlquote_plus()``, ``urlunquote()``, and |
| 296 |
``urlunquote_plus()`` will be removed. |
| 297 |
|
| 298 |
* ``django.utils.encoding.force_text()`` and ``smart_text()`` will be removed. |
| 299 |
|
| 300 |
* ``django.utils.translation.ugettext()``, ``ugettext_lazy()``, |
| 301 |
``ugettext_noop()``, ``ungettext()``, and ``ungettext_lazy()`` will be |
| 302 |
removed. |
| 303 |
|
| 304 |
* ``django.views.i18n.set_language()`` will no longer set the user language in |
| 305 |
``request.session`` (key ``django.utils.translation.LANGUAGE_SESSION_KEY``). |
| 306 |
|
| 307 |
* ``alias=None`` will be required in the signature of |
| 308 |
``django.db.models.Expression.get_group_by_cols()`` subclasses. |
| 309 |
|
| 310 |
* ``django.utils.text.unescape_entities()`` will be removed. |
| 311 |
|
| 312 |
* ``django.utils.http.is_safe_url()`` will be removed. |
| 313 |
|
| 314 |
See the :ref:`Django 3.1 release notes <deprecated-features-3.1>` for more |
| 315 |
details on these changes. |
| 316 |
|
| 317 |
* The ``PASSWORD_RESET_TIMEOUT_DAYS`` setting will be removed. |
| 318 |
|
| 319 |
* The undocumented usage of the :lookup:`isnull` lookup with non-boolean values |
| 320 |
as the right-hand side will no longer be allowed. |
| 321 |
|
| 322 |
* The ``django.db.models.query_utils.InvalidQuery`` exception class will be |
| 323 |
removed. |
| 324 |
|
| 325 |
* The ``django-admin.py`` entry point will be removed. |
| 326 |
|
| 327 |
* The ``HttpRequest.is_ajax()`` method will be removed. |
| 328 |
|
| 329 |
* Support for the pre-Django 3.1 encoding format of cookies values used by |
| 330 |
``django.contrib.messages.storage.cookie.CookieStorage`` will be removed. |
| 331 |
|
| 332 |
* Support for the pre-Django 3.1 password reset tokens in the admin site (that |
| 333 |
use the SHA-1 hashing algorithm) will be removed. |
| 334 |
|
| 335 |
* Support for the pre-Django 3.1 encoding format of sessions will be removed. |
| 336 |
|
| 337 |
* Support for the pre-Django 3.1 ``django.core.signing.Signer`` signatures |
| 338 |
(encoded with the SHA-1 algorithm) will be removed. |
| 339 |
|
| 340 |
* Support for the pre-Django 3.1 ``django.core.signing.dumps()`` signatures |
| 341 |
(encoded with the SHA-1 algorithm) in ``django.core.signing.loads()`` will be |
| 342 |
removed. |
| 343 |
|
| 344 |
* Support for the pre-Django 3.1 user sessions (that use the SHA-1 algorithm) |
| 345 |
will be removed. |
| 346 |
|
| 347 |
* The ``get_response`` argument for |
| 348 |
``django.utils.deprecation.MiddlewareMixin.__init__()`` will be required and |
| 349 |
won't accept ``None``. |
| 350 |
|
| 351 |
* The ``providing_args`` argument for ``django.dispatch.Signal`` will be |
| 352 |
removed. |
| 353 |
|
| 354 |
* The ``length`` argument for ``django.utils.crypto.get_random_string()`` will |
| 355 |
be required. |
| 356 |
|
| 357 |
* The ``list`` message for ``ModelMultipleChoiceField`` will be removed. |
| 358 |
|
| 359 |
* Support for passing raw column aliases to ``QuerySet.order_by()`` will be |
| 360 |
removed. |
| 361 |
|
| 362 |
* The model ``NullBooleanField`` will be removed. A stub field will remain for |
| 363 |
compatibility with historical migrations. |
| 364 |
|
| 365 |
* ``django.conf.urls.url()`` will be removed. |
| 366 |
|
| 367 |
* The model ``django.contrib.postgres.fields.JSONField`` will be removed. A |
| 368 |
stub field will remain for compatibility with historical migrations. |
| 369 |
|
| 370 |
* ``django.contrib.postgres.forms.JSONField``, |
| 371 |
``django.contrib.postgres.fields.jsonb.KeyTransform``, and |
| 372 |
``django.contrib.postgres.fields.jsonb.KeyTextTransform`` will be removed. |
| 373 |
|
| 374 |
* The ``{% ifequal %}`` and ``{% ifnotequal %}`` template tags will be removed. |
| 375 |
|
| 376 |
* The ``DEFAULT_HASHING_ALGORITHM`` transitional setting will be removed. |
| 377 |
|
| 378 |
.. _deprecation-removed-in-3.1: |
| 379 |
|
| 380 |
3.1 |
| 381 |
--- |
| 382 |
|
| 383 |
See the :ref:`Django 2.2 release notes <deprecated-features-2.2>` for more |
| 384 |
details on these changes. |
| 385 |
|
| 386 |
* ``django.utils.timezone.FixedOffset`` will be removed. |
| 387 |
|
| 388 |
* ``django.core.paginator.QuerySetPaginator`` will be removed. |
| 389 |
|
| 390 |
* A model's ``Meta.ordering`` will no longer affect ``GROUP BY`` queries. |
| 391 |
|
| 392 |
* ``django.contrib.postgres.fields.FloatRangeField`` and |
| 393 |
``django.contrib.postgres.forms.FloatRangeField`` will be removed. |
| 394 |
|
| 395 |
* The ``FILE_CHARSET`` setting will be removed. |
| 396 |
|
| 397 |
* ``django.contrib.staticfiles.storage.CachedStaticFilesStorage`` will be |
| 398 |
removed. |
| 399 |
|
| 400 |
* ``RemoteUserBackend.configure_user()`` will require ``request`` as the first |
| 401 |
positional argument. |
| 402 |
|
| 403 |
* Support for ``SimpleTestCase.allow_database_queries`` and |
| 404 |
``TransactionTestCase.multi_db`` will be removed. |
| 405 |
|
| 406 |
.. _deprecation-removed-in-3.0: |
| 407 |
|
| 408 |
3.0 |
| 409 |
--- |
| 410 |
|
| 411 |
See the :ref:`Django 2.0 release notes<deprecated-features-2.0>` for more |
| 412 |
details on these changes. |
| 413 |
|
| 414 |
* The ``django.db.backends.postgresql_psycopg2`` module will be removed. |
| 415 |
|
| 416 |
* ``django.shortcuts.render_to_response()`` will be removed. |
| 417 |
|
| 418 |
* The ``DEFAULT_CONTENT_TYPE`` setting will be removed. |
| 419 |
|
| 420 |
* ``HttpRequest.xreadlines()`` will be removed. |
| 421 |
|
| 422 |
* Support for the ``context`` argument of ``Field.from_db_value()`` and |
| 423 |
``Expression.convert_value()`` will be removed. |
| 424 |
|
| 425 |
* The ``field_name`` keyword argument of ``QuerySet.earliest()`` and |
| 426 |
``latest()`` will be removed. |
| 427 |
|
| 428 |
See the :ref:`Django 2.1 release notes <deprecated-features-2.1>` for more |
| 429 |
details on these changes. |
| 430 |
|
| 431 |
* ``django.contrib.gis.db.models.functions.ForceRHR`` will be removed. |
| 432 |
|
| 433 |
* ``django.utils.http.cookie_date()`` will be removed. |
| 434 |
|
| 435 |
* The ``staticfiles`` and ``admin_static`` template tag libraries will be |
| 436 |
removed. |
| 437 |
|
| 438 |
* ``django.contrib.staticfiles.templatetags.static()`` will be removed. |
| 439 |
|
| 440 |
* The shim to allow ``InlineModelAdmin.has_add_permission()`` to be defined |
| 441 |
without an ``obj`` argument will be removed. |
| 442 |
|
| 443 |
.. _deprecation-removed-in-2.1: |
| 444 |
|
| 445 |
2.1 |
| 446 |
--- |
| 447 |
|
| 448 |
See the :ref:`Django 1.11 release notes<deprecated-features-1.11>` for more |
| 449 |
details on these changes. |
| 450 |
|
| 451 |
* ``contrib.auth.views.login()``, ``logout()``, ``password_change()``, |
| 452 |
``password_change_done()``, ``password_reset()``, ``password_reset_done()``, |
| 453 |
``password_reset_confirm()``, and ``password_reset_complete()`` will be |
| 454 |
removed. |
| 455 |
|
| 456 |
* The ``extra_context`` parameter of ``contrib.auth.views.logout_then_login()`` |
| 457 |
will be removed. |
| 458 |
|
| 459 |
* ``django.test.runner.setup_databases()`` will be removed. |
| 460 |
|
| 461 |
* ``django.utils.translation.string_concat()`` will be removed. |
| 462 |
|
| 463 |
* ``django.core.cache.backends.memcached.PyLibMCCache`` will no longer support |
| 464 |
passing ``pylibmc`` behavior settings as top-level attributes of ``OPTIONS``. |
| 465 |
|
| 466 |
* The ``host`` parameter of ``django.utils.http.is_safe_url()`` will be |
| 467 |
removed. |
| 468 |
|
| 469 |
* Silencing of exceptions raised while rendering the ``{% include %}`` template |
| 470 |
tag will be removed. |
| 471 |
|
| 472 |
* ``DatabaseIntrospection.get_indexes()`` will be removed. |
| 473 |
|
| 474 |
* The ``authenticate()`` method of authentication backends will require |
| 475 |
``request`` as the first positional argument. |
| 476 |
|
| 477 |
* The ``django.db.models.permalink()`` decorator will be removed. |
| 478 |
|
| 479 |
* The ``USE_ETAGS`` setting will be removed. ``CommonMiddleware`` and |
| 480 |
``django.utils.cache.patch_response_headers()`` will no longer set ETags. |
| 481 |
|
| 482 |
* The ``Model._meta.has_auto_field`` attribute will be removed. |
| 483 |
|
| 484 |
* ``url()``'s support for inline flags in regular expression groups (``(?i)``, |
| 485 |
``(?L)``, ``(?m)``, ``(?s)``, and ``(?u)``) will be removed. |
| 486 |
|
| 487 |
* Support for ``Widget.render()`` methods without the ``renderer`` argument |
| 488 |
will be removed. |
| 489 |
|
| 490 |
.. _deprecation-removed-in-2.0: |
| 491 |
|
| 492 |
2.0 |
| 493 |
--- |
| 494 |
|
| 495 |
See the :ref:`Django 1.9 release notes<deprecated-features-1.9>` for more |
| 496 |
details on these changes. |
| 497 |
|
| 498 |
* The ``weak`` argument to ``django.dispatch.signals.Signal.disconnect()`` will |
| 499 |
be removed. |
| 500 |
|
| 501 |
* ``django.db.backends.base.BaseDatabaseOperations.check_aggregate_support()`` |
| 502 |
will be removed. |
| 503 |
|
| 504 |
* The ``django.forms.extras`` package will be removed. |
| 505 |
|
| 506 |
* The ``assignment_tag`` helper will be removed. |
| 507 |
|
| 508 |
* The ``host`` argument to ``assertsRedirects`` will be removed. The |
| 509 |
compatibility layer which allows absolute URLs to be considered equal to |
| 510 |
relative ones when the path is identical will also be removed. |
| 511 |
|
| 512 |
* ``Field.rel`` will be removed. |
| 513 |
|
| 514 |
* ``Field.remote_field.to`` attribute will be removed. |
| 515 |
|
| 516 |
* The ``on_delete`` argument for ``ForeignKey`` and ``OneToOneField`` will be |
| 517 |
required. |
| 518 |
|
| 519 |
* ``django.db.models.fields.add_lazy_relation()`` will be removed. |
| 520 |
|
| 521 |
* When time zone support is enabled, database backends that don't support time |
| 522 |
zones won't convert aware datetimes to naive values in UTC anymore when such |
| 523 |
values are passed as parameters to SQL queries executed outside of the ORM, |
| 524 |
e.g. with ``cursor.execute()``. |
| 525 |
|
| 526 |
* The ``django.contrib.auth.tests.utils.skipIfCustomUser()`` decorator will be |
| 527 |
removed. |
| 528 |
|
| 529 |
* The ``GeoManager`` and ``GeoQuerySet`` classes will be removed. |
| 530 |
|
| 531 |
* The ``django.contrib.gis.geoip`` module will be removed. |
| 532 |
|
| 533 |
* The ``supports_recursion`` check for template loaders will be removed from: |
| 534 |
|
| 535 |
* ``django.template.engine.Engine.find_template()`` |
| 536 |
* ``django.template.loader_tags.ExtendsNode.find_template()`` |
| 537 |
* ``django.template.loaders.base.Loader.supports_recursion()`` |
| 538 |
* ``django.template.loaders.cached.Loader.supports_recursion()`` |
| 539 |
|
| 540 |
* The ``load_template()`` and ``load_template_sources()`` template loader |
| 541 |
methods will be removed. |
| 542 |
|
| 543 |
* The ``template_dirs`` argument for template loaders will be removed: |
| 544 |
|
| 545 |
* ``django.template.loaders.base.Loader.get_template()`` |
| 546 |
* ``django.template.loaders.cached.Loader.cache_key()`` |
| 547 |
* ``django.template.loaders.cached.Loader.get_template()`` |
| 548 |
* ``django.template.loaders.cached.Loader.get_template_sources()`` |
| 549 |
* ``django.template.loaders.filesystem.Loader.get_template_sources()`` |
| 550 |
|
| 551 |
* The ``django.template.loaders.base.Loader.__call__()`` method will be |
| 552 |
removed. |
| 553 |
|
| 554 |
* Support for custom error views with a single positional parameter will be |
| 555 |
dropped. |
| 556 |
|
| 557 |
* The ``mime_type`` attribute of ``django.utils.feedgenerator.Atom1Feed`` and |
| 558 |
``django.utils.feedgenerator.RssFeed`` will be removed in favor of |
| 559 |
``content_type``. |
| 560 |
|
| 561 |
* The ``app_name`` argument to ``django.conf.urls.include()`` will be |
| 562 |
removed. |
| 563 |
|
| 564 |
* Support for passing a 3-tuple as the first argument to ``include()`` will |
| 565 |
be removed. |
| 566 |
|
| 567 |
* Support for setting a URL instance namespace without an application |
| 568 |
namespace will be removed. |
| 569 |
|
| 570 |
* ``Field._get_val_from_obj()`` will be removed in favor of |
| 571 |
``Field.value_from_object()``. |
| 572 |
|
| 573 |
* ``django.template.loaders.eggs.Loader`` will be removed. |
| 574 |
|
| 575 |
* The ``current_app`` parameter to the ``contrib.auth`` views will be removed. |
| 576 |
|
| 577 |
* The ``callable_obj`` keyword argument to |
| 578 |
``SimpleTestCase.assertRaisesMessage()`` will be removed. |
| 579 |
|
| 580 |
* Support for the ``allow_tags`` attribute on ``ModelAdmin`` methods will be |
| 581 |
removed. |
| 582 |
|
| 583 |
* The ``enclosure`` keyword argument to ``SyndicationFeed.add_item()`` will be |
| 584 |
removed. |
| 585 |
|
| 586 |
* The ``django.template.loader.LoaderOrigin`` and |
| 587 |
``django.template.base.StringOrigin`` aliases for |
| 588 |
``django.template.base.Origin`` will be removed. |
| 589 |
|
| 590 |
See the :ref:`Django 1.10 release notes <deprecated-features-1.10>` for more |
| 591 |
details on these changes. |
| 592 |
|
| 593 |
* The ``makemigrations --exit`` option will be removed. |
| 594 |
|
| 595 |
* Support for direct assignment to a reverse foreign key or many-to-many |
| 596 |
relation will be removed. |
| 597 |
|
| 598 |
* The ``get_srid()`` and ``set_srid()`` methods of |
| 599 |
``django.contrib.gis.geos.GEOSGeometry`` will be removed. |
| 600 |
|
| 601 |
* The ``get_x()``, ``set_x()``, ``get_y()``, ``set_y()``, ``get_z()``, and |
| 602 |
``set_z()`` methods of ``django.contrib.gis.geos.Point`` will be removed. |
| 603 |
|
| 604 |
* The ``get_coords()`` and ``set_coords()`` methods of |
| 605 |
``django.contrib.gis.geos.Point`` will be removed. |
| 606 |
|
| 607 |
* The ``cascaded_union`` property of ``django.contrib.gis.geos.MultiPolygon`` |
| 608 |
will be removed. |
| 609 |
|
| 610 |
* ``django.utils.functional.allow_lazy()`` will be removed. |
| 611 |
|
| 612 |
* The ``shell --plain`` option will be removed. |
| 613 |
|
| 614 |
* The ``django.core.urlresolvers`` module will be removed. |
| 615 |
|
| 616 |
* The model ``CommaSeparatedIntegerField`` will be removed. A stub field will |
| 617 |
remain for compatibility with historical migrations. |
| 618 |
|
| 619 |
* Support for the template ``Context.has_key()`` method will be removed. |
| 620 |
|
| 621 |
* Support for the ``django.core.files.storage.Storage.accessed_time()``, |
| 622 |
``created_time()``, and ``modified_time()`` methods will be removed. |
| 623 |
|
| 624 |
* Support for query lookups using the model name when |
| 625 |
``Meta.default_related_name`` is set will be removed. |
| 626 |
|
| 627 |
* The ``__search`` query lookup and the |
| 628 |
``DatabaseOperations.fulltext_search_sql()`` method will be removed. |
| 629 |
|
| 630 |
* The shim for supporting custom related manager classes without a |
| 631 |
``_apply_rel_filters()`` method will be removed. |
| 632 |
|
| 633 |
* Using ``User.is_authenticated()`` and ``User.is_anonymous()`` as methods |
| 634 |
will no longer be supported. |
| 635 |
|
| 636 |
* The private attribute ``virtual_fields`` of ``Model._meta`` will be removed. |
| 637 |
|
| 638 |
* The private keyword arguments ``virtual_only`` in |
| 639 |
``Field.contribute_to_class()`` and ``virtual`` in |
| 640 |
``Model._meta.add_field()`` will be removed. |
| 641 |
|
| 642 |
* The ``javascript_catalog()`` and ``json_catalog()`` views will be removed. |
| 643 |
|
| 644 |
* The ``django.contrib.gis.utils.precision_wkt()`` function will be removed. |
| 645 |
|
| 646 |
* In multi-table inheritance, implicit promotion of a ``OneToOneField`` to a |
| 647 |
``parent_link`` will be removed. |
| 648 |
|
| 649 |
* Support for ``Widget._format_value()`` will be removed. |
| 650 |
|
| 651 |
* ``FileField`` methods ``get_directory_name()`` and ``get_filename()`` will be |
| 652 |
removed. |
| 653 |
|
| 654 |
* The ``mark_for_escaping()`` function and the classes it uses: ``EscapeData``, |
| 655 |
``EscapeBytes``, ``EscapeText``, ``EscapeString``, and ``EscapeUnicode`` will |
| 656 |
be removed. |
| 657 |
|
| 658 |
* The ``escape`` filter will change to use |
| 659 |
``django.utils.html.conditional_escape()``. |
| 660 |
|
| 661 |
* ``Manager.use_for_related_fields`` will be removed. |
| 662 |
|
| 663 |
* Model ``Manager`` inheritance will follow MRO inheritance rules and the |
| 664 |
``Meta.manager_inheritance_from_future`` to opt-in to this behavior will be |
| 665 |
removed. |
| 666 |
|
| 667 |
* Support for old-style middleware using ``settings.MIDDLEWARE_CLASSES`` will |
| 668 |
be removed. |
| 669 |
|
| 670 |
.. _deprecation-removed-in-1.10: |
| 671 |
|
| 672 |
1.10 |
| 673 |
---- |
| 674 |
|
| 675 |
See the :ref:`Django 1.8 release notes<deprecated-features-1.8>` for more |
| 676 |
details on these changes. |
| 677 |
|
| 678 |
* Support for calling a ``SQLCompiler`` directly as an alias for calling its |
| 679 |
``quote_name_unless_alias`` method will be removed. |
| 680 |
|
| 681 |
* ``cycle`` and ``firstof`` template tags will be removed from the ``future`` |
| 682 |
template tag library (used during the 1.6/1.7 deprecation period). |
| 683 |
|
| 684 |
* ``django.conf.urls.patterns()`` will be removed. |
| 685 |
|
| 686 |
* Support for the ``prefix`` argument to |
| 687 |
``django.conf.urls.i18n.i18n_patterns()`` will be removed. |
| 688 |
|
| 689 |
* ``SimpleTestCase.urls`` will be removed. |
| 690 |
|
| 691 |
* Using an incorrect count of unpacked values in the ``for`` template tag |
| 692 |
will raise an exception rather than fail silently. |
| 693 |
|
| 694 |
* The ability to reverse URLs using a dotted Python path will be removed. |
| 695 |
|
| 696 |
* The ability to use a dotted Python path for the ``LOGIN_URL`` and |
| 697 |
``LOGIN_REDIRECT_URL`` settings will be removed. |
| 698 |
|
| 699 |
* Support for :py:mod:`optparse` will be dropped for custom management commands |
| 700 |
(replaced by :py:mod:`argparse`). |
| 701 |
|
| 702 |
* The class ``django.core.management.NoArgsCommand`` will be removed. Use |
| 703 |
:class:`~django.core.management.BaseCommand` instead, which takes no arguments |
| 704 |
by default. |
| 705 |
|
| 706 |
* ``django.core.context_processors`` module will be removed. |
| 707 |
|
| 708 |
* ``django.db.models.sql.aggregates`` module will be removed. |
| 709 |
|
| 710 |
* ``django.contrib.gis.db.models.sql.aggregates`` module will be removed. |
| 711 |
|
| 712 |
* The following methods and properties of ``django.db.sql.query.Query`` will |
| 713 |
be removed: |
| 714 |
|
| 715 |
* Properties: ``aggregates`` and ``aggregate_select`` |
| 716 |
* Methods: ``add_aggregate``, ``set_aggregate_mask``, and |
| 717 |
``append_aggregate_mask``. |
| 718 |
|
| 719 |
* ``django.template.resolve_variable`` will be removed. |
| 720 |
|
| 721 |
* The following private APIs will be removed from |
| 722 |
:class:`django.db.models.options.Options` (``Model._meta``): |
| 723 |
|
| 724 |
* ``get_field_by_name()`` |
| 725 |
* ``get_all_field_names()`` |
| 726 |
* ``get_fields_with_model()`` |
| 727 |
* ``get_concrete_fields_with_model()`` |
| 728 |
* ``get_m2m_with_model()`` |
| 729 |
* ``get_all_related_objects()`` |
| 730 |
* ``get_all_related_objects_with_model()`` |
| 731 |
* ``get_all_related_many_to_many_objects()`` |
| 732 |
* ``get_all_related_m2m_objects_with_model()`` |
| 733 |
|
| 734 |
* The ``error_message`` argument of ``django.forms.RegexField`` will be removed. |
| 735 |
|
| 736 |
* The ``unordered_list`` filter will no longer support old style lists. |
| 737 |
|
| 738 |
* Support for string ``view`` arguments to ``url()`` will be removed. |
| 739 |
|
| 740 |
* The backward compatible shim to rename ``django.forms.Form._has_changed()`` |
| 741 |
to ``has_changed()`` will be removed. |
| 742 |
|
| 743 |
* The ``removetags`` template filter will be removed. |
| 744 |
|
| 745 |
* The ``remove_tags()`` and ``strip_entities()`` functions in |
| 746 |
``django.utils.html`` will be removed. |
| 747 |
|
| 748 |
* The ``is_admin_site`` argument to |
| 749 |
``django.contrib.auth.views.password_reset()`` will be removed. |
| 750 |
|
| 751 |
* ``django.db.models.field.subclassing.SubfieldBase`` will be removed. |
| 752 |
|
| 753 |
* ``django.utils.checksums`` will be removed; its functionality is included |
| 754 |
in ``django-localflavor`` 1.1+. |
| 755 |
|
| 756 |
* The ``original_content_type_id`` attribute on |
| 757 |
``django.contrib.admin.helpers.InlineAdminForm`` will be removed. |
| 758 |
|
| 759 |
* The backwards compatibility shim to allow ``FormMixin.get_form()`` to be |
| 760 |
defined with no default value for its ``form_class`` argument will be removed. |
| 761 |
|
| 762 |
* The following settings will be removed: |
| 763 |
|
| 764 |
* ``ALLOWED_INCLUDE_ROOTS`` |
| 765 |
* ``TEMPLATE_CONTEXT_PROCESSORS`` |
| 766 |
* ``TEMPLATE_DEBUG`` |
| 767 |
* ``TEMPLATE_DIRS`` |
| 768 |
* ``TEMPLATE_LOADERS`` |
| 769 |
* ``TEMPLATE_STRING_IF_INVALID`` |
| 770 |
|
| 771 |
* The backwards compatibility alias ``django.template.loader.BaseLoader`` will |
| 772 |
be removed. |
| 773 |
|
| 774 |
* Django template objects returned by |
| 775 |
:func:`~django.template.loader.get_template` and |
| 776 |
:func:`~django.template.loader.select_template` won't accept a |
| 777 |
:class:`~django.template.Context` in their |
| 778 |
:meth:`~django.template.backends.base.Template.render()` method anymore. |
| 779 |
|
| 780 |
* :doc:`Template response APIs </ref/template-response>` will enforce the use |
| 781 |
of :class:`dict` and backend-dependent template objects instead of |
| 782 |
:class:`~django.template.Context` and :class:`~django.template.Template` |
| 783 |
respectively. |
| 784 |
|
| 785 |
* The ``current_app`` parameter for the following function and classes will be |
| 786 |
removed: |
| 787 |
|
| 788 |
* ``django.shortcuts.render()`` |
| 789 |
* ``django.template.Context()`` |
| 790 |
* ``django.template.RequestContext()`` |
| 791 |
* ``django.template.response.TemplateResponse()`` |
| 792 |
|
| 793 |
* The ``dictionary`` and ``context_instance`` parameters for the following |
| 794 |
functions will be removed: |
| 795 |
|
| 796 |
* ``django.shortcuts.render()`` |
| 797 |
* ``django.shortcuts.render_to_response()`` |
| 798 |
* ``django.template.loader.render_to_string()`` |
| 799 |
|
| 800 |
* The ``dirs`` parameter for the following functions will be removed: |
| 801 |
|
| 802 |
* ``django.template.loader.get_template()`` |
| 803 |
* ``django.template.loader.select_template()`` |
| 804 |
* ``django.shortcuts.render()`` |
| 805 |
* ``django.shortcuts.render_to_response()`` |
| 806 |
|
| 807 |
* Session verification will be enabled regardless of whether or not |
| 808 |
``'django.contrib.auth.middleware.SessionAuthenticationMiddleware'`` is in |
| 809 |
``MIDDLEWARE_CLASSES``. |
| 810 |
|
| 811 |
* Private attribute ``django.db.models.Field.related`` will be removed. |
| 812 |
|
| 813 |
* The ``--list`` option of the ``migrate`` management command will be removed. |
| 814 |
|
| 815 |
* The ``ssi`` template tag will be removed. |
| 816 |
|
| 817 |
* Support for the ``=`` comparison operator in the ``if`` template tag will be |
| 818 |
removed. |
| 819 |
|
| 820 |
* The backwards compatibility shims to allow ``Storage.get_available_name()`` |
| 821 |
and ``Storage.save()`` to be defined without a ``max_length`` argument will |
| 822 |
be removed. |
| 823 |
|
| 824 |
* Support for the legacy ``%(<foo>)s`` syntax in ``ModelFormMixin.success_url`` |
| 825 |
will be removed. |
| 826 |
|
| 827 |
* ``GeoQuerySet`` aggregate methods ``collect()``, ``extent()``, ``extent3d()``, |
| 828 |
``make_line()``, and ``unionagg()`` will be removed. |
| 829 |
|
| 830 |
* Ability to specify ``ContentType.name`` when creating a content type instance |
| 831 |
will be removed. |
| 832 |
|
| 833 |
* Support for the old signature of ``allow_migrate`` will be removed. It changed |
| 834 |
from ``allow_migrate(self, db, model)`` to |
| 835 |
``allow_migrate(self, db, app_label, model_name=None, **hints)``. |
| 836 |
|
| 837 |
* Support for the syntax of ``{% cycle %}`` that uses comma-separated arguments |
| 838 |
will be removed. |
| 839 |
|
| 840 |
* The warning that :class:`~django.core.signing.Signer` issues when given an |
| 841 |
invalid separator will become an exception. |
| 842 |
|
| 843 |
.. _deprecation-removed-in-1.9: |
| 844 |
|
| 845 |
1.9 |
| 846 |
--- |
| 847 |
|
| 848 |
See the :ref:`Django 1.7 release notes<deprecated-features-1.7>` for more |
| 849 |
details on these changes. |
| 850 |
|
| 851 |
* ``django.utils.dictconfig`` will be removed. |
| 852 |
|
| 853 |
* ``django.utils.importlib`` will be removed. |
| 854 |
|
| 855 |
* ``django.utils.tzinfo`` will be removed. |
| 856 |
|
| 857 |
* ``django.utils.unittest`` will be removed. |
| 858 |
|
| 859 |
* The ``syncdb`` command will be removed. |
| 860 |
|
| 861 |
* ``django.db.models.signals.pre_syncdb`` and |
| 862 |
``django.db.models.signals.post_syncdb`` will be removed. |
| 863 |
|
| 864 |
* ``allow_syncdb`` on database routers will no longer automatically become |
| 865 |
``allow_migrate``. |
| 866 |
|
| 867 |
* Automatic syncing of apps without migrations will be removed. Migrations will |
| 868 |
become compulsory for all apps unless you pass the ``--run-syncdb`` option to |
| 869 |
``migrate``. |
| 870 |
|
| 871 |
* The SQL management commands for apps without migrations, ``sql``, ``sqlall``, |
| 872 |
``sqlclear``, ``sqldropindexes``, and ``sqlindexes``, will be removed. |
| 873 |
|
| 874 |
* Support for automatic loading of ``initial_data`` fixtures and initial SQL |
| 875 |
data will be removed. |
| 876 |
|
| 877 |
* All models will need to be defined inside an installed application or |
| 878 |
declare an explicit :attr:`~django.db.models.Options.app_label`. |
| 879 |
Furthermore, it won't be possible to import them before their application |
| 880 |
is loaded. In particular, it won't be possible to import models inside |
| 881 |
the root package of their application. |
| 882 |
|
| 883 |
* The model and form ``IPAddressField`` will be removed. A stub field will |
| 884 |
remain for compatibility with historical migrations. |
| 885 |
|
| 886 |
* ``AppCommand.handle_app()`` will no longer be supported. |
| 887 |
|
| 888 |
* ``RequestSite`` and ``get_current_site()`` will no longer be importable from |
| 889 |
``django.contrib.sites.models``. |
| 890 |
|
| 891 |
* FastCGI support via the ``runfcgi`` management command will be |
| 892 |
removed. Please deploy your project using WSGI. |
| 893 |
|
| 894 |
* ``django.utils.datastructures.SortedDict`` will be removed. Use |
| 895 |
:class:`collections.OrderedDict` from the Python standard library instead. |
| 896 |
|
| 897 |
* ``ModelAdmin.declared_fieldsets`` will be removed. |
| 898 |
|
| 899 |
* Instances of ``util.py`` in the Django codebase have been renamed to |
| 900 |
``utils.py`` in an effort to unify all util and utils references. |
| 901 |
The modules that provided backwards compatibility will be removed: |
| 902 |
|
| 903 |
* ``django.contrib.admin.util`` |
| 904 |
* ``django.contrib.gis.db.backends.util`` |
| 905 |
* ``django.db.backends.util`` |
| 906 |
* ``django.forms.util`` |
| 907 |
|
| 908 |
* ``ModelAdmin.get_formsets`` will be removed. |
| 909 |
|
| 910 |
* The backward compatibility shim introduced to rename the |
| 911 |
``BaseMemcachedCache._get_memcache_timeout()`` method to |
| 912 |
``get_backend_timeout()`` will be removed. |
| 913 |
|
| 914 |
* The ``--natural`` and ``-n`` options for :djadmin:`dumpdata` will be removed. |
| 915 |
|
| 916 |
* The ``use_natural_keys`` argument for ``serializers.serialize()`` will be |
| 917 |
removed. |
| 918 |
|
| 919 |
* Private API ``django.forms.forms.get_declared_fields()`` will be removed. |
| 920 |
|
| 921 |
* The ability to use a ``SplitDateTimeWidget`` with ``DateTimeField`` will be |
| 922 |
removed. |
| 923 |
|
| 924 |
* The ``WSGIRequest.REQUEST`` property will be removed. |
| 925 |
|
| 926 |
* The class ``django.utils.datastructures.MergeDict`` will be removed. |
| 927 |
|
| 928 |
* The ``zh-cn`` and ``zh-tw`` language codes will be removed and have been |
| 929 |
replaced by the ``zh-hans`` and ``zh-hant`` language code respectively. |
| 930 |
|
| 931 |
* The internal ``django.utils.functional.memoize`` will be removed. |
| 932 |
|
| 933 |
* ``django.core.cache.get_cache`` will be removed. Add suitable entries |
| 934 |
to :setting:`CACHES` and use :data:`django.core.cache.caches` instead. |
| 935 |
|
| 936 |
* ``django.db.models.loading`` will be removed. |
| 937 |
|
| 938 |
* Passing callable arguments to querysets will no longer be possible. |
| 939 |
|
| 940 |
* ``BaseCommand.requires_model_validation`` will be removed in favor of |
| 941 |
``requires_system_checks``. Admin validators will be replaced by admin |
| 942 |
checks. |
| 943 |
|
| 944 |
* The ``ModelAdmin.validator_class`` and ``default_validator_class`` attributes |
| 945 |
will be removed. |
| 946 |
|
| 947 |
* ``ModelAdmin.validate()`` will be removed. |
| 948 |
|
| 949 |
* ``django.db.backends.DatabaseValidation.validate_field`` will be removed in |
| 950 |
favor of the ``check_field`` method. |
| 951 |
|
| 952 |
* The ``validate`` management command will be removed. |
| 953 |
|
| 954 |
* ``django.utils.module_loading.import_by_path`` will be removed in favor of |
| 955 |
``django.utils.module_loading.import_string``. |
| 956 |
|
| 957 |
* ``ssi`` and ``url`` template tags will be removed from the ``future`` template |
| 958 |
tag library (used during the 1.3/1.4 deprecation period). |
| 959 |
|
| 960 |
* ``django.utils.text.javascript_quote`` will be removed. |
| 961 |
|
| 962 |
* Database test settings as independent entries in the database settings, |
| 963 |
prefixed by ``TEST_``, will no longer be supported. |
| 964 |
|
| 965 |
* The ``cache_choices`` option to :class:`~django.forms.ModelChoiceField` and |
| 966 |
:class:`~django.forms.ModelMultipleChoiceField` will be removed. |
| 967 |
|
| 968 |
* The default value of the |
| 969 |
:attr:`RedirectView.permanent <django.views.generic.base.RedirectView.permanent>` |
| 970 |
attribute will change from ``True`` to ``False``. |
| 971 |
|
| 972 |
* ``django.contrib.sitemaps.FlatPageSitemap`` will be removed in favor of |
| 973 |
``django.contrib.flatpages.sitemaps.FlatPageSitemap``. |
| 974 |
|
| 975 |
* Private API ``django.test.utils.TestTemplateLoader`` will be removed. |
| 976 |
|
| 977 |
* The ``django.contrib.contenttypes.generic`` module will be removed. |
| 978 |
|
| 979 |
* Private APIs ``django.db.models.sql.where.WhereNode.make_atom()`` and |
| 980 |
``django.db.models.sql.where.Constraint`` will be removed. |
| 981 |
|
| 982 |
.. _deprecation-removed-in-1.8: |
| 983 |
|
| 984 |
1.8 |
| 985 |
--- |
| 986 |
|
| 987 |
See the :ref:`Django 1.6 release notes<deprecated-features-1.6>` for more |
| 988 |
details on these changes. |
| 989 |
|
| 990 |
* ``django.contrib.comments`` will be removed. |
| 991 |
|
| 992 |
* The following transaction management APIs will be removed: |
| 993 |
|
| 994 |
- ``TransactionMiddleware``, |
| 995 |
- the decorators and context managers ``autocommit``, ``commit_on_success``, |
| 996 |
and ``commit_manually``, defined in ``django.db.transaction``, |
| 997 |
- the functions ``commit_unless_managed`` and ``rollback_unless_managed``, |
| 998 |
also defined in ``django.db.transaction``, |
| 999 |
- the ``TRANSACTIONS_MANAGED`` setting. |
| 1000 |
|
| 1001 |
* The :ttag:`cycle` and :ttag:`firstof` template tags will auto-escape their |
| 1002 |
arguments. In 1.6 and 1.7, this behavior is provided by the version of these |
| 1003 |
tags in the ``future`` template tag library. |
| 1004 |
|
| 1005 |
* The ``SEND_BROKEN_LINK_EMAILS`` setting will be removed. Add the |
| 1006 |
:class:`django.middleware.common.BrokenLinkEmailsMiddleware` middleware to |
| 1007 |
your ``MIDDLEWARE_CLASSES`` setting instead. |
| 1008 |
|
| 1009 |
* ``django.middleware.doc.XViewMiddleware`` will be removed. Use |
| 1010 |
``django.contrib.admindocs.middleware.XViewMiddleware`` instead. |
| 1011 |
|
| 1012 |
* ``Model._meta.module_name`` was renamed to ``model_name``. |
| 1013 |
|
| 1014 |
* Remove the backward compatible shims introduced to rename ``get_query_set`` |
| 1015 |
and similar queryset methods. This affects the following classes: |
| 1016 |
``BaseModelAdmin``, ``ChangeList``, ``BaseCommentNode``, |
| 1017 |
``GenericForeignKey``, ``Manager``, ``SingleRelatedObjectDescriptor`` and |
| 1018 |
``ReverseSingleRelatedObjectDescriptor``. |
| 1019 |
|
| 1020 |
* Remove the backward compatible shims introduced to rename the attributes |
| 1021 |
``ChangeList.root_query_set`` and ``ChangeList.query_set``. |
| 1022 |
|
| 1023 |
* ``django.views.defaults.shortcut`` will be removed, as part of the |
| 1024 |
goal of removing all ``django.contrib`` references from the core |
| 1025 |
Django codebase. Instead use |
| 1026 |
``django.contrib.contenttypes.views.shortcut``. ``django.conf.urls.shortcut`` |
| 1027 |
will also be removed. |
| 1028 |
|
| 1029 |
* Support for the Python Imaging Library (PIL) module will be removed, as it |
| 1030 |
no longer appears to be actively maintained & does not work on Python 3. |
| 1031 |
|
| 1032 |
* The following private APIs will be removed: |
| 1033 |
|
| 1034 |
- ``django.db.backend`` |
| 1035 |
- ``django.db.close_connection()`` |
| 1036 |
- ``django.db.backends.creation.BaseDatabaseCreation.set_autocommit()`` |
| 1037 |
- ``django.db.transaction.is_managed()`` |
| 1038 |
- ``django.db.transaction.managed()`` |
| 1039 |
|
| 1040 |
* ``django.forms.widgets.RadioInput`` will be removed in favor of |
| 1041 |
``django.forms.widgets.RadioChoiceInput``. |
| 1042 |
|
| 1043 |
* The module ``django.test.simple`` and the class |
| 1044 |
``django.test.simple.DjangoTestSuiteRunner`` will be removed. Instead use |
| 1045 |
``django.test.runner.DiscoverRunner``. |
| 1046 |
|
| 1047 |
* The module ``django.test._doctest`` will be removed. Instead use the doctest |
| 1048 |
module from the Python standard library. |
| 1049 |
|
| 1050 |
* The ``CACHE_MIDDLEWARE_ANONYMOUS_ONLY`` setting will be removed. |
| 1051 |
|
| 1052 |
* Usage of the hard-coded *Hold down "Control", or "Command" on a Mac, to select |
| 1053 |
more than one.* string to override or append to user-provided ``help_text`` in |
| 1054 |
forms for ManyToMany model fields will not be performed by Django anymore |
| 1055 |
either at the model or forms layer. |
| 1056 |
|
| 1057 |
* The ``Model._meta.get_(add|change|delete)_permission`` methods will |
| 1058 |
be removed. |
| 1059 |
|
| 1060 |
* The session key ``django_language`` will no longer be read for backwards |
| 1061 |
compatibility. |
| 1062 |
|
| 1063 |
* Geographic Sitemaps will be removed |
| 1064 |
(``django.contrib.gis.sitemaps.views.index`` and |
| 1065 |
``django.contrib.gis.sitemaps.views.sitemap``). |
| 1066 |
|
| 1067 |
* ``django.utils.html.fix_ampersands``, the ``fix_ampersands`` template filter and |
| 1068 |
``django.utils.html.clean_html`` will be removed following an accelerated deprecation. |
| 1069 |
|
| 1070 |
.. _deprecation-removed-in-1.7: |
| 1071 |
|
| 1072 |
1.7 |
| 1073 |
--- |
| 1074 |
|
| 1075 |
See the :ref:`Django 1.5 release notes<deprecated-features-1.5>` for more |
| 1076 |
details on these changes. |
| 1077 |
|
| 1078 |
* The module ``django.utils.simplejson`` will be removed. The standard library |
| 1079 |
provides :mod:`json` which should be used instead. |
| 1080 |
|
| 1081 |
* The function ``django.utils.itercompat.product`` will be removed. The Python |
| 1082 |
builtin version should be used instead. |
| 1083 |
|
| 1084 |
* Auto-correction of INSTALLED_APPS and TEMPLATE_DIRS settings when they are |
| 1085 |
specified as a plain string instead of a tuple will be removed and raise an |
| 1086 |
exception. |
| 1087 |
|
| 1088 |
* The ``mimetype`` argument to the ``__init__`` methods of |
| 1089 |
:class:`~django.http.HttpResponse`, |
| 1090 |
:class:`~django.template.response.SimpleTemplateResponse`, and |
| 1091 |
:class:`~django.template.response.TemplateResponse`, will be removed. |
| 1092 |
``content_type`` should be used instead. This also applies to the |
| 1093 |
``render_to_response()`` shortcut and the sitemap views, |
| 1094 |
:func:`~django.contrib.sitemaps.views.index` and |
| 1095 |
:func:`~django.contrib.sitemaps.views.sitemap`. |
| 1096 |
|
| 1097 |
* When :class:`~django.http.HttpResponse` is instantiated with an iterator, |
| 1098 |
or when :attr:`~django.http.HttpResponse.content` is set to an iterator, |
| 1099 |
that iterator will be immediately consumed. |
| 1100 |
|
| 1101 |
* The ``AUTH_PROFILE_MODULE`` setting, and the ``get_profile()`` method on |
| 1102 |
the User model, will be removed. |
| 1103 |
|
| 1104 |
* The ``cleanup`` management command will be removed. It's replaced by |
| 1105 |
``clearsessions``. |
| 1106 |
|
| 1107 |
* The ``daily_cleanup.py`` script will be removed. |
| 1108 |
|
| 1109 |
* The ``depth`` keyword argument will be removed from |
| 1110 |
:meth:`~django.db.models.query.QuerySet.select_related`. |
| 1111 |
|
| 1112 |
* The undocumented ``get_warnings_state()``/``restore_warnings_state()`` |
| 1113 |
functions from :mod:`django.test.utils` and the ``save_warnings_state()``/ |
| 1114 |
``restore_warnings_state()`` |
| 1115 |
:ref:`django.test.*TestCase <django-testcase-subclasses>` methods are |
| 1116 |
deprecated. Use the :class:`warnings.catch_warnings` context manager |
| 1117 |
available starting with Python 2.6 instead. |
| 1118 |
|
| 1119 |
* The undocumented ``check_for_test_cookie`` method in |
| 1120 |
:class:`~django.contrib.auth.forms.AuthenticationForm` will be removed |
| 1121 |
following an accelerated deprecation. Users subclassing this form should |
| 1122 |
remove calls to this method, and instead ensure that their auth related views |
| 1123 |
are CSRF protected, which ensures that cookies are enabled. |
| 1124 |
|
| 1125 |
* The version of ``django.contrib.auth.views.password_reset_confirm()`` that |
| 1126 |
supports base36 encoded user IDs |
| 1127 |
(``django.contrib.auth.views.password_reset_confirm_uidb36``) will be |
| 1128 |
removed. If your site has been running Django 1.6 for more than |
| 1129 |
``PASSWORD_RESET_TIMEOUT_DAYS``, this change will have no effect. If not, |
| 1130 |
then any password reset links generated before you upgrade to Django 1.7 |
| 1131 |
won't work after the upgrade. |
| 1132 |
|
| 1133 |
* The ``django.utils.encoding.StrAndUnicode`` mix-in will be removed. |
| 1134 |
|
| 1135 |
.. _deprecation-removed-in-1.6: |
| 1136 |
|
| 1137 |
1.6 |
| 1138 |
--- |
| 1139 |
|
| 1140 |
See the :ref:`Django 1.4 release notes<deprecated-features-1.4>` for more |
| 1141 |
details on these changes. |
| 1142 |
|
| 1143 |
* ``django.contrib.databrowse`` will be removed. |
| 1144 |
|
| 1145 |
* ``django.contrib.localflavor`` will be removed following an accelerated |
| 1146 |
deprecation. |
| 1147 |
|
| 1148 |
* ``django.contrib.markup`` will be removed following an accelerated |
| 1149 |
deprecation. |
| 1150 |
|
| 1151 |
* The compatibility modules ``django.utils.copycompat`` and |
| 1152 |
``django.utils.hashcompat`` as well as the functions |
| 1153 |
``django.utils.itercompat.all`` and ``django.utils.itercompat.any`` will |
| 1154 |
be removed. The Python builtin versions should be used instead. |
| 1155 |
|
| 1156 |
* The ``csrf_response_exempt`` and ``csrf_view_exempt`` decorators will |
| 1157 |
be removed. Since 1.4 ``csrf_response_exempt`` has been a no-op (it |
| 1158 |
returns the same function), and ``csrf_view_exempt`` has been a |
| 1159 |
synonym for ``django.views.decorators.csrf.csrf_exempt``, which should |
| 1160 |
be used to replace it. |
| 1161 |
|
| 1162 |
* The ``django.core.cache.backends.memcached.CacheClass`` backend |
| 1163 |
was split into two in Django 1.3 in order to introduce support for |
| 1164 |
PyLibMC. The historical ``CacheClass`` will be removed in favor of |
| 1165 |
``django.core.cache.backends.memcached.MemcachedCache``. |
| 1166 |
|
| 1167 |
* The UK-prefixed objects of ``django.contrib.localflavor.uk`` will only |
| 1168 |
be accessible through their GB-prefixed names (GB is the correct |
| 1169 |
ISO 3166 code for United Kingdom). |
| 1170 |
|
| 1171 |
* The ``IGNORABLE_404_STARTS`` and ``IGNORABLE_404_ENDS`` settings have been |
| 1172 |
superseded by :setting:`IGNORABLE_404_URLS` in the 1.4 release. They will be |
| 1173 |
removed. |
| 1174 |
|
| 1175 |
* The form wizard has been refactored to use class-based views with pluggable |
| 1176 |
backends in 1.4. The previous implementation will be removed. |
| 1177 |
|
| 1178 |
* Legacy ways of calling |
| 1179 |
:func:`~django.views.decorators.cache.cache_page` will be removed. |
| 1180 |
|
| 1181 |
* The backward-compatibility shim to automatically add a debug-false |
| 1182 |
filter to the ``'mail_admins'`` logging handler will be removed. The |
| 1183 |
:setting:`LOGGING` setting should include this filter explicitly if |
| 1184 |
it is desired. |
| 1185 |
|
| 1186 |
* The builtin truncation functions ``django.utils.text.truncate_words()`` |
| 1187 |
and ``django.utils.text.truncate_html_words()`` will be removed in |
| 1188 |
favor of the ``django.utils.text.Truncator`` class. |
| 1189 |
|
| 1190 |
* The ``django.contrib.gis.geoip.GeoIP`` class was moved to |
| 1191 |
``django.contrib.gis.geoip`` in 1.4 -- the shortcut in |
| 1192 |
``django.contrib.gis.utils`` will be removed. |
| 1193 |
|
| 1194 |
* ``django.conf.urls.defaults`` will be removed. The functions |
| 1195 |
``include()``, ``patterns()``, and ``url()``, plus |
| 1196 |
:data:`~django.conf.urls.handler404` and :data:`~django.conf.urls.handler500` |
| 1197 |
are now available through ``django.conf.urls``. |
| 1198 |
|
| 1199 |
* The functions ``setup_environ()`` and ``execute_manager()`` will be removed |
| 1200 |
from :mod:`django.core.management`. This also means that the old (pre-1.4) |
| 1201 |
style of :file:`manage.py` file will no longer work. |
| 1202 |
|
| 1203 |
* Setting the ``is_safe`` and ``needs_autoescape`` flags as attributes of |
| 1204 |
template filter functions will no longer be supported. |
| 1205 |
|
| 1206 |
* The attribute ``HttpRequest.raw_post_data`` was renamed to ``HttpRequest.body`` |
| 1207 |
in 1.4. The backward compatibility will be removed -- |
| 1208 |
``HttpRequest.raw_post_data`` will no longer work. |
| 1209 |
|
| 1210 |
* The value for the ``post_url_continue`` parameter in |
| 1211 |
``ModelAdmin.response_add()`` will have to be either ``None`` (to redirect |
| 1212 |
to the newly created object's edit page) or a pre-formatted url. String |
| 1213 |
formats, such as the previous default ``'../%s/'``, will not be accepted any |
| 1214 |
more. |
| 1215 |
|
| 1216 |
.. _deprecation-removed-in-1.5: |
| 1217 |
|
| 1218 |
1.5 |
| 1219 |
--- |
| 1220 |
|
| 1221 |
See the :ref:`Django 1.3 release notes<deprecated-features-1.3>` for more |
| 1222 |
details on these changes. |
| 1223 |
|
| 1224 |
* Starting Django without a :setting:`SECRET_KEY` will result in an exception |
| 1225 |
rather than a ``DeprecationWarning``. (This is accelerated from the usual |
| 1226 |
deprecation path; see the :doc:`Django 1.4 release notes</releases/1.4>`.) |
| 1227 |
|
| 1228 |
* The ``mod_python`` request handler will be removed. The ``mod_wsgi`` |
| 1229 |
handler should be used instead. |
| 1230 |
|
| 1231 |
* The ``template`` attribute on ``django.test.client.Response`` |
| 1232 |
objects returned by the :ref:`test client <test-client>` will be removed. |
| 1233 |
The :attr:`~django.test.Response.templates` attribute should be |
| 1234 |
used instead. |
| 1235 |
|
| 1236 |
* The ``django.test.simple.DjangoTestRunner`` will be removed. |
| 1237 |
Instead use a ``unittest``-native class. The features of the |
| 1238 |
``django.test.simple.DjangoTestRunner`` (including fail-fast and |
| 1239 |
Ctrl-C test termination) can be provided by :class:`unittest.TextTestRunner`. |
| 1240 |
|
| 1241 |
* The undocumented function |
| 1242 |
``django.contrib.formtools.utils.security_hash`` will be removed, |
| 1243 |
instead use ``django.contrib.formtools.utils.form_hmac`` |
| 1244 |
|
| 1245 |
* The function-based generic view modules will be removed in favor of their |
| 1246 |
class-based equivalents, outlined :doc:`here |
| 1247 |
</topics/class-based-views/index>`. |
| 1248 |
|
| 1249 |
* The ``django.core.servers.basehttp.AdminMediaHandler`` will be |
| 1250 |
removed. In its place use |
| 1251 |
``django.contrib.staticfiles.handlers.StaticFilesHandler``. |
| 1252 |
|
| 1253 |
* The template tags library ``adminmedia`` and the template tag ``{% |
| 1254 |
admin_media_prefix %}`` will be removed in favor of the generic static files |
| 1255 |
handling. (This is faster than the usual deprecation path; see the |
| 1256 |
:doc:`Django 1.4 release notes</releases/1.4>`.) |
| 1257 |
|
| 1258 |
* The ``url`` and ``ssi`` template tags will be modified so that the first |
| 1259 |
argument to each tag is a template variable, not an implied string. In 1.4, |
| 1260 |
this behavior is provided by a version of the tag in the ``future`` template |
| 1261 |
tag library. |
| 1262 |
|
| 1263 |
* The ``reset`` and ``sqlreset`` management commands will be removed. |
| 1264 |
|
| 1265 |
* Authentication backends will need to support an inactive user |
| 1266 |
being passed to all methods dealing with permissions. |
| 1267 |
The ``supports_inactive_user`` attribute will no longer be checked |
| 1268 |
and can be removed from custom backends. |
| 1269 |
|
| 1270 |
* :meth:`~django.contrib.gis.geos.GEOSGeometry.transform` will raise |
| 1271 |
a :class:`~django.contrib.gis.geos.GEOSException` when called |
| 1272 |
on a geometry with no SRID value. |
| 1273 |
|
| 1274 |
* ``django.http.CompatCookie`` will be removed in favor of |
| 1275 |
``django.http.SimpleCookie``. |
| 1276 |
|
| 1277 |
* ``django.core.context_processors.PermWrapper`` and |
| 1278 |
``django.core.context_processors.PermLookupDict`` will be removed in |
| 1279 |
favor of the corresponding |
| 1280 |
``django.contrib.auth.context_processors.PermWrapper`` and |
| 1281 |
``django.contrib.auth.context_processors.PermLookupDict``, respectively. |
| 1282 |
|
| 1283 |
* The :setting:`MEDIA_URL` or :setting:`STATIC_URL` settings will be |
| 1284 |
required to end with a trailing slash to ensure there is a consistent |
| 1285 |
way to combine paths in templates. |
| 1286 |
|
| 1287 |
* ``django.db.models.fields.URLField.verify_exists`` will be removed. The |
| 1288 |
feature was deprecated in 1.3.1 due to intractable security and |
| 1289 |
performance issues and will follow a slightly accelerated deprecation |
| 1290 |
timeframe. |
| 1291 |
|
| 1292 |
* Translations located under the so-called *project path* will be ignored during |
| 1293 |
the translation building process performed at runtime. The |
| 1294 |
:setting:`LOCALE_PATHS` setting can be used for the same task by including the |
| 1295 |
filesystem path to a ``locale`` directory containing non-app-specific |
| 1296 |
translations in its value. |
| 1297 |
|
| 1298 |
* The Markup contrib app will no longer support versions of Python-Markdown |
| 1299 |
library earlier than 2.1. An accelerated timeline was used as this was |
| 1300 |
a security related deprecation. |
| 1301 |
|
| 1302 |
* The ``CACHE_BACKEND`` setting will be removed. The cache backend(s) should be |
| 1303 |
specified in the :setting:`CACHES` setting. |
| 1304 |
|
| 1305 |
.. _deprecation-removed-in-1.4: |
| 1306 |
|
| 1307 |
1.4 |
| 1308 |
--- |
| 1309 |
|
| 1310 |
See the :ref:`Django 1.2 release notes<deprecated-features-1.2>` for more |
| 1311 |
details on these changes. |
| 1312 |
|
| 1313 |
* ``CsrfResponseMiddleware`` and ``CsrfMiddleware`` will be removed. Use |
| 1314 |
the ``{% csrf_token %}`` template tag inside forms to enable CSRF |
| 1315 |
protection. ``CsrfViewMiddleware`` remains and is enabled by default. |
| 1316 |
|
| 1317 |
* The old imports for CSRF functionality (``django.contrib.csrf.*``), |
| 1318 |
which moved to core in 1.2, will be removed. |
| 1319 |
|
| 1320 |
* The ``django.contrib.gis.db.backend`` module will be removed in favor |
| 1321 |
of the specific backends. |
| 1322 |
|
| 1323 |
* ``SMTPConnection`` will be removed in favor of a generic email backend API. |
| 1324 |
|
| 1325 |
* The many to many SQL generation functions on the database backends |
| 1326 |
will be removed. |
| 1327 |
|
| 1328 |
* The ability to use the ``DATABASE_*`` family of top-level settings to |
| 1329 |
define database connections will be removed. |
| 1330 |
|
| 1331 |
* The ability to use shorthand notation to specify a database backend |
| 1332 |
(i.e., ``sqlite3`` instead of ``django.db.backends.sqlite3``) will be |
| 1333 |
removed. |
| 1334 |
|
| 1335 |
* The ``get_db_prep_save``, ``get_db_prep_value`` and |
| 1336 |
``get_db_prep_lookup`` methods will have to support multiple databases. |
| 1337 |
|
| 1338 |
* The ``Message`` model (in ``django.contrib.auth``), its related |
| 1339 |
manager in the ``User`` model (``user.message_set``), and the |
| 1340 |
associated methods (``user.message_set.create()`` and |
| 1341 |
``user.get_and_delete_messages()``), will be removed. The |
| 1342 |
:doc:`messages framework </ref/contrib/messages>` should be used |
| 1343 |
instead. The related ``messages`` variable returned by the |
| 1344 |
auth context processor will also be removed. Note that this |
| 1345 |
means that the admin application will depend on the messages |
| 1346 |
context processor. |
| 1347 |
|
| 1348 |
* Authentication backends will need to support the ``obj`` parameter for |
| 1349 |
permission checking. The ``supports_object_permissions`` attribute |
| 1350 |
will no longer be checked and can be removed from custom backends. |
| 1351 |
|
| 1352 |
* Authentication backends will need to support the ``AnonymousUser`` class |
| 1353 |
being passed to all methods dealing with permissions. The |
| 1354 |
``supports_anonymous_user`` variable will no longer be checked and can be |
| 1355 |
removed from custom backends. |
| 1356 |
|
| 1357 |
* The ability to specify a callable template loader rather than a |
| 1358 |
``Loader`` class will be removed, as will the ``load_template_source`` |
| 1359 |
functions that are included with the built in template loaders for |
| 1360 |
backwards compatibility. |
| 1361 |
|
| 1362 |
* ``django.utils.translation.get_date_formats()`` and |
| 1363 |
``django.utils.translation.get_partial_date_formats()``. These functions |
| 1364 |
will be removed; use the locale-aware |
| 1365 |
``django.utils.formats.get_format()`` to get the appropriate formats. |
| 1366 |
|
| 1367 |
* In ``django.forms.fields``, the constants: ``DEFAULT_DATE_INPUT_FORMATS``, |
| 1368 |
``DEFAULT_TIME_INPUT_FORMATS`` and |
| 1369 |
``DEFAULT_DATETIME_INPUT_FORMATS`` will be removed. Use |
| 1370 |
``django.utils.formats.get_format()`` to get the appropriate |
| 1371 |
formats. |
| 1372 |
|
| 1373 |
* The ability to use a function-based test runner will be removed, |
| 1374 |
along with the ``django.test.simple.run_tests()`` test runner. |
| 1375 |
|
| 1376 |
* The ``views.feed()`` view and ``feeds.Feed`` class in |
| 1377 |
``django.contrib.syndication`` will be removed. The class-based view |
| 1378 |
``views.Feed`` should be used instead. |
| 1379 |
|
| 1380 |
* ``django.core.context_processors.auth``. This release will |
| 1381 |
remove the old method in favor of the new method in |
| 1382 |
``django.contrib.auth.context_processors.auth``. |
| 1383 |
|
| 1384 |
* The ``postgresql`` database backend will be removed, use the |
| 1385 |
``postgresql_psycopg2`` backend instead. |
| 1386 |
|
| 1387 |
* The ``no`` language code will be removed and has been replaced by the |
| 1388 |
``nb`` language code. |
| 1389 |
|
| 1390 |
* Authentication backends will need to define the boolean attribute |
| 1391 |
``supports_inactive_user`` until version 1.5 when it will be assumed that |
| 1392 |
all backends will handle inactive users. |
| 1393 |
|
| 1394 |
* ``django.db.models.fields.XMLField`` will be removed. This was |
| 1395 |
deprecated as part of the 1.3 release. An accelerated deprecation |
| 1396 |
schedule has been used because the field hasn't performed any role |
| 1397 |
beyond that of a simple ``TextField`` since the removal of ``oldforms``. |
| 1398 |
All uses of ``XMLField`` can be replaced with ``TextField``. |
| 1399 |
|
| 1400 |
* The undocumented ``mixin`` parameter to the ``open()`` method of |
| 1401 |
``django.core.files.storage.Storage`` (and subclasses) will be removed. |
| 1402 |
|
| 1403 |
.. _deprecation-removed-in-1.3: |
| 1404 |
|
| 1405 |
1.3 |
| 1406 |
--- |
| 1407 |
|
| 1408 |
See the :ref:`Django 1.1 release notes<deprecated-features-1.1>` for more |
| 1409 |
details on these changes. |
| 1410 |
|
| 1411 |
* ``AdminSite.root()``. This method of hooking up the admin URLs will be |
| 1412 |
removed in favor of including ``admin.site.urls``. |
| 1413 |
|
| 1414 |
* Authentication backends need to define the boolean attributes |
| 1415 |
``supports_object_permissions`` and ``supports_anonymous_user`` until |
| 1416 |
version 1.4, at which point it will be assumed that all backends will |
| 1417 |
support these options. |