Django 3.1 est sorti
par Makersquad ·
Date de sortie : 4 août 2020
Mis à jour le 17 novembre 2026
Documentation officielle : Django 3.1 release notes
L’async débarque vraiment dans Django. Après le support ASGI en 3.0, cette version apporte les vues async et JSONField pour tous les backends.
Les nouveautés principales
Vues asynchrones, c’est parti !
Les vues peuvent maintenant être async :
import asyncio
from django.http import HttpResponse
async def my_view(request):
await asyncio.sleep(1)
return HttpResponse("Hello, async world!")
Les middlewares async sont aussi supportés.
JSONField pour tous les backends, enfin !
Plus besoin de PostgreSQL pour stocker du JSON. JSONField fonctionne maintenant sur tous les backends supportés : MariaDB 10.2.7+, MySQL 5.7.8+, Oracle, PostgreSQL et SQLite 3.9.0+ (avec l’extension JSON1 activée). Sur Oracle, seuls les objets et les tableaux JSON sont stockables, pas les scalaires.
from django.db import models
class Profile(models.Model):
data = models.JSONField(default=dict)
Les lookups, introspections et transformations jusqu’ici réservés à PostgreSQL sont disponibles :
Profile.objects.filter(data__settings__theme='dark')
Profile.objects.filter(data__pets__has_key='dogs')
Les lookups contains et contained_by ne sont pas supportés sur Oracle ni sur SQLite.
Sidebar dans l’admin
L’admin affiche maintenant une barre latérale de navigation sur les grands écrans pour accéder rapidement aux modèles. Elle est activée par défaut et se désactive avec AdminSite.enable_nav_sidebar = False dans un AdminSite personnalisé. Son rendu a besoin de la requête courante : 'django.template.context_processors.request' doit figurer dans l’option context_processors de OPTIONS.
on_delete=RESTRICT
Nouvelle option de ForeignKey et OneToOneField qui émule la contrainte SQL ON DELETE RESTRICT. Comme PROTECT, elle lève une erreur (RestrictedError) à la suppression de l’objet référencé. Mais, contrairement à PROTECT, la suppression est autorisée si cet objet est aussi supprimé dans la même opération par une relation CASCADE :
class Artist(models.Model):
name = models.CharField(max_length=10)
class Album(models.Model):
artist = models.ForeignKey(Artist, on_delete=models.CASCADE)
class Song(models.Model):
artist = models.ForeignKey(Artist, on_delete=models.CASCADE)
album = models.ForeignKey(Album, on_delete=models.RESTRICT)
Supprimer un Album référencé par un Song lève RestrictedError. Supprimer l’Artist de ce Song réussit, car le Song est supprimé par cascade avec lui.
PositiveBigIntegerField
Pour les grands entiers positifs (jusqu’à 9223372036854775807).
Autres améliorations
pathlib.Pathaccepté par certains réglages (STATICFILES_DIRS,EMAIL_FILE_PATH,NAMEdu backend SQLite) et parFileSystemStorage.save(), et lesettings.pygénéré parstartprojectutilisepathlib.Pathà la place deos.pathHttpRequest.accepts()pour la négociation de contenuSearchHeadlinepour PostgreSQL (highlight des résultats)- Itérations PBKDF2 augmentées (180 000 → 216 000)
À retenir
Django 3.1 concrétise la promesse async de 3.0. Certes, l’ORM reste synchrone (ça viendra), mais les vues async ouvrent déjà des possibilités intéressantes pour les I/O concurrents. Et JSONField universel, c’est juste du bonheur.