1.10.txt 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729
  1. =============================================
  2. Django 1.10 release notes - UNDER DEVELOPMENT
  3. =============================================
  4. Welcome to Django 1.10!
  5. These release notes cover the `new features`_, as well as some `backwards
  6. incompatible changes`_ you'll want to be aware of when upgrading from Django
  7. 1.9 or older versions. We've :ref:`dropped some features<removed-features-1.10>`
  8. that have reached the end of their deprecation cycle, and we've `begun the
  9. deprecation process for some features`_.
  10. .. _`new features`: `What's new in Django 1.10`_
  11. .. _`backwards incompatible changes`: `Backwards incompatible changes in 1.10`_
  12. .. _`dropped some features`: `Features removed in 1.10`_
  13. .. _`begun the deprecation process for some features`: `Features deprecated in 1.10`_
  14. Python compatibility
  15. ====================
  16. Like Django 1.9, Django 1.10 requires Python 2.7, 3.4, or 3.5. We **highly
  17. recommend** and only officially support the latest release of each series.
  18. What's new in Django 1.10
  19. =========================
  20. ...
  21. Minor features
  22. --------------
  23. :mod:`django.contrib.admin`
  24. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  25. * For sites running on a subpath, the default :attr:`URL for the "View site"
  26. link <django.contrib.admin.AdminSite.site_url>` at the top of each admin page
  27. will now point to ``request.META['SCRIPT_NAME']`` if set, instead of ``/``.
  28. * The success message that appears after adding or editing an object now
  29. contains a link to the object's change form.
  30. * All inline JavaScript is removed so you can enable the
  31. ``Content-Security-Policy`` HTTP header if you wish.
  32. * The new :attr:`InlineModelAdmin.classes
  33. <django.contrib.admin.InlineModelAdmin.classes>` attribute allows specifying
  34. classes on inline fieldsets. Inlines with a ``collapse`` class will be
  35. initially collapsed and their header will have a small "show" link.
  36. * If a user doesn't have the add permission, the ``object-tools`` block on a
  37. model's changelist will now be rendered (without the add button, of course).
  38. This makes it easier to add custom tools in this case.
  39. * The :class:`~django.contrib.admin.models.LogEntry` model now stores change
  40. messages in a JSON structure so that the message can be dynamically translated
  41. using the current active language. A new ``LogEntry.get_change_message()``
  42. method is now the preferred way of retrieving the change message.
  43. * Selected objects for fields in ``ModelAdmin.raw_id_fields`` now have a link
  44. to object's change form.
  45. * Added "No date" and "Has date" choices for ``DateFieldListFilter`` if the
  46. field is nullable.
  47. :mod:`django.contrib.admindocs`
  48. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  49. * ...
  50. :mod:`django.contrib.auth`
  51. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  52. * The default iteration count for the PBKDF2 password hasher has been increased
  53. by 25%. This backwards compatible change will not affect users who have
  54. subclassed ``django.contrib.auth.hashers.PBKDF2PasswordHasher`` to change the
  55. default value.
  56. * The :func:`~django.contrib.auth.views.logout` view sends "no-cache" headers
  57. to prevent an issue where Safari caches redirects and prevents a user from
  58. being able to log out.
  59. * Added the optional ``backend`` argument to :func:`~django.contrib.auth.login`
  60. to allow using it without credentials.
  61. * The new :setting:`LOGOUT_REDIRECT_URL` setting controls the redirect of the
  62. :func:`~django.contrib.auth.views.logout` view, if the view doesn't get a
  63. ``next_page`` argument.
  64. :mod:`django.contrib.contenttypes`
  65. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  66. * ...
  67. :mod:`django.contrib.gis`
  68. ~~~~~~~~~~~~~~~~~~~~~~~~~
  69. * :ref:`Distance lookups <distance-lookups>` now accept expressions as the
  70. distance value parameter.
  71. * The new :attr:`GEOSGeometry.unary_union
  72. <django.contrib.gis.geos.GEOSGeometry.unary_union>` property computes the
  73. union of all the elements of this geometry.
  74. * Added the :meth:`GEOSGeometry.covers()
  75. <django.contrib.gis.geos.GEOSGeometry.covers>` binary predicate.
  76. * Added the :meth:`GDALBand.statistics()
  77. <django.contrib.gis.gdal.GDALBand.statistics>` method and
  78. :attr:`~django.contrib.gis.gdal.GDALBand.mean`
  79. and :attr:`~django.contrib.gis.gdal.GDALBand.std` attributes.
  80. * Added support for the :class:`~django.contrib.gis.db.models.MakeLine`
  81. aggregate and :class:`~django.contrib.gis.db.models.functions.GeoHash`
  82. function on SpatiaLite.
  83. * Added support for the
  84. :class:`~django.contrib.gis.db.models.functions.Difference`,
  85. :class:`~django.contrib.gis.db.models.functions.Intersection`, and
  86. :class:`~django.contrib.gis.db.models.functions.SymDifference`
  87. functions on MySQL.
  88. * Added support for instantiating empty GEOS geometries.
  89. * The new :attr:`~django.contrib.gis.geos.WKTWriter.trim` and
  90. :attr:`~django.contrib.gis.geos.WKTWriter.precision` properties
  91. of :class:`~django.contrib.gis.geos.WKTWriter` allow controlling
  92. output of the fractional part of the coordinates in WKT.
  93. * Added the :attr:`LineString.closed
  94. <django.contrib.gis.geos.LineString.closed>` and
  95. :attr:`MultiLineString.closed
  96. <django.contrib.gis.geos.MultiLineString.closed>` properties.
  97. :mod:`django.contrib.messages`
  98. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  99. * ...
  100. :mod:`django.contrib.postgres`
  101. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  102. * For convenience, :class:`~django.contrib.postgres.fields.HStoreField` now
  103. casts its keys and values to strings.
  104. :mod:`django.contrib.redirects`
  105. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  106. * ...
  107. :mod:`django.contrib.sessions`
  108. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  109. * The :djadmin:`clearsessions` management command now removes file-based
  110. sessions.
  111. :mod:`django.contrib.sitemaps`
  112. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  113. * ...
  114. :mod:`django.contrib.sites`
  115. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  116. * The :class:`~django.contrib.sites.models.Site` model now supports
  117. :ref:`natural keys <topics-serialization-natural-keys>`.
  118. :mod:`django.contrib.staticfiles`
  119. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  120. * The :ttag:`static` template tag now uses ``django.contrib.staticfiles``
  121. if it's in ``INSTALLED_APPS``. This is especially useful for third-party apps
  122. which can now always use ``{% load static %}`` (instead of
  123. ``{% load staticfiles %}`` or ``{% load static from staticfiles %}``) and
  124. not worry about whether or not the ``staticfiles`` app is installed.
  125. :mod:`django.contrib.syndication`
  126. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  127. * ...
  128. Cache
  129. ~~~~~
  130. * The file-based cache backend now uses the highest pickling protocol.
  131. CSRF
  132. ~~~~
  133. * The default :setting:`CSRF_FAILURE_VIEW`, ``views.csrf.csrf_failure()`` now
  134. accepts an optional ``template_name`` parameter, defaulting to
  135. ``'403_csrf.html'``, to control the template used to render the page.
  136. Database backends
  137. ~~~~~~~~~~~~~~~~~
  138. * ...
  139. Email
  140. ~~~~~
  141. * ...
  142. File Storage
  143. ~~~~~~~~~~~~
  144. * ...
  145. File Uploads
  146. ~~~~~~~~~~~~
  147. * ...
  148. Forms
  149. ~~~~~
  150. * Form and widget ``Media`` is now served using
  151. :mod:`django.contrib.staticfiles` if installed.
  152. Generic Views
  153. ~~~~~~~~~~~~~
  154. * The :class:`~django.views.generic.base.View` class can now be imported from
  155. ``django.views``.
  156. Internationalization
  157. ~~~~~~~~~~~~~~~~~~~~
  158. * ...
  159. Management Commands
  160. ~~~~~~~~~~~~~~~~~~~
  161. * The new :option:`check --fail-level` option allows specifying the message
  162. level that will cause the command to exit with a non-zero status.
  163. * The new :option:`makemigrations --check` option makes the command exit
  164. with a non-zero status when model changes without migrations are detected.
  165. * :djadmin:`makemigrations` now displays the path to the migration files that
  166. it generates.
  167. * The :option:`shell --interface` option now accepts ``python`` to force use of
  168. the "plain" Python interpreter.
  169. * The new :option:`shell --command` option lets you run a command as Django and
  170. exit, instead of opening the interactive shell.
  171. * Added a warning to :djadmin:`dumpdata` if a proxy model is specified (which
  172. results in no output) without its concrete parent.
  173. Migrations
  174. ~~~~~~~~~~
  175. * Added support for serialization of ``enum.Enum`` objects.
  176. * Added the ``elidable`` argument to the
  177. :class:`~django.db.migrations.operations.RunSQL` and
  178. :class:`~django.db.migrations.operations.RunPython` operations to allow them
  179. to be removed when squashing migrations.
  180. * Added support for :ref:`non-atomic migrations <non-atomic-migrations>` by
  181. setting the ``atomic`` attribute on a ``Migration``.
  182. Models
  183. ~~~~~~
  184. * Reverse foreign keys from proxy models are now propagated to their
  185. concrete class. The reverse relation attached by a
  186. :class:`~django.db.models.ForeignKey` pointing to a proxy model is now
  187. accessible as a descriptor on the proxied model class and may be referenced in
  188. queryset filtering.
  189. * The new :meth:`Field.rel_db_type() <django.db.models.Field.rel_db_type>`
  190. method returns the database column data type for fields such as ``ForeignKey``
  191. and ``OneToOneField`` that point to another field.
  192. * The :attr:`~django.db.models.Func.arity` class attribute is added to
  193. :class:`~django.db.models.Func`. This attribute can be used to set the number
  194. of arguments the function accepts.
  195. * Added :class:`~django.db.models.BigAutoField` which acts much like an
  196. :class:`~django.db.models.AutoField` except that it is guaranteed
  197. to fit numbers from ``1`` to ``9223372036854775807``.
  198. * :meth:`QuerySet.in_bulk() <django.db.models.query.QuerySet.in_bulk>`
  199. may be called without any arguments to return all objects in the queryset.
  200. * :attr:`~django.db.models.ForeignKey.related_query_name` now supports
  201. app label and class interpolation using the ``'%(app_label)s'`` and
  202. ``'%(class)s'`` strings.
  203. Requests and Responses
  204. ~~~~~~~~~~~~~~~~~~~~~~
  205. * Added ``request.user`` to the debug view.
  206. * Added :class:`~django.http.HttpResponse` methods
  207. :meth:`~django.http.HttpResponse.readable()` and
  208. :meth:`~django.http.HttpResponse.seekable()` to make an instance a
  209. stream-like object and allow wrapping it with :py:class:`io.TextIOWrapper`.
  210. Serialization
  211. ~~~~~~~~~~~~~
  212. * The ``django.core.serializers.json.DjangoJSONEncoder`` now knows how to
  213. serialize lazy strings, typically used for translatable content.
  214. Signals
  215. ~~~~~~~
  216. * ...
  217. Templates
  218. ~~~~~~~~~
  219. * Added the ``autoescape`` option to the
  220. :class:`~django.template.backends.django.DjangoTemplates` backend and the
  221. :class:`~django.template.Engine` class.
  222. * Added the ``is`` comparison operator to the :ttag:`if` tag.
  223. Tests
  224. ~~~~~
  225. * ...
  226. URLs
  227. ~~~~
  228. * An addition in :func:`django.setup()` allows URL resolving that happens
  229. outside of the request/response cycle (e.g. in management commands and
  230. standalone scripts) to take :setting:`FORCE_SCRIPT_NAME` into account when it
  231. is set.
  232. Validators
  233. ~~~~~~~~~~
  234. * :class:`~django.core.validators.URLValidator` now limits the length of
  235. domain name labels to 63 characters and the total length of domain
  236. names to 253 characters per :rfc:`1034`.
  237. Backwards incompatible changes in 1.10
  238. ======================================
  239. .. warning::
  240. In addition to the changes outlined in this section, be sure to review the
  241. :ref:`removed-features-1.10` for the features that have reached the end of
  242. their deprecation cycle and therefore been removed. If you haven't updated
  243. your code within the deprecation timeline for a given feature, its removal
  244. may appear as a backwards incompatible change.
  245. Database backend API
  246. --------------------
  247. * ...
  248. ``select_related()`` prohibits non-relational fields for nested relations
  249. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  250. Django 1.8 added validation for non-relational fields in ``select_related()``::
  251. >>> Book.objects.select_related('title')
  252. Traceback (most recent call last):
  253. ...
  254. FieldError: Non-relational field given in select_related: 'title'
  255. But it didn't prohibit nested non-relation fields as it does now::
  256. >>> Book.objects.select_related('author__name')
  257. Traceback (most recent call last):
  258. ...
  259. FieldError: Non-relational field given in select_related: 'name'
  260. ``_meta.get_fields()`` returns consistent reverse fields for proxy models
  261. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  262. Before Django 1.10, the :meth:`~django.db.models.options.Options.get_fields`
  263. method returned different reverse fields when called on a proxy model compared
  264. to its proxied concrete class. This inconsistency was fixed by returning the
  265. full set of fields pointing to a concrete class or one of its proxies in both
  266. cases.
  267. :attr:`AbstractUser.username <django.contrib.auth.models.User.username>` ``max_length`` increased to 150
  268. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  269. A migration for :attr:`django.contrib.auth.models.User.username` is included.
  270. If you have a custom user model inheriting from ``AbstractUser``, you'll need
  271. to generate and apply a database migration for your user model.
  272. We considered an increase to 254 characters to more easily allow the use of
  273. email addresses (which are limited to 254 characters) as usernames but rejected
  274. it due to a MySQL limitation. When using the ``utf8mb4`` encoding (recommended
  275. for proper Unicode support), MySQL can only create unique indexes with 191
  276. characters by default. Therefore, if you need a longer length, please use a
  277. custom user model.
  278. If you want to preserve the 30 character limit for usernames, use a custom form
  279. when creating a user or changing usernames::
  280. from django.contrib.auth.forms import UserCreationForm
  281. class MyUserCreationForm(UserCreationForm):
  282. username = forms.CharField(
  283. max_length=30,
  284. help_text='Required. 30 characters or fewer. Letters, digits and @/./+/-/_ only.',
  285. )
  286. If you wish to keep this restriction in the admin, set ``UserAdmin.add_form``
  287. to use this form::
  288. from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
  289. from django.contrib.auth.models import User
  290. class UserAdmin(BaseUserAdmin):
  291. add_form = MyUserCreationForm
  292. admin.site.unregister(User)
  293. admin.site.register(User, UserAdmin)
  294. Dropped support for PostgreSQL 9.1
  295. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  296. Upstream support for PostgreSQL 9.1 ends in September 2016. As a consequence,
  297. Django 1.10 sets PostgreSQL 9.2 as the minimum version it officially supports.
  298. ``runserver`` output goes through logging
  299. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  300. Request and response handling of the ``runserver`` command is sent to the
  301. :ref:`django-server-logger` logger instead of to ``sys.stderr``. If you
  302. disable Django's logging configuration or override it with your own, you'll
  303. need to add the appropriate logging configuration if you want to see that
  304. output::
  305. 'formatters': {
  306. 'django.server': {
  307. '()': 'django.utils.log.ServerFormatter',
  308. 'format': '[%(server_time)s] %(message)s',
  309. }
  310. },
  311. 'handlers': {
  312. 'django.server': {
  313. 'level': 'INFO',
  314. 'class': 'logging.StreamHandler',
  315. 'formatter': 'django.server',
  316. },
  317. },
  318. 'loggers': {
  319. 'django.server': {
  320. 'handlers': ['django.server'],
  321. 'level': 'INFO',
  322. 'propagate': False,
  323. }
  324. }
  325. ``auth.CustomUser`` and ``auth.ExtensionUser`` test models were removed.
  326. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  327. Since the introduction of migrations for the contrib apps in Django 1.8, the
  328. tables of these custom user test models were not created anymore making them
  329. unusable in a testing context.
  330. Miscellaneous
  331. ~~~~~~~~~~~~~
  332. * The ``repr()`` of a ``QuerySet`` is wrapped in ``<QuerySet >`` to
  333. disambiguate it from a plain list when debugging.
  334. * Support for SpatiaLite < 3.0 and GEOS < 3.3 is dropped.
  335. * ``utils.version.get_version()`` returns :pep:`440` compliant release
  336. candidate versions (e.g. '1.10rc1' instead of '1.10c1').
  337. * The ``LOGOUT_URL`` setting is removed as Django hasn't made use of it
  338. since pre-1.0. If you use it in your project, you can add it to your
  339. project's settings. The default value was ``'/accounts/logout/'``.
  340. * The ``add_postgis_srs()`` backwards compatibility alias for
  341. ``django.contrib.gis.utils.add_srs_entry()`` is removed.
  342. * Objects with a ``close()`` method such as files and generators passed to
  343. :class:`~django.http.HttpResponse` are now closed immediately instead of when
  344. the WSGI server calls ``close()`` on the response.
  345. * A redundant ``transaction.atomic()`` call in ``QuerySet.update_or_create()``
  346. is removed. This may affect query counts tested by
  347. ``TransactionTestCase.assertNumQueries()``.
  348. * Support for ``skip_validation`` in ``BaseCommand.execute(**options)`` is
  349. removed. Use ``skip_checks`` (added in Django 1.7) instead.
  350. * :djadmin:`loaddata` now raises a ``CommandError`` instead of showing a
  351. warning when the specified fixture file is not found.
  352. * Instead of directly accessing the ``LogEntry.change_message`` attribute, it's
  353. now better to call the ``LogEntry.get_change_message()`` method which will
  354. provide the message in the current language.
  355. * The default error views now raise ``TemplateDoesNotExist`` if a nonexistent
  356. ``template_name`` is specified.
  357. * The unused ``choices`` keyword argument of the ``Select`` and
  358. ``SelectMultiple`` widgets' ``render()`` method is removed. The ``choices``
  359. argument of the ``render_options()`` method is also removed, making
  360. ``selected_choices`` the first argument.
  361. .. _deprecated-features-1.10:
  362. Features deprecated in 1.10
  363. ===========================
  364. Direct assignment to a reverse foreign key or many-to-many relation
  365. -------------------------------------------------------------------
  366. Instead of assigning related objects using direct assignment::
  367. >>> new_list = [obj1, obj2, obj3]
  368. >>> e.related_set = new_list
  369. Use the :meth:`~django.db.models.fields.related.RelatedManager.set` method
  370. added in Django 1.9::
  371. >>> e.related_set.set([obj1, obj2, obj3])
  372. This prevents confusion about an assignment resulting in an implicit save.
  373. :mod:`django.contrib.gis`
  374. -------------------------
  375. * The ``get_srid()`` and ``set_srid()`` methods of
  376. :class:`~django.contrib.gis.geos.GEOSGeometry` are deprecated in favor
  377. of the :attr:`~django.contrib.gis.geos.GEOSGeometry.srid` property.
  378. * The ``get_x()``, ``set_x()``, ``get_y()``, ``set_y()``, ``get_z()``, and
  379. ``set_z()`` methods of :class:`~django.contrib.gis.geos.Point` are deprecated
  380. in favor of the ``x``, ``y``, and ``z`` properties.
  381. * The ``get_coords()`` and ``set_coords()`` methods of
  382. :class:`~django.contrib.gis.geos.Point` are deprecated in favor of the
  383. ``tuple`` property.
  384. * The ``cascaded_union`` property of
  385. :class:`~django.contrib.gis.geos.MultiPolygon` is deprecated in favor of the
  386. :attr:`~django.contrib.gis.geos.GEOSGeometry.unary_union` property.
  387. Miscellaneous
  388. -------------
  389. * The ``makemigrations --exit`` option is deprecated in favor of the
  390. :option:`makemigrations --check` option.
  391. * ``django.utils.functional.allow_lazy()`` is deprecated in favor of the new
  392. :func:`~django.utils.functional.keep_lazy` function which can be used with a
  393. more natural decorator syntax.
  394. * The ``shell --plain`` option is deprecated in favor of ``-i python`` or
  395. ``--interface python``.
  396. * Importing from the ``django.core.urlresolvers`` module is deprecated in
  397. favor of its new location, :mod:`django.urls`.
  398. .. _removed-features-1.10:
  399. Features removed in 1.10
  400. ========================
  401. These features have reached the end of their deprecation cycle and so have been
  402. removed in Django 1.10 (please see the :ref:`deprecation timeline
  403. <deprecation-removed-in-1.10>` for more details):
  404. * Support for calling a ``SQLCompiler`` directly as an alias for calling its
  405. ``quote_name_unless_alias`` method is removed.
  406. * The ``cycle`` and ``firstof`` template tags are removed from the ``future``
  407. template tag library.
  408. * ``django.conf.urls.patterns()`` is removed.
  409. * Support for the ``prefix`` argument to
  410. ``django.conf.urls.i18n.i18n_patterns()`` is removed.
  411. * ``SimpleTestCase.urls`` is removed.
  412. * Using an incorrect count of unpacked values in the ``for`` template tag
  413. raises an exception rather than failing silently.
  414. * The ability to :func:`~django.urls.reverse` URLs using a dotted Python path
  415. is removed.
  416. * Support for ``optparse`` is dropped for custom management commands.
  417. * The class ``django.core.management.NoArgsCommand`` is removed.
  418. * ``django.core.context_processors`` module is removed.
  419. * ``django.db.models.sql.aggregates`` module is removed.
  420. * ``django.contrib.gis.db.models.sql.aggregates`` module is removed.
  421. * The following methods and properties of ``django.db.sql.query.Query`` are
  422. removed:
  423. * Properties: ``aggregates`` and ``aggregate_select``
  424. * Methods: ``add_aggregate``, ``set_aggregate_mask``, and
  425. ``append_aggregate_mask``.
  426. * ``django.template.resolve_variable`` is removed.
  427. * The following private APIs are removed from
  428. :class:`django.db.models.options.Options` (``Model._meta``):
  429. * ``get_field_by_name()``
  430. * ``get_all_field_names()``
  431. * ``get_fields_with_model()``
  432. * ``get_concrete_fields_with_model()``
  433. * ``get_m2m_with_model()``
  434. * ``get_all_related_objects()``
  435. * ``get_all_related_objects_with_model()``
  436. * ``get_all_related_many_to_many_objects()``
  437. * ``get_all_related_m2m_objects_with_model()``
  438. * The ``error_message`` argument of ``django.forms.RegexField`` is removed.
  439. * The ``unordered_list`` filter no longer supports old style lists.
  440. * Support for string ``view`` arguments to ``url()`` is removed.
  441. * The backward compatible shim to rename ``django.forms.Form._has_changed()``
  442. to ``has_changed()`` is removed.
  443. * The ``removetags`` template filter is removed.
  444. * The ``remove_tags()`` and ``strip_entities()`` functions in
  445. ``django.utils.html`` is removed.
  446. * The ``is_admin_site`` argument to
  447. ``django.contrib.auth.views.password_reset()`` is removed.
  448. * ``django.db.models.field.subclassing.SubfieldBase`` is removed.
  449. * ``django.utils.checksums`` is removed.
  450. * The ``original_content_type_id`` attribute on
  451. ``django.contrib.admin.helpers.InlineAdminForm`` is removed.
  452. * The backwards compatibility shim to allow ``FormMixin.get_form()`` to be
  453. defined with no default value for its ``form_class`` argument is removed.
  454. * The following settings are removed:
  455. * ``ALLOWED_INCLUDE_ROOTS``
  456. * ``TEMPLATE_CONTEXT_PROCESSORS``
  457. * ``TEMPLATE_DEBUG``
  458. * ``TEMPLATE_DIRS``
  459. * ``TEMPLATE_LOADERS``
  460. * ``TEMPLATE_STRING_IF_INVALID``
  461. * The backwards compatibility alias ``django.template.loader.BaseLoader`` is
  462. removed.
  463. * Django template objects returned by
  464. :func:`~django.template.loader.get_template` and
  465. :func:`~django.template.loader.select_template` no longer accept a
  466. :class:`~django.template.Context` in their
  467. :meth:`~django.template.backends.base.Template.render()` method.
  468. * :doc:`Template response APIs </ref/template-response>` enforce the use of
  469. :class:`dict` and backend-dependent template objects instead of
  470. :class:`~django.template.Context` and :class:`~django.template.Template`
  471. respectively.
  472. * The ``current_app`` parameter for the following function and classes is
  473. removed:
  474. * ``django.shortcuts.render()``
  475. * ``django.template.Context()``
  476. * ``django.template.RequestContext()``
  477. * ``django.template.response.TemplateResponse()``
  478. * The ``dictionary`` and ``context_instance`` parameters for the following
  479. functions are removed:
  480. * ``django.shortcuts.render()``
  481. * ``django.shortcuts.render_to_response()``
  482. * ``django.template.loader.render_to_string()``
  483. * The ``dirs`` parameter for the following functions is removed:
  484. * ``django.template.loader.get_template()``
  485. * ``django.template.loader.select_template()``
  486. * ``django.shortcuts.render()``
  487. * ``django.shortcuts.render_to_response()``
  488. * Session verification is enabled regardless of whether or not
  489. ``'django.contrib.auth.middleware.SessionAuthenticationMiddleware'`` is in
  490. ``MIDDLEWARE_CLASSES``. ``SessionAuthenticationMiddleware`` no longer has
  491. any purpose and can be removed from ``MIDDLEWARE_CLASSES``. It's kept as
  492. a stub until Django 2.0 as a courtesy for users who don't read this note.
  493. * Private attribute ``django.db.models.Field.related`` is removed.
  494. * The ``--list`` option of the ``migrate`` management command is removed.
  495. * The ``ssi`` template tag is removed.
  496. * Support for the ``=`` comparison operator in the ``if`` template tag is
  497. removed.
  498. * The backwards compatibility shims to allow ``Storage.get_available_name()``
  499. and ``Storage.save()`` to be defined without a ``max_length`` argument are
  500. removed.
  501. * Support for the legacy ``%(<foo>)s`` syntax in ``ModelFormMixin.success_url``
  502. is removed.
  503. * ``GeoQuerySet`` aggregate methods ``collect()``, ``extent()``, ``extent3d()``,
  504. ``make_line()``, and ``unionagg()`` are removed.
  505. * The ability to specify ``ContentType.name`` when creating a content type
  506. instance is removed.
  507. * Support for the old signature of ``allow_migrate`` is removed.
  508. * Support for the syntax of ``{% cycle %}`` that uses comma-separated arguments
  509. is removed.
  510. * The warning that :class:`~django.core.signing.Signer` issued when given an
  511. invalid separator is now a ``ValueError``.