Django REST Framework 3.17 est sorti
par Makersquad ·
Date de sortie : 18 mars 2026
Documentation officielle : Release notes DRF 3.17.x
Une release de modernisation : DRF aligne son support des versions Python et Django sur les plus récentes, et fait un peu de ménage en retirant coreapi.
Les nouveautés principales
Nouveaux décorateurs pour les vues fonctionnelles
Trois décorateurs viennent compléter l’API des function-based views :
from rest_framework.decorators import (
api_view,
versioning_class,
content_negotiation_class,
metadata_class,
)
@api_view(["GET"])
@versioning_class(URLPathVersioning)
@content_negotiation_class(DefaultContentNegotiation)
@metadata_class(SimpleMetadata)
def my_view(request):
...
Avant, il fallait passer par une APIView pour configurer ces aspects. Ces décorateurs rapprochent les vues fonctionnelles des capacités des vues classe.
Format de sortie pour DurationField
Il est possible de choisir le format de sortie d’un DurationField avec son argument format, qui vaut 'iso-8601' ou 'django' :
from rest_framework import serializers
class TaskSerializer(serializers.Serializer):
duration = serializers.DurationField(format="iso-8601")
Support étendu pour UniqueConstraint
DRF prend désormais en compte les attributs violation_error_code et violation_error_message des UniqueConstraint Django pour construire les messages d’erreur de validation.
Support natif pour ipaddress
Les objets ipaddress.IPv4Address, IPv6Address, etc. sont maintenant sérialisables directement par le JSONEncoder de DRF.
BigInteger en string
Option pour sérialiser les BigIntegerField en chaîne, avec l’argument coerce_to_string du champ ou le réglage COERCE_BIGINT_TO_STRING :
class AccountSerializer(serializers.Serializer):
id = serializers.BigIntegerField(coerce_to_string=True)
Breaking changes
- Support de Python 3.9 retiré. Minimum requis : Python 3.10.
- Support de
coreapiretiré (déjà déprécié depuis plusieurs versions).
Autres améliorations
- Support officiel de Django 6.0 et Python 3.14
- Correction d’un risque d’écrasement de
Tokenlors de la création UniqueTogetherValidatorvalide correctement lorsqu’une condition fait référence à un champ en lecture seule- Validation des ManyToMany avec
default=Nonecorrigée HTMLFormRendererrespecte le formatdatetime-localOrderingFilter: correction d’arguments mutables par défautTokenAdminrespecteUSERNAME_FIELDsur les modèles utilisateur personnalisésMultipleChoiceFieldpréserve l’ordre des valeurs- Migration du packaging vers
pyproject.toml - Génération des tokens via le module
secrets
À retenir
Si vous utilisez encore Python 3.9 ou coreapi, préparez la migration avant de mettre à jour. La 3.17 apporte aussi de petits conforts, en particulier les nouveaux décorateurs et le support natif de ipaddress.