Django REST Framework 3.15 est sorti
par Makersquad ·
Date de sortie : 15 mars 2024
Documentation officielle : https://www.django-rest-framework.org/community/3.15-announcement/
La nouvelle version de DRF vient d’arriver avec son lot de bonnes nouvelles.
Les nouveautés principales
Support Django 5.0 et Python 3.12
DRF 3.15 supporte pleinement Django 5.0 et Python 3.12. Les versions minimales annoncées pour la 3.15.0 restent Django 3.0 et Python 3.6, mais la version 3.15.2 (14 juin 2024) ne supporte plus Django antérieur à 4.2 ni Python antérieur à 3.8 : vérifiez vos versions avant de mettre à jour.
Validators pour UniqueConstraint
ModelSerializer génère maintenant des validators pour les UniqueConstraint Django (UniqueValidator et UniqueTogetherValidator) :
class Product(models.Model):
sku = models.CharField(max_length=50)
store = models.ForeignKey(Store, on_delete=models.CASCADE)
class Meta:
constraints = [
models.UniqueConstraint(
fields=['sku', 'store'],
name='unique_sku_per_store'
)
]
# Le serializer génère automatiquement UniqueTogetherValidator
URLs SimpleRouter sans regex
Par défaut, les URLs créées par SimpleRouter utilisent des expressions régulières. Ce comportement se modifie en passant use_regex_path=False à l’instanciation du routeur, pour utiliser le path matching natif de Django :
from rest_framework.routers import SimpleRouter
router = SimpleRouter(use_regex_path=False)
router.register('users', UserViewSet)
# Génère users/<str:pk>/ au lieu de users/(?P<pk>[^/.]+)/ (convertisseur `str` par défaut)
Adieu pytz
La dépendance à pytz est retirée et des avertissements de dépréciation sont ajoutés. Django fournit des instances ZoneInfo tant que le réglage USE_DEPRECATED_PYTZ n’est pas activé. Le module zoneinfo fait partie de la bibliothèque standard depuis Python 3.9 ; pour les versions plus anciennes, le paquet backports.zoneinfo est installé automatiquement en dépendance.
Recherche par phrases avec guillemets
Le comportement de SearchFilter est aligné sur la recherche de django.contrib.admin : une recherche peut contenir des phrases entre guillemets avec espaces, chaque phrase étant un seul terme de recherche, et une erreur de validation est levée si la recherche contient un caractère nul.
# GET /products/?search="red shoes" large
# Cherche la phrase exacte "red shoes" ET le mot "large"
class ProductViewSet(viewsets.ModelViewSet):
search_fields = ['name', 'description']
Et aussi…
Cette version, c’est le fruit du travail de 138 contributeurs sur 176 commits. Au menu : documentation améliorée, corrections de bugs et plein de petites optimisations qui rendent la vie plus douce.
À retenir
DRF 3.15 ajoute la prise en charge de Django 5.0 et de Python 3.12, des validators pour UniqueConstraint, un routeur sans regex et la recherche par phrases. Avant de monter de version, vérifiez que votre projet est sur Django 4.2 ou plus et sur Python 3.8 ou plus, minimum exigé par la 3.15.2.