deprecation.txt 51 KB

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