Jeffallan/claude-skills / skills/fastapi-expert
fastapi-expert
VerifiedUse when building high-performance async Python APIs with FastAPI and Pydantic V2. Invoke to create REST endpoints, define Pydantic models, implement authentication flows, set up async SQLAlchemy database operations, add JWT authentication, build WebSocket endpoints, or generate OpenAPI documentation. Trigger terms: FastAPI, Pydantic, async Python, Python API, REST API Python, SQLAlchemy async, JWT authentication, OpenAPI, Swagger Python.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.9 KB |
| references/async-sqlalchemy.md | markdown | 4.0 KB |
| references/authentication.md | markdown | 4.3 KB |
| references/endpoints-routing.md | markdown | 4.0 KB |
| references/migration-from-django.md | markdown | 27.0 KB |
| references/pydantic-v2.md | markdown | 3.3 KB |
| references/testing-async.md | markdown | 4.5 KB |
references/pydantic-v2.md
View on GitHub# Pydantic V2 Schemas
## Schema Patterns
```python
from pydantic import BaseModel, EmailStr, Field, field_validator, model_validator
from typing import Self
class UserCreate(BaseModel):
email: EmailStr
password: str = Field(min_length=8)
username: str = Field(min_length=3, max_length=50)
age: int = Field(ge=18, le=120)
@field_validator('password')
@classmethod
def validate_password(cls, v: str) -> str:
if not any(c.isupper() for c in v):
raise ValueError('Password must contain uppercase')
if not any(c.isdigit() for c in v):
raise ValueError('Password must contain digit')
return v
@field_validator('username')
@classmethod
def validate_username(cls, v: str) -> str:
if not v.isalnum():
raise ValueError('Username must be alphanumeric')
return v.lower()
class UserUpdate(BaseModel):
email: EmailStr | None = None
username: str | None = Field(None, min_length=3, max_length=50)
```
## ORM Mode (from_attributes)
```python
class UserResponse(BaseModel):
model_config = {"from_attributes": True}
id: int
email: EmailStr
username: str
is_active: bool = True
created_at: datetime
# Usage with SQLAlchemy model
user_response = UserResponse.model_validate(db_user)
```
## Model Validator
```python
class OrderCreate(BaseModel):
items: list[OrderItem]
discount_code: str | None = None
total: float
@model_validator(mode='after')
def validate_order(self) -> Self:
calculated = sum(item.price * item.quantity for item in self.items)
if abs(self.total - calculated) > 0.01:
raise ValueError('Total does not match items')
return self
```
## Nested Models
```python
class Address(BaseModel):
street: str
city: str
country: str = Field(default="US")
class UserWithAddress(BaseModel):
name: str
addresses: list[Address] = Field(default_factory=list)
```
## Serialization Control
```python
class User(BaseModel):
model_config = {
"from_attributes": True,
"json_schema_extra": {
"example": {"email": "user@example.com", "username": "johndoe"}
}
}
id: int
email: EmailStr
password: str = Field(exclude=True) # Never serialize
internal_id: str = Field(repr=False) # Hide from repr
# Serialize with aliases
class ApiResponse(BaseModel):
model_config = {"populate_by_name": True}
user_id: int = Field(alias="userId", serialization_alias="user_id")
```
## Settings (Pydantic V2)
```python
from pydantic_settings import BaseSettings, SettingsConfigDict
class Settings(BaseSettings):
model_config = SettingsConfigDict(
env_file=".env",
env_file_encoding="utf-8",
case_sensitive=True,
)
DATABASE_URL: str
SECRET_KEY: str
DEBUG: bool = False
CORS_ORIGINS: list[str] = ["http://localhost:3000"]
API_V1_PREFIX: str = "/api/v1"
settings = Settings()
```
## Quick Reference
| V1 Syntax | V2 Syntax |
|-----------|-----------|
| `@validator` | `@field_validator` |
| `@root_validator` | `@model_validator` |
| `class Config` | `model_config = {}` |
| `orm_mode = True` | `from_attributes = True` |
| `Optional[X]` | `X \| None` |
| `.dict()` | `.model_dump()` |
| `.parse_obj()` | `.model_validate()` |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |