endpoint_fx docstring as FastAPI description

this commit adds descriptions to each API endpoint in the generated
FastAPI. in vetiver_post, the docstring for the new function is dedented
to avoid formatting issues.

Author: isabelizimm

vetiver/server.py

@@ -11,6 +11,7 @@
 from fastapi.openapi.utils import get_openapi
 from fastapi.responses import HTMLResponse, RedirectResponse
 from fastapi.responses import PlainTextResponse
+from textwrap import dedent
 from warnings import warn
 
 from .utils import _jupyter_nb
@@ -105,10 +106,12 @@ def pin_url():
 
         @app.get("/ping", include_in_schema=True)
         async def ping():
+            """Ping endpoint for health check"""
             return {"ping": "pong"}
 
         @app.get("/metadata")
         async def get_metadata():
+            """Get metadata from model"""
             return self.model.metadata.to_dict()
 
         self.vetiver_post(
@@ -185,11 +188,14 @@ def vetiver_post(self, endpoint_fx: Callable, endpoint_name: str = None, **kw):
 
         if self.check_prototype is True:
 
-            @self.app.post(urljoin("/", endpoint_name), name=endpoint_name)
+            @self.app.post(
+                urljoin("/", endpoint_name),
+                name=endpoint_name,
+                description=dedent(endpoint_fx.__doc__),
+            )
             async def custom_endpoint(input_data: List[self.model.prototype]):
                 _to_frame = api_data_to_frame(input_data)
                 predictions = endpoint_fx(_to_frame, **kw)
-
                 if isinstance(predictions, List):
                     return {endpoint_name: predictions}
                 else: