Aller au contenu
Makersquad

Django Ninja 1.6 est sorti

par Makersquad ·

Logo de Django Ninja sur fond dégradé

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.

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