FastAPI 0.100 est sorti
par Makersquad ·
Date de sortie : 7 juillet 2023
Documentation officielle : FastAPI Release Notes
FastAPI 0.100 marque un tournant. Elle ajoute le support de Pydantic v2, dont le cœur est réécrit en Rust, et promet des gains de performance : l’article « Introducing Pydantic v2 » de Pydantic (juillet 2022) annonce un traitement entre 4× et 50× plus rapide qu’avec Pydantic 1.9.1, la release de FastAPI évoque 20× ou plus pour la validation seule. Si vous faites de l’API Python, cette migration vaut le coup.
Les nouveautés principales
Support de Pydantic v2
FastAPI 0.100 ajoute le support de Pydantic v2, dont le cœur est réécrit en Rust pour des performances nettement améliorées. FastAPI continue de supporter Pydantic v1 :
from pydantic import BaseModel, ConfigDict
class Item(BaseModel):
model_config = ConfigDict(
str_strip_whitespace=True,
from_attributes=True # Remplace orm_mode
)
name: str
price: float
tags: list[str] = []
Changements Pydantic v1 vers v2
Ce qui change en pratique :
# Avant (Pydantic v1)
class Item(BaseModel):
class Config:
orm_mode = True
item = Item.from_orm(db_item)
data = Item.parse_raw(json_string)
# Après (Pydantic v2)
class Item(BaseModel):
model_config = ConfigDict(from_attributes=True)
item = Item.model_validate(db_item)
data = Item.model_validate_json(json_string)
OpenAPI 3.1.0 et Swagger UI
Le support d’OpenAPI 3.1.0 et la montée de Swagger UI en version 5.x.x, qui le supporte, datent de la 0.99.0 (30 juin 2023), une semaine avant la 0.100. Passer à la 0.100 depuis une version antérieure à la 0.99 les apporte donc aussi :
- OpenAPI 3.1.0, qui s’appuie sur JSON Schema 2020-12
- la documentation des webhooks
- un champ
examplesdeQuery(),Cookie(),Body()et consorts qui prend une liste d’exemples
JSON Schema généré par Pydantic v2
Pour un champ optionnel, Pydantic v2 génère un anyOf qui contient le type null, comme dans l’exemple de sa documentation JSON Schema :
"size": {
"anyOf": [
{ "type": "number" },
{ "type": "null" }
],
"default": null,
"title": "Size"
}
Migration depuis Pydantic v1
Une version de Pydantic ou l’autre
FastAPI 0.100 supporte toujours Pydantic v1. Vous pouvez installer Pydantic v2 et, si quelque chose casse, revenir à Pydantic v1 le temps de corriger, tout en gardant la dernière version de FastAPI. Pour les changements à faire dans vos modèles, l’outil bump-pydantic traite votre code et met à jour l’essentiel automatiquement.
Mélanger les modèles v1 et v2
Mélanger dans une même application des modèles pydantic.v1 et des modèles Pydantic v2 n’est pas possible en 0.100. Cela arrive, à titre temporaire, en 0.119.0 (11 octobre 2025), voir la release officielle FastAPI 0.119.0 (s’ouvre dans un nouvel onglet).
Changements courants
| Pydantic v1 | Pydantic v2 |
|---|---|
orm_mode = True |
from_attributes=True |
.from_orm() |
.model_validate() |
.parse_raw() |
.model_validate_json() |
.dict() |
.model_dump() |
.json() |
.model_dump_json() |
@validator |
@field_validator |
@root_validator |
@model_validator |
Performance
L’article « Introducing Pydantic v2 » (s’ouvre dans un nouvel onglet) de Pydantic (juillet 2022) annonce un Pydantic v2 entre 4× et 50× plus rapide que la version 1.9.1, et environ 17× plus rapide pour valider un modèle de champs courants. La release de FastAPI parle de 20× ou plus pour la validation et le traitement de données seuls, mais précise qu’une application FastAPI passe aussi son temps à traiter la requête, résoudre les dépendances, exécuter votre code et attendre le réseau : le gain y sera plus modeste. Des bêta-testeurs tiers ont rapporté 2× à 3× sur les versions bêta, sans benchmark officiel.
À retenir
FastAPI 0.100 ajoute le support de Pydantic v2, tout en gardant celui de Pydantic v1 : vous migrez à votre rythme. Les gains de performance sont réels mais dépendent de votre charge, les standards sont à jour, et la migration est bien documentée. Si vous partez sur un nouveau projet, c’est cette stack qu’il faut viser.