📝 Add source examples for Python 3.9 and 3.10 (#715)

* 📝 Add source examples for Python 3.9 and 3.10

* ✅ Add tests for new source examples for Python 3.9 and 3.10, still needs pytest markers

* ✅ Add tests for fastapi examples

* ✅ Update tests for FastAPI app testing, for Python 3.9 and 3.10, fixing multi-app testing conflicts

* ✅ Require Python 3.9 and 3.10 for tests

* ✅ Update tests with missing markers

tests/test_tutorial/test_one/test_tutorial001_py310.py

@@ -0,0 +1,30 @@
+from unittest.mock import patch
+
+from sqlmodel import create_engine
+
+from ...conftest import get_testing_print_function, needs_py310
+
+
+@needs_py310
+def test_tutorial(clear_sqlmodel):
+    from docs_src.tutorial.one import tutorial001_py310 as mod
+
+    mod.sqlite_url = "sqlite://"
+    mod.engine = create_engine(mod.sqlite_url)
+    calls = []
+
+    new_print = get_testing_print_function(calls)
+
+    with patch("builtins.print", new=new_print):
+        mod.main()
+    assert calls == [
+        [
+            "Hero:",
+            {
+                "name": "Tarantula",
+                "secret_name": "Natalia Roman-on",
+                "age": 32,
+                "id": 4,
+            },
+        ]
+    ]

tests/test_tutorial/test_one/test_tutorial002_py310.py

@@ -0,0 +1,20 @@
+from unittest.mock import patch
+
+from sqlmodel import create_engine
+
+from ...conftest import get_testing_print_function, needs_py310
+
+
+@needs_py310
+def test_tutorial(clear_sqlmodel):
+    from docs_src.tutorial.one import tutorial002_py310 as mod
+
+    mod.sqlite_url = "sqlite://"
+    mod.engine = create_engine(mod.sqlite_url)
+    calls = []
+
+    new_print = get_testing_print_function(calls)
+
+    with patch("builtins.print", new=new_print):
+        mod.main()
+    assert calls == [["Hero:", None]]

tests/test_tutorial/test_one/test_tutorial003_py310.py

@@ -0,0 +1,25 @@
+from unittest.mock import patch
+
+from sqlmodel import create_engine
+
+from ...conftest import get_testing_print_function, needs_py310
+
+
+@needs_py310
+def test_tutorial(clear_sqlmodel):
+    from docs_src.tutorial.one import tutorial003_py310 as mod
+
+    mod.sqlite_url = "sqlite://"
+    mod.engine = create_engine(mod.sqlite_url)
+    calls = []
+
+    new_print = get_testing_print_function(calls)
+
+    with patch("builtins.print", new=new_print):
+        mod.main()
+    assert calls == [
+        [
+            "Hero:",
+            {"name": "Deadpond", "secret_name": "Dive Wilson", "age": None, "id": 1},
+        ]
+    ]

tests/test_tutorial/test_one/test_tutorial004_py310.py

@@ -0,0 +1,41 @@
+from unittest.mock import patch
+
+import pytest
+from sqlalchemy.exc import MultipleResultsFound
+from sqlmodel import Session, create_engine, delete
+
+from ...conftest import get_testing_print_function, needs_py310
+
+
+@needs_py310
+def test_tutorial(clear_sqlmodel):
+    from docs_src.tutorial.one import tutorial004_py310 as mod
+
+    mod.sqlite_url = "sqlite://"
+    mod.engine = create_engine(mod.sqlite_url)
+    with pytest.raises(MultipleResultsFound):
+        mod.main()
+    with Session(mod.engine) as session:
+        # TODO: create delete() function
+        # TODO: add overloads for .exec() with delete object
+        session.exec(delete(mod.Hero))
+        session.add(mod.Hero(name="Test Hero", secret_name="Secret Test Hero", age=24))
+        session.commit()
+
+    calls = []
+
+    new_print = get_testing_print_function(calls)
+
+    with patch("builtins.print", new=new_print):
+        mod.select_heroes()
+    assert calls == [
+        [
+            "Hero:",
+            {
+                "id": 1,
+                "name": "Test Hero",
+                "secret_name": "Secret Test Hero",
+                "age": 24,
+            },
+        ]
+    ]

tests/test_tutorial/test_one/test_tutorial005_py310.py

@@ -0,0 +1,41 @@
+from unittest.mock import patch
+
+import pytest
+from sqlalchemy.exc import NoResultFound
+from sqlmodel import Session, create_engine, delete
+
+from ...conftest import get_testing_print_function, needs_py310
+
+
+@needs_py310
+def test_tutorial(clear_sqlmodel):
+    from docs_src.tutorial.one import tutorial005_py310 as mod
+
+    mod.sqlite_url = "sqlite://"
+    mod.engine = create_engine(mod.sqlite_url)
+    with pytest.raises(NoResultFound):
+        mod.main()
+    with Session(mod.engine) as session:
+        # TODO: create delete() function
+        # TODO: add overloads for .exec() with delete object
+        session.exec(delete(mod.Hero))
+        session.add(mod.Hero(name="Test Hero", secret_name="Secret Test Hero", age=24))
+        session.commit()
+
+    calls = []
+
+    new_print = get_testing_print_function(calls)
+
+    with patch("builtins.print", new=new_print):
+        mod.select_heroes()
+    assert calls == [
+        [
+            "Hero:",
+            {
+                "id": 1,
+                "name": "Test Hero",
+                "secret_name": "Secret Test Hero",
+                "age": 24,
+            },
+        ]
+    ]

tests/test_tutorial/test_one/test_tutorial006_py310.py

@@ -0,0 +1,25 @@
+from unittest.mock import patch
+
+from sqlmodel import create_engine
+
+from ...conftest import get_testing_print_function, needs_py310
+
+
+@needs_py310
+def test_tutorial(clear_sqlmodel):
+    from docs_src.tutorial.one import tutorial006_py310 as mod
+
+    mod.sqlite_url = "sqlite://"
+    mod.engine = create_engine(mod.sqlite_url)
+    calls = []
+
+    new_print = get_testing_print_function(calls)
+
+    with patch("builtins.print", new=new_print):
+        mod.main()
+    assert calls == [
+        [
+            "Hero:",
+            {"name": "Deadpond", "secret_name": "Dive Wilson", "age": None, "id": 1},
+        ]
+    ]

tests/test_tutorial/test_one/test_tutorial007_py310.py

@@ -0,0 +1,25 @@
+from unittest.mock import patch
+
+from sqlmodel import create_engine
+
+from ...conftest import get_testing_print_function, needs_py310
+
+
+@needs_py310
+def test_tutorial(clear_sqlmodel):
+    from docs_src.tutorial.one import tutorial007_py310 as mod
+
+    mod.sqlite_url = "sqlite://"
+    mod.engine = create_engine(mod.sqlite_url)
+    calls = []
+
+    new_print = get_testing_print_function(calls)
+
+    with patch("builtins.print", new=new_print):
+        mod.main()
+    assert calls == [
+        [
+            "Hero:",
+            {"name": "Deadpond", "secret_name": "Dive Wilson", "age": None, "id": 1},
+        ]
+    ]

tests/test_tutorial/test_one/test_tutorial008_py310.py

@@ -0,0 +1,25 @@
+from unittest.mock import patch
+
+from sqlmodel import create_engine
+
+from ...conftest import get_testing_print_function, needs_py310
+
+
+@needs_py310
+def test_tutorial(clear_sqlmodel):
+    from docs_src.tutorial.one import tutorial008_py310 as mod
+
+    mod.sqlite_url = "sqlite://"
+    mod.engine = create_engine(mod.sqlite_url)
+    calls = []
+
+    new_print = get_testing_print_function(calls)
+
+    with patch("builtins.print", new=new_print):
+        mod.main()
+    assert calls == [
+        [
+            "Hero:",
+            {"name": "Deadpond", "secret_name": "Dive Wilson", "age": None, "id": 1},
+        ]
+    ]

tests/test_tutorial/test_one/test_tutorial009_py310.py

@@ -0,0 +1,20 @@
+from unittest.mock import patch
+
+from sqlmodel import create_engine
+
+from ...conftest import get_testing_print_function, needs_py310
+
+
+@needs_py310
+def test_tutorial(clear_sqlmodel):
+    from docs_src.tutorial.one import tutorial009_py310 as mod
+
+    mod.sqlite_url = "sqlite://"
+    mod.engine = create_engine(mod.sqlite_url)
+    calls = []
+
+    new_print = get_testing_print_function(calls)
+
+    with patch("builtins.print", new=new_print):
+        mod.main()
+    assert calls == [["Hero:", None]]