2.0.txt 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776
  1. ============================================
  2. Django 2.0 release notes - UNDER DEVELOPMENT
  3. ============================================
  4. Welcome to Django 2.0!
  5. These release notes cover the :ref:`new features <whats-new-2.0>`, as well as
  6. some :ref:`backwards incompatible changes <backwards-incompatible-2.0>` you'll
  7. want to be aware of when upgrading from Django 1.11 or earlier. We've
  8. :ref:`dropped some features<removed-features-2.0>` that have reached the end of
  9. their deprecation cycle, and we've :ref:`begun the deprecation process for some
  10. features <deprecated-features-2.0>`.
  11. See the :doc:`/howto/upgrade-version` guide if you're updating an existing
  12. project.
  13. Python compatibility
  14. ====================
  15. Django 2.0 supports Python 3.5+. Since Django 1.11, support for Python 2.7 and
  16. 3.4 is removed. We **highly recommend** and only officially support the latest
  17. release of each series.
  18. Third-party library support for older version of Django
  19. =======================================================
  20. Following the release of Django 2.0, we suggest that third-party app authors
  21. drop support for all versions of Django prior to 1.11. At that time, you should
  22. be able run your package's tests using ``python -Wd`` so that deprecation
  23. warnings do appear. After making the deprecation warning fixes, your app should
  24. be compatible with Django 2.0.
  25. .. _whats-new-2.0:
  26. What's new in Django 2.0
  27. ========================
  28. Minor features
  29. --------------
  30. :mod:`django.contrib.admin`
  31. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  32. * ...
  33. :mod:`django.contrib.admindocs`
  34. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35. * ...
  36. :mod:`django.contrib.auth`
  37. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  38. * The default iteration count for the PBKDF2 password hasher is increased from
  39. 36,000 to 100,000.
  40. :mod:`django.contrib.contenttypes`
  41. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  42. * ...
  43. :mod:`django.contrib.gis`
  44. ~~~~~~~~~~~~~~~~~~~~~~~~~
  45. * Added MySQL support for the
  46. :class:`~django.contrib.gis.db.models.functions.AsGeoJSON` function,
  47. :class:`~django.contrib.gis.db.models.functions.GeoHash` function,
  48. :class:`~django.contrib.gis.db.models.functions.IsValid` function,
  49. :lookup:`isvalid` lookup, and :ref:`distance lookups <distance-lookups>`.
  50. * Added the :class:`~django.contrib.gis.db.models.functions.Azimuth` and
  51. :class:`~django.contrib.gis.db.models.functions.LineLocatePoint` functions,
  52. supported on PostGIS and SpatiaLite.
  53. * Any :class:`~django.contrib.gis.geos.GEOSGeometry` imported from GeoJSON now
  54. has its SRID set.
  55. * Added the :attr:`.OSMWidget.default_zoom` attribute to customize the map's
  56. default zoom level.
  57. * Made metadata readable and editable on rasters through the
  58. :attr:`~django.contrib.gis.gdal.GDALRaster.metadata`,
  59. :attr:`~django.contrib.gis.gdal.GDALRaster.info`, and
  60. :attr:`~django.contrib.gis.gdal.GDALBand.metadata` attributes.
  61. * Allowed passing driver-specific creation options to
  62. :class:`~django.contrib.gis.gdal.GDALRaster` objects using ``papsz_options``.
  63. * Allowed creating :class:`~django.contrib.gis.gdal.GDALRaster` objects in
  64. GDAL's internal virtual filesystem. Rasters can now be :ref:`created from and
  65. converted to binary data <gdal-raster-vsimem>` in-memory.
  66. :mod:`django.contrib.messages`
  67. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  68. * ...
  69. :mod:`django.contrib.postgres`
  70. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  71. * The new ``distinct`` argument for
  72. :class:`~django.contrib.postgres.aggregates.ArrayAgg` determines if
  73. concatenated values will be distinct.
  74. * The new :class:`~django.contrib.postgres.functions.RandomUUID` database
  75. function returns a version 4 UUID. It requires use of PostgreSQL's
  76. ``pgcrypto`` extension which can be activated using the new
  77. :class:`~django.contrib.postgres.operations.CryptoExtension` migration
  78. operation.
  79. * :class:`django.contrib.postgres.indexes.GinIndex` now supports the
  80. ``fast_update`` and ``gin_pending_list_limit`` parameters.
  81. :mod:`django.contrib.redirects`
  82. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  83. * ...
  84. :mod:`django.contrib.sessions`
  85. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  86. * ...
  87. :mod:`django.contrib.sitemaps`
  88. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  89. * Added the ``protocol`` keyword argument to the
  90. :class:`~django.contrib.sitemaps.GenericSitemap` constructor.
  91. :mod:`django.contrib.sites`
  92. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  93. * ...
  94. :mod:`django.contrib.staticfiles`
  95. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  96. * ...
  97. :mod:`django.contrib.syndication`
  98. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  99. * ...
  100. Cache
  101. ~~~~~
  102. * ...
  103. CSRF
  104. ~~~~
  105. * ...
  106. Database backends
  107. ~~~~~~~~~~~~~~~~~
  108. * ...
  109. Email
  110. ~~~~~
  111. * ...
  112. File Storage
  113. ~~~~~~~~~~~~
  114. * :meth:`File.open() <django.core.files.File.open>` can be used as a context
  115. manager, e.g. ``with file.open() as f:``.
  116. File Uploads
  117. ~~~~~~~~~~~~
  118. * ...
  119. Forms
  120. ~~~~~
  121. * The new ``date_attrs`` and ``time_attrs`` arguments for
  122. :class:`~django.forms.SplitDateTimeWidget` and
  123. :class:`~django.forms.SplitHiddenDateTimeWidget` allow specifying different
  124. HTML attributes for the ``DateInput`` and ``TimeInput`` (or hidden)
  125. subwidgets.
  126. * The new :meth:`Form.errors.get_json_data()
  127. <django.forms.Form.errors.get_json_data>` method returns form errors as
  128. a dictionary suitable for including in a JSON response.
  129. Generic Views
  130. ~~~~~~~~~~~~~
  131. * The new :attr:`.ContextMixin.extra_context` attribute allows adding context
  132. in ``View.as_view()``.
  133. Internationalization
  134. ~~~~~~~~~~~~~~~~~~~~
  135. * ...
  136. Management Commands
  137. ~~~~~~~~~~~~~~~~~~~
  138. * :djadmin:`inspectdb` now translates MySQL's unsigned integer columns to
  139. ``PositiveIntegerField`` or ``PositiveSmallIntegerField``.
  140. * The new :option:`makemessages --add-location` option controls the comment
  141. format in PO files.
  142. * :djadmin:`loaddata` can now :ref:`read from stdin <loading-fixtures-stdin>`.
  143. * The new :option:`diffsettings --output` option allows formatting the output
  144. in a unified diff format.
  145. * On Oracle, :djadmin:`inspectdb` can now introspect ``AutoField`` if the
  146. column is created as an identity column.
  147. * On MySQL, :djadmin:`dbshell` now supports client-side TLS certificates.
  148. Migrations
  149. ~~~~~~~~~~
  150. * The new :option:`squashmigrations --squashed-name` option allows naming
  151. the squashed migration.
  152. Models
  153. ~~~~~~
  154. * The new :class:`~django.db.models.functions.StrIndex` database function
  155. finds the starting index of a string inside another string.
  156. * On Oracle, ``AutoField`` and ``BigAutoField`` are now created as `identity
  157. columns`_.
  158. .. _`identity columns`: https://docs.oracle.com/database/121/DRDAA/migr_tools_feat.htm#DRDAA109
  159. * The new ``chunk_size`` parameter of :meth:`.QuerySet.iterator` controls the
  160. number of rows fetched by the Python database client when streaming results
  161. from the database. For databases that don't support server-side cursors, it
  162. controls the number of results Django fetches from the database adapter.
  163. * Added the :class:`~django.db.models.functions.datetime.ExtractQuarter`
  164. function to extract the quarter from :class:`~django.db.models.DateField` and
  165. :class:`~django.db.models.DateTimeField`, and exposed it through the
  166. :lookup:`quarter` lookup.
  167. * Added the :class:`~django.db.models.functions.datetime.TruncQuarter`
  168. function to truncate :class:`~django.db.models.DateField` and
  169. :class:`~django.db.models.DateTimeField` to the first day of a quarter.
  170. * Added the :attr:`~django.db.models.Index.db_tablespace` parameter to
  171. class-based indexes.
  172. * If the database supports a native duration field (Oracle and PostgreSQL),
  173. :class:`~django.db.models.functions.datetime.Extract` now works with
  174. :class:`~django.db.models.DurationField`.
  175. * Added the ``of`` argument to :meth:`.QuerySet.select_for_update()`, supported
  176. on PostgreSQL and Oracle, to lock only rows from specific tables rather than
  177. all selected tables. It may be helpful particularly when
  178. :meth:`~.QuerySet.select_for_update()` is used in conjunction with
  179. :meth:`~.QuerySet.select_related()`.
  180. * The new ``field_name`` parameter of :meth:`.QuerySet.in_bulk` allows fetching
  181. results based on any unique model field.
  182. Requests and Responses
  183. ~~~~~~~~~~~~~~~~~~~~~~
  184. * The :djadmin:`runserver` Web server supports HTTP 1.1.
  185. Serialization
  186. ~~~~~~~~~~~~~
  187. * ...
  188. Signals
  189. ~~~~~~~
  190. * ...
  191. Templates
  192. ~~~~~~~~~
  193. * To increase the usefulness of :meth:`.Engine.get_default` in third-party
  194. apps, it now returns the first engine if multiple ``DjangoTemplates`` engines
  195. are configured in ``TEMPLATES`` rather than raising ``ImproperlyConfigured``.
  196. * Custom template tags may now accept keyword-only arguments.
  197. Tests
  198. ~~~~~
  199. * Added threading support to :class:`~django.test.LiveServerTestCase`.
  200. * Added settings that allow customizing the test tablespace parameters for
  201. Oracle: :setting:`DATAFILE_SIZE`, :setting:`DATAFILE_TMP_SIZE`,
  202. :setting:`DATAFILE_EXTSIZE`, and :setting:`DATAFILE_TMP_EXTSIZE`.
  203. URLs
  204. ~~~~
  205. * ...
  206. Validators
  207. ~~~~~~~~~~
  208. * ...
  209. .. _backwards-incompatible-2.0:
  210. Backwards incompatible changes in 2.0
  211. =====================================
  212. Removed support for bytestrings in some places
  213. ----------------------------------------------
  214. To support native Python 2 strings, older Django versions had to accept both
  215. bytestrings and unicode strings. Now that Python 2 support is dropped,
  216. bytestrings should only be encountered around input/output boundaries (handling
  217. of binary fields or HTTP streams, for example). You might have to update your
  218. code to limit bytestring usage to a minimum, as Django no longer accepts
  219. bytestrings in certain code paths.
  220. Database backend API
  221. --------------------
  222. This section describes changes that may be needed in third-party database
  223. backends.
  224. * The ``DatabaseOperations.datetime_cast_date_sql()``,
  225. ``datetime_cast_time_sql()``, ``datetime_trunc_sql()``,
  226. ``datetime_extract_sql()``, and ``date_interval_sql()`` methods now return
  227. only the SQL to perform the operation instead of SQL and a list of
  228. parameters.
  229. * Third-party database backends should add a ``DatabaseWrapper.display_name``
  230. attribute with the name of the database that your backend works with. Django
  231. may use it in various messages, such as in system checks.
  232. * The first argument of ``SchemaEditor._alter_column_type_sql()`` is now
  233. ``model`` rather than ``table``.
  234. * The first argument of ``SchemaEditor._create_index_name()`` is now
  235. ``table_name`` rather than ``model``.
  236. * To enable ``FOR UPDATE OF`` support, set
  237. ``DatabaseFeatures.has_select_for_update_of = True``. If the database
  238. requires that the arguments to ``OF`` be columns rather than tables, set
  239. ``DatabaseFeatures.select_for_update_of_column = True``.
  240. Dropped support for Oracle 11.2
  241. -------------------------------
  242. The end of upstream support for Oracle 11.2 is Dec. 2020. Django 1.11 will be
  243. supported until April 2020 which almost reaches this date. Django 2.0
  244. officially supports Oracle 12.1+.
  245. Default MySQL isolation level is read committed
  246. -----------------------------------------------
  247. MySQL's default isolation level, repeatable read, may cause data loss in
  248. typical Django usage. To prevent that and for consistency with other databases,
  249. the default isolation level is now read committed. You can use the
  250. :setting:`DATABASES` setting to :ref:`use a different isolation level
  251. <mysql-isolation-level>`, if needed.
  252. :attr:`AbstractUser.last_name <django.contrib.auth.models.User.last_name>` ``max_length`` increased to 150
  253. ----------------------------------------------------------------------------------------------------------
  254. A migration for :attr:`django.contrib.auth.models.User.last_name` is included.
  255. If you have a custom user model inheriting from ``AbstractUser``, you'll need
  256. to generate and apply a database migration for your user model.
  257. If you want to preserve the 30 character limit for last names, use a custom
  258. form::
  259. from django.contrib.auth.forms import UserChangeForm
  260. class MyUserChangeForm(UserChangeForm):
  261. last_name = forms.CharField(max_length=30, required=False)
  262. If you wish to keep this restriction in the admin when editing users, set
  263. ``UserAdmin.form`` to use this form::
  264. from django.contrib.auth.admin import UserAdmin
  265. from django.contrib.auth.models import User
  266. class MyUserAdmin(UserAdmin):
  267. form = MyUserChangeForm
  268. admin.site.unregister(User)
  269. admin.site.register(User, MyUserAdmin)
  270. ``QuerySet.reverse()`` and ``last()`` are prohibited after slicing
  271. ------------------------------------------------------------------
  272. Calling ``QuerySet.reverse()`` or ``last()`` on a sliced queryset leads to
  273. unexpected results due to the slice being applied after reordering. This is
  274. now prohibited, e.g.::
  275. >>> Model.objects.all()[:2].reverse()
  276. Traceback (most recent call last):
  277. ...
  278. TypeError: Cannot reverse a query once a slice has been taken.
  279. Form fields no longer accept optional arguments as positional arguments
  280. -----------------------------------------------------------------------
  281. To help prevent runtime errors due to incorrect ordering of form field
  282. arguments, optional arguments of built-in form fields are no longer accepted
  283. as positional arguments. For example::
  284. forms.IntegerField(25, 10)
  285. raises an exception and should be replaced with::
  286. forms.IntegerField(max_value=25, min_value=10)
  287. ``call_command()`` validates the options it receives
  288. ----------------------------------------------------
  289. ``call_command()`` now validates that the argument parser of the command being
  290. called defines all of the options passed to ``call_command()``.
  291. For custom management commands that use options not created using
  292. ``parser.add_argument()``, add a ``stealth_options`` attribute on the command::
  293. class MyCommand(BaseCommand):
  294. stealth_options = ('option_name', ...)
  295. Indexes no longer accept positional arguments
  296. ---------------------------------------------
  297. For example::
  298. models.Index(['headline', '-pub_date'], 'index_name')
  299. raises an exception and should be replaced with::
  300. models.Index(fields=['headline', '-pub_date'], name='index_name')
  301. Foreign key constraints are now enabled on SQLite
  302. -------------------------------------------------
  303. This will appear as a backwards-incompatible change (``IntegrityError:
  304. FOREIGN KEY constraint failed``) if attempting to save an existing model
  305. instance that's violating a foreign key constraint.
  306. Foreign keys are now created with ``DEFERRABLE INITIALLY DEFERRED`` instead of
  307. ``DEFERRABLE IMMEDIATE``. Thus, tables may need to be rebuilt to recreate
  308. foreign keys with the new definition, particularly if you're using a pattern
  309. like this::
  310. from django.db import transaction
  311. with transaction.atomic():
  312. Book.objects.create(author_id=1)
  313. Author.objects.create(id=1)
  314. If you don't recreate the foreign key as ``DEFERRED``, the first ``create()``
  315. would fail now that foreign key constraints are enforced.
  316. Backup your database first! After upgrading to Django 2.0, you can then
  317. rebuild tables using a script similar to this::
  318. from django.apps import apps
  319. from django.db import connection
  320. for app in apps.get_app_configs():
  321. for model in app.get_models(include_auto_created=True):
  322. if model._meta.managed and not (model._meta.proxy or model._meta.swapped):
  323. for base in model.__bases__:
  324. if hasattr(base, '_meta'):
  325. base._meta.local_many_to_many = []
  326. model._meta.local_many_to_many = []
  327. with connection.schema_editor() as editor:
  328. editor._remake_table(model)
  329. This script hasn't received extensive testing and needs adaption for various
  330. cases such as multiple databases. Feel free to contribute improvements.
  331. Miscellaneous
  332. -------------
  333. * The ``SessionAuthenticationMiddleware`` class is removed. It provided no
  334. functionality since session authentication is unconditionally enabled in
  335. Django 1.10.
  336. * The default HTTP error handlers (``handler404``, etc.) are now callables
  337. instead of dotted Python path strings. Django favors callable references
  338. since they provide better performance and debugging experience.
  339. * :class:`~django.views.generic.base.RedirectView` no longer silences
  340. ``NoReverseMatch`` if the ``pattern_name`` doesn't exist.
  341. * When :setting:`USE_L10N` is off, :class:`~django.forms.FloatField` and
  342. :class:`~django.forms.DecimalField` now respect :setting:`DECIMAL_SEPARATOR`
  343. and :setting:`THOUSAND_SEPARATOR` during validation. For example, with the
  344. settings::
  345. USE_L10N = False
  346. USE_THOUSAND_SEPARATOR = True
  347. DECIMAL_SEPARATOR = ','
  348. THOUSAND_SEPARATOR = '.'
  349. an input of ``"1.345"`` is now converted to ``1345`` instead of ``1.345``.
  350. * Subclasses of :class:`~django.contrib.auth.models.AbstractBaseUser` are no
  351. longer required to implement ``get_short_name()`` and ``get_full_name()``.
  352. (The base implementations that raise ``NotImplementedError`` are removed.)
  353. ``django.contrib.admin`` uses these methods if implemented but doesn't
  354. require them. Third-party apps that use these methods may want to adopt a
  355. similar approach.
  356. * The ``FIRST_DAY_OF_WEEK`` and ``NUMBER_GROUPING`` format settings are now
  357. kept as integers in JavaScript and JSON i18n view outputs.
  358. * :meth:`~django.test.TransactionTestCase.assertNumQueries` now ignores
  359. connection configuration queries. Previously, if a test opened a new database
  360. connection, those queries could be included as part of the
  361. ``assertNumQueries()`` count.
  362. * The ``PASSWORD_RESET_TIMEOUT_DAYS`` setting is more properly respected in
  363. ``contrib.auth`` password reset. Previously, resets were allowed for one day
  364. longer than expected. For example, with the default of
  365. ``PASSWORD_RESET_TIMEOUT_DAYS = 3``, password reset tokens are now valid for
  366. 72 hours rather than 96 hours.
  367. * The default size of the Oracle test tablespace is increased from 20M to 50M
  368. and the default autoextend size is increased from 10M to 25M.
  369. * To improve performance when streaming large result sets from the database,
  370. :meth:`.QuerySet.iterator` now fetches 2000 rows at a time instead of 100.
  371. The old behavior can be restored using the ``chunk_size`` parameter. For
  372. example::
  373. Book.objects.iterator(chunk_size=100)
  374. * Providing unknown package names in the ``packages`` argument of the
  375. :class:`~django.views.i18n.JavaScriptCatalog` view now raises ``ValueError``
  376. instead of passing silently.
  377. * A model instance's primary key now appears in the default ``Model.__str__()``
  378. method, e.g. ``Question object (1)``.
  379. * ``makemigrations`` now detects changes to the model field ``limit_choices_to``
  380. option. Add this to your existing migrations or accept an auto-generated
  381. migration for fields that use it.
  382. * Performing queries that require :ref:`automatic spatial transformations
  383. <automatic-spatial-transformations>` now raises ``NotImplementedError``
  384. on MySQL instead of silently using non-transformed geometries.
  385. * ``django.core.exceptions.DjangoRuntimeWarning`` is removed. It was only used
  386. in the cache backend as an intermediate class in ``CacheKeyWarning``'s
  387. inheritance of ``RuntimeWarning``.
  388. * Renamed ``BaseExpression._output_field`` to ``output_field``. You may need
  389. to update custom expressions.
  390. * In older versions, forms and formsets combine their ``Media`` with widget
  391. ``Media`` by concatenating the two. The combining now tries to :ref:`preserve
  392. the relative order of elements in each list <form-media-asset-order>`.
  393. ``MediaOrderConflictWarning`` is issued if the order can't be preserved.
  394. .. _deprecated-features-2.0:
  395. Features deprecated in 2.0
  396. ==========================
  397. ``context`` argument of ``Field.from_db_value()`` and ``Expression.convert_value()``
  398. ------------------------------------------------------------------------------------
  399. The ``context`` argument of ``Field.from_db_value()`` and
  400. ``Expression.convert_value()`` is unused as it's always an empty dictionary.
  401. The signature of both methods is now::
  402. (self, value, expression, connection)
  403. instead of::
  404. (self, value, expression, connection, context)
  405. Support for the old signature in custom fields and expressions remains until
  406. Django 3.0.
  407. Miscellaneous
  408. -------------
  409. * The ``django.db.backends.postgresql_psycopg2`` module is deprecated in favor
  410. of ``django.db.backends.postgresql``. It's been an alias since Django 1.9.
  411. This only affects code that imports from the module directly. The
  412. ``DATABASES`` setting can still use
  413. ``'django.db.backends.postgresql_psycopg2'``, though you can simplify that by
  414. using the ``'django.db.backends.postgresql'`` name added in Django 1.9.
  415. * ``django.shortcuts.render_to_response()`` is deprecated in favor of
  416. :func:`django.shortcuts.render`. ``render()`` takes the same arguments
  417. except that is also requires a ``request``.
  418. * The ``DEFAULT_CONTENT_TYPE`` setting is deprecated. It doesn't interact well
  419. well with third-party apps and is obsolete since HTML5 has mostly superseded
  420. XHTML.
  421. * ``HttpRequest.xreadlines()`` is deprecated in favor of iterating over the
  422. request.
  423. .. _removed-features-2.0:
  424. Features removed in 2.0
  425. =======================
  426. These features have reached the end of their deprecation cycle and are removed
  427. in Django 2.0. See :ref:`deprecated-features-1.9` and
  428. :ref:`deprecated-features-1.10` for details, including how to remove usage of
  429. these features.
  430. * The ``weak`` argument to ``django.dispatch.signals.Signal.disconnect()`` is
  431. removed.
  432. * ``django.db.backends.base.BaseDatabaseOperations.check_aggregate_support()``
  433. is removed.
  434. * The ``django.forms.extras`` package is removed.
  435. * The ``assignment_tag`` helper is removed.
  436. * The ``host`` argument to ``SimpleTestCase.assertsRedirects()`` is removed.
  437. The compatibility layer which allows absolute URLs to be considered equal to
  438. relative ones when the path is identical is also removed.
  439. * ``Field.rel`` and ``Field.remote_field.to`` are removed.
  440. * The ``on_delete`` argument for ``ForeignKey`` and ``OneToOneField`` are now
  441. required.
  442. * ``django.db.models.fields.add_lazy_relation()`` is removed.
  443. * When time zone support is enabled, database backends that don't support time
  444. zones no longer convert aware datetimes to naive values in UTC anymore when
  445. such values are passed as parameters to SQL queries executed outside of the
  446. ORM, e.g. with ``cursor.execute()``.
  447. * ``django.contrib.auth.tests.utils.skipIfCustomUser()`` is removed.
  448. * The ``GeoManager`` and ``GeoQuerySet`` classes are removed.
  449. * The ``django.contrib.gis.geoip`` module is removed.
  450. * The ``supports_recursion`` check for template loaders is removed from:
  451. * ``django.template.engine.Engine.find_template()``
  452. * ``django.template.loader_tags.ExtendsNode.find_template()``
  453. * ``django.template.loaders.base.Loader.supports_recursion()``
  454. * ``django.template.loaders.cached.Loader.supports_recursion()``
  455. * The ``load_template`` and ``load_template_sources`` template loader methods
  456. are removed.
  457. * The ``template_dirs`` argument for template loaders is removed:
  458. * ``django.template.loaders.base.Loader.get_template()``
  459. * ``django.template.loaders.cached.Loader.cache_key()``
  460. * ``django.template.loaders.cached.Loader.get_template()``
  461. * ``django.template.loaders.cached.Loader.get_template_sources()``
  462. * ``django.template.loaders.filesystem.Loader.get_template_sources()``
  463. * ``django.template.loaders.base.Loader.__call__()`` is removed.
  464. * Support for custom error views that don't accept an ``exception`` parameter
  465. is removed.
  466. * The ``mime_type`` attribute of ``django.utils.feedgenerator.Atom1Feed`` and
  467. ``django.utils.feedgenerator.RssFeed`` is removed.
  468. * The ``app_name`` argument to ``include()`` is removed.
  469. * Support for passing a 3-tuple (including ``admin.site.urls``) as the first
  470. argument to ``include()`` is removed.
  471. * Support for setting a URL instance namespace without an application namespace
  472. is removed.
  473. * ``Field._get_val_from_obj()`` is removed.
  474. * ``django.template.loaders.eggs.Loader`` is removed.
  475. * The ``current_app`` parameter to the ``contrib.auth`` function-based views is
  476. removed.
  477. * The ``callable_obj`` keyword argument to
  478. ``SimpleTestCase.assertRaisesMessage()`` is removed.
  479. * Support for the ``allow_tags`` attribute on ``ModelAdmin`` methods is
  480. removed.
  481. * The ``enclosure`` keyword argument to ``SyndicationFeed.add_item()`` is
  482. removed.
  483. * The ``django.template.loader.LoaderOrigin`` and
  484. ``django.template.base.StringOrigin`` aliases for
  485. ``django.template.base.Origin`` are removed.
  486. * The ``makemigrations --exit`` option is removed.
  487. * Support for direct assignment to a reverse foreign key or many-to-many
  488. relation is removed.
  489. * The ``get_srid()`` and ``set_srid()`` methods of
  490. ``django.contrib.gis.geos.GEOSGeometry`` are removed.
  491. * The ``get_x()``, ``set_x()``, ``get_y()``, ``set_y()``, ``get_z()``, and
  492. ``set_z()`` methods of ``django.contrib.gis.geos.Point`` are removed.
  493. * The ``get_coords()`` and ``set_coords()`` methods of
  494. ``django.contrib.gis.geos.Point`` are removed.
  495. * The ``cascaded_union`` property of ``django.contrib.gis.geos.MultiPolygon``
  496. is removed.
  497. * ``django.utils.functional.allow_lazy()`` is removed.
  498. * The ``shell --plain`` option is removed.
  499. * The ``django.core.urlresolvers`` module is removed.
  500. * ``CommaSeparatedIntegerField`` is removed, except for support in historical
  501. migrations.
  502. * The template ``Context.has_key()`` method is removed.
  503. * Support for the ``django.core.files.storage.Storage.accessed_time()``,
  504. ``created_time()``, and ``modified_time()`` methods is removed.
  505. * Support for query lookups using the model name when
  506. ``Meta.default_related_name`` is set is removed.
  507. * The MySQL ``__search`` lookup is removed.
  508. * The shim for supporting custom related manager classes without a
  509. ``_apply_rel_filters()`` method is removed.
  510. * Using ``User.is_authenticated()`` and ``User.is_anonymous()`` as methods
  511. rather than properties is no longer supported.
  512. * The ``Model._meta.virtual_fields`` attribute is removed.
  513. * The keyword arguments ``virtual_only`` in ``Field.contribute_to_class()`` and
  514. ``virtual`` in ``Model._meta.add_field()`` are removed.
  515. * The ``javascript_catalog()`` and ``json_catalog()`` views are removed.
  516. * ``django.contrib.gis.utils.precision_wkt()`` is removed.
  517. * In multi-table inheritance, implicit promotion of a ``OneToOneField`` to a
  518. ``parent_link`` is removed.
  519. * Support for ``Widget._format_value()`` is removed.
  520. * ``FileField`` methods ``get_directory_name()`` and ``get_filename()`` are
  521. removed.
  522. * The ``mark_for_escaping()`` function and the classes it uses: ``EscapeData``,
  523. ``EscapeBytes``, ``EscapeText``, ``EscapeString``, and ``EscapeUnicode`` are
  524. removed.
  525. * The ``escape`` filter now uses ``django.utils.html.conditional_escape()``.
  526. * ``Manager.use_for_related_fields`` is removed.
  527. * Model ``Manager`` inheritance follows MRO inheritance rules. The requirement
  528. to use ``Meta.manager_inheritance_from_future`` to opt-in to the behavior is
  529. removed.
  530. * Support for old-style middleware using ``settings.MIDDLEWARE_CLASSES`` is
  531. removed.