py-fastapi-patterns

What problem does it solve?

FastAPI projects often struggle with inconsistent API design, scattered patterns, and unclear OpenAPI documentation. This Skill provides a curated set of patterns to standardize endpoint creation, dependency management, error handling, and OpenAPI schema generation across teams.

Core Features & Use Cases

• Dependency Injection patterns to share sessions, auth, and services across endpoints.
• Explicit Response Models and consistent error handling to produce clean, predictable OpenAPI docs.
• Route ordering and parameter handling to prevent ambiguous matches.
• Request Body Validation with Pydantic validators to enforce data integrity.
• Middleware and OpenAPI schema best practices to ensure robust, observable APIs.
• Router Organization patterns for scalable project structure and easy onboarding.

Quick Start

Refactor an existing FastAPI project to apply the Dependency Injection, Response Models, and Error Handling patterns described in this Skill, starting with a simple endpoint and iterating layer by layer.