from typing import Any from fastapi import FastAPI, Request from fastapi.responses import JSONResponse class AppError(Exception): def __init__( self, code: str, message: str, status_code: int = 400, details: dict[str, Any] | None = None, ) -> None: super().__init__(message) self.code = code self.message = message self.status_code = status_code self.details = details def install_error_handlers(app: FastAPI) -> None: @app.exception_handler(AppError) async def handle_app_error(_request: Request, exc: AppError) -> JSONResponse: body: dict[str, Any] = {"error": {"code": exc.code, "message": exc.message}} if exc.details is not None: body["error"]["details"] = exc.details return JSONResponse(status_code=exc.status_code, content=body)