From f8c6df190c8bffcab8868b82eadf744cd98d8a91 Mon Sep 17 00:00:00 2001
From: sneakers-the-rat <sneakers-the-rat@protonmail.com>
Date: Tue, 14 Apr 2026 18:45:26 -0700
Subject: [PATCH] add tests for tutorials

---
 .../test_tutorial003.py                       | 43 ++++++++++++++++++
 .../test_tutorial004.py                       | 44 +++++++++++++++++++
 2 files changed, 87 insertions(+)
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial003.py
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial004.py

diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial003.py b/tests/test_tutorial/test_request_form_models/test_tutorial003.py
new file mode 100644
index 0000000000..b4973178a3
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial003.py
@@ -0,0 +1,43 @@
+import importlib
+
+import pytest
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(
+    name="client",
+    params=[
+        "tutorial003_py310",
+        "tutorial003_an_py310",
+    ],
+)
+def get_client(request: pytest.FixtureRequest):
+    mod = importlib.import_module(f"docs_src.request_form_models.{request.param}")
+
+    client = TestClient(mod.app)
+    return client
+
+
+def test_get_form(client: TestClient):
+    """The form has a checkbox that is by default checked"""
+    response = client.get("/form")
+    response.raise_for_status()
+    assert '<input type="checkbox" name="checkbox"' in response.text
+    assert 'checked="checked"' in response.text
+
+
+def test_post_form_checked(client: TestClient):
+    """When the checkbox is checked, the value is (correctly) True"""
+    response = client.post("/form", data={"checkbox": "on"})
+    response.raise_for_status()
+    assert response.json() == {"checkbox": True}
+
+
+def test_post_form_unchecked(client: TestClient):
+    """
+    When the checkbox is not checked,
+    the value is (maybe correctly but undesirably) still True
+    """
+    response = client.post("/form", data={"checkbox": ""})
+    response.raise_for_status()
+    assert response.json() == {"checkbox": True}
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial004.py b/tests/test_tutorial/test_request_form_models/test_tutorial004.py
new file mode 100644
index 0000000000..1afdeddd34
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial004.py
@@ -0,0 +1,44 @@
+import importlib
+
+import pytest
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(
+    name="client",
+    params=[
+        "tutorial004_py310",
+        "tutorial004_an_py310",
+    ],
+)
+def get_client(request: pytest.FixtureRequest):
+    mod = importlib.import_module(f"docs_src.request_form_models.{request.param}")
+
+    client = TestClient(mod.app)
+    return client
+
+
+def test_get_form(client: TestClient):
+    """The form has a checkbox that is by default checked"""
+    response = client.get("/form")
+    response.raise_for_status()
+    assert '<input type="checkbox" name="checkbox"' in response.text
+    assert 'checked="checked"' in response.text
+
+
+def test_post_form_checked(client: TestClient):
+    """When the checkbox is checked, the value is (correctly) True"""
+    response = client.post("/form", data={"checkbox": "on"})
+    response.raise_for_status()
+    assert response.json() == {"checkbox": True}
+
+
+def test_post_form_unchecked(client: TestClient):
+    """
+    When the checkbox is not checked,
+    now that we have a model validator that can differentiate defaults vs. undefined,
+    the checkbox is correctly false.
+    """
+    response = client.post("/form", data={"checkbox": ""})
+    response.raise_for_status()
+    assert response.json() == {"checkbox": False}