Django Ninja 1.6 est sorti
par Makersquad ·
Date de sortie : 12 mars 2026
Release officielle : django-ninja 1.6.0
Une release riche pour django-ninja, qui rapproche le framework des cas d’usage d’API moderne : streaming, pagination par curseur, et routers mieux composables.
Les nouveautés principales
Routers idempotents
Un Router peut maintenant être monté plusieurs fois sur la même API ou sur des APIs différentes, chaque montage étant isolé dans sa configuration :
from ninja import NinjaAPI, Router
shared = Router()
@shared.get("/health")
def health(request):
return {"ok": True}
api_v1 = NinjaAPI(version="1.0")
api_v2 = NinjaAPI(version="2.0")
api_v1.add_router("/", shared)
api_v2.add_router("/", shared)
Pagination par curseur
Nouvelle classe CursorPagination pour paginer proprement sur des datasets qui changent en continu :
from ninja.pagination import paginate, CursorPagination
@api.get("/events", response=list[EventSchema])
@paginate(CursorPagination, ordering=("-created",), page_size=20)
def list_events(request):
return Event.objects.all()
Le tri se déclare avec ordering (par défaut -pk, que CursorPagination réapplique au queryset). Le curseur est encodé en base64 plutôt que fondé sur des décalages, ce qui garde des résultats cohérents quand des éléments sont ajoutés ou retirés.
Streaming JSONL et SSE
Support natif du streaming avec validation par chunk :
from ninja.streaming import JSONL, SSE
@api.get("/items", response=JSONL[Item])
def stream_items(request):
for i in range(100):
yield {"name": f"item-{i}", "price": float(i)}
@api.get("/events", response=SSE[Item])
async def stream_events(request):
async for item in get_items():
yield item
Chaque chunk est validé contre le schéma de réponse, comme pour une réponse standard.
Classe Status
Remplace la syntaxe tuple (status_code, body) désormais dépréciée :
from ninja import Status
# Avant
@api.post("/items")
def create(request, payload: ItemIn):
return 201, {"id": 42}
# Après
@api.post("/items")
def create(request, payload: ItemIn):
return Status(201, {"id": 42})
Optimisation de sérialisation
Quand la valeur retournée par la vue est déjà une instance du schéma de réponse, django-ninja saute la validation redondante et sérialise directement, ce qui améliore les performances.
Autres améliorations
- Compatibilité Python 3.14 (annotations namespace)
- Correction sur
Optional[Union[...]]
À retenir
Les routers idempotents et le streaming sont les deux changements à connaitre. Le streaming en particulier rapproche django-ninja des capacités FastAPI, avec le même confort de validation par schéma. Le tuple (status, body) continue de fonctionner mais émet un warning : prévoyez la migration vers Status.