Django 3.1 release notes - UNDER DEVELOPMENT

Expected August 2020

Welcome to Django 3.1!

These release notes cover the new features, as well as some backwards incompatible changes you’ll want to be aware of when upgrading from Django 3.0 or earlier. We’ve dropped some features that have reached the end of their deprecation cycle, and we’ve begun the deprecation process for some features.

See the Upgrading Django to a newer version guide if you’re updating an existing project.

Python compatibility

Django 3.1 supports Python 3.6, 3.7, and 3.8. We highly recommend and only officially support the latest release of each series.

What’s new in Django 3.1

Minor features

django.contrib.auth

  • The default iteration count for the PBKDF2 password hasher is increased from 180,000 to 216,000.
  • Added the PASSWORD_RESET_TIMEOUT setting to define the minimum number of seconds a password reset link is valid for. This is encouraged instead of deprecated PASSWORD_RESET_TIMEOUT_DAYS, which will be removed in Django 4.0.

Cache

CSRF

Email

File Storage

File Uploads

Forms

Generic Views

Internationalization

Logging

Management Commands

Migrations

  • Migrations are now loaded also from directories without __init__.py files.

Models

Requests and Responses

Serialization

Signals

Templates

Tests

URLs

Validators

Backwards incompatible changes in 3.1

Database backend API

This section describes changes that may be needed in third-party database backends.

  • DatabaseOperations.fetch_returned_insert_columns() now requires an additional returning_params argument.

Miscellaneous

  • The cache keys used by cache and generated by make_template_fragment_key() are different from the keys generated by older versions of Django. After upgrading to Django 3.1, the first request to any previously cached template fragment will be a cache miss.
  • The compatibility imports of django.core.exceptions.EmptyResultSet in django.db.models.query, django.db.models.sql, and django.db.models.sql.datastructures are removed.
  • The compatibility import of django.core.exceptions.FieldDoesNotExist in django.db.models.fields is removed.
  • The compatibility imports of django.forms.utils.pretty_name() and django.forms.boundfield.BoundField in django.forms.forms are removed.
  • The compatibility imports of Context, ContextPopException, and RequestContext in django.template.base are removed.
  • The STATIC_URL and MEDIA_URL settings set to relative paths are now prefixed by the server-provided value of SCRIPT_NAME (or / if not set). This change should not affect settings set to valid URLs or absolute paths.
  • ConditionalGetMiddleware no longer adds the ETag header to responses with an empty content.

Features deprecated in 3.1

Miscellaneous

Features removed in 3.1

These features have reached the end of their deprecation cycle and are removed in Django 3.1.

See Features deprecated in 2.2 for details on these changes, including how to remove usage of these features.

  • django.utils.timezone.FixedOffset is removed.
  • django.core.paginator.QuerySetPaginator is removed.
  • A model’s Meta.ordering doesn’t affect GROUP BY queries.
  • django.contrib.postgres.fields.FloatRangeField and django.contrib.postgres.forms.FloatRangeField are removed.
  • The FILE_CHARSET setting is removed.
  • django.contrib.staticfiles.storage.CachedStaticFilesStorage is removed.
  • The RemoteUserBackend.configure_user() method requires request as the first positional argument.
  • Support for SimpleTestCase.allow_database_queries and TransactionTestCase.multi_db is removed.