Fastapi Router Py

1---
2name: fastapi-router-py
3description: Create FastAPI routers with CRUD operations, authentication dependencies, and proper response models. Use when building REST API endpoints, creating new routes, implementing CRUD operations, or adding authenticated endpoints in FastAPI applications.
4---
5 
6# FastAPI Router
7 
8Create FastAPI routers following established patterns with proper authentication, response models, and HTTP status codes.
9 
10## Quick Start
11 
12Copy the template from [assets/template.py](assets/template.py) and replace placeholders:
13- `{{ResourceName}}` → PascalCase name (e.g., `Project`)
14- `{{resource_name}}` → snake_case name (e.g., `project`)
15- `{{resource_plural}}` → plural form (e.g., `projects`)
16 
17## Authentication Patterns
18 
19```python
20# Optional auth - returns None if not authenticated
21current_user: Optional[User] = Depends(get_current_user)
22 
23# Required auth - raises 401 if not authenticated
24current_user: User = Depends(get_current_user_required)
25```
26 
27## Response Models
28 
29```python
30@router.get("/items/{item_id}", response_model=Item)
31async def get_item(item_id: str) -> Item:
32    ...
33 
34@router.get("/items", response_model=list[Item])
35async def list_items() -> list[Item]:
36    ...
37```
38 
39## HTTP Status Codes
40 
41```python
42@router.post("/items", status_code=status.HTTP_201_CREATED)
43@router.delete("/items/{id}", status_code=status.HTTP_204_NO_CONTENT)
44```
45 
46## Integration Steps
47 
481. Create router in `src/backend/app/routers/`
492. Mount in `src/backend/app/main.py`
503. Create corresponding Pydantic models
514. Create service layer if needed
525. Add frontend API functions
53