Django REST Framework 3.16 est sorti
par Makersquad ·
Date de sortie : 28 mars 2025
Documentation officielle : https://www.django-rest-framework.org/community/release-notes/#316x-series
DRF 3.16 est une version significative pour améliorer le support de Django et de Python. Elle prend en charge Django 5.1 et la future version 5.2 LTS, ainsi que Python 3.13. Selon les notes de version, certaines corrections peuvent modifier le comportement de fonctionnalités existantes.
Les nouveautés principales
Support de Django 5.1 et de la future version 5.2 LTS
DRF 3.16 prend pleinement en charge Django 5.1 et la future version 5.2 LTS. La version 3.16.0 ajoute le support officiel de Django 5.2a1, et la version 3.16.1 teste la version stable de Django 5.2. Django 4.2 était déjà le minimum depuis la 3.15.2 : cette version ne change pas le minimum de Django.
Python 3.13 et minimum relevé à 3.9
Python 3.13 est pris en charge. Python 3.9 devient le minimum requis, et la version 3.16.1 nettoie la dépendance optionnelle à backports.zoneinfo et les conditions pour les versions de Python inférieures ou égales à 3.8, déjà non supportées.
Compatibilité avec LoginRequiredMiddleware
Django 5.1 a introduit le middleware LoginRequiredMiddleware. Selon l’annonce officielle, il peut maintenant être utilisé aux côtés de DRF, mais il n’est pas appliqué aux vues d’API : toutes les vues DRF en sont exclues. L’authentification de DRF repose sur des classes d’authentification et de permission, qui peuvent être déterminées après le passage du middleware, et une requête non authentifiée y recevrait une redirection vers la page de connexion plutôt qu’un statut 401, peu adapté à une API.
Le middleware ne protège donc pas vos vues DRF. Un comportement équivalent se configure avec DEFAULT_PERMISSION_CLASSES (par exemple IsAuthenticated), les classes d’authentification seules n’imposant rien ; les permissions de DRF restent celles qui s’appliquent.
Meilleur support de UniqueConstraint
La génération des validators pour UniqueConstraint est améliorée pour mieux gérer les champs nullables et les contraintes avec condition. Les notes de la 3.16.0 listent trois corrections liées : le validateur d’unicité groupée respecte désormais les champs de la condition d’une UniqueConstraint, l’erreur levée sur les champs nullables d’une UniqueConstraint est corrigée, et la validation unique_together avec source l’est aussi. Ces corrections peuvent modifier le comportement de la validation intégrée des serializers.
Autres changements
La version 3.16.0 gère aussi automatiquement la sérialisation des données JSON du client de test de Django 2.1 et plus.
À retenir
DRF 3.16 relève le minimum de Python à 3.9 (Django 4.2 l’était déjà depuis la 3.15.2), supporte Django 5.1 et Python 3.13 et améliore les validators pour UniqueConstraint. N’oubliez pas que LoginRequiredMiddleware ne s’applique pas aux vues DRF.