Debian Codegraph @

docs/internals/deprecation.txt

raw
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.