Aller au contenu
Makersquad

Django REST Framework 3.16 est sorti

par Makersquad ·

Logo de Django REST framework sur fond dégradé

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.

É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.