FastAPI From Scratch

Descrizione

FastAPI From Scratch è il gemello Python di Spring Boot From Scratch: stesso approccio progressivo, stesso dominio applicativo (un sistema di gestione task condiviso), stessa filosofia 'build-your-own', ma adattato all'ecosistema Python e ai pattern moderni FastAPI 0.115+ con Pydantic v2 e SQLAlchemy 2.0 async. Il percorso copre passo dopo passo: setup pyproject.toml + uv (con fallback documentato a pip/poetry per chi preferisce tooling tradizionale), FastAPI app structure modulare con APIRouter per separare bounded context, Pydantic v2 validation profonda con discriminated unions, custom validators e computed fields, dependency injection FastAPI-native (Depends) per auth/DB/settings, database async con SQLAlchemy 2.0 + asyncpg (driver nativo PostgreSQL), Alembic per migrations versionate, autenticazione JWT con python-jose + passlib + argon2, testing pyramid completa con pytest + httpx AsyncClient + factory_boy + pytest-asyncio, observability production-grade con structlog + Prometheus FastAPI Instrumentator + healthcheck custom, deploy Uvicorn + Gunicorn workers + Dockerfile multi-stage ottimizzato. Ogni step è un branch git con esercizi opzionali, soluzione di riferimento e ADR per documentare le scelte. La documentazione MkDocs Material include diagrammi sequenza async (event loop, await yields, task scheduling, semaphore patterns), che sono spesso il punto di confusione principale per chi viene da Flask sincrono, Django o Node.js. Il progetto è MIT, ottimizzato per essere clonato e usato come scaffold per microservizi Python production-ready. Allineato con lo stack del portfolio: il pattern ml-service/ (FastAPI + Ollama + RediSearch) è citato come case study reale di produzione su VPS Hetzner.