✨ Add source examples for Python 3.10 and 3.9 with updated syntax (#842)

Co-authored-by: Esteban Maya Cadavid <emayacadavid9@gmail.com>
2026-01-05 00:51:07 -06:00 · 2024-03-21 17:49:38 -05:00
parent 4c3f242ae2
commit 9141c8a920
39 changed files with 7456 additions and 25 deletions
--- a/docs/tutorial/fastapi/session-with-dependency.md
+++ b/docs/tutorial/fastapi/session-with-dependency.md
@@ -6,6 +6,32 @@ Before we keep adding things, let's change a bit how we get the session for each

 Up to now, we have been creating a session in each *path operation*, in a `with` block.

+//// tab | Python 3.10+
+
+```Python hl_lines="5"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/fastapi/delete/tutorial001_py310.py[ln:48-55]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="5"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/fastapi/delete/tutorial001_py39.py[ln:50-57]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="5"
 # Code above omitted 👆

@@ -14,12 +40,34 @@ Up to now, we have been creating a session in each *path operation*, in a `with`
 # Code below omitted 👇
 ```

+////
+
 /// details | 👀 Full file preview

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/fastapi/delete/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/fastapi/delete/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/fastapi/delete/tutorial001.py!}
 ```

+////
+
 ///

 That's perfectly fine, but in many use cases we would want to use <a href="https://fastapi.tiangolo.com/tutorial/dependencies/" class="external-link" target="_blank">FastAPI Dependencies</a>, for example to **verify** that the client is **logged in** and get the **current user** before executing any other code in the *path operation*.
@@ -34,6 +82,32 @@ A **FastAPI** dependency is very simple, it's just a function that returns a val

 It could use `yield` instead of `return`, and in that case **FastAPI** will make sure it executes all the code **after** the `yield`, once it is done with the request.

+//// tab | Python 3.10+
+
+```Python hl_lines="3-5"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:40-42]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="3-5"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:42-44]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="3-5"
 # Code above omitted 👆

@@ -42,12 +116,34 @@ It could use `yield` instead of `return`, and in that case **FastAPI** will make
 # Code below omitted 👇
 ```

+////
+
 /// details | 👀 Full file preview

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001.py!}
 ```

+////
+
 ///

 ## Use the Dependency
@@ -56,6 +152,44 @@ Now let's make FastAPI execute a dependency and get its value in the *path opera

 We import `Depends()` from `fastapi`. Then we use it in the *path operation function* in a **parameter**, the same way we declared parameters to get JSON bodies, path parameters, etc.

+//// tab | Python 3.10+
+
+```Python hl_lines="1  13"
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:1-2]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:40-42]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:53-59]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="3  15"
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:1-4]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:42-44]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:55-61]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="3  15"
 {!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001.py[ln:1-4]!}

@@ -70,12 +204,34 @@ We import `Depends()` from `fastapi`. Then we use it in the *path operation func
 # Code below omitted 👇
 ```

+////
+
 /// details | 👀 Full file preview

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001.py!}
 ```

+////
+
 ///

 /// tip
@@ -104,6 +260,44 @@ And because dependencies can use `yield`, FastAPI will make sure to run the code

 This means that in the main code of the *path operation function*, it will work equivalently to the previous version with the explicit `with` block.

+//// tab | Python 3.10+
+
+```Python hl_lines="14-18"
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:1-2]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:40-42]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:53-59]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="16-20"
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:1-4]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:42-44]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:55-61]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="16-20"
 {!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001.py[ln:1-4]!}

@@ -118,18 +312,78 @@ This means that in the main code of the *path operation function*, it will work
 # Code below omitted 👇
 ```

+////
+
 /// details | 👀 Full file preview

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001.py!}
 ```

+////
+
 ///

 In fact, you could think that all that block of code inside of the `create_hero()` function is still inside a `with` block for the **session**, because this is more or less what's happening behind the scenes.

 But now, the `with` block is not explicitly in the function, but in the dependency above:

+//// tab | Python 3.10+
+
+```Python hl_lines="7-8"
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:1-2]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:40-42]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:53-59]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-10"
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:1-4]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:42-44]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:55-61]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="9-10"
 {!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001.py[ln:1-4]!}

@@ -144,12 +398,34 @@ But now, the `with` block is not explicitly in the function, but in the dependen
 # Code below omitted 👇
 ```

+////
+
 /// details | 👀 Full file preview

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001.py!}
 ```

+////
+
 ///

 We will see how this is very useful when testing the code later. ✅
@@ -166,6 +442,40 @@ session: Session = Depends(get_session)

 And then we remove the previous `with` block with the old **session**.

+//// tab | Python 3.10+
+
+```Python hl_lines="13  24  33  42  57"
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:1-2]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:40-42]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py[ln:53-104]!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="15  26  35  44  59"
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:1-4]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:42-44]!}
+
+# Code here omitted 👈
+
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py[ln:55-106]!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="15  26  35  44  59"
 {!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001.py[ln:1-4]!}

@@ -178,12 +488,34 @@ And then we remove the previous `with` block with the old **session**.
 {!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001.py[ln:55-106]!}
 ```

+////
+
 /// details | 👀 Full file preview

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/fastapi/session_with_dependency/tutorial001.py!}
 ```

+////
+
 ///

 ## Recap