Tipurile Annotated în FastAPI Modern în FastAPI

Începând cu versiunile recente, FastAPI recomandă utilizarea tipului standard typing.Annotated (introdus în Python 3.9 prin PEP 593) pentru declararea tuturor dependențelor și validărilor.

Avantaje majore:

• Separă clar tipul Python al variabilei (de exemplu int sau str) de metadatele FastAPI (cum ar fi Query(), Depends() sau Header()).
• Permite atribuirea de valori implicite reale în Python (= None) fără a folosi trucuri de framework.
• Permite reutilizarea tipurilor compuse personalizate (Type Aliases) în multiple endpoint-uri.

from fastapi import FastAPI, Query
from typing import Annotated

app = FastAPI()

# Definim un alias reutilizabil pentru parametrii de căutare:
SearchQuery = Annotated[
    str | None,
    Query(min_length=3, max_length=50, description="Termen de căutare de minim 3 caractere")
]

@app.get("/articles")
async def search_articles(q: SearchQuery = None):
    return {"query": q}

@app.get("/users")
async def search_users(q: SearchQuery = None):
    return {"query": q}