py-auth-fastapi

FastAPI integration for py-auth-core.

Removes the boilerplate of wiring py-auth-core authentication into a FastAPI application down to a single line.

Features

• ✅ One-liner setup — Mounts as a standard FastAPI APIRouter with app.include_router()
• ✅ Automatic cookie handling — Sets and clears session and CSRF cookies automatically
• ✅ Dependency injection — Includes get_current_session() dependency factory for protecting endpoints
• ✅ Built-in error handling — Converts py-auth-core errors into standard FastAPI HTTPException responses

Installation

pip install py-auth-fastapi

Quick Start

from fastapi import FastAPI, Depends
from py_auth import PyAuth
from py_auth_fastapi import PyAuthFastAPI

# Initialize your PyAuth instance
auth = PyAuth(...)

app = FastAPI()

# Mount auth router (prefix="/auth" and tags=["Authentication"] by default)
auth_router = PyAuthFastAPI(auth)
app.include_router(auth_router)

# Protect routes using the session dependency
@app.get("/protected")
async def protected_route(session=Depends(auth_router.get_current_session())):
    return {"message": f"Hello user {session['user_id']}"}

Endpoints Registered

• POST /auth/signin — Authenticates credentials and sets session & CSRF cookies
• POST /auth/signout — Revokes session and deletes cookies
• GET /auth/session — Fetches current session and rotates CSRF token

License

MIT