2018-05-17 22:17:53 +08:00
|
|
|
============================================
|
|
|
|
|
Django 2.2 release notes - UNDER DEVELOPMENT
|
|
|
|
|
============================================
|
|
|
|
|
|
|
|
|
|
*Expected April 2019*
|
|
|
|
|
|
|
|
|
|
Welcome to Django 2.2!
|
|
|
|
|
|
|
|
|
|
These release notes cover the :ref:`new features <whats-new-2.2>`, as well as
|
|
|
|
|
some :ref:`backwards incompatible changes <backwards-incompatible-2.2>` you'll
|
|
|
|
|
want to be aware of when upgrading from Django 2.1 or earlier. We've
|
|
|
|
|
:ref:`begun the deprecation process for some features
|
|
|
|
|
<deprecated-features-2.2>`.
|
|
|
|
|
|
|
|
|
|
See the :doc:`/howto/upgrade-version` guide if you're updating an existing
|
|
|
|
|
project.
|
|
|
|
|
|
|
|
|
|
Django 2.2 is designated as a :term:`long-term support release`. It will
|
|
|
|
|
receive security updates for at least three years after its release. Support
|
|
|
|
|
for the previous LTS, Django 1.11, will end in April 2020.
|
|
|
|
|
|
|
|
|
|
Python compatibility
|
|
|
|
|
====================
|
|
|
|
|
|
|
|
|
|
Django 2.2 supports Python 3.5, 3.6, and 3.7. We **highly recommend** and only
|
|
|
|
|
officially support the latest release of each series.
|
|
|
|
|
|
|
|
|
|
.. _whats-new-2.2:
|
|
|
|
|
|
|
|
|
|
What's new in Django 2.2
|
|
|
|
|
========================
|
|
|
|
|
|
2016-11-05 21:12:12 +08:00
|
|
|
Check Constraints
|
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
|
|
The new :class:`~django.db.models.CheckConstraint` class enables adding custom
|
|
|
|
|
database constraints. Constraints are added to models using the
|
|
|
|
|
:attr:`Meta.constraints <django.db.models.Options.constraints>` option.
|
|
|
|
|
|
2018-05-17 22:17:53 +08:00
|
|
|
Minor features
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.admin`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.admindocs`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.auth`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.contenttypes`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.gis`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
2018-06-20 19:48:57 +08:00
|
|
|
* Added Oracle support for the
|
|
|
|
|
:class:`~django.contrib.gis.db.models.functions.Envelope` function.
|
2018-05-17 22:17:53 +08:00
|
|
|
|
2018-06-21 21:25:31 +08:00
|
|
|
* Added SpatiaLite support for the :lookup:`coveredby` and :lookup:`covers`
|
|
|
|
|
lookups.
|
|
|
|
|
|
2018-05-17 22:17:53 +08:00
|
|
|
:mod:`django.contrib.messages`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.postgres`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
2016-07-05 17:47:24 +08:00
|
|
|
* The new ``ordering`` argument for
|
|
|
|
|
:class:`~django.contrib.postgres.aggregates.ArrayAgg` and
|
|
|
|
|
:class:`~django.contrib.postgres.aggregates.StringAgg` determines the
|
|
|
|
|
ordering of the aggregated elements.
|
2018-05-17 22:17:53 +08:00
|
|
|
|
|
|
|
|
:mod:`django.contrib.redirects`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.sessions`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.sitemaps`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.sites`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.staticfiles`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
:mod:`django.contrib.syndication`
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Cache
|
|
|
|
|
~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
CSRF
|
|
|
|
|
~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Database backends
|
|
|
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Email
|
|
|
|
|
~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
File Storage
|
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
File Uploads
|
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Forms
|
|
|
|
|
~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Generic Views
|
|
|
|
|
~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Internationalization
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Management Commands
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Migrations
|
|
|
|
|
~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Models
|
|
|
|
|
~~~~~~
|
|
|
|
|
|
2017-10-12 01:25:52 +08:00
|
|
|
* Added support for PostgreSQL operator classes (:attr:`.Index.opclasses`).
|
2018-05-17 22:17:53 +08:00
|
|
|
|
2018-07-05 23:02:12 +08:00
|
|
|
* Added many :ref:`math database functions <math-functions>`.
|
|
|
|
|
|
2018-05-17 22:17:53 +08:00
|
|
|
Requests and Responses
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Serialization
|
|
|
|
|
~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Signals
|
|
|
|
|
~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Templates
|
|
|
|
|
~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Tests
|
|
|
|
|
~~~~~
|
|
|
|
|
|
2017-12-20 03:05:10 +08:00
|
|
|
* The new :meth:`.SimpleTestCase.assertURLEqual` assertion checks for a given
|
|
|
|
|
URL, ignoring the ordering of the query string.
|
|
|
|
|
:meth:`~.SimpleTestCase.assertRedirects` uses the new assertion.
|
2018-05-17 22:17:53 +08:00
|
|
|
|
|
|
|
|
URLs
|
|
|
|
|
~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
Validators
|
|
|
|
|
~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
|
|
|
|
.. _backwards-incompatible-2.2:
|
|
|
|
|
|
|
|
|
|
Backwards incompatible changes in 2.2
|
|
|
|
|
=====================================
|
|
|
|
|
|
|
|
|
|
Database backend API
|
|
|
|
|
--------------------
|
|
|
|
|
|
2016-11-05 21:12:12 +08:00
|
|
|
* Third-party database backends must implement support for table check
|
|
|
|
|
constraints or set ``DatabaseFeatures.supports_table_check_constraints`` to
|
|
|
|
|
``False``.
|
2018-05-17 22:17:53 +08:00
|
|
|
|
|
|
|
|
:mod:`django.contrib.gis`
|
|
|
|
|
-------------------------
|
|
|
|
|
|
2018-06-11 20:33:09 +08:00
|
|
|
* Support for GDAL 1.9 and 1.10 is dropped.
|
2018-05-17 22:17:53 +08:00
|
|
|
|
|
|
|
|
Miscellaneous
|
|
|
|
|
-------------
|
|
|
|
|
|
2018-06-23 02:42:51 +08:00
|
|
|
* On SQLite, ``PositiveIntegerField`` and ``PositiveSmallIntegerField`` now
|
|
|
|
|
include a check constraint to prevent negative values in the database. If you
|
|
|
|
|
have existing invalid data and run a migration that recreates a table, you'll
|
|
|
|
|
see ``CHECK constraint failed``.
|
2018-05-17 22:17:53 +08:00
|
|
|
|
2018-07-09 23:44:49 +08:00
|
|
|
* For consistency with WSGI servers, the test client now sets the
|
|
|
|
|
``Content-Length`` header to a string rather than an integer.
|
|
|
|
|
|
2018-05-17 22:17:53 +08:00
|
|
|
.. _deprecated-features-2.2:
|
|
|
|
|
|
|
|
|
|
Features deprecated in 2.2
|
|
|
|
|
==========================
|
|
|
|
|
|
|
|
|
|
Miscellaneous
|
|
|
|
|
-------------
|
|
|
|
|
|
2018-07-10 04:33:36 +08:00
|
|
|
* ``django.utils.timezone.FixedOffset`` is deprecated in favor of
|
|
|
|
|
:class:`datetime.timezone`.
|
