From 70c61b3bdd7a175acf4591018ddf38b3f32c6722 Mon Sep 17 00:00:00 2001
From: z0z0r4 <z0z0r4@outlook.com>
Date: Sun, 26 Jan 2025 08:55:25 +0800
Subject: [PATCH] =?UTF-8?q?=F0=9F=8C=90=20Update=20testing=20events=20docu?=
 =?UTF-8?q?mentation?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`lifespan` should be included in th document, instead of only `startup` and `shutdown`
---
 docs/en/docs/advanced/testing-events.md       |  6 ++++--
 docs_src/app_testing/tutorial003.py           | 20 +++++++++++++++----
 .../test_testing/test_tutorial003.py          |  4 +---
 3 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/docs/en/docs/advanced/testing-events.md b/docs/en/docs/advanced/testing-events.md
index 0c554c4ec..6c800f279 100644
--- a/docs/en/docs/advanced/testing-events.md
+++ b/docs/en/docs/advanced/testing-events.md
@@ -1,5 +1,7 @@
 # Testing Events: startup - shutdown
 
-When you need your event handlers (`startup` and `shutdown`) to run in your tests, you can use the `TestClient` with a `with` statement:
+When you need your event handlers (`lifespan`, `startup` and `shutdown`) to run in your tests, you can use the `TestClient` with a `with` statement:
 
-{* ../../docs_src/app_testing/tutorial003.py hl[9:12,20:24] *}
+You can read more details about the ["Running lifespan in tests in the official Starlette documentation site."](https://www.starlette.io/lifespan/#running-lifespan-in-tests)
+
+{* ../../docs_src/app_testing/tutorial003.py hl[9:15,32:37] *}
\ No newline at end of file
diff --git a/docs_src/app_testing/tutorial003.py b/docs_src/app_testing/tutorial003.py
index ca6b45ce0..3b952dd73 100644
--- a/docs_src/app_testing/tutorial003.py
+++ b/docs_src/app_testing/tutorial003.py
@@ -1,15 +1,27 @@
+from contextlib import asynccontextmanager
+
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-app = FastAPI()
-
 items = {}
 
 
-@app.on_event("startup")
-async def startup_event():
+@asynccontextmanager
+async def lifespan(app: FastAPI):
     items["foo"] = {"name": "Fighters"}
     items["bar"] = {"name": "Tenders"}
+    yield
+    # clean up items or other work
+    ...
+
+
+app = FastAPI(lifespan=lifespan)
+
+# startup event and shutdown event are deprecated, you should use lifespan instead
+# @app.on_event("startup")
+# async def startup_event():
+#     items["foo"] = {"name": "Fighters"}
+#     items["bar"] = {"name": "Tenders"}
 
 
 @app.get("/items/{item_id}")
diff --git a/tests/test_tutorial/test_testing/test_tutorial003.py b/tests/test_tutorial/test_testing/test_tutorial003.py
index 2a5d67071..d9e16390e 100644
--- a/tests/test_tutorial/test_testing/test_tutorial003.py
+++ b/tests/test_tutorial/test_testing/test_tutorial003.py
@@ -1,7 +1,5 @@
-import pytest
+from docs_src.app_testing.tutorial003 import test_read_items
 
 
 def test_main():
-    with pytest.warns(DeprecationWarning):
-        from docs_src.app_testing.tutorial003 import test_read_items
     test_read_items()