FastAPI static types

routes.py

from .schemas import HealthCheckModel, HealthCheckDict

@app.get("/health-check", response_model=HealthCheckModel) # FastAPI uses pydantic version
async def healthcheck() -> HealthCheckDict: # route annotated with TypedDict version for static validation
    return {'status': 'ok'}

schemas.py

from typing import TypedDict, Type

from pydantic import BaseModel, create_model


def model_from_td(name: str, td: Type) -> Type[BaseModel]:
    return create_model(
        name,
        **{
            key: (value, ...)
            for key, value in td.__annotations__.items()
        }
    )


class HealthCheckDict(TypedDict): # create model as TypedDict
    status: str


HealthCheckModel = model_from_td('HealthCheckModel', HealthCheckDict) # generate pydantic model from TypedDict