Aller au contenu
Makersquad

Django REST Framework 3.13 est sorti

par Makersquad ·

Logo de Django REST framework sur fond dégradé

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.

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