fastapi-patterns

What problem does it solve?

This Skill enforces best practices for building APIs with FastAPI, addressing issues like inconsistent endpoint definitions, poor error handling, and lack of documentation. It ensures your APIs are well-structured, validated, secure, and easy to maintain, accelerating development and improving reliability.

Core Features & Use Cases

• Router Organization: Guides on structuring APIs using APIRouter for modularity and clear resource separation.
• Dependency Injection: Provides patterns for authentication, authorization, and service injection using Depends().
• Request & Response Validation: Enforces Pydantic models for request bodies and response_model for consistent, validated API outputs.
• Comprehensive Error Handling: Guides on converting service exceptions to HTTP exceptions and implementing global exception handlers for predictable error responses.
• Async Operations & Middleware: Covers asynchronous I/O, background tasks, and custom middleware for logging and performance.
• Use Case: A backend developer is creating a new user management API. This skill helps them define UserCreate and UserResponse Pydantic models, organize endpoints with APIRouter, implement get_current_user for authentication, and set up global error handling, ensuring a high-quality API.

Quick Start

Create a new FastAPI endpoint for creating a user, ensuring it uses a Pydantic request model and handles duplicate email errors.