Aller au contenu
Makersquad

FastAPI 0.1 est sorti

par Makersquad ·

Logo de FastAPI sur fond dégradé

Date de sortie : 8 décembre 2018

Documentation officielle : fastapi.tiangolo.com

Créé par Sebastián Ramírez (@tiangolo), FastAPI est un nouveau framework API Python. Encore un ? Oui, mais celui-ci est différent. Son résumé sur PyPI tient en une ligne : « Fast API framework, high performance, fast to learn, fast to code, fast to production », soit un framework API performant, rapide à apprendre, à coder et à mettre en production. Voyons ça.

Une approche moderne des APIs Python

FastAPI propose une approche moderne basée sur les standards Python. En 0.1.0, le fichier fastapi/__init__.py n’exporte rien : les imports passent par les sous-modules (fastapi.applications, fastapi.params). Ce premier exemple suit la suite de tests de la version :

from fastapi.applications import FastAPI

app = FastAPI()


@app.get("/path/int/{item_id}")
def get_int_id(item_id: int):
    return item_id

Les type hints définissent la validation, la sérialisation et la documentation.

Pourquoi FastAPI ?

Performance

Le résumé PyPI parle de haute performance, sans chiffre : cette version 0.1.0 ne publie aucun benchmark. Le framework s’appuie sur deux briques existantes :

  • Starlette pour la couche ASGI
  • Pydantic pour la validation

Documentation automatique

Plus d’excuse pour ne pas documenter votre API. Dès cette version, FastAPI() expose le schéma OpenAPI à /openapi.json, Swagger UI à /docs et ReDoc à /redoc (paramètres openapi_url, swagger_ui_url et redoc_url), sans configuration.

Validation avec Pydantic

Les modèles Pydantic servent à la validation des données, comme dans la suite de tests de la version :

from pydantic import BaseModel


class Item(BaseModel):
    name: str
    price: float
    is_offer: bool


@app.post("/items/")
def post_item(item: Item):
    return item

Support async natif

Le routeur détecte les fonctions de chemin déclarées avec async def (asyncio.iscoroutinefunction dans fastapi/routing.py) et les attend, les fonctions classiques restant acceptées.

Injection de dépendances

Un système de dépendances est intégré, avec Depends importé depuis fastapi.params :

from fastapi.params import Depends


@app.get("/dependency", response_model=UserOut)
def get_dependency(user: UserInDB = Depends(require_user)):
    return user

Les dépendances avec yield (étapes de sortie, nettoyage) n’existent pas encore : elles arrivent en 0.42.0, le 9 octobre 2019 (« Add dependencies with yield »).

Architecture

FastAPI est construit sur :

  • Starlette, framework ASGI haute performance
  • Pydantic, validation et sérialisation
  • OpenAPI, spécification d’API (Swagger)
  • JSON Schema, schémas de données

Pourquoi ça compte

La promesse de cette première version tient dans son résumé : un framework rapide à apprendre, rapide à coder et rapide à mettre en production, bâti sur Starlette et Pydantic.

C’est la version 0.1.0, publiée sur PyPI le 8 décembre 2018. Le projet démarre, sans benchmark publié à ce stade. À suivre.

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