4.1.txt 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275
  1. ============================================
  2. Django 4.1 release notes - UNDER DEVELOPMENT
  3. ============================================
  4. *Expected August 2022*
  5. Welcome to Django 4.1!
  6. These release notes cover the :ref:`new features <whats-new-4.1>`, as well as
  7. some :ref:`backwards incompatible changes <backwards-incompatible-4.1>` you'll
  8. want to be aware of when upgrading from Django 4.0 or earlier. We've
  9. :ref:`begun the deprecation process for some features
  10. <deprecated-features-4.1>`.
  11. See the :doc:`/howto/upgrade-version` guide if you're updating an existing
  12. project.
  13. Python compatibility
  14. ====================
  15. Django 4.1 supports Python 3.8, 3.9, and 3.10. We **highly recommend** and only
  16. officially support the latest release of each series.
  17. .. _whats-new-4.1:
  18. What's new in Django 4.1
  19. ========================
  20. Minor features
  21. --------------
  22. :mod:`django.contrib.admin`
  23. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24. * ...
  25. :mod:`django.contrib.admindocs`
  26. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  27. * ...
  28. :mod:`django.contrib.auth`
  29. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  30. * The default iteration count for the PBKDF2 password hasher is increased from
  31. 320,000 to 390,000.
  32. :mod:`django.contrib.contenttypes`
  33. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  34. * ...
  35. :mod:`django.contrib.gis`
  36. ~~~~~~~~~~~~~~~~~~~~~~~~~
  37. * ...
  38. :mod:`django.contrib.messages`
  39. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  40. * ...
  41. :mod:`django.contrib.postgres`
  42. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43. * ...
  44. :mod:`django.contrib.redirects`
  45. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  46. * ...
  47. :mod:`django.contrib.sessions`
  48. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  49. * ...
  50. :mod:`django.contrib.sitemaps`
  51. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  52. * ...
  53. :mod:`django.contrib.sites`
  54. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  55. * ...
  56. :mod:`django.contrib.staticfiles`
  57. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  58. * ...
  59. :mod:`django.contrib.syndication`
  60. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  61. * ...
  62. Cache
  63. ~~~~~
  64. * ...
  65. CSRF
  66. ~~~~
  67. * ...
  68. Decorators
  69. ~~~~~~~~~~
  70. * ...
  71. Email
  72. ~~~~~
  73. * ...
  74. Error Reporting
  75. ~~~~~~~~~~~~~~~
  76. * ...
  77. File Storage
  78. ~~~~~~~~~~~~
  79. * ...
  80. File Uploads
  81. ~~~~~~~~~~~~
  82. * ...
  83. Forms
  84. ~~~~~
  85. * ...
  86. Generic Views
  87. ~~~~~~~~~~~~~
  88. * ...
  89. Internationalization
  90. ~~~~~~~~~~~~~~~~~~~~
  91. * ...
  92. Logging
  93. ~~~~~~~
  94. * ...
  95. Management Commands
  96. ~~~~~~~~~~~~~~~~~~~
  97. * ...
  98. Migrations
  99. ~~~~~~~~~~
  100. * ...
  101. Models
  102. ~~~~~~
  103. * ...
  104. Requests and Responses
  105. ~~~~~~~~~~~~~~~~~~~~~~
  106. * ...
  107. Security
  108. ~~~~~~~~
  109. * ...
  110. Serialization
  111. ~~~~~~~~~~~~~
  112. * ...
  113. Signals
  114. ~~~~~~~
  115. * ...
  116. Templates
  117. ~~~~~~~~~
  118. * ...
  119. Tests
  120. ~~~~~
  121. * ...
  122. URLs
  123. ~~~~
  124. * ...
  125. Utilities
  126. ~~~~~~~~~
  127. * ...
  128. Validators
  129. ~~~~~~~~~~
  130. * ...
  131. .. _backwards-incompatible-4.1:
  132. Backwards incompatible changes in 4.1
  133. =====================================
  134. Database backend API
  135. --------------------
  136. This section describes changes that may be needed in third-party database
  137. backends.
  138. * ...
  139. Dropped support for MariaDB 10.2
  140. --------------------------------
  141. Upstream support for MariaDB 10.2 ends in May 2022. Django 4.1 supports MariaDB
  142. 10.3 and higher.
  143. Miscellaneous
  144. -------------
  145. * ...
  146. .. _deprecated-features-4.1:
  147. Features deprecated in 4.1
  148. ==========================
  149. Miscellaneous
  150. -------------
  151. * ...
  152. Features removed in 4.1
  153. =======================
  154. These features have reached the end of their deprecation cycle and are removed
  155. in Django 4.1.
  156. See :ref:`deprecated-features-3.2` for details on these changes, including how
  157. to remove usage of these features.
  158. * Support for assigning objects which don't support creating deep copies with
  159. ``copy.deepcopy()`` to class attributes in ``TestCase.setUpTestData()`` is
  160. removed.
  161. * Support for using a boolean value in
  162. :attr:`.BaseCommand.requires_system_checks` is removed.
  163. * The ``whitelist`` argument and ``domain_whitelist`` attribute of
  164. ``django.core.validators.EmailValidator`` are removed.
  165. * The ``default_app_config`` application configuration variable is removed.
  166. * ``TransactionTestCase.assertQuerysetEqual()`` no longer calls ``repr()`` on a
  167. queryset when compared to string values.
  168. * The ``django.core.cache.backends.memcached.MemcachedCache`` backend is
  169. removed.
  170. * Support for the pre-Django 3.2 format of messages used by
  171. ``django.contrib.messages.storage.cookie.CookieStorage`` is removed.