Starlette 0.52 est sorti
par Makersquad ·
Date de sortie : 18 janvier 2026
Release officielle : Starlette 0.52.0
Starlette est le framework ASGI Python minimaliste qui sert de fondation à FastAPI. Il fournit les blocs de construction essentiels pour les applications web asynchrones : routing, middlewares, gestion des requêtes et réponses, WebSockets et lifespan. La version 0.52 apporte une amélioration pour le typage du state, utile aux équipes qui utilisent des type checkers comme mypy ou pyright.
Les nouveautés principales
State accessible en syntaxe dictionnaire avec typage
C’est la fonctionnalité phare de cette version. L’objet request.state supporte désormais une syntaxe dictionnaire (request.state["key"]) en plus de la syntaxe attribut existante (request.state.key). L’intérêt majeur : la compatibilité avec TypedDict, ce qui permet au type checker de connaître précisément le type de chaque valeur stockée dans le state.
from collections.abc import AsyncIterator
from contextlib import asynccontextmanager
from typing import TypedDict
import httpx
from starlette.applications import Starlette
from starlette.requests import Request
from starlette.responses import PlainTextResponse
from starlette.routing import Route
class State(TypedDict):
http_client: httpx.AsyncClient
@asynccontextmanager
async def lifespan(app: Starlette) -> AsyncIterator[State]:
async with httpx.AsyncClient() as client:
yield {"http_client": client}
async def homepage(request: Request[State]) -> PlainTextResponse:
client = request.state["http_client"]
reveal_type(client) # Revealed type is 'httpx.AsyncClient'
response = await client.get("https://www.example.com")
return PlainTextResponse(response.text)
app = Starlette(lifespan=lifespan, routes=[Route("/", homepage)])
Cet exemple vient de la documentation officielle du lifespan (s’ouvre dans un nouvel onglet). Elle précise que la syntaxe dictionnaire a été introduite en 0.52.0 pour améliorer le typage du state, Request étant devenu générique sur le type du state : ici, le type checker connaît le type de client.
Rétrocompatibilité
L’ancienne syntaxe attribut (request.state.attr) reste utilisable : la documentation indique que le state s’accède indifféremment en syntaxe attribut ou en syntaxe dictionnaire. Si vous préférez garder le style existant, rien ne change pour vous.
Import de typing_extensions limité (0.52.1)
Le patch 0.52.1 « n’utilise typing_extensions que sur les anciennes versions de Python ». Concrètement, starlette/requests.py importe TypeVar depuis typing sur Python 3.13 et plus, depuis typing_extensions avant. La dépendance typing_extensions déclarée par Starlette ne change pas.
À retenir
Starlette 0.52 cible en priorité les équipes qui ont une pratique de typage stricte. L’accès au state en syntaxe dictionnaire permet de le typer avec un TypedDict, et les deux syntaxes cohabitent, la migration peut donc se faire progressivement, endpoint par endpoint.