Python Web

Load python3-core for standing defaults. Load python3-typing for request/response modeling. Load python3-testing for endpoint and auth tests.

Quality Checklist

• Route handlers contain NO business logic — only validation, delegation, response mapping
• No framework objects (Request, Response, ORM models) leak into domain layer
• model_config = {"strict": True} on all request models
• Separate request and response models per endpoint — never reuse ORM models as API schemas
• Auth resolved at edge; domain functions receive typed identity, never raw tokens
• Domain exceptions mapped to HTTP status codes at boundary, not scattered through handlers
• Async handlers use httpx.AsyncClient — never requests (blocks event loop)
• Background tasks hold no references to request-scoped objects

Gotchas