Aller au contenu
Makersquad

Starlette 0.52 est sorti

par Makersquad ·

Logo de Starlette sur fond dégradé

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.

Échanger avec un expert FastAPI

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.