3.0.txt 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246
  1. ============================================
  2. Django 3.0 release notes - UNDER DEVELOPMENT
  3. ============================================
  4. *Expected December 2019*
  5. Welcome to Django 3.0!
  6. These release notes cover the :ref:`new features <whats-new-3.0>`, as well as
  7. some :ref:`backwards incompatible changes <backwards-incompatible-3.0>` you'll
  8. want to be aware of when upgrading from Django 2.2 or earlier. We've
  9. :ref:`dropped some features<removed-features-3.0>` that have reached the end of
  10. their deprecation cycle, and we've :ref:`begun the deprecation process for
  11. some features <deprecated-features-3.0>`.
  12. See the :doc:`/howto/upgrade-version` guide if you're updating an existing
  13. project.
  14. Python compatibility
  15. ====================
  16. Django 3.0 supports Python 3.6, 3.7, and 3.8. We **highly recommend** and only
  17. officially support the latest release of each series.
  18. The Django 2.2.x series is the last to support Python 3.5.
  19. Third-party library support for older version of Django
  20. =======================================================
  21. Following the release of Django 3.0, we suggest that third-party app authors
  22. drop support for all versions of Django prior to 2.2. At that time, you should
  23. be able to run your package's tests using ``python -Wd`` so that deprecation
  24. warnings appear. After making the deprecation warning fixes, your app should be
  25. compatible with Django 3.0.
  26. .. _whats-new-3.0:
  27. What's new in Django 3.0
  28. ========================
  29. Minor features
  30. --------------
  31. :mod:`django.contrib.admin`
  32. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  33. * ...
  34. :mod:`django.contrib.admindocs`
  35. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  36. * ...
  37. :mod:`django.contrib.auth`
  38. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  39. * ...
  40. :mod:`django.contrib.contenttypes`
  41. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  42. * ...
  43. :mod:`django.contrib.gis`
  44. ~~~~~~~~~~~~~~~~~~~~~~~~~
  45. * ...
  46. :mod:`django.contrib.messages`
  47. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  48. * ...
  49. :mod:`django.contrib.postgres`
  50. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  51. * ...
  52. :mod:`django.contrib.redirects`
  53. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  54. * ...
  55. :mod:`django.contrib.sessions`
  56. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  57. * ...
  58. :mod:`django.contrib.sitemaps`
  59. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  60. * ...
  61. :mod:`django.contrib.sites`
  62. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  63. * ...
  64. :mod:`django.contrib.staticfiles`
  65. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  66. * ...
  67. :mod:`django.contrib.syndication`
  68. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  69. * ...
  70. Cache
  71. ~~~~~
  72. * ...
  73. CSRF
  74. ~~~~
  75. * ...
  76. Email
  77. ~~~~~
  78. * ...
  79. File Storage
  80. ~~~~~~~~~~~~
  81. * ...
  82. File Uploads
  83. ~~~~~~~~~~~~
  84. * ...
  85. Forms
  86. ~~~~~
  87. * ...
  88. Generic Views
  89. ~~~~~~~~~~~~~
  90. * ...
  91. Internationalization
  92. ~~~~~~~~~~~~~~~~~~~~
  93. * ...
  94. Management Commands
  95. ~~~~~~~~~~~~~~~~~~~
  96. * ...
  97. Migrations
  98. ~~~~~~~~~~
  99. * ...
  100. Models
  101. ~~~~~~
  102. * ...
  103. Requests and Responses
  104. ~~~~~~~~~~~~~~~~~~~~~~
  105. * ...
  106. Serialization
  107. ~~~~~~~~~~~~~
  108. * ...
  109. Signals
  110. ~~~~~~~
  111. * ...
  112. Templates
  113. ~~~~~~~~~
  114. * ...
  115. Tests
  116. ~~~~~
  117. * ...
  118. URLs
  119. ~~~~
  120. * ...
  121. Validators
  122. ~~~~~~~~~~
  123. * ...
  124. .. _backwards-incompatible-3.0:
  125. Backwards incompatible changes in 3.0
  126. =====================================
  127. Database backend API
  128. --------------------
  129. This section describes changes that may be needed in third-party database
  130. backends.
  131. * ...
  132. Miscellaneous
  133. -------------
  134. * ...
  135. .. _deprecated-features-3.0:
  136. Features deprecated in 3.0
  137. ==========================
  138. Miscellaneous
  139. -------------
  140. * ...
  141. .. _removed-features-3.0:
  142. Features removed in 3.0
  143. =======================
  144. These features have reached the end of their deprecation cycle and are removed
  145. in Django 3.0.
  146. See :ref:`deprecated-features-2.0` for details on these changes, including how
  147. to remove usage of these features.
  148. * The ``django.db.backends.postgresql_psycopg2`` module is removed.
  149. * ``django.shortcuts.render_to_response()`` is removed.
  150. See :ref:`deprecated-features-2.1` for details on these changes, including how
  151. to remove usage of these features.
  152. * ...