Aller au contenu
Makersquad

Django REST Framework 3.15 est sorti

par Makersquad ·

Logo de Django REST framework sur fond dégradé

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.

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