Aller au contenu
Makersquad

Django Ninja 1.1 est sorti

par Makersquad ·

Logo de Django Ninja sur fond dégradé

Date de sortie : 7 décembre 2023

Mis à jour le 17 novembre 2026

Release officielle : Django Ninja 1.1.0

Django Ninja 1.1 est une version d’entretien. Elle permet de plafonner la limite de la pagination, corrige le schéma OpenAPI des relations many-to-many à clé UUID, corrige la génération des champs optionnels de ModelSchema et relève le minimum de Django déclaré de 2.2 à 3.1. Les nouveautés d’authentification asynchrone et de protection CSRF automatique, parfois attribuées à cette version, datent de la 1.0.

Les nouveautés principales

Limite maximale pour la pagination

Le limit demandé par le client à LimitOffsetPagination peut désormais être plafonné par le serveur. Le plafond se règle dans settings.py :

NINJA_PAGINATION_MAX_LIMIT = 100

Avec ce réglage, une requête qui demande limit=1000 aboutit et ne renvoie que 100 éléments.

Support de UUID

Le schéma OpenAPI des relations many-to-many dont la clé est un UUID est désormais généré. Il corrige une erreur signalée sur une telle relation : l’affichage du schéma OpenAPI échouait avec une KeyError.

Champs optionnels avec fields_optional = '__all__'

Avec Meta.fields_optional = '__all__' sur un ModelSchema, les champs n’étaient pas générés. C’est corrigé.

Version minimale de Django

Django Ninja 1.1 relève le minimum de Django déclaré par le paquet, de Django >=2.2 à Django >=3.1, et supprime le code de compatibilité avec les versions antérieures. Django 2.2, 3.0 et 4.0 sortent de la matrice de tests et Django 5.0 y entre. Les versions de Python ne changent pas : le paquet déclare toujours requires_python >=3.7, et Python 3.7 reste testé.

Documentation de la protection CSRF

La documentation de la protection CSRF est plus complète. Le comportement lui-même, automatique avec l’authentification par cookie, vient de la 1.0.

À retenir

Django Ninja 1.1 ne change pas l’API de façon visible. Elle ajuste la pagination, la génération de schémas à partir des modèles Django et le minimum de Django (3.1) : relisez la limite maximale de pagination si vos clients demandent de grandes pages.

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