Merge aef56cdf2e into 1d434dec47

fastapi/applications.py

@@ -512,6 +512,14 @@ class FastAPI(Starlette):
                 Read more in the [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
                 """
             ),
+            deprecated(
+                """
+                **Attention**: This parameter is deprecated.
+
+                The recommended approach for managing startup and shutdown
+                is by utilizing the lifespan parameter within the FastAPI app.
+                """
+            ),
         ] = None,
         on_shutdown: Annotated[
             Optional[Sequence[Callable[[], Any]]],
@@ -525,6 +533,14 @@ class FastAPI(Starlette):
                 [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
                 """
             ),
+            deprecated(
+                """
+                **Attention**: This parameter is deprecated.
+
+                The recommended approach for managing startup and shutdown
+                is by utilizing the lifespan parameter within the FastAPI app.
+                """
+            ),
         ] = None,
         lifespan: Annotated[
             Optional[Lifespan[AppType]],

fastapi/routing.py

@@ -763,6 +763,14 @@ class APIRouter(routing.Router):
                 Read more in the [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
                 """
             ),
+            deprecated(
+                """
+                **Attention**: This parameter is deprecated.
+
+                The recommended approach for managing startup and shutdown
+                is by utilizing the lifespan parameter within the APIRouter.
+                """
+            ),
         ] = None,
         on_shutdown: Annotated[
             Optional[Sequence[Callable[[], Any]]],
@@ -776,6 +784,14 @@ class APIRouter(routing.Router):
                 [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
                 """
             ),
+            deprecated(
+                """
+                **Attention**: This parameter is deprecated.
+
+                The recommended approach for managing startup and shutdown
+                is by utilizing the lifespan parameter within the APIRouter.
+                """
+            ),
         ] = None,
         # the generic to Lifespan[AppType] is the type of the top level application
         # which the router cannot know statically, so we use typing.Any