diff --git a/fastapi/applications.py b/fastapi/applications.py index 4af1146b0d..d2db5bb1cc 100644 --- a/fastapi/applications.py +++ b/fastapi/applications.py @@ -509,6 +509,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[ Sequence[Callable[[], Any]] | None, @@ -522,6 +530,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[ Lifespan[AppType] | None, diff --git a/fastapi/routing.py b/fastapi/routing.py index 36acb6b89d..ee29dd5bd9 100644 --- a/fastapi/routing.py +++ b/fastapi/routing.py @@ -1173,6 +1173,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[ Sequence[Callable[[], Any]] | None, @@ -1186,6 +1194,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