python-fastapi

Python FastAPI Stack

Overview

Layer	Technology	Purpose
Framework	FastAPI	Async web framework
Database	PostgreSQL	Relational database
ORM	SQLAlchemy 2.0	Async ORM
Validation	Pydantic v2	Data validation
Migrations	Alembic	Database migrations
Auth	python-jose	JWT authentication

Related rules: python.mdc, fastapi.mdc

---

Project Structure

app/
├── api/
│   ├── routes/
│   │   ├── __init__.py
│   │   ├── auth.py
│   │   ├── users.py
│   │   └── posts.py
│   └── deps.py            # Dependencies
├── core/
│   ├── __init__.py
│   ├── config.py          # Settings
│   ├── security.py        # Auth utilities
│   └── database.py        # DB connection
├── models/
│   ├── __init__.py
│   ├── user.py
│   └── post.py
├── schemas/
│   ├── __init__.py
│   ├── user.py
│   └── post.py
├── services/
│   ├── __init__.py
│   └── user.py
└── main.py
alembic/
├── versions/
└── env.py
tests/
├── conftest.py
└── test_users.py
pyproject.toml

---

Application Setup

Main Application

# app/main.py
from contextlib import asynccontextmanager
from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware

from app.api.routes import auth, users, posts
from app.core.config import settings
from app.core.database import engine, Base


@asynccontextmanager
async def lifespan(app: FastAPI):
    # Startup
    async with engine.begin() as conn:
        await conn.run_sync(Base.metadata.create_all)
    yield
    # Shutdown
    await engine.dispose()


app = FastAPI(
    title=settings.PROJECT_NAME,
    version="1.0.0",
    lifespan=lifespan,
)

app.add_middleware(
    CORSMiddleware,
    allow_origins=settings.ALLOWED_ORIGINS,
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

app.include_router(auth.router, prefix="/api/auth", tags=["auth"])
app.include_router(users.router, prefix="/api/users", tags=["users"])
app.include_router(posts.router, prefix="/api/posts", tags=["posts"])


@app.get("/health")
async def health_check():
    return {"status": "healthy"}