improve remote endpoints documentation

src/api_factory.py

@@ -26,7 +26,7 @@ def get_param_metadata(p):
 
 async def get_remote_params(base_url: str,
                             endpoint: str,
-                            method: str = 'get'):
+                            method: str = 'get') -> Dict:
     async with httpx.AsyncClient() as client:
         headers = {}
         if TENNIS_ML_API_KEY := os.getenv('TENNIS_ML_API_KEY'):
@@ -40,10 +40,17 @@ async def get_remote_params(base_url: str,
     method_def = path_def.get(method, {})
     params = method_def.get("parameters", [])
 
-    return [
-        get_param_metadata(p)
-        for p in params if p["in"] == "query"
-    ]
+    return {
+        "general": {
+            "description": method_def.get("description", ""),
+            "summary": method_def.get("summary", ""),
+            "tags": method_def.get("tags", []),
+        },
+        "params": [
+            get_param_metadata(p)
+            for p in params if p["in"] == "query"
+        ]
+    }
 
 def openapi_type_to_python(t: str):
     return {

src/main.py

@@ -82,18 +82,21 @@ async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
     ]
 
     for endpoint in endpoints:
-        param_defs = await get_remote_params(base_url=TENNIS_ML_API,
-                                             endpoint=endpoint,
-                                             method='get')
+        endpoint_def = await get_remote_params(base_url=TENNIS_ML_API,
+                                               endpoint=endpoint,
+                                               method='get')
         forward_endpoint = create_forward_endpoint(base_url=TENNIS_ML_API,
                                                    _endpoint=endpoint,
-                                                   param_defs=param_defs)
+                                                   param_defs=endpoint_def["params"])
 
         app.add_api_route(
             path=f'/{endpoint}',
             endpoint=forward_endpoint,
             methods=["GET"],
             name=f"Forward to remote {forward_endpoint.__name__}",
+            tags=endpoint_def["general"]["tags"],
+            description=endpoint_def["general"]["description"],
+            summary=endpoint_def["general"]["summary"],
         )
     
     yield