Aller au contenu
Makersquad

FastAPI 0.100 est sorti

par Makersquad ·

Logo de FastAPI sur fond dégradé

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 examples de Query(), 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.

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