flask-pydantic-spec

from flask import Flask from flask_pydantic_spec import FlaskPydanticSpec, Request, Response, Query from pydantic import BaseModel, Field # Define Pydantic models for request and response class UserRequest(Request): user_id: int = Field(Query, description="ID of the user") class UserResponse(BaseModel): id: int name: str email: str app = Flask(__name__) spec = FlaskPydanticSpec('flask-pydantic-spec', app=app) spec.register(app) @app.route('/user/<int:user_id>') @spec.validate( query=UserRequest, resp=Response(HTTP_200=UserResponse) ) def get_user(user_id): # Access validated query parameters via spec.query # Note: user_id from path param will override if name conflict if spec.query.user_id != user_id: print(f"Warning: Path ID {user_id} and Query ID {spec.query.user_id} mismatch.") # In a real app, fetch user from DB user_data = {"id": user_id, "name": f"User_{user_id}", "email": f"user{user_id}@example.com"} return UserResponse(**user_data).model_dump() # Example of OpenAPI documentation endpoint (auto-generated) # Accessible at /swagger or /redoc by default if __name__ == '__main__': app.run(debug=True)