Django REST Framework 3.13 est sorti
par Makersquad ·
Date de sortie : 13 décembre 2021
Documentation officielle : https://www.django-rest-framework.org/community/release-notes/#313x-series
Django 4.0 est sorti le 7 décembre 2021, DRF 3.13 le 13 décembre 2021 et ajoute sa prise en charge. Au menu : la compatibilité avec Django 4.0, un relèvement du minimum requis à Python 3.6 et un changement cassant à surveiller lors de la migration.
Les nouveautés principales
Support de Django 4.0
DRF 3.13 prend pleinement en charge Django 4.0. Les prérequis annoncés sont Python 3.6 ou plus, et Django 4.0, 3.2, 3.1 et 2.2 (LTS). Python 3.6 devient la version minimale supportée.
Changement cassant : arguments keyword-only sur les champs
C’est le point à surveiller lors de la migration. Les arguments passés aux champs de serializer doivent désormais être explicitement nommés. La syntaxe positionnelle n’est plus acceptée.
# Avant — ne fonctionne plus avec DRF 3.13
aliases = serializers.ListField(serializers.CharField())
# Maintenant — l'argument doit être nommé
aliases = serializers.ListField(child=serializers.CharField())
Ce n’est pas une nouveauté de convention, puisque tous les exemples de la documentation utilisent déjà des arguments nommés, mais elle est désormais appliquée explicitement. Les cas où l’on omet le plus probablement le mot-clé par erreur sont les champs composites ListField et DictField, car passer l’argument en position ne produit pas le comportement attendu. Si votre projet utilise des champs avec des arguments positionnels, un passage en revue du code s’impose avant la mise à jour.
Fin du support de Python 3.5
DRF 3.13 abandonne le support de Python 3.5 (en fin de vie depuis septembre 2020). Si vous êtes encore sur cette version, DRF 3.12 est la dernière version qui la déclare compatible. Django 2.1 n’est pas concerné par ce changement : il ne figure plus dans les versions supportées depuis la 3.12, et la 3.11 est la dernière à le prendre en charge.
À retenir
DRF 3.13 ajoute la prise en charge de Django 4.0. Le point d’attention est le passage en keyword-only des arguments des champs de serializer. Un grep rapide sur ListField( et DictField( dans votre code permet d’identifier les lignes à corriger avant de mettre à jour.