From 0f3e65b00712a59d763cf9c7715cde353bb94b02 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 16:40:48 +0200
Subject: [PATCH] =?utf8?q?=E2=9C=A8=20Add=20support=20for=20Pydantic=20mod?=
 =?utf8?q?els=20in=20`Form`=20parameters=20(#12127)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

---
 .../tutorial/request-form-models/image01.png  | Bin 0 -> 44487 bytes
 docs/en/docs/tutorial/request-form-models.md  |  65 +++++
 docs/en/mkdocs.yml                            |   1 +
 docs_src/request_form_models/tutorial001.py   |  14 +
 .../request_form_models/tutorial001_an.py     |  15 ++
 .../tutorial001_an_py39.py                    |  16 ++
 fastapi/dependencies/utils.py                 |  17 +-
 .../playwright/request_form_models/image01.py |  36 +++
 tests/test_forms_single_model.py              | 129 ++++++++++
 .../test_request_form_models/__init__.py      |   0
 .../test_tutorial001.py                       | 232 +++++++++++++++++
 .../test_tutorial001_an.py                    | 232 +++++++++++++++++
 .../test_tutorial001_an_py39.py               | 240 ++++++++++++++++++
 13 files changed, 994 insertions(+), 3 deletions(-)
 create mode 100644 docs/en/docs/img/tutorial/request-form-models/image01.png
 create mode 100644 docs/en/docs/tutorial/request-form-models.md
 create mode 100644 docs_src/request_form_models/tutorial001.py
 create mode 100644 docs_src/request_form_models/tutorial001_an.py
 create mode 100644 docs_src/request_form_models/tutorial001_an_py39.py
 create mode 100644 scripts/playwright/request_form_models/image01.py
 create mode 100644 tests/test_forms_single_model.py
 create mode 100644 tests/test_tutorial/test_request_form_models/__init__.py
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001.py
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py

diff --git a/docs/en/docs/img/tutorial/request-form-models/image01.png b/docs/en/docs/img/tutorial/request-form-models/image01.png
new file mode 100644
index 0000000000000000000000000000000000000000..3fe32c03d589e76abec5e9c6b71374ebd4e8cd2c
GIT binary patch
literal 44487
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

literal 0
Hc-jL100001

diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
new file mode 100644
index 0000000000..8bb1ffb1fc
--- /dev/null
+++ b/docs/en/docs/tutorial/request-form-models.md
@@ -0,0 +1,65 @@
+# Form Models
+
+You can use Pydantic models to declare form fields in FastAPI.
+
+/// info
+
+To use forms, first install <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
+
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install it, for example:
+
+```console
+$ pip install python-multipart
+```
+
+///
+
+/// note
+
+This is supported since FastAPI version `0.113.0`. 🤓
+
+///
+
+## Pydantic Models for Forms
+
+You just need to declare a Pydantic model with the fields you want to receive as form fields, and then declare the parameter as `Form`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-11  15"
+{!> ../../../docs_src/request_form_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="8-10  14"
+{!> ../../../docs_src/request_form_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="7-9  13"
+{!> ../../../docs_src/request_form_models/tutorial001.py!}
+```
+
+////
+
+FastAPI will extract the data for each field from the form data in the request and give you the Pydantic model you defined.
+
+## Check the Docs
+
+You can verify it in the docs UI at `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/request-form-models/image01.png">
+</div>
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 528c80b8e6..7c810c2d7c 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -129,6 +129,7 @@ nav:
     - tutorial/extra-models.md
     - tutorial/response-status-code.md
     - tutorial/request-forms.md
+    - tutorial/request-form-models.md
     - tutorial/request-files.md
     - tutorial/request-forms-and-files.md
     - tutorial/handling-errors.md
diff --git a/docs_src/request_form_models/tutorial001.py b/docs_src/request_form_models/tutorial001.py
new file mode 100644
index 0000000000..98feff0b9f
--- /dev/null
+++ b/docs_src/request_form_models/tutorial001.py
@@ -0,0 +1,14 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+    username: str
+    password: str
+
+
+@app.post("/login/")
+async def login(data: FormData = Form()):
+    return data
diff --git a/docs_src/request_form_models/tutorial001_an.py b/docs_src/request_form_models/tutorial001_an.py
new file mode 100644
index 0000000000..30483d4455
--- /dev/null
+++ b/docs_src/request_form_models/tutorial001_an.py
@@ -0,0 +1,15 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+    username: str
+    password: str
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+    return data
diff --git a/docs_src/request_form_models/tutorial001_an_py39.py b/docs_src/request_form_models/tutorial001_an_py39.py
new file mode 100644
index 0000000000..7cc81aae95
--- /dev/null
+++ b/docs_src/request_form_models/tutorial001_an_py39.py
@@ -0,0 +1,16 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+    username: str
+    password: str
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+    return data
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 7ac18d941c..98ce17b55d 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -33,6 +33,7 @@ from fastapi._compat import (
     field_annotation_is_scalar,
     get_annotation_from_field_info,
     get_missing_field_error,
+    get_model_fields,
     is_bytes_field,
     is_bytes_sequence_field,
     is_scalar_field,
@@ -56,6 +57,7 @@ from fastapi.security.base import SecurityBase
 from fastapi.security.oauth2 import OAuth2, SecurityScopes
 from fastapi.security.open_id_connect_url import OpenIdConnect
 from fastapi.utils import create_model_field, get_path_param_names
+from pydantic import BaseModel
 from pydantic.fields import FieldInfo
 from starlette.background import BackgroundTasks as StarletteBackgroundTasks
 from starlette.concurrency import run_in_threadpool
@@ -743,7 +745,9 @@ def _should_embed_body_fields(fields: List[ModelField]) -> bool:
         return True
     # If it's a Form (or File) field, it has to be a BaseModel to be top level
     # otherwise it has to be embedded, so that the key value pair can be extracted
-    if isinstance(first_field.field_info, params.Form):
+    if isinstance(first_field.field_info, params.Form) and not lenient_issubclass(
+        first_field.type_, BaseModel
+    ):
         return True
     return False
 
@@ -783,7 +787,8 @@ async def _extract_form_body(
                 for sub_value in value:
                     tg.start_soon(process_fn, sub_value.read)
             value = serialize_sequence_value(field=field, value=results)
-        values[field.name] = value
+        if value is not None:
+            values[field.name] = value
     return values
 
 
@@ -798,8 +803,14 @@ async def request_body_to_args(
     single_not_embedded_field = len(body_fields) == 1 and not embed_body_fields
     first_field = body_fields[0]
     body_to_process = received_body
+
+    fields_to_extract: List[ModelField] = body_fields
+
+    if single_not_embedded_field and lenient_issubclass(first_field.type_, BaseModel):
+        fields_to_extract = get_model_fields(first_field.type_)
+
     if isinstance(received_body, FormData):
-        body_to_process = await _extract_form_body(body_fields, received_body)
+        body_to_process = await _extract_form_body(fields_to_extract, received_body)
 
     if single_not_embedded_field:
         loc: Tuple[str, ...] = ("body",)
diff --git a/scripts/playwright/request_form_models/image01.py b/scripts/playwright/request_form_models/image01.py
new file mode 100644
index 0000000000..15bd3858c5
--- /dev/null
+++ b/scripts/playwright/request_form_models/image01.py
@@ -0,0 +1,36 @@
+import subprocess
+import time
+
+import httpx
+from playwright.sync_api import Playwright, sync_playwright
+
+
+# Run playwright codegen to generate the code below, copy paste the sections in run()
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context()
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_role("button", name="POST /login/ Login").click()
+    page.get_by_role("button", name="Try it out").click()
+    page.screenshot(path="docs/en/docs/img/tutorial/request-form-models/image01.png")
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["fastapi", "run", "docs_src/request_form_models/tutorial001.py"]
+)
+try:
+    for _ in range(3):
+        try:
+            response = httpx.get("http://localhost:8000/docs")
+        except httpx.ConnectError:
+            time.sleep(1)
+            break
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/tests/test_forms_single_model.py b/tests/test_forms_single_model.py
new file mode 100644
index 0000000000..7ed3ba3a2d
--- /dev/null
+++ b/tests/test_forms_single_model.py
@@ -0,0 +1,129 @@
+from typing import List, Optional
+
+from dirty_equals import IsDict
+from fastapi import FastAPI, Form
+from fastapi.testclient import TestClient
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class FormModel(BaseModel):
+    username: str
+    lastname: str
+    age: Optional[int] = None
+    tags: List[str] = ["foo", "bar"]
+
+
+@app.post("/form/")
+def post_form(user: Annotated[FormModel, Form()]):
+    return user
+
+
+client = TestClient(app)
+
+
+def test_send_all_data():
+    response = client.post(
+        "/form/",
+        data={
+            "username": "Rick",
+            "lastname": "Sanchez",
+            "age": "70",
+            "tags": ["plumbus", "citadel"],
+        },
+    )
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "username": "Rick",
+        "lastname": "Sanchez",
+        "age": 70,
+        "tags": ["plumbus", "citadel"],
+    }
+
+
+def test_defaults():
+    response = client.post("/form/", data={"username": "Rick", "lastname": "Sanchez"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "username": "Rick",
+        "lastname": "Sanchez",
+        "age": None,
+        "tags": ["foo", "bar"],
+    }
+
+
+def test_invalid_data():
+    response = client.post(
+        "/form/",
+        data={
+            "username": "Rick",
+            "lastname": "Sanchez",
+            "age": "seventy",
+            "tags": ["plumbus", "citadel"],
+        },
+    )
+    assert response.status_code == 422, response.text
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "int_parsing",
+                    "loc": ["body", "age"],
+                    "msg": "Input should be a valid integer, unable to parse string as an integer",
+                    "input": "seventy",
+                }
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "age"],
+                    "msg": "value is not a valid integer",
+                    "type": "type_error.integer",
+                }
+            ]
+        }
+    )
+
+
+def test_no_data():
+    response = client.post("/form/")
+    assert response.status_code == 422, response.text
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "username"],
+                    "msg": "Field required",
+                    "input": {"tags": ["foo", "bar"]},
+                },
+                {
+                    "type": "missing",
+                    "loc": ["body", "lastname"],
+                    "msg": "Field required",
+                    "input": {"tags": ["foo", "bar"]},
+                },
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "username"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+                {
+                    "loc": ["body", "lastname"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+            ]
+        }
+    )
diff --git a/tests/test_tutorial/test_request_form_models/__init__.py b/tests/test_tutorial/test_request_form_models/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001.py b/tests/test_tutorial/test_request_form_models/test_tutorial001.py
new file mode 100644
index 0000000000..46c130ee8c
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial001.py
@@ -0,0 +1,232 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.request_form_models.tutorial001 import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_post_body_form(client: TestClient):
+    response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+    assert response.status_code == 200
+    assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+def test_post_body_form_no_password(client: TestClient):
+    response = client.post("/login/", data={"username": "Foo"})
+    assert response.status_code == 422
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "password"],
+                    "msg": "Field required",
+                    "input": {"username": "Foo"},
+                }
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "password"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                }
+            ]
+        }
+    )
+
+
+def test_post_body_form_no_username(client: TestClient):
+    response = client.post("/login/", data={"password": "secret"})
+    assert response.status_code == 422
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "username"],
+                    "msg": "Field required",
+                    "input": {"password": "secret"},
+                }
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "username"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                }
+            ]
+        }
+    )
+
+
+def test_post_body_form_no_data(client: TestClient):
+    response = client.post("/login/")
+    assert response.status_code == 422
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "username"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+                {
+                    "type": "missing",
+                    "loc": ["body", "password"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "username"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+                {
+                    "loc": ["body", "password"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+            ]
+        }
+    )
+
+
+def test_post_body_json(client: TestClient):
+    response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+    assert response.status_code == 422, response.text
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "username"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+                {
+                    "type": "missing",
+                    "loc": ["body", "password"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "username"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+                {
+                    "loc": ["body", "password"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+            ]
+        }
+    )
+
+
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/login/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Login",
+                    "operationId": "login_login__post",
+                    "requestBody": {
+                        "content": {
+                            "application/x-www-form-urlencoded": {
+                                "schema": {"$ref": "#/components/schemas/FormData"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "FormData": {
+                    "properties": {
+                        "username": {"type": "string", "title": "Username"},
+                        "password": {"type": "string", "title": "Password"},
+                    },
+                    "type": "object",
+                    "required": ["username", "password"],
+                    "title": "FormData",
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py b/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
new file mode 100644
index 0000000000..4e14d89c84
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
@@ -0,0 +1,232 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.request_form_models.tutorial001_an import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_post_body_form(client: TestClient):
+    response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+    assert response.status_code == 200
+    assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+def test_post_body_form_no_password(client: TestClient):
+    response = client.post("/login/", data={"username": "Foo"})
+    assert response.status_code == 422
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "password"],
+                    "msg": "Field required",
+                    "input": {"username": "Foo"},
+                }
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "password"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                }
+            ]
+        }
+    )
+
+
+def test_post_body_form_no_username(client: TestClient):
+    response = client.post("/login/", data={"password": "secret"})
+    assert response.status_code == 422
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "username"],
+                    "msg": "Field required",
+                    "input": {"password": "secret"},
+                }
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "username"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                }
+            ]
+        }
+    )
+
+
+def test_post_body_form_no_data(client: TestClient):
+    response = client.post("/login/")
+    assert response.status_code == 422
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "username"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+                {
+                    "type": "missing",
+                    "loc": ["body", "password"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "username"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+                {
+                    "loc": ["body", "password"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+            ]
+        }
+    )
+
+
+def test_post_body_json(client: TestClient):
+    response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+    assert response.status_code == 422, response.text
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "username"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+                {
+                    "type": "missing",
+                    "loc": ["body", "password"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "username"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+                {
+                    "loc": ["body", "password"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+            ]
+        }
+    )
+
+
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/login/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Login",
+                    "operationId": "login_login__post",
+                    "requestBody": {
+                        "content": {
+                            "application/x-www-form-urlencoded": {
+                                "schema": {"$ref": "#/components/schemas/FormData"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "FormData": {
+                    "properties": {
+                        "username": {"type": "string", "title": "Username"},
+                        "password": {"type": "string", "title": "Password"},
+                    },
+                    "type": "object",
+                    "required": ["username", "password"],
+                    "title": "FormData",
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py b/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
new file mode 100644
index 0000000000..2e6426aa78
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
@@ -0,0 +1,240 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_py39
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.request_form_models.tutorial001_an_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py39
+def test_post_body_form(client: TestClient):
+    response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+    assert response.status_code == 200
+    assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+@needs_py39
+def test_post_body_form_no_password(client: TestClient):
+    response = client.post("/login/", data={"username": "Foo"})
+    assert response.status_code == 422
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "password"],
+                    "msg": "Field required",
+                    "input": {"username": "Foo"},
+                }
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "password"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                }
+            ]
+        }
+    )
+
+
+@needs_py39
+def test_post_body_form_no_username(client: TestClient):
+    response = client.post("/login/", data={"password": "secret"})
+    assert response.status_code == 422
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "username"],
+                    "msg": "Field required",
+                    "input": {"password": "secret"},
+                }
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "username"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                }
+            ]
+        }
+    )
+
+
+@needs_py39
+def test_post_body_form_no_data(client: TestClient):
+    response = client.post("/login/")
+    assert response.status_code == 422
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "username"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+                {
+                    "type": "missing",
+                    "loc": ["body", "password"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "username"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+                {
+                    "loc": ["body", "password"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+            ]
+        }
+    )
+
+
+@needs_py39
+def test_post_body_json(client: TestClient):
+    response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+    assert response.status_code == 422, response.text
+    assert response.json() == IsDict(
+        {
+            "detail": [
+                {
+                    "type": "missing",
+                    "loc": ["body", "username"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+                {
+                    "type": "missing",
+                    "loc": ["body", "password"],
+                    "msg": "Field required",
+                    "input": {},
+                },
+            ]
+        }
+    ) | IsDict(
+        # TODO: remove when deprecating Pydantic v1
+        {
+            "detail": [
+                {
+                    "loc": ["body", "username"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+                {
+                    "loc": ["body", "password"],
+                    "msg": "field required",
+                    "type": "value_error.missing",
+                },
+            ]
+        }
+    )
+
+
+@needs_py39
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/login/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Login",
+                    "operationId": "login_login__post",
+                    "requestBody": {
+                        "content": {
+                            "application/x-www-form-urlencoded": {
+                                "schema": {"$ref": "#/components/schemas/FormData"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "FormData": {
+                    "properties": {
+                        "username": {"type": "string", "title": "Username"},
+                        "password": {"type": "string", "title": "Password"},
+                    },
+                    "type": "object",
+                    "required": ["username", "password"],
+                    "title": "FormData",
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
-- 
2.47.3