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

Co-authored-by: Esteban Maya Cadavid <emayacadavid9@gmail.com>
2024-03-21 17:49:38 -05:00
parent 4c3f242ae2
commit 9141c8a920
39 changed files with 7456 additions and 25 deletions
--- a/docs/tutorial/many-to-many/link-with-extra-fields.md
+++ b/docs/tutorial/many-to-many/link-with-extra-fields.md
@@ -32,6 +32,32 @@ We will add a new field `is_training`.

 And we will also add two **relationship attributes**, for the linked `team` and `hero`:

+//// tab | Python 3.10+
+
+```Python hl_lines="6  8-9"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py[ln:4-10]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="10  12-13"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py[ln:6-16]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="10  12-13"
 # Code above omitted 👆

@@ -40,12 +66,34 @@ And we will also add two **relationship attributes**, for the linked `team` and
 # Code below omitted 👇
 ```

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

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/many_to_many/tutorial003.py!}
 ```

+////
+
 ///

 The new **relationship attributes** have their own `back_populates` pointing to new relationship attributes we will create in the `Hero` and `Team` models:
@@ -67,6 +115,32 @@ Now let's update the `Team` model.

 We no longer have the `heroes` relationship attribute, and instead we have the new `hero_links` attribute:

+//// tab | Python 3.10+
+
+```Python hl_lines="8"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py[ln:13-18]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="8"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py[ln:19-24]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="8"
 # Code above omitted 👆

@@ -75,12 +149,34 @@ We no longer have the `heroes` relationship attribute, and instead we have the n
 # Code below omitted 👇
 ```

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

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/many_to_many/tutorial003.py!}
 ```

+////
+
 ///

 ## Update Hero Model
@@ -89,6 +185,32 @@ The same with the `Hero` model.

 We change the `teams` relationship attribute for `team_links`:

+//// tab | Python 3.10+
+
+```Python hl_lines="9"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py[ln:21-27]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py[ln:27-33]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="9"
 # Code above omitted 👆

@@ -97,12 +219,34 @@ We change the `teams` relationship attribute for `team_links`:
 # Code below omitted 👇
 ```

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

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/many_to_many/tutorial003.py!}
 ```

+////
+
 ///

 ## Create Relationships
@@ -111,6 +255,32 @@ Now the process to create relationships is very similar.

 But now we create the **explicit link models** manually, pointing to their hero and team instances, and specifying the additional link data (`is_training`):

+//// tab | Python 3.10+
+
+```Python hl_lines="21-30  32-35"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py[ln:40-79]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="21-30  32-35"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py[ln:46-85]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="21-30  32-35"
 # Code above omitted 👆

@@ -119,12 +289,34 @@ But now we create the **explicit link models** manually, pointing to their hero
 # Code below omitted 👇
 ```

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

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/many_to_many/tutorial003.py!}
 ```

+////
+
 ///

 We are just adding the link model instances to the session, because the link model instances are connected to the heroes and teams, they will be also automatically included in the session when we commit.
@@ -223,6 +415,32 @@ Now, to add a new relationship, we have to create a new `HeroTeamLink` instance

 Here we do that in the `update_heroes()` function:

+//// tab | Python 3.10+
+
+```Python hl_lines="10-15"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py[ln:82-97]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="10-15"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py[ln:88-103]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="10-15"
 # Code above omitted 👆

@@ -231,12 +449,34 @@ Here we do that in the `update_heroes()` function:
 # Code below omitted 👇
 ```

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

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/many_to_many/tutorial003.py!}
 ```

+////
+
 ///

 ## Run the Program with the New Relationship
@@ -318,6 +558,40 @@ So now we want to update the status of `is_training` to `False`.

 We can do that by iterating on the links:

+//// tab | Python 3.10+
+
+```Python hl_lines="8-10"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py[ln:82-83]!}
+
+        # Code here omitted 👈
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py[ln:99-107]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="8-10"
+# Code above omitted 👆
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py[ln:88-89]!}
+
+        # Code here omitted 👈
+
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py[ln:105-113]!}
+
+# Code below omitted 👇
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python hl_lines="8-10"
 # Code above omitted 👆

@@ -330,12 +604,34 @@ We can do that by iterating on the links:
 # Code below omitted 👇
 ```

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

+//// tab | Python 3.10+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!./docs_src/tutorial/many_to_many/tutorial003_py39.py!}
+```
+
+////
+
+//// tab | Python 3.7+
+
 ```Python
 {!./docs_src/tutorial/many_to_many/tutorial003.py!}
 ```

+////
+
 ///

 ## Run the Program with the Updated Relationships