chore: update fastapi integration example

Author: tilyupo

README.md

@@ -383,6 +383,8 @@ finally:
 
 ```python
 from contextlib import asynccontextmanager
+from typing import Annotated
+
 from fastapi import FastAPI, Depends
 from replane import AsyncReplane
 
@@ -405,8 +407,11 @@ def get_replane() -> AsyncReplane:
     assert _replane is not None
     return _replane
 
+# Define reusable dependency type
+Replane = Annotated[AsyncReplane, Depends(get_replane)]
+
 @app.get("/items")
-async def get_items(replane: AsyncReplane = Depends(get_replane)):
+async def get_items(replane: Replane):
     max_items = replane.with_context({"plan": "free"}).configs["max-items"]
     return {"max_items": max_items}
 ```

docs/source/frameworks.md

@@ -10,6 +10,8 @@ FastAPI's async nature makes it a perfect fit for the async Replane client.
 
 ```python
 from contextlib import asynccontextmanager
+from typing import Annotated
+
 from fastapi import FastAPI, Depends
 from replane import AsyncReplane
 
@@ -35,8 +37,11 @@ def get_replane() -> AsyncReplane:
     assert _replane is not None
     return _replane
 
+# Define reusable dependency type
+Replane = Annotated[AsyncReplane, Depends(get_replane)]
+
 @app.get("/items")
-async def get_items(replane: AsyncReplane = Depends(get_replane)):
+async def get_items(replane: Replane):
     max_items = replane.configs["max-items-per-page"]
     return {"max_items": max_items}
 ```
@@ -47,10 +52,7 @@ async def get_items(replane: AsyncReplane = Depends(get_replane)):
 from fastapi import Request
 
 @app.get("/features")
-async def get_features(
-    request: Request,
-    replane: AsyncReplane = Depends(get_replane),
-):
+async def get_features(request: Request, replane: Replane):
     # Build context from request/user
     user_client = replane.with_context({
         "user_id": request.state.user.id,
@@ -73,18 +75,20 @@ from replane._async import ContextualAsyncReplane
 
 def get_replane_with_context(
     request: Request,
-    replane: AsyncReplane = Depends(get_replane),
+    replane: Replane,
 ) -> ContextualAsyncReplane:
     context = {}
     if hasattr(request.state, "user"):
         context["user_id"] = request.state.user.id
         context["plan"] = request.state.user.plan
     return replane.with_context(context)
 
+ReplaneWithContext = Annotated[ContextualAsyncReplane, Depends(get_replane_with_context)]
+
 @app.get("/dashboard")
-async def dashboard(config: ContextualAsyncReplane = Depends(get_replane_with_context)):
+async def dashboard(replane: ReplaneWithContext):
     # Context is automatically included
-    show_analytics = config.configs["show-analytics"]
+    show_analytics = replane.configs["show-analytics"]
     return {"show_analytics": show_analytics}
 ```
 

examples/fastapi-integration/app.py

@@ -72,6 +72,11 @@ def get_user_context(
     }
 
 
+# Define reusable dependency types (recommended FastAPI pattern)
+Replane = Annotated[AsyncReplane, Depends(get_replane)]
+UserContext = Annotated[dict, Depends(get_user_context)]
+
+
 # Response models
 class WelcomeResponse(BaseModel):
     message: str
@@ -108,10 +113,7 @@ async def check_maintenance_mode(request: Request, call_next):
 
 
 @app.get("/", response_model=WelcomeResponse)
-async def index(
-    replane: Annotated[AsyncReplane, Depends(get_replane)],
-    ctx: Annotated[dict, Depends(get_user_context)],
-):
+async def index(replane: Replane, ctx: UserContext):
     """Homepage with feature flag check."""
     user_client = replane.with_context(ctx)
     new_dashboard = user_client.configs["new-dashboard-enabled"]
@@ -123,10 +125,7 @@ async def index(
 
 
 @app.get("/api/items", response_model=ItemsResponse)
-async def get_items(
-    replane: Annotated[AsyncReplane, Depends(get_replane)],
-    ctx: Annotated[dict, Depends(get_user_context)],
-):
+async def get_items(replane: Replane, ctx: UserContext):
     """List items with configurable rate limiting."""
     user_client = replane.with_context(ctx)
     rate_limit = user_client.configs["rate-limit"]
@@ -145,11 +144,7 @@ async def get_items(
 
 
 @app.post("/api/upload", response_model=UploadResponse)
-async def upload(
-    request: Request,
-    replane: Annotated[AsyncReplane, Depends(get_replane)],
-    ctx: Annotated[dict, Depends(get_user_context)],
-):
+async def upload(request: Request, replane: Replane, ctx: UserContext):
     """Upload endpoint with configurable size limit."""
     user_client = replane.with_context(ctx)
     max_size_mb = user_client.configs["max-upload-size-mb"]
@@ -170,10 +165,7 @@ async def upload(
 
 
 @app.get("/api/config", response_model=ConfigResponse)
-async def get_config(
-    replane: Annotated[AsyncReplane, Depends(get_replane)],
-    ctx: Annotated[dict, Depends(get_user_context)],
-):
+async def get_config(replane: Replane, ctx: UserContext):
     """Debug endpoint to view current config values."""
     user_client = replane.with_context(ctx)
     return ConfigResponse(