Aller au contenu
Makersquad

Django REST Framework 3.14 est sorti

par Makersquad ·

Logo de Django REST framework sur fond dégradé

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.

Échanger avec un expert Django

De l’idée au marché. Makersquad conçoit des logiciels sur mesure, pensés pour durer, avec de petites équipes d’experts autonomes. Depuis 2018.