Django REST Framework 3.14 est sorti
par Makersquad ·
Date de sortie : 22 septembre 2022
Mis à jour le 17 novembre 2026
Documentation officielle : DRF 3.14 Announcement
DRF 3.14 met à jour la compatibilité Django et durcit quelques comportements. Elle change aussi la sémantique du OR entre deux classes de permission.
Les nouveautés principales
Support de Django 4.1
DRF 3.14 supporte pleinement Django 4.1 et abandonne le support de Django 2.2. Les prérequis annoncés sont Python 3.6 ou plus, et Django 4.1, 4.0, 3.2, 3.1 et 3.0.
raise_exception devient keyword-only
Appeler serializer_instance.is_valid(True) n’est plus une syntaxe acceptable. Pour utiliser l’argument raise_exception, il faut le passer par nom :
# Avant (n’est plus accepté)
serializer.is_valid(True)
# Après
serializer.is_valid(raise_exception=True)
Changement de sémantique pour OR sur les permissions
Depuis la 3.14.0, lorsque deux permissions sont combinées avec | (OR), la requête doit réussir has_permission() et has_object_permission() de l’une ou l’autre des classes. Auparavant, le has_permission() des deux classes était ignoré lors de cette combinaison.
ManyRelatedField avec source manquante
Auparavant, un champ de serializer avec many=True et un source en notation pointée vers un attribut inexistant levait une AttributeError. Il renvoie désormais la valeur par défaut, ou est ignoré selon les autres arguments.
API get_reference publique
La méthode get_reference() de AutoSchema (rest_framework.schemas.openapi) devient publique. Elle renvoie une référence au component du serializer, ce qui peut être utile si vous surchargez get_schema().
Suppression de NullBooleanField
serializers.NullBooleanField, déprécié depuis la 3.12 (notes de version (s’ouvre dans un nouvel onglet)), est retiré du cœur du framework. Utilisez BooleanField(allow_null=True) à la place.
À retenir
Cette version est surtout une mise à niveau de compatibilité. Vérifiez les appels à is_valid(True) et les usages de NullBooleanField. Si vous combinez des permissions avec |, relisez aussi la sémantique du OR décrite ci-dessus. Enfin, DRF n’appelle plus set_context sur les validators : un validator personnalisé qui en dépend peut casser.