Codificador Compatible con JSON¶

Hay algunos casos donde podrías necesitar convertir un tipo de dato (como un modelo de Pydantic) a algo compatible con JSON (como un dict, list, etc).

Por ejemplo, si necesitas almacenarlo en una base de datos.

Para eso, FastAPI proporciona una función jsonable_encoder().

Usando el jsonable_encoder¶

Imaginemos que tienes una base de datos fake_db que solo recibe datos compatibles con JSON.

Por ejemplo, no recibe objetos datetime, ya que estos no son compatibles con JSON.

Por lo tanto, un objeto datetime tendría que convertirse a un str que contenga los datos en ISO format.

De la misma manera, esta base de datos no recibiría un modelo de Pydantic (un objeto con atributos), solo un dict.

Puedes usar jsonable_encoder para eso.

Recibe un objeto, como un modelo de Pydantic, y devuelve una versión compatible con JSON:

from datetime import datetime

from fastapi import FastAPI
from fastapi.encoders import jsonable_encoder
from pydantic import BaseModel

fake_db = {}


class Item(BaseModel):
    title: str
    timestamp: datetime
    description: str | None = None


app = FastAPI()


@app.put("/items/{id}")
def update_item(id: str, item: Item):
    json_compatible_item_data = jsonable_encoder(item)
    fake_db[id] = json_compatible_item_data

En este ejemplo, convertiría el modelo de Pydantic a un dict, y el datetime a un str.

El resultado de llamarlo es algo que puede ser codificado con el json.dumps() estándar de Python.

No devuelve un str grande conteniendo los datos en formato JSON (como un string). Devuelve una estructura de datos estándar de Python (por ejemplo, un dict) con valores y sub-valores que son todos compatibles con JSON.