aiskillstore/marketplace / skills/0xdarkmatter/python-fastapi-patterns
python-fastapi-patterns
UnverifiedFastAPI web framework patterns. Triggers on: fastapi, api endpoint, dependency injection, pydantic model, openapi, swagger, starlette, async api, rest api, uvicorn.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.2 KB |
| assets/fastapi-template.py | script | 4.9 KB |
| references/background-tasks.md | markdown | 8.4 KB |
| references/dependency-injection.md | markdown | 7.2 KB |
| references/middleware-patterns.md | markdown | 8.8 KB |
| references/validation-serialization.md | markdown | 7.3 KB |
| scripts/scaffold-api.sh | script | 4.1 KB |
| skill-report.json | config | 72.8 KB |
scripts/scaffold-api.sh
View on GitHub#!/usr/bin/env bash
# Generate FastAPI endpoint boilerplate
#
# Usage: scaffold-api.sh <resource_name>
# Example: scaffold-api.sh user
set -euo pipefail
RESOURCE="${1:-}"
if [[ -z "$RESOURCE" ]]; then
echo "Usage: scaffold-api.sh <resource_name>"
echo "Example: scaffold-api.sh user"
exit 1
fi
# Convert to different cases
RESOURCE_LOWER=$(echo "$RESOURCE" | tr '[:upper:]' '[:lower:]')
RESOURCE_UPPER=$(echo "$RESOURCE" | tr '[:lower:]' '[:upper:]')
RESOURCE_TITLE=$(echo "$RESOURCE_LOWER" | sed 's/\b\(.\)/\u\1/g')
RESOURCE_PLURAL="${RESOURCE_LOWER}s"
cat << EOF
# =============================================================================
# ${RESOURCE_TITLE} Models
# =============================================================================
from pydantic import BaseModel, Field
from datetime import datetime
class ${RESOURCE_TITLE}Create(BaseModel):
"""Create ${RESOURCE_LOWER} request."""
name: str = Field(..., min_length=1, max_length=100)
# Add more fields
class ${RESOURCE_TITLE}Update(BaseModel):
"""Update ${RESOURCE_LOWER} request (partial)."""
name: str | None = None
# Add more fields
class ${RESOURCE_TITLE}Response(BaseModel):
"""${RESOURCE_TITLE} response."""
id: int
name: str
created_at: datetime
updated_at: datetime
model_config = {"from_attributes": True}
# =============================================================================
# ${RESOURCE_TITLE} Router
# =============================================================================
from fastapi import APIRouter, Depends, HTTPException
from typing import Annotated
router = APIRouter(prefix="/${RESOURCE_PLURAL}", tags=["${RESOURCE_PLURAL}"])
@router.get("/", response_model=list[${RESOURCE_TITLE}Response])
async def list_${RESOURCE_PLURAL}(
db: DB,
skip: int = 0,
limit: int = 10,
):
"""List all ${RESOURCE_PLURAL}."""
result = await db.execute(
select(${RESOURCE_TITLE}).offset(skip).limit(limit)
)
return result.scalars().all()
@router.post("/", response_model=${RESOURCE_TITLE}Response, status_code=201)
async def create_${RESOURCE_LOWER}(data: ${RESOURCE_TITLE}Create, db: DB):
"""Create a new ${RESOURCE_LOWER}."""
${RESOURCE_LOWER} = ${RESOURCE_TITLE}(**data.model_dump())
db.add(${RESOURCE_LOWER})
await db.commit()
await db.refresh(${RESOURCE_LOWER})
return ${RESOURCE_LOWER}
@router.get("/{${RESOURCE_LOWER}_id}", response_model=${RESOURCE_TITLE}Response)
async def get_${RESOURCE_LOWER}(${RESOURCE_LOWER}_id: int, db: DB):
"""Get a ${RESOURCE_LOWER} by ID."""
${RESOURCE_LOWER} = await db.get(${RESOURCE_TITLE}, ${RESOURCE_LOWER}_id)
if not ${RESOURCE_LOWER}:
raise HTTPException(status_code=404, detail="${RESOURCE_TITLE} not found")
return ${RESOURCE_LOWER}
@router.patch("/{${RESOURCE_LOWER}_id}", response_model=${RESOURCE_TITLE}Response)
async def update_${RESOURCE_LOWER}(
${RESOURCE_LOWER}_id: int,
data: ${RESOURCE_TITLE}Update,
db: DB,
):
"""Update a ${RESOURCE_LOWER}."""
${RESOURCE_LOWER} = await db.get(${RESOURCE_TITLE}, ${RESOURCE_LOWER}_id)
if not ${RESOURCE_LOWER}:
raise HTTPException(status_code=404, detail="${RESOURCE_TITLE} not found")
for field, value in data.model_dump(exclude_unset=True).items():
setattr(${RESOURCE_LOWER}, field, value)
await db.commit()
await db.refresh(${RESOURCE_LOWER})
return ${RESOURCE_LOWER}
@router.delete("/{${RESOURCE_LOWER}_id}", status_code=204)
async def delete_${RESOURCE_LOWER}(${RESOURCE_LOWER}_id: int, db: DB):
"""Delete a ${RESOURCE_LOWER}."""
${RESOURCE_LOWER} = await db.get(${RESOURCE_TITLE}, ${RESOURCE_LOWER}_id)
if not ${RESOURCE_LOWER}:
raise HTTPException(status_code=404, detail="${RESOURCE_TITLE} not found")
await db.delete(${RESOURCE_LOWER})
await db.commit()
# =============================================================================
# Include in main app:
# from routers.${RESOURCE_PLURAL} import router as ${RESOURCE_PLURAL}_router
# app.include_router(${RESOURCE_PLURAL}_router, prefix="/api/v1")
# =============================================================================
EOF
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |