Adnotarea @computed_field în Pydantic v2 în FastAPI

În Pydantic v1, metodele decorate cu @property erau ignorate la serializarea în dicționar sau JSON. Pydantic v2 introduce adnotarea dedicată @computed_field.

Aceasta include proprietatea calculată direct în schema OpenAPI generată de FastAPI și o serializează automat în răspunsul JSON trimis clientului, fără a necesita stocarea unei valori duplicate în baza de date.

from pydantic import BaseModel, computed_field

class Rectangle(BaseModel):
    width: float
    height: float

    @computed_field
    @property
    def area(self) -> float:
        return self.width * self.height

# Când se serializează un Rectangle(width=10, height=5),
# JSON-ul returnat va fi automat:
# {"width": 10.0, "height": 5.0, "area": 50.0}