2020-05-04 09:46:46 +00:00
|
|
|
============================================
|
|
|
|
Django 3.2 release notes - UNDER DEVELOPMENT
|
|
|
|
============================================
|
|
|
|
|
|
|
|
*Expected April 2021*
|
|
|
|
|
|
|
|
Welcome to Django 3.2!
|
|
|
|
|
|
|
|
These release notes cover the :ref:`new features <whats-new-3.2>`, as well as
|
|
|
|
some :ref:`backwards incompatible changes <backwards-incompatible-3.2>` you'll
|
|
|
|
want to be aware of when upgrading from Django 3.1 or earlier. We've
|
|
|
|
:ref:`begun the deprecation process for some features
|
|
|
|
<deprecated-features-3.2>`.
|
|
|
|
|
|
|
|
See the :doc:`/howto/upgrade-version` guide if you're updating an existing
|
|
|
|
project.
|
|
|
|
|
|
|
|
Django 3.2 is designated as a :term:`long-term support release
|
|
|
|
<Long-term support release>`. It will receive security updates for at least
|
|
|
|
three years after its release. Support for the previous LTS, Django 2.2, will
|
|
|
|
end in April 2022.
|
|
|
|
|
|
|
|
Python compatibility
|
|
|
|
====================
|
|
|
|
|
2020-10-13 06:35:01 +00:00
|
|
|
Django 3.2 supports Python 3.6, 3.7, 3.8, and 3.9. We **highly recommend** and
|
|
|
|
only officially support the latest release of each series.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
.. _whats-new-3.2:
|
|
|
|
|
|
|
|
What's new in Django 3.2
|
|
|
|
========================
|
|
|
|
|
2020-07-21 08:35:12 +00:00
|
|
|
Automatic :class:`~django.apps.AppConfig` discovery
|
|
|
|
---------------------------------------------------
|
|
|
|
|
|
|
|
Most pluggable applications define an :class:`~django.apps.AppConfig` subclass
|
|
|
|
in an ``apps.py`` submodule. Many define a ``default_app_config`` variable
|
|
|
|
pointing to this class in their ``__init__.py``.
|
|
|
|
|
|
|
|
When the ``apps.py`` submodule exists and defines a single
|
|
|
|
:class:`~django.apps.AppConfig` subclass, Django now uses that configuration
|
|
|
|
automatically, so you can remove ``default_app_config``.
|
|
|
|
|
|
|
|
``default_app_config`` made it possible to declare only the application's path
|
|
|
|
in :setting:`INSTALLED_APPS` (e.g. ``'django.contrib.admin'``) rather than the
|
|
|
|
app config's path (e.g. ``'django.contrib.admin.apps.AdminConfig'``). It was
|
|
|
|
introduced for backwards-compatibility with the former style, with the intent
|
|
|
|
to switch the ecosystem to the latter, but the switch didn't happen.
|
|
|
|
|
|
|
|
With automatic ``AppConfig`` discovery, ``default_app_config`` is no longer
|
|
|
|
needed. As a consequence, it's deprecated.
|
|
|
|
|
|
|
|
See :ref:`configuring-applications-ref` for full details.
|
|
|
|
|
2019-01-18 23:26:50 +00:00
|
|
|
``pymemcache`` support
|
|
|
|
----------------------
|
|
|
|
|
|
|
|
The new ``django.core.cache.backends.memcached.PyMemcacheCache`` cache backend
|
|
|
|
allows using the pymemcache_ library for memcached. ``pymemcache`` 3.4.0 or
|
|
|
|
higher is required. For more details, see the :doc:`documentation on caching in
|
|
|
|
Django </topics/cache>`.
|
|
|
|
|
|
|
|
.. _pymemcache: https://pypi.org/project/pymemcache/
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
Minor features
|
|
|
|
--------------
|
|
|
|
|
|
|
|
:mod:`django.contrib.admin`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-05-26 15:53:18 +00:00
|
|
|
* :attr:`.ModelAdmin.search_fields` now allows searching against quoted phrases
|
|
|
|
with spaces.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-01-18 18:03:03 +00:00
|
|
|
* Read-only related fields are now rendered as navigable links if target models
|
|
|
|
are registered in the admin.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
:mod:`django.contrib.admindocs`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
:mod:`django.contrib.auth`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-05-04 10:19:16 +00:00
|
|
|
* The default iteration count for the PBKDF2 password hasher is increased from
|
|
|
|
216,000 to 260,000.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-06-17 06:07:10 +00:00
|
|
|
* The default variant for the Argon2 password hasher is changed to Argon2id.
|
|
|
|
``memory_cost`` and ``parallelism`` are increased to 102,400 and 8
|
|
|
|
respectively to match the ``argon2-cffi`` defaults.
|
|
|
|
|
|
|
|
Increasing the ``memory_cost`` pushes the required memory from 512 KB to 100
|
|
|
|
MB. This is still rather conservative but can lead to problems in memory
|
|
|
|
constrained environments. If this is the case, the existing hasher can be
|
|
|
|
subclassed to override the defaults.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
:mod:`django.contrib.contenttypes`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-08-17 11:27:08 +00:00
|
|
|
* The new ``absolute_max`` argument for
|
|
|
|
:func:`~django.contrib.contenttypes.forms.generic_inlineformset_factory`
|
|
|
|
allows customizing the maximum number of forms that can be instantiated when
|
|
|
|
supplying ``POST`` data. See :ref:`formsets-absolute-max` for more details.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-08-17 11:34:13 +00:00
|
|
|
* The new ``can_delete_extra`` argument for
|
|
|
|
:func:`~django.contrib.contenttypes.forms.generic_inlineformset_factory`
|
|
|
|
allows removal of the option to delete extra forms. See
|
|
|
|
:attr:`~.BaseFormSet.can_delete_extra` for more information.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
:mod:`django.contrib.gis`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-06-18 12:52:02 +00:00
|
|
|
* The :meth:`.GDALRaster.transform` method now supports
|
|
|
|
:class:`~django.contrib.gis.gdal.SpatialReference`.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
:mod:`django.contrib.messages`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-08-25 04:13:19 +00:00
|
|
|
* ...
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
:mod:`django.contrib.postgres`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-06-11 19:05:38 +00:00
|
|
|
* The new :attr:`.ExclusionConstraint.include` attribute allows creating
|
|
|
|
covering exclusion constraints on PostgreSQL 12+.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-06-14 18:50:39 +00:00
|
|
|
* The new :attr:`.ExclusionConstraint.opclasses` attribute allows setting
|
|
|
|
PostgreSQL operator classes.
|
|
|
|
|
2020-06-12 14:55:22 +00:00
|
|
|
* The new :attr:`.JSONBAgg.ordering` attribute determines the ordering of the
|
|
|
|
aggregated elements.
|
2020-08-25 08:01:37 +00:00
|
|
|
|
2020-08-25 04:13:19 +00:00
|
|
|
* The :class:`~django.contrib.postgres.operations.CreateExtension` operation
|
|
|
|
now checks that the extension already exists in the database and skips the
|
|
|
|
migration if so.
|
2020-06-12 14:55:22 +00:00
|
|
|
|
2020-09-30 12:00:59 +00:00
|
|
|
* The new :class:`~django.contrib.postgres.operations.CreateCollation` and
|
|
|
|
:class:`~django.contrib.postgres.operations.RemoveCollation` operations
|
|
|
|
allow creating and dropping collations on PostgreSQL. See
|
|
|
|
:ref:`manage-postgresql-collations` for more details.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
:mod:`django.contrib.redirects`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
:mod:`django.contrib.sessions`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
:mod:`django.contrib.sitemaps`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-07-29 08:33:20 +00:00
|
|
|
* The new :class:`~django.contrib.sitemaps.Sitemap` attributes
|
|
|
|
:attr:`~django.contrib.sitemaps.Sitemap.alternates`,
|
|
|
|
:attr:`~django.contrib.sitemaps.Sitemap.languages` and
|
|
|
|
:attr:`~django.contrib.sitemaps.Sitemap.x_default` allow
|
|
|
|
generating sitemap *alternates* to localized versions of your pages.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
:mod:`django.contrib.sites`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
:mod:`django.contrib.staticfiles`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
:mod:`django.contrib.syndication`
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-07-23 14:42:25 +00:00
|
|
|
* The new ``item_comments`` hook allows specifying a comments URL per feed
|
|
|
|
item.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
Cache
|
|
|
|
~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
CSRF
|
|
|
|
~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
2020-10-20 07:14:48 +00:00
|
|
|
Decorators
|
|
|
|
~~~~~~~~~~
|
|
|
|
|
|
|
|
* The new :func:`~django.views.decorators.common.no_append_slash` decorator
|
|
|
|
allows individual views to be excluded from :setting:`APPEND_SLASH` URL
|
|
|
|
normalization.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
Email
|
|
|
|
~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
Error Reporting
|
|
|
|
~~~~~~~~~~~~~~~
|
|
|
|
|
2020-10-15 09:44:02 +00:00
|
|
|
* Custom :class:`~django.views.debug.ExceptionReporter` subclasses can now set
|
|
|
|
the :attr:`~django.views.debug.ExceptionReporter.html_template_path` and
|
|
|
|
:attr:`~django.views.debug.ExceptionReporter.text_template_path` class
|
|
|
|
attributes to override the templates used to render exception reports.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
File Storage
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
File Uploads
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
2020-02-19 18:53:48 +00:00
|
|
|
* The new :meth:`FileUploadHandler.upload_interrupted()
|
|
|
|
<django.core.files.uploadhandler.FileUploadHandler.upload_interrupted>`
|
|
|
|
callback allows handling interrupted uploads.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
Forms
|
|
|
|
~~~~~
|
|
|
|
|
2020-04-30 07:34:53 +00:00
|
|
|
* The new ``absolute_max`` argument for :func:`.formset_factory`,
|
|
|
|
:func:`.inlineformset_factory`, and :func:`.modelformset_factory` allows
|
|
|
|
customizing the maximum number of forms that can be instantiated when
|
|
|
|
supplying ``POST`` data. See :ref:`formsets-absolute-max` for more details.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-06-19 21:46:25 +00:00
|
|
|
* The new ``can_delete_extra`` argument for :func:`.formset_factory`,
|
|
|
|
:func:`.inlineformset_factory`, and :func:`.modelformset_factory` allows
|
|
|
|
removal of the option to delete extra forms. See
|
|
|
|
:attr:`~.BaseFormSet.can_delete_extra` for more information.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
Generic Views
|
|
|
|
~~~~~~~~~~~~~
|
|
|
|
|
2020-06-25 21:00:51 +00:00
|
|
|
* The ``week_format`` attributes of
|
|
|
|
:class:`~django.views.generic.dates.WeekMixin` and
|
|
|
|
:class:`~django.views.generic.dates.WeekArchiveView` now support the
|
|
|
|
``'%V'`` ISO 8601 week format.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
Internationalization
|
|
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
Logging
|
|
|
|
~~~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
Management Commands
|
|
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-05-15 07:40:42 +00:00
|
|
|
* :djadmin:`loaddata` now supports fixtures stored in XZ archives (``.xz``) and
|
|
|
|
LZMA archives (``.lzma``).
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-04-25 18:54:20 +00:00
|
|
|
* :djadmin:`makemigrations` can now be called without an active database
|
|
|
|
connection. In that case, check for a consistent migration history is
|
|
|
|
skipped.
|
|
|
|
|
2020-05-13 22:00:41 +00:00
|
|
|
* :attr:`.BaseCommand.requires_system_checks` now supports specifying a list of
|
|
|
|
tags. System checks registered in the chosen tags will be checked for errors
|
|
|
|
prior to executing the command. In previous versions, either all or none
|
|
|
|
of the system checks were performed.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
Migrations
|
|
|
|
~~~~~~~~~~
|
|
|
|
|
2019-11-23 11:08:45 +00:00
|
|
|
* The new ``Operation.migration_name_fragment`` property allows providing a
|
|
|
|
filename fragment that will be used to name a migration containing only that
|
|
|
|
operation.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-05-01 14:05:20 +00:00
|
|
|
* Migrations now support serialization of pure and concrete path objects from
|
|
|
|
:mod:`pathlib`, and :class:`os.PathLike` instances.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
Models
|
|
|
|
~~~~~~
|
|
|
|
|
2020-05-10 16:25:06 +00:00
|
|
|
* The new ``no_key`` parameter for :meth:`.QuerySet.select_for_update()`,
|
|
|
|
supported on PostgreSQL, allows acquiring weaker locks that don't block the
|
|
|
|
creation of rows that reference locked rows through a foreign key.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-05-19 05:47:56 +00:00
|
|
|
* :class:`When() <django.db.models.expressions.When>` expression now allows
|
|
|
|
using the ``condition`` argument with ``lookups``.
|
|
|
|
|
2019-10-31 12:33:53 +00:00
|
|
|
* The new :attr:`.Index.include` and :attr:`.UniqueConstraint.include`
|
|
|
|
attributes allow creating covering indexes and covering unique constraints on
|
|
|
|
PostgreSQL 11+.
|
|
|
|
|
2020-06-11 19:37:12 +00:00
|
|
|
* The new :attr:`.UniqueConstraint.opclasses` attribute allows setting
|
|
|
|
PostgreSQL operator classes.
|
|
|
|
|
2020-06-20 04:55:03 +00:00
|
|
|
* The :meth:`.QuerySet.update` method now respects the ``order_by()`` clause on
|
|
|
|
MySQL and MariaDB.
|
|
|
|
|
2020-01-06 23:44:32 +00:00
|
|
|
* :class:`FilteredRelation() <django.db.models.FilteredRelation>` now supports
|
|
|
|
nested relations.
|
|
|
|
|
2020-07-12 04:25:03 +00:00
|
|
|
* The ``of`` argument of :meth:`.QuerySet.select_for_update()` is now allowed
|
|
|
|
on MySQL 8.0.1+.
|
|
|
|
|
2019-05-12 21:17:47 +00:00
|
|
|
* :class:`Value() <django.db.models.Value>` expression now
|
|
|
|
automatically resolves its ``output_field`` to the appropriate
|
|
|
|
:class:`Field <django.db.models.Field>` subclass based on the type of
|
2020-10-21 06:06:24 +00:00
|
|
|
its provided ``value`` for :py:class:`bool`, :py:class:`bytes`,
|
2019-05-12 21:17:47 +00:00
|
|
|
:py:class:`float`, :py:class:`int`, :py:class:`str`,
|
|
|
|
:py:class:`datetime.date`, :py:class:`datetime.datetime`,
|
|
|
|
:py:class:`datetime.time`, :py:class:`datetime.timedelta`,
|
2020-09-09 10:54:25 +00:00
|
|
|
:py:class:`decimal.Decimal`, and :py:class:`uuid.UUID` instances. As a
|
|
|
|
consequence, resolving an ``output_field`` for database functions and
|
|
|
|
combined expressions may now crash with mixed types when using ``Value()``.
|
|
|
|
You will need to explicitly set the ``output_field`` in such cases.
|
2019-05-12 21:17:47 +00:00
|
|
|
|
2020-06-14 18:38:43 +00:00
|
|
|
* The new :meth:`.QuerySet.alias` method allows creating reusable aliases for
|
|
|
|
expressions that don't need to be selected but are used for filtering,
|
|
|
|
ordering, or as a part of complex expressions.
|
|
|
|
|
2020-08-08 11:37:06 +00:00
|
|
|
* The new :class:`~django.db.models.functions.Collate` function allows
|
|
|
|
filtering and ordering by specified database collations.
|
|
|
|
|
2020-08-22 05:53:50 +00:00
|
|
|
* The ``field_name`` argument of :meth:`.QuerySet.in_bulk()` now accepts
|
|
|
|
distinct fields if there's only one field specified in
|
|
|
|
:meth:`.QuerySet.distinct`.
|
|
|
|
|
2020-08-29 18:40:54 +00:00
|
|
|
* The new ``tzinfo`` parameter of the
|
|
|
|
:class:`~django.db.models.functions.TruncDate` and
|
|
|
|
:class:`~django.db.models.functions.TruncTime` database functions allows
|
|
|
|
truncating datetimes in a specific timezone.
|
|
|
|
|
2020-07-18 11:17:39 +00:00
|
|
|
* The new ``db_collation`` argument for
|
|
|
|
:attr:`CharField <django.db.models.CharField.db_collation>` and
|
|
|
|
:attr:`TextField <django.db.models.TextField.db_collation>` allows setting a
|
|
|
|
database collation for the field.
|
|
|
|
|
2020-07-16 22:32:46 +00:00
|
|
|
* Added the :class:`~django.db.models.functions.Random` database function.
|
|
|
|
|
2020-08-06 09:43:42 +00:00
|
|
|
Pagination
|
|
|
|
~~~~~~~~~~
|
|
|
|
|
|
|
|
* The new :meth:`django.core.paginator.Paginator.get_elided_page_range` method
|
|
|
|
allows generating a page range with some of the values elided. If there are a
|
|
|
|
large number of pages, this can be helpful for generating a reasonable number
|
|
|
|
of page links in a template.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
Requests and Responses
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-07-14 11:32:24 +00:00
|
|
|
* Response headers are now stored in :attr:`.HttpResponse.headers`. This can be
|
|
|
|
used instead of the original dict-like interface of ``HttpResponse`` objects.
|
|
|
|
Both interfaces will continue to be supported. See
|
|
|
|
:ref:`setting-header-fields` for details.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-09-15 10:43:37 +00:00
|
|
|
* The new ``headers`` parameter of :class:`~django.http.HttpResponse`,
|
|
|
|
:class:`~django.template.response.SimpleTemplateResponse`, and
|
|
|
|
:class:`~django.template.response.TemplateResponse` allows setting response
|
|
|
|
:attr:`~django.http.HttpResponse.headers` on instantiation.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
Security
|
|
|
|
~~~~~~~~
|
|
|
|
|
2020-07-29 07:06:54 +00:00
|
|
|
* The :setting:`SECRET_KEY` setting is now checked for a valid value upon first
|
|
|
|
access, rather than when settings are first loaded. This enables running
|
|
|
|
management commands that do not rely on the ``SECRET_KEY`` without needing to
|
|
|
|
provide a value. As a consequence of this, calling
|
|
|
|
:func:`~django.conf.settings.configure` without providing a valid
|
|
|
|
``SECRET_KEY``, and then going on to access ``settings.SECRET_KEY`` will now
|
|
|
|
raise an :exc:`~django.core.exceptions.ImproperlyConfigured` exception.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
Serialization
|
|
|
|
~~~~~~~~~~~~~
|
|
|
|
|
2020-06-16 14:51:58 +00:00
|
|
|
* The new :ref:`JSONL <serialization-formats-jsonl>` serializer allows using
|
|
|
|
the JSON Lines format with :djadmin:`dumpdata` and :djadmin:`loaddata`. This
|
|
|
|
can be useful for populating large databases because data is loaded line by
|
|
|
|
line into memory, rather than being loaded all at once.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
Signals
|
|
|
|
~~~~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
Templates
|
|
|
|
~~~~~~~~~
|
|
|
|
|
2020-10-12 03:34:32 +00:00
|
|
|
* :tfilter:`floatformat` template filter now allows using the ``g`` suffix to
|
|
|
|
force grouping by the :setting:`THOUSAND_SEPARATOR` for the active locale.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
Tests
|
|
|
|
~~~~~
|
|
|
|
|
2018-11-24 02:22:09 +00:00
|
|
|
* Objects assigned to class attributes in :meth:`.TestCase.setUpTestData` are
|
|
|
|
now isolated for each test method. Such objects are now required to support
|
|
|
|
creating deep copies with :py:func:`copy.deepcopy`. Assigning objects which
|
|
|
|
don't support ``deepcopy()`` is deprecated and will be removed in Django 4.1.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-05-06 17:52:12 +00:00
|
|
|
* :class:`~django.test.runner.DiscoverRunner` now enables
|
|
|
|
:py:mod:`faulthandler` by default. This can be disabled by using the
|
|
|
|
:option:`test --no-faulthandler` option.
|
|
|
|
|
2020-07-22 15:37:52 +00:00
|
|
|
* :class:`~django.test.runner.DiscoverRunner` and the
|
|
|
|
:djadmin:`test` management command can now track timings, including database
|
|
|
|
setup and total run time. This can be enabled by using the :option:`test
|
|
|
|
--timing` option.
|
|
|
|
|
2020-05-27 06:10:08 +00:00
|
|
|
* :class:`~django.test.Client` now preserves the request query string when
|
|
|
|
following 307 and 308 redirects.
|
|
|
|
|
2020-05-20 10:04:36 +00:00
|
|
|
* The new :meth:`.TestCase.captureOnCommitCallbacks` method captures callback
|
|
|
|
functions passed to :func:`transaction.on_commit()
|
|
|
|
<django.db.transaction.on_commit>` in a list. This allows you to test such
|
|
|
|
callbacks without using the slower :class:`.TransactionTestCase`.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
URLs
|
|
|
|
~~~~
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
Utilities
|
|
|
|
~~~~~~~~~
|
|
|
|
|
2020-07-03 06:01:45 +00:00
|
|
|
* The new ``depth`` parameter of ``django.utils.timesince.timesince()`` and
|
|
|
|
``django.utils.timesince.timeuntil()`` functions allows specifying the number
|
|
|
|
of adjacent time units to return.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
|
|
|
Validators
|
|
|
|
~~~~~~~~~~
|
|
|
|
|
2020-07-20 23:11:23 +00:00
|
|
|
* Built-in validators now include the provided value in the ``params`` argument
|
|
|
|
of a raised :exc:`~django.core.exceptions.ValidationError`. This allows
|
|
|
|
custom error messages to use the ``%(value)s`` placeholder.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-07-21 19:05:33 +00:00
|
|
|
* The :class:`.ValidationError` equality operator now ignores ``messages`` and
|
|
|
|
``params`` ordering.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
.. _backwards-incompatible-3.2:
|
|
|
|
|
|
|
|
Backwards incompatible changes in 3.2
|
|
|
|
=====================================
|
|
|
|
|
|
|
|
Database backend API
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
This section describes changes that may be needed in third-party database
|
|
|
|
backends.
|
|
|
|
|
2020-05-26 22:25:45 +00:00
|
|
|
* The new ``DatabaseFeatures.introspected_field_types`` property replaces these
|
|
|
|
features:
|
|
|
|
|
2020-06-02 00:18:14 +00:00
|
|
|
* ``can_introspect_autofield``
|
2020-05-26 22:25:45 +00:00
|
|
|
* ``can_introspect_big_integer_field``
|
|
|
|
* ``can_introspect_binary_field``
|
|
|
|
* ``can_introspect_decimal_field``
|
|
|
|
* ``can_introspect_duration_field``
|
|
|
|
* ``can_introspect_ip_address_field``
|
|
|
|
* ``can_introspect_positive_integer_field``
|
|
|
|
* ``can_introspect_small_integer_field``
|
|
|
|
* ``can_introspect_time_field``
|
|
|
|
* ``introspected_big_auto_field_type``
|
|
|
|
* ``introspected_small_auto_field_type``
|
|
|
|
* ``introspected_boolean_field_type``
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2019-10-31 12:33:53 +00:00
|
|
|
* To enable support for covering indexes (:attr:`.Index.include`) and covering
|
|
|
|
unique constraints (:attr:`.UniqueConstraint.include`), set
|
|
|
|
``DatabaseFeatures.supports_covering_indexes`` to ``True``.
|
|
|
|
|
2020-07-18 11:17:39 +00:00
|
|
|
* Third-party database backends must implement support for column database
|
|
|
|
collations on ``CharField``\s and ``TextField``\s or set
|
|
|
|
``DatabaseFeatures.supports_collation_on_charfield`` and
|
|
|
|
``DatabaseFeatures.supports_collation_on_textfield`` to ``False``. If
|
|
|
|
non-deterministic collations are not supported, set
|
|
|
|
``supports_non_deterministic_collations`` to ``False``.
|
|
|
|
|
2020-07-16 22:32:46 +00:00
|
|
|
* ``DatabaseOperations.random_function_sql()`` is removed in favor of the new
|
|
|
|
:class:`~django.db.models.functions.Random` database function.
|
|
|
|
|
2020-10-04 17:28:21 +00:00
|
|
|
* ``DatabaseOperations.date_trunc_sql()`` and
|
|
|
|
``DatabaseOperations.time_trunc_sql()`` now take the optional ``tzname``
|
|
|
|
argument in order to truncate in a specific timezone.
|
|
|
|
|
2020-07-30 11:45:32 +00:00
|
|
|
:mod:`django.contrib.admin`
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
* Pagination links in the admin are now 1-indexed instead of 0-indexed, i.e.
|
|
|
|
the query string for the first page is ``?p=1`` instead of ``?p=0``.
|
|
|
|
|
2020-05-14 04:33:00 +00:00
|
|
|
:mod:`django.contrib.gis`
|
|
|
|
-------------------------
|
|
|
|
|
|
|
|
* Support for PostGIS 2.2 is removed.
|
|
|
|
|
2020-10-22 00:20:26 +00:00
|
|
|
* The Oracle backend now clones polygons (and geometry collections containing
|
|
|
|
polygons) before reorienting them and saving them to the database. They are
|
|
|
|
no longer mutated in place. You might notice this if you use the polygons
|
|
|
|
after a model is saved.
|
|
|
|
|
2020-05-14 04:33:00 +00:00
|
|
|
Dropped support for PostgreSQL 9.5
|
|
|
|
----------------------------------
|
|
|
|
|
|
|
|
Upstream support for PostgreSQL 9.5 ends in February 2021. Django 3.2 supports
|
|
|
|
PostgreSQL 9.6 and higher.
|
|
|
|
|
2020-05-19 08:56:39 +00:00
|
|
|
Dropped support for MySQL 5.6
|
|
|
|
-----------------------------
|
|
|
|
|
|
|
|
The end of upstream support for MySQL 5.6 is April 2021. Django 3.2 supports
|
|
|
|
MySQL 5.7 and higher.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
Miscellaneous
|
|
|
|
-------------
|
|
|
|
|
2020-05-10 20:30:03 +00:00
|
|
|
* The undocumented ``SpatiaLiteOperations.proj4_version()`` method is renamed
|
|
|
|
to ``proj_version()``.
|
2020-05-04 09:46:46 +00:00
|
|
|
|
2020-05-14 15:17:05 +00:00
|
|
|
* Minified JavaScript files are no longer included with the admin. If you
|
|
|
|
require these files to be minified, consider using a third party app or
|
|
|
|
external build tool. The minified vendored JavaScript files packaged with the
|
|
|
|
admin (e.g. :ref:`jquery.min.js <contrib-admin-jquery>`) are still included.
|
|
|
|
|
2020-05-20 17:11:30 +00:00
|
|
|
* :attr:`.ModelAdmin.prepopulated_fields` no longer strips English stop words,
|
|
|
|
such as ``'a'`` or ``'an'``.
|
|
|
|
|
2020-05-26 21:56:41 +00:00
|
|
|
* :func:`~django.utils.text.slugify` now removes leading and trailing dashes
|
|
|
|
and underscores.
|
|
|
|
|
2020-05-22 18:39:47 +00:00
|
|
|
* The :tfilter:`intcomma` and :tfilter:`intword` template filters no longer
|
|
|
|
depend on the :setting:`USE_L10N` setting.
|
|
|
|
|
2020-06-17 05:46:45 +00:00
|
|
|
* Support for ``argon2-cffi`` < 19.1.0 is removed.
|
|
|
|
|
2020-05-22 17:43:03 +00:00
|
|
|
* The cache keys no longer includes the language when internationalization is
|
|
|
|
disabled (``USE_I18N = False``) and localization is enabled
|
|
|
|
(``USE_L10N = True``). After upgrading to Django 3.2 in such configurations,
|
|
|
|
the first request to any previously cached value will be a cache miss.
|
|
|
|
|
2020-06-25 08:28:52 +00:00
|
|
|
* ``ForeignKey.validate()`` now uses
|
|
|
|
:attr:`~django.db.models.Model._base_manager` rather than
|
|
|
|
:attr:`~django.db.models.Model._default_manager` to check that related
|
|
|
|
instances exist.
|
|
|
|
|
2020-07-21 08:35:12 +00:00
|
|
|
* When an application defines an :class:`~django.apps.AppConfig` subclass in
|
|
|
|
an ``apps.py`` submodule, Django now uses this configuration automatically,
|
|
|
|
even if it isn't enabled with ``default_app_config``. Set ``default = False``
|
|
|
|
in the :class:`~django.apps.AppConfig` subclass if you need to prevent this
|
|
|
|
behavior. See :ref:`whats-new-3.2` for more details.
|
|
|
|
|
2020-08-02 20:20:30 +00:00
|
|
|
* Instantiating an abstract model now raises ``TypeError``.
|
|
|
|
|
2020-07-22 15:37:52 +00:00
|
|
|
* Keyword arguments to :func:`~django.test.utils.setup_databases` are now
|
|
|
|
keyword-only.
|
|
|
|
|
2019-11-04 12:06:49 +00:00
|
|
|
* The undocumented ``django.utils.http.limited_parse_qsl()`` function is
|
|
|
|
removed. Please use :func:`urllib.parse.parse_qsl` instead.
|
|
|
|
|
2020-09-06 12:36:20 +00:00
|
|
|
* ``django.test.utils.TestContextDecorator`` now uses
|
|
|
|
:py:meth:`~unittest.TestCase.addCleanup` so that cleanups registered in the
|
|
|
|
:py:meth:`~unittest.TestCase.setUp` method are called before
|
|
|
|
``TestContextDecorator.disable()``.
|
|
|
|
|
2020-09-07 11:33:47 +00:00
|
|
|
* ``SessionMiddleware`` now raises a
|
|
|
|
:exc:`~django.contrib.sessions.exceptions.SessionInterrupted` exception
|
|
|
|
instead of :exc:`~django.core.exceptions.SuspiciousOperation` when a session
|
|
|
|
is destroyed in a concurrent request.
|
|
|
|
|
2020-06-30 04:16:05 +00:00
|
|
|
* The :class:`django.db.models.Field` equality operator now correctly
|
|
|
|
distinguishes inherited field instances across models. Additionally, the
|
|
|
|
ordering of such fields is now defined.
|
|
|
|
|
2020-09-11 09:48:40 +00:00
|
|
|
* The undocumented ``django.core.files.locks.lock()`` function now returns
|
|
|
|
``False`` if the file cannot be locked, instead of raising
|
|
|
|
:exc:`BlockingIOError`.
|
|
|
|
|
2016-05-16 01:54:03 +00:00
|
|
|
* The password reset mechanism now invalidates tokens when the user email is
|
|
|
|
changed.
|
|
|
|
|
2020-05-04 09:46:46 +00:00
|
|
|
.. _deprecated-features-3.2:
|
|
|
|
|
|
|
|
Features deprecated in 3.2
|
|
|
|
==========================
|
|
|
|
|
|
|
|
Miscellaneous
|
|
|
|
-------------
|
|
|
|
|
2018-11-24 02:22:09 +00:00
|
|
|
* Assigning objects which don't support creating deep copies with
|
|
|
|
:py:func:`copy.deepcopy` to class attributes in
|
|
|
|
:meth:`.TestCase.setUpTestData` is deprecated.
|
2020-05-13 22:00:41 +00:00
|
|
|
|
|
|
|
* Using a boolean value in :attr:`.BaseCommand.requires_system_checks` is
|
|
|
|
deprecated. Use ``'__all__'`` instead of ``True``, and ``[]`` (an empty list)
|
|
|
|
instead of ``False``.
|
2020-06-17 06:35:09 +00:00
|
|
|
|
|
|
|
* The ``whitelist`` argument and ``domain_whitelist`` attribute of
|
|
|
|
:class:`~django.core.validators.EmailValidator` are deprecated. Use
|
|
|
|
``allowlist`` instead of ``whitelist``, and ``domain_allowlist`` instead of
|
|
|
|
``domain_whitelist``. You may need to rename ``whitelist`` in existing
|
|
|
|
migrations.
|
2020-07-21 08:35:12 +00:00
|
|
|
|
|
|
|
* The ``default_app_config`` application configuration variable is deprecated,
|
|
|
|
due to the now automatic ``AppConfig`` discovery. See :ref:`whats-new-3.2`
|
|
|
|
for more details.
|