5.2.txt 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265
  1. ============================================
  2. Django 5.2 release notes - UNDER DEVELOPMENT
  3. ============================================
  4. *Expected April 2025*
  5. Welcome to Django 5.2!
  6. These release notes cover the :ref:`new features <whats-new-5.2>`, as well as
  7. some :ref:`backwards incompatible changes <backwards-incompatible-5.2>` you
  8. should be aware of when upgrading from Django 5.1 or earlier. We've
  9. :ref:`begun the deprecation process for some features
  10. <deprecated-features-5.2>`.
  11. See the :doc:`/howto/upgrade-version` guide if you're updating an existing
  12. project.
  13. Django 5.2 is designated as a :term:`long-term support release
  14. <Long-term support release>`. It will receive security updates for at least
  15. three years after its release. Support for the previous LTS, Django 4.2, will
  16. end in April 2026.
  17. Python compatibility
  18. ====================
  19. Django 5.2 supports Python 3.10, 3.11, 3.12, and 3.13. We **highly recommend**
  20. and only officially support the latest release of each series.
  21. .. _whats-new-5.2:
  22. What's new in Django 5.2
  23. ========================
  24. Minor features
  25. --------------
  26. :mod:`django.contrib.admin`
  27. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  28. * ...
  29. :mod:`django.contrib.admindocs`
  30. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  31. * ...
  32. :mod:`django.contrib.auth`
  33. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  34. * The default iteration count for the PBKDF2 password hasher is increased from
  35. 870,000 to 1,000,000.
  36. :mod:`django.contrib.contenttypes`
  37. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  38. * ...
  39. :mod:`django.contrib.gis`
  40. ~~~~~~~~~~~~~~~~~~~~~~~~~
  41. * ...
  42. :mod:`django.contrib.messages`
  43. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  44. * ...
  45. :mod:`django.contrib.postgres`
  46. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  47. * ...
  48. :mod:`django.contrib.redirects`
  49. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50. * ...
  51. :mod:`django.contrib.sessions`
  52. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  53. * ...
  54. :mod:`django.contrib.sitemaps`
  55. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  56. * ...
  57. :mod:`django.contrib.sites`
  58. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  59. * ...
  60. :mod:`django.contrib.staticfiles`
  61. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  62. * ...
  63. :mod:`django.contrib.syndication`
  64. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  65. * ...
  66. Asynchronous views
  67. ~~~~~~~~~~~~~~~~~~
  68. * ...
  69. Cache
  70. ~~~~~
  71. * ...
  72. CSRF
  73. ~~~~
  74. * ...
  75. Database backends
  76. ~~~~~~~~~~~~~~~~~
  77. * ...
  78. Decorators
  79. ~~~~~~~~~~
  80. * ...
  81. Email
  82. ~~~~~
  83. * ...
  84. Error Reporting
  85. ~~~~~~~~~~~~~~~
  86. * ...
  87. File Storage
  88. ~~~~~~~~~~~~
  89. * ...
  90. File Uploads
  91. ~~~~~~~~~~~~
  92. * ...
  93. Forms
  94. ~~~~~
  95. * ...
  96. Generic Views
  97. ~~~~~~~~~~~~~
  98. * ...
  99. Internationalization
  100. ~~~~~~~~~~~~~~~~~~~~
  101. * ...
  102. Logging
  103. ~~~~~~~
  104. * ...
  105. Management Commands
  106. ~~~~~~~~~~~~~~~~~~~
  107. * ...
  108. Migrations
  109. ~~~~~~~~~~
  110. * ...
  111. Models
  112. ~~~~~~
  113. * ...
  114. Requests and Responses
  115. ~~~~~~~~~~~~~~~~~~~~~~
  116. * ...
  117. Security
  118. ~~~~~~~~
  119. * ...
  120. Serialization
  121. ~~~~~~~~~~~~~
  122. * ...
  123. Signals
  124. ~~~~~~~
  125. * ...
  126. Templates
  127. ~~~~~~~~~
  128. * ...
  129. Tests
  130. ~~~~~
  131. * ...
  132. URLs
  133. ~~~~
  134. * ...
  135. Utilities
  136. ~~~~~~~~~
  137. * ...
  138. Validators
  139. ~~~~~~~~~~
  140. * ...
  141. .. _backwards-incompatible-5.2:
  142. Backwards incompatible changes in 5.2
  143. =====================================
  144. Database backend API
  145. --------------------
  146. This section describes changes that may be needed in third-party database
  147. backends.
  148. * ...
  149. :mod:`django.contrib.gis`
  150. -------------------------
  151. * Support for PostGIS 3.0 is removed.
  152. Dropped support for PostgreSQL 13
  153. ---------------------------------
  154. Upstream support for PostgreSQL 13 ends in November 2025. Django 5.2 supports
  155. PostgreSQL 14 and higher.
  156. Miscellaneous
  157. -------------
  158. * ...
  159. .. _deprecated-features-5.2:
  160. Features deprecated in 5.2
  161. ==========================
  162. Miscellaneous
  163. -------------
  164. * ...