FastAPI 0.1 est sorti
par Makersquad ·
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.