From 7ff5da8bf2b8bfe895e4621f630e9fc3f2c434f4 Mon Sep 17 00:00:00 2001
From: Dom <domdent@protonmail.com>
Date: Tue, 6 Aug 2024 14:46:39 +0100
Subject: [PATCH 001/146] edit middleware docs code sample to use perf_counter
 as a timer

---
 docs_src/middleware/tutorial001.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs_src/middleware/tutorial001.py b/docs_src/middleware/tutorial001.py
index 6bab3410a..e65a7dade 100644
--- a/docs_src/middleware/tutorial001.py
+++ b/docs_src/middleware/tutorial001.py
@@ -7,8 +7,8 @@ app = FastAPI()
 
 @app.middleware("http")
 async def add_process_time_header(request: Request, call_next):
-    start_time = time.time()
+    start_time = time.perf_counter()
     response = await call_next(request)
-    process_time = time.time() - start_time
+    process_time = time.perf_counter() - start_time
     response.headers["X-Process-Time"] = str(process_time)
     return response

From 34e6e63fb2ca05a5929bc2d151b4e45194ed87a0 Mon Sep 17 00:00:00 2001
From: Yuki Watanabe <ukwhatn@gmail.com>
Date: Thu, 22 Aug 2024 01:55:16 +0900
Subject: [PATCH 002/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Japanese=20transla?=
 =?UTF-8?q?tion=20for=20`docs/ja/docs/learn/index.md`=20(#11592)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ja/docs/learn/index.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 docs/ja/docs/learn/index.md

diff --git a/docs/ja/docs/learn/index.md b/docs/ja/docs/learn/index.md
new file mode 100644
index 000000000..2f24c670a
--- /dev/null
+++ b/docs/ja/docs/learn/index.md
@@ -0,0 +1,5 @@
+# 学習
+
+ここでは、**FastAPI** を学習するための入門セクションとチュートリアルを紹介します。
+
+これは、FastAPIを学習するにあたっての**書籍**や**コース**であり、**公式**かつ推奨される方法とみなすことができます 😎

From 2fe05762b2672959d754ee869a11efbf9cdd6e97 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 21 Aug 2024 16:55:38 +0000
Subject: [PATCH 003/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f562ba06e..a9fcd1383 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -31,6 +31,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Japanese translation for `docs/ja/docs/learn/index.md`. PR [#11592](https://github.com/fastapi/fastapi/pull/11592) by [@ukwhatn](https://github.com/ukwhatn).
 * 📝 Update Spanish translation docs for consistency. PR [#12044](https://github.com/fastapi/fastapi/pull/12044) by [@alejsdev](https://github.com/alejsdev).
 * 🌐 Update docs about dependencies with yield. PR [#12028](https://github.com/fastapi/fastapi/pull/12028) by [@xuvjso](https://github.com/xuvjso).
 * 📝 Update FastAPI People, do not translate to have the most recent info. PR [#12034](https://github.com/fastapi/fastapi/pull/12034) by [@tiangolo](https://github.com/tiangolo).

From 38ff43b690df0d5a8ce7e4069750696eca323c23 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Pedro=20Pereira=20Holanda?=
 <joaopedroph09@gmail.com>
Date: Wed, 21 Aug 2024 13:56:50 -0300
Subject: [PATCH 004/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/request=5Ffile.md`=20(#12?=
 =?UTF-8?q?018)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/pt/docs/tutorial/request_files.md | 418 +++++++++++++++++++++++++
 1 file changed, 418 insertions(+)
 create mode 100644 docs/pt/docs/tutorial/request_files.md

diff --git a/docs/pt/docs/tutorial/request_files.md b/docs/pt/docs/tutorial/request_files.md
new file mode 100644
index 000000000..60e4ecb26
--- /dev/null
+++ b/docs/pt/docs/tutorial/request_files.md
@@ -0,0 +1,418 @@
+# Arquivos de Requisição
+
+Você pode definir arquivos para serem enviados para o cliente utilizando `File`.
+
+/// info
+
+Para receber arquivos compartilhados, primeiro  instale <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
+
+E.g. `pip install python-multipart`.
+
+Isso se deve por que arquivos enviados são enviados como "dados de formulário".
+
+///
+
+## Importe `File`
+
+Importe `File` e `UploadFile` do `fastapi`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="3"
+{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1"
+{!> ../../../docs_src/request_files/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="1"
+{!> ../../../docs_src/request_files/tutorial001.py!}
+```
+
+////
+
+## Defina os parâmetros de `File`
+
+Cria os parâmetros do arquivo da mesma forma que você faria para `Body` ou `Form`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9"
+{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="8"
+{!> ../../../docs_src/request_files/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="7"
+{!> ../../../docs_src/request_files/tutorial001.py!}
+```
+
+////
+
+/// info | Informação
+
+`File` é uma classe que herda diretamente de `Form`.
+
+Mas lembre-se que quando você importa `Query`,`Path`, `File`, entre outros, do `fastapi`, essas são na verdade funções que retornam classes especiais.
+
+///
+
+/// tip | Dica
+
+Para declarar o corpo de arquivos, você precisa utilizar `File`, do contrário os parâmetros seriam interpretados como parâmetros de consulta ou corpo (JSON) da requisição.
+
+///
+
+Os arquivos serão enviados como "form data".
+
+Se você declarar o tipo do seu parâmetro na sua *função de operação de rota* como `bytes`, o **FastAPI** irá ler o arquivo para você e você receberá o conteúdo como `bytes`.
+
+Lembre-se que isso significa que o conteúdo inteiro será armazenado em memória. Isso funciona bem para arquivos pequenos.
+
+Mas existem vários casos em que você pode se beneficiar ao usar `UploadFile`.
+
+## Parâmetros de arquivo com `UploadFile`
+
+Defina um parâmetro de arquivo com o tipo `UploadFile`
+
+//// tab | Python 3.9+
+
+```Python hl_lines="14"
+{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="13"
+{!> ../../../docs_src/request_files/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="12"
+{!> ../../../docs_src/request_files/tutorial001.py!}
+```
+
+////
+
+Utilizando `UploadFile` tem várias vantagens sobre `bytes`:
+
+* Você não precisa utilizar `File()` como o valor padrão do parâmetro.
+* A classe utiliza um arquivo em "spool":
+    * Um arquivo guardado em memória até um tamanho máximo, depois desse limite ele é guardado em disco.
+* Isso significa que a classe funciona bem com arquivos grandes como imagens, vídeos, binários extensos, etc. Sem consumir toda a memória.
+* Você pode obter metadados do arquivo enviado.
+* Ela possui uma interface <a href="https://docs.python.org/3/glossary.html#term-file-like-object" class="external-link" target="_blank">semelhante a arquivos</a> `async`.
+* Ela expõe um objeto python <a href="https://docs.python.org/3/library/tempfile.html#tempfile.SpooledTemporaryFile" class="external-link" target="_blank">`SpooledTemporaryFile`</a> que você pode repassar para bibliotecas que esperam um objeto com comportamento de arquivo.
+
+### `UploadFile`
+
+`UploadFile` tem os seguintes atributos:
+
+* `filename`: Uma string (`str`) com o nome original do arquivo enviado (e.g. `myimage.jpg`).
+* `content-type`: Uma `str` com o tipo do conteúdo (tipo MIME / media) (e.g. `image/jpeg`).
+* `file`: Um objeto do tipo <a href="https://docs.python.org/3/library/tempfile.html#tempfile.SpooledTemporaryFile" class="external-link" target="_blank">`SpooledTemporaryFile`</a> (um objeto <a href="https://docs.python.org/3/glossary.html#term-file-like-object" class="external-link" target="_blank">file-like</a>). O arquivo propriamente dito que você pode passar diretamente para outras funções ou bibliotecas que esperam um objeto "file-like".
+
+`UploadFile` tem os seguintes métodos `async`. Todos eles chamam os métodos de arquivos por baixo dos panos (usando o objeto `SpooledTemporaryFile` interno).
+
+* `write(data)`: escreve dados (`data`) em `str` ou `bytes` no arquivo.
+* `read(size)`: Lê um número de bytes/caracteres de acordo com a quantidade `size` (`int`).
+* `seek(offset)`: Navega para o byte na posição `offset` (`int`) do arquivo.
+    * E.g., `await myfile.seek(0)` navegaria para o ínicio do arquivo.
+    * Isso é especialmente útil se você executar `await myfile.read()` uma vez e depois precisar ler os conteúdos do arquivo de novo.
+* `close()`: Fecha o arquivo.
+
+Como todos esses métodos são assíncronos (`async`) você precisa esperar ("await") por eles.
+
+Por exemplo, dentro de uma *função de operação de rota* assíncrona você pode obter os conteúdos com:
+
+```Python
+contents = await myfile.read()
+```
+
+Se você estiver dentro de uma *função de operação de rota* definida normalmente com `def`, você pode acessar `UploadFile.file` diretamente, por exemplo:
+
+```Python
+contents = myfile.file.read()
+```
+
+/// note | Detalhes técnicos do `async`
+
+Quando você utiliza métodos assíncronos, o **FastAPI** executa os métodos do arquivo em uma threadpool e espera por eles.
+
+///
+
+/// note | Detalhes técnicos do Starlette
+
+O `UploadFile` do **FastAPI** herda diretamente do `UploadFile` do **Starlette**, mas adiciona algumas funcionalidades necessárias para ser compatível com o **Pydantic**
+
+///
+
+## O que é "Form Data"
+
+A forma como formulários HTML(`<form></form>`) enviam dados para o servidor normalmente utilizam uma codificação "especial" para esses dados, que é diferente do JSON.
+
+O **FastAPI** garante que os dados serão lidos da forma correta, em vez do JSON.
+
+/// note | Detalhes Técnicos
+
+Dados vindos de formulários geralmente tem a codificação com o "media type" `application/x-www-form-urlencoded` quando estes não incluem arquivos.
+
+Mas quando os dados incluem arquivos, eles são codificados como `multipart/form-data`. Se você utilizar `File`, **FastAPI** saberá que deve receber os arquivos da parte correta do corpo da requisição.
+
+Se você quer ler mais sobre essas codificações e campos de formulário, veja a documentação online da <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN</abbr> sobre <code> POST</code> </a>.
+
+///
+
+/// warning | Aviso
+
+Você pode declarar múltiplos parâmetros `File` e `Form` em uma *operação de rota*, mas você não pode declarar campos `Body`que seriam recebidos como JSON junto desses parâmetros, por que a codificação do corpo da requisição será `multipart/form-data` em vez de `application/json`.
+
+Isso não é uma limitação do **FastAPI**, é uma parte do protocolo HTTP.
+
+///
+
+## Arquivo de upload opcional
+
+Você pode definir um arquivo como opcional utilizando as anotações de tipo padrão e definindo o valor padrão como `None`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9  17"
+{!> ../../../docs_src/request_files/tutorial001_02_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9  17"
+{!> ../../../docs_src/request_files/tutorial001_02_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10  18"
+{!> ../../../docs_src/request_files/tutorial001_02_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated`, se possível
+
+///
+
+```Python hl_lines="7  15"
+{!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated`, se possível
+
+///
+
+```Python hl_lines="9  17"
+{!> ../../../docs_src/request_files/tutorial001_02.py!}
+```
+
+////
+
+## `UploadFile` com Metadados Adicionais
+
+Você também pode utilizar `File()` com `UploadFile`, por exemplo, para definir metadados adicionais:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9  15"
+{!> ../../../docs_src/request_files/tutorial001_03_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="8  14"
+{!> ../../../docs_src/request_files/tutorial001_03_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível
+
+///
+
+```Python hl_lines="7  13"
+{!> ../../../docs_src/request_files/tutorial001_03.py!}
+```
+
+////
+
+## Envio de Múltiplos Arquivos
+
+É possível enviar múltiplos arquivos ao mesmo tmepo.
+
+Ele ficam associados ao mesmo "campo do formulário" enviado com "form data".
+
+Para usar isso, declare uma lista de `bytes` ou `UploadFile`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="10  15"
+{!> ../../../docs_src/request_files/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11  16"
+{!> ../../../docs_src/request_files/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível
+
+///
+
+```Python hl_lines="8  13"
+{!> ../../../docs_src/request_files/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível
+
+///
+
+```Python hl_lines="10  15"
+{!> ../../../docs_src/request_files/tutorial002.py!}
+```
+
+////
+
+Você irá receber, como delcarado uma lista (`list`) de `bytes` ou `UploadFile`s,
+
+/// note | Detalhes Técnicos
+
+Você também poderia utilizar `from starlette.responses import HTMLResponse`.
+
+O **FastAPI** fornece as mesmas `starlette.responses` como `fastapi.responses` apenas como um facilitador para você, desenvolvedor. Mas a maior parte das respostas vem diretamente do Starlette.
+
+///
+
+### Enviando Múltiplos Arquivos com Metadados Adicionais
+
+E da mesma forma que antes, você pode utilizar `File()` para definir parâmetros adicionais, até mesmo para `UploadFile`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="11  18-20"
+{!> ../../../docs_src/request_files/tutorial003_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="12  19-21"
+{!> ../../../docs_src/request_files/tutorial003_an.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="9  16"
+{!> ../../../docs_src/request_files/tutorial003_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="11  18"
+{!> ../../../docs_src/request_files/tutorial003.py!}
+```
+
+////
+
+## Recapitulando
+
+Use `File`, `bytes` e `UploadFile` para declarar arquivos que serão enviados na requisição, enviados como dados do formulário.

From 4f3381a95eee1c1a76630d0a232cdd4553166d2b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 21 Aug 2024 16:58:20 +0000
Subject: [PATCH 005/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a9fcd1383..12f1f50cd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -31,6 +31,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request_file.md`. PR [#12018](https://github.com/fastapi/fastapi/pull/12018) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
 * 🌐 Add Japanese translation for `docs/ja/docs/learn/index.md`. PR [#11592](https://github.com/fastapi/fastapi/pull/11592) by [@ukwhatn](https://github.com/ukwhatn).
 * 📝 Update Spanish translation docs for consistency. PR [#12044](https://github.com/fastapi/fastapi/pull/12044) by [@alejsdev](https://github.com/alejsdev).
 * 🌐 Update docs about dependencies with yield. PR [#12028](https://github.com/fastapi/fastapi/pull/12028) by [@xuvjso](https://github.com/xuvjso).

From 705659bb2277633e75269de9bac9d84cc3c15ae4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 21 Aug 2024 19:47:31 -0500
Subject: [PATCH 006/146] =?UTF-8?q?=F0=9F=93=9D=20Add=20docs=20about=20Env?=
 =?UTF-8?q?ironment=20Variables=20and=20Virtual=20Environments=20(#12054)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                     |   2 +
 docs/en/docs/advanced/settings.md             | 126 +--
 docs/en/docs/advanced/templates.md            |   2 +-
 docs/en/docs/advanced/websockets.md           |   2 +-
 docs/en/docs/contributing.md                  | 138 +--
 docs/en/docs/deployment/manually.md           |   4 +-
 docs/en/docs/deployment/server-workers.md     |   2 +
 docs/en/docs/environment-variables.md         | 300 +++++++
 docs/en/docs/index.md                         |   2 +
 docs/en/docs/tutorial/index.md                |   8 +-
 docs/en/docs/tutorial/request-files.md        |   6 +-
 .../docs/tutorial/request-forms-and-files.md  |   6 +-
 docs/en/docs/tutorial/request-forms.md        |   6 +-
 docs/en/docs/tutorial/response-model.md       |  13 +-
 docs/en/docs/tutorial/security/first-steps.md |   8 +-
 docs/en/docs/tutorial/security/oauth2-jwt.md  |   6 +-
 docs/en/docs/tutorial/sql-databases.md        |   4 +-
 docs/en/docs/tutorial/testing.md              |  10 +-
 docs/en/docs/virtual-environments.md          | 844 ++++++++++++++++++
 docs/en/mkdocs.yml                            |   2 +
 20 files changed, 1228 insertions(+), 263 deletions(-)
 create mode 100644 docs/en/docs/environment-variables.md
 create mode 100644 docs/en/docs/virtual-environments.md

diff --git a/README.md b/README.md
index b00ef6ba9..889a89ed7 100644
--- a/README.md
+++ b/README.md
@@ -132,6 +132,8 @@ FastAPI stands on the shoulders of giants:
 
 ## Installation
 
+Create and activate a <a href="https://fastapi.tiangolo.com/virtual-environments/" class="external-link" target="_blank">virtual environment</a> and then install FastAPI:
+
 <div class="termy">
 
 ```console
diff --git a/docs/en/docs/advanced/settings.md b/docs/en/docs/advanced/settings.md
index b78f83953..22bf7de20 100644
--- a/docs/en/docs/advanced/settings.md
+++ b/docs/en/docs/advanced/settings.md
@@ -6,135 +6,17 @@ Most of these settings are variable (can change), like database URLs. And many c
 
 For this reason it's common to provide them in environment variables that are read by the application.
 
-## Environment Variables
-
-/// tip
-
-If you already know what "environment variables" are and how to use them, feel free to skip to the next section below.
-
-///
-
-An <a href="https://en.wikipedia.org/wiki/Environment_variable" class="external-link" target="_blank">environment variable</a> (also known as "env var") is a variable that lives outside of the Python code, in the operating system, and could be read by your Python code (or by other programs as well).
-
-You can create and use environment variables in the shell, without needing Python:
-
-//// tab | Linux, macOS, Windows Bash
-
-<div class="termy">
-
-```console
-// You could create an env var MY_NAME with
-$ export MY_NAME="Wade Wilson"
-
-// Then you could use it with other programs, like
-$ echo "Hello $MY_NAME"
-
-Hello Wade Wilson
-```
-
-</div>
-
-////
-
-//// tab | Windows PowerShell
-
-<div class="termy">
-
-```console
-// Create an env var MY_NAME
-$ $Env:MY_NAME = "Wade Wilson"
-
-// Use it with other programs, like
-$ echo "Hello $Env:MY_NAME"
-
-Hello Wade Wilson
-```
-
-</div>
-
-////
-
-### Read env vars in Python
-
-You could also create environment variables outside of Python, in the terminal (or with any other method), and then read them in Python.
-
-For example you could have a file `main.py` with:
-
-```Python hl_lines="3"
-import os
-
-name = os.getenv("MY_NAME", "World")
-print(f"Hello {name} from Python")
-```
-
-/// tip
-
-The second argument to <a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> is the default value to return.
-
-If not provided, it's `None` by default, here we provide `"World"` as the default value to use.
-
-///
-
-Then you could call that Python program:
-
-<div class="termy">
-
-```console
-// Here we don't set the env var yet
-$ python main.py
-
-// As we didn't set the env var, we get the default value
-
-Hello World from Python
-
-// But if we create an environment variable first
-$ export MY_NAME="Wade Wilson"
-
-// And then call the program again
-$ python main.py
-
-// Now it can read the environment variable
-
-Hello Wade Wilson from Python
-```
-
-</div>
-
-As environment variables can be set outside of the code, but can be read by the code, and don't have to be stored (committed to `git`) with the rest of the files, it's common to use them for configurations or settings.
-
-You can also create an environment variable only for a specific program invocation, that is only available to that program, and only for its duration.
-
-To do that, create it right before the program itself, on the same line:
-
-<div class="termy">
-
-```console
-// Create an env var MY_NAME in line for this program call
-$ MY_NAME="Wade Wilson" python main.py
-
-// Now it can read the environment variable
-
-Hello Wade Wilson from Python
-
-// The env var no longer exists afterwards
-$ python main.py
-
-Hello World from Python
-```
-
-</div>
-
 /// tip
 
-You can read more about it at <a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a>.
+To understand environment variables you can read [Environment Variables](../environment-variables.md){.internal-link target=_blank}.
 
 ///
 
-### Types and validation
+## Types and validation
 
 These environment variables can only handle text strings, as they are external to Python and have to be compatible with other programs and the rest of the system (and even with different operating systems, as Linux, Windows, macOS).
 
-That means that any value read in Python from an environment variable will be a `str`, and any conversion to a different type or validation has to be done in code.
+That means that any value read in Python from an environment variable will be a `str`, and any conversion to a different type or any validation has to be done in code.
 
 ## Pydantic `Settings`
 
@@ -142,7 +24,7 @@ Fortunately, Pydantic provides a great utility to handle these settings coming f
 
 ### Install `pydantic-settings`
 
-First, install the `pydantic-settings` package:
+First, make sure you create your [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install the `pydantic-settings` package:
 
 <div class="termy">
 
diff --git a/docs/en/docs/advanced/templates.md b/docs/en/docs/advanced/templates.md
index 43731ec36..416540ba4 100644
--- a/docs/en/docs/advanced/templates.md
+++ b/docs/en/docs/advanced/templates.md
@@ -8,7 +8,7 @@ There are utilities to configure it easily that you can use directly in your **F
 
 ## Install dependencies
 
-Install `jinja2`:
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and install `jinja2`:
 
 <div class="termy">
 
diff --git a/docs/en/docs/advanced/websockets.md b/docs/en/docs/advanced/websockets.md
index 9655714b0..44c6c7428 100644
--- a/docs/en/docs/advanced/websockets.md
+++ b/docs/en/docs/advanced/websockets.md
@@ -4,7 +4,7 @@ You can use <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebSockets
 
 ## Install `WebSockets`
 
-First you need to install `WebSockets`:
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and install `websockets`:
 
 <div class="termy">
 
diff --git a/docs/en/docs/contributing.md b/docs/en/docs/contributing.md
index 63e1f359a..91d5724a8 100644
--- a/docs/en/docs/contributing.md
+++ b/docs/en/docs/contributing.md
@@ -6,117 +6,13 @@ First, you might want to see the basic ways to [help FastAPI and get help](help-
 
 If you already cloned the <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">fastapi repository</a> and you want to deep dive in the code, here are some guidelines to set up your environment.
 
-### Virtual environment with `venv`
+### Virtual environment
 
-You can create an isolated virtual local environment in a directory using Python's `venv` module. Let's do this in the cloned repository (where the `requirements.txt` is):
-
-<div class="termy">
-
-```console
-$ python -m venv env
-```
-
-</div>
-
-That will create a directory `./env/` with the Python binaries, and then you will be able to install packages for that local environment.
-
-### Activate the environment
-
-Activate the new environment with:
-
-//// tab | Linux, macOS
-
-<div class="termy">
-
-```console
-$ source ./env/bin/activate
-```
-
-</div>
-
-////
-
-//// tab | Windows PowerShell
-
-<div class="termy">
-
-```console
-$ .\env\Scripts\Activate.ps1
-```
-
-</div>
-
-////
-
-//// tab | Windows Bash
-
-Or if you use Bash for Windows (e.g. <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>):
-
-<div class="termy">
-
-```console
-$ source ./env/Scripts/activate
-```
-
-</div>
-
-////
-
-To check it worked, use:
-
-//// tab | Linux, macOS, Windows Bash
-
-<div class="termy">
-
-```console
-$ which pip
-
-some/directory/fastapi/env/bin/pip
-```
-
-</div>
-
-////
-
-//// tab | Windows PowerShell
-
-<div class="termy">
-
-```console
-$ Get-Command pip
-
-some/directory/fastapi/env/bin/pip
-```
-
-</div>
-
-////
-
-If it shows the `pip` binary at `env/bin/pip` then it worked. 🎉
-
-Make sure you have the latest pip version on your local environment to avoid errors on the next steps:
-
-<div class="termy">
-
-```console
-$ python -m pip install --upgrade pip
-
----> 100%
-```
-
-</div>
-
-/// tip
-
-Every time you install a new package with `pip` under that environment, activate the environment again.
-
-This makes sure that if you use a terminal program installed by that package, you use the one from your local environment and not any other that could be installed globally.
-
-///
+Follow the instructions to create and activate a [virtual environment](virtual-environments.md){.internal-link target=_blank} for the internal code of `fastapi`.
 
 ### Install requirements using pip
 
-After activating the environment as described above:
+After activating the environment, install the required packages:
 
 <div class="termy">
 
@@ -160,7 +56,19 @@ $ bash scripts/format.sh
 
 It will also auto-sort all your imports.
 
-For it to sort them correctly, you need to have FastAPI installed locally in your environment, with the command in the section above using `-e`.
+## Tests
+
+There is a script that you can run locally to test all the code and generate coverage reports in HTML:
+
+<div class="termy">
+
+```console
+$ bash scripts/test-cov-html.sh
+```
+
+</div>
+
+This command generates a directory `./htmlcov/`, if you open the file `./htmlcov/index.html` in your browser, you can explore interactively the regions of code that are covered by the tests, and notice if there is any region missing.
 
 ## Docs
 
@@ -482,17 +390,3 @@ Serving at: http://127.0.0.1:8008
     * Search for such links in the translated document using the regex `#[^# ]`.
     * Search in all documents already translated into your language for `your-translated-document.md`. For example VS Code has an option "Edit" -> "Find in Files".
     * When translating a document, do not "pre-translate" `#hash-parts` that link to headings in untranslated documents.
-
-## Tests
-
-There is a script that you can run locally to test all the code and generate coverage reports in HTML:
-
-<div class="termy">
-
-```console
-$ bash scripts/test-cov-html.sh
-```
-
-</div>
-
-This command generates a directory `./htmlcov/`, if you open the file `./htmlcov/index.html` in your browser, you can explore interactively the regions of code that are covered by the tests, and notice if there is any region missing.
diff --git a/docs/en/docs/deployment/manually.md b/docs/en/docs/deployment/manually.md
index d70c5e48b..3324a7503 100644
--- a/docs/en/docs/deployment/manually.md
+++ b/docs/en/docs/deployment/manually.md
@@ -82,7 +82,9 @@ When referring to the remote machine, it's common to call it **server**, but als
 
 When you install FastAPI, it comes with a production server, Uvicorn, and you can start it with the `fastapi run` command.
 
-But you can also install an ASGI server manually:
+But you can also install an ASGI server manually.
+
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then you can install the server:
 
 //// tab | Uvicorn
 
diff --git a/docs/en/docs/deployment/server-workers.md b/docs/en/docs/deployment/server-workers.md
index 433371b9d..efde5f3a1 100644
--- a/docs/en/docs/deployment/server-workers.md
+++ b/docs/en/docs/deployment/server-workers.md
@@ -39,6 +39,8 @@ And then the Gunicorn-compatible **Uvicorn worker** class would be in charge of
 
 ## Install Gunicorn and Uvicorn
 
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install `gunicorn`:
+
 <div class="termy">
 
 ```console
diff --git a/docs/en/docs/environment-variables.md b/docs/en/docs/environment-variables.md
new file mode 100644
index 000000000..78e82d5af
--- /dev/null
+++ b/docs/en/docs/environment-variables.md
@@ -0,0 +1,300 @@
+# Environment Variables
+
+/// tip
+
+If you already know what "environment variables" are and how to use them, feel free to skip this.
+
+///
+
+An environment variable (also known as "**env var**") is a variable that lives **outside** of the Python code, in the **operating system**, and could be read by your Python code (or by other programs as well).
+
+Environment variables could be useful for handling application **settings**, as part of the **installation** of Python, etc.
+
+## Create and Use Env Vars
+
+You can **create** and use environment variables in the **shell (terminal)**, without needing Python:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// You could create an env var MY_NAME with
+$ export MY_NAME="Wade Wilson"
+
+// Then you could use it with other programs, like
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Create an env var MY_NAME
+$ $Env:MY_NAME = "Wade Wilson"
+
+// Use it with other programs, like
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+## Read env vars in Python
+
+You could also create environment variables **outside** of Python, in the terminal (or with any other method), and then **read them in Python**.
+
+For example you could have a file `main.py` with:
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip
+
+The second argument to <a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> is the default value to return.
+
+If not provided, it's `None` by default, here we provide `"World"` as the default value to use.
+
+///
+
+Then you could call that Python program:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// Here we don't set the env var yet
+$ python main.py
+
+// As we didn't set the env var, we get the default value
+
+Hello World from Python
+
+// But if we create an environment variable first
+$ export MY_NAME="Wade Wilson"
+
+// And then call the program again
+$ python main.py
+
+// Now it can read the environment variable
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Here we don't set the env var yet
+$ python main.py
+
+// As we didn't set the env var, we get the default value
+
+Hello World from Python
+
+// But if we create an environment variable first
+$ $Env:MY_NAME = "Wade Wilson"
+
+// And then call the program again
+$ python main.py
+
+// Now it can read the environment variable
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+As environment variables can be set outside of the code, but can be read by the code, and don't have to be stored (committed to `git`) with the rest of the files, it's common to use them for configurations or **settings**.
+
+You can also create an environment variable only for a **specific program invocation**, that is only available to that program, and only for its duration.
+
+To do that, create it right before the program itself, on the same line:
+
+<div class="termy">
+
+```console
+// Create an env var MY_NAME in line for this program call
+$ MY_NAME="Wade Wilson" python main.py
+
+// Now it can read the environment variable
+
+Hello Wade Wilson from Python
+
+// The env var no longer exists afterwards
+$ python main.py
+
+Hello World from Python
+```
+
+</div>
+
+/// tip
+
+You can read more about it at <a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a>.
+
+///
+
+## Types and Validation
+
+These environment variables can only handle **text strings**, as they are external to Python and have to be compatible with other programs and the rest of the system (and even with different operating systems, as Linux, Windows, macOS).
+
+That means that **any value** read in Python from an environment variable **will be a `str`**, and any conversion to a different type or any validation has to be done in code.
+
+You will learn more about using environment variables for handling **application settings** in the [Advanced User Guide - Settings and Environment Variables](./advanced/settings.md){.internal-link target=_blank}.
+
+## `PATH` Environment Variable
+
+There is a **special** environment variable called **`PATH`** that is used by the operating systems (Linux, macOS, Windows) to find programs to run.
+
+The value of the variable `PATH` is a long string that is made of directories separated by a colon `:` on Linux and macOS, and by a semicolon `;` on Windows.
+
+For example, the `PATH` environment variable could look like this:
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+This means that the system should look for programs in the directories:
+
+* `/usr/local/bin`
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+This means that the system should look for programs in the directories:
+
+* `C:\Program Files\Python312\Scripts`
+* `C:\Program Files\Python312`
+* `C:\Windows\System32`
+
+////
+
+When you type a **command** in the terminal, the operating system **looks for** the program in **each of those directories** listed in the `PATH` environment variable.
+
+For example, when you type `python` in the terminal, the operating system looks for a program called `python` in the **first directory** in that list.
+
+If it finds it, then it will **use it**. Otherwise it keeps looking in the **other directories**.
+
+### Installing Python and Updating the `PATH`
+
+When you install Python, you might be asked if you want to update the `PATH` environment variable.
+
+//// tab | Linux, macOS
+
+Let's say you install Python and it ends up in a directory `/opt/custompython/bin`.
+
+If you say yes to update the `PATH` environment variable, then the installer will add `/opt/custompython/bin` to the `PATH` environment variable.
+
+It could look like this:
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+This way, when you type `python` in the terminal, the system will find the Python program in `/opt/custompython/bin` (the last directory) and use that one.
+
+////
+
+//// tab | Windows
+
+Let's say you install Python and it ends up in a directory `C:\opt\custompython\bin`.
+
+If you say yes to update the `PATH` environment variable, then the installer will add `C:\opt\custompython\bin` to the `PATH` environment variable.
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+This way, when you type `python` in the terminal, the system will find the Python program in `C:\opt\custompython\bin` (the last directory) and use that one.
+
+////
+
+This way, when you type `python` in the terminal, the system will find the Python program in `/opt/custompython/bin` (the last directory) and use that one.
+
+So, if you type:
+
+<div class="termy">
+
+```console
+$ python
+```
+
+</div>
+
+//// tab | Linux, macOS
+
+The system will **find** the `python` program in `/opt/custompython/bin` and run it.
+
+It would be roughly equivalent to typing:
+
+<div class="termy">
+
+```console
+$ /opt/custompython/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows
+
+The system will **find** the `python` program in `C:\opt\custompython\bin\python` and run it.
+
+It would be roughly equivalent to typing:
+
+<div class="termy">
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+</div>
+
+////
+
+This information will be useful when learning about [Virtual Environments](virtual-environments.md){.internal-link target=_blank}.
+
+## Conclusion
+
+With this you should have a basic understanding of what **environment variables** are and how to use them in Python.
+
+You can also read more about them in the <a href="https://en.wikipedia.org/wiki/Environment_variable" class="external-link" target="_blank">Wikipedia for Environment Variable</a>.
+
+In many cases it's not very obvious how environment variables would be useful and applicable right away. But they keep showing up in many different scenarios when you are developing, so it's good to know about them.
+
+For example, you will need this information in the next section, about [Virtual Environments](virtual-environments.md).
diff --git a/docs/en/docs/index.md b/docs/en/docs/index.md
index d76ef498b..ac4f4d00f 100644
--- a/docs/en/docs/index.md
+++ b/docs/en/docs/index.md
@@ -128,6 +128,8 @@ FastAPI stands on the shoulders of giants:
 
 ## Installation
 
+Create and activate a <a href="https://fastapi.tiangolo.com/virtual-environments/" class="external-link" target="_blank">virtual environment</a> and then install FastAPI:
+
 <div class="termy">
 
 ```console
diff --git a/docs/en/docs/tutorial/index.md b/docs/en/docs/tutorial/index.md
index 5f8c51c4c..386fe5de9 100644
--- a/docs/en/docs/tutorial/index.md
+++ b/docs/en/docs/tutorial/index.md
@@ -4,9 +4,7 @@ This tutorial shows you how to use **FastAPI** with most of its features, step b
 
 Each section gradually builds on the previous ones, but it's structured to separate topics, so that you can go directly to any specific one to solve your specific API needs.
 
-It is also built to work as a future reference.
-
-So you can come back and see exactly what you need.
+It is also built to work as a future reference so you can come back and see exactly what you need.
 
 ## Run the code
 
@@ -71,7 +69,9 @@ Using it in your editor is what really shows you the benefits of FastAPI, seeing
 
 ## Install FastAPI
 
-The first step is to install FastAPI:
+The first step is to install FastAPI.
+
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then **install FastAPI**:
 
 <div class="termy">
 
diff --git a/docs/en/docs/tutorial/request-files.md b/docs/en/docs/tutorial/request-files.md
index 53d9eefde..9f19596a8 100644
--- a/docs/en/docs/tutorial/request-files.md
+++ b/docs/en/docs/tutorial/request-files.md
@@ -6,7 +6,11 @@ You can define files to be uploaded by the client using `File`.
 
 To receive uploaded files, first install <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
 
-E.g. `pip install python-multipart`.
+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
+```
 
 This is because uploaded files are sent as "form data".
 
diff --git a/docs/en/docs/tutorial/request-forms-and-files.md b/docs/en/docs/tutorial/request-forms-and-files.md
index 9b4342652..7830a2ba4 100644
--- a/docs/en/docs/tutorial/request-forms-and-files.md
+++ b/docs/en/docs/tutorial/request-forms-and-files.md
@@ -6,7 +6,11 @@ You can define files and form fields at the same time using `File` and `Form`.
 
 To receive uploaded files and/or form data, first install <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
 
-E.g. `pip install python-multipart`.
+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
+```
 
 ///
 
diff --git a/docs/en/docs/tutorial/request-forms.md b/docs/en/docs/tutorial/request-forms.md
index 88b5b86b6..87cfdefbc 100644
--- a/docs/en/docs/tutorial/request-forms.md
+++ b/docs/en/docs/tutorial/request-forms.md
@@ -6,7 +6,11 @@ When you need to receive form fields instead of JSON, you can use `Form`.
 
 To use forms, first install <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
 
-E.g. `pip install python-multipart`.
+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
+```
 
 ///
 
diff --git a/docs/en/docs/tutorial/response-model.md b/docs/en/docs/tutorial/response-model.md
index c17e32f90..6a2093e6d 100644
--- a/docs/en/docs/tutorial/response-model.md
+++ b/docs/en/docs/tutorial/response-model.md
@@ -133,8 +133,17 @@ Here we are declaring a `UserIn` model, it will contain a plaintext password:
 
 To use `EmailStr`, first install <a href="https://github.com/JoshData/python-email-validator" class="external-link" target="_blank">`email-validator`</a>.
 
-E.g. `pip install email-validator`
-or `pip install pydantic[email]`.
+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 email-validator
+```
+
+or with:
+
+```console
+$ pip install "pydantic[email]"
+```
 
 ///
 
diff --git a/docs/en/docs/tutorial/security/first-steps.md b/docs/en/docs/tutorial/security/first-steps.md
index ed427a282..4bd026caf 100644
--- a/docs/en/docs/tutorial/security/first-steps.md
+++ b/docs/en/docs/tutorial/security/first-steps.md
@@ -56,9 +56,13 @@ Prefer to use the `Annotated` version if possible.
 
 The <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a> package is automatically installed with **FastAPI** when you run the `pip install "fastapi[standard]"` command.
 
-However, if you use the `pip install fastapi` command, the `python-multipart` package is not included by default. To install it manually, use the following command:
+However, if you use the `pip install fastapi` command, the `python-multipart` package is not included by default.
 
-`pip install python-multipart`
+To install it manually, make sure you create a [virtual environment](../../virtual-environments.md){.internal-link target=_blank}, activate it, and then install it with:
+
+```console
+$ pip install python-multipart
+```
 
 This is because **OAuth2** uses "form data" for sending the `username` and `password`.
 
diff --git a/docs/en/docs/tutorial/security/oauth2-jwt.md b/docs/en/docs/tutorial/security/oauth2-jwt.md
index 52877b916..ba2bfef29 100644
--- a/docs/en/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/en/docs/tutorial/security/oauth2-jwt.md
@@ -28,7 +28,9 @@ If you want to play with JWT tokens and see how they work, check <a href="https:
 
 ## Install `PyJWT`
 
-We need to install `PyJWT` to generate and verify the JWT tokens in Python:
+We need to install `PyJWT` to generate and verify the JWT tokens in Python.
+
+Make sure you create a [virtual environment](../../virtual-environments.md){.internal-link target=_blank}, activate it, and then install `pyjwt`:
 
 <div class="termy">
 
@@ -70,7 +72,7 @@ It supports many secure hashing algorithms and utilities to work with them.
 
 The recommended algorithm is "Bcrypt".
 
-So, install PassLib with Bcrypt:
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install PassLib with Bcrypt:
 
 <div class="termy">
 
diff --git a/docs/en/docs/tutorial/sql-databases.md b/docs/en/docs/tutorial/sql-databases.md
index 0645cc9f1..56971bf9d 100644
--- a/docs/en/docs/tutorial/sql-databases.md
+++ b/docs/en/docs/tutorial/sql-databases.md
@@ -101,7 +101,9 @@ Now let's see what each file/module does.
 
 ## Install `SQLAlchemy`
 
-First you need to install `SQLAlchemy`:
+First you need to install `SQLAlchemy`.
+
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install it, for example:
 
 <div class="termy">
 
diff --git a/docs/en/docs/tutorial/testing.md b/docs/en/docs/tutorial/testing.md
index 95c8c5bef..06a87e92e 100644
--- a/docs/en/docs/tutorial/testing.md
+++ b/docs/en/docs/tutorial/testing.md
@@ -12,7 +12,11 @@ With it, you can use <a href="https://docs.pytest.org/" class="external-link" ta
 
 To use `TestClient`, first install <a href="https://www.python-httpx.org" class="external-link" target="_blank">`httpx`</a>.
 
-E.g. `pip install httpx`.
+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 httpx
+```
 
 ///
 
@@ -206,7 +210,9 @@ If you have a Pydantic model in your test and you want to send its data to the a
 
 ## Run it
 
-After that, you just need to install `pytest`:
+After that, you just need to install `pytest`.
+
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install it, for example:
 
 <div class="termy">
 
diff --git a/docs/en/docs/virtual-environments.md b/docs/en/docs/virtual-environments.md
new file mode 100644
index 000000000..3c4aa49c1
--- /dev/null
+++ b/docs/en/docs/virtual-environments.md
@@ -0,0 +1,844 @@
+# Virtual Environments
+
+When you work in Python projects you probably should use a **virtual environment** (or a similar mechanism) to isolate the packages you install for each project.
+
+/// info
+
+If you already know about virtual environments, how to create them and use them, you might want to skip this section. 🤓
+
+///
+
+/// tip
+
+A **virtual environment** is different than an **environment variable**.
+
+An **environment variable** is a variable in the system that can be used by programs.
+
+A **virtual environment** is a directory with some files in it.
+
+///
+
+/// info
+
+This page will teach you how to use **virtual environments** and how they work.
+
+If you are ready to adopt a **tool that manages everything** for you (including installing Python), try <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">uv</a>.
+
+///
+
+## Create a Project
+
+First, create a directory for your project.
+
+What I normally do is that I create a directory named `code` inside my home/user directory.
+
+And inside of that I create one directory per project.
+
+<div class="termy">
+
+```console
+// Go to the home directory
+$ cd
+// Create a directory for all your code projects
+$ mkdir code
+// Enter into that code directory
+$ cd code
+// Create a directory for this project
+$ mkdir awesome-project
+// Enter into that project directory
+$ cd awesome-project
+```
+
+</div>
+
+## Create a Virtual Environment
+
+When you start working on a Python project **for the first time**, create a virtual environment **<abbr title="there are other options, this is a simple guideline">inside your project</abbr>**.
+
+/// tip
+
+You only need to do this **once per project**, not every time you work.
+
+///
+
+//// tab | `venv`
+
+To create a virtual environment, you can use the `venv` module that comes with Python.
+
+<div class="termy">
+
+```console
+$ python -m venv .venv
+```
+
+</div>
+
+/// details | What that command means
+
+* `python`: use the program called `python`
+* `-m`: call a module as a script, we'll tell it which module next
+* `venv`: use the module called `venv` that normally comes installed with Python
+* `.venv`: create the virtual environment in the new directory `.venv`
+
+///
+
+////
+
+//// tab | `uv`
+
+If you have <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a> installed, you can use it to create a virtual environment.
+
+<div class="termy">
+
+```console
+$ uv venv
+```
+
+</div>
+
+/// tip
+
+By default, `uv` will create a virtual environment in a directory called `.venv`.
+
+But you could customize it passing an additional argument with the directory name.
+
+///
+
+////
+
+That command creates a new virtual environment in a directory called `.venv`.
+
+/// details | `.venv` or other name
+
+You could create the virtual environment in a different directory, but there's a convention of calling it `.venv`.
+
+///
+
+## Activate the Virtual Environment
+
+Activate the new virtual environment so that any Python command you run or package you install uses it.
+
+/// tip
+
+Do this **every time** you start a **new terminal session** to work on the project.
+
+///
+
+//// tab | Linux, macOS
+
+<div class="termy">
+
+```console
+$ source .venv/bin/activate
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+</div>
+
+////
+
+//// tab | Windows Bash
+
+Or if you use Bash for Windows (e.g. <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>):
+
+<div class="termy">
+
+```console
+$ source .venv/Scripts/activate
+```
+
+</div>
+
+////
+
+/// tip
+
+Every time you install a **new package** in that environment, **activate** the environment again.
+
+This makes sure that if you use a **terminal (<abbr title="command line interface">CLI</abbr>) program** installed by that package, you use the one from your virtual environment and not any other that could be installed globally, probably with a different version than what you need.
+
+///
+
+## Check the Virtual Environment is Active
+
+Check that the virtual environment is active (the previous command worked).
+
+/// tip
+
+This is **optional**, but it's a good way to **check** that everything is working as expected and you are using the virtual environment you intended.
+
+///
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+</div>
+
+If it shows the `python` binary at `.venv/bin/python`, inside of your project (in this case `awesome-project`), then it worked. 🎉
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+</div>
+
+If it shows the `python` binary at `.venv\Scripts\python`, inside of your project (in this case `awesome-project`), then it worked. 🎉
+
+////
+
+## Upgrade `pip`
+
+/// tip
+
+If you use <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a> you would use it to install things instead of `pip`, so you don't need to upgrade `pip`. 😎
+
+///
+
+If you are using `pip` to install packages (it comes by default with Python), you should **upgrade** it to the latest version.
+
+Many exotic errors while installing a package are solved by just upgrading `pip` first.
+
+/// tip
+
+You would normally do this **once**, right after you create the virtual environment.
+
+///
+
+Make sure the virtual environment is active (with the command above) and then run:
+
+<div class="termy">
+
+```console
+$ python -m pip install --upgrade pip
+
+---> 100%
+```
+
+</div>
+
+## Add `.gitignore`
+
+If you are using **Git** (you should), add a `.gitignore` file to exclude everything in your `.venv` from Git.
+
+/// tip
+
+If you used <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a> to create the virtual environment, it already did this for you, you can skip this step. 😎
+
+///
+
+/// tip
+
+Do this **once**, right after you create the virtual environment.
+
+///
+
+<div class="termy">
+
+```console
+$ echo "*" > .venv/.gitignore
+```
+
+</div>
+
+/// details | What that command means
+
+* `echo "*"`: will "print" the text `*` in the terminal (the next part changes that a bit)
+* `>`: anything printed to the terminal by the command to the left of `>` should not be printed but instead written to the file that goes to the right of `>`
+* `.gitignore`: the name of the file where the text should be written
+
+And `*` for Git means "everything". So, it will ignore everything in the `.venv` directory.
+
+That command will create a file `.gitignore` with the content:
+
+```gitignore
+*
+```
+
+///
+
+## Install Packages
+
+After activating the environment, you can install packages in it.
+
+/// tip
+
+Do this **once** when installing or upgrading the packages your project needs.
+
+If you need to upgrade a version or add a new package you would **do this again**.
+
+///
+
+### Install Packages Directly
+
+If you're in a hurry and don't want to use a file to declare your project's package requirements, you can install them directly.
+
+/// tip
+
+It's a (very) good idea to put the packages and versions your program needs in a file (for example `requirements.txt` or `pyproject.toml`).
+
+///
+
+//// tab | `pip`
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[standard]"
+
+---> 100%
+```
+
+</div>
+
+////
+
+//// tab | `uv`
+
+If you have <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>:
+
+<div class="termy">
+
+```console
+$ uv pip install "fastapi[standard]"
+---> 100%
+```
+
+</div>
+
+////
+
+### Install from `requirements.txt`
+
+If you have a `requirements.txt`, you can now use it to install its packages.
+
+//// tab | `pip`
+
+<div class="termy">
+
+```console
+$ pip install -r requirements.txt
+---> 100%
+```
+
+</div>
+
+////
+
+//// tab | `uv`
+
+If you have <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>:
+
+<div class="termy">
+
+```console
+$ uv pip install -r requirements.txt
+---> 100%
+```
+
+</div>
+
+////
+
+/// details | `requirements.txt`
+
+A `requirements.txt` with some packages could look like:
+
+```requirements.txt
+fastapi[standard]==0.113.0
+pydantic==2.8.0
+```
+
+///
+
+## Run Your Program
+
+After you activated the virtual environment, you can run your program, and it will use the Python inside of your virtual environment with the packages you installed there.
+
+<div class="termy">
+
+```console
+$ python main.py
+
+Hello World
+```
+
+</div>
+
+## Configure Your Editor
+
+You would probably use an editor, make sure you configure it to use the same virtual environment you created (it will probably autodetect it) so that you can get autocompletion and inline errors.
+
+For example:
+
+* <a href="https://code.visualstudio.com/docs/python/environments#_select-and-activate-an-environment" class="external-link" target="_blank">VS Code</a>
+* <a href="https://www.jetbrains.com/help/pycharm/creating-virtual-environment.html" class="external-link" target="_blank">PyCharm</a>
+
+/// tip
+
+You normally have to do this only **once**, when you create the virtual environment.
+
+///
+
+## Deactivate the Virtual Environment
+
+Once you are done working on your project you can **deactivate** the virtual environment.
+
+<div class="termy">
+
+```console
+$ deactivate
+```
+
+</div>
+
+This way, when you run `python` it won't try to run it from that virtual environment with the packages installed there.
+
+## Ready to Work
+
+Now you're ready to start working on your project.
+
+
+
+/// tip
+
+Do you want to understand what's all that above?
+
+Continue reading. 👇🤓
+
+///
+
+## Why Virtual Environments
+
+To work with FastAPI you need to install <a href="https://www.python.org/" class="external-link" target="_blank">Python</a>.
+
+After that, you would need to **install** FastAPI and any other **packages** you want to use.
+
+To install packages you would normally use the `pip` command that comes with Python (or similar alternatives).
+
+Nevertheless, if you just use `pip` directly, the packages would be installed in your **global Python environment** (the global installation of Python).
+
+### The Problem
+
+So, what's the problem with installing packages in the global Python environment?
+
+At some point, you will probably end up writing many different programs that depend on **different packages**. And some of these projects you work on will depend on **different versions** of the same package. 😱
+
+For example, you could create a project called `philosophers-stone`, this program depends on another package called **`harry`, using the version `1`**. So, you need to install `harry`.
+
+```mermaid
+flowchart LR
+    stone(philosophers-stone) -->|requires| harry-1[harry v1]
+```
+
+Then, at some point later, you create another project called `prisoner-of-azkaban`, and this project also depends on `harry`, but this project needs **`harry` version `3`**.
+
+```mermaid
+flowchart LR
+    azkaban(prisoner-of-azkaban) --> |requires| harry-3[harry v3]
+```
+
+But now the problem is, if you install the packages globally (in the global environment) instead of in a local **virtual environment**, you will have to choose which version of `harry` to install.
+
+If you want to run `philosophers-stone` you will need to first install `harry` version `1`, for example with:
+
+<div class="termy">
+
+```console
+$ pip install "harry==1"
+```
+
+</div>
+
+And then you would end up with `harry` version `1` installed in your global Python environment.
+
+```mermaid
+flowchart LR
+    subgraph global[global env]
+        harry-1[harry v1]
+    end
+    subgraph stone-project[philosophers-stone project]
+        stone(philosophers-stone) -->|requires| harry-1
+    end
+```
+
+But then if you want to run `prisoner-of-azkaban`, you will need to uninstall `harry` version `1` and install `harry` version `3` (or just installing version `3` would automatically uninstall version `1`).
+
+<div class="termy">
+
+```console
+$ pip install "harry==3"
+```
+
+</div>
+
+And then you would end up with `harry` version `3` installed in your global Python environment.
+
+And if you try to run `philosophers-stone` again, there's a chance it would **not work** because it needs `harry` version `1`.
+
+```mermaid
+flowchart LR
+    subgraph global[global env]
+        harry-1[<strike>harry v1</strike>]
+        style harry-1 fill:#ccc,stroke-dasharray: 5 5
+        harry-3[harry v3]
+    end
+    subgraph stone-project[philosophers-stone project]
+        stone(philosophers-stone) -.-x|⛔️| harry-1
+    end
+    subgraph azkaban-project[prisoner-of-azkaban project]
+        azkaban(prisoner-of-azkaban) --> |requires| harry-3
+    end
+```
+
+/// tip
+
+It's very common in Python packages to try the best to **avoid breaking changes** in **new versions**, but it's better to be safe, and install newer versions intentionally and when you can run the tests to check everything is working correctly.
+
+///
+
+Now, imagine that with **many** other **packages** that all your **projects depend on**. That's very difficult to manage. And you would probably end up running some projects with some **incompatible versions** of the packages, and not knowing why something isn't working.
+
+Also, depending on your operating system (e.g. Linux, Windows, macOS), it could have come with Python already installed. And in that case it probably had some packages pre-installed with some specific versions **needed by your system**. If you install packages in the global Python environment, you could end up **breaking** some of the programs that came with your operating system.
+
+## Where are Packages Installed
+
+When you install Python, it creates some directories with some files in your computer.
+
+Some of these directories are the ones in charge of having all the packages you install.
+
+When you run:
+
+<div class="termy">
+
+```console
+// Don't run this now, it's just an example 🤓
+$ pip install "fastapi[standard]"
+---> 100%
+```
+
+</div>
+
+That will download a compressed file with the FastAPI code, normally from <a href="https://pypi.org/project/fastapi/" class="external-link" target="_blank">PyPI</a>.
+
+It will also **download** files for other packages that FastAPI depends on.
+
+Then it will **extract** all those files and put them in a directory in your computer.
+
+By default, it will put those files downloaded and extracted in the directory that comes with your Python installation, that's the **global environment**.
+
+## What are Virtual Environments
+
+The solution to the problems of having all the packages in the global environment is to use a **virtual environment for each project** you work on.
+
+A virtual environment is a **directory**, very similar to the global one, where you can install the packages for a project.
+
+This way, each project will have it's own virtual environment (`.venv` directory) with its own packages.
+
+```mermaid
+flowchart TB
+    subgraph stone-project[philosophers-stone project]
+        stone(philosophers-stone) --->|requires| harry-1
+        subgraph venv1[.venv]
+            harry-1[harry v1]
+        end
+    end
+    subgraph azkaban-project[prisoner-of-azkaban project]
+        azkaban(prisoner-of-azkaban) --->|requires| harry-3
+        subgraph venv2[.venv]
+            harry-3[harry v3]
+        end
+    end
+    stone-project ~~~ azkaban-project
+```
+
+## What Does Activating a Virtual Environment Mean
+
+When you activate a virtual environment, for example with:
+
+//// tab | Linux, macOS
+
+<div class="termy">
+
+```console
+$ source .venv/bin/activate
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+</div>
+
+////
+
+//// tab | Windows Bash
+
+Or if you use Bash for Windows (e.g. <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>):
+
+<div class="termy">
+
+```console
+$ source .venv/Scripts/activate
+```
+
+</div>
+
+////
+
+That command will create or modify some [environment variables](environment-variables.md){.internal-link target=_blank} that will be available for the next commands.
+
+One of those variables is the `PATH` variable.
+
+/// tip
+
+You can learn more about the `PATH` environment variable in the [Environment Variables](environment-variables.md#path-environment-variable){.internal-link target=_blank} section.
+
+///
+
+Activating a virtual environment adds its path `.venv/bin` (on Linux and macOS) or `.venv\Scripts` (on Windows) to the `PATH` environment variable.
+
+Let's say that before activating the environment, the `PATH` variable looked like this:
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+That means that the system would look for programs in:
+
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Windows\System32
+```
+
+That means that the system would look for programs in:
+
+* `C:\Windows\System32`
+
+////
+
+After activating the virtual environment, the `PATH` variable would look something like this:
+
+//// tab | Linux, macOS
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+That means that the system will now start looking first look for programs in:
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin
+```
+
+before looking in the other directories.
+
+So, when you type `python` in the terminal, the system will find the Python program in
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+and use that one.
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts;C:\Windows\System32
+```
+
+That means that the system will now start looking first look for programs in:
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts
+```
+
+before looking in the other directories.
+
+So, when you type `python` in the terminal, the system will find the Python program in
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+and use that one.
+
+////
+
+An important detail is that it will put the virtual environment path at the **beginning** of the `PATH` variable. The system will find it **before** finding any other Python available. This way, when you run `python`, it will use the Python **from the virtual environment** instead of any other `python` (for example, a `python` from a global environment).
+
+Activating a virtual environment also changes a couple of other things, but this is one of the most important things it does.
+
+## Checking a Virtual Environment
+
+When you check if a virtual environment is active, for example with:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+</div>
+
+////
+
+That means that the `python` program that will be used is the one **in the virtual environment**.
+
+you use `which` in Linux and macOS and `Get-Command` in Windows PowerShell.
+
+The way that command works is that it will go and check in the `PATH` environment variable, going through **each path in order**, looking for the program called `python`. Once it finds it, it will **show you the path** to that program.
+
+The most important part is that when you call `python`, that is the exact "`python`" that will be executed.
+
+So, you can confirm if you are in the correct virtual environment.
+
+/// tip
+
+It's easy to activate one virtual environment, get one Python, and then **go to another project**.
+
+And the second project **wouldn't work** because you are using the **incorrect Python**, from a virtual environment for another project.
+
+It's useful being able to check what `python` is being used. 🤓
+
+///
+
+## Why Deactivate a Virtual Environment
+
+For example, you could be working on a project `philosophers-stone`, **activate that virtual environment**, install packages and work with that environment.
+
+And then you want to work on **another project** `prisoner-of-azkaban`.
+
+You go to that project:
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+```
+
+</div>
+
+If you don't deactivate the virtual environment for `philosophers-stone`, when you run `python` in the terminal, it will try to use the Python from `philosophers-stone`.
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+
+$ python main.py
+
+// Error importing sirius, it's not installed 😱
+Traceback (most recent call last):
+    File "main.py", line 1, in <module>
+        import sirius
+```
+
+</div>
+
+But if you deactivate the virtual environment and activate the new one for `prisoner-of-askaban` then when you run `python` it will use the Python from the virtual environment in `prisoner-of-azkaban`.
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+
+// You don't need to be in the old directory to deactivate, you can do it wherever you are, even after going to the other project 😎
+$ deactivate
+
+// Activate the virtual environment in prisoner-of-azkaban/.venv 🚀
+$ source .venv/bin/activate
+
+// Now when you run python, it will find the package sirius installed in this virtual environment ✨
+$ python main.py
+
+I solemnly swear 🐺
+```
+
+</div>
+
+## Alternatives
+
+This is a simple guide to get you started and teach you how everything works **underneath**.
+
+There are many **alternatives** to managing virtual environments, package dependencies (requirements), projects.
+
+Once you are ready and want to use a tool to **manage the entire project**, packages dependencies, virtual environments, etc. I would suggest you try <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">uv</a>.
+
+`uv` can do a lot of things, it can:
+
+* **Install Python** for you, including different versions
+* Manage the **virtual environment** for your projects
+* Install **packages**
+* Manage package **dependencies and versions** for your project
+* Make sure you have an **exact** set of packages and versions to install, including their dependencies, so that you can be sure that you can run your project in production exactly the same as in your computer while developing, this is called **locking**
+* And many other things
+
+## Conclusion
+
+If you read and understood all this, now **you know much more** about virtual environments than many developers out there. 🤓
+
+Knowing these details will most probably be useful in a future time when you are debugging something that seems complex, but you will know **how it all works underneath**. 😎
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index d0527ca3c..6f1e12511 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -108,6 +108,8 @@ nav:
   - learn/index.md
   - python-types.md
   - async.md
+  - environment-variables.md
+  - virtual-environments.md
   - Tutorial - User Guide:
     - tutorial/index.md
     - tutorial/first-steps.md

From d0ce9d2bdf7f3c78b6f193288b9925b952da27c9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 22 Aug 2024 00:47:57 +0000
Subject: [PATCH 007/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 12f1f50cd..a8bbcc3b7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Docs
 
+* 📝 Add docs about Environment Variables and Virtual Environments. PR [#12054](https://github.com/fastapi/fastapi/pull/12054) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Add Asyncer mention in async docs. PR [#12037](https://github.com/fastapi/fastapi/pull/12037) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Move the Features docs to the top level to improve the main page menu. PR [#12036](https://github.com/fastapi/fastapi/pull/12036) by [@tiangolo](https://github.com/tiangolo).
 * ✏️ Fix import typo in reference example for `Security`. PR [#11168](https://github.com/fastapi/fastapi/pull/11168) by [@0shah0](https://github.com/0shah0).

From 8f037167571ca60f87677594418fc68a05db6a9f Mon Sep 17 00:00:00 2001
From: Aymen <aymenkrifa@gmail.com>
Date: Sat, 24 Aug 2024 04:16:23 +0100
Subject: [PATCH 008/146] =?UTF-8?q?=F0=9F=93=9D=20Fix=20a=20typo=20in=20vi?=
 =?UTF-8?q?rtual=20environement=20page=20(#12064)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/virtual-environments.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/virtual-environments.md b/docs/en/docs/virtual-environments.md
index 3c4aa49c1..fcc72fbe7 100644
--- a/docs/en/docs/virtual-environments.md
+++ b/docs/en/docs/virtual-environments.md
@@ -558,7 +558,7 @@ The solution to the problems of having all the packages in the global environmen
 
 A virtual environment is a **directory**, very similar to the global one, where you can install the packages for a project.
 
-This way, each project will have it's own virtual environment (`.venv` directory) with its own packages.
+This way, each project will have its own virtual environment (`.venv` directory) with its own packages.
 
 ```mermaid
 flowchart TB

From 6935fe8d38fe4befd0cc1cd8ddbbd836bb809497 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 24 Aug 2024 03:16:48 +0000
Subject: [PATCH 009/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a8bbcc3b7..8059de05d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Docs
 
+* 📝 Fix a typo in virtual environement page. PR [#12064](https://github.com/fastapi/fastapi/pull/12064) by [@aymenkrifa](https://github.com/aymenkrifa).
 * 📝 Add docs about Environment Variables and Virtual Environments. PR [#12054](https://github.com/fastapi/fastapi/pull/12054) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Add Asyncer mention in async docs. PR [#12037](https://github.com/fastapi/fastapi/pull/12037) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Move the Features docs to the top level to improve the main page menu. PR [#12036](https://github.com/fastapi/fastapi/pull/12036) by [@tiangolo](https://github.com/tiangolo).

From 22bf988dfb085f45449bc137401af0105a86cdf5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 23 Aug 2024 22:48:20 -0500
Subject: [PATCH 010/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8059de05d..c872f59e9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,7 +14,7 @@ hide:
 
 ### Docs
 
-* 📝 Fix a typo in virtual environement page. PR [#12064](https://github.com/fastapi/fastapi/pull/12064) by [@aymenkrifa](https://github.com/aymenkrifa).
+* 📝 Fix a typo in `docs/en/docs/virtual-environments.md`. PR [#12064](https://github.com/fastapi/fastapi/pull/12064) by [@aymenkrifa](https://github.com/aymenkrifa).
 * 📝 Add docs about Environment Variables and Virtual Environments. PR [#12054](https://github.com/fastapi/fastapi/pull/12054) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Add Asyncer mention in async docs. PR [#12037](https://github.com/fastapi/fastapi/pull/12037) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Move the Features docs to the top level to improve the main page menu. PR [#12036](https://github.com/fastapi/fastapi/pull/12036) by [@tiangolo](https://github.com/tiangolo).
@@ -36,7 +36,7 @@ hide:
 * 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request_file.md`. PR [#12018](https://github.com/fastapi/fastapi/pull/12018) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
 * 🌐 Add Japanese translation for `docs/ja/docs/learn/index.md`. PR [#11592](https://github.com/fastapi/fastapi/pull/11592) by [@ukwhatn](https://github.com/ukwhatn).
 * 📝 Update Spanish translation docs for consistency. PR [#12044](https://github.com/fastapi/fastapi/pull/12044) by [@alejsdev](https://github.com/alejsdev).
-* 🌐 Update docs about dependencies with yield. PR [#12028](https://github.com/fastapi/fastapi/pull/12028) by [@xuvjso](https://github.com/xuvjso).
+* 🌐 Update Chinese translation for `docs/zh/docs/tutorial/dependencies/dependencies-with-yield.md`. PR [#12028](https://github.com/fastapi/fastapi/pull/12028) by [@xuvjso](https://github.com/xuvjso).
 * 📝 Update FastAPI People, do not translate to have the most recent info. PR [#12034](https://github.com/fastapi/fastapi/pull/12034) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Update Urdu translation for `docs/ur/docs/benchmarks.md`. PR [#10046](https://github.com/fastapi/fastapi/pull/10046) by [@AhsanSheraz](https://github.com/AhsanSheraz).
 

From 3a4ac2467594d0ccad92ecfb7f7f10ffa5d1d992 Mon Sep 17 00:00:00 2001
From: Pastukhov Nikita <diementros@yandex.ru>
Date: Sat, 24 Aug 2024 22:09:52 +0300
Subject: [PATCH 011/146] =?UTF-8?q?=F0=9F=90=9B=20Ensure=20that=20`app.inc?=
 =?UTF-8?q?lude=5Frouter`=20merges=20nested=20lifespans=20(#9630)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 fastapi/routing.py          |  27 +++++++-
 tests/test_router_events.py | 135 +++++++++++++++++++++++++++++++++++-
 2 files changed, 158 insertions(+), 4 deletions(-)

diff --git a/fastapi/routing.py b/fastapi/routing.py
index 2e7959f3d..49f1b6013 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -3,14 +3,16 @@ import dataclasses
 import email.message
 import inspect
 import json
-from contextlib import AsyncExitStack
+from contextlib import AsyncExitStack, asynccontextmanager
 from enum import Enum, IntEnum
 from typing import (
     Any,
+    AsyncIterator,
     Callable,
     Coroutine,
     Dict,
     List,
+    Mapping,
     Optional,
     Sequence,
     Set,
@@ -67,7 +69,7 @@ from starlette.routing import (
     websocket_session,
 )
 from starlette.routing import Mount as Mount  # noqa
-from starlette.types import ASGIApp, Lifespan, Scope
+from starlette.types import AppType, ASGIApp, Lifespan, Scope
 from starlette.websockets import WebSocket
 from typing_extensions import Annotated, Doc, deprecated
 
@@ -119,6 +121,23 @@ def _prepare_response_content(
     return res
 
 
+def _merge_lifespan_context(
+    original_context: Lifespan[Any], nested_context: Lifespan[Any]
+) -> Lifespan[Any]:
+    @asynccontextmanager
+    async def merged_lifespan(
+        app: AppType,
+    ) -> AsyncIterator[Optional[Mapping[str, Any]]]:
+        async with original_context(app) as maybe_original_state:
+            async with nested_context(app) as maybe_nested_state:
+                if maybe_nested_state is None and maybe_original_state is None:
+                    yield None  # old ASGI compatibility
+                else:
+                    yield {**(maybe_nested_state or {}), **(maybe_original_state or {})}
+
+    return merged_lifespan  # type: ignore[return-value]
+
+
 async def serialize_response(
     *,
     field: Optional[ModelField] = None,
@@ -1308,6 +1327,10 @@ class APIRouter(routing.Router):
             self.add_event_handler("startup", handler)
         for handler in router.on_shutdown:
             self.add_event_handler("shutdown", handler)
+        self.lifespan_context = _merge_lifespan_context(
+            self.lifespan_context,
+            router.lifespan_context,
+        )
 
     def get(
         self,
diff --git a/tests/test_router_events.py b/tests/test_router_events.py
index 1b9de18ae..dd7ff3314 100644
--- a/tests/test_router_events.py
+++ b/tests/test_router_events.py
@@ -1,8 +1,8 @@
 from contextlib import asynccontextmanager
-from typing import AsyncGenerator, Dict
+from typing import AsyncGenerator, Dict, Union
 
 import pytest
-from fastapi import APIRouter, FastAPI
+from fastapi import APIRouter, FastAPI, Request
 from fastapi.testclient import TestClient
 from pydantic import BaseModel
 
@@ -109,3 +109,134 @@ def test_app_lifespan_state(state: State) -> None:
         assert response.json() == {"message": "Hello World"}
     assert state.app_startup is True
     assert state.app_shutdown is True
+
+
+def test_router_nested_lifespan_state(state: State) -> None:
+    @asynccontextmanager
+    async def lifespan(app: FastAPI) -> AsyncGenerator[Dict[str, bool], None]:
+        state.app_startup = True
+        yield {"app": True}
+        state.app_shutdown = True
+
+    @asynccontextmanager
+    async def router_lifespan(app: FastAPI) -> AsyncGenerator[Dict[str, bool], None]:
+        state.router_startup = True
+        yield {"router": True}
+        state.router_shutdown = True
+
+    @asynccontextmanager
+    async def subrouter_lifespan(app: FastAPI) -> AsyncGenerator[Dict[str, bool], None]:
+        state.sub_router_startup = True
+        yield {"sub_router": True}
+        state.sub_router_shutdown = True
+
+    sub_router = APIRouter(lifespan=subrouter_lifespan)
+
+    router = APIRouter(lifespan=router_lifespan)
+    router.include_router(sub_router)
+
+    app = FastAPI(lifespan=lifespan)
+    app.include_router(router)
+
+    @app.get("/")
+    def main(request: Request) -> Dict[str, str]:
+        assert request.state.app
+        assert request.state.router
+        assert request.state.sub_router
+        return {"message": "Hello World"}
+
+    assert state.app_startup is False
+    assert state.router_startup is False
+    assert state.sub_router_startup is False
+    assert state.app_shutdown is False
+    assert state.router_shutdown is False
+    assert state.sub_router_shutdown is False
+
+    with TestClient(app) as client:
+        assert state.app_startup is True
+        assert state.router_startup is True
+        assert state.sub_router_startup is True
+        assert state.app_shutdown is False
+        assert state.router_shutdown is False
+        assert state.sub_router_shutdown is False
+        response = client.get("/")
+        assert response.status_code == 200, response.text
+        assert response.json() == {"message": "Hello World"}
+
+    assert state.app_startup is True
+    assert state.router_startup is True
+    assert state.sub_router_startup is True
+    assert state.app_shutdown is True
+    assert state.router_shutdown is True
+    assert state.sub_router_shutdown is True
+
+
+def test_router_nested_lifespan_state_overriding_by_parent() -> None:
+    @asynccontextmanager
+    async def lifespan(
+        app: FastAPI,
+    ) -> AsyncGenerator[Dict[str, Union[str, bool]], None]:
+        yield {
+            "app_specific": True,
+            "overridden": "app",
+        }
+
+    @asynccontextmanager
+    async def router_lifespan(
+        app: FastAPI,
+    ) -> AsyncGenerator[Dict[str, Union[str, bool]], None]:
+        yield {
+            "router_specific": True,
+            "overridden": "router",  # should override parent
+        }
+
+    router = APIRouter(lifespan=router_lifespan)
+    app = FastAPI(lifespan=lifespan)
+    app.include_router(router)
+
+    with TestClient(app) as client:
+        assert client.app_state == {
+            "app_specific": True,
+            "router_specific": True,
+            "overridden": "app",
+        }
+
+
+def test_merged_no_return_lifespans_return_none() -> None:
+    @asynccontextmanager
+    async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
+        yield
+
+    @asynccontextmanager
+    async def router_lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
+        yield
+
+    router = APIRouter(lifespan=router_lifespan)
+    app = FastAPI(lifespan=lifespan)
+    app.include_router(router)
+
+    with TestClient(app) as client:
+        assert not client.app_state
+
+
+def test_merged_mixed_state_lifespans() -> None:
+    @asynccontextmanager
+    async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
+        yield
+
+    @asynccontextmanager
+    async def router_lifespan(app: FastAPI) -> AsyncGenerator[Dict[str, bool], None]:
+        yield {"router": True}
+
+    @asynccontextmanager
+    async def sub_router_lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
+        yield
+
+    sub_router = APIRouter(lifespan=sub_router_lifespan)
+    router = APIRouter(lifespan=router_lifespan)
+    app = FastAPI(lifespan=lifespan)
+    router.include_router(sub_router)
+    app.include_router(router)
+
+    with TestClient(app) as client:
+        assert client.app_state == {"router": True}

From 48b36f26d83d607a044866633068dbf46e723e0f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 24 Aug 2024 19:10:14 +0000
Subject: [PATCH 012/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c872f59e9..d9cefc989 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Fixes
+
+* 🐛 Ensure that `app.include_router` merges nested lifespans. PR [#9630](https://github.com/fastapi/fastapi/pull/9630) by [@Lancetnik](https://github.com/Lancetnik).
+
 ### Refactors
 
 * 🎨 Fix typing annotation for semi-internal `FastAPI.add_api_route()`. PR [#10240](https://github.com/fastapi/fastapi/pull/10240) by [@ordinary-jamie](https://github.com/ordinary-jamie).

From 51b625e127982f626886d467122ef85d5772d1db Mon Sep 17 00:00:00 2001
From: Giunio <59511892+giunio-prc@users.noreply.github.com>
Date: Sat, 24 Aug 2024 21:27:37 +0200
Subject: [PATCH 013/146] =?UTF-8?q?=F0=9F=90=9B=20Fix=20`allow=5Finf=5Fnan?=
 =?UTF-8?q?`=20option=20for=20Param=20and=20Body=20classes=20(#11867)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: svlandeg <svlandeg@github.com>
---
 fastapi/params.py                        |  4 +-
 tests/test_allow_inf_nan_in_enforcing.py | 83 ++++++++++++++++++++++++
 2 files changed, 85 insertions(+), 2 deletions(-)
 create mode 100644 tests/test_allow_inf_nan_in_enforcing.py

diff --git a/fastapi/params.py b/fastapi/params.py
index 860146531..cc2a5c13c 100644
--- a/fastapi/params.py
+++ b/fastapi/params.py
@@ -91,7 +91,7 @@ class Param(FieldInfo):
             max_length=max_length,
             discriminator=discriminator,
             multiple_of=multiple_of,
-            allow_nan=allow_inf_nan,
+            allow_inf_nan=allow_inf_nan,
             max_digits=max_digits,
             decimal_places=decimal_places,
             **extra,
@@ -547,7 +547,7 @@ class Body(FieldInfo):
             max_length=max_length,
             discriminator=discriminator,
             multiple_of=multiple_of,
-            allow_nan=allow_inf_nan,
+            allow_inf_nan=allow_inf_nan,
             max_digits=max_digits,
             decimal_places=decimal_places,
             **extra,
diff --git a/tests/test_allow_inf_nan_in_enforcing.py b/tests/test_allow_inf_nan_in_enforcing.py
new file mode 100644
index 000000000..9e855fdf8
--- /dev/null
+++ b/tests/test_allow_inf_nan_in_enforcing.py
@@ -0,0 +1,83 @@
+import pytest
+from fastapi import Body, FastAPI, Query
+from fastapi.testclient import TestClient
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+@app.post("/")
+async def get(
+    x: Annotated[float, Query(allow_inf_nan=True)] = 0,
+    y: Annotated[float, Query(allow_inf_nan=False)] = 0,
+    z: Annotated[float, Query()] = 0,
+    b: Annotated[float, Body(allow_inf_nan=False)] = 0,
+) -> str:
+    return "OK"
+
+
+client = TestClient(app)
+
+
+@pytest.mark.parametrize(
+    "value,code",
+    [
+        ("-1", 200),
+        ("inf", 200),
+        ("-inf", 200),
+        ("nan", 200),
+        ("0", 200),
+        ("342", 200),
+    ],
+)
+def test_allow_inf_nan_param_true(value: str, code: int):
+    response = client.post(f"/?x={value}")
+    assert response.status_code == code, response.text
+
+
+@pytest.mark.parametrize(
+    "value,code",
+    [
+        ("-1", 200),
+        ("inf", 422),
+        ("-inf", 422),
+        ("nan", 422),
+        ("0", 200),
+        ("342", 200),
+    ],
+)
+def test_allow_inf_nan_param_false(value: str, code: int):
+    response = client.post(f"/?y={value}")
+    assert response.status_code == code, response.text
+
+
+@pytest.mark.parametrize(
+    "value,code",
+    [
+        ("-1", 200),
+        ("inf", 200),
+        ("-inf", 200),
+        ("nan", 200),
+        ("0", 200),
+        ("342", 200),
+    ],
+)
+def test_allow_inf_nan_param_default(value: str, code: int):
+    response = client.post(f"/?z={value}")
+    assert response.status_code == code, response.text
+
+
+@pytest.mark.parametrize(
+    "value,code",
+    [
+        ("-1", 200),
+        ("inf", 422),
+        ("-inf", 422),
+        ("nan", 422),
+        ("0", 200),
+        ("342", 200),
+    ],
+)
+def test_allow_inf_nan_body(value: str, code: int):
+    response = client.post("/", json=value)
+    assert response.status_code == code, response.text

From b69a9f3b6f822e71be275ca20347a0ab3dfe99e8 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 24 Aug 2024 19:27:59 +0000
Subject: [PATCH 014/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d9cefc989..28d430ab0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Fixes
 
+* 🐛 Fix `allow_inf_nan` option for Param and Body classes. PR [#11867](https://github.com/fastapi/fastapi/pull/11867) by [@giunio-prc](https://github.com/giunio-prc).
 * 🐛 Ensure that `app.include_router` merges nested lifespans. PR [#9630](https://github.com/fastapi/fastapi/pull/9630) by [@Lancetnik](https://github.com/Lancetnik).
 
 ### Refactors

From d00af00d3f15e9a963e2f1baf8f9b4c8357f6f66 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 24 Aug 2024 14:34:50 -0500
Subject: [PATCH 015/146] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
 =?UTF-8?q?2.2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 fastapi/__init__.py           | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 28d430ab0..2af28ae05 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.112.2
+
 ### Fixes
 
 * 🐛 Fix `allow_inf_nan` option for Param and Body classes. PR [#11867](https://github.com/fastapi/fastapi/pull/11867) by [@giunio-prc](https://github.com/giunio-prc).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 0b79d45ef..ac2508d89 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.112.1"
+__version__ = "0.112.2"
 
 from starlette import status as status
 

From 9656895b60e85aeee82a599dc601813ba815b0df Mon Sep 17 00:00:00 2001
From: GPla <36087062+GPla@users.noreply.github.com>
Date: Sat, 24 Aug 2024 22:04:30 +0200
Subject: [PATCH 016/146] =?UTF-8?q?=F0=9F=93=9D=20Add=20note=20in=20Docker?=
 =?UTF-8?q?=20docs=20about=20ensuring=20graceful=20shutdowns=20and=20lifes?=
 =?UTF-8?q?pan=20events=20with=20`CMD`=20exec=20form=20(#11960)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: svlandeg <svlandeg@github.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/en/docs/deployment/docker.md | 32 +++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/docs/en/docs/deployment/docker.md b/docs/en/docs/deployment/docker.md
index 253e25fe5..ab1c2201f 100644
--- a/docs/en/docs/deployment/docker.md
+++ b/docs/en/docs/deployment/docker.md
@@ -232,6 +232,38 @@ Review what each line does by clicking each number bubble in the code. 👆
 
 ///
 
+/// warning
+
+Make sure to **always** use the **exec form** of the `CMD` instruction, as explained below.
+
+///
+
+#### Use `CMD` - Exec Form
+
+The <a href="https://docs.docker.com/reference/dockerfile/#cmd" class="external-link" target="_blank">`CMD`</a> Docker instruction can be written using two forms:
+
+✅ **Exec** form:
+
+```Dockerfile
+# ✅ Do this
+CMD ["fastapi", "run", "app/main.py", "--port", "80"]
+```
+
+⛔️ **Shell** form:
+
+```Dockerfile
+# ⛔️ Don't do this
+CMD fastapi run app/main.py --port 80
+```
+
+Make sure to always use the **exec** form to ensure that FastAPI can shutdown gracefully and [lifespan events](../advanced/events.md){.internal-link target=_blank} are triggered.
+
+You can read more about it in the <a href="https://docs.docker.com/reference/dockerfile/#shell-and-exec-form" class="external-link" target="_blank">Docker docs for shell and exec form</a>.
+
+This can be quite noticeable when using `docker compose`. See this Docker Compose FAQ section for more technical details: <a href="https://docs.docker.com/compose/faq/#why-do-my-services-take-10-seconds-to-recreate-or-stop" class="external-link" target="_blank">Why do my services take 10 seconds to recreate or stop?</a>.
+
+#### Directory Structure
+
 You should now have a directory structure like:
 
 ```

From e4727ed20aa83604a9d28d397e4ce4994f8b9640 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 24 Aug 2024 20:04:51 +0000
Subject: [PATCH 017/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2af28ae05..83d992b8b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Docs
+
+* 📝 Add note in Docker docs about ensuring graceful shutdowns and lifespan events with `CMD` exec form. PR [#11960](https://github.com/fastapi/fastapi/pull/11960) by [@GPla](https://github.com/GPla).
+
 ## 0.112.2
 
 ### Fixes

From 6aa44a85a211f5175b2b45d0dbf23128f6be0627 Mon Sep 17 00:00:00 2001
From: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
Date: Sat, 24 Aug 2024 23:52:09 +0200
Subject: [PATCH 018/146] =?UTF-8?q?=F0=9F=93=9D=20Fix=20minor=20typos=20an?=
 =?UTF-8?q?d=20issues=20in=20the=20documentation=20(#12063)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                                   | 2 +-
 docs/en/docs/advanced/response-directly.md                  | 2 +-
 docs/en/docs/async.md                                       | 2 +-
 docs/en/docs/index.md                                       | 2 +-
 docs/en/docs/python-types.md                                | 2 +-
 docs/en/docs/tutorial/bigger-applications.md                | 4 ++--
 docs/en/docs/tutorial/body-multiple-params.md               | 2 +-
 docs/en/docs/tutorial/body-updates.md                       | 2 +-
 docs/en/docs/tutorial/body.md                               | 2 +-
 docs/en/docs/tutorial/cors.md                               | 2 +-
 .../docs/tutorial/dependencies/classes-as-dependencies.md   | 2 +-
 docs/en/docs/tutorial/extra-data-types.md                   | 2 +-
 docs/en/docs/tutorial/handling-errors.md                    | 4 ++--
 docs/en/docs/tutorial/index.md                              | 2 +-
 docs/en/docs/tutorial/middleware.md                         | 2 +-
 docs/en/docs/tutorial/query-params-str-validations.md       | 6 +++---
 docs/en/docs/tutorial/schema-extra-example.md               | 2 +-
 docs/en/docs/tutorial/security/first-steps.md               | 2 +-
 docs/en/docs/tutorial/security/get-current-user.md          | 2 +-
 19 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/README.md b/README.md
index 889a89ed7..ec7a95497 100644
--- a/README.md
+++ b/README.md
@@ -394,7 +394,7 @@ Coming back to the previous code example, **FastAPI** will:
 * Check if there is an optional query parameter named `q` (as in `http://127.0.0.1:8000/items/foo?q=somequery`) for `GET` requests.
     * As the `q` parameter is declared with `= None`, it is optional.
     * Without the `None` it would be required (as is the body in the case with `PUT`).
-* For `PUT` requests to `/items/{item_id}`, Read the body as JSON:
+* For `PUT` requests to `/items/{item_id}`, read the body as JSON:
     * Check that it has a required attribute `name` that should be a `str`.
     * Check that it has a required attribute `price` that has to be a `float`.
     * Check that it has an optional attribute `is_offer`, that should be a `bool`, if present.
diff --git a/docs/en/docs/advanced/response-directly.md b/docs/en/docs/advanced/response-directly.md
index 73071ed1b..2251659c5 100644
--- a/docs/en/docs/advanced/response-directly.md
+++ b/docs/en/docs/advanced/response-directly.md
@@ -28,7 +28,7 @@ This gives you a lot of flexibility. You can return any data type, override any
 
 ## Using the `jsonable_encoder` in a `Response`
 
-Because **FastAPI** doesn't do any change to a `Response` you return, you have to make sure it's contents are ready for it.
+Because **FastAPI** doesn't do any change to a `Response` you return, you have to make sure its contents are ready for it.
 
 For example, you cannot put a Pydantic model in a `JSONResponse` without first converting it to a `dict` with all the data types (like `datetime`, `UUID`, etc) converted to JSON-compatible types.
 
diff --git a/docs/en/docs/async.md b/docs/en/docs/async.md
index 7cf4af627..752a5c247 100644
--- a/docs/en/docs/async.md
+++ b/docs/en/docs/async.md
@@ -292,7 +292,7 @@ For example:
 
 ### Concurrency + Parallelism: Web + Machine Learning
 
-With **FastAPI** you can take the advantage of concurrency that is very common for web development (the same main attraction of NodeJS).
+With **FastAPI** you can take advantage of concurrency that is very common for web development (the same main attraction of NodeJS).
 
 But you can also exploit the benefits of parallelism and multiprocessing (having multiple processes running in parallel) for **CPU bound** workloads like those in Machine Learning systems.
 
diff --git a/docs/en/docs/index.md b/docs/en/docs/index.md
index ac4f4d00f..3ed3d7bf6 100644
--- a/docs/en/docs/index.md
+++ b/docs/en/docs/index.md
@@ -390,7 +390,7 @@ Coming back to the previous code example, **FastAPI** will:
 * Check if there is an optional query parameter named `q` (as in `http://127.0.0.1:8000/items/foo?q=somequery`) for `GET` requests.
     * As the `q` parameter is declared with `= None`, it is optional.
     * Without the `None` it would be required (as is the body in the case with `PUT`).
-* For `PUT` requests to `/items/{item_id}`, Read the body as JSON:
+* For `PUT` requests to `/items/{item_id}`, read the body as JSON:
     * Check that it has a required attribute `name` that should be a `str`.
     * Check that it has a required attribute `price` that has to be a `float`.
     * Check that it has an optional attribute `is_offer`, that should be a `bool`, if present.
diff --git a/docs/en/docs/python-types.md b/docs/en/docs/python-types.md
index 4ed1fc680..6994adb5f 100644
--- a/docs/en/docs/python-types.md
+++ b/docs/en/docs/python-types.md
@@ -324,7 +324,7 @@ In Python 3.6 and above (including Python 3.10) you can declare it by importing
 {!../../../docs_src/python_types/tutorial009.py!}
 ```
 
-Using `Optional[str]` instead of just `str` will let the editor help you detecting errors where you could be assuming that a value is always a `str`, when it could actually be `None` too.
+Using `Optional[str]` instead of just `str` will let the editor help you detect errors where you could be assuming that a value is always a `str`, when it could actually be `None` too.
 
 `Optional[Something]` is actually a shortcut for `Union[Something, None]`, they are equivalent.
 
diff --git a/docs/en/docs/tutorial/bigger-applications.md b/docs/en/docs/tutorial/bigger-applications.md
index 97f6b205b..230f9c08c 100644
--- a/docs/en/docs/tutorial/bigger-applications.md
+++ b/docs/en/docs/tutorial/bigger-applications.md
@@ -1,6 +1,6 @@
 # Bigger Applications - Multiple Files
 
-If you are building an application or a web API, it's rarely the case that you can put everything on a single file.
+If you are building an application or a web API, it's rarely the case that you can put everything in a single file.
 
 **FastAPI** provides a convenience tool to structure your application while keeping all the flexibility.
 
@@ -478,7 +478,7 @@ We can declare all that without having to modify the original `APIRouter` by pas
 {!../../../docs_src/bigger_applications/app/main.py!}
 ```
 
-That way, the original `APIRouter` will keep unmodified, so we can still share that same `app/internal/admin.py` file with other projects in the organization.
+That way, the original `APIRouter` will stay unmodified, so we can still share that same `app/internal/admin.py` file with other projects in the organization.
 
 The result is that in our app, each of the *path operations* from the `admin` module will have:
 
diff --git a/docs/en/docs/tutorial/body-multiple-params.md b/docs/en/docs/tutorial/body-multiple-params.md
index 511fb358e..d63cd2529 100644
--- a/docs/en/docs/tutorial/body-multiple-params.md
+++ b/docs/en/docs/tutorial/body-multiple-params.md
@@ -97,7 +97,7 @@ But you can also declare multiple body parameters, e.g. `item` and `user`:
 
 ////
 
-In this case, **FastAPI** will notice that there are more than one body parameters in the function (two parameters that are Pydantic models).
+In this case, **FastAPI** will notice that there is more than one body parameter in the function (there are two parameters that are Pydantic models).
 
 So, it will then use the parameter names as keys (field names) in the body, and expect a body like:
 
diff --git a/docs/en/docs/tutorial/body-updates.md b/docs/en/docs/tutorial/body-updates.md
index 261f44d33..3257f9a08 100644
--- a/docs/en/docs/tutorial/body-updates.md
+++ b/docs/en/docs/tutorial/body-updates.md
@@ -155,7 +155,7 @@ In summary, to apply partial updates you would:
 * Put that data in a Pydantic model.
 * Generate a `dict` without default values from the input model (using `exclude_unset`).
     * This way you can update only the values actually set by the user, instead of overriding values already stored with default values in your model.
-* Create a copy of the stored model, updating it's attributes with the received partial updates (using the `update` parameter).
+* Create a copy of the stored model, updating its attributes with the received partial updates (using the `update` parameter).
 * Convert the copied model to something that can be stored in your DB (for example, using the `jsonable_encoder`).
     * This is comparable to using the model's `.model_dump()` method again, but it makes sure (and converts) the values to data types that can be converted to JSON, for example, `datetime` to `str`.
 * Save the data to your DB.
diff --git a/docs/en/docs/tutorial/body.md b/docs/en/docs/tutorial/body.md
index 608b50dbb..83f08ce84 100644
--- a/docs/en/docs/tutorial/body.md
+++ b/docs/en/docs/tutorial/body.md
@@ -123,7 +123,7 @@ The JSON Schemas of your models will be part of your OpenAPI generated schema, a
 
 <img src="/img/tutorial/body/image01.png">
 
-And will be also used in the API docs inside each *path operation* that needs them:
+And will also be used in the API docs inside each *path operation* that needs them:
 
 <img src="/img/tutorial/body/image02.png">
 
diff --git a/docs/en/docs/tutorial/cors.md b/docs/en/docs/tutorial/cors.md
index fd329e138..7dd0a5df5 100644
--- a/docs/en/docs/tutorial/cors.md
+++ b/docs/en/docs/tutorial/cors.md
@@ -40,7 +40,7 @@ You can configure it in your **FastAPI** application using the `CORSMiddleware`.
 * Create a list of allowed origins (as strings).
 * Add it as a "middleware" to your **FastAPI** application.
 
-You can also specify if your backend allows:
+You can also specify whether your backend allows:
 
 * Credentials (Authorization headers, Cookies, etc).
 * Specific HTTP methods (`POST`, `PUT`) or all of them with the wildcard `"*"`.
diff --git a/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
index a392672bb..b3394f14e 100644
--- a/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -381,7 +381,7 @@ The last `CommonQueryParams`, in:
 
 ...is what **FastAPI** will actually use to know what is the dependency.
 
-From it is that FastAPI will extract the declared parameters and that is what FastAPI will actually call.
+It is from this one that FastAPI will extract the declared parameters and that is what FastAPI will actually call.
 
 ---
 
diff --git a/docs/en/docs/tutorial/extra-data-types.md b/docs/en/docs/tutorial/extra-data-types.md
index 849dee41f..3009acaf3 100644
--- a/docs/en/docs/tutorial/extra-data-types.md
+++ b/docs/en/docs/tutorial/extra-data-types.md
@@ -49,7 +49,7 @@ Here are some of the additional data types you can use:
 * `Decimal`:
     * Standard Python `Decimal`.
     * In requests and responses, handled the same as a `float`.
-* You can check all the valid pydantic data types here: <a href="https://docs.pydantic.dev/latest/usage/types/types/" class="external-link" target="_blank">Pydantic data types</a>.
+* You can check all the valid Pydantic data types here: <a href="https://docs.pydantic.dev/latest/usage/types/types/" class="external-link" target="_blank">Pydantic data types</a>.
 
 ## Example
 
diff --git a/docs/en/docs/tutorial/handling-errors.md b/docs/en/docs/tutorial/handling-errors.md
index ca3cff661..14a3cf998 100644
--- a/docs/en/docs/tutorial/handling-errors.md
+++ b/docs/en/docs/tutorial/handling-errors.md
@@ -176,7 +176,7 @@ These are technical details that you might skip if it's not important for you no
 
 **FastAPI** uses it so that, if you use a Pydantic model in `response_model`, and your data has an error, you will see the error in your log.
 
-But the client/user will not see it. Instead, the client will receive an "Internal Server Error" with a HTTP status code `500`.
+But the client/user will not see it. Instead, the client will receive an "Internal Server Error" with an HTTP status code `500`.
 
 It should be this way because if you have a Pydantic `ValidationError` in your *response* or anywhere in your code (not in the client's *request*), it's actually a bug in your code.
 
@@ -262,7 +262,7 @@ from starlette.exceptions import HTTPException as StarletteHTTPException
 
 ### Reuse **FastAPI**'s exception handlers
 
-If you want to use the exception along with the same default exception handlers from  **FastAPI**, You can import and reuse the default exception handlers from `fastapi.exception_handlers`:
+If you want to use the exception along with the same default exception handlers from  **FastAPI**, you can import and reuse the default exception handlers from `fastapi.exception_handlers`:
 
 ```Python hl_lines="2-5  15  21"
 {!../../../docs_src/handling_errors/tutorial006.py!}
diff --git a/docs/en/docs/tutorial/index.md b/docs/en/docs/tutorial/index.md
index 386fe5de9..bf613aace 100644
--- a/docs/en/docs/tutorial/index.md
+++ b/docs/en/docs/tutorial/index.md
@@ -95,7 +95,7 @@ If you don't want to have those optional dependencies, you can instead install `
 
 There is also an **Advanced User Guide** that you can read later after this **Tutorial - User guide**.
 
-The **Advanced User Guide**, builds on this, uses the same concepts, and teaches you some extra features.
+The **Advanced User Guide** builds on this one, uses the same concepts, and teaches you some extra features.
 
 But you should first read the **Tutorial - User Guide** (what you are reading right now).
 
diff --git a/docs/en/docs/tutorial/middleware.md b/docs/en/docs/tutorial/middleware.md
index f0b3faf3b..06fb3f504 100644
--- a/docs/en/docs/tutorial/middleware.md
+++ b/docs/en/docs/tutorial/middleware.md
@@ -29,7 +29,7 @@ The middleware function receives:
 * A function `call_next` that will receive the `request` as a parameter.
     * This function will pass the `request` to the corresponding *path operation*.
     * Then it returns the `response` generated by the corresponding *path operation*.
-* You can then modify further the `response` before returning it.
+* You can then further modify the `response` before returning it.
 
 ```Python hl_lines="8-9  11  14"
 {!../../../docs_src/middleware/tutorial001.py!}
diff --git a/docs/en/docs/tutorial/query-params-str-validations.md b/docs/en/docs/tutorial/query-params-str-validations.md
index 859242d93..dd101a2a6 100644
--- a/docs/en/docs/tutorial/query-params-str-validations.md
+++ b/docs/en/docs/tutorial/query-params-str-validations.md
@@ -273,7 +273,7 @@ The **default** value of the **function parameter** is the **actual default** va
 
 You could **call** that same function in **other places** without FastAPI, and it would **work as expected**. If there's a **required** parameter (without a default value), your **editor** will let you know with an error, **Python** will also complain if you run it without passing the required parameter.
 
-When you don't use `Annotated` and instead use the **(old) default value style**, if you call that function without FastAPI in **other place**, you have to **remember** to pass the arguments to the function for it to work correctly, otherwise the values will be different from what you expect (e.g. `QueryInfo` or something similar instead of `str`). And your editor won't complain, and Python won't complain running that function, only when the operations inside error out.
+When you don't use `Annotated` and instead use the **(old) default value style**, if you call that function without FastAPI in **other places**, you have to **remember** to pass the arguments to the function for it to work correctly, otherwise the values will be different from what you expect (e.g. `QueryInfo` or something similar instead of `str`). And your editor won't complain, and Python won't complain running that function, only when the operations inside error out.
 
 Because `Annotated` can have more than one metadata annotation, you could now even use the same function with other tools, like <a href="https://typer.tiangolo.com/" class="external-link" target="_blank">Typer</a>. 🚀
 
@@ -645,7 +645,7 @@ Remember that in most of the cases, when something is required, you can simply o
 
 ## Query parameter list / multiple values
 
-When you define a query parameter explicitly with `Query` you can also declare it to receive a list of values, or said in other way, to receive multiple values.
+When you define a query parameter explicitly with `Query` you can also declare it to receive a list of values, or said in another way, to receive multiple values.
 
 For example, to declare a query parameter `q` that can appear multiple times in the URL, you can write:
 
@@ -1182,4 +1182,4 @@ Validations specific for strings:
 
 In these examples you saw how to declare validations for `str` values.
 
-See the next chapters to see how to declare validations for other types, like numbers.
+See the next chapters to learn how to declare validations for other types, like numbers.
diff --git a/docs/en/docs/tutorial/schema-extra-example.md b/docs/en/docs/tutorial/schema-extra-example.md
index 70745b048..20dee3a4f 100644
--- a/docs/en/docs/tutorial/schema-extra-example.md
+++ b/docs/en/docs/tutorial/schema-extra-example.md
@@ -347,7 +347,7 @@ If the ideas above already work for you, that might be enough, and you probably
 
 Before OpenAPI 3.1.0, OpenAPI used an older and modified version of **JSON Schema**.
 
-JSON Schema didn't have `examples`, so OpenAPI added it's own `example` field to its own modified version.
+JSON Schema didn't have `examples`, so OpenAPI added its own `example` field to its own modified version.
 
 OpenAPI also added `example` and `examples` fields to other parts of the specification:
 
diff --git a/docs/en/docs/tutorial/security/first-steps.md b/docs/en/docs/tutorial/security/first-steps.md
index 4bd026caf..d1fe0163e 100644
--- a/docs/en/docs/tutorial/security/first-steps.md
+++ b/docs/en/docs/tutorial/security/first-steps.md
@@ -152,7 +152,7 @@ A "bearer" token is not the only option.
 
 But it's the best one for our use case.
 
-And it might be the best for most use cases, unless you are an OAuth2 expert and know exactly why there's another option that suits better your needs.
+And it might be the best for most use cases, unless you are an OAuth2 expert and know exactly why there's another option that better suits your needs.
 
 In that case, **FastAPI** also provides you with the tools to build it.
 
diff --git a/docs/en/docs/tutorial/security/get-current-user.md b/docs/en/docs/tutorial/security/get-current-user.md
index 6f3bf3944..7faaa3e13 100644
--- a/docs/en/docs/tutorial/security/get-current-user.md
+++ b/docs/en/docs/tutorial/security/get-current-user.md
@@ -316,7 +316,7 @@ And you can make it as complex as you want. And still, have it written only once
 
 But you can have thousands of endpoints (*path operations*) using the same security system.
 
-And all of them (or any portion of them that you want) can take the advantage of re-using these dependencies or any other dependencies you create.
+And all of them (or any portion of them that you want) can take advantage of re-using these dependencies or any other dependencies you create.
 
 And all these thousands of *path operations* can be as small as 3 lines:
 

From d8e526c1db42b9049a3c9a26f2ac91109c896812 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 24 Aug 2024 21:52:29 +0000
Subject: [PATCH 019/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 83d992b8b..2218b352b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* 📝 Fix minor typos and issues in the documentation. PR [#12063](https://github.com/fastapi/fastapi/pull/12063) by [@svlandeg](https://github.com/svlandeg).
 * 📝 Add note in Docker docs about ensuring graceful shutdowns and lifespan events with `CMD` exec form. PR [#11960](https://github.com/fastapi/fastapi/pull/11960) by [@GPla](https://github.com/GPla).
 
 ## 0.112.2

From c692176d4288e8b8f6f404c7c15aaab74083a6e1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 24 Aug 2024 19:01:04 -0500
Subject: [PATCH 020/146] =?UTF-8?q?=F0=9F=93=9D=20Clarify=20`response=5Fcl?=
 =?UTF-8?q?ass`=20parameter,=20validations,=20and=20returning=20a=20respon?=
 =?UTF-8?q?se=20directly=20(#12067)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/advanced/custom-response.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/docs/advanced/custom-response.md b/docs/en/docs/advanced/custom-response.md
index 8a6555dba..79f755815 100644
--- a/docs/en/docs/advanced/custom-response.md
+++ b/docs/en/docs/advanced/custom-response.md
@@ -4,9 +4,9 @@ By default, **FastAPI** will return the responses using `JSONResponse`.
 
 You can override it by returning a `Response` directly as seen in [Return a Response directly](response-directly.md){.internal-link target=_blank}.
 
-But if you return a `Response` directly, the data won't be automatically converted, and the documentation won't be automatically generated (for example, including the specific "media type", in the HTTP header `Content-Type` as part of the generated OpenAPI).
+But if you return a `Response` directly (or any subclass, like `JSONResponse`), the data won't be automatically converted (even if you declare a `response_model`), and the documentation won't be automatically generated (for example, including the specific "media type", in the HTTP header `Content-Type` as part of the generated OpenAPI).
 
-But you can also declare the `Response` that you want to be used, in the *path operation decorator*.
+But you can also declare the `Response` that you want to be used (e.g. any `Response` subclass), in the *path operation decorator* using the `response_class` parameter.
 
 The contents that you return from your *path operation function* will be put inside of that `Response`.
 

From b5cbff9521c6c800aebf37d73a3532951db95bff Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 25 Aug 2024 00:01:26 +0000
Subject: [PATCH 021/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2218b352b..ac8f16f53 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* 📝 Clarify `response_class` parameter, validations, and returning a response directly. PR [#12067](https://github.com/fastapi/fastapi/pull/12067) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Fix minor typos and issues in the documentation. PR [#12063](https://github.com/fastapi/fastapi/pull/12063) by [@svlandeg](https://github.com/svlandeg).
 * 📝 Add note in Docker docs about ensuring graceful shutdowns and lifespan events with `CMD` exec form. PR [#11960](https://github.com/fastapi/fastapi/pull/11960) by [@GPla](https://github.com/GPla).
 

From bd1b77548f0f1788c5ae0fbd8144f5139bdb959e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 24 Aug 2024 21:44:06 -0500
Subject: [PATCH 022/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20docs=20about=20?=
 =?UTF-8?q?serving=20FastAPI:=20ASGI=20servers,=20Docker=20containers,=20e?=
 =?UTF-8?q?tc.=20(#12069)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/advanced/sub-applications.md    |   4 +-
 docs/en/docs/alternatives.md                 |   2 +-
 docs/en/docs/contributing.md                 |   2 +-
 docs/en/docs/deployment/concepts.md          |   8 +-
 docs/en/docs/deployment/docker.md            | 226 ++++---------------
 docs/en/docs/deployment/manually.md          |  89 +-------
 docs/en/docs/deployment/server-workers.md    | 165 ++++++--------
 docs/en/docs/deployment/versions.md          |   2 +-
 docs/en/docs/tutorial/bigger-applications.md |   4 +-
 9 files changed, 129 insertions(+), 373 deletions(-)

diff --git a/docs/en/docs/advanced/sub-applications.md b/docs/en/docs/advanced/sub-applications.md
index 8c52e091f..568a9deca 100644
--- a/docs/en/docs/advanced/sub-applications.md
+++ b/docs/en/docs/advanced/sub-applications.md
@@ -36,12 +36,12 @@ In this case, it will be mounted at the path `/subapi`:
 
 ### Check the automatic API docs
 
-Now, run `uvicorn` with the main app, if your file is `main.py`, it would be:
+Now, run the `fastapi` command with your file:
 
 <div class="termy">
 
 ```console
-$ uvicorn main:app --reload
+$ fastapi dev main.py
 
 <span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
 ```
diff --git a/docs/en/docs/alternatives.md b/docs/en/docs/alternatives.md
index 2ad584c95..e98c0475a 100644
--- a/docs/en/docs/alternatives.md
+++ b/docs/en/docs/alternatives.md
@@ -474,7 +474,7 @@ It is the recommended server for Starlette and **FastAPI**.
 
 The main web server to run **FastAPI** applications.
 
-You can combine it with Gunicorn, to have an asynchronous multi-process server.
+You can also use the `--workers` command line option to have an asynchronous multi-process server.
 
 Check more details in the [Deployment](deployment/index.md){.internal-link target=_blank} section.
 
diff --git a/docs/en/docs/contributing.md b/docs/en/docs/contributing.md
index 91d5724a8..0dc07b89b 100644
--- a/docs/en/docs/contributing.md
+++ b/docs/en/docs/contributing.md
@@ -170,7 +170,7 @@ If you run the examples with, e.g.:
 <div class="termy">
 
 ```console
-$ uvicorn tutorial001:app --reload
+$ fastapi dev tutorial001.py
 
 <span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
 ```
diff --git a/docs/en/docs/deployment/concepts.md b/docs/en/docs/deployment/concepts.md
index f917d18b3..69ee71a73 100644
--- a/docs/en/docs/deployment/concepts.md
+++ b/docs/en/docs/deployment/concepts.md
@@ -94,7 +94,7 @@ In most cases, when you create a web API, you want it to be **always running**,
 
 ### In a Remote Server
 
-When you set up a remote server (a cloud server, a virtual machine, etc.) the simplest thing you can do is to use `fastapi run`, Uvicorn (or similar) manually, the same way you do when developing locally.
+When you set up a remote server (a cloud server, a virtual machine, etc.) the simplest thing you can do is use `fastapi run` (which uses Uvicorn) or something  similar, manually, the same way you do when developing locally.
 
 And it will work and will be useful **during development**.
 
@@ -178,7 +178,7 @@ For example, this could be handled by:
 
 ## Replication - Processes and Memory
 
-With a FastAPI application, using a server program like Uvicorn, running it once in **one process** can serve multiple clients concurrently.
+With a FastAPI application, using a server program like the `fastapi` command that runs Uvicorn, running it once in **one process** can serve multiple clients concurrently.
 
 But in many cases, you will want to run several worker processes at the same time.
 
@@ -232,9 +232,7 @@ The main constraint to consider is that there has to be a **single** component h
 
 Here are some possible combinations and strategies:
 
-* **Gunicorn** managing **Uvicorn workers**
-    * Gunicorn would be the **process manager** listening on the **IP** and **port**, the replication would be by having **multiple Uvicorn worker processes**.
-* **Uvicorn** managing **Uvicorn workers**
+* **Uvicorn** with `--workers`
     * One Uvicorn **process manager** would listen on the **IP** and **port**, and it would start **multiple Uvicorn worker processes**.
 * **Kubernetes** and other distributed **container systems**
     * Something in the **Kubernetes** layer would listen on the **IP** and **port**. The replication would be by having **multiple containers**, each with **one Uvicorn process** running.
diff --git a/docs/en/docs/deployment/docker.md b/docs/en/docs/deployment/docker.md
index ab1c2201f..2d832a238 100644
--- a/docs/en/docs/deployment/docker.md
+++ b/docs/en/docs/deployment/docker.md
@@ -167,22 +167,22 @@ def read_item(item_id: int, q: Union[str, None] = None):
 Now in the same project directory create a file `Dockerfile` with:
 
 ```{ .dockerfile .annotate }
-# (1)
+# (1)!
 FROM python:3.9
 
-# (2)
+# (2)!
 WORKDIR /code
 
-# (3)
+# (3)!
 COPY ./requirements.txt /code/requirements.txt
 
-# (4)
+# (4)!
 RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
 
-# (5)
+# (5)!
 COPY ./app /code/app
 
-# (6)
+# (6)!
 CMD ["fastapi", "run", "app/main.py", "--port", "80"]
 ```
 
@@ -400,10 +400,10 @@ COPY ./requirements.txt /code/requirements.txt
 
 RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
 
-# (1)
+# (1)!
 COPY ./main.py /code/
 
-# (2)
+# (2)!
 CMD ["fastapi", "run", "main.py", "--port", "80"]
 ```
 
@@ -456,11 +456,11 @@ Without using containers, making applications run on startup and with restarts c
 
 ## Replication - Number of Processes
 
-If you have a <abbr title="A group of machines that are configured to be connected and work together in some way.">cluster</abbr> of machines with **Kubernetes**, Docker Swarm Mode, Nomad, or another similar complex system to manage distributed containers on multiple machines, then you will probably want to **handle replication** at the **cluster level** instead of using a **process manager** (like Gunicorn with workers) in each container.
+If you have a <abbr title="A group of machines that are configured to be connected and work together in some way.">cluster</abbr> of machines with **Kubernetes**, Docker Swarm Mode, Nomad, or another similar complex system to manage distributed containers on multiple machines, then you will probably want to **handle replication** at the **cluster level** instead of using a **process manager** (like Uvicorn with workers) in each container.
 
 One of those distributed container management systems like Kubernetes normally has some integrated way of handling **replication of containers** while still supporting **load balancing** for the incoming requests. All at the **cluster level**.
 
-In those cases, you would probably want to build a **Docker image from scratch** as [explained above](#dockerfile), installing your dependencies, and running **a single Uvicorn process** instead of running something like Gunicorn with Uvicorn workers.
+In those cases, you would probably want to build a **Docker image from scratch** as [explained above](#dockerfile), installing your dependencies, and running **a single Uvicorn process** instead of using multiple Uvicorn workers.
 
 ### Load Balancer
 
@@ -490,37 +490,44 @@ And normally this **load balancer** would be able to handle requests that go to
 
 In this type of scenario, you probably would want to have **a single (Uvicorn) process per container**, as you would already be handling replication at the cluster level.
 
-So, in this case, you **would not** want to have a process manager like Gunicorn with Uvicorn workers, or Uvicorn using its own Uvicorn workers. You would want to have just a **single Uvicorn process** per container (but probably multiple containers).
+So, in this case, you **would not** want to have a multiple workers in the container, for example with the `--workers` command line option.You would want to have just a **single Uvicorn process** per container (but probably multiple containers).
 
-Having another process manager inside the container (as would be with Gunicorn or Uvicorn managing Uvicorn workers) would only add **unnecessary complexity** that you are most probably already taking care of with your cluster system.
+Having another process manager inside the container (as would be with multiple workers) would only add **unnecessary complexity** that you are most probably already taking care of with your cluster system.
 
 ### Containers with Multiple Processes and Special Cases
 
-Of course, there are **special cases** where you could want to have **a container** with a **Gunicorn process manager** starting several **Uvicorn worker processes** inside.
+Of course, there are **special cases** where you could want to have **a container** with several **Uvicorn worker processes** inside.
 
-In those cases, you can use the **official Docker image** that includes **Gunicorn** as a process manager running multiple **Uvicorn worker processes**, and some default settings to adjust the number of workers based on the current CPU cores automatically. I'll tell you more about it below in [Official Docker Image with Gunicorn - Uvicorn](#official-docker-image-with-gunicorn-uvicorn).
+In those cases, you can use the `--workers` command line option to set the number of workers that you want to run:
 
-Here are some examples of when that could make sense:
+```{ .dockerfile .annotate }
+FROM python:3.9
 
-#### A Simple App
+WORKDIR /code
 
-You could want a process manager in the container if your application is **simple enough** that you don't need (at least not yet) to fine-tune the number of processes too much, and you can just use an automated default (with the official Docker image), and you are running it on a **single server**, not a cluster.
+COPY ./requirements.txt /code/requirements.txt
 
-#### Docker Compose
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
 
-You could be deploying to a **single server** (not a cluster) with **Docker Compose**, so you wouldn't have an easy way to manage replication of containers (with Docker Compose) while preserving the shared network and **load balancing**.
+COPY ./app /code/app
 
-Then you could want to have **a single container** with a **process manager** starting **several worker processes** inside.
+# (1)!
+CMD ["fastapi", "run", "app/main.py", "--port", "80", "--workers", "4"]
+```
 
-#### Prometheus and Other Reasons
+1. Here we use the `--workers` command line option to set the number of workers to 4.
 
-You could also have **other reasons** that would make it easier to have a **single container** with **multiple processes** instead of having **multiple containers** with **a single process** in each of them.
+Here are some examples of when that could make sense:
 
-For example (depending on your setup) you could have some tool like a Prometheus exporter in the same container that should have access to **each of the requests** that come.
+#### A Simple App
+
+You could want a process manager in the container if your application is **simple enough** that can run it on a **single server**, not a cluster.
+
+#### Docker Compose
 
-In this case, if you had **multiple containers**, by default, when Prometheus came to **read the metrics**, it would get the ones for **a single container each time** (for the container that handled that particular request), instead of getting the **accumulated metrics** for all the replicated containers.
+You could be deploying to a **single server** (not a cluster) with **Docker Compose**, so you wouldn't have an easy way to manage replication of containers (with Docker Compose) while preserving the shared network and **load balancing**.
 
-Then, in that case, it could be simpler to have **one container** with **multiple processes**, and a local tool (e.g. a Prometheus exporter) on the same container collecting Prometheus metrics for all the internal processes and exposing those metrics on that single container.
+Then you could want to have **a single container** with a **process manager** starting **several worker processes** inside.
 
 ---
 
@@ -541,7 +548,7 @@ And then you can set those same memory limits and requirements in your configura
 
 If your application is **simple**, this will probably **not be a problem**, and you might not need to specify hard memory limits. But if you are **using a lot of memory** (for example with **machine learning** models), you should check how much memory you are consuming and adjust the **number of containers** that runs in **each machine** (and maybe add more machines to your cluster).
 
-If you run **multiple processes per container** (for example with the official Docker image) you will have to make sure that the number of processes started doesn't **consume more memory** than what is available.
+If you run **multiple processes per container** you will have to make sure that the number of processes started doesn't **consume more memory** than what is available.
 
 ## Previous Steps Before Starting and Containers
 
@@ -561,80 +568,26 @@ If in your use case there's no problem in running those previous steps **multipl
 
 ### Single Container
 
-If you have a simple setup, with a **single container** that then starts multiple **worker processes** (or also just one process), then you could run those previous steps in the same container, right before starting the process with the app. The official Docker image supports this internally.
+If you have a simple setup, with a **single container** that then starts multiple **worker processes** (or also just one process), then you could run those previous steps in the same container, right before starting the process with the app.
 
-## Official Docker Image with Gunicorn - Uvicorn
+### Base Docker Image
 
-There is an official Docker image that includes Gunicorn running with Uvicorn workers, as detailed in a previous chapter: [Server Workers - Gunicorn with Uvicorn](server-workers.md){.internal-link target=_blank}.
+There used to be an official FastAPI Docker image: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>. But it is now deprecated. ⛔️
 
-This image would be useful mainly in the situations described above in: [Containers with Multiple Processes and Special Cases](#containers-with-multiple-processes-and-special-cases).
-
-* <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
-
-/// warning
-
-There's a high chance that you **don't** need this base image or any other similar one, and would be better off by building the image from scratch as [described above in: Build a Docker Image for FastAPI](#build-a-docker-image-for-fastapi).
-
-///
+You should probably **not** use this base Docker image (or any other similar one).
 
-This image has an **auto-tuning** mechanism included to set the **number of worker processes** based on the CPU cores available.
+If you are using **Kubernetes** (or others) and you are already setting **replication** at the cluster level, with multiple **containers**. In those cases, you are better off **building an image from scratch** as described above: [Build a Docker Image for FastAPI](#build-a-docker-image-for-fastapi).
 
-It has **sensible defaults**, but you can still change and update all the configurations with **environment variables** or configuration files.
+And if you need to have multiple workers, you can simply use the `--workers` command line option.
 
-It also supports running <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker#pre_start_path" class="external-link" target="_blank">**previous steps before starting**</a> with a script.
+/// note | Technical Details
 
-/// tip
+The Docker image was created when Uvicorn didn't support managing and restarting dead workers, so it was needed to use Gunicorn with Uvicorn, which added quite some complexity, just to have Gunicorn manage and restart the Uvicorn worker processes.
 
-To see all the configurations and options, go to the Docker image page: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
+But now that Uvicorn (and the `fastapi` command) support using `--workers`, there's no reason to use a base Docker image instead of building your own (it's pretty much the same amount of code 😅).
 
 ///
 
-### Number of Processes on the Official Docker Image
-
-The **number of processes** on this image is **computed automatically** from the CPU **cores** available.
-
-This means that it will try to **squeeze** as much **performance** from the CPU as possible.
-
-You can also adjust it with the configurations using **environment variables**, etc.
-
-But it also means that as the number of processes depends on the CPU the container is running, the **amount of memory consumed** will also depend on that.
-
-So, if your application consumes a lot of memory (for example with machine learning models), and your server has a lot of CPU cores **but little memory**, then your container could end up trying to use more memory than what is available, and degrading performance a lot (or even crashing). 🚨
-
-### Create a `Dockerfile`
-
-Here's how you would create a `Dockerfile` based on this image:
-
-```Dockerfile
-FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9
-
-COPY ./requirements.txt /app/requirements.txt
-
-RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
-
-COPY ./app /app
-```
-
-### Bigger Applications
-
-If you followed the section about creating [Bigger Applications with Multiple Files](../tutorial/bigger-applications.md){.internal-link target=_blank}, your `Dockerfile` might instead look like:
-
-```Dockerfile hl_lines="7"
-FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9
-
-COPY ./requirements.txt /app/requirements.txt
-
-RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
-
-COPY ./app /app/app
-```
-
-### When to Use
-
-You should probably **not** use this official base image (or any other similar one) if you are using **Kubernetes** (or others) and you are already setting **replication** at the cluster level, with multiple **containers**. In those cases, you are better off **building an image from scratch** as described above: [Build a Docker Image for FastAPI](#build-a-docker-image-for-fastapi).
-
-This image would be useful mainly in the special cases described above in [Containers with Multiple Processes and Special Cases](#containers-with-multiple-processes-and-special-cases). For example, if your application is **simple enough** that setting a default number of processes based on the CPU works well, you don't want to bother with manually configuring the replication at the cluster level, and you are not running more than one container with your app. Or if you are deploying with **Docker Compose**, running on a single server, etc.
-
 ## Deploy the Container Image
 
 After having a Container (Docker) Image there are several ways to deploy it.
@@ -647,98 +600,9 @@ For example:
 * With another tool like Nomad
 * With a cloud service that takes your container image and deploys it
 
-## Docker Image with Poetry
+## Docker Image with `uv`
 
-If you use <a href="https://python-poetry.org/" class="external-link" target="_blank">Poetry</a> to manage your project's dependencies, you could use Docker multi-stage building:
-
-```{ .dockerfile .annotate }
-# (1)
-FROM python:3.9 as requirements-stage
-
-# (2)
-WORKDIR /tmp
-
-# (3)
-RUN pip install poetry
-
-# (4)
-COPY ./pyproject.toml ./poetry.lock* /tmp/
-
-# (5)
-RUN poetry export -f requirements.txt --output requirements.txt --without-hashes
-
-# (6)
-FROM python:3.9
-
-# (7)
-WORKDIR /code
-
-# (8)
-COPY --from=requirements-stage /tmp/requirements.txt /code/requirements.txt
-
-# (9)
-RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
-
-# (10)
-COPY ./app /code/app
-
-# (11)
-CMD ["fastapi", "run", "app/main.py", "--port", "80"]
-```
-
-1. This is the first stage, it is named `requirements-stage`.
-
-2. Set `/tmp` as the current working directory.
-
-    Here's where we will generate the file `requirements.txt`
-
-3. Install Poetry in this Docker stage.
-
-4. Copy the `pyproject.toml` and `poetry.lock` files to the `/tmp` directory.
-
-    Because it uses `./poetry.lock*` (ending with a `*`), it won't crash if that file is not available yet.
-
-5. Generate the `requirements.txt` file.
-
-6. This is the final stage, anything here will be preserved in the final container image.
-
-7. Set the current working directory to `/code`.
-
-8. Copy the `requirements.txt` file to the `/code` directory.
-
-    This file only lives in the previous Docker stage, that's why we use `--from-requirements-stage` to copy it.
-
-9. Install the package dependencies in the generated `requirements.txt` file.
-
-10. Copy the `app` directory to the `/code` directory.
-
-11. Use the `fastapi run` command to run your app.
-
-/// tip
-
-Click the bubble numbers to see what each line does.
-
-///
-
-A **Docker stage** is a part of a `Dockerfile` that works as a **temporary container image** that is only used to generate some files to be used later.
-
-The first stage will only be used to **install Poetry** and to **generate the `requirements.txt`** with your project dependencies from Poetry's `pyproject.toml` file.
-
-This `requirements.txt` file will be used with `pip` later in the **next stage**.
-
-In the final container image **only the final stage** is preserved. The previous stage(s) will be discarded.
-
-When using Poetry, it would make sense to use **Docker multi-stage builds** because you don't really need to have Poetry and its dependencies installed in the final container image, you **only need** to have the generated `requirements.txt` file to install your project dependencies.
-
-Then in the next (and final) stage you would build the image more or less in the same way as described before.
-
-### Behind a TLS Termination Proxy - Poetry
-
-Again, if you are running your container behind a TLS Termination Proxy (load balancer) like Nginx or Traefik, add the option `--proxy-headers` to the command:
-
-```Dockerfile
-CMD ["fastapi", "run", "app/main.py", "--proxy-headers", "--port", "80"]
-```
+If you are using <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">uv</a> to install and manage your project, you can follow their <a href="https://docs.astral.sh/uv/guides/integration/docker/" class="external-link" target="_blank">uv Docker guide</a>.
 
 ## Recap
 
@@ -754,5 +618,3 @@ Using container systems (e.g. with **Docker** and **Kubernetes**) it becomes fai
 In most cases, you probably won't want to use any base image, and instead **build a container image from scratch** one based on the official Python Docker image.
 
 Taking care of the **order** of instructions in the `Dockerfile` and the **Docker cache** you can **minimize build times**, to maximize your productivity (and avoid boredom). 😎
-
-In certain special cases, you might want to use the official Docker image for FastAPI. 🤓
diff --git a/docs/en/docs/deployment/manually.md b/docs/en/docs/deployment/manually.md
index 3324a7503..3f7c7a008 100644
--- a/docs/en/docs/deployment/manually.md
+++ b/docs/en/docs/deployment/manually.md
@@ -67,6 +67,8 @@ There are several alternatives, including:
 * <a href="https://www.uvicorn.org/" class="external-link" target="_blank">Uvicorn</a>: a high performance ASGI server.
 * <a href="https://hypercorn.readthedocs.io/" class="external-link" target="_blank">Hypercorn</a>: an ASGI server compatible with HTTP/2 and Trio among other features.
 * <a href="https://github.com/django/daphne" class="external-link" target="_blank">Daphne</a>: the ASGI server built for Django Channels.
+* <a href="https://github.com/emmett-framework/granian" class="external-link" target="_blank">Granian</a>: A Rust HTTP server for Python applications.
+* <a href="https://unit.nginx.org/howto/fastapi/" class="external-link" target="_blank">NGINX Unit</a>: NGINX Unit is a lightweight and versatile web application runtime.
 
 ## Server Machine and Server Program
 
@@ -84,11 +86,9 @@ When you install FastAPI, it comes with a production server, Uvicorn, and you ca
 
 But you can also install an ASGI server manually.
 
-Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then you can install the server:
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then you can install the server application.
 
-//// tab | Uvicorn
-
-* <a href="https://www.uvicorn.org/" class="external-link" target="_blank">Uvicorn</a>, a lightning-fast ASGI server, built on uvloop and httptools.
+For example, to install Uvicorn:
 
 <div class="termy">
 
@@ -100,6 +100,8 @@ $ pip install "uvicorn[standard]"
 
 </div>
 
+A similar process would apply to any other ASGI server program.
+
 /// tip
 
 By adding the `standard`, Uvicorn will install and use some recommended extra dependencies.
@@ -110,32 +112,10 @@ When you install FastAPI with something like `pip install "fastapi[standard]"` y
 
 ///
 
-////
-
-//// tab | Hypercorn
-
-* <a href="https://github.com/pgjones/hypercorn" class="external-link" target="_blank">Hypercorn</a>, an ASGI server also compatible with HTTP/2.
-
-<div class="termy">
-
-```console
-$ pip install hypercorn
-
----> 100%
-```
-
-</div>
-
-...or any other ASGI server.
-
-////
-
 ## Run the Server Program
 
 If you installed an ASGI server manually, you would normally need to pass an import string in a special format for it to import your FastAPI application:
 
-//// tab | Uvicorn
-
 <div class="termy">
 
 ```console
@@ -146,22 +126,6 @@ $ uvicorn main:app --host 0.0.0.0 --port 80
 
 </div>
 
-////
-
-//// tab | Hypercorn
-
-<div class="termy">
-
-```console
-$ hypercorn main:app --bind 0.0.0.0:80
-
-Running on 0.0.0.0:8080 over http (CTRL + C to quit)
-```
-
-</div>
-
-////
-
 /// note
 
 The command `uvicorn main:app` refers to:
@@ -177,9 +141,11 @@ from main import app
 
 ///
 
+Each alternative ASGI server program would have a similar command, you can read more in their respective documentation.
+
 /// warning
 
-Uvicorn and others support a `--reload` option that is useful during development.
+Uvicorn and other servers support a `--reload` option that is useful during development.
 
 The `--reload` option consumes much more resources, is more unstable, etc.
 
@@ -187,43 +153,6 @@ It helps a lot during **development**, but you **shouldn't** use it in **product
 
 ///
 
-## Hypercorn with Trio
-
-Starlette and **FastAPI** are based on <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a>, which makes them compatible with both Python's standard library <a href="https://docs.python.org/3/library/asyncio-task.html" class="external-link" target="_blank">asyncio</a> and <a href="https://trio.readthedocs.io/en/stable/" class="external-link" target="_blank">Trio</a>.
-
-Nevertheless, Uvicorn is currently only compatible with asyncio, and it normally uses <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a>, the high-performance drop-in replacement for `asyncio`.
-
-But if you want to directly use **Trio**, then you can use **Hypercorn** as it supports it. ✨
-
-### Install Hypercorn with Trio
-
-First you need to install Hypercorn with Trio support:
-
-<div class="termy">
-
-```console
-$ pip install "hypercorn[trio]"
----> 100%
-```
-
-</div>
-
-### Run with Trio
-
-Then you can pass the command line option `--worker-class` with the value `trio`:
-
-<div class="termy">
-
-```console
-$ hypercorn main:app --worker-class trio
-```
-
-</div>
-
-And that will start Hypercorn with your app using Trio as the backend.
-
-Now you can use Trio internally in your app. Or even better, you can use AnyIO, to keep your code compatible with both Trio and asyncio. 🎉
-
 ## Deployment Concepts
 
 These examples run the server program (e.g Uvicorn), starting **a single process**, listening on all the IPs (`0.0.0.0`) on a predefined port (e.g. `80`).
diff --git a/docs/en/docs/deployment/server-workers.md b/docs/en/docs/deployment/server-workers.md
index efde5f3a1..5e369e071 100644
--- a/docs/en/docs/deployment/server-workers.md
+++ b/docs/en/docs/deployment/server-workers.md
@@ -1,4 +1,4 @@
-# Server Workers - Gunicorn with Uvicorn
+# Server Workers - Uvicorn with Workers
 
 Let's check back those deployment concepts from before:
 
@@ -9,125 +9,92 @@ Let's check back those deployment concepts from before:
 * Memory
 * Previous steps before starting
 
-Up to this point, with all the tutorials in the docs, you have probably been running a **server program** like Uvicorn, running a **single process**.
+Up to this point, with all the tutorials in the docs, you have probably been running a **server program**, for example, using the `fastapi` command, that runs Uvicorn, running a **single process**.
 
 When deploying applications you will probably want to have some **replication of processes** to take advantage of **multiple cores** and to be able to handle more requests.
 
 As you saw in the previous chapter about [Deployment Concepts](concepts.md){.internal-link target=_blank}, there are multiple strategies you can use.
 
-Here I'll show you how to use <a href="https://gunicorn.org/" class="external-link" target="_blank">**Gunicorn**</a> with **Uvicorn worker processes**.
+Here I'll show you how to use **Uvicorn** with **worker processes** using the `fastapi` command or the `uvicorn` command directly.
 
 /// info
 
 If you are using containers, for example with Docker or Kubernetes, I'll tell you more about that in the next chapter: [FastAPI in Containers - Docker](docker.md){.internal-link target=_blank}.
 
-In particular, when running on **Kubernetes** you will probably **not** want to use Gunicorn and instead run **a single Uvicorn process per container**, but I'll tell you about it later in that chapter.
+In particular, when running on **Kubernetes** you will probably **not** want to use workers and instead run **a single Uvicorn process per container**, but I'll tell you about it later in that chapter.
 
 ///
 
-## Gunicorn with Uvicorn Workers
+## Multiple Workers
 
-**Gunicorn** is mainly an application server using the **WSGI standard**. That means that Gunicorn can serve applications like Flask and Django. Gunicorn by itself is not compatible with **FastAPI**, as FastAPI uses the newest **<a href="https://asgi.readthedocs.io/en/latest/" class="external-link" target="_blank">ASGI standard</a>**.
+You can start multiple workers with the `--workers` command line option:
 
-But Gunicorn supports working as a **process manager** and allowing users to tell it which specific **worker process class** to use. Then Gunicorn would start one or more **worker processes** using that class.
+//// tab | `fastapi`
 
-And **Uvicorn** has a **Gunicorn-compatible worker class**.
-
-Using that combination, Gunicorn would act as a **process manager**, listening on the **port** and the **IP**. And it would **transmit** the communication to the worker processes running the **Uvicorn class**.
-
-And then the Gunicorn-compatible **Uvicorn worker** class would be in charge of converting the data sent by Gunicorn to the ASGI standard for FastAPI to use it.
-
-## Install Gunicorn and Uvicorn
-
-Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install `gunicorn`:
+If you use the `fastapi` command:
 
 <div class="termy">
 
 ```console
-$ pip install "uvicorn[standard]" gunicorn
-
----> 100%
+$ <pre> <font color="#4E9A06">fastapi</font> run --workers 4 <u style="text-decoration-style:single">main.py</u>
+<font color="#3465A4">INFO    </font> Using path <font color="#3465A4">main.py</font>
+<font color="#3465A4">INFO    </font> Resolved absolute path <font color="#75507B">/home/user/code/awesomeapp/</font><font color="#AD7FA8">main.py</font>
+<font color="#3465A4">INFO    </font> Searching for package file structure from directories with <font color="#3465A4">__init__.py</font> files
+<font color="#3465A4">INFO    </font> Importing from <font color="#75507B">/home/user/code/</font><font color="#AD7FA8">awesomeapp</font>
+
+ ╭─ <font color="#8AE234"><b>Python module file</b></font> ─╮
+ │                      │
+ │  🐍 main.py          │
+ │                      │
+ ╰──────────────────────╯
+
+<font color="#3465A4">INFO    </font> Importing module <font color="#4E9A06">main</font>
+<font color="#3465A4">INFO    </font> Found importable FastAPI app
+
+ ╭─ <font color="#8AE234"><b>Importable FastAPI app</b></font> ─╮
+ │                          │
+ │  <span style="background-color:#272822"><font color="#FF4689">from</font></span><span style="background-color:#272822"><font color="#F8F8F2"> main </font></span><span style="background-color:#272822"><font color="#FF4689">import</font></span><span style="background-color:#272822"><font color="#F8F8F2"> app</font></span><span style="background-color:#272822">  </span>  │
+ │                          │
+ ╰──────────────────────────╯
+
+<font color="#3465A4">INFO    </font> Using import string <font color="#8AE234"><b>main:app</b></font>
+
+ <font color="#4E9A06">╭─────────── FastAPI CLI - Production mode ───────────╮</font>
+ <font color="#4E9A06">│                                                     │</font>
+ <font color="#4E9A06">│  Serving at: http://0.0.0.0:8000                    │</font>
+ <font color="#4E9A06">│                                                     │</font>
+ <font color="#4E9A06">│  API docs: http://0.0.0.0:8000/docs                 │</font>
+ <font color="#4E9A06">│                                                     │</font>
+ <font color="#4E9A06">│  Running in production mode, for development use:   │</font>
+ <font color="#4E9A06">│                                                     │</font>
+ <font color="#4E9A06">│  </font><font color="#8AE234"><b>fastapi dev</b></font><font color="#4E9A06">                                        │</font>
+ <font color="#4E9A06">│                                                     │</font>
+ <font color="#4E9A06">╰─────────────────────────────────────────────────────╯</font>
+
+<font color="#4E9A06">INFO</font>:     Uvicorn running on <b>http://0.0.0.0:8000</b> (Press CTRL+C to quit)
+<font color="#4E9A06">INFO</font>:     Started parent process [<font color="#34E2E2"><b>27365</b></font>]
+<font color="#4E9A06">INFO</font>:     Started server process [<font color="#06989A">27368</font>]
+<font color="#4E9A06">INFO</font>:     Waiting for application startup.
+<font color="#4E9A06">INFO</font>:     Application startup complete.
+<font color="#4E9A06">INFO</font>:     Started server process [<font color="#06989A">27369</font>]
+<font color="#4E9A06">INFO</font>:     Waiting for application startup.
+<font color="#4E9A06">INFO</font>:     Application startup complete.
+<font color="#4E9A06">INFO</font>:     Started server process [<font color="#06989A">27370</font>]
+<font color="#4E9A06">INFO</font>:     Waiting for application startup.
+<font color="#4E9A06">INFO</font>:     Application startup complete.
+<font color="#4E9A06">INFO</font>:     Started server process [<font color="#06989A">27367</font>]
+<font color="#4E9A06">INFO</font>:     Waiting for application startup.
+<font color="#4E9A06">INFO</font>:     Application startup complete.
+</pre>
 ```
 
 </div>
 
-That will install both Uvicorn with the `standard` extra packages (to get high performance) and Gunicorn.
+////
 
-## Run Gunicorn with Uvicorn Workers
+//// tab | `uvicorn`
 
-Then you can run Gunicorn with:
-
-<div class="termy">
-
-```console
-$ gunicorn main:app --workers 4 --worker-class uvicorn.workers.UvicornWorker --bind 0.0.0.0:80
-
-[19499] [INFO] Starting gunicorn 20.1.0
-[19499] [INFO] Listening at: http://0.0.0.0:80 (19499)
-[19499] [INFO] Using worker: uvicorn.workers.UvicornWorker
-[19511] [INFO] Booting worker with pid: 19511
-[19513] [INFO] Booting worker with pid: 19513
-[19514] [INFO] Booting worker with pid: 19514
-[19515] [INFO] Booting worker with pid: 19515
-[19511] [INFO] Started server process [19511]
-[19511] [INFO] Waiting for application startup.
-[19511] [INFO] Application startup complete.
-[19513] [INFO] Started server process [19513]
-[19513] [INFO] Waiting for application startup.
-[19513] [INFO] Application startup complete.
-[19514] [INFO] Started server process [19514]
-[19514] [INFO] Waiting for application startup.
-[19514] [INFO] Application startup complete.
-[19515] [INFO] Started server process [19515]
-[19515] [INFO] Waiting for application startup.
-[19515] [INFO] Application startup complete.
-```
-
-</div>
-
-Let's see what each of those options mean:
-
-* `main:app`: This is the same syntax used by Uvicorn, `main` means the Python module named "`main`", so, a file `main.py`. And `app` is the name of the variable that is the **FastAPI** application.
-    * You can imagine that `main:app` is equivalent to a Python `import` statement like:
-
-        ```Python
-        from main import app
-        ```
-
-    * So, the colon in `main:app` would be equivalent to the Python `import` part in `from main import app`.
-
-* `--workers`: The number of worker processes to use, each will run a Uvicorn worker, in this case, 4 workers.
-
-* `--worker-class`: The Gunicorn-compatible worker class to use in the worker processes.
-    * Here we pass the class that Gunicorn can import and use with:
-
-        ```Python
-        import uvicorn.workers.UvicornWorker
-        ```
-
-* `--bind`: This tells Gunicorn the IP and the port to listen to, using a colon (`:`) to separate the IP and the port.
-    * If you were running Uvicorn directly, instead of `--bind 0.0.0.0:80` (the Gunicorn option) you would use `--host 0.0.0.0` and `--port 80`.
-
-In the output, you can see that it shows the **PID** (process ID) of each process (it's just a number).
-
-You can see that:
-
-* The Gunicorn **process manager** starts with PID `19499` (in your case it will be a different number).
-* Then it starts `Listening at: http://0.0.0.0:80`.
-* Then it detects that it has to use the worker class at `uvicorn.workers.UvicornWorker`.
-* And then it starts **4 workers**, each with its own PID: `19511`, `19513`, `19514`, and `19515`.
-
-Gunicorn would also take care of managing **dead processes** and **restarting** new ones if needed to keep the number of workers. So that helps in part with the **restart** concept from the list above.
-
-Nevertheless, you would probably also want to have something outside making sure to **restart Gunicorn** if necessary, and also to **run it on startup**, etc.
-
-## Uvicorn with Workers
-
-Uvicorn also has an option to start and run several **worker processes**.
-
-Nevertheless, as of now, Uvicorn's capabilities for handling worker processes are more limited than Gunicorn's. So, if you want to have a process manager at this level (at the Python level), then it might be better to try with Gunicorn as the process manager.
-
-In any case, you would run it like this:
+If you prefer to use the `uvicorn` command directly:
 
 <div class="termy">
 
@@ -151,13 +118,15 @@ $ uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4
 
 </div>
 
+////
+
 The only new option here is `--workers` telling Uvicorn to start 4 worker processes.
 
 You can also see that it shows the **PID** of each process, `27365` for the parent process (this is the **process manager**) and one for each worker process: `27368`, `27369`, `27370`, and `27367`.
 
 ## Deployment Concepts
 
-Here you saw how to use **Gunicorn** (or Uvicorn) managing **Uvicorn worker processes** to **parallelize** the execution of the application, take advantage of **multiple cores** in the CPU, and be able to serve **more requests**.
+Here you saw how to use multiple **workers** to **parallelize** the execution of the application, take advantage of **multiple cores** in the CPU, and be able to serve **more requests**.
 
 From the list of deployment concepts from above, using workers would mainly help with the **replication** part, and a little bit with the **restarts**, but you still need to take care of the others:
 
@@ -172,13 +141,11 @@ From the list of deployment concepts from above, using workers would mainly help
 
 In the next chapter about [FastAPI in Containers - Docker](docker.md){.internal-link target=_blank} I'll tell some strategies you could use to handle the other **deployment concepts**.
 
-I'll also show you the **official Docker image** that includes **Gunicorn with Uvicorn workers** and some default configurations that can be useful for simple cases.
-
-There I'll also show you how to **build your own image from scratch** to run a single Uvicorn process (without Gunicorn). It is a simple process and is probably what you would want to do when using a distributed container management system like **Kubernetes**.
+I'll show you how to **build your own image from scratch** to run a single Uvicorn process. It is a simple process and is probably what you would want to do when using a distributed container management system like **Kubernetes**.
 
 ## Recap
 
-You can use **Gunicorn** (or also Uvicorn) as a process manager with Uvicorn workers to take advantage of **multi-core CPUs**, to run **multiple processes in parallel**.
+You can use multiple worker processes with the `--workers` CLI option with the `fastapi` or `uvicorn` commands to take advantage of **multi-core CPUs**, to run **multiple processes in parallel**.
 
 You could use these tools and ideas if you are setting up **your own deployment system** while taking care of the other deployment concepts yourself.
 
diff --git a/docs/en/docs/deployment/versions.md b/docs/en/docs/deployment/versions.md
index e387d5712..23f49cf99 100644
--- a/docs/en/docs/deployment/versions.md
+++ b/docs/en/docs/deployment/versions.md
@@ -30,7 +30,7 @@ fastapi[standard]>=0.112.0,<0.113.0
 
 that would mean that you would use the versions `0.112.0` or above, but less than `0.113.0`, for example, a version `0.112.2` would still be accepted.
 
-If you use any other tool to manage your installations, like Poetry, Pipenv, or others, they all have a way that you can use to define specific versions for your packages.
+If you use any other tool to manage your installations, like `uv`, Poetry, Pipenv, or others, they all have a way that you can use to define specific versions for your packages.
 
 ## Available versions
 
diff --git a/docs/en/docs/tutorial/bigger-applications.md b/docs/en/docs/tutorial/bigger-applications.md
index 230f9c08c..1c33fd051 100644
--- a/docs/en/docs/tutorial/bigger-applications.md
+++ b/docs/en/docs/tutorial/bigger-applications.md
@@ -519,12 +519,12 @@ As we cannot just isolate them and "mount" them independently of the rest, the *
 
 ## Check the automatic API docs
 
-Now, run `uvicorn`, using the module `app.main` and the variable `app`:
+Now, run your app:
 
 <div class="termy">
 
 ```console
-$ uvicorn app.main:app --reload
+$ fastapi dev app/main.py
 
 <span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
 ```

From 3a96938771c67a9cc343a38b143f55b618817bd3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 25 Aug 2024 02:44:27 +0000
Subject: [PATCH 023/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ac8f16f53..b5b3188ef 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* 📝 Update docs about serving FastAPI: ASGI servers, Docker containers, etc.. PR [#12069](https://github.com/fastapi/fastapi/pull/12069) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Clarify `response_class` parameter, validations, and returning a response directly. PR [#12067](https://github.com/fastapi/fastapi/pull/12067) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Fix minor typos and issues in the documentation. PR [#12063](https://github.com/fastapi/fastapi/pull/12063) by [@svlandeg](https://github.com/svlandeg).
 * 📝 Add note in Docker docs about ensuring graceful shutdowns and lifespan events with `CMD` exec form. PR [#11960](https://github.com/fastapi/fastapi/pull/11960) by [@GPla](https://github.com/GPla).

From 5fdbeed7928231a249d479c0c266f83877cafce6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 25 Aug 2024 21:14:56 -0500
Subject: [PATCH 024/146] =?UTF-8?q?=F0=9F=91=B7=20Update=20`latest-changes?=
 =?UTF-8?q?`=20GitHub=20Action=20(#12073)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/latest-changes.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.github/workflows/latest-changes.yml b/.github/workflows/latest-changes.yml
index 27e062d09..16da3bc63 100644
--- a/.github/workflows/latest-changes.yml
+++ b/.github/workflows/latest-changes.yml
@@ -34,8 +34,7 @@ jobs:
         if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
         with:
           limit-access-to-actor: true
-      - uses: docker://tiangolo/latest-changes:0.3.0
-      # - uses: tiangolo/latest-changes@main
+      - uses: tiangolo/latest-changes@0.3.1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           latest_changes_file: docs/en/docs/release-notes.md

From 9416e89bd7e3491157f8c962012aebd7be7ed5d6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 26 Aug 2024 02:15:38 +0000
Subject: [PATCH 025/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b5b3188ef..1dff0bddc 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,10 @@ hide:
 * 📝 Fix minor typos and issues in the documentation. PR [#12063](https://github.com/fastapi/fastapi/pull/12063) by [@svlandeg](https://github.com/svlandeg).
 * 📝 Add note in Docker docs about ensuring graceful shutdowns and lifespan events with `CMD` exec form. PR [#11960](https://github.com/fastapi/fastapi/pull/11960) by [@GPla](https://github.com/GPla).
 
+### Internal
+
+* 👷 Update `latest-changes` GitHub Action. PR [#12073](https://github.com/fastapi/fastapi/pull/12073) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.112.2
 
 ### Fixes

From f41f6234af886914ebd3022faad80bb6320bb1bf Mon Sep 17 00:00:00 2001
From: lkw123 <2020393267@qq.com>
Date: Wed, 28 Aug 2024 21:48:13 +0800
Subject: [PATCH 026/146] =?UTF-8?q?=F0=9F=8C=90=20Update=20Chinese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/zh/docs/how-to/index.md`=20(#12070)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/zh/docs/how-to/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/zh/docs/how-to/index.md b/docs/zh/docs/how-to/index.md
index 262dcfaee..ac097618b 100644
--- a/docs/zh/docs/how-to/index.md
+++ b/docs/zh/docs/how-to/index.md
@@ -6,7 +6,7 @@
 
 如果某些内容看起来对你的项目有用，请继续查阅，否则请直接跳过它们。
 
-/// 小技巧
+/// tip | 小技巧
 
 如果你想以系统的方式**学习 FastAPI**（推荐），请阅读 [教程 - 用户指南](../tutorial/index.md){.internal-link target=_blank} 的每一章节。
 

From be9abcf35315cff34d30e86ce7d2deec3e3df9be Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 28 Aug 2024 13:48:40 +0000
Subject: [PATCH 027/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1dff0bddc..20caacd64 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,10 @@ hide:
 * 📝 Fix minor typos and issues in the documentation. PR [#12063](https://github.com/fastapi/fastapi/pull/12063) by [@svlandeg](https://github.com/svlandeg).
 * 📝 Add note in Docker docs about ensuring graceful shutdowns and lifespan events with `CMD` exec form. PR [#11960](https://github.com/fastapi/fastapi/pull/11960) by [@GPla](https://github.com/GPla).
 
+### Translations
+
+* 🌐 Update Chinese translation for `docs/zh/docs/how-to/index.md`. PR [#12070](https://github.com/fastapi/fastapi/pull/12070) by [@synthpop123](https://github.com/synthpop123).
+
 ### Internal
 
 * 👷 Update `latest-changes` GitHub Action. PR [#12073](https://github.com/fastapi/fastapi/pull/12073) by [@tiangolo](https://github.com/tiangolo).

From 4909e44a7ff9b7048f7e6db8c7ad72283fd6a30d Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Wed, 28 Aug 2024 09:07:00 -0500
Subject: [PATCH 028/146] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
 =?UTF-8?q?t=20autoupdate=20(#12076)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.1 → v0.6.2](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.1...v0.6.2)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 .pre-commit-config.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 7532f21b5..317514062 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -14,7 +14,7 @@ repos:
     -   id: end-of-file-fixer
     -   id: trailing-whitespace
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.1
+    rev: v0.6.2
     hooks:
     -   id: ruff
         args:

From 48bf0db58fb5008c78d758d830e0d58f34edfb62 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 28 Aug 2024 14:07:23 +0000
Subject: [PATCH 029/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 20caacd64..baf25d451 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -20,6 +20,7 @@ hide:
 
 ### Internal
 
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12076](https://github.com/fastapi/fastapi/pull/12076) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
 * 👷 Update `latest-changes` GitHub Action. PR [#12073](https://github.com/fastapi/fastapi/pull/12073) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.112.2

From cabed9efb6a6b615f3bf45e9e523ff290f252f0f Mon Sep 17 00:00:00 2001
From: Alec Gillis <alec.gillis@quorum.us>
Date: Wed, 28 Aug 2024 16:33:37 -0700
Subject: [PATCH 030/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20comma=20in=20`d?=
 =?UTF-8?q?ocs/en/docs/async.md`=20(#12062)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Alec Gillis <alecgillis@quorum.us>
Co-authored-by: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
---
 docs/en/docs/async.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/async.md b/docs/en/docs/async.md
index 752a5c247..63bd8ca68 100644
--- a/docs/en/docs/async.md
+++ b/docs/en/docs/async.md
@@ -387,7 +387,7 @@ In previous versions of NodeJS / Browser JavaScript, you would have used "callba
 
 ## Coroutines
 
-**Coroutine** is just the very fancy term for the thing returned by an `async def` function. Python knows that it is something like a function that it can start and that it will end at some point, but that it might be paused ⏸ internally too, whenever there is an `await` inside of it.
+**Coroutine** is just the very fancy term for the thing returned by an `async def` function. Python knows that it is something like a function, that it can start and that it will end at some point, but that it might be paused ⏸ internally too, whenever there is an `await` inside of it.
 
 But all this functionality of using asynchronous code with `async` and `await` is many times summarized as using "coroutines". It is comparable to the main key feature of Go, the "Goroutines".
 

From a930128910f65e53bdff76f4e52f484e5129f60b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 28 Aug 2024 23:35:03 +0000
Subject: [PATCH 031/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index baf25d451..838516421 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* 📝 Update comma in `docs/en/docs/async.md`. PR [#12062](https://github.com/fastapi/fastapi/pull/12062) by [@Alec-Gillis](https://github.com/Alec-Gillis).
 * 📝 Update docs about serving FastAPI: ASGI servers, Docker containers, etc.. PR [#12069](https://github.com/fastapi/fastapi/pull/12069) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Clarify `response_class` parameter, validations, and returning a response directly. PR [#12067](https://github.com/fastapi/fastapi/pull/12067) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Fix minor typos and issues in the documentation. PR [#12063](https://github.com/fastapi/fastapi/pull/12063) by [@svlandeg](https://github.com/svlandeg).

From 9b35d355bfb44c33000359a2b24f215286996693 Mon Sep 17 00:00:00 2001
From: Muhammad Ashiq Ameer
 <46787072+MuhammadAshiqAmeer@users.noreply.github.com>
Date: Thu, 29 Aug 2024 05:09:15 +0530
Subject: [PATCH 032/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20`docs=5Fsrc/pat?=
 =?UTF-8?q?h=5Fparams=5Fnumeric=5Fvalidations/tutorial006.py`=20(#11478)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
---
 docs_src/path_params_numeric_validations/tutorial006.py         | 2 ++
 docs_src/path_params_numeric_validations/tutorial006_an.py      | 2 ++
 docs_src/path_params_numeric_validations/tutorial006_an_py39.py | 2 ++
 3 files changed, 6 insertions(+)

diff --git a/docs_src/path_params_numeric_validations/tutorial006.py b/docs_src/path_params_numeric_validations/tutorial006.py
index 0ea32694a..f07629aa0 100644
--- a/docs_src/path_params_numeric_validations/tutorial006.py
+++ b/docs_src/path_params_numeric_validations/tutorial006.py
@@ -13,4 +13,6 @@ async def read_items(
     results = {"item_id": item_id}
     if q:
         results.update({"q": q})
+    if size:
+        results.update({"size": size})
     return results
diff --git a/docs_src/path_params_numeric_validations/tutorial006_an.py b/docs_src/path_params_numeric_validations/tutorial006_an.py
index 22a143623..ac4732573 100644
--- a/docs_src/path_params_numeric_validations/tutorial006_an.py
+++ b/docs_src/path_params_numeric_validations/tutorial006_an.py
@@ -14,4 +14,6 @@ async def read_items(
     results = {"item_id": item_id}
     if q:
         results.update({"q": q})
+    if size:
+        results.update({"size": size})
     return results
diff --git a/docs_src/path_params_numeric_validations/tutorial006_an_py39.py b/docs_src/path_params_numeric_validations/tutorial006_an_py39.py
index 804751893..426ec3776 100644
--- a/docs_src/path_params_numeric_validations/tutorial006_an_py39.py
+++ b/docs_src/path_params_numeric_validations/tutorial006_an_py39.py
@@ -15,4 +15,6 @@ async def read_items(
     results = {"item_id": item_id}
     if q:
         results.update({"q": q})
+    if size:
+        results.update({"size": size})
     return results

From 33328952518b78ed40d5f58cf21f3e40e48f6615 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 28 Aug 2024 23:40:13 +0000
Subject: [PATCH 033/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 838516421..34a3fbc57 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* 📝 Update `docs_src/path_params_numeric_validations/tutorial006.py`. PR [#11478](https://github.com/fastapi/fastapi/pull/11478) by [@MuhammadAshiqAmeer](https://github.com/MuhammadAshiqAmeer).
 * 📝 Update comma in `docs/en/docs/async.md`. PR [#12062](https://github.com/fastapi/fastapi/pull/12062) by [@Alec-Gillis](https://github.com/Alec-Gillis).
 * 📝 Update docs about serving FastAPI: ASGI servers, Docker containers, etc.. PR [#12069](https://github.com/fastapi/fastapi/pull/12069) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Clarify `response_class` parameter, validations, and returning a response directly. PR [#12067](https://github.com/fastapi/fastapi/pull/12067) by [@tiangolo](https://github.com/tiangolo).

From ae27540348d943e786e83176a8fc32d535baece7 Mon Sep 17 00:00:00 2001
From: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
Date: Thu, 29 Aug 2024 01:41:46 +0200
Subject: [PATCH 034/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Dutch=20translatio?=
 =?UTF-8?q?n=20for=20`docs/nl/docs/index.md`=20(#12042)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Max Scheijen <maxscheijen@gmail.com>
---
 docs/en/mkdocs.yml    |   2 +
 docs/nl/docs/index.md | 494 ++++++++++++++++++++++++++++++++++++++++++
 docs/nl/mkdocs.yml    |   1 +
 3 files changed, 497 insertions(+)
 create mode 100644 docs/nl/docs/index.md
 create mode 100644 docs/nl/mkdocs.yml

diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 6f1e12511..528c80b8e 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -363,6 +363,8 @@ extra:
     name: ja - 日本語
   - link: /ko/
     name: ko - 한국어
+  - link: /nl/
+    name: nl - Nederlands
   - link: /pl/
     name: pl - Polski
   - link: /pt/
diff --git a/docs/nl/docs/index.md b/docs/nl/docs/index.md
new file mode 100644
index 000000000..8edc3ba0c
--- /dev/null
+++ b/docs/nl/docs/index.md
@@ -0,0 +1,494 @@
+# FastAPI
+
+<style>
+.md-content .md-typeset h1 { display: none; }
+</style>
+
+<p align="center">
+  <a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a>
+</p>
+<p align="center">
+    <em>FastAPI framework, zeer goede prestaties, eenvoudig te leren, snel te programmeren, klaar voor productie</em>
+</p>
+<p align="center">
+<a href="https://github.com/fastapi/fastapi/actions?query=workflow%3ATest+event%3Apush+branch%3Amaster" target="_blank">
+    <img src="https://github.com/fastapi/fastapi/workflows/Test/badge.svg?event=push&branch=master" alt="Test">
+</a>
+<a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/fastapi/fastapi" target="_blank">
+    <img src="https://coverage-badge.samuelcolvin.workers.dev/fastapi/fastapi.svg" alt="Coverage">
+</a>
+<a href="https://pypi.org/project/fastapi" target="_blank">
+    <img src="https://img.shields.io/pypi/v/fastapi?color=%2334D058&label=pypi%20package" alt="Package version">
+</a>
+<a href="https://pypi.org/project/fastapi" target="_blank">
+    <img src="https://img.shields.io/pypi/pyversions/fastapi.svg?color=%2334D058" alt="Supported Python versions">
+</a>
+</p>
+
+---
+
+**Documentatie**: <a href="https://fastapi.tiangolo.com" target="_blank">https://fastapi.tiangolo.com</a>
+
+**Broncode**: <a href="https://github.com/fastapi/fastapi" target="_blank">https://github.com/tiangolo/fastapi</a>
+
+---
+
+FastAPI is een modern, snel (zeer goede prestaties), web framework voor het bouwen van API's in Python, gebruikmakend van standaard Python type-hints.
+
+De belangrijkste kenmerken zijn:
+
+* **Snel**: Zeer goede prestaties, vergelijkbaar met **NodeJS** en **Go** (dankzij Starlette en Pydantic). [Een van de snelste beschikbare Python frameworks](#prestaties).
+* **Snel te programmeren**: Verhoog de snelheid om functionaliteit te ontwikkelen met ongeveer 200% tot 300%. *
+* **Minder bugs**: Verminder ongeveer 40% van de door mensen (ontwikkelaars) veroorzaakte fouten. *
+* **Intuïtief**: Buitengewoon goede ondersteuning voor editors. <abbr title="ook bekend als automatisch aanvullen, automatisch aanvullen, IntelliSense">Overal automische code aanvulling</abbr>. Minder tijd kwijt aan debuggen.
+* **Eenvoudig**: Ontworpen om gemakkelijk te gebruiken en te leren. Minder tijd nodig om documentatie te lezen.
+* **Kort**: Minimaliseer codeduplicatie. Elke parameterdeclaratie ondersteunt meerdere functionaliteiten. Minder bugs.
+* **Robust**: Code gereed voor productie. Met automatische interactieve documentatie.
+* **Standards-based**: Gebaseerd op (en volledig verenigbaar met) open standaarden voor API's: <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a> (voorheen bekend als Swagger) en <a href="https://json-schema.org/" class="external-link" target="_blank">JSON Schema</a>.
+
+<small>* schatting op basis van testen met een intern ontwikkelteam en bouwen van productieapplicaties.</small>
+
+## Sponsors
+
+<!-- sponsors -->
+
+{% if sponsors %}
+{% for sponsor in sponsors.gold -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor -%}
+{%- for sponsor in sponsors.silver -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+<!-- /sponsors -->
+
+<a href="https://fastapi.tiangolo.com/fastapi-people/#sponsors" class="external-link" target="_blank">Overige sponsoren</a>
+
+## Meningen
+
+"_[...] Ik gebruik **FastAPI** heel vaak tegenwoordig. [...] Ik ben van plan om het te gebruiken voor alle **ML-services van mijn team bij Microsoft**. Sommige van deze worden geïntegreerd in het kernproduct van **Windows** en sommige **Office**-producten._"
+
+<div style="text-align: right; margin-right: 10%;">Kabir Khan - <strong>Microsoft</strong> <a href="https://github.com/fastapi/fastapi/pull/26" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_We hebben de **FastAPI** library gebruikt om een **REST** server te maken die bevraagd kan worden om **voorspellingen** te maken. [voor Ludwig]_"
+
+<div style="text-align: right; margin-right: 10%;">Piero Molino, Yaroslav Dudin en Sai Sumanth Miryala - <strong>Uber</strong> <a href="https://eng.uber.com/ludwig-v0-2/" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_**Netflix** is verheugd om een open-source release aan te kondigen van ons **crisismanagement**-orkestratieframework: **Dispatch**! [gebouwd met **FastAPI**]_"
+
+<div style="text-align: right; margin-right: 10%;">Kevin Glisson, Marc Vilanova, Forest Monsen - <strong>Netflix</strong> <a href="https://netflixtechblog.com/introducing-dispatch-da4b8a2a8072" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Ik ben super enthousiast over **FastAPI**. Het is zo leuk!_"
+
+<div style="text-align: right; margin-right: 10%;">Brian Okken - <strong><a href="https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855" target="_blank">Python Bytes</a> podcast presentator</strong> <a href="https://twitter.com/brianokken/status/1112220079972728832" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Wat je hebt gebouwd ziet er echt super solide en gepolijst uit. In veel opzichten is het wat ik wilde dat **Hug** kon zijn - het is echt inspirerend om iemand dit te zien bouwen._"
+
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"Wie geïnteresseerd is in een **modern framework** voor het bouwen van REST API's, bekijkt best eens **FastAPI** [...] Het is snel, gebruiksvriendelijk en gemakkelijk te leren [...]_"
+
+"_We zijn overgestapt naar **FastAPI** voor onze **API's** [...] Het gaat jou vast ook bevallen [...]_"
+
+<div style="text-align: right; margin-right: 10%;">Ines Montani - Matthew Honnibal - <strong><a href="https://explosion.ai" target="_blank">Explosion AI</a> oprichters - <a href="https://spacy.io" target="_blank">spaCy</a> ontwikkelaars</strong> <a href="https://twitter.com/_inesmontani/status/1144173225322143744" target="_blank"><small>(ref)</small></a> - <a href="https://twitter.com/honnibal/status/1144031421859655680" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Wie een Python API wil bouwen voor productie, kan ik ten stelligste **FastAPI** aanraden. Het is **prachtig ontworpen**, **eenvoudig te gebruiken** en **gemakkelijk schaalbaar**, het is een **cruciale component** geworden in onze strategie om API's centraal te zetten, en het vereenvoudigt automatisering en diensten zoals onze Virtual TAC Engineer._"
+
+<div style="text-align: right; margin-right: 10%;">Deon Pillsbury - <strong>Cisco</strong> <a href="https://www.linkedin.com/posts/deonpillsbury_cisco-cx-python-activity-6963242628536487936-trAp/" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+## **Typer**, de FastAPI van CLIs
+
+<a href="https://typer.tiangolo.com" target="_blank"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style="width: 20%;"></a>
+
+Als je een <abbr title="Command Line Interface">CLI</abbr>-app bouwt die in de terminal moet worden gebruikt in plaats van een web-API, gebruik dan <a href="https://typer.tiangolo.com/ " class="external-link" target="_blank">**Typer**</a>.
+
+**Typer** is het kleine broertje van FastAPI. En het is bedoeld als de **FastAPI van CLI's**. ️
+
+## Vereisten
+
+FastAPI staat op de schouders van reuzen:
+
+* <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a> voor de webonderdelen.
+* <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a> voor de datadelen.
+
+## Installatie
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[standard]"
+
+---> 100%
+```
+
+</div>
+
+**Opmerking**: Zet `"fastapi[standard]"` tussen aanhalingstekens om ervoor te zorgen dat het werkt in alle terminals.
+
+## Voorbeeld
+
+### Creëer het
+
+* Maak het bestand `main.py` aan met daarin:
+
+```Python
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+<details markdown="1">
+<summary>Of maak gebruik van <code>async def</code>...</summary>
+
+Als je code gebruik maakt van `async` / `await`, gebruik dan `async def`:
+
+```Python hl_lines="9  14"
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+async def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+**Opmerking**:
+
+Als je het niet weet, kijk dan in het gedeelte _"Heb je haast?"_ over <a href="https://fastapi.tiangolo.com/async/#in-a-hurry" target="_blank">`async` en `await` in de documentatie</a>.
+
+</details>
+
+### Voer het uit
+
+Run de server met:
+
+<div class="termy">
+
+```console
+$ fastapi dev main.py
+
+ ╭────────── FastAPI CLI - Development mode ───────────╮
+ │                                                     │
+ │  Serving at: http://127.0.0.1:8000                  │
+ │                                                     │
+ │  API docs: http://127.0.0.1:8000/docs               │
+ │                                                     │
+ │  Running in development mode, for production use:   │
+ │                                                     │
+ │  fastapi run                                        │
+ │                                                     │
+ ╰─────────────────────────────────────────────────────╯
+
+INFO:     Will watch for changes in these directories: ['/home/user/code/awesomeapp']
+INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+INFO:     Started reloader process [2248755] using WatchFiles
+INFO:     Started server process [2248757]
+INFO:     Waiting for application startup.
+INFO:     Application startup complete.
+```
+
+</div>
+
+<details markdown="1">
+<summary>Over het commando <code>fastapi dev main.py</code>...</summary>
+
+Het commando `fastapi dev` leest het `main.py` bestand, detecteert de **FastAPI** app, en start een server met <a href="https://www.uvicorn.org" class="external-link" target="_blank">Uvicorn</a>.
+
+Standaard zal dit commando `fastapi dev` starten met "auto-reload" geactiveerd voor ontwikkeling op het lokale systeem.
+
+Je kan hier meer over lezen in de <a href="https://fastapi.tiangolo.com/fastapi-cli/" target="_blank">FastAPI CLI documentatie</a>.
+
+</details>
+
+### Controleer het
+
+Open je browser op <a href="http://127.0.0.1:8000/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1:8000/items/5?q=somequery</a>.
+
+Je zult een JSON response zien:
+
+```JSON
+{"item_id": 5, "q": "somequery"}
+```
+
+Je hebt een API gemaakt die:
+
+* HTTP verzoeken kan ontvangen op de _paden_ `/` en `/items/{item_id}`.
+* Beide _paden_ hebben `GET` <em>operaties</em> (ook bekend als HTTP _methoden_).
+* Het _pad_ `/items/{item_id}` heeft een _pad parameter_ `item_id` dat een `int` moet zijn.
+* Het _pad_ `/items/{item_id}` heeft een optionele `str` _query parameter_ `q`.
+
+### Interactieve API documentatie
+
+Ga naar <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+Je ziet de automatische interactieve API documentatie (verstrekt door <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>):
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
+
+### Alternatieve API documentatie
+
+Ga vervolgens naar <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+Je ziet de automatische interactieve API documentatie (verstrekt door <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>):
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
+
+## Voorbeeld upgrade
+
+Pas nu het bestand `main.py` aan om de body van een `PUT` request te ontvangen.
+
+Dankzij Pydantic kunnen we de body declareren met standaard Python types.
+
+```Python hl_lines="4  9-12  25-27"
+from typing import Union
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    price: float
+    is_offer: Union[bool, None] = None
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+
+
+@app.put("/items/{item_id}")
+def update_item(item_id: int, item: Item):
+    return {"item_name": item.name, "item_id": item_id}
+```
+
+De `fastapi dev` server zou automatisch moeten herladen.
+
+### Interactieve API documentatie upgrade
+
+Ga nu naar <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+* De interactieve API-documentatie wordt automatisch bijgewerkt, inclusief de nieuwe body:
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png)
+
+* Klik op de knop "Try it out", hiermee kan je de parameters invullen en direct met de API interacteren:
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-04-swagger-03.png)
+
+* Klik vervolgens op de knop "Execute", de gebruikersinterface zal communiceren met jouw API, de parameters verzenden, de resultaten ophalen en deze op het scherm tonen:
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-05-swagger-04.png)
+
+### Alternatieve API documentatie upgrade
+
+Ga vervolgens naar <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+* De alternatieve documentatie zal ook de nieuwe queryparameter en body weergeven:
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png)
+
+### Samenvatting
+
+Samengevat declareer je **eenmalig** de types van parameters, body, etc. als functieparameters.
+
+Dat doe je met standaard moderne Python types.
+
+Je hoeft geen nieuwe syntax te leren, de methods of klassen van een specifieke bibliotheek, etc.
+
+Gewoon standaard **Python**.
+
+Bijvoorbeeld, voor een `int`:
+
+```Python
+item_id: int
+```
+
+of voor een complexer `Item` model:
+
+```Python
+item: Item
+```
+
+...en met die ene verklaring krijg je:
+
+* Editor ondersteuning, inclusief:
+    * Code aanvulling.
+    * Type validatie.
+* Validatie van data:
+    * Automatische en duidelijke foutboodschappen wanneer de data ongeldig is.
+    * Validatie zelfs voor diep geneste JSON objecten.
+* <abbr title="ook bekend als: serialisatie, parsing, marshalling">Conversie</abbr> van invoergegevens: afkomstig van het netwerk naar Python-data en -types. Zoals:
+    * JSON.
+    * Pad parameters.
+    * Query parameters.
+    * Cookies.
+    * Headers.
+    * Formulieren.
+    * Bestanden.
+* <abbr title="ook bekend als: serialisatie, parsing, marshalling">Conversie</abbr> van uitvoergegevens: converstie van Python-data en -types naar netwerkgegevens (zoals JSON):
+    * Converteer Python types (`str`, `int`, `float`, `bool`, `list`, etc).
+    * `datetime` objecten.
+    * `UUID` objecten.
+    * Database modellen.
+    * ...en nog veel meer.
+* Automatische interactieve API-documentatie, inclusief 2 alternatieve gebruikersinterfaces:
+    * Swagger UI.
+    * ReDoc.
+
+---
+
+Terugkomend op het vorige code voorbeeld, **FastAPI** zal:
+
+* Valideren dat er een `item_id` bestaat in het pad voor `GET` en `PUT` verzoeken.
+* Valideren dat het `item_id` van het type `int` is voor `GET` en `PUT` verzoeken.
+    * Wanneer dat niet het geval is, krijgt de cliënt een nuttige, duidelijke foutmelding.
+* Controleren of er een optionele query parameter is met de naam `q` (zoals in `http://127.0.0.1:8000/items/foo?q=somequery`) voor `GET` verzoeken.
+    * Aangezien de `q` parameter werd gedeclareerd met `= None`, is deze optioneel.
+    * Zonder de `None` declaratie zou deze verplicht zijn (net als bij de body in het geval met `PUT`).
+* Voor `PUT` verzoeken naar `/items/{item_id}`, lees de body als JSON:
+    * Controleer of het een verplicht attribuut `naam` heeft en dat dat een `str` is.
+    * Controleer of het een verplicht attribuut `price` heeft en dat dat een`float` is.
+    * Controleer of het een optioneel attribuut `is_offer` heeft, dat een `bool` is wanneer het aanwezig is.
+    * Dit alles werkt ook voor diep geneste JSON objecten.
+* Converteer automatisch van en naar JSON.
+* Documenteer alles met OpenAPI, dat gebruikt kan worden door:
+    * Interactieve documentatiesystemen.
+    * Automatische client code generatie systemen, voor vele talen.
+* Biedt 2 interactieve documentatie-webinterfaces aan.
+
+---
+
+Dit was nog maar een snel overzicht, maar je zou nu toch al een idee moeten hebben over hoe het allemaal werkt.
+
+Probeer deze regel te veranderen:
+
+```Python
+    return {"item_name": item.name, "item_id": item_id}
+```
+
+...van:
+
+```Python
+        ... "item_name": item.name ...
+```
+
+...naar:
+
+```Python
+        ... "item_price": item.price ...
+```
+
+...en zie hoe je editor de attributen automatisch invult en hun types herkent:
+
+![editor support](https://fastapi.tiangolo.com/img/vscode-completion.png)
+
+Voor een vollediger voorbeeld met meer mogelijkheden, zie de <a href="https://fastapi.tiangolo.com/tutorial/">Tutorial - Gebruikershandleiding</a>.
+
+**Spoiler alert**: de tutorial - gebruikershandleiding bevat:
+
+* Declaratie van **parameters** op andere plaatsen zoals: **headers**, **cookies**, **formuliervelden** en **bestanden**.
+* Hoe stel je **validatie restricties** in zoals `maximum_length` of een `regex`.
+* Een zeer krachtig en eenvoudig te gebruiken **<abbr title="ook bekend als componenten, middelen, verstrekkers, diensten, injectables">Dependency Injection</abbr>** systeem.
+* Beveiliging en authenticatie, inclusief ondersteuning voor **OAuth2** met **JWT-tokens** en **HTTP Basic** auth.
+* Meer geavanceerde (maar even eenvoudige) technieken voor het declareren van **diep geneste JSON modellen** (dankzij Pydantic).
+* **GraphQL** integratie met <a href="https://strawberry.rocks" class="external-link" target="_blank">Strawberry</a> en andere packages.
+* Veel extra functies (dankzij Starlette) zoals:
+    * **WebSockets**
+    * uiterst gemakkelijke tests gebaseerd op HTTPX en `pytest`
+    * **CORS**
+    * **Cookie Sessions**
+    * ...en meer.
+
+## Prestaties
+
+Onafhankelijke TechEmpower benchmarks tonen **FastAPI** applicaties draaiend onder Uvicorn aan als <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank">een van de snelste Python frameworks beschikbaar</a>, alleen onder Starlette en Uvicorn zelf (intern gebruikt door FastAPI). (*)
+
+Zie de sectie <a href="https://fastapi.tiangolo.com/benchmarks/" class="internal-link" target="_blank">Benchmarks</a> om hier meer over te lezen.
+
+## Afhankelijkheden
+
+FastAPI maakt gebruik van Pydantic en Starlette.
+
+### `standard` Afhankelijkheden
+
+Wanneer je FastAPI installeert met `pip install "fastapi[standard]"`, worden de volgende `standard` optionele afhankelijkheden geïnstalleerd:
+
+Gebruikt door Pydantic:
+
+* <a href="https://github.com/JoshData/python-email-validator" target="_blank"><code>email_validator</code></a> - voor email validatie.
+
+Gebruikt door Starlette:
+
+* <a href="https://www.python-httpx.org" target="_blank"><code>httpx</code></a> - Vereist indien je de `TestClient` wil gebruiken.
+* <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Vereist als je de standaard templateconfiguratie wil gebruiken.
+* <a href="https://github.com/Kludex/python-multipart" target="_blank"><code>python-multipart</code></a> - Vereist indien je <abbr title="het omzetten van de string die uit een HTTP verzoek komt in Python data">"parsen"</abbr> van formulieren wil ondersteunen met `requests.form()`.
+
+Gebruikt door FastAPI / Starlette:
+
+* <a href="https://www.uvicorn.org" target="_blank"><code>uvicorn</code></a> - voor de server die jouw applicatie laadt en bedient.
+* `fastapi-cli` - om het `fastapi` commando te voorzien.
+
+### Zonder `standard` Afhankelijkheden
+
+Indien je de optionele `standard` afhankelijkheden niet wenst te installeren, kan je installeren met `pip install fastapi` in plaats van `pip install "fastapi[standard]"`.
+
+### Bijkomende Optionele Afhankelijkheden
+
+Er zijn nog een aantal bijkomende afhankelijkheden die je eventueel kan installeren.
+
+Bijkomende optionele afhankelijkheden voor Pydantic:
+
+* <a href="https://docs.pydantic.dev/latest/usage/pydantic_settings/" target="_blank"><code>pydantic-settings</code></a> - voor het beheren van settings.
+* <a href="https://docs.pydantic.dev/latest/usage/types/extra_types/extra_types/" target="_blank"><code>pydantic-extra-types</code></a> - voor extra data types die gebruikt kunnen worden met Pydantic.
+
+Bijkomende optionele afhankelijkheden voor FastAPI:
+
+* <a href="https://github.com/ijl/orjson" target="_blank"><code>orjson</code></a> - Vereist indien je `ORJSONResponse` wil gebruiken.
+* <a href="https://github.com/esnme/ultrajson" target="_blank"><code>ujson</code></a> - Vereist indien je `UJSONResponse` wil gebruiken.
+
+## Licentie
+
+Dit project is gelicenseerd onder de voorwaarden van de MIT licentie.
diff --git a/docs/nl/mkdocs.yml b/docs/nl/mkdocs.yml
new file mode 100644
index 000000000..de18856f4
--- /dev/null
+++ b/docs/nl/mkdocs.yml
@@ -0,0 +1 @@
+INHERIT: ../en/mkdocs.yml

From ffa6d2eafd8955d3157e77119e07a8b7c09efef2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 28 Aug 2024 23:44:01 +0000
Subject: [PATCH 035/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 34a3fbc57..6cfbe779b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -18,6 +18,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Dutch translation for `docs/nl/docs/index.md`. PR [#12042](https://github.com/fastapi/fastapi/pull/12042) by [@svlandeg](https://github.com/svlandeg).
 * 🌐 Update Chinese translation for `docs/zh/docs/how-to/index.md`. PR [#12070](https://github.com/fastapi/fastapi/pull/12070) by [@synthpop123](https://github.com/synthpop123).
 
 ### Internal

From 4cf3421178d3ecd909cb393f39e52eed5744e44a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 28 Aug 2024 19:01:29 -0500
Subject: [PATCH 036/146] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20rem?=
 =?UTF-8?q?ove=20Kong=20(#12085)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                   | 1 -
 docs/en/data/sponsors.yml   | 3 ---
 docs/en/overrides/main.html | 6 ------
 3 files changed, 10 deletions(-)

diff --git a/README.md b/README.md
index ec7a95497..d8de34e0c 100644
--- a/README.md
+++ b/README.md
@@ -54,7 +54,6 @@ The key features are:
 <a href="https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge" target="_blank" title="Auth, user management and more for your B2B product"><img src="https://fastapi.tiangolo.com/img/sponsors/propelauth.png"></a>
 <a href="https://docs.withcoherence.com/configuration/frameworks/?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs#fastapi-example" target="_blank" title="Coherence"><img src="https://fastapi.tiangolo.com/img/sponsors/coherence.png"></a>
 <a href="https://www.mongodb.com/developer/languages/python/python-quickstart-fastapi/?utm_campaign=fastapi_framework&utm_source=fastapi_sponsorship&utm_medium=web_referral" target="_blank" title="Simplify Full Stack Development with FastAPI & MongoDB"><img src="https://fastapi.tiangolo.com/img/sponsors/mongodb.png"></a>
-<a href="https://konghq.com/products/kong-konnect?utm_medium=referral&utm_source=github&utm_campaign=platform&utm_content=fast-api" target="_blank" title="Kong Konnect - API management platform"><img src="https://fastapi.tiangolo.com/img/sponsors/kong.png"></a>
 <a href="https://zuplo.link/fastapi-gh" target="_blank" title="Zuplo: Scale, Protect, Document, and Monetize your FastAPI"><img src="https://fastapi.tiangolo.com/img/sponsors/zuplo.png"></a>
 <a href="https://fine.dev?ref=fastapibadge" target="_blank" title="Fine's AI FastAPI Workflow: Effortlessly Deploy and Integrate FastAPI into Your Project"><img src="https://fastapi.tiangolo.com/img/sponsors/fine.png"></a>
 <a href="https://liblab.com?utm_source=fastapi" target="_blank" title="liblab - Generate SDKs from FastAPI"><img src="https://fastapi.tiangolo.com/img/sponsors/liblab.png"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 8c0956ac5..76e20638a 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -23,9 +23,6 @@ gold:
   - url: https://www.mongodb.com/developer/languages/python/python-quickstart-fastapi/?utm_campaign=fastapi_framework&utm_source=fastapi_sponsorship&utm_medium=web_referral
     title: Simplify Full Stack Development with FastAPI & MongoDB
     img: https://fastapi.tiangolo.com/img/sponsors/mongodb.png
-  - url: https://konghq.com/products/kong-konnect?utm_medium=referral&utm_source=github&utm_campaign=platform&utm_content=fast-api
-    title: Kong Konnect - API management platform
-    img: https://fastapi.tiangolo.com/img/sponsors/kong.png
   - url: https://zuplo.link/fastapi-gh
     title: 'Zuplo: Scale, Protect, Document, and Monetize your FastAPI'
     img: https://fastapi.tiangolo.com/img/sponsors/zuplo.png
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 229cbca71..851f8e895 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -70,12 +70,6 @@
         <img class="sponsor-image" src="/img/sponsors/mongodb-banner.png" />
       </a>
     </div>
-    <div class="item">
-      <a title="Kong Konnect - API management platform" style="display: block; position: relative;" href="https://konghq.com/products/kong-konnect?utm_medium=referral&utm_source=github&utm_campaign=platform&utm_content=fast-api" target="_blank">
-        <span class="sponsor-badge">sponsor</span>
-        <img class="sponsor-image" src="/img/sponsors/kong-banner.png" />
-      </a>
-    </div>
     <div class="item">
       <a title="Zuplo: Scale, Protect, Document, and Monetize your FastAPI" style="display: block; position: relative;" href="https://zuplo.link/fastapi-web" target="_blank">
         <span class="sponsor-badge">sponsor</span>

From 17a29149e4a40dd756f0eb02a9317229e6b3e718 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 29 Aug 2024 00:02:01 +0000
Subject: [PATCH 037/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6cfbe779b..71e7334ad 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -23,6 +23,7 @@ hide:
 
 ### Internal
 
+* 🔧 Update sponsors, remove Kong. PR [#12085](https://github.com/fastapi/fastapi/pull/12085) by [@tiangolo](https://github.com/tiangolo).
 * ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12076](https://github.com/fastapi/fastapi/pull/12076) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
 * 👷 Update `latest-changes` GitHub Action. PR [#12073](https://github.com/fastapi/fastapi/pull/12073) by [@tiangolo](https://github.com/tiangolo).
 

From 6e98249c2121959b5253cecc1237ee5438f98758 Mon Sep 17 00:00:00 2001
From: Marcin Sulikowski <marcin.k.sulikowski@gmail.com>
Date: Fri, 30 Aug 2024 18:00:41 +0200
Subject: [PATCH 038/146] =?UTF-8?q?=F0=9F=93=9D=20Fix=20async=20test=20exa?=
 =?UTF-8?q?mple=20not=20to=20trigger=20DeprecationWarning=20(#12084)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/de/docs/advanced/async-tests.md | 2 +-
 docs/em/docs/advanced/async-tests.md | 2 +-
 docs/en/docs/advanced/async-tests.md | 2 +-
 docs/pt/docs/advanced/async-tests.md | 2 +-
 docs_src/async_tests/test_main.py    | 6 ++++--
 5 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/docs/de/docs/advanced/async-tests.md b/docs/de/docs/advanced/async-tests.md
index 9f0bd4aa2..e56841faa 100644
--- a/docs/de/docs/advanced/async-tests.md
+++ b/docs/de/docs/advanced/async-tests.md
@@ -72,7 +72,7 @@ Beachten Sie, dass die Testfunktion jetzt `async def` ist und nicht nur `def` wi
 
 Dann können wir einen `AsyncClient` mit der App erstellen und mit `await` asynchrone Requests an ihn senden.
 
-```Python hl_lines="9-10"
+```Python hl_lines="9-12"
 {!../../../docs_src/async_tests/test_main.py!}
 ```
 
diff --git a/docs/em/docs/advanced/async-tests.md b/docs/em/docs/advanced/async-tests.md
index 324b4f68a..11f885fe6 100644
--- a/docs/em/docs/advanced/async-tests.md
+++ b/docs/em/docs/advanced/async-tests.md
@@ -72,7 +72,7 @@ $ pytest
 
 ⤴️ 👥 💪 ✍ `AsyncClient` ⏮️ 📱, &amp; 📨 🔁 📨 ⚫️, ⚙️ `await`.
 
-```Python hl_lines="9-10"
+```Python hl_lines="9-12"
 {!../../../docs_src/async_tests/test_main.py!}
 ```
 
diff --git a/docs/en/docs/advanced/async-tests.md b/docs/en/docs/advanced/async-tests.md
index ac459ff0c..580d9142c 100644
--- a/docs/en/docs/advanced/async-tests.md
+++ b/docs/en/docs/advanced/async-tests.md
@@ -72,7 +72,7 @@ Note that the test function is now `async def` instead of just `def` as before w
 
 Then we can create an `AsyncClient` with the app, and send async requests to it, using `await`.
 
-```Python hl_lines="9-10"
+```Python hl_lines="9-12"
 {!../../../docs_src/async_tests/test_main.py!}
 ```
 
diff --git a/docs/pt/docs/advanced/async-tests.md b/docs/pt/docs/advanced/async-tests.md
index ab5bfa648..7cac26262 100644
--- a/docs/pt/docs/advanced/async-tests.md
+++ b/docs/pt/docs/advanced/async-tests.md
@@ -72,7 +72,7 @@ Note que a função de teste é `async def` agora, no lugar de apenas `def` como
 
 Então podemos criar um `AsyncClient` com a aplicação, e enviar requisições assíncronas para ela utilizando `await`.
 
-```Python hl_lines="9-10"
+```Python hl_lines="9-12"
 {!../../../docs_src/async_tests/test_main.py!}
 ```
 
diff --git a/docs_src/async_tests/test_main.py b/docs_src/async_tests/test_main.py
index 9f1527d5f..a57a31f7d 100644
--- a/docs_src/async_tests/test_main.py
+++ b/docs_src/async_tests/test_main.py
@@ -1,12 +1,14 @@
 import pytest
-from httpx import AsyncClient
+from httpx import ASGITransport, AsyncClient
 
 from .main import app
 
 
 @pytest.mark.anyio
 async def test_root():
-    async with AsyncClient(app=app, base_url="http://test") as ac:
+    async with AsyncClient(
+        transport=ASGITransport(app=app), base_url="http://test"
+    ) as ac:
         response = await ac.get("/")
     assert response.status_code == 200
     assert response.json() == {"message": "Tomato"}

From 4eec14fa8c8870898cfa0416b6ff20a724c0dd30 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 30 Aug 2024 16:01:05 +0000
Subject: [PATCH 039/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 71e7334ad..83080e0aa 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* 📝 Fix async test example not to trigger DeprecationWarning. PR [#12084](https://github.com/fastapi/fastapi/pull/12084) by [@marcinsulikowski](https://github.com/marcinsulikowski).
 * 📝 Update `docs_src/path_params_numeric_validations/tutorial006.py`. PR [#11478](https://github.com/fastapi/fastapi/pull/11478) by [@MuhammadAshiqAmeer](https://github.com/MuhammadAshiqAmeer).
 * 📝 Update comma in `docs/en/docs/async.md`. PR [#12062](https://github.com/fastapi/fastapi/pull/12062) by [@Alec-Gillis](https://github.com/Alec-Gillis).
 * 📝 Update docs about serving FastAPI: ASGI servers, Docker containers, etc.. PR [#12069](https://github.com/fastapi/fastapi/pull/12069) by [@tiangolo](https://github.com/tiangolo).

From 9519380764a371c4c642f969e8f1b82822f7de28 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 30 Aug 2024 18:20:21 +0200
Subject: [PATCH 040/146] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors:=20Coh?=
 =?UTF-8?q?erence=20(#12093)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                        | 2 +-
 docs/en/data/sponsors.yml        | 2 +-
 docs/en/docs/deployment/cloud.md | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index d8de34e0c..5554f71d4 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,7 @@ The key features are:
 <a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg"></a>
 <a href="https://github.com/scalar/scalar/?utm_source=fastapi&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Scalar: Beautiful Open-Source API References from Swagger/OpenAPI files"><img src="https://fastapi.tiangolo.com/img/sponsors/scalar.svg"></a>
 <a href="https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge" target="_blank" title="Auth, user management and more for your B2B product"><img src="https://fastapi.tiangolo.com/img/sponsors/propelauth.png"></a>
-<a href="https://docs.withcoherence.com/configuration/frameworks/?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs#fastapi-example" target="_blank" title="Coherence"><img src="https://fastapi.tiangolo.com/img/sponsors/coherence.png"></a>
+<a href="https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs" target="_blank" title="Coherence"><img src="https://fastapi.tiangolo.com/img/sponsors/coherence.png"></a>
 <a href="https://www.mongodb.com/developer/languages/python/python-quickstart-fastapi/?utm_campaign=fastapi_framework&utm_source=fastapi_sponsorship&utm_medium=web_referral" target="_blank" title="Simplify Full Stack Development with FastAPI & MongoDB"><img src="https://fastapi.tiangolo.com/img/sponsors/mongodb.png"></a>
 <a href="https://zuplo.link/fastapi-gh" target="_blank" title="Zuplo: Scale, Protect, Document, and Monetize your FastAPI"><img src="https://fastapi.tiangolo.com/img/sponsors/zuplo.png"></a>
 <a href="https://fine.dev?ref=fastapibadge" target="_blank" title="Fine's AI FastAPI Workflow: Effortlessly Deploy and Integrate FastAPI into Your Project"><img src="https://fastapi.tiangolo.com/img/sponsors/fine.png"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 76e20638a..3a767b6b1 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -17,7 +17,7 @@ gold:
   - url: https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge
     title: Auth, user management and more for your B2B product
     img: https://fastapi.tiangolo.com/img/sponsors/propelauth.png
-  - url: https://docs.withcoherence.com/configuration/frameworks/?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs#fastapi-example
+  - url: https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs
     title: Coherence
     img: https://fastapi.tiangolo.com/img/sponsors/coherence.png
   - url: https://www.mongodb.com/developer/languages/python/python-quickstart-fastapi/?utm_campaign=fastapi_framework&utm_source=fastapi_sponsorship&utm_medium=web_referral
diff --git a/docs/en/docs/deployment/cloud.md b/docs/en/docs/deployment/cloud.md
index d34fbe2f7..3ea5087f8 100644
--- a/docs/en/docs/deployment/cloud.md
+++ b/docs/en/docs/deployment/cloud.md
@@ -14,4 +14,4 @@ You might want to try their services and follow their guides:
 
 * <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank">Platform.sh</a>
 * <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a>
-* <a href="https://docs.withcoherence.com/docs/configuration/frameworks?utm_medium=advertising&utm_source=fastapi&utm_campaign=banner%20january%2024#fast-api-example" class="external-link" target="_blank">Coherence</a>
+* <a href="https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs" class="external-link" target="_blank">Coherence</a>

From a2458d594facb238f42dc471754612109b5f5c2d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 30 Aug 2024 16:20:42 +0000
Subject: [PATCH 041/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 83080e0aa..2f7fb0cbd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* 🔧 Update sponsors: Coherence. PR [#12093](https://github.com/fastapi/fastapi/pull/12093) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Fix async test example not to trigger DeprecationWarning. PR [#12084](https://github.com/fastapi/fastapi/pull/12084) by [@marcinsulikowski](https://github.com/marcinsulikowski).
 * 📝 Update `docs_src/path_params_numeric_validations/tutorial006.py`. PR [#11478](https://github.com/fastapi/fastapi/pull/11478) by [@MuhammadAshiqAmeer](https://github.com/MuhammadAshiqAmeer).
 * 📝 Update comma in `docs/en/docs/async.md`. PR [#12062](https://github.com/fastapi/fastapi/pull/12062) by [@Alec-Gillis](https://github.com/Alec-Gillis).

From 5827b922c3ebf999eae867dbb855c0bf2aa07a7e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 31 Aug 2024 03:23:14 +0000
Subject: [PATCH 042/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2f7fb0cbd..d1ac98ed1 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* 📝 Tweak middleware code sample `time.time()` to `time.perf_counter()`. PR [#11957](https://github.com/fastapi/fastapi/pull/11957) by [@domdent](https://github.com/domdent).
 * 🔧 Update sponsors: Coherence. PR [#12093](https://github.com/fastapi/fastapi/pull/12093) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Fix async test example not to trigger DeprecationWarning. PR [#12084](https://github.com/fastapi/fastapi/pull/12084) by [@marcinsulikowski](https://github.com/marcinsulikowski).
 * 📝 Update `docs_src/path_params_numeric_validations/tutorial006.py`. PR [#11478](https://github.com/fastapi/fastapi/pull/11478) by [@MuhammadAshiqAmeer](https://github.com/MuhammadAshiqAmeer).

From c37f2c976dfe71ac46ccc082b551d41cb7b6122f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 31 Aug 2024 12:15:50 +0200
Subject: [PATCH 043/146] =?UTF-8?q?=F0=9F=93=9D=20Add=20note=20about=20`ti?=
 =?UTF-8?q?me.perf=5Fcounter()`=20in=20middlewares=20(#12095)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/tutorial/middleware.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/en/docs/tutorial/middleware.md b/docs/en/docs/tutorial/middleware.md
index 06fb3f504..199b593d3 100644
--- a/docs/en/docs/tutorial/middleware.md
+++ b/docs/en/docs/tutorial/middleware.md
@@ -63,6 +63,12 @@ For example, you could add a custom header `X-Process-Time` containing the time
 {!../../../docs_src/middleware/tutorial001.py!}
 ```
 
+/// tip
+
+Here we use <a href="https://docs.python.org/3/library/time.html#time.perf_counter" class="external-link" target="_blank">`time.perf_counter()`</a> instead of `time.time()` because it can be more precise for these use cases. 🤓
+
+///
+
 ## Other middlewares
 
 You can later read more about other middlewares in the [Advanced User Guide: Advanced Middleware](../advanced/middleware.md){.internal-link target=_blank}.

From 6c8a205db106835c2cd4af5d0b5110f562c2a92f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 31 Aug 2024 10:16:12 +0000
Subject: [PATCH 044/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d1ac98ed1..e0e9192bd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* 📝 Add note about `time.perf_counter()` in middlewares. PR [#12095](https://github.com/fastapi/fastapi/pull/12095) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Tweak middleware code sample `time.time()` to `time.perf_counter()`. PR [#11957](https://github.com/fastapi/fastapi/pull/11957) by [@domdent](https://github.com/domdent).
 * 🔧 Update sponsors: Coherence. PR [#12093](https://github.com/fastapi/fastapi/pull/12093) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Fix async test example not to trigger DeprecationWarning. PR [#12084](https://github.com/fastapi/fastapi/pull/12084) by [@marcinsulikowski](https://github.com/marcinsulikowski).

From 0077af97195ec77ab2fcc5a3cf1536c7ed6125d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 31 Aug 2024 12:18:37 +0200
Subject: [PATCH 045/146] =?UTF-8?q?=F0=9F=94=A7=20Update=20labeler=20confi?=
 =?UTF-8?q?g=20to=20handle=20sponsorships=20data=20(#12096)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/labeler.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/labeler.yml b/.github/labeler.yml
index 1d49a2411..c5b1f84f3 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -7,6 +7,8 @@ docs:
       - all-globs-to-all-files:
         - '!fastapi/**'
         - '!pyproject.toml'
+        - '!docs/en/data/sponsors.yml'
+        - '!docs/en/overrides/main.html'
 
 lang-all:
   - all:
@@ -28,6 +30,8 @@ internal:
         - .pre-commit-config.yaml
         - pdm_build.py
         - requirements*.txt
+        - docs/en/data/sponsors.yml
+        - docs/en/overrides/main.html
       - all-globs-to-all-files:
         - '!docs/*/docs/**'
         - '!fastapi/**'

From 83422b1923b070da891bfacec707f4d2c796a32c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 31 Aug 2024 10:20:40 +0000
Subject: [PATCH 046/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e0e9192bd..a87ce21d4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
 
 ### Internal
 
+* 🔧 Update labeler config to handle sponsorships data. PR [#12096](https://github.com/fastapi/fastapi/pull/12096) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, remove Kong. PR [#12085](https://github.com/fastapi/fastapi/pull/12085) by [@tiangolo](https://github.com/tiangolo).
 * ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12076](https://github.com/fastapi/fastapi/pull/12076) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
 * 👷 Update `latest-changes` GitHub Action. PR [#12073](https://github.com/fastapi/fastapi/pull/12073) by [@tiangolo](https://github.com/tiangolo).

From eebc6c3d54f96cfd056c0a6fe4de7c3b0064ac42 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 31 Aug 2024 17:35:58 +0200
Subject: [PATCH 047/146] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors=20link?=
 =?UTF-8?q?:=20Coherence=20(#12097)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/overrides/main.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 851f8e895..47e46c4bf 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -59,7 +59,7 @@
       </a>
     </div>
     <div class="item">
-      <a title="Coherence" style="display: block; position: relative;" href="https://docs.withcoherence.com/configuration/frameworks/?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs#fastapi-example" target="_blank">
+      <a title="Coherence" style="display: block; position: relative;" href="https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs" target="_blank">
         <span class="sponsor-badge">sponsor</span>
         <img class="sponsor-image" src="/img/sponsors/coherence-banner.png" />
       </a>

From 47b3351be9c268a3b79faf9b41bf08921dbc8a8b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 31 Aug 2024 15:36:24 +0000
Subject: [PATCH 048/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a87ce21d4..855338742 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
 
 ### Internal
 
+* 🔧 Update sponsors link: Coherence. PR [#12097](https://github.com/fastapi/fastapi/pull/12097) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update labeler config to handle sponsorships data. PR [#12096](https://github.com/fastapi/fastapi/pull/12096) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, remove Kong. PR [#12085](https://github.com/fastapi/fastapi/pull/12085) by [@tiangolo](https://github.com/tiangolo).
 * ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12076](https://github.com/fastapi/fastapi/pull/12076) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).

From 581aacc4a9f3bbb872b082ee55535fe60655de2e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 31 Aug 2024 22:19:30 +0200
Subject: [PATCH 049/146] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Refactor=20and=20s?=
 =?UTF-8?q?implify=20dependencies=20data=20structures=20with=20dataclasses?=
 =?UTF-8?q?=20(#12098)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/dependencies/models.py | 75 ++++++++++++----------------------
 fastapi/dependencies/utils.py  |  2 +-
 2 files changed, 28 insertions(+), 49 deletions(-)

diff --git a/fastapi/dependencies/models.py b/fastapi/dependencies/models.py
index 61ef00638..418c11725 100644
--- a/fastapi/dependencies/models.py
+++ b/fastapi/dependencies/models.py
@@ -1,58 +1,37 @@
-from typing import Any, Callable, List, Optional, Sequence
+from dataclasses import dataclass, field
+from typing import Any, Callable, List, Optional, Sequence, Tuple
 
 from fastapi._compat import ModelField
 from fastapi.security.base import SecurityBase
 
 
+@dataclass
 class SecurityRequirement:
-    def __init__(
-        self, security_scheme: SecurityBase, scopes: Optional[Sequence[str]] = None
-    ):
-        self.security_scheme = security_scheme
-        self.scopes = scopes
+    security_scheme: SecurityBase
+    scopes: Optional[Sequence[str]] = None
 
 
+@dataclass
 class Dependant:
-    def __init__(
-        self,
-        *,
-        path_params: Optional[List[ModelField]] = None,
-        query_params: Optional[List[ModelField]] = None,
-        header_params: Optional[List[ModelField]] = None,
-        cookie_params: Optional[List[ModelField]] = None,
-        body_params: Optional[List[ModelField]] = None,
-        dependencies: Optional[List["Dependant"]] = None,
-        security_schemes: Optional[List[SecurityRequirement]] = None,
-        name: Optional[str] = None,
-        call: Optional[Callable[..., Any]] = None,
-        request_param_name: Optional[str] = None,
-        websocket_param_name: Optional[str] = None,
-        http_connection_param_name: Optional[str] = None,
-        response_param_name: Optional[str] = None,
-        background_tasks_param_name: Optional[str] = None,
-        security_scopes_param_name: Optional[str] = None,
-        security_scopes: Optional[List[str]] = None,
-        use_cache: bool = True,
-        path: Optional[str] = None,
-    ) -> None:
-        self.path_params = path_params or []
-        self.query_params = query_params or []
-        self.header_params = header_params or []
-        self.cookie_params = cookie_params or []
-        self.body_params = body_params or []
-        self.dependencies = dependencies or []
-        self.security_requirements = security_schemes or []
-        self.request_param_name = request_param_name
-        self.websocket_param_name = websocket_param_name
-        self.http_connection_param_name = http_connection_param_name
-        self.response_param_name = response_param_name
-        self.background_tasks_param_name = background_tasks_param_name
-        self.security_scopes = security_scopes
-        self.security_scopes_param_name = security_scopes_param_name
-        self.name = name
-        self.call = call
-        self.use_cache = use_cache
-        # Store the path to be able to re-generate a dependable from it in overrides
-        self.path = path
-        # Save the cache key at creation to optimize performance
+    path_params: List[ModelField] = field(default_factory=list)
+    query_params: List[ModelField] = field(default_factory=list)
+    header_params: List[ModelField] = field(default_factory=list)
+    cookie_params: List[ModelField] = field(default_factory=list)
+    body_params: List[ModelField] = field(default_factory=list)
+    dependencies: List["Dependant"] = field(default_factory=list)
+    security_requirements: List[SecurityRequirement] = field(default_factory=list)
+    name: Optional[str] = None
+    call: Optional[Callable[..., Any]] = None
+    request_param_name: Optional[str] = None
+    websocket_param_name: Optional[str] = None
+    http_connection_param_name: Optional[str] = None
+    response_param_name: Optional[str] = None
+    background_tasks_param_name: Optional[str] = None
+    security_scopes_param_name: Optional[str] = None
+    security_scopes: Optional[List[str]] = None
+    use_cache: bool = True
+    path: Optional[str] = None
+    cache_key: Tuple[Optional[Callable[..., Any]], Tuple[str, ...]] = field(init=False)
+
+    def __post_init__(self) -> None:
         self.cache_key = (self.call, tuple(sorted(set(self.security_scopes or []))))
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 3e8e7b410..85703c9e9 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -175,7 +175,7 @@ def get_flat_dependant(
         header_params=dependant.header_params.copy(),
         cookie_params=dependant.cookie_params.copy(),
         body_params=dependant.body_params.copy(),
-        security_schemes=dependant.security_requirements.copy(),
+        security_requirements=dependant.security_requirements.copy(),
         use_cache=dependant.use_cache,
         path=dependant.path,
     )

From 75c4e7fc44fda0c63d5627af65cb0ba7919fd334 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 31 Aug 2024 20:19:51 +0000
Subject: [PATCH 050/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 855338742..a02b722f6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Refactors
+
+* ♻️ Refactor and simplify dependencies data structures with dataclasses. PR [#12098](https://github.com/fastapi/fastapi/pull/12098) by [@tiangolo](https://github.com/tiangolo).
+
 ### Docs
 
 * 📝 Add note about `time.perf_counter()` in middlewares. PR [#12095](https://github.com/fastapi/fastapi/pull/12095) by [@tiangolo](https://github.com/tiangolo).

From 08547e1d571df8e8cf71d8b15a767acbc38aea62 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 31 Aug 2024 22:27:44 +0200
Subject: [PATCH 051/146] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Refactor=20and=20s?=
 =?UTF-8?q?implify=20internal=20`analyze=5Fparam()`=20to=20structure=20dat?=
 =?UTF-8?q?a=20with=20dataclasses=20instead=20of=20tuple=20(#12099)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/dependencies/utils.py | 30 +++++++++++++++++++-----------
 1 file changed, 19 insertions(+), 11 deletions(-)

diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 85703c9e9..5ebdddaf6 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -1,6 +1,7 @@
 import inspect
 from contextlib import AsyncExitStack, contextmanager
 from copy import copy, deepcopy
+from dataclasses import dataclass
 from typing import (
     Any,
     Callable,
@@ -258,16 +259,16 @@ def get_dependant(
     )
     for param_name, param in signature_params.items():
         is_path_param = param_name in path_param_names
-        type_annotation, depends, param_field = analyze_param(
+        param_details = analyze_param(
             param_name=param_name,
             annotation=param.annotation,
             value=param.default,
             is_path_param=is_path_param,
         )
-        if depends is not None:
+        if param_details.depends is not None:
             sub_dependant = get_param_sub_dependant(
                 param_name=param_name,
-                depends=depends,
+                depends=param_details.depends,
                 path=path,
                 security_scopes=security_scopes,
             )
@@ -275,18 +276,18 @@ def get_dependant(
             continue
         if add_non_field_param_to_dependency(
             param_name=param_name,
-            type_annotation=type_annotation,
+            type_annotation=param_details.type_annotation,
             dependant=dependant,
         ):
             assert (
-                param_field is None
+                param_details.field is None
             ), f"Cannot specify multiple FastAPI annotations for {param_name!r}"
             continue
-        assert param_field is not None
-        if is_body_param(param_field=param_field, is_path_param=is_path_param):
-            dependant.body_params.append(param_field)
+        assert param_details.field is not None
+        if is_body_param(param_field=param_details.field, is_path_param=is_path_param):
+            dependant.body_params.append(param_details.field)
         else:
-            add_param_to_fields(field=param_field, dependant=dependant)
+            add_param_to_fields(field=param_details.field, dependant=dependant)
     return dependant
 
 
@@ -314,13 +315,20 @@ def add_non_field_param_to_dependency(
     return None
 
 
+@dataclass
+class ParamDetails:
+    type_annotation: Any
+    depends: Optional[params.Depends]
+    field: Optional[ModelField]
+
+
 def analyze_param(
     *,
     param_name: str,
     annotation: Any,
     value: Any,
     is_path_param: bool,
-) -> Tuple[Any, Optional[params.Depends], Optional[ModelField]]:
+) -> ParamDetails:
     field_info = None
     depends = None
     type_annotation: Any = Any
@@ -450,7 +458,7 @@ def analyze_param(
             field_info=field_info,
         )
 
-    return type_annotation, depends, field
+    return ParamDetails(type_annotation=type_annotation, depends=depends, field=field)
 
 
 def is_body_param(*, param_field: ModelField, is_path_param: bool) -> bool:

From 8d7d89e8c603ca13043ce037503c66cc6a662a48 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 31 Aug 2024 20:28:07 +0000
Subject: [PATCH 052/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a02b722f6..677816f40 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Refactors
 
+* ♻️ Refactor and simplify internal `analyze_param()` to structure data with dataclasses instead of tuple. PR [#12099](https://github.com/fastapi/fastapi/pull/12099) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Refactor and simplify dependencies data structures with dataclasses. PR [#12098](https://github.com/fastapi/fastapi/pull/12098) by [@tiangolo](https://github.com/tiangolo).
 
 ### Docs

From 5b7fa3900e3156dcb93f496516740bc06903d7d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 31 Aug 2024 22:52:06 +0200
Subject: [PATCH 053/146] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Refactor=20and=20s?=
 =?UTF-8?q?implify=20internal=20data=20from=20`solve=5Fdependencies()`=20u?=
 =?UTF-8?q?sing=20dataclasses=20(#12100)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/dependencies/utils.py | 45 +++++++++++++++++++----------------
 fastapi/routing.py            | 33 +++++++++++++++----------
 2 files changed, 45 insertions(+), 33 deletions(-)

diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 5ebdddaf6..ed03df88b 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -529,6 +529,15 @@ async def solve_generator(
     return await stack.enter_async_context(cm)
 
 
+@dataclass
+class SolvedDependency:
+    values: Dict[str, Any]
+    errors: List[Any]
+    background_tasks: Optional[StarletteBackgroundTasks]
+    response: Response
+    dependency_cache: Dict[Tuple[Callable[..., Any], Tuple[str]], Any]
+
+
 async def solve_dependencies(
     *,
     request: Union[Request, WebSocket],
@@ -539,13 +548,7 @@ async def solve_dependencies(
     dependency_overrides_provider: Optional[Any] = None,
     dependency_cache: Optional[Dict[Tuple[Callable[..., Any], Tuple[str]], Any]] = None,
     async_exit_stack: AsyncExitStack,
-) -> Tuple[
-    Dict[str, Any],
-    List[Any],
-    Optional[StarletteBackgroundTasks],
-    Response,
-    Dict[Tuple[Callable[..., Any], Tuple[str]], Any],
-]:
+) -> SolvedDependency:
     values: Dict[str, Any] = {}
     errors: List[Any] = []
     if response is None:
@@ -587,27 +590,21 @@ async def solve_dependencies(
             dependency_cache=dependency_cache,
             async_exit_stack=async_exit_stack,
         )
-        (
-            sub_values,
-            sub_errors,
-            background_tasks,
-            _,  # the subdependency returns the same response we have
-            sub_dependency_cache,
-        ) = solved_result
-        dependency_cache.update(sub_dependency_cache)
-        if sub_errors:
-            errors.extend(sub_errors)
+        background_tasks = solved_result.background_tasks
+        dependency_cache.update(solved_result.dependency_cache)
+        if solved_result.errors:
+            errors.extend(solved_result.errors)
             continue
         if sub_dependant.use_cache and sub_dependant.cache_key in dependency_cache:
             solved = dependency_cache[sub_dependant.cache_key]
         elif is_gen_callable(call) or is_async_gen_callable(call):
             solved = await solve_generator(
-                call=call, stack=async_exit_stack, sub_values=sub_values
+                call=call, stack=async_exit_stack, sub_values=solved_result.values
             )
         elif is_coroutine_callable(call):
-            solved = await call(**sub_values)
+            solved = await call(**solved_result.values)
         else:
-            solved = await run_in_threadpool(call, **sub_values)
+            solved = await run_in_threadpool(call, **solved_result.values)
         if sub_dependant.name is not None:
             values[sub_dependant.name] = solved
         if sub_dependant.cache_key not in dependency_cache:
@@ -654,7 +651,13 @@ async def solve_dependencies(
         values[dependant.security_scopes_param_name] = SecurityScopes(
             scopes=dependant.security_scopes
         )
-    return values, errors, background_tasks, response, dependency_cache
+    return SolvedDependency(
+        values=values,
+        errors=errors,
+        background_tasks=background_tasks,
+        response=response,
+        dependency_cache=dependency_cache,
+    )
 
 
 def request_params_to_args(
diff --git a/fastapi/routing.py b/fastapi/routing.py
index 49f1b6013..c46772017 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -292,26 +292,34 @@ def get_request_handler(
                     dependency_overrides_provider=dependency_overrides_provider,
                     async_exit_stack=async_exit_stack,
                 )
-                values, errors, background_tasks, sub_response, _ = solved_result
+                errors = solved_result.errors
                 if not errors:
                     raw_response = await run_endpoint_function(
-                        dependant=dependant, values=values, is_coroutine=is_coroutine
+                        dependant=dependant,
+                        values=solved_result.values,
+                        is_coroutine=is_coroutine,
                     )
                     if isinstance(raw_response, Response):
                         if raw_response.background is None:
-                            raw_response.background = background_tasks
+                            raw_response.background = solved_result.background_tasks
                         response = raw_response
                     else:
-                        response_args: Dict[str, Any] = {"background": background_tasks}
+                        response_args: Dict[str, Any] = {
+                            "background": solved_result.background_tasks
+                        }
                         # If status_code was set, use it, otherwise use the default from the
                         # response class, in the case of redirect it's 307
                         current_status_code = (
-                            status_code if status_code else sub_response.status_code
+                            status_code
+                            if status_code
+                            else solved_result.response.status_code
                         )
                         if current_status_code is not None:
                             response_args["status_code"] = current_status_code
-                        if sub_response.status_code:
-                            response_args["status_code"] = sub_response.status_code
+                        if solved_result.response.status_code:
+                            response_args["status_code"] = (
+                                solved_result.response.status_code
+                            )
                         content = await serialize_response(
                             field=response_field,
                             response_content=raw_response,
@@ -326,7 +334,7 @@ def get_request_handler(
                         response = actual_response_class(content, **response_args)
                         if not is_body_allowed_for_status_code(response.status_code):
                             response.body = b""
-                        response.headers.raw.extend(sub_response.headers.raw)
+                        response.headers.raw.extend(solved_result.response.headers.raw)
             if errors:
                 validation_error = RequestValidationError(
                     _normalize_errors(errors), body=body
@@ -360,11 +368,12 @@ def get_websocket_app(
                 dependency_overrides_provider=dependency_overrides_provider,
                 async_exit_stack=async_exit_stack,
             )
-            values, errors, _, _2, _3 = solved_result
-            if errors:
-                raise WebSocketRequestValidationError(_normalize_errors(errors))
+            if solved_result.errors:
+                raise WebSocketRequestValidationError(
+                    _normalize_errors(solved_result.errors)
+                )
             assert dependant.call is not None, "dependant.call must be a function"
-            await dependant.call(**values)
+            await dependant.call(**solved_result.values)
 
     return app
 

From 3660c7a063ddc605269b0c204acd4724ccf2d69c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 31 Aug 2024 20:52:29 +0000
Subject: [PATCH 054/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 677816f40..3fc659cbb 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Refactors
 
+* ♻️ Refactor and simplify internal data from `solve_dependencies()` using dataclasses. PR [#12100](https://github.com/fastapi/fastapi/pull/12100) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Refactor and simplify internal `analyze_param()` to structure data with dataclasses instead of tuple. PR [#12099](https://github.com/fastapi/fastapi/pull/12099) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Refactor and simplify dependencies data structures with dataclasses. PR [#12098](https://github.com/fastapi/fastapi/pull/12098) by [@tiangolo](https://github.com/tiangolo).
 

From d08b95ea57fa5740c8c04da554f2b6e259f4dea4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 1 Sep 2024 01:46:03 +0200
Subject: [PATCH 055/146] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Rename=20internal?=
 =?UTF-8?q?=20`create=5Fresponse=5Ffield()`=20to=20`create=5Fmodel=5Ffield?=
 =?UTF-8?q?()`=20as=20it's=20used=20for=20more=20than=20response=20models?=
 =?UTF-8?q?=20(#12103)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/dependencies/utils.py | 6 +++---
 fastapi/routing.py            | 6 +++---
 fastapi/utils.py              | 9 +++------
 3 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index ed03df88b..c5ed709f7 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -55,7 +55,7 @@ from fastapi.logger import logger
 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_response_field, get_path_param_names
+from fastapi.utils import create_model_field, get_path_param_names
 from pydantic.fields import FieldInfo
 from starlette.background import BackgroundTasks as StarletteBackgroundTasks
 from starlette.concurrency import run_in_threadpool
@@ -449,7 +449,7 @@ def analyze_param(
         else:
             alias = field_info.alias or param_name
         field_info.alias = alias
-        field = create_response_field(
+        field = create_model_field(
             name=param_name,
             type_=use_annotation_from_field_info,
             default=field_info.default,
@@ -818,7 +818,7 @@ def get_body_field(*, dependant: Dependant, name: str) -> Optional[ModelField]:
         ]
         if len(set(body_param_media_types)) == 1:
             BodyFieldInfo_kwargs["media_type"] = body_param_media_types[0]
-    final_field = create_response_field(
+    final_field = create_model_field(
         name="body",
         type_=BodyModel,
         required=required,
diff --git a/fastapi/routing.py b/fastapi/routing.py
index c46772017..61a112fc4 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -49,7 +49,7 @@ from fastapi.exceptions import (
 from fastapi.types import DecoratedCallable, IncEx
 from fastapi.utils import (
     create_cloned_field,
-    create_response_field,
+    create_model_field,
     generate_unique_id,
     get_value_or_default,
     is_body_allowed_for_status_code,
@@ -497,7 +497,7 @@ class APIRoute(routing.Route):
                 status_code
             ), f"Status code {status_code} must not have a response body"
             response_name = "Response_" + self.unique_id
-            self.response_field = create_response_field(
+            self.response_field = create_model_field(
                 name=response_name,
                 type_=self.response_model,
                 mode="serialization",
@@ -530,7 +530,7 @@ class APIRoute(routing.Route):
                     additional_status_code
                 ), f"Status code {additional_status_code} must not have a response body"
                 response_name = f"Response_{additional_status_code}_{self.unique_id}"
-                response_field = create_response_field(name=response_name, type_=model)
+                response_field = create_model_field(name=response_name, type_=model)
                 response_fields[additional_status_code] = response_field
         if response_fields:
             self.response_fields: Dict[Union[int, str], ModelField] = response_fields
diff --git a/fastapi/utils.py b/fastapi/utils.py
index 5c2538fac..4c7350fea 100644
--- a/fastapi/utils.py
+++ b/fastapi/utils.py
@@ -60,9 +60,9 @@ def get_path_param_names(path: str) -> Set[str]:
     return set(re.findall("{(.*?)}", path))
 
 
-def create_response_field(
+def create_model_field(
     name: str,
-    type_: Type[Any],
+    type_: Any,
     class_validators: Optional[Dict[str, Validator]] = None,
     default: Optional[Any] = Undefined,
     required: Union[bool, UndefinedType] = Undefined,
@@ -71,9 +71,6 @@ def create_response_field(
     alias: Optional[str] = None,
     mode: Literal["validation", "serialization"] = "validation",
 ) -> ModelField:
-    """
-    Create a new response field. Raises if type_ is invalid.
-    """
     class_validators = class_validators or {}
     if PYDANTIC_V2:
         field_info = field_info or FieldInfo(
@@ -135,7 +132,7 @@ def create_cloned_field(
                 use_type.__fields__[f.name] = create_cloned_field(
                     f, cloned_types=cloned_types
                 )
-    new_field = create_response_field(name=field.name, type_=use_type)
+    new_field = create_model_field(name=field.name, type_=use_type)
     new_field.has_alias = field.has_alias  # type: ignore[attr-defined]
     new_field.alias = field.alias  # type: ignore[misc]
     new_field.class_validators = field.class_validators  # type: ignore[attr-defined]

From d5c6cf8122cd8de3d4fcd37b616fbfa2ade1542b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 31 Aug 2024 23:46:26 +0000
Subject: [PATCH 056/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3fc659cbb..d7b278dbe 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Refactors
 
+* ♻️ Rename internal `create_response_field()` to `create_model_field()` as it's used for more than response models. PR [#12103](https://github.com/fastapi/fastapi/pull/12103) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Refactor and simplify internal data from `solve_dependencies()` using dataclasses. PR [#12100](https://github.com/fastapi/fastapi/pull/12100) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Refactor and simplify internal `analyze_param()` to structure data with dataclasses instead of tuple. PR [#12099](https://github.com/fastapi/fastapi/pull/12099) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Refactor and simplify dependencies data structures with dataclasses. PR [#12098](https://github.com/fastapi/fastapi/pull/12098) by [@tiangolo](https://github.com/tiangolo).

From 23bda0ffeb26e906b5dcf58423522ab4166669ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 1 Sep 2024 21:39:25 +0200
Subject: [PATCH 057/146] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Refactor=20interna?=
 =?UTF-8?q?l=20`check=5Ffile=5Ffield()`,=20rename=20to=20`ensure=5Fmultipa?=
 =?UTF-8?q?rt=5Fis=5Finstalled()`=20to=20clarify=20its=20purpose=20(#12106?=
 =?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/dependencies/utils.py | 47 ++++++++++++++++++++---------------
 1 file changed, 27 insertions(+), 20 deletions(-)

diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index c5ed709f7..0dcba62f1 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -80,25 +80,23 @@ multipart_incorrect_install_error = (
 )
 
 
-def check_file_field(field: ModelField) -> None:
-    field_info = field.field_info
-    if isinstance(field_info, params.Form):
+def ensure_multipart_is_installed() -> None:
+    try:
+        # __version__ is available in both multiparts, and can be mocked
+        from multipart import __version__  # type: ignore
+
+        assert __version__
         try:
-            # __version__ is available in both multiparts, and can be mocked
-            from multipart import __version__  # type: ignore
-
-            assert __version__
-            try:
-                # parse_options_header is only available in the right multipart
-                from multipart.multipart import parse_options_header  # type: ignore
-
-                assert parse_options_header
-            except ImportError:
-                logger.error(multipart_incorrect_install_error)
-                raise RuntimeError(multipart_incorrect_install_error) from None
+            # parse_options_header is only available in the right multipart
+            from multipart.multipart import parse_options_header  # type: ignore
+
+            assert parse_options_header
         except ImportError:
-            logger.error(multipart_not_installed_error)
-            raise RuntimeError(multipart_not_installed_error) from None
+            logger.error(multipart_incorrect_install_error)
+            raise RuntimeError(multipart_incorrect_install_error) from None
+    except ImportError:
+        logger.error(multipart_not_installed_error)
+        raise RuntimeError(multipart_not_installed_error) from None
 
 
 def get_param_sub_dependant(
@@ -336,6 +334,7 @@ def analyze_param(
     if annotation is not inspect.Signature.empty:
         use_annotation = annotation
         type_annotation = annotation
+    # Extract Annotated info
     if get_origin(use_annotation) is Annotated:
         annotated_args = get_args(annotation)
         type_annotation = annotated_args[0]
@@ -355,6 +354,7 @@ def analyze_param(
             )
         else:
             fastapi_annotation = None
+        # Set default for Annotated FieldInfo
         if isinstance(fastapi_annotation, FieldInfo):
             # Copy `field_info` because we mutate `field_info.default` below.
             field_info = copy_field_info(
@@ -369,9 +369,10 @@ def analyze_param(
                 field_info.default = value
             else:
                 field_info.default = Required
+        # Get Annotated Depends
         elif isinstance(fastapi_annotation, params.Depends):
             depends = fastapi_annotation
-
+    # Get Depends from default value
     if isinstance(value, params.Depends):
         assert depends is None, (
             "Cannot specify `Depends` in `Annotated` and default value"
@@ -382,6 +383,7 @@ def analyze_param(
             f" default value together for {param_name!r}"
         )
         depends = value
+    # Get FieldInfo from default value
     elif isinstance(value, FieldInfo):
         assert field_info is None, (
             "Cannot specify FastAPI annotations in `Annotated` and default value"
@@ -391,11 +393,13 @@ def analyze_param(
         if PYDANTIC_V2:
             field_info.annotation = type_annotation
 
+    # Get Depends from type annotation
     if depends is not None and depends.dependency is None:
         # Copy `depends` before mutating it
         depends = copy(depends)
         depends.dependency = type_annotation
 
+    # Handle non-param type annotations like Request
     if lenient_issubclass(
         type_annotation,
         (
@@ -411,6 +415,7 @@ def analyze_param(
         assert (
             field_info is None
         ), f"Cannot specify FastAPI annotation for type {type_annotation!r}"
+    # Handle default assignations, neither field_info nor depends was not found in Annotated nor default value
     elif field_info is None and depends is None:
         default_value = value if value is not inspect.Signature.empty else Required
         if is_path_param:
@@ -428,7 +433,9 @@ def analyze_param(
             field_info = params.Query(annotation=use_annotation, default=default_value)
 
     field = None
+    # It's a field_info, not a dependency
     if field_info is not None:
+        # Handle field_info.in_
         if is_path_param:
             assert isinstance(field_info, params.Path), (
                 f"Cannot use `{field_info.__class__.__name__}` for path param"
@@ -444,6 +451,8 @@ def analyze_param(
             field_info,
             param_name,
         )
+        if isinstance(field_info, params.Form):
+            ensure_multipart_is_installed()
         if not field_info.alias and getattr(field_info, "convert_underscores", None):
             alias = param_name.replace("_", "-")
         else:
@@ -786,7 +795,6 @@ def get_body_field(*, dependant: Dependant, name: str) -> Optional[ModelField]:
     embed = getattr(field_info, "embed", None)
     body_param_names_set = {param.name for param in flat_dependant.body_params}
     if len(body_param_names_set) == 1 and not embed:
-        check_file_field(first_param)
         return first_param
     # If one field requires to embed, all have to be embedded
     # in case a sub-dependency is evaluated with a single unique body field
@@ -825,5 +833,4 @@ def get_body_field(*, dependant: Dependant, name: str) -> Optional[ModelField]:
         alias="body",
         field_info=BodyFieldInfo(**BodyFieldInfo_kwargs),
     )
-    check_file_field(final_field)
     return final_field

From b203d7a15fb5b49635bd81811e09ad94700f68a6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 1 Sep 2024 19:39:46 +0000
Subject: [PATCH 058/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d7b278dbe..c3e7c3590 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Refactors
 
+* ♻️ Refactor internal `check_file_field()`, rename to `ensure_multipart_is_installed()` to clarify its purpose. PR [#12106](https://github.com/fastapi/fastapi/pull/12106) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Rename internal `create_response_field()` to `create_model_field()` as it's used for more than response models. PR [#12103](https://github.com/fastapi/fastapi/pull/12103) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Refactor and simplify internal data from `solve_dependencies()` using dataclasses. PR [#12100](https://github.com/fastapi/fastapi/pull/12100) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Refactor and simplify internal `analyze_param()` to structure data with dataclasses instead of tuple. PR [#12099](https://github.com/fastapi/fastapi/pull/12099) by [@tiangolo](https://github.com/tiangolo).

From 92bdfbc7bac466e502872a1ddf6e7cae069fd068 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 2 Sep 2024 21:36:52 +0200
Subject: [PATCH 059/146] =?UTF-8?q?=E2=AC=86=20Bump=20pypa/gh-action-pypi-?=
 =?UTF-8?q?publish=20from=201.9.0=20to=201.10.0=20(#12112)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) from 1.9.0 to 1.10.0.
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/v1.9.0...v1.10.0)

---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/publish.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 591df634b..03f87d172 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -35,7 +35,7 @@ jobs:
           TIANGOLO_BUILD_PACKAGE: ${{ matrix.package }}
         run: python -m build
       - name: Publish
-        uses: pypa/gh-action-pypi-publish@v1.9.0
+        uses: pypa/gh-action-pypi-publish@v1.10.0
       - name: Dump GitHub context
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}

From 17f1f7b5bde8a75197c3aef7d4d24b04f8438083 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 2 Sep 2024 19:37:19 +0000
Subject: [PATCH 060/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c3e7c3590..bc431dfac 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -35,6 +35,7 @@ hide:
 
 ### Internal
 
+* ⬆ Bump pypa/gh-action-pypi-publish from 1.9.0 to 1.10.0. PR [#12112](https://github.com/fastapi/fastapi/pull/12112) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * 🔧 Update sponsors link: Coherence. PR [#12097](https://github.com/fastapi/fastapi/pull/12097) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update labeler config to handle sponsorships data. PR [#12096](https://github.com/fastapi/fastapi/pull/12096) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, remove Kong. PR [#12085](https://github.com/fastapi/fastapi/pull/12085) by [@tiangolo](https://github.com/tiangolo).

From b63b4189eedc9e586fb51705a0a29ace8fa6a6d1 Mon Sep 17 00:00:00 2001
From: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
Date: Mon, 2 Sep 2024 21:53:53 +0200
Subject: [PATCH 061/146] =?UTF-8?q?=F0=9F=92=9A=20Set=20`include-hidden-fi?=
 =?UTF-8?q?les`=20to=20`True`=20when=20using=20the=20`upload-artifact`=20G?=
 =?UTF-8?q?H=20action=20(#12118)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* include-hidden-files when uploading coverage files

* include-hidden-files when building docs
---
 .github/workflows/build-docs.yml | 1 +
 .github/workflows/test.yml       | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index e46629e9b..52c34a49e 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -113,6 +113,7 @@ jobs:
         with:
           name: docs-site-${{ matrix.lang }}
           path: ./site/**
+          include-hidden-files: true
 
   # https://github.com/marketplace/actions/alls-green#why
   docs-all-green:  # This job does nothing and is only used for the branch protection
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 0458f83ff..e9db49b51 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -91,6 +91,7 @@ jobs:
         with:
           name: coverage-${{ matrix.python-version }}-${{ matrix.pydantic-version }}
           path: coverage
+          include-hidden-files: true
 
   coverage-combine:
     needs: [test]
@@ -123,6 +124,7 @@ jobs:
         with:
           name: coverage-html
           path: htmlcov
+          include-hidden-files: true
 
   # https://github.com/marketplace/actions/alls-green#why
   check:  # This job does nothing and is only used for the branch protection

From a6ad088183d860c8f985a5e14f916efe77ff5011 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 2 Sep 2024 19:54:19 +0000
Subject: [PATCH 062/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index bc431dfac..4774f8af9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -35,6 +35,7 @@ hide:
 
 ### Internal
 
+* 💚 Set `include-hidden-files` to `True` when using the `upload-artifact` GH action. PR [#12118](https://github.com/fastapi/fastapi/pull/12118) by [@svlandeg](https://github.com/svlandeg).
 * ⬆ Bump pypa/gh-action-pypi-publish from 1.9.0 to 1.10.0. PR [#12112](https://github.com/fastapi/fastapi/pull/12112) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * 🔧 Update sponsors link: Coherence. PR [#12097](https://github.com/fastapi/fastapi/pull/12097) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update labeler config to handle sponsorships data. PR [#12096](https://github.com/fastapi/fastapi/pull/12096) by [@tiangolo](https://github.com/tiangolo).

From 6b3d1c6d4e84447e310584ee62eaa231636a63d3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 3 Sep 2024 15:15:17 +0200
Subject: [PATCH 063/146] =?UTF-8?q?=E2=AC=86=20Bump=20pillow=20from=2010.3?=
 =?UTF-8?q?.0=20to=2010.4.0=20(#12105)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [pillow](https://github.com/python-pillow/Pillow) from 10.3.0 to 10.4.0.
- [Release notes](https://github.com/python-pillow/Pillow/releases)
- [Changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst)
- [Commits](https://github.com/python-pillow/Pillow/compare/10.3.0...10.4.0)

---
updated-dependencies:
- dependency-name: pillow
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements-docs.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-docs.txt b/requirements-docs.txt
index ab2b0165b..332fd1857 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -8,7 +8,7 @@ pyyaml >=5.3.1,<7.0.0
 # For Material for MkDocs, Chinese search
 jieba==0.42.1
 # For image processing by Material for MkDocs
-pillow==10.3.0
+pillow==10.4.0
 # For image processing by Material for MkDocs
 cairosvg==2.7.1
 mkdocstrings[python]==0.25.1

From 7537bac43f1bcbf1edde837422cd4b720317c26b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 3 Sep 2024 13:15:41 +0000
Subject: [PATCH 064/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4774f8af9..27900f269 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -35,6 +35,7 @@ hide:
 
 ### Internal
 
+* ⬆ Bump pillow from 10.3.0 to 10.4.0. PR [#12105](https://github.com/fastapi/fastapi/pull/12105) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * 💚 Set `include-hidden-files` to `True` when using the `upload-artifact` GH action. PR [#12118](https://github.com/fastapi/fastapi/pull/12118) by [@svlandeg](https://github.com/svlandeg).
 * ⬆ Bump pypa/gh-action-pypi-publish from 1.9.0 to 1.10.0. PR [#12112](https://github.com/fastapi/fastapi/pull/12112) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * 🔧 Update sponsors link: Coherence. PR [#12097](https://github.com/fastapi/fastapi/pull/12097) by [@tiangolo](https://github.com/tiangolo).

From c1c57336b04d17077a142ec39724e9fb1a1d8bec Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Tue, 3 Sep 2024 10:43:56 -0300
Subject: [PATCH 065/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/security/index.md`=20(#12?=
 =?UTF-8?q?114)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/pt/docs/advanced/security/index.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 docs/pt/docs/advanced/security/index.md

diff --git a/docs/pt/docs/advanced/security/index.md b/docs/pt/docs/advanced/security/index.md
new file mode 100644
index 000000000..ae63f1c96
--- /dev/null
+++ b/docs/pt/docs/advanced/security/index.md
@@ -0,0 +1,19 @@
+# Segurança Avançada
+
+## Funcionalidades Adicionais
+
+Existem algumas funcionalidades adicionais para lidar com segurança além das cobertas em [Tutorial - Guia de Usuário: Segurança](../../tutorial/security/index.md){.internal-link target=_blank}.
+
+/// tip | "Dica"
+
+As próximas seções **não são necessariamente "avançadas"**.
+
+E é possível que para o seu caso de uso, a solução está em uma delas.
+
+///
+
+## Leia o Tutorial primeiro
+
+As próximas seções pressupõem que você já leu o principal [Tutorial - Guia de Usuário: Segurança](../../tutorial/security/index.md){.internal-link target=_blank}.
+
+Todas elas são baseadas nos mesmos conceitos, mas permitem algumas funcionalidades extras.

From e26229ed98f8c1e9ccfbf4274157c554e5cd80f3 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Tue, 3 Sep 2024 10:44:35 -0300
Subject: [PATCH 066/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/testing-events.md`=20(#12?=
 =?UTF-8?q?108)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/pt/docs/advanced/testing-events.md | 7 +++++++
 1 file changed, 7 insertions(+)
 create mode 100644 docs/pt/docs/advanced/testing-events.md

diff --git a/docs/pt/docs/advanced/testing-events.md b/docs/pt/docs/advanced/testing-events.md
new file mode 100644
index 000000000..392fb741c
--- /dev/null
+++ b/docs/pt/docs/advanced/testing-events.md
@@ -0,0 +1,7 @@
+# Testando Eventos: inicialização - encerramento
+
+Quando você precisa que os seus manipuladores de eventos (`startup` e `shutdown`) sejam executados em seus testes, você pode utilizar o `TestClient` usando a instrução `with`:
+
+```Python hl_lines="9-12  20-24"
+{!../../../docs_src/app_testing/tutorial003.py!}
+```

From 56cfecc1bfef14506d50eb46b676dc832b85b914 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 3 Sep 2024 13:44:55 +0000
Subject: [PATCH 067/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 27900f269..2f871a5c4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -30,6 +30,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/index.md`. PR [#12114](https://github.com/fastapi/fastapi/pull/12114) by [@ceb10n](https://github.com/ceb10n).
 * 🌐 Add Dutch translation for `docs/nl/docs/index.md`. PR [#12042](https://github.com/fastapi/fastapi/pull/12042) by [@svlandeg](https://github.com/svlandeg).
 * 🌐 Update Chinese translation for `docs/zh/docs/how-to/index.md`. PR [#12070](https://github.com/fastapi/fastapi/pull/12070) by [@synthpop123](https://github.com/synthpop123).
 

From 7d69943a22aada657b2326cec43ac6a3023d8203 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 3 Sep 2024 13:45:21 +0000
Subject: [PATCH 068/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2f871a5c4..a9acd0278 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -30,6 +30,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/testing-events.md`. PR [#12108](https://github.com/fastapi/fastapi/pull/12108) by [@ceb10n](https://github.com/ceb10n).
 * 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/index.md`. PR [#12114](https://github.com/fastapi/fastapi/pull/12114) by [@ceb10n](https://github.com/ceb10n).
 * 🌐 Add Dutch translation for `docs/nl/docs/index.md`. PR [#12042](https://github.com/fastapi/fastapi/pull/12042) by [@svlandeg](https://github.com/svlandeg).
 * 🌐 Update Chinese translation for `docs/zh/docs/how-to/index.md`. PR [#12070](https://github.com/fastapi/fastapi/pull/12070) by [@synthpop123](https://github.com/synthpop123).

From 7eae92544351036aa1ab0c70e7dea8e53eae97c9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 3 Sep 2024 15:47:08 +0200
Subject: [PATCH 069/146] =?UTF-8?q?=E2=AC=86=20Bump=20pypa/gh-action-pypi-?=
 =?UTF-8?q?publish=20from=201.10.0=20to=201.10.1=20(#12120)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) from 1.10.0 to 1.10.1.
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/v1.10.0...v1.10.1)

---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/publish.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 03f87d172..5004b94dd 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -35,7 +35,7 @@ jobs:
           TIANGOLO_BUILD_PACKAGE: ${{ matrix.package }}
         run: python -m build
       - name: Publish
-        uses: pypa/gh-action-pypi-publish@v1.10.0
+        uses: pypa/gh-action-pypi-publish@v1.10.1
       - name: Dump GitHub context
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}

From 560c43269dbd4b3c2964a69cfb1487567dfcb80e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 3 Sep 2024 13:49:34 +0000
Subject: [PATCH 070/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a9acd0278..a82965aa8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -37,6 +37,7 @@ hide:
 
 ### Internal
 
+* ⬆ Bump pypa/gh-action-pypi-publish from 1.10.0 to 1.10.1. PR [#12120](https://github.com/fastapi/fastapi/pull/12120) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump pillow from 10.3.0 to 10.4.0. PR [#12105](https://github.com/fastapi/fastapi/pull/12105) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * 💚 Set `include-hidden-files` to `True` when using the `upload-artifact` GH action. PR [#12118](https://github.com/fastapi/fastapi/pull/12118) by [@svlandeg](https://github.com/svlandeg).
 * ⬆ Bump pypa/gh-action-pypi-publish from 1.9.0 to 1.10.0. PR [#12112](https://github.com/fastapi/fastapi/pull/12112) by [@dependabot[bot]](https://github.com/apps/dependabot).

From 3feed9dd8c826a11354377c7a81b4d95382413d0 Mon Sep 17 00:00:00 2001
From: Max Scheijen <47034840+maxscheijen@users.noreply.github.com>
Date: Tue, 3 Sep 2024 15:50:38 +0200
Subject: [PATCH 071/146] =?UTF-8?q?=F0=9F=8C=90=20=20Add=20Dutch=20transla?=
 =?UTF-8?q?tion=20for=20`docs/nl/docs/features.md`=20(#12101)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/nl/docs/features.md | 201 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 201 insertions(+)
 create mode 100644 docs/nl/docs/features.md

diff --git a/docs/nl/docs/features.md b/docs/nl/docs/features.md
new file mode 100644
index 000000000..848b155ec
--- /dev/null
+++ b/docs/nl/docs/features.md
@@ -0,0 +1,201 @@
+# Functionaliteit
+
+## FastAPI functionaliteit
+
+**FastAPI** biedt je het volgende:
+
+### Gebaseerd op open standaarden
+
+* <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank"><strong>OpenAPI</strong></a> voor het maken van API's, inclusief declaraties van <abbr title="ook bekend als: endpoints, routess">pad</abbr><abbr title="ook bekend als HTTP-methoden, zoals POST, GET, PUT, DELETE">bewerkingen</abbr>, parameters, request bodies, beveiliging, enz.
+* Automatische datamodel documentatie met <a href="https://json-schema.org/" class="external-link" target="_blank"><strong>JSON Schema</strong></a> (aangezien OpenAPI zelf is gebaseerd op JSON Schema).
+* Ontworpen op basis van deze standaarden, na zorgvuldig onderzoek. In plaats van achteraf deze laag er bovenop te bouwen.
+* Dit maakt het ook mogelijk om automatisch **clientcode te genereren** in verschillende programmeertalen.
+
+### Automatische documentatie
+
+Interactieve API-documentatie en verkenning van webgebruikersinterfaces. Aangezien dit framework is gebaseerd op OpenAPI, zijn er meerdere documentatie opties mogelijk, waarvan er standaard 2 zijn inbegrepen.
+
+* <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank"><strong>Swagger UI</strong></a>, met interactieve interface, maakt het mogelijk je API rechtstreeks vanuit de browser aan te roepen en te testen.
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png)
+
+* Alternatieve API-documentatie met <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank"><strong>ReDoc</strong></a>.
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png)
+
+### Gewoon Moderne Python
+
+Het is allemaal gebaseerd op standaard **Python type** declaraties (dankzij Pydantic). Je hoeft dus geen nieuwe syntax te leren. Het is gewoon standaard moderne Python.
+
+Als je een opfriscursus van 2 minuten nodig hebt over het gebruik van Python types (zelfs als je FastAPI niet gebruikt), bekijk dan deze korte tutorial: [Python Types](python-types.md){.internal-link target=_blank}.
+
+Je schrijft gewoon standaard Python met types:
+
+```Python
+from datetime import date
+
+from pydantic import BaseModel
+
+# Declareer een variabele als een str
+# en krijg editorondersteuning in de functie
+def main(user_id: str):
+    return user_id
+
+
+# Een Pydantic model
+class User(BaseModel):
+    id: int
+    name: str
+    joined: date
+```
+
+Vervolgens kan je het op deze manier gebruiken:
+
+```Python
+my_user: User = User(id=3, name="John Doe", joined="2018-07-19")
+
+second_user_data = {
+    "id": 4,
+    "name": "Mary",
+    "joined": "2018-11-30",
+}
+
+my_second_user: User = User(**second_user_data)
+```
+
+/// info
+
+`**second_user_data` betekent:
+
+Geef de sleutels (keys) en waarden (values) van de `second_user_data` dict direct door als sleutel-waarden argumenten, gelijk aan: `User(id=4, name=“Mary”, joined=“2018-11-30”)`
+
+///
+
+### Editor-ondersteuning
+
+Het gehele framework is ontworpen om eenvoudig en intuïtief te zijn in gebruik. Alle beslissingen zijn getest op meerdere code-editors nog voordat het daadwerkelijke ontwikkelen begon, om zo de beste ontwikkelervaring te garanderen.
+
+Uit enquêtes onder Python ontwikkelaars blijkt maar al te duidelijk dat "(automatische) code aanvulling" <a href="https://www.jetbrains.com/research/python-developers-survey-2017/#tools-and-features" class="external-link" target="_blank">een van de meest gebruikte functionaliteiten is</a>.
+
+Het hele **FastAPI** framework is daarop gebaseerd. Automatische code aanvulling werkt overal.
+
+Je hoeft zelden terug te vallen op de documentatie.
+
+Zo kan je editor je helpen:
+
+* in <a href="https://code.visualstudio.com/" class="external-link" target="_blank">Visual Studio Code</a>:
+
+![editor ondersteuning](https://fastapi.tiangolo.com/img/vscode-completion.png)
+
+* in <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a>:
+
+![editor ondersteuning](https://fastapi.tiangolo.com/img/pycharm-completion.png)
+
+Je krijgt autocomletion die je voorheen misschien zelfs voor onmogelijk had gehouden. Zoals bijvoorbeeld de `price` key in een JSON body (die genest had kunnen zijn) die afkomstig is van een request.
+
+Je hoeft niet langer de verkeerde keys in te typen, op en neer te gaan tussen de documentatie, of heen en weer te scrollen om te checken of je `username` of toch `user_name` had gebruikt.
+
+### Kort
+
+Dit framework heeft voor alles verstandige **standaardinstellingen**, met overal optionele configuraties. Alle parameters kunnen worden verfijnd zodat het past bij wat je nodig hebt, om zo de API te kunnen definiëren die jij nodig hebt.
+
+Maar standaard werkt alles **“gewoon”**.
+
+### Validatie
+
+* Validatie voor de meeste (of misschien wel alle?) Python **datatypes**, inclusief:
+    * JSON objecten (`dict`).
+    * JSON array (`list`) die itemtypes definiëren.
+    * String (`str`) velden, die min en max lengtes hebben.
+    * Getallen (`int`, `float`) met min en max waarden, enz.
+
+* Validatie voor meer exotische typen, zoals:
+    * URL.
+    * E-mail.
+    * UUID.
+    * ...en anderen.
+
+Alle validatie wordt uitgevoerd door het beproefde en robuuste **Pydantic**.
+
+### Beveiliging en authenticatie
+
+Beveiliging en authenticatie is geïntegreerd. Zonder compromissen te doen naar databases of datamodellen.
+
+Alle beveiligingsschema's gedefinieerd in OpenAPI, inclusief:
+
+* HTTP Basic.
+* **OAuth2** (ook met **JWT tokens**). Bekijk de tutorial over [OAuth2 with JWT](tutorial/security/oauth2-jwt.md){.internal-link target=_blank}.
+* API keys in:
+    * Headers.
+    * Query parameters.
+    * Cookies, enz.
+
+Plus alle beveiligingsfuncties van Starlette (inclusief **sessiecookies**).
+
+Gebouwd als een herbruikbare tool met componenten die makkelijk te integreren zijn in en met je systemen, datastores, relationele en NoSQL databases, enz.
+
+### Dependency Injection
+
+FastAPI bevat een uiterst eenvoudig, maar uiterst krachtig <abbr title='ook bekend als "componenten", "bronnen", "diensten", "aanbieders"'><strong>Dependency Injection</strong></abbr> systeem.
+
+* Zelfs dependencies kunnen dependencies hebben, waardoor een hiërarchie of **“graph” van dependencies** ontstaat.
+* Allemaal **automatisch afgehandeld** door het framework.
+* Alle dependencies kunnen data nodig hebben van request, de vereiste **padoperaties veranderen** en automatische documentatie verstrekken.
+* **Automatische validatie** zelfs voor *padoperatie* parameters gedefinieerd in dependencies.
+* Ondersteuning voor complexe gebruikersauthenticatiesystemen, **databaseverbindingen**, enz.
+* **Geen compromisen** met databases, gebruikersinterfaces, enz. Maar eenvoudige integratie met ze allemaal.
+
+### Ongelimiteerde "plug-ins"
+
+Of anders gezegd, je hebt ze niet nodig, importeer en gebruik de code die je nodig hebt.
+
+Elke integratie is ontworpen om eenvoudig te gebruiken (met afhankelijkheden), zodat je een “plug-in" kunt maken in 2 regels code, met dezelfde structuur en syntax die wordt gebruikt voor je *padbewerkingen*.
+
+### Getest
+
+* 100% <abbr title="De hoeveelheid code die automatisch wordt getest">van de code is getest</abbr>.
+* 100% <abbr title="Python type annotaties, hiermee kunnen je editor en externe tools je beter ondersteunen">type geannoteerde</abbr> codebase.
+* Wordt gebruikt in productietoepassingen.
+
+## Starlette functies
+
+**FastAPI** is volledig verenigbaar met (en gebaseerd op) <a href="https://www.starlette.io/" class="external-link" target="_blank"><strong>Starlette</strong></a>.
+
+`FastAPI` is eigenlijk een subklasse van `Starlette`. Dus als je Starlette al kent of gebruikt, zal de meeste functionaliteit op dezelfde manier werken.
+
+Met **FastAPI** krijg je alle functies van **Starlette** (FastAPI is gewoon Starlette op steroïden):
+
+* Zeer indrukwekkende prestaties. Het is <a href="https://github.com/encode/starlette#performance" class="external-link" target="_blank">een van de snelste Python frameworks, vergelijkbaar met **NodeJS** en **Go**</a>.
+* **WebSocket** ondersteuning.
+* Taken in de achtergrond tijdens het proces.
+* Opstart- en afsluit events.
+* Test client gebouwd op HTTPX.
+* **CORS**, GZip, Statische bestanden, Streaming reacties.
+* **Sessie en Cookie** ondersteuning.
+* 100% van de code is getest.
+* 100% type geannoteerde codebase.
+
+## Pydantic functionaliteit
+
+**FastAPI** is volledig verenigbaar met (en gebaseerd op) Pydantic. Dus alle extra <a href="https://docs.pydantic.dev/" class="external-link" target="_blank"><strong>Pydantic</strong></a> code die je nog hebt werkt ook.
+
+Inclusief externe pakketten die ook gebaseerd zijn op Pydantic, zoals <abbr title="Object-Relational Mapper">ORM</abbr>s, <abbr title="Object-Document Mapper">ODM</abbr>s voor databases.
+
+Dit betekent ook dat je in veel gevallen het object dat je van een request krijgt **direct naar je database** kunt sturen, omdat alles automatisch wordt gevalideerd.
+
+Hetzelfde geldt ook andersom, in veel gevallen kun je dus het object dat je krijgt van de database **direct doorgeven aan de client**.
+
+Met **FastAPI** krijg je alle functionaliteit van **Pydantic** (omdat FastAPI is gebaseerd op Pydantic voor alle dataverwerking):
+
+* **Geen brainfucks**:
+    * Je hoeft geen nieuwe microtaal voor schemadefinities te leren.
+    * Als je bekend bent Python types, weet je hoe je Pydantic moet gebruiken.
+* Werkt goed samen met je **<abbr title=“Integrated Development Environment, vergelijkbaar met een code editor”>IDE</abbr>/<abbr title=“Een programma dat controleert op fouten in de code”>linter</abbr>/hersenen**:
+    * Doordat pydantic's datastructuren enkel instanties zijn van klassen, die je definieert, werkt automatische aanvulling, linting, mypy en je intuïtie allemaal goed met je gevalideerde data.
+* Valideer **complexe structuren**:
+    * Gebruik van hiërarchische Pydantic modellen, Python `typing`'s `List` en `Dict`, enz.
+    * Met validators kunnen complexe dataschema's duidelijk en eenvoudig worden gedefinieerd, gecontroleerd en gedocumenteerd als JSON Schema.
+    * Je kunt diep **geneste JSON** objecten laten valideren en annoteren.
+* **Uitbreidbaar**:
+    * Met Pydantic kunnen op maat gemaakte datatypen worden gedefinieerd of je kunt validatie uitbreiden met methoden op een model dat is ingericht met de decorator validator.
+* 100% van de code is getest.

From cbdc58b1b75a7e94c78d3dca39f0564bd071d190 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 3 Sep 2024 13:54:00 +0000
Subject: [PATCH 072/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a82965aa8..df4927752 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -30,6 +30,7 @@ hide:
 
 ### Translations
 
+* 🌐  Add Dutch translation for `docs/nl/docs/features.md`. PR [#12101](https://github.com/fastapi/fastapi/pull/12101) by [@maxscheijen](https://github.com/maxscheijen).
 * 🌐 Add Portuguese translation for `docs/pt/docs/advanced/testing-events.md`. PR [#12108](https://github.com/fastapi/fastapi/pull/12108) by [@ceb10n](https://github.com/ceb10n).
 * 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/index.md`. PR [#12114](https://github.com/fastapi/fastapi/pull/12114) by [@ceb10n](https://github.com/ceb10n).
 * 🌐 Add Dutch translation for `docs/nl/docs/index.md`. PR [#12042](https://github.com/fastapi/fastapi/pull/12042) by [@svlandeg](https://github.com/svlandeg).

From f42fd9aac2529c1bda6b81fe9cecce0986dadbf3 Mon Sep 17 00:00:00 2001
From: Shubhendra Kushwaha <shubhendrakushwaha94@gmail.com>
Date: Tue, 3 Sep 2024 21:35:19 +0530
Subject: [PATCH 073/146] =?UTF-8?q?=F0=9F=93=9D=20Add=20External=20Link:?=
 =?UTF-8?q?=20Techniques=20and=20applications=20of=20SQLAlchemy=20global?=
 =?UTF-8?q?=20filters=20in=20FastAPI=20(#12109)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/data/external_links.yml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/en/data/external_links.yml b/docs/en/data/external_links.yml
index 15f6169ee..63fd3d0cf 100644
--- a/docs/en/data/external_links.yml
+++ b/docs/en/data/external_links.yml
@@ -264,6 +264,14 @@ Articles:
     author_link: https://devonray.com
     link: https://devonray.com/blog/deploying-a-fastapi-project-using-aws-lambda-aurora-cdk
     title: Deployment using Docker, Lambda, Aurora, CDK & GH Actions
+  - author: Shubhendra Kushwaha
+    author_link: https://www.linkedin.com/in/theshubhendra/
+    link: https://theshubhendra.medium.com/mastering-soft-delete-advanced-sqlalchemy-techniques-4678f4738947
+    title: 'Mastering Soft Delete: Advanced SQLAlchemy Techniques'
+  - author: Shubhendra Kushwaha
+    author_link: https://www.linkedin.com/in/theshubhendra/
+    link: https://theshubhendra.medium.com/role-based-row-filtering-advanced-sqlalchemy-techniques-733e6b1328f6
+    title: 'Role based row filtering: Advanced SQLAlchemy Techniques'
   German:
   - author: Marcel Sander (actidoo)
     author_link: https://www.actidoo.com

From 9b2a9333b3b9820082deb35605c0619bd578baee Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 3 Sep 2024 16:05:42 +0000
Subject: [PATCH 074/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index df4927752..70dbce539 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -17,6 +17,7 @@ hide:
 
 ### Docs
 
+* 📝 Add External Link: Techniques and applications of SQLAlchemy global filters in FastAPI. PR [#12109](https://github.com/fastapi/fastapi/pull/12109) by [@TheShubhendra](https://github.com/TheShubhendra).
 * 📝 Add note about `time.perf_counter()` in middlewares. PR [#12095](https://github.com/fastapi/fastapi/pull/12095) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Tweak middleware code sample `time.time()` to `time.perf_counter()`. PR [#11957](https://github.com/fastapi/fastapi/pull/11957) by [@domdent](https://github.com/domdent).
 * 🔧 Update sponsors: Coherence. PR [#12093](https://github.com/fastapi/fastapi/pull/12093) by [@tiangolo](https://github.com/tiangolo).

From 1f64a1bb551829b57f0b8403ce4aab641a6ee11d Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 5 Sep 2024 11:07:32 +0200
Subject: [PATCH 075/146] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
 =?UTF-8?q?t=20autoupdate=20(#12115)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* ⬆ [pre-commit.ci] pre-commit autoupdate

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.2 → v0.6.3](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.2...v0.6.3)

* bump ruff as well

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
Co-authored-by: svlandeg <svlandeg@github.com>
---
 .pre-commit-config.yaml | 2 +-
 requirements-tests.txt  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 317514062..7e58afd4b 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -14,7 +14,7 @@ repos:
     -   id: end-of-file-fixer
     -   id: trailing-whitespace
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.2
+    rev: v0.6.3
     hooks:
     -   id: ruff
         args:
diff --git a/requirements-tests.txt b/requirements-tests.txt
index 08561d23a..de5fdb8a2 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -3,7 +3,7 @@
 pytest >=7.1.3,<8.0.0
 coverage[toml] >= 6.5.0,< 8.0
 mypy ==1.8.0
-ruff ==0.6.1
+ruff ==0.6.3
 dirty-equals ==0.6.0
 # TODO: once removing databases from tutorial, upgrade SQLAlchemy
 # probably when including SQLModel

From 68e5ef6968f8a2799d9db927b5db5b8e86d8b5f0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 09:07:55 +0000
Subject: [PATCH 076/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 70dbce539..c54971b73 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -39,6 +39,7 @@ hide:
 
 ### Internal
 
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12115](https://github.com/fastapi/fastapi/pull/12115) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
 * ⬆ Bump pypa/gh-action-pypi-publish from 1.10.0 to 1.10.1. PR [#12120](https://github.com/fastapi/fastapi/pull/12120) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump pillow from 10.3.0 to 10.4.0. PR [#12105](https://github.com/fastapi/fastapi/pull/12105) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * 💚 Set `include-hidden-files` to `True` when using the `upload-artifact` GH action. PR [#12118](https://github.com/fastapi/fastapi/pull/12118) by [@svlandeg](https://github.com/svlandeg).

From 7213d421f5bf0a4b9b8815e69a141550b4fc3f09 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 11:13:32 +0200
Subject: [PATCH 077/146] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
 =?UTF-8?q?2.3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 fastapi/__init__.py           | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c54971b73..cdd6cdc90 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+## 0.112.3
+
+This release is mainly internal refactors, it shouldn't affect apps using FastAPI in any way. You don't even have to upgrade to this version yet. There are a few bigger releases coming right after. 🚀
+
 ### Refactors
 
 * ♻️ Refactor internal `check_file_field()`, rename to `ensure_multipart_is_installed()` to clarify its purpose. PR [#12106](https://github.com/fastapi/fastapi/pull/12106) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index ac2508d89..1bc1bfd82 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.112.2"
+__version__ = "0.112.3"
 
 from starlette import status as status
 

From aa21814a89853c17c139054a5c51f0bb1ea68a0a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 13:24:36 +0200
Subject: [PATCH 078/146] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Refactor=20decidin?=
 =?UTF-8?q?g=20if=20`embed`=20body=20fields,=20do=20not=20overwrite=20fiel?=
 =?UTF-8?q?ds,=20compute=20once=20per=20router,=20refactor=20internals=20i?=
 =?UTF-8?q?n=20preparation=20for=20Pydantic=20models=20in=20`Form`,=20`Que?=
 =?UTF-8?q?ry`=20and=20others=20(#12117)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/_compat.py               |  15 ++
 fastapi/dependencies/utils.py    | 300 ++++++++++++++++++-------------
 fastapi/param_functions.py       |   4 +-
 fastapi/params.py                |   3 +-
 fastapi/routing.py               |  26 ++-
 tests/test_compat.py             |  13 +-
 tests/test_forms_single_param.py |  99 ++++++++++
 7 files changed, 324 insertions(+), 136 deletions(-)
 create mode 100644 tests/test_forms_single_param.py

diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index 06b847b4f..f940d6597 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -279,6 +279,12 @@ if PYDANTIC_V2:
         BodyModel: Type[BaseModel] = create_model(model_name, **field_params)  # type: ignore[call-overload]
         return BodyModel
 
+    def get_model_fields(model: Type[BaseModel]) -> List[ModelField]:
+        return [
+            ModelField(field_info=field_info, name=name)
+            for name, field_info in model.model_fields.items()
+        ]
+
 else:
     from fastapi.openapi.constants import REF_PREFIX as REF_PREFIX
     from pydantic import AnyUrl as Url  # noqa: F401
@@ -513,6 +519,9 @@ else:
             BodyModel.__fields__[f.name] = f  # type: ignore[index]
         return BodyModel
 
+    def get_model_fields(model: Type[BaseModel]) -> List[ModelField]:
+        return list(model.__fields__.values())  # type: ignore[attr-defined]
+
 
 def _regenerate_error_with_loc(
     *, errors: Sequence[Any], loc_prefix: Tuple[Union[str, int], ...]
@@ -532,6 +541,12 @@ def _annotation_is_sequence(annotation: Union[Type[Any], None]) -> bool:
 
 
 def field_annotation_is_sequence(annotation: Union[Type[Any], None]) -> bool:
+    origin = get_origin(annotation)
+    if origin is Union or origin is UnionType:
+        for arg in get_args(annotation):
+            if field_annotation_is_sequence(arg):
+                return True
+        return False
     return _annotation_is_sequence(annotation) or _annotation_is_sequence(
         get_origin(annotation)
     )
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 0dcba62f1..7ac18d941 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -59,7 +59,13 @@ from fastapi.utils import create_model_field, get_path_param_names
 from pydantic.fields import FieldInfo
 from starlette.background import BackgroundTasks as StarletteBackgroundTasks
 from starlette.concurrency import run_in_threadpool
-from starlette.datastructures import FormData, Headers, QueryParams, UploadFile
+from starlette.datastructures import (
+    FormData,
+    Headers,
+    ImmutableMultiDict,
+    QueryParams,
+    UploadFile,
+)
 from starlette.requests import HTTPConnection, Request
 from starlette.responses import Response
 from starlette.websockets import WebSocket
@@ -282,7 +288,7 @@ def get_dependant(
             ), f"Cannot specify multiple FastAPI annotations for {param_name!r}"
             continue
         assert param_details.field is not None
-        if is_body_param(param_field=param_details.field, is_path_param=is_path_param):
+        if isinstance(param_details.field.field_info, params.Body):
             dependant.body_params.append(param_details.field)
         else:
             add_param_to_fields(field=param_details.field, dependant=dependant)
@@ -466,29 +472,16 @@ def analyze_param(
             required=field_info.default in (Required, Undefined),
             field_info=field_info,
         )
+        if is_path_param:
+            assert is_scalar_field(
+                field=field
+            ), "Path params must be of one of the supported types"
+        elif isinstance(field_info, params.Query):
+            assert is_scalar_field(field) or is_scalar_sequence_field(field)
 
     return ParamDetails(type_annotation=type_annotation, depends=depends, field=field)
 
 
-def is_body_param(*, param_field: ModelField, is_path_param: bool) -> bool:
-    if is_path_param:
-        assert is_scalar_field(
-            field=param_field
-        ), "Path params must be of one of the supported types"
-        return False
-    elif is_scalar_field(field=param_field):
-        return False
-    elif isinstance(
-        param_field.field_info, (params.Query, params.Header)
-    ) and is_scalar_sequence_field(param_field):
-        return False
-    else:
-        assert isinstance(
-            param_field.field_info, params.Body
-        ), f"Param: {param_field.name} can only be a request body, using Body()"
-        return True
-
-
 def add_param_to_fields(*, field: ModelField, dependant: Dependant) -> None:
     field_info = field.field_info
     field_info_in = getattr(field_info, "in_", None)
@@ -557,6 +550,7 @@ async def solve_dependencies(
     dependency_overrides_provider: Optional[Any] = None,
     dependency_cache: Optional[Dict[Tuple[Callable[..., Any], Tuple[str]], Any]] = None,
     async_exit_stack: AsyncExitStack,
+    embed_body_fields: bool,
 ) -> SolvedDependency:
     values: Dict[str, Any] = {}
     errors: List[Any] = []
@@ -598,6 +592,7 @@ async def solve_dependencies(
             dependency_overrides_provider=dependency_overrides_provider,
             dependency_cache=dependency_cache,
             async_exit_stack=async_exit_stack,
+            embed_body_fields=embed_body_fields,
         )
         background_tasks = solved_result.background_tasks
         dependency_cache.update(solved_result.dependency_cache)
@@ -640,7 +635,9 @@ async def solve_dependencies(
             body_values,
             body_errors,
         ) = await request_body_to_args(  # body_params checked above
-            required_params=dependant.body_params, received_body=body
+            body_fields=dependant.body_params,
+            received_body=body,
+            embed_body_fields=embed_body_fields,
         )
         values.update(body_values)
         errors.extend(body_errors)
@@ -669,138 +666,185 @@ async def solve_dependencies(
     )
 
 
+def _validate_value_with_model_field(
+    *, field: ModelField, value: Any, values: Dict[str, Any], loc: Tuple[str, ...]
+) -> Tuple[Any, List[Any]]:
+    if value is None:
+        if field.required:
+            return None, [get_missing_field_error(loc=loc)]
+        else:
+            return deepcopy(field.default), []
+    v_, errors_ = field.validate(value, values, loc=loc)
+    if isinstance(errors_, ErrorWrapper):
+        return None, [errors_]
+    elif isinstance(errors_, list):
+        new_errors = _regenerate_error_with_loc(errors=errors_, loc_prefix=())
+        return None, new_errors
+    else:
+        return v_, []
+
+
+def _get_multidict_value(field: ModelField, values: Mapping[str, Any]) -> Any:
+    if is_sequence_field(field) and isinstance(values, (ImmutableMultiDict, Headers)):
+        value = values.getlist(field.alias)
+    else:
+        value = values.get(field.alias, None)
+    if (
+        value is None
+        or (
+            isinstance(field.field_info, params.Form)
+            and isinstance(value, str)  # For type checks
+            and value == ""
+        )
+        or (is_sequence_field(field) and len(value) == 0)
+    ):
+        if field.required:
+            return
+        else:
+            return deepcopy(field.default)
+    return value
+
+
 def request_params_to_args(
-    required_params: Sequence[ModelField],
+    fields: Sequence[ModelField],
     received_params: Union[Mapping[str, Any], QueryParams, Headers],
 ) -> Tuple[Dict[str, Any], List[Any]]:
-    values = {}
+    values: Dict[str, Any] = {}
     errors = []
-    for field in required_params:
-        if is_scalar_sequence_field(field) and isinstance(
-            received_params, (QueryParams, Headers)
-        ):
-            value = received_params.getlist(field.alias) or field.default
-        else:
-            value = received_params.get(field.alias)
+    for field in fields:
+        value = _get_multidict_value(field, received_params)
         field_info = field.field_info
         assert isinstance(
             field_info, params.Param
         ), "Params must be subclasses of Param"
         loc = (field_info.in_.value, field.alias)
-        if value is None:
-            if field.required:
-                errors.append(get_missing_field_error(loc=loc))
-            else:
-                values[field.name] = deepcopy(field.default)
-            continue
-        v_, errors_ = field.validate(value, values, loc=loc)
-        if isinstance(errors_, ErrorWrapper):
-            errors.append(errors_)
-        elif isinstance(errors_, list):
-            new_errors = _regenerate_error_with_loc(errors=errors_, loc_prefix=())
-            errors.extend(new_errors)
+        v_, errors_ = _validate_value_with_model_field(
+            field=field, value=value, values=values, loc=loc
+        )
+        if errors_:
+            errors.extend(errors_)
         else:
             values[field.name] = v_
     return values, errors
 
 
+def _should_embed_body_fields(fields: List[ModelField]) -> bool:
+    if not fields:
+        return False
+    # More than one dependency could have the same field, it would show up as multiple
+    # fields but it's the same one, so count them by name
+    body_param_names_set = {field.name for field in fields}
+    # A top level field has to be a single field, not multiple
+    if len(body_param_names_set) > 1:
+        return True
+    first_field = fields[0]
+    # If it explicitly specifies it is embedded, it has to be embedded
+    if getattr(first_field.field_info, "embed", None):
+        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):
+        return True
+    return False
+
+
+async def _extract_form_body(
+    body_fields: List[ModelField],
+    received_body: FormData,
+) -> Dict[str, Any]:
+    values = {}
+    first_field = body_fields[0]
+    first_field_info = first_field.field_info
+
+    for field in body_fields:
+        value = _get_multidict_value(field, received_body)
+        if (
+            isinstance(first_field_info, params.File)
+            and is_bytes_field(field)
+            and isinstance(value, UploadFile)
+        ):
+            value = await value.read()
+        elif (
+            is_bytes_sequence_field(field)
+            and isinstance(first_field_info, params.File)
+            and value_is_sequence(value)
+        ):
+            # For types
+            assert isinstance(value, sequence_types)  # type: ignore[arg-type]
+            results: List[Union[bytes, str]] = []
+
+            async def process_fn(
+                fn: Callable[[], Coroutine[Any, Any, Any]],
+            ) -> None:
+                result = await fn()
+                results.append(result)  # noqa: B023
+
+            async with anyio.create_task_group() as tg:
+                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
+    return values
+
+
 async def request_body_to_args(
-    required_params: List[ModelField],
+    body_fields: List[ModelField],
     received_body: Optional[Union[Dict[str, Any], FormData]],
+    embed_body_fields: bool,
 ) -> Tuple[Dict[str, Any], List[Dict[str, Any]]]:
-    values = {}
+    values: Dict[str, Any] = {}
     errors: List[Dict[str, Any]] = []
-    if required_params:
-        field = required_params[0]
-        field_info = field.field_info
-        embed = getattr(field_info, "embed", None)
-        field_alias_omitted = len(required_params) == 1 and not embed
-        if field_alias_omitted:
-            received_body = {field.alias: received_body}
-
-        for field in required_params:
-            loc: Tuple[str, ...]
-            if field_alias_omitted:
-                loc = ("body",)
-            else:
-                loc = ("body", field.alias)
-
-            value: Optional[Any] = None
-            if received_body is not None:
-                if (is_sequence_field(field)) and isinstance(received_body, FormData):
-                    value = received_body.getlist(field.alias)
-                else:
-                    try:
-                        value = received_body.get(field.alias)
-                    except AttributeError:
-                        errors.append(get_missing_field_error(loc))
-                        continue
-            if (
-                value is None
-                or (isinstance(field_info, params.Form) and value == "")
-                or (
-                    isinstance(field_info, params.Form)
-                    and is_sequence_field(field)
-                    and len(value) == 0
-                )
-            ):
-                if field.required:
-                    errors.append(get_missing_field_error(loc))
-                else:
-                    values[field.name] = deepcopy(field.default)
+    assert body_fields, "request_body_to_args() should be called with fields"
+    single_not_embedded_field = len(body_fields) == 1 and not embed_body_fields
+    first_field = body_fields[0]
+    body_to_process = received_body
+    if isinstance(received_body, FormData):
+        body_to_process = await _extract_form_body(body_fields, received_body)
+
+    if single_not_embedded_field:
+        loc: Tuple[str, ...] = ("body",)
+        v_, errors_ = _validate_value_with_model_field(
+            field=first_field, value=body_to_process, values=values, loc=loc
+        )
+        return {first_field.name: v_}, errors_
+    for field in body_fields:
+        loc = ("body", field.alias)
+        value: Optional[Any] = None
+        if body_to_process is not None:
+            try:
+                value = body_to_process.get(field.alias)
+            # If the received body is a list, not a dict
+            except AttributeError:
+                errors.append(get_missing_field_error(loc))
                 continue
-            if (
-                isinstance(field_info, params.File)
-                and is_bytes_field(field)
-                and isinstance(value, UploadFile)
-            ):
-                value = await value.read()
-            elif (
-                is_bytes_sequence_field(field)
-                and isinstance(field_info, params.File)
-                and value_is_sequence(value)
-            ):
-                # For types
-                assert isinstance(value, sequence_types)  # type: ignore[arg-type]
-                results: List[Union[bytes, str]] = []
-
-                async def process_fn(
-                    fn: Callable[[], Coroutine[Any, Any, Any]],
-                ) -> None:
-                    result = await fn()
-                    results.append(result)  # noqa: B023
-
-                async with anyio.create_task_group() as tg:
-                    for sub_value in value:
-                        tg.start_soon(process_fn, sub_value.read)
-                value = serialize_sequence_value(field=field, value=results)
-
-            v_, errors_ = field.validate(value, values, loc=loc)
-
-            if isinstance(errors_, list):
-                errors.extend(errors_)
-            elif errors_:
-                errors.append(errors_)
-            else:
-                values[field.name] = v_
+        v_, errors_ = _validate_value_with_model_field(
+            field=field, value=value, values=values, loc=loc
+        )
+        if errors_:
+            errors.extend(errors_)
+        else:
+            values[field.name] = v_
     return values, errors
 
 
-def get_body_field(*, dependant: Dependant, name: str) -> Optional[ModelField]:
-    flat_dependant = get_flat_dependant(dependant)
+def get_body_field(
+    *, flat_dependant: Dependant, name: str, embed_body_fields: bool
+) -> Optional[ModelField]:
+    """
+    Get a ModelField representing the request body for a path operation, combining
+    all body parameters into a single field if necessary.
+
+    Used to check if it's form data (with `isinstance(body_field, params.Form)`)
+    or JSON and to generate the JSON Schema for a request body.
+
+    This is **not** used to validate/parse the request body, that's done with each
+    individual body parameter.
+    """
     if not flat_dependant.body_params:
         return None
     first_param = flat_dependant.body_params[0]
-    field_info = first_param.field_info
-    embed = getattr(field_info, "embed", None)
-    body_param_names_set = {param.name for param in flat_dependant.body_params}
-    if len(body_param_names_set) == 1 and not embed:
+    if not embed_body_fields:
         return first_param
-    # If one field requires to embed, all have to be embedded
-    # in case a sub-dependency is evaluated with a single unique body field
-    # That is combined (embedded) with other body fields
-    for param in flat_dependant.body_params:
-        setattr(param.field_info, "embed", True)  # noqa: B010
     model_name = "Body_" + name
     BodyModel = create_body_model(
         fields=flat_dependant.body_params, model_name=model_name
diff --git a/fastapi/param_functions.py b/fastapi/param_functions.py
index 0d5f27af4..7ddaace25 100644
--- a/fastapi/param_functions.py
+++ b/fastapi/param_functions.py
@@ -1282,7 +1282,7 @@ def Body(  # noqa: N802
         ),
     ] = _Unset,
     embed: Annotated[
-        bool,
+        Union[bool, None],
         Doc(
             """
             When `embed` is `True`, the parameter will be expected in a JSON body as a
@@ -1294,7 +1294,7 @@ def Body(  # noqa: N802
             [FastAPI docs for Body - Multiple Parameters](https://fastapi.tiangolo.com/tutorial/body-multiple-params/#embed-a-single-body-parameter).
             """
         ),
-    ] = False,
+    ] = None,
     media_type: Annotated[
         str,
         Doc(
diff --git a/fastapi/params.py b/fastapi/params.py
index cc2a5c13c..3dfa5a1a3 100644
--- a/fastapi/params.py
+++ b/fastapi/params.py
@@ -479,7 +479,7 @@ class Body(FieldInfo):
         *,
         default_factory: Union[Callable[[], Any], None] = _Unset,
         annotation: Optional[Any] = None,
-        embed: bool = False,
+        embed: Union[bool, None] = None,
         media_type: str = "application/json",
         alias: Optional[str] = None,
         alias_priority: Union[int, None] = _Unset,
@@ -642,7 +642,6 @@ class Form(Body):
             default=default,
             default_factory=default_factory,
             annotation=annotation,
-            embed=True,
             media_type=media_type,
             alias=alias,
             alias_priority=alias_priority,
diff --git a/fastapi/routing.py b/fastapi/routing.py
index 61a112fc4..86e303602 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -33,8 +33,10 @@ from fastapi._compat import (
 from fastapi.datastructures import Default, DefaultPlaceholder
 from fastapi.dependencies.models import Dependant
 from fastapi.dependencies.utils import (
+    _should_embed_body_fields,
     get_body_field,
     get_dependant,
+    get_flat_dependant,
     get_parameterless_sub_dependant,
     get_typed_return_annotation,
     solve_dependencies,
@@ -225,6 +227,7 @@ def get_request_handler(
     response_model_exclude_defaults: bool = False,
     response_model_exclude_none: bool = False,
     dependency_overrides_provider: Optional[Any] = None,
+    embed_body_fields: bool = False,
 ) -> Callable[[Request], Coroutine[Any, Any, Response]]:
     assert dependant.call is not None, "dependant.call must be a function"
     is_coroutine = asyncio.iscoroutinefunction(dependant.call)
@@ -291,6 +294,7 @@ def get_request_handler(
                     body=body,
                     dependency_overrides_provider=dependency_overrides_provider,
                     async_exit_stack=async_exit_stack,
+                    embed_body_fields=embed_body_fields,
                 )
                 errors = solved_result.errors
                 if not errors:
@@ -354,7 +358,9 @@ def get_request_handler(
 
 
 def get_websocket_app(
-    dependant: Dependant, dependency_overrides_provider: Optional[Any] = None
+    dependant: Dependant,
+    dependency_overrides_provider: Optional[Any] = None,
+    embed_body_fields: bool = False,
 ) -> Callable[[WebSocket], Coroutine[Any, Any, Any]]:
     async def app(websocket: WebSocket) -> None:
         async with AsyncExitStack() as async_exit_stack:
@@ -367,6 +373,7 @@ def get_websocket_app(
                 dependant=dependant,
                 dependency_overrides_provider=dependency_overrides_provider,
                 async_exit_stack=async_exit_stack,
+                embed_body_fields=embed_body_fields,
             )
             if solved_result.errors:
                 raise WebSocketRequestValidationError(
@@ -399,11 +406,15 @@ class APIWebSocketRoute(routing.WebSocketRoute):
                 0,
                 get_parameterless_sub_dependant(depends=depends, path=self.path_format),
             )
-
+        self._flat_dependant = get_flat_dependant(self.dependant)
+        self._embed_body_fields = _should_embed_body_fields(
+            self._flat_dependant.body_params
+        )
         self.app = websocket_session(
             get_websocket_app(
                 dependant=self.dependant,
                 dependency_overrides_provider=dependency_overrides_provider,
+                embed_body_fields=self._embed_body_fields,
             )
         )
 
@@ -544,7 +555,15 @@ class APIRoute(routing.Route):
                 0,
                 get_parameterless_sub_dependant(depends=depends, path=self.path_format),
             )
-        self.body_field = get_body_field(dependant=self.dependant, name=self.unique_id)
+        self._flat_dependant = get_flat_dependant(self.dependant)
+        self._embed_body_fields = _should_embed_body_fields(
+            self._flat_dependant.body_params
+        )
+        self.body_field = get_body_field(
+            flat_dependant=self._flat_dependant,
+            name=self.unique_id,
+            embed_body_fields=self._embed_body_fields,
+        )
         self.app = request_response(self.get_route_handler())
 
     def get_route_handler(self) -> Callable[[Request], Coroutine[Any, Any, Response]]:
@@ -561,6 +580,7 @@ class APIRoute(routing.Route):
             response_model_exclude_defaults=self.response_model_exclude_defaults,
             response_model_exclude_none=self.response_model_exclude_none,
             dependency_overrides_provider=self.dependency_overrides_provider,
+            embed_body_fields=self._embed_body_fields,
         )
 
     def matches(self, scope: Scope) -> Tuple[Match, Scope]:
diff --git a/tests/test_compat.py b/tests/test_compat.py
index bf268b860..270475bf3 100644
--- a/tests/test_compat.py
+++ b/tests/test_compat.py
@@ -1,11 +1,13 @@
-from typing import List, Union
+from typing import Any, Dict, List, Union
 
 from fastapi import FastAPI, UploadFile
 from fastapi._compat import (
     ModelField,
     Undefined,
     _get_model_config,
+    get_model_fields,
     is_bytes_sequence_annotation,
+    is_scalar_field,
     is_uploadfile_sequence_annotation,
 )
 from fastapi.testclient import TestClient
@@ -91,3 +93,12 @@ def test_is_uploadfile_sequence_annotation():
     # and other types, but I'm not even sure it's a good idea to support it as a first
     # class "feature"
     assert is_uploadfile_sequence_annotation(Union[List[str], List[UploadFile]])
+
+
+def test_is_pv1_scalar_field():
+    # For coverage
+    class Model(BaseModel):
+        foo: Union[str, Dict[str, Any]]
+
+    fields = get_model_fields(Model)
+    assert not is_scalar_field(fields[0])
diff --git a/tests/test_forms_single_param.py b/tests/test_forms_single_param.py
new file mode 100644
index 000000000..3bb951441
--- /dev/null
+++ b/tests/test_forms_single_param.py
@@ -0,0 +1,99 @@
+from fastapi import FastAPI, Form
+from fastapi.testclient import TestClient
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+@app.post("/form/")
+def post_form(username: Annotated[str, Form()]):
+    return username
+
+
+client = TestClient(app)
+
+
+def test_single_form_field():
+    response = client.post("/form/", data={"username": "Rick"})
+    assert response.status_code == 200, response.text
+    assert response.json() == "Rick"
+
+
+def test_openapi_schema():
+    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": {
+            "/form/": {
+                "post": {
+                    "summary": "Post Form",
+                    "operationId": "post_form_form__post",
+                    "requestBody": {
+                        "content": {
+                            "application/x-www-form-urlencoded": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/Body_post_form_form__post"
+                                }
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "Body_post_form_form__post": {
+                    "properties": {"username": {"type": "string", "title": "Username"}},
+                    "type": "object",
+                    "required": ["username"],
+                    "title": "Body_post_form_form__post",
+                },
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }

From 832e634fd4b8c4e1a5714b5ad73f2cdc04e05e43 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 11:25:02 +0000
Subject: [PATCH 079/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index cdd6cdc90..2fe884615 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Refactors
+
+* ♻️ Refactor deciding if `embed` body fields, do not overwrite fields, compute once per router, refactor internals in preparation for Pydantic models in `Form`, `Query` and others. PR [#12117](https://github.com/fastapi/fastapi/pull/12117) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.112.3
 
 This release is mainly internal refactors, it shouldn't affect apps using FastAPI in any way. You don't even have to upgrade to this version yet. There are a few bigger releases coming right after. 🚀

From 0f3e65b00712a59d763cf9c7715cde353bb94b02 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 16:40:48 +0200
Subject: [PATCH 080/146] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20Pydan?=
 =?UTF-8?q?tic=20models=20in=20`Form`=20parameters=20(#12127)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
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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
CMaG{1

literal 0
HcmV?d00001

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 000000000..8bb1ffb1f
--- /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 528c80b8e..7c810c2d7 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 000000000..98feff0b9
--- /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 000000000..30483d445
--- /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 000000000..7cc81aae9
--- /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 7ac18d941..98ce17b55 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 000000000..15bd3858c
--- /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 000000000..7ed3ba3a2
--- /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 000000000..e69de29bb
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 000000000..46c130ee8
--- /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 000000000..4e14d89c8
--- /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 000000000..2e6426aa7
--- /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"},
+                        }
+                    },
+                },
+            }
+        },
+    }

From ccb19c4c3506d7cb05218076d0e3527cb21eed81 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 14:41:11 +0000
Subject: [PATCH 081/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2fe884615..8fe8be6a7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Features
+
+* ✨ Add support for Pydantic models in `Form` parameters. PR [#12127](https://github.com/fastapi/fastapi/pull/12127) by [@tiangolo](https://github.com/tiangolo).
+
 ### Refactors
 
 * ♻️ Refactor deciding if `embed` body fields, do not overwrite fields, compute once per router, refactor internals in preparation for Pydantic models in `Form`, `Query` and others. PR [#12117](https://github.com/fastapi/fastapi/pull/12117) by [@tiangolo](https://github.com/tiangolo).

From 8e6cf9ee9c9d87b6b658cc240146121c80f71476 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 16:55:44 +0200
Subject: [PATCH 082/146] =?UTF-8?q?=E2=8F=AA=EF=B8=8F=20Temporarily=20reve?=
 =?UTF-8?q?rt=20"=E2=9C=A8=20Add=20support=20for=20Pydantic=20models=20in?=
 =?UTF-8?q?=20`Form`=20parameters"=20to=20make=20a=20checkpoint=20release?=
 =?UTF-8?q?=20(#12128)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Revert "✨ Add support for Pydantic models in `Form` parameters (#12127)"

This reverts commit 0f3e65b00712a59d763cf9c7715cde353bb94b02.
---
 .../tutorial/request-form-models/image01.png  | Bin 44487 -> 0 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, 3 insertions(+), 994 deletions(-)
 delete mode 100644 docs/en/docs/img/tutorial/request-form-models/image01.png
 delete mode 100644 docs/en/docs/tutorial/request-form-models.md
 delete mode 100644 docs_src/request_form_models/tutorial001.py
 delete mode 100644 docs_src/request_form_models/tutorial001_an.py
 delete mode 100644 docs_src/request_form_models/tutorial001_an_py39.py
 delete mode 100644 scripts/playwright/request_form_models/image01.py
 delete mode 100644 tests/test_forms_single_model.py
 delete mode 100644 tests/test_tutorial/test_request_form_models/__init__.py
 delete mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001.py
 delete mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
 delete 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
deleted file mode 100644
index 3fe32c03d589e76abec5e9c6b71374ebd4e8cd2c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 44487
zcmeFZcT|(j_b-b2Dz8{DDj*>68l^Ys(k&DL0RgF@_uhL8ib&{6RjSe<KtOs4MSAbO
zgx(T5p(G)>3GerJ&n@emd;U6qoOQFZ);yV+XJ+p`lX>?3?7g3`_bT#tDCj82$jI&}
zyp>TWBfCz#ygKyvRbugyN%0D?xZ<WR|C+31;PDn2**|0oGOs>(r=sS4^yATZ0)ghX
z0GGhuk!4}GYJ%u$g6MO9t>3pz-qDliELRCcS^I8pie4O=Wek*=8TIyP<W=Z%lyfEV
z^SQiH7Q9Y#yZz3Gsw?JhUo5`-IKQ|8WaHrAAClOub~_TD6xu@uz)QLvtB+6@jSEiX
z&~XkTEo5YZZ`#}2(M~9D5l#|uWIqf3A-hJpKwZ7^h*TQW{M}3{$?9K{-5`}y*RMV&
zm5VV?d3pCbnZSL$z4a%Y|EZ(|^71<EEx>`lz4jLD1fKsp$iDphv_MXSl#dKWT2O9^
z%Lx`$sAy=k!72(0wN<a)zI}_f`ge$*wS}}nPT}lBq)Gl?vo`bG3%VrKv!#22BwR8w
zXY5@jDg6vfN#A4Rzy8NG|F^q8lHDfVTYBp+V^SGp@ITA;{{};_f@p$RmWGB`*jY6M
ze!GVAZWU|UwR-L@E)M-Mc(Azl;Qr&Wa!?WoF2U}%_M;(c8uMAnf>w)9#NMG=CdYZQ
zE~Mg!Zftr(!AO~sUW>G~7lmI4de6K%a^2iK*m1!|g!2jw>`3U<P=;-T1|Oxy!w)Ab
zeA+EG_5uy6i=ca>!Qu^BTIbVs_lWm4mk{>>lazmr6t~~;<}0!)J88oGYQo}hN0Sr6
za9%D7Qs<IVoR`aL=|87KHGkJ@BPg^kaD2ursQ4CXC!i*|uNyC1sWPfkYy$o!-j@Lm
ztA7=on-M6xs_xTqD&M(zjK(D0A+2&hAZTaoS5~J(LLldkwD&Pl1|ES4@$lbUc?d<h
zqZ}i3!zvFdVo$Q|5ZO}H*h$TWN4l3Stprf)x8KWKG)f9uJs;62F_yG2n-vBL)3Kk8
zR|aC~PGOqzy(K%cYm=ufAJv`&(sdqwii~&Q^NThtGCL?FN(AXodqxz25aoC}?5@4Y
zuV6o`%GVt4rbT6u_XpuWieNsVq?0sN$@LA^i3j9&Lw49o)Cy;7x_<sJko5CrGiX!S
zF^5R|ETQK`Svg94f#|bW3<SoJ%<`GCKI17D!5!ZEqmdFHRNzvY6y4@*>-2Fy<}8er
zTQjemmqFq?-UK!QE;u^<i^$oK`&>I&YU%#@mNd=6wr1fKm}8*b&+XlK_eloB!?V8c
zMS6Mu8JNX58xxV*62qnh#e#86l`Z|l8BW);(!dr*kv(~F+l83&?V3}fD3ONfo?&s@
zxuM2Jb>}DCqwP%rI%66gxESHQ$;b#plc(uE&!>7_gU7#9?Sw`?qMFD=nPL<IB2ISd
zBqd5DP9p+z6QQ$IR7PU%$7h<fFWCJo`ZZw^{#sJwJ`JH+@ktB=g7KpDC)R5hww$o8
zM1@vQ8iRr6@XZoE>9Tmu7oK-dcB<>WjWk=LFK&DZoSZH0d;i!?5H{2;`a4*-&MWC3
zzLNztou|^AHz+9#Xm|B2YbsV!h1h<|x|=5r_T0TI{a!DNtG_oUgvT1jRnH-+Ef#xD
zdwFbGW4>PvFu<%9b0!w+{k9(u?=P6V{b`~*zEnU8xgA$mlg55W<LhvIMp_`MdLAlm
zxQ~nDZ91_~$L~1ajCbX)95_<BVo-n1@oc48+vuVK2bE;)ZG-m0TPpE(pa1kWwdXu-
z;+l@nY%<(a`M6}D2jO!#(ndC7Z0D<Pm&ZB1^$yBRPe|>a)yaaoToaEzb>`}mkj6D(
zeZd~qiyPQK!rLQl1x9-+;8Ty9IYsf3V8w7(DN(zJF^LbZ782C!qwSF#>Q(kDORU0q
z4K)YWd+3dcv|i~CORKub#1cvUp3}5me6My`Ym@Ths`|Gw!=u_e>c}5+z;Wh1n5zE;
zPKeJ?h9@z5pM`Yd4;=%7V4bCIYq88mflbT3dr9`<F7u_@aeVBastj2*x_+L_f@kZM
zat65HwSxn*$sQm{EAzE6pM`E!B#-*nI89>!dv8C-eV2p7)57UC|3K`_8c1b*LiD~~
zckk@1Z1z7QP#Kxqy3;qlQ7;4zpo^Y?GMsZ52VHhP0CNy1m02}IpPtx6|8*m){^jiG
zyIR`mhqq6{JQGoFqI+pv91oK=c^H$*q3qB;U}pI4G)G-d93(zXDPVavJFNcbx81xt
z0pHPjtx2-1sEcDDx#bEEaQ%(go8lkyR6e|c0muDu9(^Yznf30Qn5Msp90##{B=cuD
zKX3_Eu67UMGeIoi>KeP?YbD$4;K5jMQIQ|lX-7Ekc-rQCT3VV6M-L~5Oq;r)<wF;D
zPZy|=H%QGTu5V{`9ktA6%Eem_flQkh-UDchB#F@*fx2^kM{W-e@Vv7979M*RnY>bx
z`=(AE5c-l*n+5=|a4${Ddt|0UZJE(MtH$$@!Jk~aA0@&w8{ioF>T0k!{>6Et5@FQu
zwDpNwU7ep|+T%`XiDp6gq}2{LUp+WO#|~c((b-PN>GvBqSfZGS+`N1+>K$QhlbMS@
z4Jobbykh4%E*wG=bhP5dI_9)+WRd$h?Lhm`>7{q}vkq<9+COQtvAMFJCkeHJY8nKr
z{)S#&<d+Cqs|Q{kxO+*4Px+Ho0tx7jGN;Ii1@(gJ{1SzxDCq9Kes}HKnWu{BP<v|i
zTUmUa8`a9E%9R-o(}85!Y_22RzN*^|a)dxlvAi^b`dbVB;!{9|lb`?M`W(v6SFyh<
z#>I2z{vzW%t97ml0W%H4-XfAtR7>m{$cjeJZrnH%p4r)bx3rMP>d1|cXR$x;e;=@l
zutGhPmBXFZ^|ay;C(Q9*<m)D?1rj<$N*$0;l^dS7!yw^|aGw^XTPFqzGdT)neiZUC
zwFCL<9u>}$W3_)z<cu6r09bS4;@*a2l}AKCavF+OCvtVQH<fz0fE-pd@_>lfTPUC@
z4>#Y~bWKS8dZEBB&z12A<Afwek+;&7byh(uzum?~=L+&*P>4`*e)hYzJ;RKa0pLI*
zqQBuViL(xx)H~f!c-}*0As##G^(-#}Vg)^smK?7#nw(hi+GqrOyh;opkL`SXZ}227
zj`7IP<0pZ}YA`LIpaIpyqn$|lN;6Axr|{bjR5o#qS12=H_!xSrIq`?9=M0k$=!H}K
zaMrdVWvyP|;V$>=U6yBgx#q}Y&B;R0^@^=AA=9CK@=UQpJ7KAl;Ulo2SHEAwO{I?8
zx<DYXCtsuyvvF^&(rcJd#o3sT=@R%2*2xFzV*}o4s`tkrT)h>|%^7GGI0)pd%2PE?
zF0SaC8a;bf7VpluJ?<~=X;_i*^bT;BR-7Cjow~jo^f)>_y~o}SfB#SBf#co|7xTH5
z2lFIyG$+RhO0AM}uB$6stINE+x3;s#qRY(afSYTJ%}CG<ge#Vat>lH}-)*J}K@P-A
zPxi0XzIuh!%9vK;0Y-mpVZbjKKA~#2i&K(G?esWw1}M$cMuZkR{@kWT0j63+W<;IR
za?vp{l?+@VynzY0s8=%C`<YU`T+66M^`kv_`Cbprr%rLC5dpW4m7U-(OALd=#pS&?
zJNNZ;DYLYoNzbpx(D~2%Efn1(Z9ICr!z)wzkD5>y=Lo~f<+5&_Y$c_U9OfNRz1ZeA
zUD#k`p`Cp#n@#(t80|KsZOmG7q-=-{@!PFXh5$3XSe+KJk|8&eyzK+MeJ~qa()aFU
zmx_u72)L-^qd$VuKYR2PE7XQ^MC>ybGmFA8IvLPjn%W$Np(ib`y4kI^&w!lg)>_r%
zSAC@gT42rnP4J%7lr!u!g$u>@Mc?<kDppnSO0nsBY>=~2NX5Pz0N@Zx{>4whXTqs|
z&>PKwey3V}OT5wW_v!0Dd*@35*O*eDm)I#poZ!`6o`@cZIdy&ci`>8?w^cGrb-frW
z_Pi4%1urs4+VG#XKQBLBim<R4D3R0?tB2Sa;kHhB_1atg^n+ga@Z#+*_IeBX3wwK2
zPtHrzHqP#<AY*TNKD;4UeWZK-2~+FFJe~RXA$oIz%i@O*GTe5qtl>FJE5Fp#O0ku%
z?8c8^oZesILOc3+6SYQ({Mk>QREVOO4DYJ;-fQrBw#QdNVh}c8Pvn^i$Zlf#=x8u8
z0#f0A>tOu2CIL*+ImzsQhVg!~fEWpGFhLz_5HV67JF^7rg41MQDYvq&#L*73b{+!y
zeWZ%_{0OzDy0A2xE*mEPpyc7t9f9ZXm@_FNw%sf&f8(nS4$yi^nDx1NyO?JwPCg;U
z>GO5o70$4gTS|d*UyK5kg=%j6Rpr6k^tIH@L*H|!J>%g5Lmhf&zSs#ep&%oncS^df
z7B;NJGydR3Me2gt>c{4#Uo_V)_WjxudE8Tslr@c^-qm)v$^|qDd;qGcD3%gjZ9E$v
zZhE%PRN}ln*HfMmYUXLVi$jNgX{SjF`|F0EyqLn0=zJaL(+Ufu3RPm5tFyC`Dqlkr
zelsHMJhb=2x0Z#KU`cWDgxwduzI}B^l^eoI;0JNXNm;VfDkZ_QwOGwZp3ib6D$0LO
zgbxmEyTGp*-gTndS^8&rsx|<c)CyAmy9S34sH^rp$ZZlONi@Z7<Y_bJjOqwn^37PY
z5s;M`I*(k@PfovAZen)0)@L(Od|}<cKbUc+n6Ejx3L_2GfIWMoJiGtuTiUgNF%CY1
z9tG982T5Pm(8YW{<Kl=D?6PXHY_=w$Gw=NSs_CD?y*S$<>v5-%&4C1;;U+VKql}f6
zWf&J7Y8q^8l>mY8o4)7WSufVS*o>>fSwiSC8&3{F9tWnyK3yEz)w7Ru81IjJ&8vct
zXPJwAywCxhI#yqHB)2-YP>RU_doV2KH+OuVl2XXqr8-x^;-ZnZV>|wS;~aZ+qa*dZ
zet<O_&fIQ^)nh!_bMY(oBUIIrmC-}B!T-HsgFSNC!ovWh<a5B9LK*P;ys*6Ev?<E3
zY1^%1|2nOQJ{vG_7w%h$@9p0uiK_V|*_DiEu2#6Dqw#gmP#EFN`1Sb6`_?ZZHioI?
z7~C4KfTx25&fPj=+dY}Cexv7^iDuVl0#6`UX@{d!9E%*x+u<a3weYsTt65*!O^w%7
znNg5Hj@Qq|Yb*?+Ostwp<uf81@sC$XkKvMRcL!KLqozf^?=ccKuP1p+%)}})u&Y@-
z&A~xM_3hBO#PDy2l-bR4t7@Jfx}sRh2?k60S48WngaKdta9u>ri~R}T%8DHCc4EQ9
z-KVdm%Kl^J<lH1TUYU-owJknfdn1coQWK(<(+Y`<wuNJQx8p(H{IaY8JR;9&%qOPS
z<wp6Ql};E|0ZU%37<o%@v*hJWY%nqnCN4PW&3mSuACxI*e@U(kz{q}}>?-_|iSc%v
z)2}Q{lzPI`XuViU&ok{IkXzxQ)L2l7hFO^-PO2v-^8so=)41Dn)!NlP^+tn3Dol{K
z4+fie2d+?hT!dGHi3VQKdgj5^QZ<-T?|$u;RP*jaV{#8!0YyeFF5<_elTS=jjN%A1
z)bNOh8ltbzHNf$$cQp2BMWjf12lw`U@pNw?V@$sTWHpwl8rE?Jvm(4Q5n_2ZnSR|M
zxq^A&IjSXP@RM*NwWS5pHiM(~y9-NTZ%pOs73!OGVs)K6ygZV&G9Ng>86+D{{~^Y4
z-+D>vS>YbKBhZd+X6u^KDa2@WU6Yq$KHD7~;OiXfHO3(gq9L76KO5<I$&f2jfh@bZ
z#ba5Bb63v{UypqC@j!It`fJ_rlV1!8^bdF_`_@?-PnQJ{?oklbuxOFnTWcK%Ax%Z5
zBzIQVt#gs?C<7W^By?*gzLZ;v(DF;fpiH;v;-a&9a%G(YA#X@WUz9K3i$qQrD-Ajt
z++~nVcjXs)%9(c-yI@<npcXUf?Cfm4RC06w^ybaGg{sHJ)axRAeNLw8Cp`i_^yTQA
zNj>~Uu68N+MYt0F7$B)f2JGHjWw6qok-(MYG!}{Lb>UCA17|xNZicbb@VnhYqYX-?
z-G-j3WiZ>r4=Ku~;}a^J97Y-|fj~uv_Ztu?K=6$Prs?sc=qi?;sV3%gv7-#m@$~Bs
z?`Gg4;LT0YO!;Qr7=RZpRjhigs8Ew3m_8eNLz_0(!GJVnkR{B9d~vR={b<1`&A*>o
z9{n>c^^jmVa^Yc<24eehs1avM{5Bbs+@w8Q=H!(cK?|FiPo&qF31J2ixRbBYr28fP
z-az3J=i?WH^umSY4pSNexhnMUCwDuE<C6u|2`-W8C;#?7X|i*)cn0K%vQjGUsC6BI
z873wA1#>$mw5Se%sHl&od%knu+`=IHQpfX9fllk)aZY_1l8eHxZ7_*x1!!xnICdK=
ze|!yn5qm%YM~)nleyYsPoIuV<cRv%J_05hnS*dswO;Bal`o#;*BK%HypkZT`B?kR>
z%3%jI4p`FmVdbQn$zS}S!!1+DAj_)pfn+(G<dY|S2SZ_I-K?<#G;}bER=N3(kX~S`
zVN~5X`iI78ds<_=l1yZGeU-Vqv`1@YoFlsW@_9J-A&%h+Pb4Bu{plRXQ<e!L9FjSi
zvW=B1l}AFJ6hHkE2>`Hjzf)2PpRL^ror=e8BO^{6aQ*j$P!lY#^LFMu4uuoV`SVbb
zqmt-n<w+!P<)@m^IGKIp*F=LOo!NpFO^x_F3ZVlFDuX5I9|6~{J-s0{L%7($mx)8S
zi`bF+(Qk)5!V8YfZSD0j32$VF;s+OKnVi#7EbY&ZBA|t%hh=H?<>~%?1kXZpl6dBF
zbLoO$(P_Q`HakulW{qL6$`^^l-WH7&cz08OMc?(><BHn`iI$s9>$e+D(m={FhAoBj
zx@cM%9-(+6ze9I@eYvRCpI!O?ta%vq-r1(1s@OJ1`)`dNfCi+63mhaJNw5!@^*_;7
zJd0uv4Y}>$-|VL9Ei&+j9}jR7K29Z~TH^KFZXV+)j2654Qcg>U%m}BbC{?klfN?87
z3K;xNpuhh}0%QEn%(?!#3Ug(qz3uDbB2FN%vuZ~b3K+ij^yyWnV~OG{Ajn9RKd)o_
zvE(I6Iv1eq`B#mHwYI7P{J#ECb(8cHantwm{W*~j4njxKmVmu|w!Q3{Z3pkTK>f4g
z$<3<5#3xHFSy@jfxE1mr3koBJ2mIE|GrGF`K-I_28et^G6Dw)c>r^lvrYC{96H`Py
z6+@krWTT!~oAoSjxv6Kq)=O53OzY@-Jg(QrE`GXMQlVWDy$w#=8cn)>vPV<1jot3^
zcikwdxcT5JmDkz7fbTZ6`-X9tx4F4Bs*tX=As4qAU>C>B#O^OY`2FO=Hldx_XaUky
z6oGYrmFg{ZxJx7OG}B5|+1tj%bo_hiv@?Govil4<r?4dM+u^2`OlKu%0x(E$3AHPF
zm6mb8o<~*&$K>}?=9!JQe!q77#h)y(1(c7N-0=}ss@V70Ij(VP?52jJ?<MH=^P}K6
z`w;N{@zk8|wF{(w@kAy1sS|Dw^>(nCoT+hPK^C8dKUqrs)gm%G{dSE;YAx-&JgY>{
zq}T2EmRT?iD+gmY0r_i1nGw3W7E_|vI9}gC7nB{Ai%L4q7Vkc}gnVlPl)e7ak->$+
z>x#@)DeX*`?`A0X3O%AyEH=WHN}a}lCB()+GBOp{HX5?L2*;gi-C}Uvf&)heYHC{D
z%9?n7=czH?8xqN-0id~-c(XiS^L6^;92S6DZ6V0F`tI$UVVg`szAwM#mY@o^#g<yz
zrFxUv+n95#wv;o~?cf2QK8eYkpsCE%?fv_c!X=+#L&r8;UXy>p!XgS(25kJ6qv7`+
z_HbEW?%aoWwV>k@LZoXlXYufe2uc#xok+yGt^a8JyhOsSU;MAYu$@n@I=Ay8e<xXj
z_VfrMmUxRdm^t&_JA;>`p&+C4+fyF`OLau&W|th%;0NI?l$bltt_@4Hqz*w0wRTrt
zWTD<ECGAr1nbYvjlt^pr{u3Py$M`Dm6vd)GB~^XjvojM-Hych6J!YCZ3^`E&Qjwpm
z@+ucR7Zvla9O-+sz0mRNICwB(93D?IkbD@yU8s`objMjUVy$l&Cwo&aSXO37;^5WJ
zKdPaqYjwI}<Hpc~GiIfa`7F_6cMmI2Q>pN34XBR+^Z~4P`yJ~_hY`i(HkT=&vdOXo
zLd_6AajWx?hB=-_M@C;W=JrJNiASHx(1qlrMNJOsZJDh0FMrn$y#T{1ila-GZa62&
z$rM`+r1;Oifc9A+aGBb2XZ{DN1h9O4>a=EQnNHiQ>@J<5k~JLbg%n->6uq|p9PrD7
z>k%WVxhmG^_Gf#c?~<sWJ(87abI%^zVT!>79@ofuphnWw0dSKo!=uH}i>B`=k@<T6
zZoGOH<VE<C^30WMjkj3O;1e@7=1v6%m;~AZeLWL(-qgA6h;Av>N;ZN}FOVjJ1|>wv
zh$OVT;cva+Mzm2I-E;Ab$K8@^!Uk+euZc)DpY41*tUr2lxq;}q4Jev(ul=|?KP#pX
zIDI9{)>)nvpjPQ#KiKO2Y!nDwF4{(@JOOTdmM|zPccLd+t)c>-B=430qg8_I3J*1u
z%4KC9!o^=eW!n0?RZY0r9t_tEW}q%0Nx=}aBr?|E1^fJlUobl-5rE6){ruR5!&{T!
zaqX?;{2tzUmku3ckGj3Uy)XxcTO++ZXLWZ@-0!*UQ@9{?^aHbXWMpvqSUZ`vU&VRL
z>Nj~QNzS8}N1k4}FO%Y#_&8X7A?AATI6`u5cS~O*ftbS{GXL}J;NXt#Lf-29UT&-V
zhv`xrKp-`ASkt5w@<J^CLlP^axSp&GSBKF`#6-FXJ%emd|Hz-pL#3SZth&Rv9yPPy
zn=qqfjv-_kHoQ^P`yj=r$U(eDm0`Jrqs*{Ye<|PN_j*zUgpDe?u>KH9+6-j&izR;<
zuY~ZY!RmsuAmv#jI=^6g6f>ztEObQh2#}StojqL$bGBYV<-2&Ih9><?RM!#=xpF2?
z?BDX}$CvnTDD2%;<YU>8aB0|XD3~*Ss22A2hb+u}Y%X7{Q#cK7xW`3wPI!*C%Z8>R
zT-~0p>D&g|0{B3OoR7t7gy)?8JqqY{J04miza3FA%!oo|vU8N25?ngBC;)uxbb;LJ
zXbR_t0Crx4U)5_Fih=lNP|bOvyOJ}|-x{~A-T_T(osXBv<&l9=r|PwuV~Wx_Z+)ga
z;wkua3m5vw6Hshb;X2W&eBm&+6wVk;7u@G1@9qRfo@c9l(;&-x04odnsI2ep&|;;~
z)L4cPEr8w0LF}kr(yqwuOIKdd`X)~#8K@`5T+}n>0|fG-?%m^GK3;yiM}Ebb?~j>^
z7=8ixAQkU@a*X_$7gC+nBfWphlFNS^FcdgEq$%nX)Rn2=i3??y?VCK=p;?xCk+a`!
z;ai-yJ-o0BHw)j`bxGggum$Jv@NDEXP{5(RW8WMLx9zy8!~?nSM}cUn3m-VtS&QM+
z_m}TOA=bDtfgAa4nxaqn!NXsQDyab?8)2<_6##bYGsLA|(O8Li^j4Pb6>xfQ(fC}@
z!tUM?#HFVFOi7qrMgm0AYwU?fpw>>*x6AeK2f4T$EVYIrM}N!5FrLKS=>MXw#y-_c
zLuy6Er~PF-+QH<iomh9<_RYV3RB?-l|M)ls|H^%N=@NAo`qu^ezk!eO|7Ya?=`a89
zFRDz#`=tMh1^A!vLlfP%?`PAmzgd{GdI->L0^@PM@yl8;5eo-`@4>dg&5c`V%bX5z
z+W{+$EJ3ed12xy*tnUbfLy*m0V1J>*L?p=zNG4dtLLIah$!BtIwBBj{gEQtGMt`0e
zlyuo>4aC2{^1`IIr0^JeCxhS2J|D``RjGDssFT~<enATEbxaP;m3hu}sZc3*GqID=
z^Q_ZzNZXJ{rV0L2bZ`rTNX&LRt|!?g%{#iat~ro*sV{~nLIh)_)yaf4!LC{b_Ripd
z<$=F~@9bV8{MEZ@UJE}2tfC?2mX-tQlCu+Qf;Z@I7`Jx!+a(swC%8Ahhwa}+%^<&p
z#mPk+ibW}(-vlK&O(lF!P1iNQr#;yG)lkihi9x!#ntzLh%Rdk^7&2a5-k2e<=m(IU
zLU|m?5g#I7s{&fLzkmKbx<!L#Q7Zsd-3fb)KPxwTT`~S30gUzTLlvI`Gbu8#7xb-#
zNdp`+Vi#pG5Bh-1=UskAeJC|;kM%aM4miBbcV9%r5>xsJuvS{#m?r-7V<0z4s@5+E
z_|vA1z8?avt8W1$cH-hjjR+WR5RJ#=GzS^|eW`$>N+*pd&Cn2=n;?Xe*f-%0d1lih
z=z(;jGMv9&$H<%C1lj$$riK-9wx3g)!hNLwNCZ64pfjJ~sB}k{J<Lwyz87OEW()M@
z!bg{MyaY+=R#*?Crpx7{=qerO#Q?M-j&pV}`1<OqpjpRlP?D$DG#eQ!%!hy_F6T{J
z%<{?wj;ikS9Xl<UQd5-!e*F|W0<#->Dq#2+(OQkel`!8*>a<8v3B=<6_(>;=zhpQZ
zBb*|Z>e85ab<%*q%&27k({CpOnRnf(E=~s5wR4R^_DZ#LqxY69-r*16vLIDDX6eB8
z<(e+=T{Xnk3fpTIxBz$xzc$+R4gfgV6mi>~G7hP@T{jwiX=Ivk>s4%yYa1~T3HL$-
zY^<(610pA3;IpMrqX4v~mDNU)QQ-8%^#xhso6WgrQS~DnNp>fjA{%K1YK%bOw{JUZ
z?V`}ZNk==C3lk61wJE3lQP{xa2|bxMzrH!$x;&$Z?$|#yLiN9I$Y9C;3c2B(W59UJ
z^Td$}K&^g$Zr=DAeUk=o^AV=!`}1N*MH+vg(_Dij3*gP4g=e%Qd(jzhcMw9^7FF8g
z`;|RV1D&^Q*Lq2-o%~%@>O7nOqC~e`?pHnqw~C4iiR|St)?Ae|4j_2(wtWPdy^3_A
zI=ZnWcW~%!Oz(!~lPspc_268US}UmR&yhW<jlT>6qB?px4MIML)ODCAg!3^!dBr4&
z!HoV4X7an3?<^6^J3iHlco+_8d<&zgoqlFZn%nwB>U=e>KqF5IJ*GjDk_V=Eb#=AE
zvOn1>-Df=}?V|(#RsF9&K<ENZ@r-1oP_-=*8at-9M`o36r4>yT;keVsI%zojL-Z-<
zn`f(Xr@fe+PN#{E_PlJPv6RSlXrrLPQ4b$!D%`ODK|75`o=Vyam*vB?UWUhyOB{Z_
zXVWUyV+IndJv==F@#h;3YU}eBaRB4s1J}(D1-5q@3-yJxi3mMcQ};lf<wbiYeL%*^
z#hf(Q-^b5TTNPZ~q5EX*d`lNKMLGbQrEvSLlyR)8flDDYQdm^E*r*dTIeDliRI9eO
zRykc_y0_PEuEr$_v~FM(L00r0%G0TzrN+Cgdl97uYx0$t7}tFo%L@#j(2&A9j}-H8
z<{;qa7Md6|ct1+jDnxtN&)uHr_QIEy?ke@E8y*ems2h5TllZe{tkBz$X9^H>n5jsq
za(8ytsdKlfcAT%!bI6LH$hYUeJ_AkAlHmo$`tWqJ6+^9F<)tY$iIHI|9do|=mqTj*
z;huf=YI2tCOiU#sKfEb?qP6pj(E@t%Yl1^fT~1-$#?^q~gvn1)8_*5oOZBx}(0hNe
zC767&yev4l^>}M^&sDZ+$vW7NLof8phaHJ*f`gqt`Y+3X<(V40s#k}%BL2?DnZKQi
zb+(vs?U*=S(0}f<6x(jJt5pB$WwD{4(mU-Nu7gh4rP8hK8+tH5j+HV|NvU7H&Na^+
z-}vK;rHl&<RV_)tL=Z~{%hTo_$R_r}%<Q*Jwl(6<G?S5kgORvGj8VCzQlom?2WT;H
zb2#r0Sm$d#O?M1-(1@D)9o?9oMtt1?5@x2M3|uA{x0Q=bIp;edwK%#(!oPcfwD6D4
zU)T6`G*V@hh;A)G`^VQJ-rD{l#t!6HHR7+BEG@Y5gJj;_R3hw2`bhMssyKiuB@_yZ
zQA?H|l6!fdBTtLZ*yMa|K3rM)#<1rdXF^(-mv2hj|1O0Tc7FariO~w2$g?-Voy@}E
zaQ_{jjDrVQgLF&BBEu40>|#aj%BK%N;FmaQ-t$g7x4b5J1OJ8XAC|r}y1*>uNF3w$
zhnnbUmq6U%Rvh6FmjYc@Y_-I@_58EfGt0`Ij!&AL$c+G+|7qJVtVe20^5{JeIQi5*
ztNcwPgZ@K6FntX2%V*gSm4azFpKj@OcoXnrNEL~~p9Q7LWYlW%1IdIIrE71ljd6tJ
z3#PYxGqVKmPsB?#au=>YN$F97()-CZ9u7?INnqcae{Bj?&$;J<KHi(zE6`pq_T4KR
zN<l3_qf><l84obmu?3nGYCdOjw^R0aS)C$xAK_7ve1JejfSM0^NY&AOz)mn2>%99t
zKRTT*0iw9WB<wsRy)nozG6UbH{-Ts4(vZ;Etn0=qbKR%#A&{f8%HgdwNchp^>gWDx
zv8|k`yM(C79OeJ7I%^f(mCNd%YJmSl*!?e!ky~^Z5xWq=H_vZUlLR~DKTk6~TXlUd
zfz19W?-Ji!<aqb-lESHwdVZoOji{YtR7rh<=83+seEet?ofH{}w_JxSfr$=xIZBXa
z%fFxD;o&8Idg{^UD>eKF$^Gl$;S}Z5_QEOL)VJQWkj5}};wUf4%F25E>pj~;;yF$c
z@~7%e%N?eme#`P<YYBtc@{;{clYqKm_2JTL(hX#SG#v7IjL8!#67?SLM`{HhC_<Jg
z?+0;)f;l-jRFYQvlo5gpO?&aeYCIGc*A^~W7>bPlq3lPYI!J7Tp}UObrRC-2q2spD
z+jGrNo2esmGBZsLmWB`T0iji>k<zqFt00+%Cge9ieF>+8SnnDmD=VwKe9Dg8*jJGf
zL+o~`R6vkb=MB^)$};4CXCLLQli_%j5KI5UNBf3xR?ep%mk3ReA`eB*u(}#;kb{m~
zE2U)lq5z4BMLl8Fh&xS``{<&sGY{3JE&lR?;oYe-{f9kQ(ivE<&siZ~llqZq+hr%k
zXq)5e(8~wXo|s~Nggvr-g_A$9(&GuK{eAUnwgyu}IhW{GeDSTak8%{vL_S3ZqLQ!H
z`|6N-^eef1Ys9GfjlR8dMk##)iZhVpBGn7h2+x8qeeFRVGXI)J{}p0NQki!KrgO?W
zqR&RBbooN6N-ot?x(8QkY+f|l&U8sDgFIDaRQ$#4P!MU&3#V1w6c9A&d1pSknvtH*
z;o!;yh9r2@YfCvf?>xU&@%fY=-%OBtyO6lzTlq|yXMcu18a(D<((AvWF|gEtkQz|o
zEDeX`r(R<^pk$i+(>d9#%f(z5drRE)q=cJGSgXqGm=Q1puE+z^=aeh<-7p(i!Xcyv
z73;@bQOTYkJ>~|Ev2$i1N*%hL14YjO8n0L50W(vcz|0f7Sz@3<{CcVaXB|C2gJF#O
zH~3eDLrw!6sT4N}lV)yt&~eh(fA>-(Pk+$TQr=<wHM%9U`m5!saJvH<eOm6JR$cJp
zFJtI52T<!`3s)3Dt;P-)^EpFI+Qv^{=8I7JE<5-bm0(}ac54m^qwjVf=0}Gm%`^Rs
zPmlN3w-2M1{f%bJMnQ#9Ia^paH*~b2WWd$EBc_~6e}TLgZeGy}%s`I4^z?KNjfG#I
zu4X~LyB!uqow?hTAy1Odq8UZsaso#zQODpID$%Otc3qH%*OFr+<-6pI<{cx$8izOb
z>7dn&teLT_GRGYdp&WV&rk2GnEcEl6;f2wsY6u*f7@t?qNMx~@p}Tt`ih(XIA)(T8
z#TVe?f83fCdYj-QUlfCIz=Qo~ZCS3=#EJ&=mwC)`1GOSz2%jwsKGk`<TW1Nl-+`ct
z<8gCSq6$rE9?lQT-(Z8}H@vpS=D|bzpDO7&8|n+jP5TYqR(sdv<jJA!$|BY(LE4So
zn&E)~ob|6|K5%C>9ix76E9s^-AR9E>)V8wK#Ky8RzZff?@thQ8jw(@l6>mTa*}3t(
zImnghHR|Mq#+Cp%Ns&PNe9*Ypdg@tD2JfsZhfza)R6xzqK}?g%LqwTVpm1f}+u>Z@
zQ7K8!+N7bIoYZoDhEg1JFTf-6-OJ*e=fAF((Z`iXIWjPMd#;ZeHiplf3TNnH-~2A<
zpK`gF&jwV`Vb;UhsJ2LYeQ8Ll{d|5)>u>(@34498(b!9XZn?`voEamnkhhLNe{(+v
zSwyheEs-2q85yVk!K8nrL$dT}r;Jv(CQxWA$_ytpT2S%Et?Ck9)Nw-|7))6m<&(ri
zC#%1^HT&z7Z$9klnx)y+u1K`*;}0CHGzsbj_W?QOW)`R6)Q&wJkFivM`3ZD=gao-t
zn5|~h2~Aa_kX^eP9MaRTp_wUObrd1W%G-Exax|X+bUi^*(v(PA-3Lt0eTF4H)*P=J
z<1E#%Du3i|Lvsids1|eDNaEY6t32qDN^~<_iM5cd8(`Go+@$k#nn^B*{4P`k&)mJc
zowwSy&79#V=JXztzq=)3vwd_SDf7-s#2+`jt#PB$3c2t`JXP1na&uYa&B{XI<10Ln
z^I1;Tr|Cx$Sfr?dXLLbpD>y}<qMu=$^hcWFRUM=jad6`kaT;4R5fz)C>8HoaoD@s=
z7>zYorie&M+4d17EW9_fFoI35H?n_Yn;u~->O*;e++@w1G?Lg`-9@sgmneCti+;E>
zBlaS{kNwMQ0IPJ4mIe12yNA*5;exEwq4Qs(6Q7m8BYfK89Ii>|C%+ElPdhU~s=3vx
zsk&=V!UFz?*hO#4Ud<w0^yhIlo}Vhg=i9#5+DvPuK_11}hl^U>KL{|!grkj$yt9%f
zbdL05y0jN?r<o#FQi~oJ_}L4amRTnr+-$}t+3Zzs^&OhI{vXm{uc1YHblX2Mv;O)3
z03XUgiom*7b4ndpWxs^wtyI)MbFokF3Q^AB>D>|9yBJIy2w-3AN?ZYk(>-10_%`xX
zp~Iwnz3Cj^sUgN>RKB#B7XPoz64bY{-&>D~B#-$J1$X>)$)~m!S#4ja(v*OaIWcIm
z(1=zM@$K4=sP*w`TKF<nbhT8Y3*oDRc*qx^ae8yKlF?L=u!{@3U#=<BHoR0QUqI2S
z1%;T|Y?W*^1s<MeGuZK~qzcq|9BkuXhaT)zI%+ia`G~9$F!PCzJrHVH+j`;9yXzIf
zor*Hqvt4RwLcl_;R>tiTYQD5{Nm<_5AD+3yU{#LoVZ(G_`h~pgc=@dDsXK)YGtf}#
zlufoRo44RRXK4|WF~}w^{div2<AQN}Nd^bllHA1m$;gb&lgs+1DZVh}e=O~htGR~_
zP5>$*Hcc*IcuIA}1mN>Syp|%s1?{xr&@;$eQ13+&i-^h2P-9e9tA`P$=v~vauCBBL
zHpdDEv7<jmQI!Su=Aw#<ER#N_j6bx7N{NafV?R9NwhZVFarn_0`+-B&M=eoyh9jW9
z?(J(27T5P)!`3n!zZHppMwzW5cMjDtCJ7zms$>ocxEvR1x_(E}1TMgfvTw*qM>>1H
zdG~493iaR{I(k_aV+v3!tkg6sRpezVetmmA_G&Psambij&D&S=?g58HKn2jITK)a_
zPpJC#BZk2+?5^>zs!5|S*g3_RNq*Y!ce}5WGIW*-has<wGDVUgayy0|BcrOE+Pq}B
z?>P)Oq(wPX{wzuo86J|LRi?sHKHd@kDW8U*UZsg-<d+a(-N<uj`s}&q30Ltw2|u%$
z<)x%#5_N3LzXKBSvvGPpSaH)v>uK})@tw{l@XF~Or?j*4i%3L_DD)u(z-}8x)7#c^
z`YULkN3-_r@Ot`3GrbpK><;oK1&R-9pQ8qmZ^%#GHAM>y64G~l+3TzUF3uGP!cv%E
zq$z*Gd=}G|`ebzyD_KgP(4en(<vl>$lO|g)V~tlTjk+>R>p9den$U+p^?cqE+{pW{
z2;=tT=(ZwhOIvBo(%=0IC)pqT*m$XE3#0pTeBt?$bAly`>_Ym5V!GewofAm9R(_MJ
zG-j~9p&_HnsrD77_~8tE_RG}w$m8Q2CPH;tVZBDb?O!z=Kpmlh1Sf^rnfmt4kK8wS
zZtn!<7Ikf|j<&SxT8!^W!viA5TMkAF5WTJSHC`E$mE+%H{j+M$3ogXjWHM4*+qgz_
z>?DnpXv*0eyUd886zLv;#cEJ0;Cf`a)w@ji<8i8w^Ka&bHx;8DG3Ra99*9Bt%_f=n
zAZ)>VcZMNsSAzvzf3dkus&;1?ZgGT_)$<5`D3cYRY}*oqTSk>^s2hlki2km}v3hD7
zPGa`}t>4lP+6^)`b3f3yA7YQ+n$C0ye^i`Loce5PGk?#6#CZ*K`9>q3-!47c-ruRZ
zR6vv#Z9Vlt5JslYN-iJzz=@$jP%0nseoxq8jQa!i#W`-ZxS$FD-f(FX^-pa1>b{82
z4tb>g7Gk~?#7u?x-Ei@Pyzxawrkh;_Ji0{9*SsI2abLp3eh(S>rh1!hozqGn!W7|)
ze)ls*@mHj`$-skOJ&=PKui2($YrQ^1M`r;Q^A~l1CiL5bP)s<)?o_Q6w4)d2W3qx{
z_mj-d_x(;hS}MTfAVjKg_#^l0K%iCCK#I#t=FD9Ye1D$UeD;h$8U1}_hmPn5!i07c
zKZ6l^8KS94PEl>*CY?4xm=>i~k_vE`&;~AVOS_-MV=I9(-$ogw(F;fz9<?@#Z^UL@
zjY+Lt1CbD_<|x59GW|efOrilbdBX1;JBGL_h6KfpBB#M3!vuYkN}cwW;a3G8YQ#8G
zIai9a{xEyZ{}@MT2XfwB&UbcK6RkB=XzKX%y;B56lMvC<TI&LIS*lVNKbiv)9*?j4
zaz9K<_YZj8(kb1U!7k?a`)yl)9{)fUEoS{SI!S4=lcASOu>SmuCzH^@R@ppsVSWcU
zS2W!*nB*Xy!<jHJ99L(cb1)A85F_Zy*p4<2G_*0i{i1#n@-kx%j&;c&6mVW;G#?D|
zBz?<M{qG>;7v}c6D)Z*Wq@{?FL@?3w<J7@)Y5?G<76#TV)C3l165vuq@XTYAP|W08
zo7349VieghPE2PbK2qV9_k$QTd;A=0j!TK=lBb5g6L$eUm=mZ-W95`2UUWeHUA6e)
z$@G{dss=Bj=R-u5eJA9HC)2fW$Vm}ASC2dlH9jn1+l-`B3LgTxBfuL}05uHe90Kt@
zGZMMov<sJzADn)U=`mTQH?q%{s<~Gk=oGeb?J4>EICtYQIgQGBhffDV8Hu!ffw%KF
zT<qcz4wR=StrF8aft$_X=iw@Yyx8BnfBA)~6!`=!yc+hl9?u-)<o_-!QAddc%g>%D
zrfh-<ALQ>k87CVKHXLJ@35`-V-ylja3EC_%_Ld-9(qF=Q`|oBjSL3PN7fVLv-tn~`
z@g<Bq^~a3ob1SEI4hEVRXLpm2!NDxkb)<YhGO*5Hi_(dA-&k=!){F5Z)fjsvk4rU^
zuE^#}hz1c4g}B~OR|(^#X__2Cthpv3F8qHpk#12cqccu&zb#xzf9RY6L9t61SPBab
zFgW~?{q=Zpy6n(|v>kum+@_l-u+w1$X`9eTRsTJa9fW=R<#HmB3E<MI`X3~;IeSsJ
z{MIA5n}?12YGW=fYC+z+cdJTXt`dEiL~FEC54<e|Z}I!LNrRFB*KCV48L21YV78X~
zB-ND6SyrPfjA$JfYe99m?<`zm-#=-~_3+=HHeb>qDD?jslrXf9B_qlC<&kEsdRhM@
zr=$Ag$BzpM_7neR9R8E=Ym!I{7q#7;DjuRfYU}LoUW7A7W;!zcn^jmi0-LtyX>@+#
z);aJ=Bae$Et~kQ>{^JBim`a-79mcUtW%`iU!$qN=ZeG&#Pr_F9=3MP+PR4@(yWij6
z(Zt2wQc2s!{4tO5+<8cG{og^8p*=qasi>%axYQE|G|E`mk&jZh5v(eKDm>ptTY>SS
z*y?M<#<2$-+JlfP4}<Dp&C589mql83va+&E1scHDm|}&T;R+@pMHvd!w8H#+>xn(t
z2bZYIRQ)zh5GSj2Tp&#SJXq%)OZoI%(d3P%my!q)MCwmkCu3p%v4c(a5E$!SX~2Id
z3#hOY?8k%xFZ=$V37UB4o)i4x>Znp4*P!5RU2JZ)!tOQw3WxQTjAvQ|H+43lz@0rN
z0hevFC&Gpi{i&GqTVRCHq7f$x`E(U20gtTz6TU0A4J|&Zx)C2A_Gh$H#Q%NF!BddW
zOdXfs__J%y%pn`_fY*8)ZTW*Qe#HMKLTLS3T)s}JFm9!uw{uA*zb#0+k}R3>Vn9|J
zzwt6mcWX|#G$AQIRjD`fLhMMV19Gl0Q&H;S;#oipIGr4l?oSz3eFBVaI?s53kc_Xn
zs7AR^p06=sT@S)NnsU}t#si;Ru&97d%)hFKSM>+t;sO|$0?c0abQ<L%q`_N}&*w`9
zlL8t2Q2O7jaj)f60)1@bVQ(=>y!~eqLhc<nNLxE%uQ$<C?E%8O3|-<SjXQB}<k-a1
z9vL<wh`~MJvryTLc9asgU|rQ+CZR2~m7nctgE+4ELJpvdp7}XNj=*9<oZT=JgNcE)
zl56?}JutJuyxfby)+ZjC_haj};;0b23Zi*5QC`@<6_$b0^Y_9;5d_s2qq<rW$QAq2
z9Sm{UA@XYvfu;kZ7a8Z`UWCL7FZ&eofb8ez`y;Tp2cwF8j>*vhe~f&EYl_vwy&RJp
zo(XIo04Qk~^=bw3UT#hAg|&=+sr(QQDRADH^aG!1CK&+JKfa=rq!-PND~EjNSAppV
zdY=~jQO^Ork749(n5xVgnV>|-2*r2>RXTv|9s+YPO6z}=_ZqQ2`YMb0NeFM@53$wU
zXB($^eZ;&LHHf(rsBZe9l)Z7j)<6JZX%@j)H+E1qX%&5wTk>RHJfmoknrIU$wx!nj
zo)3Gr-uO~Sr_x^H?>5k*!4MjWD(q36uG;K1lLLqnMiC2VmUe1gaROF-5OpR{<stzq
zZ16fW@2(v;a7HSo5r5eHGQ<S2eC`BO8o&MHxTBA+<=l@NevlD>5#u-yI46Mi-3nQ3
z{~!feqizj3T&x;JEZ?re%aV52oJDt&0o%iybQ9J57vYdUc`FfatXxL?hp(8v{fUb}
zNY{wS3;6e3tn4MkiF?7T@tL|ZIqEOM&D(bg!$aFGY7PyG6kgy9yLZu$_&u!sXlR*O
zFWev_P@;=-<M{CUtndaTUS9`8@WiL)J~})8nIvDyHCKOXl#v5?QId5thD@7N8G%`G
znzkJNtI{d&-pbc7nEd${%3J8TlMUfL!l8dp0dQ-Tg99*Z_obh(v3d{i4K?>fz%as*
zhHuf(X_&=fp;~lJCw$99+A86-Ok~T7<vYeqsT^s+HIPA~*D;udawvQAwCQlPc9i}6
zzAwAy>|V}&DW9G=HCx(6AAUS|veQu<y_)^YBt61(bYA>~o|ftvMlz)e*@kWDj$`^;
z^KFfk&E)b$%JQ9y8~U1IHg<B2Y!zvk+mGqC3h0K8@VDdqf@UU~*e`b~6lbbZ3(52d
z^6M|>Nq0<=w!I+{0M1s0zA_NHuT#47QoTcAp4n!Lm>y)2&X7k?r3ABksT!a&p3<nM
z3q)+c>-%{B;C4DrI-oUSWKzBo^L6;Ew&RPm261`4yGZo$Pc4cA0bC>I=o&k@;#KVQ
z;<uDWmd8P8KTAr4+uG36<B*#Hnx-Rc>R!c|^%ct7a^>CD)N0=&$9pYoUhnScpw*y!
z3|QBlk#@pxin3f5gbgOBaaLsqrT&(vrwT{|zYmg=sc7Vu9iWX`GZphPWCeyr7(Hq{
zJ7g|Ac9T1R=^CDdxXFE+>lcuBDv|Qq^&b#QU~3KiYzLlg!bi~v`<!`FAZgKyZzx0O
zLNZ8BsF!Y;o*LN<c$0ou25ld8+;`cBEN&i_E|kXy0D#NMfeSS|-;cJ`A6_lbD4bxP
ziU0rse_^yk^bFOl$11FvqIe&eLhE_Dx(bdGt^ZunS)!Nv8K?Cm(|MxmPK2*>GhFZ6
zku;CD*U?^bx&|VBNIRw6akm~>Zl|BAUdSQ+T_bVvnCAU|#RA~nwsP$ezXS-Uss`gt
zyoAnAFU<NIH4`-MJp=+d5`JUc#;b{`Tl-c7KG96y?S{Iv!V=&$M(>r%C-@|orVS{<
ze5_DLMtrq0=Zard2jg6lJ4y$)jyOfBq&6<5@d+FBUwYmQ)=@NzEZxjjqZIvckXC2Z
zaz(``(SpA+FfF~O^Vm;q9=?ajuwF^<J4QsPOx!LG2l<Chf`=|fZ}=ECM*I<Y`K<h7
z`U)i}nP5_dAnoVHcu#Y@!v*()cK08FI4+KVJ_Uu}s#%Ivvd%TF&5l=Ei}lO3NzQeO
z(ETxOtD9_7yRM~J@Iz-=ktO+-?I((G;HMxKrQ4hOUwjBJmHQ>{I5%cAS&E*{Z7f_#
zW7?Q=^J@q+0Td~5b>4r#l?gj=)_DUCaO{~bpPUxPPJI&uXzbkmCFJk1#b?DmY2&4=
z*xthkWF`Er`|G-I#P>K)rd|)>Ef3dUNtsPO-k7s(W_EGyJ)@^x&l2NX$yJcOKk(;f
zh3n}reCFux2}@*$LYN&}7S*7qxOC$!luQ3hQcUrpl-kiNr_-*pcn|SFN4$0Ctq9|G
zFj{S_ic4dvejds&s4jc;^;P8gR$syS4-usD#+shmGvslGLSekdGqa=hLE#PWO1oLu
z$hC0uweOV)*XE*3B@@2-%DD*r{(GV_VUf(A8$+?{D5ekrYTDm8`fcG6o1&&ZQZ3JD
zjhRZ=dB>Q}@@?)KXKQu(3%F;$t_VE4Q{D+u?56Z!>DuerzlwG4)i0M*rp<hizCfa=
zLeVjBeE*a&JWh=_wnE7N7if0Kv4w%rGYsR?8F`wN9`L@2RYGFhJ;9`WVMlGLa9}{r
z|8OR<mC?aZYGF)c01qJKX>wq+ffpn|{Zy2>bhufofXPWEO~A2x@XA^br;ox-UERVD
z_UQNDGkA(W#i_VbI)zUgm&wVS*U_zxZH@K2NI8^DrYVhg((Oss98IP2zGJ;OtST10
z533V_Sw2s`%H*oBP<nJam<0NiFgDH^lW|~o+zmqaUR0BV6yu{ce-fytEIw4vq$gfO
z1XPL@3=FAuN>Q8l%rG|E4r)SEw}LYm7FfE@?Z<HEcCMgEtn>TO9>tl7eWB1>jyAjr
zOyG?jD?MM!k_-VqIdd)az#C}>M*I82(o^_?mswH{gI;zgd3sUG@{K}`ZVsI_OnEAl
z(u-rpi`iw89E5V-7)Ds+_UQZR2U30`Sfhbx;mKWLTT>=Ny}KAuC}i>aUpj&_ysey#
z&7_%;-rFB*n%d@(Wr1lCj#u^JD{o@R>9}0LT#;RcLN%lNo@<f1-B55(SAC!px8dgV
z3Qf_l3$vx3>>|Z+3><GQ?*#}Rbc0p;bG`TT?ynN%6zCa)5oYo+3HZ@gE?Gh0lpRO3
zrjAa2;kFU@VqDw=uc|DMD0U=0Ef>={xVS2GxO{wku!uA+U~#U${v1`pi<Hg=E}(}I
zxZn8sCfc|7q>5Za+<{=O_Ogkb(fg%Zy!aH(*VWb45$<9`|F1i6G5Wt=xbfd{2L@RS
zCNJ~+a%UT74gdG08tM;sD#C%l#JRcUk{ok(u_t=6?BiQW|7na56rziAtF#5i)>z)5
zJ-e^u=(wCL1YFiH)*II4*bU!JedBUzW018Mu}yBd*SRXEm@|pSo?r(m5MI<?YRnN@
zYCS>@nWI~Z9ycuiedC8r*6@oLFCH~C`1?t%sFzy~>svpRHA+er3h<LM+dm}w2if3T
zNdRNgD&32c%Nn;O1~EKlU}&G69iE5#zj|e2@~hwSK}vBAlv9eXKSv;I63IaPJbp|J
z0@&(r{@0lKn#n%o3pXUbJ0;w-QqMs+r9XWX*0mPbN*e6(<M7;<G+t_6(f=|^v%9PD
zaGzLhPebKp(EiTtM`oGP)qMs%S6g|$UAXzSZkd8h5{aOx0wo1i8AxLirx<IF7>1gC
zfUJQ4i*u<hXxDkEpwU#M`k#LFSQgY$hR$_5(p~@U#VqerHGU$c77b3X?3r>cy3!3p
zAj<Z#F-~i*)Ub9^H49ovCmt)8##~T+$%|{xZ%JLM>v)0x=1-NrT0}%7vy}VAvI;qr
zLP=&>P}-=qV0b1(4urC^L&UKU(WS`^bKbpM=Qn(rEcnxX*t(L=-~ge!ogPU>v*!1O
zl&wWZmgKs8A$paId1Z?9i;P+J=35BYr^}Ga|Fv&h3As-jRICs|j@~-#i`+!@8cNix
z)|Lo(f+EU_z)yU%+Xhe|>&rBh8f`^$GHQTYBr(mUF-#+(KDr+0a&eg8#~)sQY1^0D
z-EB8$Mzh_i54H5KH=fRl^VQTY@l{ohP8Wab-}~`h#K7VxTLl5a<B<ll-$z;v_6gnb
z#`&*q*OZGMzMPM4?W}}tJu~fxqzhRctbbnB=kvYp{(ms{o>5J8@3$ycUJLR@nsg1)
z1*Ap@MJ1qg=^YdVq;~>@qM}p*>C%<n143w__ue5u=p6!yln{DO@ORFw<Bs$HaK;&z
z!KY;JwbxpEXRl|?XU_RBNfzl+Sw)Rmw05xC92cQavXkpi_);hPT;A^V>Dzj+_KRUs
zZN(@Vg);1EIHQ<_y$3`NDTU#tz9QoLKI5tZ>4i|A-8%b_P5qOkcbT14@C>@Bx;E{7
zE8j-khnxb!KOfLY$8;T&?)?jpgI56$&K-U6=gX8Y#y~UEl27lzwq?qvz4#<xHb{!m
zKs#!?pXyXzn_0u2Scl&`IAs-)lCZToiVvW-6g(Ppn6rh<Tbd9zr!J@L<EdH*^A+0s
znP2{#`oe6$;{xl!_%C0n8ZKHfiE54Mj13>`cwO60HN~uqry#>2Swvc|+VL!}QMxA&
zrXIQ<AGF^BM&n0QxEmR2l@l9m@CORa@B3qqhiiaK3wbe_7(z{?w^ehse5k0yFsxT?
zf>F$TwdK!LKw+Ce;-PE-b!veyICCGYnj~e>%-g)#YgM-&=1R<G^}*xc5@mZ6>^0>c
z+wP+r1vJqO$JR$%`ocG1=Ysfhi(QRuVip}EH;b_eMLMdgM0HliwkKt!X;^qY5Ps(5
z77**@=wB{l3gI+Unc7P}_#xr@l2dc64-SP%3NN32EsU=p?PYVA?)$Ls@3r>#UF)ay
z`C91%8|m5d<Edcygo(J<(LyDk)zw-_beF7v+1}2``3rVS6oS7Le`kl`12sVNdFQLT
z5f7{qt+Ta^%VFQUU(z>+=?f}sj6`Kb1&tvPw}LSnJj5QFsQ@ru_((s>iKlcM4%29u
zYo)l`{VJM&pzY9hyjvHbZgayMlhx5m>9qk#xn^_x+I!kMYCE-Y+Z8h;RZ;K);%q%q
zFS|23tgfI-9oHz}vVXi*UpwYTH7t(Wp36S2na{iz9Gn?!uo_hwXmT^tq+c{_uKVYP
zT*^#x_{rPuHp>neH0g4XP13QGBxw%NtN`Wze4$idDKjb3&TCiH^~Bm$Ux0PAeLc-2
z?S8tm{7R4h(2~|%E51dx>NbCLVyZPw`dKVrc?%n5)|mwjVBF3<-|L;HzH_10;*zqh
zD4*r(5)R5L2{VDTrSQ26;5TjDc)WjZw67Q(w$O%}wDFkrzgAVJBAmf{LH@eGV#WDf
zrVdv7V!xe{sPw)-{=y0e@5-_J09`0$0EtyDGgH_aPngFbrGBahGzIb*R@yB1;h#8N
zzKfddd8V%DwM}j%&NbGReVA(qWQO<~8g4NONLA>`xdEf;M0b{PLb9C7zKERU*N1B%
z^(YgYOq8)C%`08srxsPjAA;qEUfjSS%Ww4Q9vHCp*1gk%RDNBH-Co_jk+6Zn&I(Fz
z?fTye4#R77Y4nV4r*G9iES01V4}%lbzUhr)S1AK;2>tVyHcOOONV{s>CgrC00|TFb
z659ALTeu0$jEhE$t3X3~d=dwZkK{#}v4gz#+SeefQPnV8FI@#vs5D`R{*{wVLQ6$9
zHxLd5?<3S+yB4F%z9s;H(W#!2`wZbF3hP*sw^Ky6Q4exWcuE&;X58=@dEw^bGS|ND
zrEj&j!aBAssf{zr_ClMOo1B{&WtKCFvGQaS{tD|q-p^bie+x*jl&yUR;h*!U+^{az
zp@cmyI<Yj3mwOC;H&xZB6r)3-LY!2DO1f;8xP^5k8W)PC9@-hrzgjmMP>HwzBv{bw
z?{3r-Qn3sr3Jb#{@=o@!9er8n-35B(1b?uM1nOa;zLjJCoAr*!2~ALt06K;*!*a(E
ze^DCZO30IQ&2k;p`0b*tZ7NXl6;mSDn>ngow#HtPB<M1UQr9(ZvYP_gPAX9~s&xGh
z)+>)>5jS^sht|*iXKAa-$x{170<^PxMtx;7=fb!c!p4seJzbr!-y8$o`ztm`-QB#{
zDwRk5V6iKp+iJv}UkFFLQV()Sy^`7C1=^FlPZ1Wsy?7UDh+nIJRj;Q@Y>p*#AXOP$
zy?k^SB&AEo*IniB>RT2J<@Np)%v_p-xgS?orAlL*_FozsP^39|T-0$d>%1>G+4Jj9
z_jP`LO%7s%@ax)Xb-YO-E@64tWGUNmHxco6uJjSku&o_F7ejTk%B|tqjoRP_6QXXb
z<-m#E<dR+a1IYrJXDj3U+HRo9zbNa%+W#f+E10sw`r0kF)COR6s-R|QtJ$1HjwcLy
z2{V`WHDv71)6dK4jtPPc;h`BH5Kwy|7gg1PVh}&Yf0vFOq5g-t+Z&#eD-FK=uL3~=
z*uUWg8T+mO4(0yWiR}Lc^7{V*T|f|Qq;TgmY~(*th}Q525sj<&mu4xO<c3jlf;0HE
zzhOwWmcj$}dQQ!s_7h8LhnKVQF*@_{N*j{(BPnp3yp8j&`um|qpN^-0#D5^wHzWU(
zSoi+`UEk6%g(5G{UohpaEmM5=ZZW%)3=0gGX9F4(AC4@Kgk1)KA2s?c%V}t7StO~6
zJ0m#4&gt@*my)yY^%+MdW;}jt-0LK<1Yx5?g1NILuKfjw-x$zj&sSH=!W+bfUmo1R
zhVQTQH4+<OxCWWIWXVTQOD*#U{u7PHniUlA8=us#*0ERE7hXAsi6`(G&d^*TByXpr
z)a=u~Dw(fy+ayqNd~<bkdqRq<nZn+ZX69!FX=k9N?M}S7M#8CYU;*pDEyxdW?7&k3
z>l<yvhWDw)-!T58M$yloO=jw04ViRMz9!$o4MMM(`kmXiLy__RU;mD7q+o+#VX5S5
zDcjetU$ec7-LIC`_naDo&Ay1O#iQY;Z@`N%3S#5sG;tyHuJ@YIf4(zc092;F+(Ett
z{nL~^#@$aIBbrvcvT+4n?l@h6K`2dhTSpn}*bP=9xN}AJ8%ElavYoGmoU5?Fs!Att
z(@?SAKMG$(_e4z3)XX2eIf^atwf%MXhYpu3Vt@bfV?!YWntR2+^ebPNWAdJzbj4h|
z%^06>K5t8BA1@@@X3B?^y$pmu`hVpfg34Y@+}c4RyuA-uFsX-5C+ou`f(k>0$fgeH
z4TSf8x;^Yr+%Wrnf3&s+6tdVUFtrC1F;wlwvWogYo4grWuH7B8o$T8c3be`ifSgRb
z7e701d-!aMLz&m7Aj5}{$swb@-)fnE=(ecDY-crsJ-CdBu>!~Fx!ahj!>MCIohV~d
zC~l~{btM&AJ_t6S0@uI>@5Mml$B>WK+xxt#pr|zaRukhCy%~hj_j()BtVBi{`_w%+
zw4d6u4!S3W^asES8B_E@hr4O^L43&7x{tQJQEW|9jPg+8Ug*=!l_kc>gZ%XqkGvde
zb7M0pF{>e4^+z#ucMk*xg!uC>eij?Zbsww5l=K9uA=H5dJQkxOHQgHgdRKeVMa@Zn
z46FNe*R5^U(K@Okj4|vWLt*C%dB~Vcw4367?rY>*XVFQU(+?TMFmuv9<x;8J3c@?l
z`oqCfhkdnW0r6fD=~6jS!E;p>sHdi~_|RH#@#FKO5Lb<<c_sf`<{87y<n`ijD!f!f
z#kfqB9y+LCsX4n48QpNrbt%2f6xBAHZk3Sv^3!$7PK%_qaQjUoANK6+sWgpf%d3q1
zzCNLn!uh57zcxZFj|nIn`>2-y?(eotpI-DB`E0P*Bo9sLh<r#nO<r5-O|rEo-T1e-
zItIcP>S#c$e+D5u0ZfxqbBi+|Z0<VVE_=)jekc0nsD_xViv5*hR35D5yOBT8ZybiC
zoh-l4^fA?j;04nf&1n3jug1?LW-|~arSAW__ur_BAL65QMN_c7qU!6ClYV1eB`*d@
zyWiGAPG9N<srDtE%>JJfHJUQ$0^HFAWu~p8e<O}JYQ$sY^KO5rymKeNa=z3Sx~gTS
z1QjPPc7~znHM_5x+`gg?Ug`cNi@tt#p^gjzKLP%JZ&%pWDXlM=*F5f@t~n|;;P>t#
z@JqS({CBI4aK9%_3XnDzJIpq`1x0k;D;nR>XFKZt6aX6&3=K|^db*w|pt~)_OJgH5
zT;6k>A-!iVy^VK(`2DGNG{r4E0j}Yf$yGuppg%-lM&+1qe#ty&Nk}<Jo=Q(Y-WQ$^
z`dJ#C%dz#HNjkIpTa>GueNU*E={?R+Zgp3UILsNKd2Ky2<V5zqfr3MpM{aqsKaHXI
z@OI?zSRU8uD8yziJCc<4{Q2Mq)kOc95RgZ(waB&PaA8^C9`4@{)FEketEu)ULw?r|
z8u{jY&WfsKCeLfiq^^F8zAx>v-PiW<Lf{7H7vce|z@})gYbfCq(O^>qMWJRn?Sz8r
zsCNy_0fMXsAXin0*2}<xYI4Mekk22s236q1x8nWvLG**<ST^~{t({W}Kj}89wXk32
zsP|!A)3>BRUr1+1pG*jkR>j*BhU@&ACCZrQ#h}<wiZbp*odB!n=cRtvYH!d(G-xSV
z!2<ag!30LuW1FeKEJ^dY@4o~n`FS?mqO`(FUb@fMAsizUf6Kl!N!!!0wNeOw05(%s
zo_aNxDqS72t1;}wI8QHe3~gMus-Nvw8i}u;hWSMwed$jb&P?KW-1+iL^H8_I{Mkj&
zuhu^O`ohh<i3Vvm#cx|DlbBx9yZ3wNy6dH9^vbjgWk8M|wSL#&EMd}j_UrbZScG<6
z9M7^wZsWUOonQNH9?zFj<$;S5E?C+!IbCF7I}te?3xlZP{tSp!4Fn+5O+;<sINM(D
z$Kgz10qzfNZ3{mVWzN$0<7B<-C5B*_T+=7$^n3yZ{c*>__ri{t;#<N&b@XX0B5P<A
zno(|`h!O4Y_f2gwg<i_XRjhsvgJITgF@bR{_Of#ts`@nUtuh*Dhz+DRdb;|Ih_{z3
zo?~T$+-|*DY2lEP-bzEfAIO<h&UPthfj5i|=n4RBMmpL@8_^8ONx9W0VqPvyU8Q81
z!Cmh6RN8#FmNEzZkEFES?|8m{KH3|UuoqFJFKOEzG3lngn>SZ!)%d8GcT?`Mu*Y1k
zDSRfKdo`dXZ4d1KO6G8PcbA)+J5qA5OB+sFT)NR{@WY1-5#D_5iYU=0`TCe({A9{5
zj(>(v<usgO9$v}ry-A##chZ48A-7aE`qy3gssR-CTXhY32f7m46~6x6D3@310OjaY
zgV)NQXqCUmJTcAg*Pr0%<KCo^d0zU)5#S6f#Z>>|JG+>2#U46N<f(w64qMg=lh0ry
z(dIy4Zj~y7u=|t=!n?DfHSM<FLe~U6T-C(mC8Q4{bNXQsw|OEFDTN*eKRR3glEFQ%
zia<+m1LLou{Xt>DE3A_jK|BsBhGKOWGmgcP#a46*M3emv5tSGAhHvz(C);(TOojJl
z`<(-RKp<^z(1*d1c1b1Y>IiL6uy^X>OrWtnC3g}%+}8gY4+RFzR5;1v|2o2_Fp-v9
zS{gM=f;xV#^v;9#i;r!oQVs4skOsE7ne}FX*4qpq5NGPBK0aQtcrUlMF3!)X8kGaY
z_YU89GJ;jxynXbKx)-En<tq+_SPclf>llZMCyFOI-Hv^x$s1!?wm59F;`X3v<Jqxl
z`RkD$0S^C0Q0^9$xyiO3SVrt@8LpchW|}N*e3cr&{><)AZ)$<*@L-~SjA<fEgK6=_
z2i!Vx0>ti+EWQ}<=RH832@jkw?`@pP@!!}T5T!^A67v<aO4f%w#z8a!WAj&*7iTWM
znmn@DuN*L~WaEVGpk&(gX3#S8nBNDyz`!O6KQk$o^sLa8cBa=foO0=D|0Z*rNqMZ~
z@ys>%+i*pv#eQcq3yBQT#j7f={hE9X5U2M)Nb$TWW@~aDNMUn>l=WyWC=Qg?oY#i<
zBt?3by}Cn*?>bX}56;JHRVu(gsa4>6W_QnX1^mlUPk^DBKo<{m!Rls%y#cwGiNwlR
zav$`U>v7%S-_E;jAX;`U>+y!1=)}^^a`v(+=l=2~E{UiE6<3u0XG0lkxAxa=a}kNG
zDi^yy%CzAqlWi?NS9C>{<<8SEu82_8$M}RznUx9L*zOBd9h)JoT4dM10M~<}1Q`=L
zTZ*kY_$wvUC}ZQv+r6Z_Q5aSOzwMdsuu7H$o8t6;3X^NLgBp1UXP(*i(IrQ~Dj0WN
z8lOhS6iT0ea46!5u5v!f4TD;21iU=0AV~Z+n~eh3O8bnHOnbl{M%7M>s{(%e{UBxu
zH@$jqeCmN-Puv1v;f#a>$%JwxUG)X}4c;2owcUp>N6pH>#W`|<kQA61h(PoGD)W(v
zaLnlR!RupD9+fQlDo}?smizvDuf?x_4wAQ*B#aTt;=VeMf69+mMvgz-OuAV$@cs7O
z$!$fn1ivPmn)I7u>!2XGJ4I>xX?K|{OzZwF5gDni^{kB@h4Zu3b#3*jrQ^0R9A)t%
zpvnQa?>ZAHr?<%BtNQBPfi`#H9h_i~dGan!IGv>tUlbfX^04CTdeS&4NwyLgxIvsO
z=hU5%sQTc9Z)aMyH_tuyC2sQA-<h|AO(CT#0Wo$!4bSID0*J)AoowltY6+dQH?4TL
zSV1la$x>Ua2t!-<qSIKcU?;!R7^ICS|FrCD_#kab!QVJSp|SasMPZe-hC+H8;@xsa
z_0bp2`zyQ|bb>G`A)mLdrhxf_AIz@zGb-C7|2fog17=(&Fb!oVzF^>SMoSwpB3(NZ
zJ&eDh=43}|gPARNcXrQgeSO*)R;&$}&HE)SXf)$=*i5{~K-FGvy_~_N4zJ$(*nOU6
z&+;lo6=~lJwF-D;fTHPcEK2VhH*{?)-@k*Crh5nsXV$zqpr%(N_6zNb4ONBg`5@~=
zfMX9I-3Pr_H+tz4jqv)J)y7%4q}i^^sc{h%bq(6#Q)@kK7_v^e>J@m;zaeC?Ktn3v
zs*n4vSCqMmt$jZ{5e8jsC*g+X_wtPk9zR|QwhBAp<7GOs>Flmv9+}&GJ|n*V{SB^|
zk?PP=@i?<nO`qZs-sWb`Nq0EIk#U&}>f?k;J*@ybS--)%cc`P}7|aP*DBB2-uM@4V
zFYL;UyVxRbcJSF|+?;SUJ#c<K6dZXI<a|GBTQ4;@Z@l&{j##?bWeQ6tN-t}DeI<iK
z&HVU|bajJ_41Xziv6yUlBnRos5yREZ$~=es);0ESt%L5w-{qb!@t=S7+3kJ`Bhr0s
z00G`h5}^V_x$^Irvdr}>^;tv`FE-~Us~;=<SU%AP3%A#t@3)?UG_n$r&WmZ~Yolvt
zSr#a8MJ769Ab8AY4?zd^486V<>FsP07##c_Qao!tp}i&eCq!%xD4h%aW>n*0yuI(|
zrH<Th%fA>R;vI~2Bw$u}Zy1`n$VtrmVB^P+ACF`MSJu~M2s5t0J(5f|oI!Legfs1d
zsLj|8L3fLkDzsCHoIQbl##1m$_<1Ii)u*V4d+9(bm3JyuN0K=s)4$J*Zd%DHU(Crh
zl3fu!J8+31^QkZKmYmFJZfS+Z*UfRyw1Y}LVuH}p#>=#{^Dg^voeEsfg`b21IMq*4
zt2ZhJsEBXkp^L~cpow8p0(%G%>?XJigLA9k3J{2CaZY*(7g^Z#%DcsN-ivb^Qpb;0
zGoa}-k);y|r46&oEm!u}VL64V8k@x>Yg|5UA&(AVJi~-ZV-$9(OAP?1!EehebSV!$
z4XX+cE_wN}>IJFQ=26+liwF6_K-9e^o4wt;fcD%EFP@}2p3((Xkt}k<6v7RE+hF_j
zEembRf`iR!hTo(m`8?K!<m+Hw1|Ae^v~wv~D{%HN@dGnl;X30Fff@~;lU3U?F4%!<
zG2K>eh!V%)Ds|M*qd}sCWlzatZeka5a2ymGEc$NuiyU}Q4#M(b`gFE*`cp?RMMy|u
z2)DE4ItO18?<vS$>R-o77O<J<m$AeBC#(zHw{G3ywyvEN@x@=+Ia7mNP%|d$ieLPY
z!?7A^?z+`01oZKlHr8xq1qTm+w-L?70y1ryoe^nNySM-0BDqPaHjLN5U;Z_!kWVKQ
zQShQ!H35ODamZtM{y(??rzZ~}Sw`YkQQtxv;=Ykct5}ZcEQ5it+T}upFv^hN;7(a{
zlZGi9M2FIRzd($i&=iSX<zR<$PcTuEb~XsT>NLfpEd_ymW5LP;$_qmAD<SW--LT_l
zq{)Y`4HDrs!LOHoW0;e~rPwsvHkP#y=(P(M3lr`F0GLgxeBeZ^SL^8jvH~|YR#6@=
zQWzYhYhgYto{!B%$9u(?BX6dvRyi%U%+<ppnZ$)aAQGgZ`s3*@TU5y%+9yLcN+`Dl
zWaf49x0+q2GT&?pVk&4HrNHM+`J-Fca(d^P4w^L+{HpP*JYjZq&QRK#1Iqq5;*wD&
z@2Git-(lp@F=_`!$rOyPwZl!|{lA^B;W<EjQ@d-g+)YY;{P5+TEJ*0zB;Y2e{TEZN
zsUs<MXOh|DSSTs#yc$tC#l}aA6@ODbPU*cf&oDa{u(+S4pn1<OVPX}*#MEoWp#Mom
zL4vOw75CBUFFZ#A${6N0ko1%gaBMp|YuNa#L03g~rUjI1S3ld^Q*v^Z`y^vB16ee%
zlJz+3=-A8DGbuePHjNV)?Yh@xZEZ#ka5eCGnW7JA+c2l~#Wxl7OfSEx#K|P)z*)2k
zYo(k1^?N9$82!YX`17IMH_@x%07J@7>>JJO9=7Hy7iA^A9^2?e#&kZD$eXo2DvT*I
zF%O_z`FR8JRbZ!lE?o+u(X;o(!NE%#POG=n2h${3ps#5F-M8Kp(=|@g`L0*d8u@M(
zU2F{y*YI7o0*Jl3$?~~zrN<<h5EO)kxZ+KvO3nm_jy)J<7DikePlT`zzw<X1+i8i<
zz8mVqenNWeoSb0bVXsMw@3p~n_~`8J=jCie?tjkHQctB<1>)<KtRR*l!G;zjLm#CQ
zt-D14YQ4-1eq0@wH>aSN_Ya7RTFR5!r)-a~N7<$#^(FvywQP%!;P<Q%Qof6LjJt(6
zOz7}SgLV1~s$AvsMKlVm^}QTPV5(O2yFgEw-;$GJ1$)f!ENyD4=N{?o)2c61npRKg
zYs~B#0ZfTJ9H7WhiKx+#TQxvnO;99<@kFuJhvb{y`)Q(!Xw5cImc{qf3nvmFF(cZ!
z9H|fSVfC(1c%B_Pu`L5Xlebck^l9Oti;u2-HpB@erR0>lr~rbT>?!w$wevQd>!rBj
zd}rjwR?PE(z=^Cs&^e#oI63f01hWdA;7x=h^8zMQPslOJk0#y51h^H|N{3ZVc6-|W
zWC>%qDj^J)g9t_DW`(#~G-jM-b?_bYNKXAba~x$8U3#=1r=SBcJ{RmwD2mkkEp66a
zkgyf@;HoW5!SZZ+K0+yu;gdXjURvYD`@ZRG^h-2vNa3ZaRCTSH!c4_t-WH=)tM)pb
zk)}e}Y#p0|5oxVmU89ghHt1F$@rCnPk8y><4O7Io*WNE*Mo_1suXO`eO~!E>mKwmo
zLn=C>Nm9mV+|Bz{YViB)R8r)^`Iuw2C%c?wPTD(a+o<03`P=@FHWsUOa*jgAGK8%<
zURa2pa0HXC9ApHfLVvmzmhRA7ck#>kft0GM3Kc*-l1aJ#yN(+T59zpaEzZWKq${7K
zZ+6o;3vJBKNVx;8A~=6Iu0JnnZEk*dytf)Dee$6*f;oZTcx&O!=gt?nvJs~h31aTe
zz#{raQJaC0o&G?v;`v(hRf;==K(!N%=~`yPGAG%WUppIrjH8NGN8=qBflDp($8Gnw
z;;Su{u-W&{uAbv<&CFVJ2TCWp!!Ja~6&~xh@wlXx9Pmo}y;JaRGM7rv!|~)o+bzQy
z0;|$h4^-vrUyn@u`RZUVi@ag#TlNXNQib!kzU3TZTK-5S_TzVs2H>7vLOgGd{Q1%G
z^>cFyw;-J_>C~D#xe}*g-3SX=b1k>NZ7AK!gl^R<lR87kVN+UO5qm@b=Ag#TlyNVD
zwXqOZoP_<pNzy)WqwAKwkMJ%Yt}xfG%Pj0loHX@U%h!u_7V<wmGuLD!j@s(x1P|0(
z6m9{%<QQ3wu%n6M%@L<Mj{S7LPRsEnx<+tVjm^%>0NuezeJR)9=6B|)l4)P%K9FT8
zHfdh4rWWihF{s&T+ccf9tleT??mAR)ezEgS^=8!e4lnK3blc&Y#rgB2KxvlWHYXFo
z0&^o(cP5xGoGn5h1k}3k(R4S=4KvGlYq-sgpFto`Zt+T+re?sW%#Ri#EbX_$cy*Qa
zr;heZ;!395KzV_M?#4!+k31;$sH1*<?3svj4p}<U`wkBdc71Cv5TX!DC3`yE0KBh-
zthEadr()0Y7>+gu**p2F;#*k?EAXe2iMT#cm5U6*9<Nh=<bi#laY!rOl|15g<K~0M
z;ufn1$CQ#Q|5CX_1k4(mAL;<i&kr9B7_vbJ&OE2m!w&>`b?l^;31<~mNMk~L`v4zU
z)Px%8+S<42kb35t>1P0YP2r&4Ki-Y64Wb>Z&c@^*g8Y7*ea*H=Ji<4w^?WUuF|35k
zfIM*10+u!IB@R<%X1n}|ZY9k*3JM!~yUAK}+zcgcB8FyrvXs!0<|szB=zZXQ-V?`*
zd*6Gi#Qoq3EkLu}>ZYjH%0Zw&0#oIN&0QZyyL57uPXCni#j~AwiAc4SG0<y)C2Gm-
zxDpj!g_kRl^Bpw=uPq$La`xqE#BDsZSGv@toyE8Fm)dDquuWO0QEuT!X@N-pjKEa_
zJ8OfC`xf-p2{}^L=iFHha2~Leep_T~^w6iu(tm5U@n!rzZDFt#=Ebl3$Fq@`(Qhvz
zDH!HQ4Ix=CyN)P>0>{<weG&L^GJ7R|*m5SwoD_QoE1{!Wy~mupXHWM*QHd()7#%|a
zvoa$lgom}h+brBataAKff0V>&bDH1vDI)BL&%}M{N}O*$Iix>zAUxEyZRuGB4+aMZ
zH(V^g8xZVmM0>x?AM;*NlKsqo?|gFx4ZWj^{?oemLvpZ|*#wq98;*U48OIif)EmOA
zcJzLKaQ?<H=KQBqKomNT!igS4HT_OBq~kYAJ{{`C9ophDv*h4<$v<x*{3WaFqUjlH
zTwonE%Pp(PjbdI-2@lylRx_;UI~AMQ%sCpzE^65Zfzi$fo|Uoi6<g}E$9zP)et>N@
zcF_G`ocmM#2|~bB<l$Ll_|?y!Qy^{s>J2JE+BmuLih{Xb;Q7Bb9Nipu;$zq>W(O`A
zfSYtVGxqN^c)B=DFPy|S`7O`yj7}2zCTdIt4AQsm@AXwjl9SJ7YdgkroCmt)Zx(Ub
zoj7Pt1jr(<Z^}K1PY$nROsac&frxk!L5@;Rt^rmmpI<meVAotTDU4WIF6P1_uPbct
ziStfa>DUlwj;bV(^BY4cTQWo!Jt_h5`^Td_5cr($7Ngt~9c_q_A!YiW&%RB3eVEmN
zsn<+B-jxXB8`E#A!QYXsy&;}Vc*Q^Sed>Kv48n2qxf2yb@=ggK*6{z$|H2K$M^3BE
zyxTgPpk%Y9b7hA<es_`Ad}lNuQ1yIii<^xUjaUEt`ST$de41!=GvsyK77m*g#_PBO
zOWf8r4^jnd<r6C+y^oC@&6^_JJkPiR`n7JA<>mXSDjC>{^BB1+=PaHJSLD>OOZSb$
z#l@@UszsDPRSH}Ao7Mxpp(}%&?R;5-=2@ns3z1cW|7l_$NOxvzINi-^(AfEuNe&X7
zZMobMkbN|CBHmmG>MTLOnGv0d`sk;L!t-K*q;Iw%na#ayH%&1V>-?;In|t%9YYQek
z%zrajWMqE?{%;l)A4gQ+x{$}G9y*_II2nfeHHP}36#rwTrpWu3>~+m{{NE^2PAulr
zC)gt}rxmuY9e7`_Fp%V}`9Y-JcsLd5PuENe7(OzS+>$qj1Vyk5i(U9+Hk2bj*5%`A
zyb0WG<AJvol#E~e!6hy3xpnrq4UOEbyG7zQE8is$wzK5>!k_NHhU;#Pm57o)YHCWl
z%(!MhlZ(e5U26Klxm=;$?+Xm!s^bM0>x1c42E}3|wprL!EGt8}eD0{Ygam^MM@)AX
zSN7?k@?W}Htd1Ot3@jl*(!g+X=6?SCxuvCLiT`%>{0D>qIXStUdT5}3&CLg-#<^G$
zgq(((s9PJGjCEr@!z`r}wholYE<2j9dk}7vJ4yq6M5b7);d3lRI-HEG>c4Z;{tJXG
zCxT-@*8j;3BfPuhhLMIdOd{9;!Yd~o*?iQn*NTR%sq2>(nu;$|Tx4V!!#1L|W~z+@
zl3J2$Uij>iW=vKcONAQ*yyd3v{Co4cxD}tjeE&aHEB!yJj{SeTsQvFrKL0PsU;l4z
z0z`#ud*+fOy-sVm&TSeY#y<&-v?V?3WFOIMZ)R@%Y%64mmua@)HJq`yyh}}uvSbaE
zDX!Z%`{_Sg4oh_F#AB~D2dMWlo#E?`9=SG&GozLEHOte!4C8MejGP;-KS!q{dwl9&
zLMJ}hYbYQ^`z6-=C-R8mX`8VGvpeXrxWN3NJ0{2JtJ{jXaF;P?T9tf*F^72R^TREh
zh%Pu_z1l4RTQO;a5T8dP#=qx={lHWUsxQy>+0Y15_j+A+>LcU3+isgVhK)_m(8?bv
z?Nd|n4VisQe7gP_24&spwG}S$i>XD4X#6~<-f5k+A6}hgA9s>j&?>;|w*L7^COLH;
zchbwUO^0gXVxYpUB+GySQK?+hlbA~EP#xtf>Xq}Q2XP$qXnf;iGz)VoAvTwzej$zJ
z?~i4MUjCyJVmSgA;e2BMtzRzd?Wg>Kbp|i3(X~aN!Cv&U*S`V~FT$=m25hU0r4cp3
zr}pH<!8~8N6)IzW@(oP!2eBQWPBvOW^S^9=PER&Ig(Ai3pO?Q&dZY-^&bF(~(fF++
zIp#el2Ccd}Pjlk${Q6kmU%&781})z7;L1;Gry*YN%$S(oYwgA)Qb#Ep!I-QP>n*cg
z{-IDeGN1LJfFBtB4A!UAD;!J9*4hcW57=+U@2|;Wzp3^A=8~suTqD)0z_M&;RM>mG
zY}@`5%zUf6W@(9P(xIumKB+qF^+W;TWFS~G>2AuH6N+<x>Dw%)@3b5G51=qwrI<t6
z-tEJ5v?#f%p|VMF8nakdJ&9-p+yu9*^M%g&OSV3_nQqXJyt_$npj}f}sK%;vzJ=i<
z9}Kptzt?KI`SuK-ycy;PPBQ;vJ&uV}@0WA~6|4*S9V>zK=+s0ScEhMs%JC<U330hv
zgN14&9AmUyp*u8P!l7dICCK`O86_RY07x#dxi}7-+g!@JLXH`AOtW<<L(3eRoRB%3
zm!EL%CqA+NRjeT=@ak2k|0w0hXx!QHe(qq3SbDcmJd_)2Kze@aOUt>3ti;s3++VCT
zf9~l=du$%O(Z=j{O|dpsNs_e0(G_-Qu=0ua^VR(~k(`WPmRLhE>z<iw1*9S*0D!3b
zd6DD&18KjxfqNMwysA6g^l%P@>^TxEvUxMeA*Xt3H>C~$;G3eMb0##tS~iuo^S{!#
z?dMN6sT!tI1^l6Lbr&%;ufA#X(ieMmgIjYOiBp`tLNkRh`r@e&OhX!i|Fi>dG@!GV
z(%Qq9q?pRbELG81<ih1tF}v``w}9G4ZR;>)EX!VC|M;q}LCs4wPVrjQqh+<ARA)J7
zl%-4j7{s_E{T_^}1RdFp9FlcAJ;b=EZmp|AXYdK0N0TdA4uc9iA*uHipwDg?NLg_|
zgU%tNL7Q}?<Pi}Ob8&Td22yng^+S=QEbUtXEE2H57&c!eW13}hD!4pd8~j?Y-U6ek
z90#E(+t#ZQGND<w6i{WD98zexYVij>4CwWc(ncn3Py?b?iV7V4B<gBjKptzu=>QmO
zuMZ=+YOoOYX7`~s?almC!ux}Qt+e<g+-z2qKVpauc7vzpBC*~Il71|8($o|fzWP#k
zbHr}?3yb#nEbG1W>PG@zrgI<lscJn}<<z`4&rSCaajI|7pxPHw9liHn$GE&s#^gs3
zML;Xa-}a58EDA9X8!;??H97GmArUgZW|MjiPaiAewd{UHf|(2#kDPxa)Y+58R3Jqv
zhK7WaA^&Jgdz!bS95yB5KMV1dlA{XcALJ52%yx+B6iT1xcUAc84<#=46cUdnbWF*M
z3v3_`)a~%>g_&b=W#z!@+r8Iv$OqEF@YrLJt}5wmHNykG)5H?z<A%IX;G+leRK5%N
zS&P34KD2p1781-94t_@qfGd`)Z9j2UR}y#QTKkUB@6WLB1vyNu^o)nQoAeuchXik&
z7aVg(mn4<%%eCdsHt9~2ejM6bspYo%Q9h!CnN^GHVtZ78cBBFO)c1!bpC}|DZ41W5
zpU;xAl3e+K-6(kOqJ@(7)aR26n)BEkW%}g0AFhAo3={pCe*YS-8Duc_$<UKMS^H{q
zSYkEmN|i(+2^@9*o5}%P^4p~Wcqv05b+9BE686n$B5XPh_s6(8Ry6p4Zlu1VbL01(
z**x3v<)J&Rn5vKfCr6V_N|9<vmj8Aknfn|?PU@4DOj{fTe^XnN<7Ankady&eGgI#&
zKlF5eA31%~)uAM~tNBlY_gCVqH0adsu)TADzeHCc+D^piLAZA4nwaU2j)YoU?6+0J
z!)!}qM}zbj_2H1<XIpU@x!$S4!6v36H#L5S&g8LF@xpjDb3PQ|8U9-4kU0(eGJGt)
zu`Vz$+uvXBBdM`#Ewer9aXzw4b&pkfvW8oTN7`X`ELgt0mR^M;N-}@iLwWurp<htU
zGuZ(;pWi!|T*hPKZauRT$9c^duV6c8{IC0AW#j^O+|`x`+H+blTEF?1AE)@`)UhMK
z`ThN<KJ(ov5)gHoacIQQ8dv0tN$5AZ@BC&rPaD1(Guu%&TVJBOqAZ{Ddc3Je9?;G2
zly3-s7voJ~TdU`?|0HzS4M~@yAALWv5Exh+3ALVh_%o+GDT)LNPoR<TLF2-|6!nKL
zG7)5$GlmIKh{FI{#&NHWZJb@2e{_X^lU@$GuI^%ndNLn};CJv3d(O%!y3;gpt|NGp
zTz5QV<Z+StxNmQSgP*@LwiThW3G+jz7M-|xA=IzI(T3?->#HUvk3}5`pXtMvnJDGj
zm9(wIf7JWqL4cB3mWEXahc|;e>C~6YaMSs-t21_8T`b|V;S*!$$cRm}w9Luy9uTOb
zO(R(OK+IYh9k^P42scD-lh{aVND-LJB>8euO)!Z9go45EeV}?PQ7*8QJAY6A%s~2d
zFYD2#o*k^|`svt@wEnZZ@yo~wh{X}*17T}OXRSl1xU{A2-p-SI?p0fVIenx}Xon?o
z7CCODOVVo;6j+wm5X!#Z!Q87goNZBEu~>WHcH*+ya~bSjfc-Cyt<uKLoJgd&ucQ?K
zRx)@o6?S&|AY5Kfy<!?EMw=WH<BAE#H3HsFCRC^>iKW$TA&S`5YCVj-u@Z)t<1N*^
z{x;S|pRw`m+0qu-_TI{jxog@&2}z(wMpp8iOrG0?|D?Wz!bbbn-MssgW<$}k_xIIN
zg0__W*!j0dp$F_zJRZLGKFJ?>TG`6|9xTW>wTp94KAUM=J`ym+PS>dHOMJ4QoBF{H
zj7IFHMtr)^W)Q(hT=XU+qrAjxe^yiemFM|?Ci^zRwjR0bYRoCe*}?v}#H*w)sq4o=
z*=P{z5GU$5c)*#``|Q0vdiBIvdFf!Nw`!_-R~g<e<1k4pp3}E(3P}M>;dgsojXC5v
zu~Q=XW-Ch%xLaRentQ(G{HKXa>VRX=73Qbcu=_Uth>+Oe3HcM}n6T?ed|$fRgJQCA
z_mQmr792|;fKnym*sZ~tk)oLCX3Z?+;!o$`+8HS5>gA@uNs2UEEEYDtWlJ{_RF;u9
zt8aRE9tW}M3b?LrEu9S7U$88?|I7WougFK2E+GTeqjhk${&y>Y)g_(D!5@CpukO9!
zOuo5mQhVJ~2j__$!kdnj*u-RQ>eRth#ooG8(aX4%>ldlZqPJD;>_+#)0@fi+MmE~}
zZam*zffh^ysizn*tmg_VlaZi=nR)!{=CbxXpfvLvPe>;=IsE$(-dd0}Xqn8{ZhVt}
zd0}?p#vp6$M1cnTPsM$DRk+&rD)&V(*wb%bxD=Dn>4-@9p1>)^0;*Ge8{n}#YT))~
zo#E}@mOj{tp=Y-WOH1EqYm+4Wr;{yT-N|Q*9l|;X#C<y*51E8k12|{HkkqiKghcb9
z&E7a(!u*a4ruUP%abu)k{e*v&5}EGN{-Df$5p96&)Dl0**>1+w_i)f;Wxn%+2v2Cn
z_#C2aG9@L&(9!M{Ta$hvhliJ2S1fb8F?lGeTb%hE?B~3Z@_M4f0<iu$`IrtWN9q{a
z1*0-qeMHAKx-+5D>aZrMg<0E?>hNpmQ#C-Ykh}Ll8anAet_vPZ(s!Hm!L2gsG&M4!
zYRXvcWSRY~Jb8YriN@XS&*wUTsJvUg84$@@wG*4~@Yh=f0Ag~o30#TS{j|2)ZFg&T
zj=a7Ampr$;++_raN=nFiZU|Mmb^4?SuAe9E;99peYWXKQlc6R!izu-kL*K|u(>TPT
zxH4UB(3;aY+FnzwM&?kY{AZ{g7Dx;ITmIw1^)j~Q@Bz7xJNTAgS^jKXu6dZ=B_#mt
zXew2|#<*i51$DLT=O3&r=HO_&?e7>}@967OSo$KIS<Q+|0+4Eo23)gcib%rCwv4B;
zszqPSO6WD}BOF$1OXa0{9MVAU`;T_*r*h7IQ4DYS`(#~C*hjSU{EfHj*>6^i4%3eV
zCHQJ9+%zGOlsbmW{emP`QK)MPtX1ciO3BPi)=B@CrZ-hegQ>QaHrk_}Zo@LyoW^x#
z)9u*rBevcuc37*&5O#XvlFm(;_A6lCU&q!hInU`j|D!QtBg_KzYMV+Q+1o0%6y&ou
z9`t=*)XW%ltPSa&U8c?D1B)j@nB3{o63h3s)Qxy+!h&D13#`u5T*3!r)wx(C*^{N=
z0vx&0I)5U5>*HGB3dJI3S)e{MIM1x!7A%x>H#9HNnjRRP<`MWGXZbhLvrx^S#R`RU
zhWl3GO*Ux}>&3vOhjiq2;R842##&{9UaiH0j-@7xY8R83^SVznC@s@u;>~EgzoD6}
zU4)LWg9`n^;}v(j-BUewOr%|P9J1RG#2*6TXc8oF`_7#(l01r--_r6jTwZfVo77F%
z<z%MD6pki#u{MNs>9ntm|JiJKr!7#IDY7|~xf>EESeS$RHxhf%UvO$ter>-Yn0s_7
zlqHu~`~C#JG_pBvd-E;#yiHedCT{SAZ;#WpT>i={P|PPHO^{H8e`<Hpn_n$_6*rvH
zk9Y|JvR)_>{g@=6yA$4Ti8S;jQLPIKY{ZgbtcKO4*q_L8`~0^i1m}5fXZKE(^r5xs
zYrWMpYr^`|FAcx$(U9bSByJ}eVd8jyT`gVQIB)zxFOnKcV%aY=4p|Ym<t}``$!BJ8
z8SEG%89<zz>l2LgP_`yw{&trF>yAf>X?wp9msxrNWu9)>!6}?{@`}}YoC^=4sfB&K
z$#>udd?Q>{K7l+GNpjhE`|6)2V&Ia_i~A@!$a+|r&+{NafP^OvR4zN6w6|0Bd35<E
zbfWzCBauS3^-)X%gT~(pB_nfa_Vr|ZeEAHJU4;BcTKHdpZT^1?n>fpsDSczJ+H!R$
zb5Gk_{jmJmmr%`dIl5{plE{usv2yF(F;!9JZ_*q3^3yZh>kAqWoezH`#9MLk$p=O{
z9t=Veq?)%8&-}2c*|k8TrvMa5A~;RHyjlU)?p;Z%wC`m`VMp@<TfSr0CCH~QX0+EZ
zG_~dOwlRv+#nuyo#PX~@F`vSe^pUFPOFeZ$hNH(jKB#e3)73njq+_@bQrYG0r|t1^
zrYMwTr}Mk&)+oE(f3!{yE3~xS0j|s-4x74U{bFDsajodGhfO;qaDqEW{48uVsnyJ-
zQoMSSDFQ=xmY0J3{Z+?qFPFbK#ln-*cFp6QaBD)^G0D_-tkS*aB5&(Y@9o)|hrJtD
zZrFt8ys@ig#3~oQ*7%$=_0zS#R|4|Hy|l6`U1-xNTx9j*)^Fzj!37AKP5QQTVj689
z88HCs(Tp*1a*U+E><N~dtttCQYX<5rE0YHgu88}YDMv*V2Wm>AA(d1pd{rfDsCoLQ
z+^4D+ha5J8#QfCr$^acmTuba@L&XNIVz{@r;_`FfgT-Xrpy(U>ZPPpz*Jo*bxjN74
z_hP6E%oHb5dqzWp3<l9_Se*srOQJwzk0sb~psL`y^@4P+CKFS*YQ``%Df%L7ikN|3
znLHsLVx{<dgowl=@=h4FWvuM&FHuY{Kiyr5{ruJLWwBnE*McDnN*2RkxG8V@yXK_V
z9py5P5P?o9>r(K#t9Z~T<$YHaxp$L+>q*)ho$t@Mu1Qo~Ym{k{y}cHH+q*F>^5TId
z7E>#O5*3aN!j;%!kq@2ET4EK^8(-FU8Ye5HkbPO@1p2d?iu`6(2><{g;_AC}XiOeK
zszwghoqu88spj2RR+FFq)V@DytSI9*L%Erg%bhS5agSKIv1?{3<HVUT=B<9Qf?djt
z4_l`+9eTcu!|UQpTzg=%fc=kE0pM|O?zx{~u^xG6BbaT5%SGfE<eW?ira0~`7-o^c
z{~1uhIn4T&R!n4-lPsSp{XO2>kpy?IyVtBoW0b-H<yPpNGx6*p`-6h7Q6BE?-MuIW
zQaP0o^r_UYQEWE8tUw?)<(6v2@p#4nU0VS`U@M{Cslgwm6H(q!&8_dOX;uHhfga0!
zJ~shF{0<K0*%F0s6bs-UY{;~WOjoV$ULcJ52QI?v73?(_2a<UTi;Iix4~!iaoXDW1
z`|ATJt#rYIQr)8ChHIpyaHZr<QwC`z&7Y5}9uR)wbMz-B-%w~jMz_Hdj1w^TRx<Wj
z+K$VQ3$-P7y|`zA^jKpTFdE73#F+a)ct#T*7xkAtJCULl@A6#iN)yo3<>QaL0grSM
z-0_1AME5a}!~bx$Z1Y*vY)&b_<Hz|7o_2Slv~`V0#jNs=kcv~y*AN+0)?EBgqW?S>
zjH6C4XdA-4&`o9X^It3yZ7-OcK>B}KuE|I#>dW%Fk$ubmn}46q0ZD02A;(B%TTqMi
zl%S{1@7Me7iN|^i)?UZsG6&B)=L_HznIz$2tg3Z)D&{1K6U=K1^^iVksrh8D_O0-h
zd9I`}_Euq#n%k6To}h<YW;r6(XSSwA;rHz#2q#cQo>4v0L*mFjw-)XmJ~HY3iXc)u
z)zb_I`(t=uGH>|5q%tl{KlZAfp-S}$lVC+Yq`VlaD#`EG(%+dJEi<fgkg2#s28}Ma
z8q`TCDMb#3xW6U6=wUOySM*5D7c3EGwl|w^Mm_hPsu1nG=YO`^Yz2cQq)N|oJ{xOP
zvpf5j(zw`ls-ms#cb`;e$I(H2M%~#>0P)doIdBK^{s*z6BBsM6BQ(~}_zl~V;Csb0
zPdWg-v{UCH&>5lA-rtMn%Fb?owbh0<Y9`hEy?syYy%kQzN%<-)ftpEMZWq?2l;1yd
z<X6Tc_G^^*?DUo)0RMI=C7~+TqAr=?bn>-ss)+z_O-R%UTaa%O8myI*ZHWq-{L(oX
zMp+&exHRs(A7jXDJ*z$&vL9|9|KnoG?i~MPfGBRs?x13?(kpeXkL@0Gs&Z^?lqEd!
zo@Q!XPF^mU^|-WmNkhpAo}-!zft-9Ply2|Y%1&)*<vaA!DRz|A;fF+yXxnWG`KQfb
z;HrOYT-<~yFKT-`m5{Vj4x6(zF$D%875eh%fn<iF;$nryj~;HAi5<Jysr{Tle)*C#
zQq1KLgcKwrRcVrrJYpo#p%Li`F-*L0NgV^uIp4sxK}KLd%)MXi@GvykyK>+$aA~Yp
zJHhvvV{1|3{Pi2s8|yf*n{w$3PT<l^VFC~l1UlaY5pVtDH%a)_^uqjQ60vw~b-g$X
zdyeyuQ2ek8`bx|0`R0qSf=AD%C5AA3RJ6e`{t#!yMow4-1#i^1wAdxv?z3!QDzb~}
zDm?w;s>M)+uDAS0l&t-HR`f#jAvl^PD>k6n4h_?XWFsAP4_Ej(MyAi<848hKIF@S(
zqK8ir?WlaP;YxH7I!_{1^ZXA&byLYxlEKd*D@S6<eVQaQ7~eJ1L19qiNnZ>QC^UT_
zzn|VHY-}?*OE|l;KVT||rt>>o`kF2(<F^&MP6W}CP^t7Q#hV#84R{jzQtSSc25L{H
z^Nr70qlkh8wdCQ~AqSlrR3N*Py6QS?l1h7;pnxh|ua;xq>79on=|7rF%Ez3_vhA?E
z3})kUw%d4aZ?(HvzZpcxaikVJx*L)Xmgs8E!O8OfCQL>}hqkb_7Yy_c&iBr}Qs}<O
zDV=!Zsnyn91&_)5N~(%DjDAogkk<RbYA7T)e_*W6gb(O(NQXldrWGQ$JTr$Mju?=H
z`kT{Z+K{Zcga4$JT4otOYHQm2_A*=B+722(+(K1!#jCOXG+>@KcDJpfe<HCxzufQW
zuA3;fgkru|H%jjA?`15>er?xJ&$gtddCaGDOO<K!m+ReBX^@-Z&SJ~w0P@>HG8aOP
zPMyiNEJidq+}I#WAtH|YJyynmw*)YED0Yw1t9!lu7`$^YxqV^(XRa!BX1EDN6qU>X
z`33}P=$iiy-k>;~mE$iiG^x82HKJ`TKKI0okMxagt>s71__^9RaW&r%_SatEgCi8<
z`*A$L)JJ>t>|x<gc}R*kjKP+YPMd^>f6UvsXqZde+p*T>H>s`W5U^h^py2)*8WZV%
z^e1W;9<etXqNSsybiSzO@tB=sU1ZYxdZ2t{x+EdtBJ{P21wtPpd3qoky7|1LM5Anf
z7e5qYEF++6Y(LO>yh_`C`ba<yQg`jFNUpCPNtmb{i;ptp2Rby&RThu?H6jaD+l*2W
za1%(@uZO}_#jAgFx=rD=hPoeVvRCF^@87PYu+T^HLa1>Y|4^o?Ai|27^7z#J1=NYp
zjZFq_q30Ag%aV###=#V9MU7Jp+(=8S7Z>IYB@<iu*YuBR1+QQC+=^We8WH2reegS!
z{A=|CJ_>TeN`A)C*CPf91cyPr>h3D$qGLaJ2eJ-9bmv>pWMFn?2jwAcV$VEcbq{No
z`YiVS)0Z)BIUk@pUpJUCIpu3A4Un38?-wQlNVP(hOtghhUn?}fD+A;chY1fZF$6Ld
zBxwZgjx8%(vicKq<{X(yL*>Hv<!eYh0jl&!3OA84np|v`=C#g2nEQdSuU%HH=OD@=
zl{L)pUsn3DOb-9`h;T!X)s)IR%q)bHqBmgmvz$7~)2X+*uFf`l5#itlNrxR8=7gs(
z&;1=Y`?^yS2DUMCmb6?l&<{Vh(UGb<GfJ{mm+Yvk;F1>VTJ`B(-^?dhzV`{BN!Ops
zFgc;EW}j)20$^M+dzxTjMc4gtS3sUX4JgaApP~5cmjCCxC@IOWiNe+ZH947AP|*FJ
z0rvjfyOA4Ih$e<-d*Wk{yDb!t>c)59?Py;0`*E@*EGBU-MVJ|#`$|^rOET_8dxuS}
zjaZOfA#0koHM%H(&UVt@y(y<I;a+QPTV^$oQnMR?o2DTxSERoZ2w6w!&X^UWw3PF>
zt0-e2I?@wo1lA_O7GysIYBBtuv-guKEYGtJORiQa_2>E<r<^WrbmEYE3dqI6NC<Sb
zqwBJrh5(wkGcN`#_?ZA3%Zr%R#nZ`H3UZ72^jB>-F6E>L&vsh(D9Q*CN3$u-CM=^G
zww1~*>1T`LHGeim2)|q}PDX;$Del3#pnq7UivfWA;{!@r-&v`vvakA%F-q?!>tnrs
z)d$@mU1_26A=&bPvn4TQ{P2ztB^@>E+(lRkT9a_&%%i=+4{JWLQsUWBX}g{@J9QXF
zU^W4`TO_N=6f?yfz|}l*JD|S%#j%P}+wB6ym4@HFo)OA#5OO$nsB}Uv!N}sv#(#k%
z(tBrrZ;rMwII~s(t-YI|rr0g%_nsejk%R7s^e1l5bpe};Scfy5zwL^a&RWzEV0Zv%
z?8~9XWCKN=|5a%}H~gom+SLv3g=sZKlY}f^66zfflngIi@fIc9JKJ!3SFf*C<y|-O
zORP()%5D8hF!ci{vCFx1ssfTNtD4bCdhG_z-XKctsctlw4k{KL&%-usDoRQUts@53
zFJJ{HYpBaB{R{w-RW)ZM71*e(9r9n(t#&#aZO)wMk>nhi8d$$#g}LLRnq|B0x;}70
zNfP!`{!<MSUL9qKy7MY}!rwcB_fkGgmh^(mK^9wEy`IxQuQNR7zVLg1aN}aytM?yP
zN=kvq(zpqDAM5fHY~(92(X|2>+{jWtY{KGe-8_0@lx2^?$7~?KGh_Cc;^}3F=owDd
z{Z;nPZt<!G4yt{_&Cg{o1Z}<t`D}8wCitz_eEc#?R3Z83nQBuydJQ-n#BU7)fst^o
zx!FCVb*0GEAc5K0k#0Hxc6S7};FrK<|9)B*kySl<zc(F;YLuQStH(6;dn~2?!phD|
zc&cWtjfQitUwt`?MgmF4l2vsYS08D|AddUn#?F3w3rctgN+moMo-7gCAuOZTNJf!D
zYZ1NwIx`>^aGL+Ez3&QZYU|pC?N+u05CK7H8dN}<fPnO^6hR<JN$5mC4ZRl$hM=f)
z5a}g=gc?euB-Bu(Nw1*<2uPO}dJXUg_rCa_b1u%^_niNE{;PE{=UQvFHOH9mJJvg3
zp)q%L5I&xj2(1rQQ0U{ziYAe_aILf&*5Xk8Whz~gBVyZDAGdP1k@Umma(F*mCR<)n
zKw6r##0W5xvgI9DL@7}j&o~s!le_eG8cey}g2VIC40}#~@Rl0oLr{h|c)Zs*tEQt9
zS}PfU4-b<!6%S)Ud=rv+$|GwF_J^;wQD!_BRGX&c9Oh@IQV<v*W;fyn&w)St1kA!o
zFF78}BIfW+J$`_d`VYs#bs4zZr1Fhm(-6!WWl=2gkvOqL#Ajg$+4$bNItODM=l2{I
z$hhXZ9<8+_70IIX9J(;|Q$OIhA3z<O33E1o)mXJCckHCpi2SyZRz(2Sjb6RB{UH>p
z+_JPS+nOGfo9}n7U=R7o+byOstIiS63#g&LOSa(fSKw8nkG$HZE+TL2YBJbgvm(2Z
zy8nby8ZoEP;a9vgvdYeLHUU#~mCMv8Y;j3R_M3)8#|xiyx$EZ$w+Wq+?x{V^;TXp`
zI6AWY%CJA^Ffhf0SWR~5Qf*@;zfzIQ+3oehp2O!~Fy#bY#MG6;l&!vJK1lA@k;-8;
zhp95@HoFY~Up^r6XMoetSEDxdV;$a|K??p6D@9{}ILgG;xEz(k;XE#DZX^HzIXC^j
zuwh7zX{YyTvi>rReS-Vqs`Y>!ot>@4Ys;MjUOsIA;k-<qnmx+?Z<{o5gu&s#kuh|^
z;n38|9MdRQG%9+g3rDl4zE(w3P>L%r(wZm{$pW*USr+C`KDe5U?Z^mvnOaZCW(a=z
zVY@<^4jC->U@l9@*rJzGLD`}gRAj5pxn@FN-_L8cwEboHTAkL!>r3>z_ci#=o$||O
zZ5_BToJ~$S!Dq|I+|cha)si_e=VxbUCld^<tx;(7y=dE&sGa5G?C}C8@?Y7=P(C4n
z^<=Eo+SCwR+{STIk{vKcZr5XFsL<3m{*NiIN4~ob&A%>HAEh+4qw)6C@27mcf&wB}
zMM|(=3CZwS@)+<7_nq%d<WSl#GNr98w9{v!$h7WSGSUq+#84$f=E%y2$4mtUR}@wR
zfrcrCa$~BKS@?Wf7ki|1nzN0~gY9p8RKYm^u}?G<YkmfWx%KXt&I@AO>mjL%cZpee
z!Ky}qA@h|rcUfn<T*Iza^UMCGn!}*t>KwT<LT?=S=M+!lJ)5QXbvlmZ`)lH0uz8qJ
z<{8^iaj^D%?AF;APvau|Pe{$*%>SxcXy2mw9i{Z}U&*rGKmWJF*+Bh&F%BQP%QJ_w
zua{@KpEaqTtGT`Xne5+BY7S^CWDbb}Qqp+nKLu#sf-j^m!oAvYyZ;J!M4)(Qo056_
zlarD%^ER@*|MC9=Bqd2m!TPhCXgnVN`Qq&AfA3!<kEDNrP@6yg5m8RR_#dc%9IN)1
zN>Ti_f$SP{XE-hgOD@xQuN{Ai;8qeD%)@v5_CUw;WM9(YIE~ZRTfHNKwv>-iJksrX
z%C?EVlZlA_nzy5~bX1n|tTXk<Jmm{h19ZEbhFQY{2qW<ZO+LU<Z<lkS(qNV;QlshC
zJhLqVf;|~fZoRqP&G@Ih-0E=S;eEZMwiR8(#8!QfOe9rO_@oKN{J!?hQFK*01Yc+K
zEg&diPx$6mYfP2Du?9wk!_;1cZ%7Au&>iLHim4#OW_Y(G5PrUyNt?r1p0}=xMo4yF
z*p)Z0DV<U9@KuH1sR8|Y3Y1SSjMyL|EoQfC8TA=KlGOiFB;DpIhJLI^-yS!WL7Tsy
z=iwGpRJ804Ra(~HX)cj*Ud?0f^JYT+$kPGCGcTwq%(IEV@DE71?B-52qqEO}PO*zT
z+*j9n)!cQf7FC7#a5Y<?`1Exb?-}V+qZ*qdrkV7<Qj3&zEzD+F-HGj}h`w*n@3k-$
zxcphLzU3sEkB;RS4rxz=Xc(g(Rqw6txjdikO=GBlL{-5B(&99G(txS*6=}dfmUp2A
zBgtQEZ?5Mqs%CbxW7i|2k3xd%-ZqKMq0af%f_ZsBArgDYYp?3lX<KkfPd)pVsp-0V
zdQK`lGNXf%c6DPHIcvCmgv1Adr#64@YhX=9mH%67XpLe>JvEyr>Ab$;?(Ta$l-H;4
z%DU+KPj=eA8J<2G_`027JiGl=RB@*-3l+(QvGIAia`d7j@<VL>(<7O;+p24Zfp-Q!
zZ-6R|=u|%4oHa1*T2)o?V0gzUgMEmQ@BNvNH(k)uDE8ch@xSQRN#h>c!vTNqic|AT
z2~>zlg>#(liYLzl1C_yP`cv{Sne*9b4YXZUMJ021N~R7@u`us=2Mat>0fq!EvK}`N
z9R||Te>(=;<y%OeX;ElZJ^hhRiv#40*^z4S#(fY6^7_8B;m#pISkkxW<Q$#2(&2n)
zk2_QdwhA@-^gA?S&46n|x;{toaO;CEbL#O{ZB-m!3~6oehHB?^!paKKR8-G2$D4eV
z?hFw%m2n>OmbhQIZ8afEVG2kgl^;VYTZP*FAJeKaRrbx>O>FQ!6}D*1?lMcNup2AM
z@m<!cgs>(%AN2n2W%;wGX0%>@`(J&#eD~g#*-)bV-mNhlRxww~1fo?gzI|BVU=zmu
zGJd0v6pO(d?gS}%Z_S4daJvR0!d878rJqfu(^xOD35=;090dka51e7Ng;e<Dup1<x
zi74OvtUtS$L-$CNaFXFH?1u3bJ;w6=e((5gSu2|B3u)bu*Jh`YTzN-~nOu6R&Msbz
zL0qyh%5y%Z8xLkqyZSIDb<2>B+G})s^=+3^Bk_>Tudz-^-j8z#A!7U<e`_{LmXRoS
zz~WM9s(G=`(LBi36HWSATOTEXknBE=W8^&B09-nZBqb#$3Tkh1aDYGxzPl?U(+CHS
z_35sq>%Yr$eC>Mrz43meLR0B~&Tn-s3hwir;XLC^h;vuY>eOpLrTI;${6}}f|L10l
zbcRKO!C)&wUO~1Vh;Zi1kd)5aJH=r2>Qxqhh>>SWNr~O$GbcYP@FR$f%`lYp9-0X0
z{yhuc*YknM0*}=cKWD-v7x!A|0o7@sj+X%6nMLRqYx&*dMSiM%nFSb~718`Be1pX|
zv?Fdpw$l{}e04_<56Y7BrE9HWp&IJ>w&Xt$xrYIAUnDfCf?zn|FdsJ)D-t7lxpnUr
z;EX%yoAHY_*lqOX?*Nj(FRn3laP6+W6iHy&+U7`%Bg>D9=T}Zn*4z^m_Hq6=9wSq;
zwBlHoQ#eH7ja+%|)Ld|8SqzuPN$1U!p=>O2L?b@8`^y22&HbXArxzZD80~q+n6H`>
zBlUI&EwOEf#$sQKtp2(o;|s(`Q$50M6c=UBciCO}T-v7O;&_Hd!cS<$WD#Do>aim4
z^lK%jWz>;nVTV`Y*te`mO)W%gvUz-*xmZ5%HZwCU*tBO?<P4ecPL5#nZyxgfan+eg
zpnz11GI|TJQro%CRLrt+jY({duNwg!)5Qj!j>x$7rG}_G`t^??bVT?azis@*Aq9V(
z8HkNR)LJ$#nSY$yv6_^7xO>261rr3!RZADV@inxpv|E&L*(_-LDKaUOFCgmUV`aD7
zXHx8Wkz4#Q-kP$S`J&nV@_<5M*mCM#!`i^~tdi8%aEYZYuzdNW<A$i2?yRDC%lzw~
zK#m8ko7$s+_RZbyQzORFsBJlm)QX?!sxKQVAYmroe)w$Jcj%~znurnV2wU@oZ=77K
zCO@z_c-NI~<q{haD>W51(piNERWP$p+XvQ@ZHy77a-xH`^s3h8Y{`%y<C2#tp0Mdn
z1X%=q-52u%(yG1WJf?<N`suiQP1+Bnm$!th0q|+1vi#(~o1CMqBPB1{k9{C{Y=c*>
zOJIWpi`@kx>q;%|_z(x4&P;}jyxj_qIpQlYXSW^pV%)W!uGx}87#U5B2b34@crTT-
z*JQrp@S2ZJ^uQGz2Li)6riG>Dt1`L<Uf&ywyy>{_pnnj3dEOY4^sSv!qEA6OZ|bXI
z{Qj};oW1Wc)EUWi|5ctQxagop%j|vNLB3=6QkG8WoKb&_3`d7b$n}<(u#+Qd_GVjt
z;v;BVOHIejm#XQQIeVoMDqFR8g<J8}VX4I@a+si;YlD)Wra_?p;@6fzLRxjR^V>G^
zVOmREK~bEOX<|$a{FxabyY_+OH&jB0o?#I&#=^|0cw<q?0Y>FImcf%lM2e^LDg5bU
z+rp8`Lk8qcHV&HsqW9CT1UXNQwt5XEnS%yu56NSvzsi{qZ@f#=fOn|sImWi#`f)Xi
z=nhZQQQ+x9Sg+<Ow81Q{*lx8tjU_&rHAgWrEQEt+E^p8wQOOeIIGB*W898t%-%&md
zrf3;5u}khm`*eNp5})6x3v;!trgQJ?e8)<5>?$(&T?1WbzHEJlc8M&%F-^x{_<8ZS
zXHTtaVoFvB_NCeY$+VhdV$~mwpKl<1B-<14Ubg*Wwm<y5M<ZsO8s|k4IZm13-A5dH
z9V*Yfh0H5ZnZw^IJ6>NAM;y#&aLpNdnI_i0Jeha6n0RRS{c@zhsD`u9DEKyjsxD>$
z{Ke~v=?V8L?6km(7uFCYLNfR>)-=1kZpwNlV7~Id`i0iguiqbLYZ`|nr6wdeEs5C>
zSrDo$b;0fkrOvsd?tK1`+)+8Ny)ZvZyKlucuQCg(z07d5UyoUKlHqh+0KKSW&^_Q|
z%hYBLwwh=d(S17O1LV-~o+wNXh2A;Qs-E=o^nqb}azC7RZA^*0Cu;J=0Fc3~Iy<${
z%<Wod`hb)#;=L83-AYOIRV0F%?gISU_HWJ5Q?<aqi1f`s-ef>QPMb+c*1|gdc%ycy
z+QXKXCymS-7cc6c8=T;n7wvdBvA?*T5yZ0Ash7&h#bLz<Qx$q;YfJdb{FK2B|Mp7~
zmp!wRfO`--k5b$5dg`<kbVu(TvZHsO-5JUL{ay{X(hsT<LAz21|ElyIsrp)Z?=9-<
z0CvD>j^MO>%Z;t;VXgvZdo4*qJ0b4~(392Gm?syxPbp1-I@x{}f*JgVMXKc+wk%9y
zY%f_VA`@j~%a)4=W67@upB>;p!E!*7wBpYl0Si!?vwDrkEQrCue8aE!SYN^dB5rNd
zgEAe?<iwS2Xbgp>9M~Q8(X{~KcD*Qk7VcKHy2|WSD&?j*`P;jQ$>IC$Gn+<(0rqi1
z8j3!XxfM#CH|AYs;mzZo2lN1Hr&+7FuAt_7l8F!oC!eDU`Br=A&Jm1%ELM++Wsf2O
z9}IwI1?$q#(5q^wJT_?Kz{Qs-s!^Ba)H81r8XV(IIk@_EQ&fPNim;OL-JOH#OIonW
zuPBPbA1Kthn0^K0K;aCNCIhcobz}U%`UiUQU6pEeAMnuQQf;Hot96PejVSzJMnQ_;
zHJ7gV8#10!UwgtME^W}KiQga0orlhrQ&I@R@~>T-hd(c>^HAjhWd?f>Z>XxQG~NU9
zTq8`XZiM+9<D1H-d27xozc*J^02zx&72zGW0iP@^iWFivWHI`S3DAImPgl5R0d}Kp
z_w#xtOQc-qh)uD{63;{pNyG{V<?r|y;`@~+QSFqKYpyr1PQxFHmTH+b2C5yr`55`v
zjt&0^9#e}w0J-ax+I!TZvehn}zt9@NGy77Yqw~?d3@UA6E!L+fLK4$`tR|rF{Q2DU
zw1aR)xhHwXrlOep$~mhRmHoh0wKq$H`h0?_CO$bLa#eCD70;WL@r1u7({J}QZ|iG~
zLgpTh?^9#i`{-J09^4Zz)9HAYz86#>Cia!Y5T7sHDFF7g5M$<jf5>=a>m?aSU6IVq
z-GzZv*<F_nFUMcti(x)LM}Le!)L_fAgKf`>sr*r4tRhn*_wwqofk6V?5v<lQ=V}}=
zkI)x&(zRAQAIQMNyvhpz82&l648QMT(bvOxkv=pGUQ#~DI?EP3@Hu|SiK6-41wsyb
zp@WR!K6PG(aE7Lo=gyr9h$vV~FUGQR#6@oRVvjX&+c$4Y%ff=ljpvl*Gp!KdM5Bng
zm!P19dRmdm$tAb9SQhd#%+;RU;GPRdJ3QiIRpkb29YPL?rRkP^eolDQr;m>`RvT(U
zelNePX-w4I$nULDc$SV|{o+`x7*6pl<fONNq2l~u6;(>z17KCr%HMwrty(CNXVvYy
zRjJ_|5~RvH(dM=s#hmjLj3HrRy4gX~gNVVE54ZK~ujT0=l?13_$E=}_zigvIPYp0=
z@nH7VWK>>vOKr8fqjqews!G$)&|{URmJxHNP?O>Gb}W<y!W5O-g$*9O?r^;IX_XF`
zEQB^vG3#^;pRZcLF5d&lHrq_d_gC@Wuod_SutI$bt0^-d8YEV%90u+$UfzXr<qLG&
zXK7t@5zXs*WFM6zjET^?&IG~+rJ$L5>;=&nIaCO?P<iXb#?;prnSypS_LCZ+9t=Ei
zEkyv&Y$-KQJU1ujii*mWp$kmKK}K|tBcM5{!4%{>1Ylt3`blhQuwc@3ME*i>Afw%T
z1a}R_9?6(v`Ea$w%n;I$&6rv0<IL<rV^%)fP~|P-DhOwMWo^;pOq&5r8tD!IZJfF3
z5gs&=6+IMOA&Dq*K(1g&<D{0HCnhIlbq03E6EXyYFI8`S?7WN%?WhfSOq^0$`KbFU
zc<hVe3h+9<aB{t3l-U=%Ibo}41YI7HHyZx@yu3@J(q~Rd3>qK2*K~_d*S)r!aCe?4
zsCHkCPENHQ-SbfN(-=oJHRv4YbpdHWz!o?Egei=ScpIvyh!Gc)bMUcZhd7zrXH%Xj
zCrksuXQJ5YLl)tD!aO{g&VJdU0l=6BW(ywq1_P6nt&RCQN8<L{LO?e0ri#ONXgA05
zfcQ)6$PPSJq+bOHHbetL672JPg5D6ZnWO0T`=RU}SONjP=nys(Qs&kYePB4~<uXte
z?sKiwrTNZjQn;%qpJbU#(lT;yDN43Q$dt!@BQnWRnDI(sgeK3mrPAAC<PKzOC@AMg
zkRsqNZo;E~HSdNfV|97ulE?&C)+RB;A#8%xHn$MX>UuQ~or_bK4vd=udseA6sdmN^
z?lD2DoeCp=!4%9oekFO^tueDnpaUGGkqPJ|lr9{Ey$>_>4G7v{<Tke_++-0O9wLN1
zddT=~)fn#z<3M49G`HUy|J)VsVaFu=!GY4v#NnPb-NMchmOzDLhXygBL0Pyelgy{?
zc~WYPzgB~jC3-$|TX3-5x2@x;#$|RTIRs?ip}?)+KDrI5dnd)Pflp<82<Rlyo9{@j
z(Ci6a#T~~(*f4a-awF+suWn{7!P(495X#awMuc$Z8Gs16U3plb3flC-o2rs_z(kni
zpM>Qd7hY?#t26yeQD@VZE9ZE5o8Um<-jPfQl~9tifLFad+PtfIYV4p`H8W?a53z_f
zC#IJ#+oBd(0<hC8*QN_GJ*Prs70|10Uxcrtv058z9b*{>JNL_ip102Cc3_JobYY^W
z)MKTKwi-fNzci9d+;MlaIIm_+2KWsXA~&if6FIs=)!{pB6h~8u4puRwh(LZk&|GDZ
z8IrXSKQ!6v<E+IoQ$o+Nm>si1Ov1?0U)kslesf4Ct6@77Pp3mj-QUD#T^?G!?~GNt
z%YT2QTko5Im@uETgzdzd8=Slz%I1$AMW)20#uvZ#^$K|N=OIx8+81na9lE9fwyyok
zT{J|L^E?2Re{<2vqD1e3a~9?tj-I-u+ObLX_8hi`6~%7s!bdcVS*YStJqPkK0;}7e
z&>es|8y={o3V~h+n{io~GOW|n<6^&Hyjj6uo-TE>_4(>b!#h&Q<h1f|PHk;s46^dB
zK-T)w(D0FgQABnDuwxX@`)fwLc<0il0jM-cwNON`Tb&3u6P@2g1=^eD<-T5+?$fEO
z0UYOQK<%B!R6Q=Jo*t*YWOC(VpSBYqC7B7qpIoRY+X%O}_wuv|0B~mA@$5PpJ*f7+
zb9|Ig@qvD6n39xq+C!h`TN+I|MXPc0T=KAmgE7O6;bFSegC(Z|;G~uG;Oyw{9V(|l
z6FR}%)2g%#!duUETy!Rj9Wih*Ik<2<bgjW0l*Wqcq)8~{b-M3wMK`jza&20@ojq<X
z?@q(+PdrJUV$$_9v=AzPszMo$YA6wPB~3R?T$6WIqkIl!)7ZVZB~xOnVdWKTzc^T-
zUJdTqpZG%gM1R>6tqCc4qy3INm>6Kz<zo+CNPPRASHba_l5zRH)meJv-UY0fNHy*4
zR6S>LIflRXt}*rbgeObfZa4b;2zv5e`_-;eaInLx)6$@z+bauO(@$0z9TJolR#!n5
z#qNF_z8hZJ+?KVTrjvf|t+op%s2oObCf6%r+vO5$4rVyXy0uTR3X^>D;9c4H5g!RF
zxR$Nv^&SYwDk$NBGpxhlbgIw1!}iCbhUG5k*D~oXMto5NlI26Uv!f(DRBIV2^Gt)d
zDJhd<LZ-^5C5s6dP2e4Vc7*n8J2Cahd(F{DJA6+&^@&MN!mq7n9<P0+9X6Y+-qHDp
zPEvI^ZX}<=y1r<ShT~B=r}Be1?^$;y?l0vq5_+PW7ZUWVP*lreOGB`{2OG++Aol%p
zo!f@<Yife$ciepvd@4KpCpy$vK2!DFP&+g;`Q76#juhuyLbK0$DmxF=PBJHhPyBuk
zHR1s?3z3^n#?m<YOS<ADlLO1BKJsXr^>M7!>m6Bz@m}_xWRSi&lK5JUj*5xn{yT~!
znW$wQSpXqR&%O2>a}qiqJi}&DgN?*-X`g71H;?sC-FvPbi>?g}2khis)Hh`L*ge6{
zmYFChMQ|{EWO>lGcvmnRR~$!$UHz;3{}0Y+$f_qr#(jov(zcHF!rB|Vlafh_A2fcw
zqD|Sc4k*Z?{I`Gk>wfa9anu<tUCu?zUeQH8tGHUDhn#fG5^m#)XvIo%0^N$OsKrxK
zFD^f%UTLP{mj5zMC-46&0^q{?KZ@;Hq=GVK8F_gcDpU|pRN*%;Rd!iWP>|`@VBSDh
zt9KCt+ZnMzEe&NnUT9?e!Z?etR>a```L840{7~eXQXO5|K^;4$meFHr@K;24J(nPj
zbk1bP_l)!I781$9wP(ZB+ugZ97%#vu&cY?24J(R@a9OttC+m%j82Dx)G_`WO!kS8%
zR;Hs(71gDZ3AsOlG?-gQyvQUH>lvoz??p(JDTQh4*_j;1F@Ax-US-#6#_ty8YAY%#
zUS<=i*-ZTK;e+7miV<6bor8k`;qv*T%c>v#iN#v&#`*419~Y$FaPkC%?|qBSj-bk}
z9<?_mfBrnRx(c78r8YVA$H&WTNz&9Dm}f6c=d}SsUzfsue*d^zH0Nv9UO${Y$xwd2
z>Oi`F)%+}wgBp|;9v;qh3REDGNK{2J$DJ&O@<0ATH4FbQe#hI5MhbD9ql-eF#=LSO
zKRJ5<4c8=+)4wB<TZwP4x_WW!EFzyOj?lVyN(;)l#ivtAca{>5Mne^-QuO4-`~Lz+
CMaG{1

diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
deleted file mode 100644
index 8bb1ffb1f..000000000
--- a/docs/en/docs/tutorial/request-form-models.md
+++ /dev/null
@@ -1,65 +0,0 @@
-# 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 7c810c2d7..528c80b8e 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -129,7 +129,6 @@ 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
deleted file mode 100644
index 98feff0b9..000000000
--- a/docs_src/request_form_models/tutorial001.py
+++ /dev/null
@@ -1,14 +0,0 @@
-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
deleted file mode 100644
index 30483d445..000000000
--- a/docs_src/request_form_models/tutorial001_an.py
+++ /dev/null
@@ -1,15 +0,0 @@
-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
deleted file mode 100644
index 7cc81aae9..000000000
--- a/docs_src/request_form_models/tutorial001_an_py39.py
+++ /dev/null
@@ -1,16 +0,0 @@
-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 98ce17b55..7ac18d941 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -33,7 +33,6 @@ 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,
@@ -57,7 +56,6 @@ 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
@@ -745,9 +743,7 @@ 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) and not lenient_issubclass(
-        first_field.type_, BaseModel
-    ):
+    if isinstance(first_field.field_info, params.Form):
         return True
     return False
 
@@ -787,8 +783,7 @@ 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)
-        if value is not None:
-            values[field.name] = value
+        values[field.name] = value
     return values
 
 
@@ -803,14 +798,8 @@ 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(fields_to_extract, received_body)
+        body_to_process = await _extract_form_body(body_fields, 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
deleted file mode 100644
index 15bd3858c..000000000
--- a/scripts/playwright/request_form_models/image01.py
+++ /dev/null
@@ -1,36 +0,0 @@
-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
deleted file mode 100644
index 7ed3ba3a2..000000000
--- a/tests/test_forms_single_model.py
+++ /dev/null
@@ -1,129 +0,0 @@
-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
deleted file mode 100644
index e69de29bb..000000000
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001.py b/tests/test_tutorial/test_request_form_models/test_tutorial001.py
deleted file mode 100644
index 46c130ee8..000000000
--- a/tests/test_tutorial/test_request_form_models/test_tutorial001.py
+++ /dev/null
@@ -1,232 +0,0 @@
-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
deleted file mode 100644
index 4e14d89c8..000000000
--- a/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
+++ /dev/null
@@ -1,232 +0,0 @@
-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
deleted file mode 100644
index 2e6426aa7..000000000
--- a/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
+++ /dev/null
@@ -1,240 +0,0 @@
-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"},
-                        }
-                    },
-                },
-            }
-        },
-    }

From b69e8b24af305ddceaa9c63c8d2eebf80672caed Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 14:56:10 +0000
Subject: [PATCH 083/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8fe8be6a7..3c5fbb731 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -15,6 +15,10 @@ hide:
 
 * ♻️ Refactor deciding if `embed` body fields, do not overwrite fields, compute once per router, refactor internals in preparation for Pydantic models in `Form`, `Query` and others. PR [#12117](https://github.com/fastapi/fastapi/pull/12117) by [@tiangolo](https://github.com/tiangolo).
 
+### Internal
+
+* ⏪️ Temporarily revert "✨ Add support for Pydantic models in `Form` parameters" to make a checkpoint release. PR [#12128](https://github.com/fastapi/fastapi/pull/12128) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.112.3
 
 This release is mainly internal refactors, it shouldn't affect apps using FastAPI in any way. You don't even have to upgrade to this version yet. There are a few bigger releases coming right after. 🚀

From 8224addd8f31325ad465af994da8421a69f494ba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 16:57:57 +0200
Subject: [PATCH 084/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3c5fbb731..22a224a5a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,7 +9,7 @@ hide:
 
 ### Features
 
-* ✨ Add support for Pydantic models in `Form` parameters. PR [#12127](https://github.com/fastapi/fastapi/pull/12127) by [@tiangolo](https://github.com/tiangolo).
+## 0.112.4
 
 ### Refactors
 
@@ -18,6 +18,7 @@ hide:
 ### Internal
 
 * ⏪️ Temporarily revert "✨ Add support for Pydantic models in `Form` parameters" to make a checkpoint release. PR [#12128](https://github.com/fastapi/fastapi/pull/12128) by [@tiangolo](https://github.com/tiangolo).
+* ✨ Add support for Pydantic models in `Form` parameters. PR [#12127](https://github.com/fastapi/fastapi/pull/12127) by [@tiangolo](https://github.com/tiangolo). Reverted to make a checkpoint release with only refactors.
 
 ## 0.112.3
 

From 96c7e7e0f34730e6f6333ced9476bfd62f384cfe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:00:13 +0200
Subject: [PATCH 085/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 22a224a5a..43ce86c99 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,10 +7,12 @@ hide:
 
 ## Latest Changes
 
-### Features
-
 ## 0.112.4
 
+This release is mainly a big internal refactor to enable adding support for Pydantic models for `Form` fields, but that feature comes in the next release.
+
+This release shouldn't affect apps using FastAPI in any way. You don't even have to upgrade to this version yet. It's just a checkpoint. 🤓
+
 ### Refactors
 
 * ♻️ Refactor deciding if `embed` body fields, do not overwrite fields, compute once per router, refactor internals in preparation for Pydantic models in `Form`, `Query` and others. PR [#12117](https://github.com/fastapi/fastapi/pull/12117) by [@tiangolo](https://github.com/tiangolo).

From 999eeb6c76ff37f94612dd140ce8091932f56c54 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:00:33 +0200
Subject: [PATCH 086/146] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
 =?UTF-8?q?2.4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 1bc1bfd82..1e10bf557 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.112.3"
+__version__ = "0.112.4"
 
 from starlette import status as status
 

From 965fc8301e8fa7a7228bee33873387f4852a30df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:09:31 +0200
Subject: [PATCH 087/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 43ce86c99..9b44bc9a8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -19,8 +19,8 @@ This release shouldn't affect apps using FastAPI in any way. You don't even have
 
 ### Internal
 
-* ⏪️ Temporarily revert "✨ Add support for Pydantic models in `Form` parameters" to make a checkpoint release. PR [#12128](https://github.com/fastapi/fastapi/pull/12128) by [@tiangolo](https://github.com/tiangolo).
-* ✨ Add support for Pydantic models in `Form` parameters. PR [#12127](https://github.com/fastapi/fastapi/pull/12127) by [@tiangolo](https://github.com/tiangolo). Reverted to make a checkpoint release with only refactors.
+* ⏪️ Temporarily revert "✨ Add support for Pydantic models in `Form` parameters" to make a checkpoint release. PR [#12128](https://github.com/fastapi/fastapi/pull/12128) by [@tiangolo](https://github.com/tiangolo). Restored by PR [#12129](https://github.com/fastapi/fastapi/pull/12129).
+* ✨ Add support for Pydantic models in `Form` parameters. PR [#12127](https://github.com/fastapi/fastapi/pull/12127) by [@tiangolo](https://github.com/tiangolo). Reverted by PR [#12128](https://github.com/fastapi/fastapi/pull/12128) to make a checkpoint release with only refactors. Restored by PR [#12129](https://github.com/fastapi/fastapi/pull/12129).
 
 ## 0.112.3
 

From 7bad7c09757f8a06cf62cc0838082a766065883e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:16:50 +0200
Subject: [PATCH 088/146] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20Pydan?=
 =?UTF-8?q?tic=20models=20in=20`Form`=20parameters=20(#12129)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Revert "⏪️ Temporarily revert "✨ Add support for Pydantic models in `Form` pa…"

This reverts commit 8e6cf9ee9c9d87b6b658cc240146121c80f71476.
---
 .../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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
CMaG{1

literal 0
HcmV?d00001

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 000000000..8bb1ffb1f
--- /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 528c80b8e..7c810c2d7 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 000000000..98feff0b9
--- /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 000000000..30483d445
--- /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 000000000..7cc81aae9
--- /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 7ac18d941..98ce17b55 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 000000000..15bd3858c
--- /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 000000000..7ed3ba3a2
--- /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 000000000..e69de29bb
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 000000000..46c130ee8
--- /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 000000000..4e14d89c8
--- /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 000000000..2e6426aa7
--- /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"},
+                        }
+                    },
+                },
+            }
+        },
+    }

From e787f854ddbe12d08ae6b13298b6d5eda7e20928 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 15:17:13 +0000
Subject: [PATCH 089/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9b44bc9a8..c6cbc7658 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Features
+
+* ✨ Add support for Pydantic models in `Form` parameters. PR [#12129](https://github.com/fastapi/fastapi/pull/12129) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.112.4
 
 This release is mainly a big internal refactor to enable adding support for Pydantic models for `Form` fields, but that feature comes in the next release.

From afdda4e50ba002c951233f5bedcc64068d59d212 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:21:35 +0200
Subject: [PATCH 090/146] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors:=20Coh?=
 =?UTF-8?q?erence=20link=20(#12130)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                        | 2 +-
 docs/en/data/sponsors.yml        | 2 +-
 docs/en/docs/deployment/cloud.md | 2 +-
 docs/en/overrides/main.html      | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 5554f71d4..3b01b713a 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,7 @@ The key features are:
 <a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg"></a>
 <a href="https://github.com/scalar/scalar/?utm_source=fastapi&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Scalar: Beautiful Open-Source API References from Swagger/OpenAPI files"><img src="https://fastapi.tiangolo.com/img/sponsors/scalar.svg"></a>
 <a href="https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge" target="_blank" title="Auth, user management and more for your B2B product"><img src="https://fastapi.tiangolo.com/img/sponsors/propelauth.png"></a>
-<a href="https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs" target="_blank" title="Coherence"><img src="https://fastapi.tiangolo.com/img/sponsors/coherence.png"></a>
+<a href="https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website" target="_blank" title="Coherence"><img src="https://fastapi.tiangolo.com/img/sponsors/coherence.png"></a>
 <a href="https://www.mongodb.com/developer/languages/python/python-quickstart-fastapi/?utm_campaign=fastapi_framework&utm_source=fastapi_sponsorship&utm_medium=web_referral" target="_blank" title="Simplify Full Stack Development with FastAPI & MongoDB"><img src="https://fastapi.tiangolo.com/img/sponsors/mongodb.png"></a>
 <a href="https://zuplo.link/fastapi-gh" target="_blank" title="Zuplo: Scale, Protect, Document, and Monetize your FastAPI"><img src="https://fastapi.tiangolo.com/img/sponsors/zuplo.png"></a>
 <a href="https://fine.dev?ref=fastapibadge" target="_blank" title="Fine's AI FastAPI Workflow: Effortlessly Deploy and Integrate FastAPI into Your Project"><img src="https://fastapi.tiangolo.com/img/sponsors/fine.png"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 3a767b6b1..d96646fb3 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -17,7 +17,7 @@ gold:
   - url: https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge
     title: Auth, user management and more for your B2B product
     img: https://fastapi.tiangolo.com/img/sponsors/propelauth.png
-  - url: https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs
+  - url: https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website
     title: Coherence
     img: https://fastapi.tiangolo.com/img/sponsors/coherence.png
   - url: https://www.mongodb.com/developer/languages/python/python-quickstart-fastapi/?utm_campaign=fastapi_framework&utm_source=fastapi_sponsorship&utm_medium=web_referral
diff --git a/docs/en/docs/deployment/cloud.md b/docs/en/docs/deployment/cloud.md
index 3ea5087f8..41ada859d 100644
--- a/docs/en/docs/deployment/cloud.md
+++ b/docs/en/docs/deployment/cloud.md
@@ -14,4 +14,4 @@ You might want to try their services and follow their guides:
 
 * <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank">Platform.sh</a>
 * <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a>
-* <a href="https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs" class="external-link" target="_blank">Coherence</a>
+* <a href="https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website" class="external-link" target="_blank">Coherence</a>
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 47e46c4bf..463c5af3b 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -59,7 +59,7 @@
       </a>
     </div>
     <div class="item">
-      <a title="Coherence" style="display: block; position: relative;" href="https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs" target="_blank">
+      <a title="Coherence" style="display: block; position: relative;" href="https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website" target="_blank">
         <span class="sponsor-badge">sponsor</span>
         <img class="sponsor-image" src="/img/sponsors/coherence-banner.png" />
       </a>

From 179f838c366b1d9ac74e114949c5c6cfe713ec03 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 15:23:05 +0000
Subject: [PATCH 091/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c6cbc7658..acf53e3de 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
 
 * ✨ Add support for Pydantic models in `Form` parameters. PR [#12129](https://github.com/fastapi/fastapi/pull/12129) by [@tiangolo](https://github.com/tiangolo).
 
+### Internal
+
+* 🔧 Update sponsors: Coherence link. PR [#12130](https://github.com/fastapi/fastapi/pull/12130) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.112.4
 
 This release is mainly a big internal refactor to enable adding support for Pydantic models for `Form` fields, but that feature comes in the next release.

From d86f6603029def91e0798ca42f5fd12eff13c87b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:25:29 +0200
Subject: [PATCH 092/146] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
 =?UTF-8?q?3.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 25 +++++++++++++++++++++++++
 fastapi/__init__.py           |  2 +-
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index acf53e3de..0571523bf 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,31 @@ hide:
 
 ## Latest Changes
 
+## 0.113.0
+
+Now you can declare form fields with Pydantic models:
+
+```python
+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
+```
+
+Read the new docs: [Form Models](https://fastapi.tiangolo.com/tutorial/request-form-models/).
+
 ### Features
 
 * ✨ Add support for Pydantic models in `Form` parameters. PR [#12129](https://github.com/fastapi/fastapi/pull/12129) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 1e10bf557..f785f81cd 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.112.4"
+__version__ = "0.113.0"
 
 from starlette import status as status
 

From c411b81c29f0e8365e0710baf951b4a42039a2e5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 6 Sep 2024 17:57:43 +0200
Subject: [PATCH 093/146] =?UTF-8?q?=E2=9C=85=20Update=20internal=20tests?=
 =?UTF-8?q?=20for=20latest=20Pydantic,=20including=20CI=20tweaks=20to=20in?=
 =?UTF-8?q?stall=20the=20latest=20Pydantic=20(#12147)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/test.yml     |  4 ++--
 tests/test_openapi_examples.py | 27 ++++++++++++++++++++-------
 2 files changed, 22 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index e9db49b51..fb4b083c4 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -37,7 +37,7 @@ jobs:
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
       - name: Install Pydantic v2
-        run: pip install "pydantic>=2.0.2,<3.0.0"
+        run: pip install --upgrade "pydantic>=2.0.2,<3.0.0"
       - name: Lint
         run: bash scripts/lint.sh
 
@@ -79,7 +79,7 @@ jobs:
         run: pip install "pydantic>=1.10.0,<2.0.0"
       - name: Install Pydantic v2
         if: matrix.pydantic-version == 'pydantic-v2'
-        run: pip install "pydantic>=2.0.2,<3.0.0"
+        run: pip install --upgrade "pydantic>=2.0.2,<3.0.0"
       - run: mkdir coverage
       - name: Test
         run: bash scripts/test.sh
diff --git a/tests/test_openapi_examples.py b/tests/test_openapi_examples.py
index 6597e5058..b3f83ae23 100644
--- a/tests/test_openapi_examples.py
+++ b/tests/test_openapi_examples.py
@@ -155,13 +155,26 @@ def test_openapi_schema():
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {
-                                    "allOf": [{"$ref": "#/components/schemas/Item"}],
-                                    "title": "Item",
-                                    "examples": [
-                                        {"data": "Data in Body examples, example1"}
-                                    ],
-                                },
+                                "schema": IsDict(
+                                    {
+                                        "$ref": "#/components/schemas/Item",
+                                        "examples": [
+                                            {"data": "Data in Body examples, example1"}
+                                        ],
+                                    }
+                                )
+                                | IsDict(
+                                    {
+                                        # TODO: remove when deprecating Pydantic v1
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                        "examples": [
+                                            {"data": "Data in Body examples, example1"}
+                                        ],
+                                    }
+                                ),
                                 "examples": {
                                     "Example One": {
                                         "summary": "Example One Summary",

From 1b06b532677c91006efe01e4bd09b5d91f5df261 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 6 Sep 2024 15:58:05 +0000
Subject: [PATCH 094/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0571523bf..2b9bd3e87 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Internal
+
+* ✅ Update internal tests for latest Pydantic, including CI tweaks to install the latest Pydantic. PR [#12147](https://github.com/fastapi/fastapi/pull/12147) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.113.0
 
 Now you can declare form fields with Pydantic models:

From 4633b1bca933e68dac5c3bcce797ff5963debe2a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 6 Sep 2024 19:31:18 +0200
Subject: [PATCH 095/146] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20forbi?=
 =?UTF-8?q?dding=20extra=20form=20fields=20with=20Pydantic=20models=20(#12?=
 =?UTF-8?q?134)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
---
 docs/en/docs/tutorial/request-form-models.md  |  75 ++++++-
 docs_src/request_form_models/tutorial002.py   |  15 ++
 .../request_form_models/tutorial002_an.py     |  16 ++
 .../tutorial002_an_py39.py                    |  17 ++
 .../request_form_models/tutorial002_pv1.py    |  17 ++
 .../request_form_models/tutorial002_pv1_an.py |  18 ++
 .../tutorial002_pv1_an_py39.py                |  19 ++
 fastapi/dependencies/utils.py                 |   3 +
 .../test_tutorial002.py                       | 196 +++++++++++++++++
 .../test_tutorial002_an.py                    | 196 +++++++++++++++++
 .../test_tutorial002_an_py39.py               | 203 ++++++++++++++++++
 .../test_tutorial002_pv1.py                   | 189 ++++++++++++++++
 .../test_tutorial002_pv1_an.py                | 196 +++++++++++++++++
 .../test_tutorial002_pv1_an_p39.py            | 203 ++++++++++++++++++
 14 files changed, 1360 insertions(+), 3 deletions(-)
 create mode 100644 docs_src/request_form_models/tutorial002.py
 create mode 100644 docs_src/request_form_models/tutorial002_an.py
 create mode 100644 docs_src/request_form_models/tutorial002_an_py39.py
 create mode 100644 docs_src/request_form_models/tutorial002_pv1.py
 create mode 100644 docs_src/request_form_models/tutorial002_pv1_an.py
 create mode 100644 docs_src/request_form_models/tutorial002_pv1_an_py39.py
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002.py
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002_an.py
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002_an_py39.py
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002_pv1.py
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an.py
 create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an_p39.py

diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
index 8bb1ffb1f..a317ee14d 100644
--- a/docs/en/docs/tutorial/request-form-models.md
+++ b/docs/en/docs/tutorial/request-form-models.md
@@ -1,6 +1,6 @@
 # Form Models
 
-You can use Pydantic models to declare form fields in FastAPI.
+You can use **Pydantic models** to declare **form fields** in FastAPI.
 
 /// info
 
@@ -22,7 +22,7 @@ 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`:
+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+
 
@@ -54,7 +54,7 @@ Prefer to use the `Annotated` version if possible.
 
 ////
 
-FastAPI will extract the data for each field from the form data in the request and give you the Pydantic model you defined.
+**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
 
@@ -63,3 +63,72 @@ You can verify it in the docs UI at `/docs`:
 <div class="screenshot">
 <img src="/img/tutorial/request-form-models/image01.png">
 </div>
+
+## Restrict Extra Form Fields
+
+In some special use cases (probably not very common), you might want to **restrict** the form fields to only those declared in the Pydantic model. And **forbid** any **extra** fields.
+
+/// note
+
+This is supported since FastAPI version `0.114.0`. 🤓
+
+///
+
+You can use Pydantic's model configuration to `forbid` any `extra` fields:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="12"
+{!> ../../../docs_src/request_form_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/request_form_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/request_form_models/tutorial002.py!}
+```
+
+////
+
+If a client tries to send some extra data, they will receive an **error** response.
+
+For example, if the client tries to send the form fields:
+
+* `username`: `Rick`
+* `password`: `Portal Gun`
+* `extra`: `Mr. Poopybutthole`
+
+They will receive an error response telling them that the field `extra` is not allowed:
+
+```json
+{
+    "detail": [
+        {
+            "type": "extra_forbidden",
+            "loc": ["body", "extra"],
+            "msg": "Extra inputs are not permitted",
+            "input": "Mr. Poopybutthole"
+        }
+    ]
+}
+```
+
+## Summary
+
+You can use Pydantic models to declare form fields in FastAPI. 😎
diff --git a/docs_src/request_form_models/tutorial002.py b/docs_src/request_form_models/tutorial002.py
new file mode 100644
index 000000000..59b329e8d
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002.py
@@ -0,0 +1,15 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+    username: str
+    password: str
+    model_config = {"extra": "forbid"}
+
+
+@app.post("/login/")
+async def login(data: FormData = Form()):
+    return data
diff --git a/docs_src/request_form_models/tutorial002_an.py b/docs_src/request_form_models/tutorial002_an.py
new file mode 100644
index 000000000..bcb022795
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002_an.py
@@ -0,0 +1,16 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+    username: str
+    password: str
+    model_config = {"extra": "forbid"}
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+    return data
diff --git a/docs_src/request_form_models/tutorial002_an_py39.py b/docs_src/request_form_models/tutorial002_an_py39.py
new file mode 100644
index 000000000..3004e0852
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002_an_py39.py
@@ -0,0 +1,17 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+    username: str
+    password: str
+    model_config = {"extra": "forbid"}
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+    return data
diff --git a/docs_src/request_form_models/tutorial002_pv1.py b/docs_src/request_form_models/tutorial002_pv1.py
new file mode 100644
index 000000000..d5f7db2a6
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002_pv1.py
@@ -0,0 +1,17 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+    username: str
+    password: str
+
+    class Config:
+        extra = "forbid"
+
+
+@app.post("/login/")
+async def login(data: FormData = Form()):
+    return data
diff --git a/docs_src/request_form_models/tutorial002_pv1_an.py b/docs_src/request_form_models/tutorial002_pv1_an.py
new file mode 100644
index 000000000..fe9dbc344
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002_pv1_an.py
@@ -0,0 +1,18 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+    username: str
+    password: str
+
+    class Config:
+        extra = "forbid"
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+    return data
diff --git a/docs_src/request_form_models/tutorial002_pv1_an_py39.py b/docs_src/request_form_models/tutorial002_pv1_an_py39.py
new file mode 100644
index 000000000..942d5d411
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002_pv1_an_py39.py
@@ -0,0 +1,19 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+    username: str
+    password: str
+
+    class Config:
+        extra = "forbid"
+
+
+@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 98ce17b55..6083b7319 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -789,6 +789,9 @@ async def _extract_form_body(
             value = serialize_sequence_value(field=field, value=results)
         if value is not None:
             values[field.name] = value
+    for key, value in received_body.items():
+        if key not in values:
+            values[key] = value
     return values
 
 
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial002.py b/tests/test_tutorial/test_request_form_models/test_tutorial002.py
new file mode 100644
index 000000000..76f480001
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002.py
@@ -0,0 +1,196 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.request_form_models.tutorial002 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_pydanticv2
+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_pydanticv2
+def test_post_body_extra_form(client: TestClient):
+    response = client.post(
+        "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+    )
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "extra_forbidden",
+                "loc": ["body", "extra"],
+                "msg": "Extra inputs are not permitted",
+                "input": "extra",
+            }
+        ]
+    }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_password(client: TestClient):
+    response = client.post("/login/", data={"username": "Foo"})
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "password"],
+                "msg": "Field required",
+                "input": {"username": "Foo"},
+            }
+        ]
+    }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_username(client: TestClient):
+    response = client.post("/login/", data={"password": "secret"})
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "username"],
+                "msg": "Field required",
+                "input": {"password": "secret"},
+            }
+        ]
+    }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_data(client: TestClient):
+    response = client.post("/login/")
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "username"],
+                "msg": "Field required",
+                "input": {},
+            },
+            {
+                "type": "missing",
+                "loc": ["body", "password"],
+                "msg": "Field required",
+                "input": {},
+            },
+        ]
+    }
+
+
+@needs_pydanticv2
+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() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "username"],
+                "msg": "Field required",
+                "input": {},
+            },
+            {
+                "type": "missing",
+                "loc": ["body", "password"],
+                "msg": "Field required",
+                "input": {},
+            },
+        ]
+    }
+
+
+@needs_pydanticv2
+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"},
+                    },
+                    "additionalProperties": False,
+                    "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_tutorial002_an.py b/tests/test_tutorial/test_request_form_models/test_tutorial002_an.py
new file mode 100644
index 000000000..179b2977d
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002_an.py
@@ -0,0 +1,196 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.request_form_models.tutorial002_an import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_pydanticv2
+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_pydanticv2
+def test_post_body_extra_form(client: TestClient):
+    response = client.post(
+        "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+    )
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "extra_forbidden",
+                "loc": ["body", "extra"],
+                "msg": "Extra inputs are not permitted",
+                "input": "extra",
+            }
+        ]
+    }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_password(client: TestClient):
+    response = client.post("/login/", data={"username": "Foo"})
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "password"],
+                "msg": "Field required",
+                "input": {"username": "Foo"},
+            }
+        ]
+    }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_username(client: TestClient):
+    response = client.post("/login/", data={"password": "secret"})
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "username"],
+                "msg": "Field required",
+                "input": {"password": "secret"},
+            }
+        ]
+    }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_data(client: TestClient):
+    response = client.post("/login/")
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "username"],
+                "msg": "Field required",
+                "input": {},
+            },
+            {
+                "type": "missing",
+                "loc": ["body", "password"],
+                "msg": "Field required",
+                "input": {},
+            },
+        ]
+    }
+
+
+@needs_pydanticv2
+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() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "username"],
+                "msg": "Field required",
+                "input": {},
+            },
+            {
+                "type": "missing",
+                "loc": ["body", "password"],
+                "msg": "Field required",
+                "input": {},
+            },
+        ]
+    }
+
+
+@needs_pydanticv2
+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"},
+                    },
+                    "additionalProperties": False,
+                    "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_tutorial002_an_py39.py b/tests/test_tutorial/test_request_form_models/test_tutorial002_an_py39.py
new file mode 100644
index 000000000..510ad9d7c
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002_an_py39.py
@@ -0,0 +1,203 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_py39, needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.request_form_models.tutorial002_an_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_pydanticv2
+@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_pydanticv2
+@needs_py39
+def test_post_body_extra_form(client: TestClient):
+    response = client.post(
+        "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+    )
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "extra_forbidden",
+                "loc": ["body", "extra"],
+                "msg": "Extra inputs are not permitted",
+                "input": "extra",
+            }
+        ]
+    }
+
+
+@needs_pydanticv2
+@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() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "password"],
+                "msg": "Field required",
+                "input": {"username": "Foo"},
+            }
+        ]
+    }
+
+
+@needs_pydanticv2
+@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() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "username"],
+                "msg": "Field required",
+                "input": {"password": "secret"},
+            }
+        ]
+    }
+
+
+@needs_pydanticv2
+@needs_py39
+def test_post_body_form_no_data(client: TestClient):
+    response = client.post("/login/")
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "username"],
+                "msg": "Field required",
+                "input": {},
+            },
+            {
+                "type": "missing",
+                "loc": ["body", "password"],
+                "msg": "Field required",
+                "input": {},
+            },
+        ]
+    }
+
+
+@needs_pydanticv2
+@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() == {
+        "detail": [
+            {
+                "type": "missing",
+                "loc": ["body", "username"],
+                "msg": "Field required",
+                "input": {},
+            },
+            {
+                "type": "missing",
+                "loc": ["body", "password"],
+                "msg": "Field required",
+                "input": {},
+            },
+        ]
+    }
+
+
+@needs_pydanticv2
+@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"},
+                    },
+                    "additionalProperties": False,
+                    "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_tutorial002_pv1.py b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1.py
new file mode 100644
index 000000000..249b9379d
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1.py
@@ -0,0 +1,189 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_pydanticv1
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.request_form_models.tutorial002_pv1 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_pydanticv1
+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_pydanticv1
+def test_post_body_extra_form(client: TestClient):
+    response = client.post(
+        "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+    )
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "value_error.extra",
+                "loc": ["body", "extra"],
+                "msg": "extra fields not permitted",
+            }
+        ]
+    }
+
+
+@needs_pydanticv1
+def test_post_body_form_no_password(client: TestClient):
+    response = client.post("/login/", data={"username": "Foo"})
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "password"],
+                "msg": "field required",
+            }
+        ]
+    }
+
+
+@needs_pydanticv1
+def test_post_body_form_no_username(client: TestClient):
+    response = client.post("/login/", data={"password": "secret"})
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "username"],
+                "msg": "field required",
+            }
+        ]
+    }
+
+
+@needs_pydanticv1
+def test_post_body_form_no_data(client: TestClient):
+    response = client.post("/login/")
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "username"],
+                "msg": "field required",
+            },
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "password"],
+                "msg": "field required",
+            },
+        ]
+    }
+
+
+@needs_pydanticv1
+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() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "username"],
+                "msg": "field required",
+            },
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "password"],
+                "msg": "field required",
+            },
+        ]
+    }
+
+
+@needs_pydanticv1
+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"},
+                    },
+                    "additionalProperties": False,
+                    "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_tutorial002_pv1_an.py b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an.py
new file mode 100644
index 000000000..44cb3c32b
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an.py
@@ -0,0 +1,196 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_pydanticv1
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.request_form_models.tutorial002_pv1_an import app
+
+    client = TestClient(app)
+    return client
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+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"}
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_post_body_extra_form(client: TestClient):
+    response = client.post(
+        "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+    )
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "value_error.extra",
+                "loc": ["body", "extra"],
+                "msg": "extra fields not permitted",
+            }
+        ]
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_post_body_form_no_password(client: TestClient):
+    response = client.post("/login/", data={"username": "Foo"})
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "password"],
+                "msg": "field required",
+            }
+        ]
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_post_body_form_no_username(client: TestClient):
+    response = client.post("/login/", data={"password": "secret"})
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "username"],
+                "msg": "field required",
+            }
+        ]
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_post_body_form_no_data(client: TestClient):
+    response = client.post("/login/")
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "username"],
+                "msg": "field required",
+            },
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "password"],
+                "msg": "field required",
+            },
+        ]
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+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() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "username"],
+                "msg": "field required",
+            },
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "password"],
+                "msg": "field required",
+            },
+        ]
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+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"},
+                    },
+                    "additionalProperties": False,
+                    "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_tutorial002_pv1_an_p39.py b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an_p39.py
new file mode 100644
index 000000000..899549e40
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an_p39.py
@@ -0,0 +1,203 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_py39, needs_pydanticv1
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.request_form_models.tutorial002_pv1_an_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@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"}
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@needs_py39
+def test_post_body_extra_form(client: TestClient):
+    response = client.post(
+        "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+    )
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "value_error.extra",
+                "loc": ["body", "extra"],
+                "msg": "extra fields not permitted",
+            }
+        ]
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@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() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "password"],
+                "msg": "field required",
+            }
+        ]
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@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() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "username"],
+                "msg": "field required",
+            }
+        ]
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@needs_py39
+def test_post_body_form_no_data(client: TestClient):
+    response = client.post("/login/")
+    assert response.status_code == 422
+    assert response.json() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "username"],
+                "msg": "field required",
+            },
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "password"],
+                "msg": "field required",
+            },
+        ]
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@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() == {
+        "detail": [
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "username"],
+                "msg": "field required",
+            },
+            {
+                "type": "value_error.missing",
+                "loc": ["body", "password"],
+                "msg": "field required",
+            },
+        ]
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@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"},
+                    },
+                    "additionalProperties": False,
+                    "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"},
+                        }
+                    },
+                },
+            }
+        },
+    }

From a11e392f5f0ae8b50f92252f811764d48929466f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 6 Sep 2024 17:31:44 +0000
Subject: [PATCH 096/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2b9bd3e87..7f4353cfe 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Features
+
+* ✨ Add support for forbidding extra form fields with Pydantic models. PR [#12134](https://github.com/fastapi/fastapi/pull/12134) by [@tiangolo](https://github.com/tiangolo).
+
 ### Internal
 
 * ✅ Update internal tests for latest Pydantic, including CI tweaks to install the latest Pydantic. PR [#12147](https://github.com/fastapi/fastapi/pull/12147) by [@tiangolo](https://github.com/tiangolo).

From 4ff22a0c4167e5fe5dc039b29531329398d67ad5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 6 Sep 2024 19:38:23 +0200
Subject: [PATCH 097/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20docs,=20Form=20?=
 =?UTF-8?q?Models=20section=20title,=20to=20match=20config=20name=20(#1215?=
 =?UTF-8?q?2)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/tutorial/request-form-models.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
index a317ee14d..1440d17b8 100644
--- a/docs/en/docs/tutorial/request-form-models.md
+++ b/docs/en/docs/tutorial/request-form-models.md
@@ -64,7 +64,7 @@ You can verify it in the docs UI at `/docs`:
 <img src="/img/tutorial/request-form-models/image01.png">
 </div>
 
-## Restrict Extra Form Fields
+## Forbid Extra Form Fields
 
 In some special use cases (probably not very common), you might want to **restrict** the form fields to only those declared in the Pydantic model. And **forbid** any **extra** fields.
 

From e68d8c60fbe22609b6e3c3a652474088eeba18e6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 6 Sep 2024 17:38:50 +0000
Subject: [PATCH 098/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7f4353cfe..b7db0f780 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
 
 * ✨ Add support for forbidding extra form fields with Pydantic models. PR [#12134](https://github.com/fastapi/fastapi/pull/12134) by [@tiangolo](https://github.com/tiangolo).
 
+### Docs
+
+* 📝 Update docs, Form Models section title, to match config name. PR [#12152](https://github.com/fastapi/fastapi/pull/12152) by [@tiangolo](https://github.com/tiangolo).
+
 ### Internal
 
 * ✅ Update internal tests for latest Pydantic, including CI tweaks to install the latest Pydantic. PR [#12147](https://github.com/fastapi/fastapi/pull/12147) by [@tiangolo](https://github.com/tiangolo).

From 74842f0a604f9e90e6ffb71c352186389060b1b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 6 Sep 2024 19:40:27 +0200
Subject: [PATCH 099/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b7db0f780..94f494375 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,30 @@ hide:
 
 ## Latest Changes
 
+You can restrict form fields to only include those declared in a Pydantic model and forbid any extra field sent in the request using Pydantic's `model_config = {"extra": "forbid"}`:
+
+```python
+from typing import Annotated
+
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+    username: str
+    password: str
+    model_config = {"extra": "forbid"}
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+    return data
+```
+
+Read the new docs: [Form Models - Forbid Extra Form Fields](https://fastapi.tiangolo.com/tutorial/request-form-models/#forbid-extra-form-fields).
+
 ### Features
 
 * ✨ Add support for forbidding extra form fields with Pydantic models. PR [#12134](https://github.com/fastapi/fastapi/pull/12134) by [@tiangolo](https://github.com/tiangolo).

From bde12faea20313e4570f7cb896c201058c26e546 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 6 Sep 2024 19:41:13 +0200
Subject: [PATCH 100/146] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
 =?UTF-8?q?4.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 fastapi/__init__.py           | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 94f494375..557498278 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.114.0
+
 You can restrict form fields to only include those declared in a Pydantic model and forbid any extra field sent in the request using Pydantic's `model_config = {"extra": "forbid"}`:
 
 ```python
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index f785f81cd..dce17360f 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.113.0"
+__version__ = "0.114.0"
 
 from starlette import status as status
 

From b60d36e7533e0ae299cdff0d72b078d1f036ac67 Mon Sep 17 00:00:00 2001
From: Vaibhav <35167042+surreal30@users.noreply.github.com>
Date: Fri, 6 Sep 2024 23:36:20 +0530
Subject: [PATCH 101/146] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
 =?UTF-8?q?`fastapi/params.py`=20(#12143)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/params.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/fastapi/params.py b/fastapi/params.py
index 3dfa5a1a3..90ca7cb01 100644
--- a/fastapi/params.py
+++ b/fastapi/params.py
@@ -556,7 +556,7 @@ class Body(FieldInfo):
             kwargs["examples"] = examples
         if regex is not None:
             warnings.warn(
-                "`regex` has been depreacated, please use `pattern` instead",
+                "`regex` has been deprecated, please use `pattern` instead",
                 category=DeprecationWarning,
                 stacklevel=4,
             )

From 4b9e5b3a7433f13dcb1ca6d284326b1753231af2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 6 Sep 2024 18:06:45 +0000
Subject: [PATCH 102/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 557498278..23bb2d9d1 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Internal
+
+* ✏️ Fix typo in `fastapi/params.py`. PR [#12143](https://github.com/fastapi/fastapi/pull/12143) by [@surreal30](https://github.com/surreal30).
+
 ## 0.114.0
 
 You can restrict form fields to only include those declared in a Pydantic model and forbid any extra field sent in the request using Pydantic's `model_config = {"extra": "forbid"}`:

From edb584199f3341b205da5d7e1686c54d8719b82d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 7 Sep 2024 17:21:14 +0200
Subject: [PATCH 103/146] =?UTF-8?q?=F0=9F=91=B7=20Update=20`issue-manager.?=
 =?UTF-8?q?yml`=20(#12159)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/issue-manager.yml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/issue-manager.yml b/.github/workflows/issue-manager.yml
index d5b947a9c..fbb856792 100644
--- a/.github/workflows/issue-manager.yml
+++ b/.github/workflows/issue-manager.yml
@@ -2,7 +2,7 @@ name: Issue Manager
 
 on:
   schedule:
-    - cron: "10 3 * * *"
+    - cron: "13 22 * * *"
   issue_comment:
     types:
       - created
@@ -16,6 +16,7 @@ on:
 
 permissions:
   issues: write
+  pull-requests: write
 
 jobs:
   issue-manager:
@@ -35,8 +36,8 @@ jobs:
                 "delay": 864000,
                 "message": "Assuming the original need was handled, this will be automatically closed now. But feel free to add more comments or create new issues or PRs."
               },
-              "changes-requested": {
+              "waiting": {
                 "delay": 2628000,
-                "message": "As this PR had requested changes to be applied but has been inactive for a while, it's now going to be closed. But if there's anyone interested, feel free to create a new PR."
+                "message": "As this PR has been waiting for the original user for a while but seems to be inactive, it's now going to be closed. But if there's anyone interested, feel free to create a new PR."
               }
             }

From b501fc6dafbef19a9d17b8484469ca81426c8e9d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 7 Sep 2024 15:24:06 +0000
Subject: [PATCH 104/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 23bb2d9d1..16bd6e526 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Internal
 
+* 👷 Update `issue-manager.yml`. PR [#12159](https://github.com/fastapi/fastapi/pull/12159) by [@tiangolo](https://github.com/tiangolo).
 * ✏️ Fix typo in `fastapi/params.py`. PR [#12143](https://github.com/fastapi/fastapi/pull/12143) by [@surreal30](https://github.com/surreal30).
 
 ## 0.114.0

From ec2a50829202ab98f166f581053d82b74d3f1130 Mon Sep 17 00:00:00 2001
From: BORA <88664069+BORA040126@users.noreply.github.com>
Date: Sun, 8 Sep 2024 08:35:43 +0900
Subject: [PATCH 105/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
 =?UTF-8?q?on=20for=20`docs/ko/docs/project-generation.md`=20(#12157)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ko/docs/project-generation.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 docs/ko/docs/project-generation.md

diff --git a/docs/ko/docs/project-generation.md b/docs/ko/docs/project-generation.md
new file mode 100644
index 000000000..019919f77
--- /dev/null
+++ b/docs/ko/docs/project-generation.md
@@ -0,0 +1,28 @@
+# Full Stack FastAPI 템플릿
+
+템플릿은 일반적으로 특정 설정과 함께 제공되지만, 유연하고 커스터마이징이 가능하게 디자인 되었습니다. 이 특성들은 여러분이 프로젝트의 요구사항에 맞춰 수정, 적용을 할 수 있게 해주고, 템플릿이 완벽한 시작점이 되게 해줍니다. 🏁
+
+많은 초기 설정, 보안, 데이터베이스 및 일부 API 엔드포인트가 이미 준비되어 있으므로, 여러분은 이 템플릿을 (프로젝트를) 시작하는 데 사용할 수 있습니다.
+
+GitHub 저장소: <a href="https://github.com/tiangolo/full-stack-fastapi-template" class="external-link" target="_blank">Full Stack FastAPI 템플릿</a>
+
+## Full Stack FastAPI 템플릿 - 기술 스택과 기능들
+
+- ⚡ [**FastAPI**](https://fastapi.tiangolo.com): Python 백엔드 API.
+    - 🧰 [SQLModel](https://sqlmodel.tiangolo.com): Python SQL 데이터 상호작용을 위한 (ORM).
+    - 🔍 [Pydantic](https://docs.pydantic.dev): FastAPI에 의해 사용되는, 데이터 검증과 설정관리.
+    - 💾 [PostgreSQL](https://www.postgresql.org): SQL 데이터베이스.
+- 🚀 [React](https://react.dev): 프론트엔드.
+    - 💃 TypeScript, hooks, Vite 및 기타 현대적인 프론트엔드 스택을 사용.
+    - 🎨 [Chakra UI](https://chakra-ui.com): 프론트엔드 컴포넌트.
+    - 🤖 자동으로 생성된 프론트엔드 클라이언트.
+    - 🧪 E2E 테스트를 위한 Playwright.
+    - 🦇 다크 모드 지원.
+- 🐋 [Docker Compose](https://www.docker.com): 개발 환경과 프로덕션(운영).
+- 🔒 기본으로 지원되는 안전한 비밀번호 해싱.
+- 🔑 JWT 토큰 인증.
+- 📫 이메일 기반 비밀번호 복구.
+- ✅ [Pytest]를 이용한 테스트(https://pytest.org).
+- 📞 [Traefik](https://traefik.io): 리버스 프록시 / 로드 밸런서.
+- 🚢 Docker Compose를 이용한 배포 지침: 자동 HTTPS 인증서를 처리하기 위한 프론트엔드 Traefik 프록시 설정 방법을 포함.
+- 🏭 GitHub Actions를 기반으로 CI (지속적인 통합) 및 CD (지속적인 배포).

From 3a4431b6feb50a86a60ce034580cf9fbacee9d32 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 7 Sep 2024 23:36:05 +0000
Subject: [PATCH 106/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 16bd6e526..e09eb57b6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Translations
+
+* 🌐 Add Korean translation for `docs/ko/docs/project-generation.md`. PR [#12157](https://github.com/fastapi/fastapi/pull/12157) by [@BORA040126](https://github.com/BORA040126).
+
 ### Internal
 
 * 👷 Update `issue-manager.yml`. PR [#12159](https://github.com/fastapi/fastapi/pull/12159) by [@tiangolo](https://github.com/tiangolo).

From 270aef71c47694ca349afeba95d13ade195185d2 Mon Sep 17 00:00:00 2001
From: Guillaume Fassot <97948781+prometek@users.noreply.github.com>
Date: Sun, 8 Sep 2024 22:36:53 +0200
Subject: [PATCH 107/146] =?UTF-8?q?=F0=9F=93=9D=20Remove=20duplicate=20lin?=
 =?UTF-8?q?e=20in=20docs=20for=20`docs/en/docs/environment-variables.md`?=
 =?UTF-8?q?=20(#12169)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/environment-variables.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/docs/en/docs/environment-variables.md b/docs/en/docs/environment-variables.md
index 78e82d5af..43dd06add 100644
--- a/docs/en/docs/environment-variables.md
+++ b/docs/en/docs/environment-variables.md
@@ -243,8 +243,6 @@ This way, when you type `python` in the terminal, the system will find the Pytho
 
 ////
 
-This way, when you type `python` in the terminal, the system will find the Python program in `/opt/custompython/bin` (the last directory) and use that one.
-
 So, if you type:
 
 <div class="termy">

From c49c4e7df8eef1ab4ed5baacdf02df3a10aaaae1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 8 Sep 2024 20:37:14 +0000
Subject: [PATCH 108/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e09eb57b6..6e84911e9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Docs
+
+* 📝 Remove duplicate line in docs for `docs/en/docs/environment-variables.md`. PR [#12169](https://github.com/fastapi/fastapi/pull/12169) by [@prometek](https://github.com/prometek).
+
 ### Translations
 
 * 🌐 Add Korean translation for `docs/ko/docs/project-generation.md`. PR [#12157](https://github.com/fastapi/fastapi/pull/12157) by [@BORA040126](https://github.com/BORA040126).

From a67167dce3f3b33ef1789c0eeb7a2dcdf2cc4314 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 9 Sep 2024 20:35:50 +0200
Subject: [PATCH 109/146] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
 =?UTF-8?q?t=20autoupdate=20(#12176)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* ⬆ [pre-commit.ci] pre-commit autoupdate

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.3 → v0.6.4](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.3...v0.6.4)

* bump ruff in tests requirements as well

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: svlandeg <svlandeg@github.com>
---
 .pre-commit-config.yaml | 2 +-
 requirements-tests.txt  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 7e58afd4b..f74816f12 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -14,7 +14,7 @@ repos:
     -   id: end-of-file-fixer
     -   id: trailing-whitespace
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.3
+    rev: v0.6.4
     hooks:
     -   id: ruff
         args:
diff --git a/requirements-tests.txt b/requirements-tests.txt
index de5fdb8a2..809a19c0c 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -3,7 +3,7 @@
 pytest >=7.1.3,<8.0.0
 coverage[toml] >= 6.5.0,< 8.0
 mypy ==1.8.0
-ruff ==0.6.3
+ruff ==0.6.4
 dirty-equals ==0.6.0
 # TODO: once removing databases from tutorial, upgrade SQLAlchemy
 # probably when including SQLModel

From da4670cf775ff7c2ef98b7157a71a91fe980816e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 9 Sep 2024 18:36:15 +0000
Subject: [PATCH 110/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6e84911e9..3af1a5ade 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -17,6 +17,7 @@ hide:
 
 ### Internal
 
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12176](https://github.com/fastapi/fastapi/pull/12176) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
 * 👷 Update `issue-manager.yml`. PR [#12159](https://github.com/fastapi/fastapi/pull/12159) by [@tiangolo](https://github.com/tiangolo).
 * ✏️ Fix typo in `fastapi/params.py`. PR [#12143](https://github.com/fastapi/fastapi/pull/12143) by [@surreal30](https://github.com/surreal30).
 

From fc601bcb4b2dd97e3c7918c8f59f97a62df06abc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 10 Sep 2024 11:07:46 +0200
Subject: [PATCH 111/146] =?UTF-8?q?=E2=AC=86=20Bump=20tiangolo/issue-manag?=
 =?UTF-8?q?er=20from=200.5.0=20to=200.5.1=20(#12173)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [tiangolo/issue-manager](https://github.com/tiangolo/issue-manager) from 0.5.0 to 0.5.1.
- [Release notes](https://github.com/tiangolo/issue-manager/releases)
- [Commits](https://github.com/tiangolo/issue-manager/compare/0.5.0...0.5.1)

---
updated-dependencies:
- dependency-name: tiangolo/issue-manager
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/issue-manager.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/issue-manager.yml b/.github/workflows/issue-manager.yml
index fbb856792..439084434 100644
--- a/.github/workflows/issue-manager.yml
+++ b/.github/workflows/issue-manager.yml
@@ -27,7 +27,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: tiangolo/issue-manager@0.5.0
+      - uses: tiangolo/issue-manager@0.5.1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           config: >

From bc715d55bc1ee3aedf4d429ca4e08ae39e0bbb90 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 10 Sep 2024 09:08:09 +0000
Subject: [PATCH 112/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3af1a5ade..b9eaed65d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -17,6 +17,7 @@ hide:
 
 ### Internal
 
+* ⬆ Bump tiangolo/issue-manager from 0.5.0 to 0.5.1. PR [#12173](https://github.com/fastapi/fastapi/pull/12173) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12176](https://github.com/fastapi/fastapi/pull/12176) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
 * 👷 Update `issue-manager.yml`. PR [#12159](https://github.com/fastapi/fastapi/pull/12159) by [@tiangolo](https://github.com/tiangolo).
 * ✏️ Fix typo in `fastapi/params.py`. PR [#12143](https://github.com/fastapi/fastapi/pull/12143) by [@surreal30](https://github.com/surreal30).

From 80e2cd12747df2de38b4ab3ee1ee1cb889ee242b Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Tue, 10 Sep 2024 07:34:25 -0300
Subject: [PATCH 113/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/debugging.md`=20(#12165)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/pt/docs/tutorial/debugging.md | 115 +++++++++++++++++++++++++++++
 1 file changed, 115 insertions(+)
 create mode 100644 docs/pt/docs/tutorial/debugging.md

diff --git a/docs/pt/docs/tutorial/debugging.md b/docs/pt/docs/tutorial/debugging.md
new file mode 100644
index 000000000..54582fcbc
--- /dev/null
+++ b/docs/pt/docs/tutorial/debugging.md
@@ -0,0 +1,115 @@
+# Depuração
+
+Você pode conectar o depurador no seu editor, por exemplo, com o Visual Studio Code ou PyCharm.
+
+## Chamar `uvicorn`
+
+Em seu aplicativo FastAPI, importe e execute `uvicorn` diretamente:
+
+```Python hl_lines="1  15"
+{!../../../docs_src/debugging/tutorial001.py!}
+```
+
+### Sobre `__name__ == "__main__"`
+
+O objetivo principal de `__name__ == "__main__"` é ter algum código que seja executado quando seu arquivo for chamado com:
+
+<div class="termy">
+
+```console
+$ python myapp.py
+```
+
+</div>
+
+mas não é chamado quando outro arquivo o importa, como em:
+
+```Python
+from myapp import app
+```
+
+#### Mais detalhes
+
+Digamos que seu arquivo se chama `myapp.py`.
+
+Se você executá-lo com:
+
+<div class="termy">
+
+```console
+$ python myapp.py
+```
+
+</div>
+
+então a variável interna `__name__` no seu arquivo, criada automaticamente pelo Python, terá como valor a string `"__main__"`.
+
+Então, a seção:
+
+```Python
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+vai executar.
+
+---
+
+Isso não acontecerá se você importar esse módulo (arquivo).
+
+Então, se você tiver outro arquivo `importer.py` com:
+
+```Python
+from myapp import app
+
+# Mais um pouco de código
+```
+
+nesse caso, a variável criada automaticamente dentro de `myapp.py` não terá a variável `__name__` com o valor `"__main__"`.
+
+Então, a linha:
+
+```Python
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+não será executada.
+
+/// info | "Informação"
+
+Para mais informações, consulte <a href="https://docs.python.org/3/library/__main__.html" class="external-link" target="_blank">a documentação oficial do Python</a>.
+
+///
+
+## Execute seu código com seu depurador
+
+Como você está executando o servidor Uvicorn diretamente do seu código, você pode chamar seu programa Python (seu aplicativo FastAPI) diretamente do depurador.
+
+---
+
+Por exemplo, no Visual Studio Code, você pode:
+
+* Ir para o painel "Debug".
+* "Add configuration...".
+* Selecionar "Python"
+* Executar o depurador com a opção "`Python: Current File (Integrated Terminal)`".
+
+Em seguida, ele iniciará o servidor com seu código **FastAPI**, parará em seus pontos de interrupção, etc.
+
+Veja como pode parecer:
+
+<img src="/img/tutorial/debugging/image01.png">
+
+---
+
+Se você usar o Pycharm, você pode:
+
+* Abrir o menu "Executar".
+* Selecionar a opção "Depurar...".
+* Então um menu de contexto aparece.
+* Selecionar o arquivo para depurar (neste caso, `main.py`).
+
+Em seguida, ele iniciará o servidor com seu código **FastAPI**, parará em seus pontos de interrupção, etc.
+
+Veja como pode parecer:
+
+<img src="/img/tutorial/debugging/image02.png">

From 73d4f347df83c8e59ab55c9dfdbd974351e6efc5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 10 Sep 2024 10:34:46 +0000
Subject: [PATCH 114/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b9eaed65d..7492242a4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/debugging.md`. PR [#12165](https://github.com/fastapi/fastapi/pull/12165) by [@marcelomarkus](https://github.com/marcelomarkus).
 * 🌐 Add Korean translation for `docs/ko/docs/project-generation.md`. PR [#12157](https://github.com/fastapi/fastapi/pull/12157) by [@BORA040126](https://github.com/BORA040126).
 
 ### Internal

From a4a7925045e42030528c6f1fdeaa059e811455c0 Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Tue, 10 Sep 2024 07:35:14 -0300
Subject: [PATCH 115/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/testing.md`=20(#12164)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/pt/docs/tutorial/testing.md | 249 +++++++++++++++++++++++++++++++
 1 file changed, 249 insertions(+)
 create mode 100644 docs/pt/docs/tutorial/testing.md

diff --git a/docs/pt/docs/tutorial/testing.md b/docs/pt/docs/tutorial/testing.md
new file mode 100644
index 000000000..f734a7d9a
--- /dev/null
+++ b/docs/pt/docs/tutorial/testing.md
@@ -0,0 +1,249 @@
+# Testando
+
+Graças ao <a href="https://www.starlette.io/testclient/" class="external-link" target="_blank">Starlette</a>, testar aplicativos **FastAPI** é fácil e agradável.
+
+Ele é baseado no <a href="https://www.python-httpx.org" class="external-link" target="_blank">HTTPX</a>, que por sua vez é projetado com base em Requests, por isso é muito familiar e intuitivo.
+
+Com ele, você pode usar o <a href="https://docs.pytest.org/" class="external-link" target="_blank">pytest</a> diretamente com **FastAPI**.
+
+## Usando `TestClient`
+
+/// info | "Informação"
+
+Para usar o `TestClient`, primeiro instale o <a href="https://www.python-httpx.org" class="external-link" target="_blank">`httpx`</a>.
+
+Certifique-se de criar um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, ativá-lo e instalá-lo, por exemplo:
+
+```console
+$ pip install httpx
+```
+
+///
+
+Importe `TestClient`.
+
+Crie um `TestClient` passando seu aplicativo **FastAPI** para ele.
+
+Crie funções com um nome que comece com `test_` (essa é a convenção padrão do `pytest`).
+
+Use o objeto `TestClient` da mesma forma que você faz com `httpx`.
+
+Escreva instruções `assert` simples com as expressões Python padrão que você precisa verificar (novamente, `pytest` padrão).
+
+```Python hl_lines="2  12  15-18"
+{!../../../docs_src/app_testing/tutorial001.py!}
+```
+
+/// tip | "Dica"
+
+Observe que as funções de teste são `def` normais, não `async def`.
+
+E as chamadas para o cliente também são chamadas normais, não usando `await`.
+
+Isso permite que você use `pytest` diretamente sem complicações.
+
+///
+
+/// note | "Detalhes técnicos"
+
+Você também pode usar `from starlette.testclient import TestClient`.
+
+**FastAPI** fornece o mesmo `starlette.testclient` que `fastapi.testclient` apenas como uma conveniência para você, o desenvolvedor. Mas ele vem diretamente da Starlette.
+
+///
+
+/// tip | "Dica"
+
+Se você quiser chamar funções `async` em seus testes além de enviar solicitações ao seu aplicativo FastAPI (por exemplo, funções de banco de dados assíncronas), dê uma olhada em [Testes assíncronos](../advanced/async-tests.md){.internal-link target=_blank} no tutorial avançado.
+
+///
+
+## Separando testes
+
+Em uma aplicação real, você provavelmente teria seus testes em um arquivo diferente.
+
+E seu aplicativo **FastAPI** também pode ser composto de vários arquivos/módulos, etc.
+
+### Arquivo do aplicativo **FastAPI**
+
+Digamos que você tenha uma estrutura de arquivo conforme descrito em [Aplicativos maiores](bigger-applications.md){.internal-link target=_blank}:
+
+```
+.
+├── app
+│   ├── __init__.py
+│   └── main.py
+```
+
+No arquivo `main.py` você tem seu aplicativo **FastAPI**:
+
+
+```Python
+{!../../../docs_src/app_testing/main.py!}
+```
+
+### Arquivo de teste
+
+Então você poderia ter um arquivo `test_main.py` com seus testes. Ele poderia estar no mesmo pacote Python (o mesmo diretório com um arquivo `__init__.py`):
+
+``` hl_lines="5"
+.
+├── app
+│   ├── __init__.py
+│   ├── main.py
+│   └── test_main.py
+```
+
+Como esse arquivo está no mesmo pacote, você pode usar importações relativas para importar o objeto `app` do módulo `main` (`main.py`):
+
+```Python hl_lines="3"
+{!../../../docs_src/app_testing/test_main.py!}
+```
+
+...e ter o código para os testes como antes.
+
+## Testando: exemplo estendido
+
+Agora vamos estender este exemplo e adicionar mais detalhes para ver como testar diferentes partes.
+
+### Arquivo de aplicativo **FastAPI** estendido
+
+Vamos continuar com a mesma estrutura de arquivo de antes:
+
+```
+.
+├── app
+│   ├── __init__.py
+│   ├── main.py
+│   └── test_main.py
+```
+
+Digamos que agora o arquivo `main.py` com seu aplicativo **FastAPI** tenha algumas outras **operações de rotas**.
+
+Ele tem uma operação `GET` que pode retornar um erro.
+
+Ele tem uma operação `POST` que pode retornar vários erros.
+
+Ambas as *operações de rotas* requerem um cabeçalho `X-Token`.
+
+//// tab | Python 3.10+
+
+```Python
+{!> ../../../docs_src/app_testing/app_b_an_py310/main.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python
+{!> ../../../docs_src/app_testing/app_b_an/main.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira usar a versão `Annotated` se possível.
+
+///
+
+```Python
+{!> ../../../docs_src/app_testing/app_b_py310/main.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira usar a versão `Annotated` se possível.
+
+///
+
+```Python
+{!> ../../../docs_src/app_testing/app_b/main.py!}
+```
+
+////
+
+### Arquivo de teste estendido
+
+Você pode então atualizar `test_main.py` com os testes estendidos:
+
+```Python
+{!> ../../../docs_src/app_testing/app_b/test_main.py!}
+```
+
+Sempre que você precisar que o cliente passe informações na requisição e não souber como, você pode pesquisar (no Google) como fazer isso no `httpx`, ou até mesmo como fazer isso com `requests`, já que o design do HTTPX é baseado no design do Requests.
+
+Depois é só fazer o mesmo nos seus testes.
+
+Por exemplo:
+
+* Para passar um parâmetro *path* ou *query*, adicione-o à própria URL.
+* Para passar um corpo JSON, passe um objeto Python (por exemplo, um `dict`) para o parâmetro `json`.
+* Se você precisar enviar *Dados de Formulário* em vez de JSON, use o parâmetro `data`.
+* Para passar *headers*, use um `dict` no parâmetro `headers`.
+* Para *cookies*, um `dict` no parâmetro `cookies`.
+
+Para mais informações sobre como passar dados para o backend (usando `httpx` ou `TestClient`), consulte a <a href="https://www.python-httpx.org" class="external-link" target="_blank">documentação do HTTPX</a>.
+
+/// info | "Informação"
+
+Observe que o `TestClient` recebe dados que podem ser convertidos para JSON, não para modelos Pydantic.
+
+Se você tiver um modelo Pydantic em seu teste e quiser enviar seus dados para o aplicativo durante o teste, poderá usar o `jsonable_encoder` descrito em [Codificador compatível com JSON](encoder.md){.internal-link target=_blank}.
+
+///
+
+## Execute-o
+
+Depois disso, você só precisa instalar o `pytest`.
+
+Certifique-se de criar um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, ativá-lo e instalá-lo, por exemplo:
+
+<div class="termy">
+
+```console
+$ pip install pytest
+
+---> 100%
+```
+
+</div>
+
+Ele detectará os arquivos e os testes automaticamente, os executará e informará os resultados para você.
+
+Execute os testes com:
+
+<div class="termy">
+
+```console
+$ pytest
+
+================ test session starts ================
+platform linux -- Python 3.6.9, pytest-5.3.5, py-1.8.1, pluggy-0.13.1
+rootdir: /home/user/code/superawesome-cli/app
+plugins: forked-1.1.3, xdist-1.31.0, cov-2.8.1
+collected 6 items
+
+---> 100%
+
+test_main.py <span style="color: green; white-space: pre;">......                            [100%]</span>
+
+<span style="color: green;">================= 1 passed in 0.03s =================</span>
+```
+
+</div>

From e69ba263861b440fce06b55bedf83bd08646452b Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Tue, 10 Sep 2024 07:36:42 -0300
Subject: [PATCH 116/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/pt/docs/environment-variables.md`=20(#1216?=
 =?UTF-8?q?2)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/pt/docs/environment-variables.md | 298 ++++++++++++++++++++++++++
 1 file changed, 298 insertions(+)
 create mode 100644 docs/pt/docs/environment-variables.md

diff --git a/docs/pt/docs/environment-variables.md b/docs/pt/docs/environment-variables.md
new file mode 100644
index 000000000..360d1c496
--- /dev/null
+++ b/docs/pt/docs/environment-variables.md
@@ -0,0 +1,298 @@
+# Variáveis de Ambiente
+
+/// tip | "Dica"
+
+Se você já sabe o que são "variáveis de ambiente" e como usá-las, pode pular esta seção.
+
+///
+
+Uma variável de ambiente (também conhecida como "**env var**") é uma variável que existe **fora** do código Python, no **sistema operacional**, e pode ser lida pelo seu código Python (ou por outros programas também).
+
+Variáveis de ambiente podem ser úteis para lidar com **configurações** do aplicativo, como parte da **instalação** do Python, etc.
+
+## Criar e Usar Variáveis de Ambiente
+
+Você pode **criar** e usar variáveis de ambiente no **shell (terminal)**, sem precisar do Python:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// Você pode criar uma variável de ambiente MY_NAME com
+$ export MY_NAME="Wade Wilson"
+
+// Então você pode usá-la com outros programas, como
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Criar uma variável de ambiente MY_NAME
+$ $Env:MY_NAME = "Wade Wilson"
+
+// Usá-la com outros programas, como
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+## Ler Variáveis de Ambiente no Python
+
+Você também pode criar variáveis de ambiente **fora** do Python, no terminal (ou com qualquer outro método) e depois **lê-las no Python**.
+
+Por exemplo, você poderia ter um arquivo `main.py` com:
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip | "Dica"
+
+O segundo argumento para <a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> é o valor padrão a ser retornado.
+
+Se não for fornecido, é `None` por padrão, Aqui fornecemos `"World"` como o valor padrão a ser usado.
+
+///
+
+Então você poderia chamar esse programa Python:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// Aqui ainda não definimos a variável de ambiente
+$ python main.py
+
+// Como não definimos a variável de ambiente, obtemos o valor padrão
+
+Hello World from Python
+
+// Mas se criarmos uma variável de ambiente primeiro
+$ export MY_NAME="Wade Wilson"
+
+// E então chamar o programa novamente
+$ python main.py
+
+// Agora ele pode ler a variável de ambiente
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Aqui ainda não definimos a variável de ambiente
+$ python main.py
+
+// Como não definimos a variável de ambiente, obtemos o valor padrão
+
+Hello World from Python
+
+// Mas se criarmos uma variável de ambiente primeiro
+$ $Env:MY_NAME = "Wade Wilson"
+
+// E então chamar o programa novamente
+$ python main.py
+
+// Agora ele pode ler a variável de ambiente
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+Como as variáveis de ambiente podem ser definidas fora do código, mas podem ser lidas pelo código e não precisam ser armazenadas (com versão no `git`) com o restante dos arquivos, é comum usá-las para configurações ou **definições**.
+
+Você também pode criar uma variável de ambiente apenas para uma **invocação específica do programa**, que só está disponível para aquele programa e apenas pela duração dele.
+
+Para fazer isso, crie-a na mesma linha, antes do próprio programa:
+
+<div class="termy">
+
+```console
+// Criar uma variável de ambiente MY_NAME para esta chamada de programa
+$ MY_NAME="Wade Wilson" python main.py
+
+// Agora ele pode ler a variável de ambiente
+
+Hello Wade Wilson from Python
+
+// A variável de ambiente não existe mais depois
+$ python main.py
+
+Hello World from Python
+```
+
+</div>
+
+/// tip | "Dica"
+
+Você pode ler mais sobre isso em <a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a>.
+
+///
+
+## Tipos e Validação
+
+Essas variáveis de ambiente só podem lidar com **strings de texto**, pois são externas ao Python e precisam ser compatíveis com outros programas e com o resto do sistema (e até mesmo com diferentes sistemas operacionais, como Linux, Windows, macOS).
+
+Isso significa que **qualquer valor** lido em Python de uma variável de ambiente **será uma `str`**, e qualquer conversão para um tipo diferente ou qualquer validação precisa ser feita no código.
+
+Você aprenderá mais sobre como usar variáveis de ambiente para lidar com **configurações do aplicativo** no [Guia do Usuário Avançado - Configurações e Variáveis de Ambiente](./advanced/settings.md){.internal-link target=_blank}.
+
+## Variável de Ambiente `PATH`
+
+Existe uma variável de ambiente **especial** chamada **`PATH`** que é usada pelos sistemas operacionais (Linux, macOS, Windows) para encontrar programas para executar.
+
+O valor da variável `PATH` é uma longa string composta por diretórios separados por dois pontos `:` no Linux e macOS, e por ponto e vírgula `;` no Windows.
+
+Por exemplo, a variável de ambiente `PATH` poderia ter esta aparência:
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+Isso significa que o sistema deve procurar programas nos diretórios:
+
+* `/usr/local/bin`
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+Isso significa que o sistema deve procurar programas nos diretórios:
+
+* `C:\Program Files\Python312\Scripts`
+* `C:\Program Files\Python312`
+* `C:\Windows\System32`
+
+////
+
+Quando você digita um **comando** no terminal, o sistema operacional **procura** o programa em **cada um dos diretórios** listados na variável de ambiente `PATH`.
+
+Por exemplo, quando você digita `python` no terminal, o sistema operacional procura um programa chamado `python` no **primeiro diretório** dessa lista.
+
+Se ele o encontrar, então ele o **usará**. Caso contrário, ele continua procurando nos **outros diretórios**.
+
+### Instalando o Python e Atualizando o `PATH`
+
+Durante a instalação do Python, você pode ser questionado sobre a atualização da variável de ambiente `PATH`.
+
+//// tab | Linux, macOS
+
+Vamos supor que você instale o Python e ele fique em um diretório `/opt/custompython/bin`.
+
+Se você concordar em atualizar a variável de ambiente `PATH`, o instalador adicionará `/opt/custompython/bin` para a variável de ambiente `PATH`.
+
+Poderia parecer assim:
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+Dessa forma, ao digitar `python` no terminal, o sistema encontrará o programa Python em `/opt/custompython/bin` (último diretório) e o utilizará.
+
+////
+
+//// tab | Windows
+
+Digamos que você instala o Python e ele acaba em um diretório `C:\opt\custompython\bin`.
+
+Se você disser sim para atualizar a variável de ambiente `PATH`, o instalador adicionará `C:\opt\custompython\bin` à variável de ambiente `PATH`.
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+Dessa forma, quando você digitar `python` no terminal, o sistema encontrará o programa Python em `C:\opt\custompython\bin` (o último diretório) e o utilizará.
+
+////
+
+Então, se você digitar:
+
+<div class="termy">
+
+```console
+$ python
+```
+
+</div>
+
+//// tab | Linux, macOS
+
+O sistema **encontrará** o programa `python` em `/opt/custompython/bin` e o executará.
+
+Seria aproximadamente equivalente a digitar:
+
+<div class="termy">
+
+```console
+$ /opt/custompython/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows
+
+O sistema **encontrará** o programa `python` em `C:\opt\custompython\bin\python` e o executará.
+
+Seria aproximadamente equivalente a digitar:
+
+<div class="termy">
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+</div>
+
+////
+
+Essas informações serão úteis ao aprender sobre [Ambientes Virtuais](virtual-environments.md){.internal-link target=_blank}.
+
+## Conclusão
+
+Com isso, você deve ter uma compreensão básica do que são **variáveis ​​de ambiente** e como usá-las em Python.
+
+Você também pode ler mais sobre elas na <a href="https://en.wikipedia.org/wiki/Environment_variable" class="external-link" target="_blank">Wikipedia para Variáveis ​​de Ambiente</a>.
+
+Em muitos casos, não é muito óbvio como as variáveis ​​de ambiente seriam úteis e aplicáveis ​​imediatamente. Mas elas continuam aparecendo em muitos cenários diferentes quando você está desenvolvendo, então é bom saber sobre elas.
+
+Por exemplo, você precisará dessas informações na próxima seção, sobre [Ambientes Virtuais](virtual-environments.md).

From 944b6e507e326f986061e99936c80aa565da669f Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Tue, 10 Sep 2024 07:37:13 -0300
Subject: [PATCH 117/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/pt/docs/virtual-environments.md`=20(#12163?=
 =?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/pt/docs/virtual-environments.md | 844 +++++++++++++++++++++++++++
 1 file changed, 844 insertions(+)
 create mode 100644 docs/pt/docs/virtual-environments.md

diff --git a/docs/pt/docs/virtual-environments.md b/docs/pt/docs/virtual-environments.md
new file mode 100644
index 000000000..863c8d65e
--- /dev/null
+++ b/docs/pt/docs/virtual-environments.md
@@ -0,0 +1,844 @@
+# Ambientes Virtuais
+
+Ao trabalhar em projetos Python, você provavelmente deve usar um **ambiente virtual** (ou um mecanismo similar) para isolar os pacotes que você instala para cada projeto.
+
+/// info | "Informação"
+
+Se você já sabe sobre ambientes virtuais, como criá-los e usá-los, talvez seja melhor pular esta seção. 🤓
+
+///
+
+/// tip | "Dica"
+
+Um **ambiente virtual** é diferente de uma **variável de ambiente**.
+
+Uma **variável de ambiente** é uma variável no sistema que pode ser usada por programas.
+
+Um **ambiente virtual** é um diretório com alguns arquivos.
+
+///
+
+/// info | "Informação"
+
+Esta página lhe ensinará como usar **ambientes virtuais** e como eles funcionam.
+
+Se você estiver pronto para adotar uma **ferramenta que gerencia tudo** para você (incluindo a instalação do Python), experimente <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">uv</a>.
+
+///
+
+## Criar um Projeto
+
+Primeiro, crie um diretório para seu projeto.
+
+O que normalmente faço é criar um diretório chamado `code` dentro do meu diretório home/user.
+
+E dentro disso eu crio um diretório por projeto.
+
+<div class="termy">
+
+```console
+// Vá para o diretório inicial
+$ cd
+// Crie um diretório para todos os seus projetos de código
+$ mkdir code
+// Entre nesse diretório de código
+$ cd code
+// Crie um diretório para este projeto
+$ mkdir awesome-project
+// Entre no diretório do projeto
+$ cd awesome-project
+```
+
+</div>
+
+## Crie um ambiente virtual
+
+Ao começar a trabalhar em um projeto Python **pela primeira vez**, crie um ambiente virtual **<abbr title="existem outras opções, esta é uma diretriz simples">dentro do seu projeto</abbr>**.
+
+/// tip | "Dica"
+
+Você só precisa fazer isso **uma vez por projeto**, não toda vez que trabalhar.
+
+///
+
+//// tab | `venv`
+
+Para criar um ambiente virtual, você pode usar o módulo `venv` que vem com o Python.
+
+<div class="termy">
+
+```console
+$ python -m venv .venv
+```
+
+</div>
+
+/// details | O que esse comando significa
+
+* `python`: usa o programa chamado `python`
+* `-m`: chama um módulo como um script, nós diremos a ele qual módulo vem em seguida
+* `venv`: usa o módulo chamado `venv` que normalmente vem instalado com o Python
+* `.venv`: cria o ambiente virtual no novo diretório `.venv`
+
+///
+
+////
+
+//// tab | `uv`
+
+Se você tiver o <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a> instalado, poderá usá-lo para criar um ambiente virtual.
+
+<div class="termy">
+
+```console
+$ uv venv
+```
+
+</div>
+
+/// tip | "Dica"
+
+Por padrão, `uv` criará um ambiente virtual em um diretório chamado `.venv`.
+
+Mas você pode personalizá-lo passando um argumento adicional com o nome do diretório.
+
+///
+
+////
+
+Esse comando cria um novo ambiente virtual em um diretório chamado `.venv`.
+
+/// details | `.venv` ou outro nome
+
+Você pode criar o ambiente virtual em um diretório diferente, mas há uma convenção para chamá-lo de `.venv`.
+
+///
+
+## Ative o ambiente virtual
+
+Ative o novo ambiente virtual para que qualquer comando Python que você executar ou pacote que você instalar o utilize.
+
+/// tip | "Dica"
+
+Faça isso **toda vez** que iniciar uma **nova sessão de terminal** para trabalhar no projeto.
+
+///
+
+//// tab | Linux, macOS
+
+<div class="termy">
+
+```console
+$ source .venv/bin/activate
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+</div>
+
+////
+
+//// tab | Windows Bash
+
+Ou se você usa o Bash para Windows (por exemplo, <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>):
+
+<div class="termy">
+
+```console
+$ source .venv/Scripts/activate
+```
+
+</div>
+
+////
+
+/// tip | "Dica"
+
+Toda vez que você instalar um **novo pacote** naquele ambiente, **ative** o ambiente novamente.
+
+Isso garante que, se você usar um **programa de terminal (<abbr title="interface de linha de comando">CLI</abbr>)** instalado por esse pacote, você usará aquele do seu ambiente virtual e não qualquer outro que possa ser instalado globalmente, provavelmente com uma versão diferente do que você precisa.
+
+///
+
+## Verifique se o ambiente virtual está ativo
+
+Verifique se o ambiente virtual está ativo (o comando anterior funcionou).
+
+/// tip | "Dica"
+
+Isso é **opcional**, mas é uma boa maneira de **verificar** se tudo está funcionando conforme o esperado e se você está usando o ambiente virtual pretendido.
+
+///
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+</div>
+
+Se ele mostrar o binário `python` em `.venv/bin/python`, dentro do seu projeto (neste caso `awesome-project`), então funcionou. 🎉
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+</div>
+
+Se ele mostrar o binário `python` em `.venv\Scripts\python`, dentro do seu projeto (neste caso `awesome-project`), então funcionou. 🎉
+
+////
+
+## Atualizar `pip`
+
+/// tip | "Dica"
+
+Se você usar <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>, você o usará para instalar coisas em vez do `pip`, então não precisará atualizar o `pip`. 😎
+
+///
+
+Se você estiver usando `pip` para instalar pacotes (ele vem por padrão com o Python), você deve **atualizá-lo** para a versão mais recente.
+
+Muitos erros exóticos durante a instalação de um pacote são resolvidos apenas atualizando o `pip` primeiro.
+
+/// tip | "Dica"
+
+Normalmente, você faria isso **uma vez**, logo após criar o ambiente virtual.
+
+///
+
+Certifique-se de que o ambiente virtual esteja ativo (com o comando acima) e execute:
+
+<div class="termy">
+
+```console
+$ python -m pip install --upgrade pip
+
+---> 100%
+```
+
+</div>
+
+## Adicionar `.gitignore`
+
+Se você estiver usando **Git** (você deveria), adicione um arquivo `.gitignore` para excluir tudo em seu `.venv` do Git.
+
+/// tip | "Dica"
+
+Se você usou <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a> para criar o ambiente virtual, ele já fez isso para você, você pode pular esta etapa. 😎
+
+///
+
+/// tip | "Dica"
+
+Faça isso **uma vez**, logo após criar o ambiente virtual.
+
+///
+
+<div class="termy">
+
+```console
+$ echo "*" > .venv/.gitignore
+```
+
+</div>
+
+/// details | O que esse comando significa
+
+* `echo "*"`: irá "imprimir" o texto `*` no terminal (a próxima parte muda isso um pouco)
+* `>`: qualquer coisa impressa no terminal pelo comando à esquerda de `>` não deve ser impressa, mas sim escrita no arquivo que vai à direita de `>`
+* `.gitignore`: o nome do arquivo onde o texto deve ser escrito
+
+E `*` para Git significa "tudo". Então, ele ignorará tudo no diretório `.venv`.
+
+Esse comando criará um arquivo `.gitignore` com o conteúdo:
+
+```gitignore
+*
+```
+
+///
+
+## Instalar Pacotes
+
+Após ativar o ambiente, você pode instalar pacotes nele.
+
+/// tip | "Dica"
+
+Faça isso **uma vez** ao instalar ou atualizar os pacotes que seu projeto precisa.
+
+Se precisar atualizar uma versão ou adicionar um novo pacote, você **fará isso novamente**.
+
+///
+
+### Instalar pacotes diretamente
+
+Se estiver com pressa e não quiser usar um arquivo para declarar os requisitos de pacote do seu projeto, você pode instalá-los diretamente.
+
+/// tip | "Dica"
+
+É uma (muito) boa ideia colocar os pacotes e versões que seu programa precisa em um arquivo (por exemplo `requirements.txt` ou `pyproject.toml`).
+
+///
+
+//// tab | `pip`
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[standard]"
+
+---> 100%
+```
+
+</div>
+
+////
+
+//// tab | `uv`
+
+Se você tem o <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>:
+
+<div class="termy">
+
+```console
+$ uv pip install "fastapi[standard]"
+---> 100%
+```
+
+</div>
+
+////
+
+### Instalar a partir de `requirements.txt`
+
+Se você tiver um `requirements.txt`, agora poderá usá-lo para instalar seus pacotes.
+
+//// tab | `pip`
+
+<div class="termy">
+
+```console
+$ pip install -r requirements.txt
+---> 100%
+```
+
+</div>
+
+////
+
+//// tab | `uv`
+
+Se você tem o <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>:
+
+<div class="termy">
+
+```console
+$ uv pip install -r requirements.txt
+---> 100%
+```
+
+</div>
+
+////
+
+/// details | `requirements.txt`
+
+Um `requirements.txt` com alguns pacotes poderia se parecer com:
+
+```requirements.txt
+fastapi[standard]==0.113.0
+pydantic==2.8.0
+```
+
+///
+
+## Execute seu programa
+
+Depois de ativar o ambiente virtual, você pode executar seu programa, e ele usará o Python dentro do seu ambiente virtual com os pacotes que você instalou lá.
+
+<div class="termy">
+
+```console
+$ python main.py
+
+Hello World
+```
+
+</div>
+
+## Configure seu editor
+
+Você provavelmente usaria um editor. Certifique-se de configurá-lo para usar o mesmo ambiente virtual que você criou (ele provavelmente o detectará automaticamente) para que você possa obter erros de preenchimento automático e em linha.
+
+Por exemplo:
+
+* <a href="https://code.visualstudio.com/docs/python/environments#_select-and-activate-an-environment" class="external-link" target="_blank">VS Code</a>
+* <a href="https://www.jetbrains.com/help/pycharm/creating-virtual-environment.html" class="external-link" target="_blank">PyCharm</a>
+
+/// tip | "Dica"
+
+Normalmente, você só precisa fazer isso **uma vez**, ao criar o ambiente virtual.
+
+///
+
+## Desativar o ambiente virtual
+
+Quando terminar de trabalhar no seu projeto, você pode **desativar** o ambiente virtual.
+
+<div class="termy">
+
+```console
+$ deactivate
+```
+
+</div>
+
+Dessa forma, quando você executar `python`, ele não tentará executá-lo naquele ambiente virtual com os pacotes instalados nele.
+
+## Pronto para trabalhar
+
+Agora você está pronto para começar a trabalhar no seu projeto.
+
+
+
+/// tip | "Dica"
+
+Você quer entender o que é tudo isso acima?
+
+Continue lendo. 👇🤓
+
+///
+
+## Por que ambientes virtuais
+
+Para trabalhar com o FastAPI, você precisa instalar o <a href="https://www.python.org/" class="external-link" target="_blank">Python</a>.
+
+Depois disso, você precisará **instalar** o FastAPI e quaisquer outros **pacotes** que queira usar.
+
+Para instalar pacotes, você normalmente usaria o comando `pip` que vem com o Python (ou alternativas semelhantes).
+
+No entanto, se você usar `pip` diretamente, os pacotes serão instalados no seu **ambiente Python global** (a instalação global do Python).
+
+### O Problema
+
+Então, qual é o problema em instalar pacotes no ambiente global do Python?
+
+Em algum momento, você provavelmente acabará escrevendo muitos programas diferentes que dependem de **pacotes diferentes**. E alguns desses projetos em que você trabalha dependerão de **versões diferentes** do mesmo pacote. 😱
+
+Por exemplo, você pode criar um projeto chamado `philosophers-stone`, este programa depende de outro pacote chamado **`harry`, usando a versão `1`**. Então, você precisa instalar `harry`.
+
+```mermaid
+flowchart LR
+    stone(philosophers-stone) -->|requires| harry-1[harry v1]
+```
+
+Então, em algum momento depois, você cria outro projeto chamado `prisoner-of-azkaban`, e esse projeto também depende de `harry`, mas esse projeto precisa do **`harry` versão `3`**.
+
+```mermaid
+flowchart LR
+    azkaban(prisoner-of-azkaban) --> |requires| harry-3[harry v3]
+```
+
+Mas agora o problema é que, se você instalar os pacotes globalmente (no ambiente global) em vez de em um **ambiente virtual** local, você terá que escolher qual versão do `harry` instalar.
+
+Se você quiser executar `philosophers-stone`, precisará primeiro instalar `harry` versão `1`, por exemplo com:
+
+<div class="termy">
+
+```console
+$ pip install "harry==1"
+```
+
+</div>
+
+E então você acabaria com `harry` versão `1` instalado em seu ambiente Python global.
+
+```mermaid
+flowchart LR
+    subgraph global[global env]
+        harry-1[harry v1]
+    end
+    subgraph stone-project[philosophers-stone project]
+        stone(philosophers-stone) -->|requires| harry-1
+    end
+```
+
+Mas se você quiser executar `prisoner-of-azkaban`, você precisará desinstalar `harry` versão `1` e instalar `harry` versão `3` (ou apenas instalar a versão `3` desinstalaria automaticamente a versão `1`).
+
+<div class="termy">
+
+```console
+$ pip install "harry==3"
+```
+
+</div>
+
+E então você acabaria com `harry` versão `3` instalado em seu ambiente Python global.
+
+E se você tentar executar `philosophers-stone` novamente, há uma chance de que **não funcione** porque ele precisa de `harry` versão `1`.
+
+```mermaid
+flowchart LR
+    subgraph global[global env]
+        harry-1[<strike>harry v1</strike>]
+        style harry-1 fill:#ccc,stroke-dasharray: 5 5
+        harry-3[harry v3]
+    end
+    subgraph stone-project[philosophers-stone project]
+        stone(philosophers-stone) -.-x|⛔️| harry-1
+    end
+    subgraph azkaban-project[prisoner-of-azkaban project]
+        azkaban(prisoner-of-azkaban) --> |requires| harry-3
+    end
+```
+
+/// tip | "Dica"
+
+É muito comum em pacotes Python tentar ao máximo **evitar alterações drásticas** em **novas versões**, mas é melhor prevenir do que remediar e instalar versões mais recentes intencionalmente e, quando possível, executar os testes para verificar se tudo está funcionando corretamente.
+
+///
+
+Agora, imagine isso com **muitos** outros **pacotes** dos quais todos os seus **projetos dependem**. Isso é muito difícil de gerenciar. E você provavelmente acabaria executando alguns projetos com algumas **versões incompatíveis** dos pacotes, e não saberia por que algo não está funcionando.
+
+Além disso, dependendo do seu sistema operacional (por exemplo, Linux, Windows, macOS), ele pode ter vindo com o Python já instalado. E, nesse caso, provavelmente tinha alguns pacotes pré-instalados com algumas versões específicas **necessárias para o seu sistema**. Se você instalar pacotes no ambiente global do Python, poderá acabar **quebrando** alguns dos programas que vieram com seu sistema operacional.
+
+## Onde os pacotes são instalados
+
+Quando você instala o Python, ele cria alguns diretórios com alguns arquivos no seu computador.
+
+Alguns desses diretórios são os responsáveis ​​por ter todos os pacotes que você instala.
+
+Quando você executa:
+
+<div class="termy">
+
+```console
+// Não execute isso agora, é apenas um exemplo 🤓
+$ pip install "fastapi[standard]"
+---> 100%
+```
+
+</div>
+
+Isso fará o download de um arquivo compactado com o código FastAPI, normalmente do <a href="https://pypi.org/project/fastapi/" class="external-link" target="_blank">PyPI</a>.
+
+Ele também fará o **download** de arquivos para outros pacotes dos quais o FastAPI depende.
+
+Em seguida, ele **extrairá** todos esses arquivos e os colocará em um diretório no seu computador.
+
+Por padrão, ele colocará os arquivos baixados e extraídos no diretório que vem com a instalação do Python, que é o **ambiente global**.
+
+## O que são ambientes virtuais
+
+A solução para os problemas de ter todos os pacotes no ambiente global é usar um **ambiente virtual para cada projeto** em que você trabalha.
+
+Um ambiente virtual é um **diretório**, muito semelhante ao global, onde você pode instalar os pacotes para um projeto.
+
+Dessa forma, cada projeto terá seu próprio ambiente virtual (diretório `.venv`) com seus próprios pacotes.
+
+```mermaid
+flowchart TB
+    subgraph stone-project[philosophers-stone project]
+        stone(philosophers-stone) --->|requires| harry-1
+        subgraph venv1[.venv]
+            harry-1[harry v1]
+        end
+    end
+    subgraph azkaban-project[prisoner-of-azkaban project]
+        azkaban(prisoner-of-azkaban) --->|requires| harry-3
+        subgraph venv2[.venv]
+            harry-3[harry v3]
+        end
+    end
+    stone-project ~~~ azkaban-project
+```
+
+## O que significa ativar um ambiente virtual
+
+Quando você ativa um ambiente virtual, por exemplo com:
+
+//// tab | Linux, macOS
+
+<div class="termy">
+
+```console
+$ source .venv/bin/activate
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+</div>
+
+////
+
+//// tab | Windows Bash
+
+Ou se você usa o Bash para Windows (por exemplo, <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>):
+
+<div class="termy">
+
+```console
+$ source .venv/Scripts/activate
+```
+
+</div>
+
+////
+
+Esse comando criará ou modificará algumas [variáveis ​​de ambiente](environment-variables.md){.internal-link target=_blank} que estarão disponíveis para os próximos comandos.
+
+Uma dessas variáveis ​​é a variável `PATH`.
+
+/// tip | "Dica"
+
+Você pode aprender mais sobre a variável de ambiente `PATH` na seção [Variáveis ​​de ambiente](environment-variables.md#path-environment-variable){.internal-link target=_blank}.
+
+///
+
+A ativação de um ambiente virtual adiciona seu caminho `.venv/bin` (no Linux e macOS) ou `.venv\Scripts` (no Windows) à variável de ambiente `PATH`.
+
+Digamos que antes de ativar o ambiente, a variável `PATH` estava assim:
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+Isso significa que o sistema procuraria programas em:
+
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Windows\System32
+```
+
+Isso significa que o sistema procuraria programas em:
+
+* `C:\Windows\System32`
+
+////
+
+Após ativar o ambiente virtual, a variável `PATH` ficaria mais ou menos assim:
+
+//// tab | Linux, macOS
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+Isso significa que o sistema agora começará a procurar primeiro por programas em:
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin
+```
+
+antes de procurar nos outros diretórios.
+
+Então, quando você digita `python` no terminal, o sistema encontrará o programa Python em
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+e usa esse.
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts;C:\Windows\System32
+```
+
+Isso significa que o sistema agora começará a procurar primeiro por programas em:
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts
+```
+
+antes de procurar nos outros diretórios.
+
+Então, quando você digita `python` no terminal, o sistema encontrará o programa Python em
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+e usa esse.
+
+////
+
+Um detalhe importante é que ele colocará o caminho do ambiente virtual no **início** da variável `PATH`. O sistema o encontrará **antes** de encontrar qualquer outro Python disponível. Dessa forma, quando você executar `python`, ele usará o Python **do ambiente virtual** em vez de qualquer outro `python` (por exemplo, um `python` de um ambiente global).
+
+Ativar um ambiente virtual também muda algumas outras coisas, mas esta é uma das mais importantes.
+
+## Verificando um ambiente virtual
+
+Ao verificar se um ambiente virtual está ativo, por exemplo com:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+</div>
+
+////
+
+Isso significa que o programa `python` que será usado é aquele **no ambiente virtual**.
+
+você usa `which` no Linux e macOS e `Get-Command` no Windows PowerShell.
+
+A maneira como esse comando funciona é que ele vai e verifica na variável de ambiente `PATH`, passando por **cada caminho em ordem**, procurando pelo programa chamado `python`. Uma vez que ele o encontre, ele **mostrará o caminho** para esse programa.
+
+A parte mais importante é que quando você chama ``python`, esse é exatamente o "`python`" que será executado.
+
+Assim, você pode confirmar se está no ambiente virtual correto.
+
+/// tip | "Dica"
+
+É fácil ativar um ambiente virtual, obter um Python e então **ir para outro projeto**.
+
+E o segundo projeto **não funcionaria** porque você está usando o **Python incorreto**, de um ambiente virtual para outro projeto.
+
+É útil poder verificar qual `python` está sendo usado. 🤓
+
+///
+
+## Por que desativar um ambiente virtual
+
+Por exemplo, você pode estar trabalhando em um projeto `philosophers-stone`, **ativar esse ambiente virtual**, instalar pacotes e trabalhar com esse ambiente.
+
+E então você quer trabalhar em **outro projeto** `prisoner-of-azkaban`.
+
+Você vai para aquele projeto:
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+```
+
+</div>
+
+Se você não desativar o ambiente virtual para `philosophers-stone`, quando você executar `python` no terminal, ele tentará usar o Python de `philosophers-stone`.
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+
+$ python main.py
+
+// Erro ao importar o Sirius, ele não está instalado 😱
+Traceback (most recent call last):
+    File "main.py", line 1, in <module>
+        import sirius
+```
+
+</div>
+
+Mas se você desativar o ambiente virtual e ativar o novo para `prisoner-of-askaban`, quando você executar `python`, ele usará o Python do ambiente virtual em `prisoner-of-azkaban`.
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+
+// Você não precisa estar no diretório antigo para desativar, você pode fazer isso de onde estiver, mesmo depois de ir para o outro projeto 😎
+$ deactivate
+
+// Ative o ambiente virtual em prisoner-of-azkaban/.venv 🚀
+$ source .venv/bin/activate
+
+// Agora, quando você executar o python, ele encontrará o pacote sirius instalado neste ambiente virtual ✨
+$ python main.py
+
+Eu juro solenemente 🐺
+```
+
+</div>
+
+## Alternativas
+
+Este é um guia simples para você começar e lhe ensinar como tudo funciona **por baixo**.
+
+Existem muitas **alternativas** para gerenciar ambientes virtuais, dependências de pacotes (requisitos) e projetos.
+
+Quando estiver pronto e quiser usar uma ferramenta para **gerenciar todo o projeto**, dependências de pacotes, ambientes virtuais, etc., sugiro que você experimente o <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">uv</a>.
+
+`uv` pode fazer muitas coisas, ele pode:
+
+* **Instalar o Python** para você, incluindo versões diferentes
+* Gerenciar o **ambiente virtual** para seus projetos
+* Instalar **pacotes**
+* Gerenciar **dependências e versões** de pacotes para seu projeto
+* Certifique-se de ter um conjunto **exato** de pacotes e versões para instalar, incluindo suas dependências, para que você possa ter certeza de que pode executar seu projeto em produção exatamente da mesma forma que em seu computador durante o desenvolvimento, isso é chamado de **bloqueio**
+* E muitas outras coisas
+
+## Conclusão
+
+Se você leu e entendeu tudo isso, agora **você sabe muito mais** sobre ambientes virtuais do que muitos desenvolvedores por aí. 🤓
+
+Saber esses detalhes provavelmente será útil no futuro, quando você estiver depurando algo que parece complexo, mas você saberá **como tudo funciona**. 😎

From eb45bade63972dec674b83524e010e19ebdcd457 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 10 Sep 2024 10:37:36 +0000
Subject: [PATCH 118/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7492242a4..114841f2d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/testing.md`. PR [#12164](https://github.com/fastapi/fastapi/pull/12164) by [@marcelomarkus](https://github.com/marcelomarkus).
 * 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/debugging.md`. PR [#12165](https://github.com/fastapi/fastapi/pull/12165) by [@marcelomarkus](https://github.com/marcelomarkus).
 * 🌐 Add Korean translation for `docs/ko/docs/project-generation.md`. PR [#12157](https://github.com/fastapi/fastapi/pull/12157) by [@BORA040126](https://github.com/BORA040126).
 

From a4c5f7f62fbb2fbfc3daefd3ddcefa8b65e103d8 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 10 Sep 2024 10:38:58 +0000
Subject: [PATCH 119/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 114841f2d..11289cfe8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Portuguese translation for `docs/pt/docs/environment-variables.md`. PR [#12162](https://github.com/fastapi/fastapi/pull/12162) by [@marcelomarkus](https://github.com/marcelomarkus).
 * 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/testing.md`. PR [#12164](https://github.com/fastapi/fastapi/pull/12164) by [@marcelomarkus](https://github.com/marcelomarkus).
 * 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/debugging.md`. PR [#12165](https://github.com/fastapi/fastapi/pull/12165) by [@marcelomarkus](https://github.com/marcelomarkus).
 * 🌐 Add Korean translation for `docs/ko/docs/project-generation.md`. PR [#12157](https://github.com/fastapi/fastapi/pull/12157) by [@BORA040126](https://github.com/BORA040126).

From 74451189f6f243833674fc22a1fe57dfb21f9831 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 10 Sep 2024 10:40:52 +0000
Subject: [PATCH 120/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 11289cfe8..a72775416 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Portuguese translation for `docs/pt/docs/virtual-environments.md`. PR [#12163](https://github.com/fastapi/fastapi/pull/12163) by [@marcelomarkus](https://github.com/marcelomarkus).
 * 🌐 Add Portuguese translation for `docs/pt/docs/environment-variables.md`. PR [#12162](https://github.com/fastapi/fastapi/pull/12162) by [@marcelomarkus](https://github.com/marcelomarkus).
 * 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/testing.md`. PR [#12164](https://github.com/fastapi/fastapi/pull/12164) by [@marcelomarkus](https://github.com/marcelomarkus).
 * 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/debugging.md`. PR [#12165](https://github.com/fastapi/fastapi/pull/12165) by [@marcelomarkus](https://github.com/marcelomarkus).

From b0eedbb5804a6ac32e4ee8d029d462d950ff8848 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 11 Sep 2024 09:45:30 +0200
Subject: [PATCH 121/146] =?UTF-8?q?=E2=9A=A1=EF=B8=8F=20Improve=20performa?=
 =?UTF-8?q?nce=20in=20request=20body=20parsing=20with=20a=20cache=20for=20?=
 =?UTF-8?q?internal=20model=20fields=20(#12184)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/_compat.py            |  6 ++++++
 fastapi/dependencies/utils.py |  4 ++--
 tests/test_compat.py          | 16 ++++++++++++++++
 3 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index f940d6597..4b07b44fa 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -2,6 +2,7 @@ from collections import deque
 from copy import copy
 from dataclasses import dataclass, is_dataclass
 from enum import Enum
+from functools import lru_cache
 from typing import (
     Any,
     Callable,
@@ -649,3 +650,8 @@ def is_uploadfile_sequence_annotation(annotation: Any) -> bool:
         is_uploadfile_or_nonable_uploadfile_annotation(sub_annotation)
         for sub_annotation in get_args(annotation)
     )
+
+
+@lru_cache
+def get_cached_model_fields(model: Type[BaseModel]) -> List[ModelField]:
+    return get_model_fields(model)
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 6083b7319..f18eace9d 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -32,8 +32,8 @@ from fastapi._compat import (
     evaluate_forwardref,
     field_annotation_is_scalar,
     get_annotation_from_field_info,
+    get_cached_model_fields,
     get_missing_field_error,
-    get_model_fields,
     is_bytes_field,
     is_bytes_sequence_field,
     is_scalar_field,
@@ -810,7 +810,7 @@ async def request_body_to_args(
     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_)
+        fields_to_extract = get_cached_model_fields(first_field.type_)
 
     if isinstance(received_body, FormData):
         body_to_process = await _extract_form_body(fields_to_extract, received_body)
diff --git a/tests/test_compat.py b/tests/test_compat.py
index 270475bf3..f4a3093c5 100644
--- a/tests/test_compat.py
+++ b/tests/test_compat.py
@@ -5,6 +5,7 @@ from fastapi._compat import (
     ModelField,
     Undefined,
     _get_model_config,
+    get_cached_model_fields,
     get_model_fields,
     is_bytes_sequence_annotation,
     is_scalar_field,
@@ -102,3 +103,18 @@ def test_is_pv1_scalar_field():
 
     fields = get_model_fields(Model)
     assert not is_scalar_field(fields[0])
+
+
+def test_get_model_fields_cached():
+    class Model(BaseModel):
+        foo: str
+
+    non_cached_fields = get_model_fields(Model)
+    non_cached_fields2 = get_model_fields(Model)
+    cached_fields = get_cached_model_fields(Model)
+    cached_fields2 = get_cached_model_fields(Model)
+    for f1, f2 in zip(cached_fields, cached_fields2):
+        assert f1 is f2
+
+    assert non_cached_fields is not non_cached_fields2
+    assert cached_fields is cached_fields2

From 8dc882f75121414eb44db590efae83fbddf43f72 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 11 Sep 2024 07:45:49 +0000
Subject: [PATCH 122/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a72775416..647b51b19 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Refactors
+
+* ⚡️ Improve performance in request body parsing with a cache for internal model fields. PR [#12184](https://github.com/fastapi/fastapi/pull/12184) by [@tiangolo](https://github.com/tiangolo).
+
 ### Docs
 
 * 📝 Remove duplicate line in docs for `docs/en/docs/environment-variables.md`. PR [#12169](https://github.com/fastapi/fastapi/pull/12169) by [@prometek](https://github.com/prometek).

From 212fd5e247279073dceaba346fd4afc52f627232 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 11 Sep 2024 09:46:34 +0200
Subject: [PATCH 123/146] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
 =?UTF-8?q?4.1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 fastapi/__init__.py           | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 647b51b19..97f472815 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.114.1
+
 ### Refactors
 
 * ⚡️ Improve performance in request body parsing with a cache for internal model fields. PR [#12184](https://github.com/fastapi/fastapi/pull/12184) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index dce17360f..c2ed4859a 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.114.0"
+__version__ = "0.114.1"
 
 from starlette import status as status
 

From 24b8f2668beb773895a93040a2ae284898dc58b1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 12 Sep 2024 00:49:55 +0200
Subject: [PATCH 124/146] =?UTF-8?q?=E2=9E=95=20Add=20inline-snapshot=20for?=
 =?UTF-8?q?=20tests=20(#12189)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 pyproject.toml         | 4 ++++
 requirements-tests.txt | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index bb87be470..1be2817a1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -241,3 +241,7 @@ known-third-party = ["fastapi", "pydantic", "starlette"]
 [tool.ruff.lint.pyupgrade]
 # Preserve types, even if a file imports `from __future__ import annotations`.
 keep-runtime-typing = true
+
+[tool.inline-snapshot]
+# default-flags=["fix"]
+# default-flags=["create"]
diff --git a/requirements-tests.txt b/requirements-tests.txt
index 809a19c0c..2f2576dd5 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -14,7 +14,7 @@ anyio[trio] >=3.2.1,<4.0.0
 PyJWT==2.8.0
 pyyaml >=5.3.1,<7.0.0
 passlib[bcrypt] >=1.7.2,<2.0.0
-
+inline-snapshot==0.13.0
 # types
 types-ujson ==5.7.0.1
 types-orjson ==3.6.2

From ba0bb6212e553e779f75f973d07a4db112b43cf0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 11 Sep 2024 22:50:18 +0000
Subject: [PATCH 125/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 97f472815..01c9fb225 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Internal
+
+* ➕ Add inline-snapshot for tests. PR [#12189](https://github.com/fastapi/fastapi/pull/12189) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.114.1
 
 ### Refactors

From c8e644d19e688e00e51cdca2c1bb15d274d70801 Mon Sep 17 00:00:00 2001
From: Max Scheijen <47034840+maxscheijen@users.noreply.github.com>
Date: Thu, 12 Sep 2024 19:00:36 +0200
Subject: [PATCH 126/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Dutch=20translatio?=
 =?UTF-8?q?n=20for=20`docs/nl/docs/python-types.md`=20(#12158)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/nl/docs/python-types.md | 597 +++++++++++++++++++++++++++++++++++
 1 file changed, 597 insertions(+)
 create mode 100644 docs/nl/docs/python-types.md

diff --git a/docs/nl/docs/python-types.md b/docs/nl/docs/python-types.md
new file mode 100644
index 000000000..a5562b795
--- /dev/null
+++ b/docs/nl/docs/python-types.md
@@ -0,0 +1,597 @@
+# Introductie tot Python Types
+
+Python biedt ondersteuning voor optionele "type hints" (ook wel "type annotaties" genoemd).
+
+Deze **"type hints"** of annotaties zijn een speciale syntax waarmee het <abbr title="bijvoorbeeld: str, int, float, bool">type</abbr> van een variabele kan worden gedeclareerd.
+
+Door types voor je variabelen te declareren, kunnen editors en hulpmiddelen je beter ondersteunen.
+
+Dit is slechts een **korte tutorial/opfrisser** over Python type hints. Het behandelt enkel het minimum dat nodig is om ze te gebruiken met **FastAPI**... en dat is relatief weinig.
+
+**FastAPI** is helemaal gebaseerd op deze type hints, ze geven veel voordelen.
+
+Maar zelfs als je **FastAPI** nooit gebruikt, heb je er baat bij om er iets over te leren.
+
+/// note
+
+Als je een Python expert bent en alles al weet over type hints, sla dan dit hoofdstuk over.
+
+///
+
+## Motivatie
+
+Laten we beginnen met een eenvoudig voorbeeld:
+
+```Python
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+Het aanroepen van dit programma leidt tot het volgende resultaat:
+
+```
+John Doe
+```
+
+De functie voert het volgende uit:
+
+* Neem een `first_name` en een `last_name`
+* Converteer de eerste letter van elk naar een hoofdletter met `title()`.
+``
+* <abbr title="Voegt ze samen, als één. Met de inhoud van de een na de ander.">Voeg samen</abbr> met een spatie in het midden.
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+### Bewerk het
+
+Dit is een heel eenvoudig programma.
+
+Maar stel je nu voor dat je het vanaf nul zou moeten maken.
+
+Op een gegeven moment zou je aan de definitie van de functie zijn begonnen, je had de parameters klaar...
+
+Maar dan moet je “die methode die de eerste letter naar hoofdletters converteert” aanroepen.
+
+Was het `upper`? Was het `uppercase`? `first_uppercase`? `capitalize`?
+
+Dan roep je de hulp in van je oude programmeursvriend, (automatische) code aanvulling in je editor.
+
+Je typt de eerste parameter van de functie, `first_name`, dan een punt (`.`) en drukt dan op `Ctrl+Spatie` om de aanvulling te activeren.
+
+Maar helaas krijg je niets bruikbaars:
+
+<img src="/img/python-types/image01.png">
+
+### Types toevoegen
+
+Laten we een enkele regel uit de vorige versie aanpassen.
+
+We zullen precies dit fragment, de parameters van de functie, wijzigen van:
+
+```Python
+    first_name, last_name
+```
+
+naar:
+
+```Python
+    first_name: str, last_name: str
+```
+
+Dat is alles.
+
+Dat zijn de "type hints":
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial002.py!}
+```
+
+Dit is niet hetzelfde als het declareren van standaardwaarden zoals bij:
+
+```Python
+    first_name="john", last_name="doe"
+```
+
+Het is iets anders.
+
+We gebruiken dubbele punten (`:`), geen gelijkheidstekens (`=`).
+
+Het toevoegen van type hints verandert normaal gesproken niet wat er gebeurt in je programma t.o.v. wat er zonder type hints zou gebeuren.
+
+Maar stel je voor dat je weer bezig bent met het maken van een functie, maar deze keer met type hints.
+
+Op hetzelfde moment probeer je de automatische aanvulling te activeren met `Ctrl+Spatie` en je ziet:
+
+<img src="/img/python-types/image02.png">
+
+Nu kun je de opties bekijken en er doorheen scrollen totdat je de optie vindt die “een belletje doet rinkelen”:
+
+<img src="/img/python-types/image03.png">
+
+### Meer motivatie
+
+Bekijk deze functie, deze heeft al type hints:
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial003.py!}
+```
+
+Omdat de editor de types van de variabelen kent, krijgt u niet alleen aanvulling, maar ook controles op fouten:
+
+<img src="/img/python-types/image04.png">
+
+Nu weet je hoe je het moet oplossen, converteer `age` naar een string met `str(age)`:
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial004.py!}
+```
+
+## Types declareren
+
+Je hebt net de belangrijkste plek om type hints te declareren gezien. Namelijk als functieparameters.
+
+Dit is ook de belangrijkste plek waar je ze gebruikt met **FastAPI**.
+
+### Eenvoudige types
+
+Je kunt alle standaard Python types declareren, niet alleen `str`.
+
+Je kunt bijvoorbeeld het volgende gebruiken:
+
+* `int`
+* `float`
+* `bool`
+* `bytes`
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial005.py!}
+```
+
+### Generieke types met typeparameters
+
+Er zijn enkele datastructuren die andere waarden kunnen bevatten, zoals `dict`, `list`, `set` en `tuple` en waar ook de interne waarden hun eigen type kunnen hebben.
+
+Deze types die interne types hebben worden “**generieke**” types genoemd. Het is mogelijk om ze te declareren, zelfs met hun interne types.
+
+Om deze types en de interne types te declareren, kun je de standaard Python module `typing` gebruiken. Deze module is speciaal gemaakt om deze type hints te ondersteunen.
+
+#### Nieuwere versies van Python
+
+De syntax met `typing` is **verenigbaar** met alle versies, van Python 3.6 tot aan de nieuwste, inclusief Python 3.9, Python 3.10, enz.
+
+Naarmate Python zich ontwikkelt, worden **nieuwere versies**, met verbeterde ondersteuning voor deze type annotaties, beschikbaar. In veel gevallen hoef je niet eens de `typing` module te importeren en te gebruiken om de type annotaties te declareren.
+
+Als je een recentere versie van Python kunt kiezen voor je project, kun je profiteren van die extra eenvoud.
+
+In alle documentatie staan voorbeelden die compatibel zijn met elke versie van Python (als er een verschil is).
+
+Bijvoorbeeld “**Python 3.6+**” betekent dat het compatibel is met Python 3.6 of hoger (inclusief 3.7, 3.8, 3.9, 3.10, etc). En “**Python 3.9+**” betekent dat het compatibel is met Python 3.9 of hoger (inclusief 3.10, etc).
+
+Als je de **laatste versies van Python** kunt gebruiken, gebruik dan de voorbeelden voor de laatste versie, die hebben de **beste en eenvoudigste syntax**, bijvoorbeeld “**Python 3.10+**”.
+
+#### List
+
+Laten we bijvoorbeeld een variabele definiëren als een `list` van `str`.
+
+//// tab | Python 3.9+
+
+Declareer de variabele met dezelfde dubbele punt (`:`) syntax.
+
+Als type, vul `list` in.
+
+Doordat de list een type is dat enkele interne types bevat, zet je ze tussen vierkante haakjes:
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial006_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+Van `typing`, importeer `List` (met een hoofdletter `L`):
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial006.py!}
+```
+
+Declareer de variabele met dezelfde dubbele punt (`:`) syntax.
+
+Zet als type de `List` die je hebt geïmporteerd uit `typing`.
+
+Doordat de list een type is dat enkele interne types bevat, zet je ze tussen vierkante haakjes:
+
+```Python hl_lines="4"
+{!> ../../../docs_src/python_types/tutorial006.py!}
+```
+
+////
+
+/// info
+
+De interne types tussen vierkante haakjes worden “typeparameters” genoemd.
+
+In dit geval is `str` de typeparameter die wordt doorgegeven aan `List` (of `list` in Python 3.9 en hoger).
+
+///
+
+Dat betekent: “de variabele `items` is een `list`, en elk van de items in deze list is een `str`”.
+
+/// tip
+
+Als je Python 3.9 of hoger gebruikt, hoef je `List` niet te importeren uit `typing`, je kunt in plaats daarvan hetzelfde reguliere `list` type gebruiken.
+
+///
+
+Door dat te doen, kan je editor ondersteuning bieden, zelfs tijdens het verwerken van items uit de list:
+
+<img src="/img/python-types/image05.png">
+
+Zonder types is dat bijna onmogelijk om te bereiken.
+
+Merk op dat de variabele `item` een van de elementen is in de lijst `items`.
+
+Toch weet de editor dat het een `str` is, en biedt daar vervolgens ondersteuning voor aan.
+
+#### Tuple en Set
+
+Je kunt hetzelfde doen om `tuple`s en `set`s te declareren:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial007_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1  4"
+{!> ../../../docs_src/python_types/tutorial007.py!}
+```
+
+////
+
+Dit betekent:
+
+* De variabele `items_t` is een `tuple` met 3 items, een `int`, nog een `int`, en een `str`.
+* De variabele `items_s` is een `set`, en elk van de items is van het type `bytes`.
+
+#### Dict
+
+Om een `dict` te definiëren, geef je 2 typeparameters door, gescheiden door komma's.
+
+De eerste typeparameter is voor de sleutels (keys) van de `dict`.
+
+De tweede typeparameter is voor de waarden  (values) van het `dict`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial008_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1  4"
+{!> ../../../docs_src/python_types/tutorial008.py!}
+```
+
+////
+
+Dit betekent:
+
+* De variabele `prices` is een `dict`:
+    * De sleutels van dit `dict` zijn van het type `str` (bijvoorbeeld de naam van elk item).
+    * De waarden van dit `dict` zijn van het type `float` (bijvoorbeeld de prijs van elk item).
+
+#### Union
+
+Je kunt een variable declareren die van **verschillende types** kan zijn, bijvoorbeeld een `int` of een `str`.
+
+In Python 3.6 en hoger (inclusief Python 3.10) kun je het `Union`-type van `typing` gebruiken en de mogelijke types die je wilt accepteren, tussen de vierkante haakjes zetten.
+
+In Python 3.10 is er ook een **nieuwe syntax** waarin je de mogelijke types kunt scheiden door een <abbr title='ook wel "bitwise of operator" genoemd, maar die betekenis is hier niet relevant'>verticale balk (`|`)</abbr>.
+
+//// tab | Python 3.10+
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1  4"
+{!> ../../../docs_src/python_types/tutorial008b.py!}
+```
+
+////
+
+In beide gevallen betekent dit dat `item` een `int` of een `str` kan zijn.
+
+#### Mogelijk `None`
+
+Je kunt declareren dat een waarde een type kan hebben, zoals `str`, maar dat het ook `None` kan zijn.
+
+In Python 3.6 en hoger (inclusief Python 3.10) kun je het declareren door `Optional` te importeren en te gebruiken vanuit de `typing`-module.
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009.py!}
+```
+
+Door `Optional[str]` te gebruiken in plaats van alleen `str`, kan de editor je helpen fouten te detecteren waarbij je ervan uit zou kunnen gaan dat een waarde altijd een `str` is, terwijl het in werkelijkheid ook `None` zou kunnen zijn.
+
+`Optional[EenType]` is eigenlijk een snelkoppeling voor `Union[EenType, None]`, ze zijn equivalent.
+
+Dit betekent ook dat je in Python 3.10 `EenType | None` kunt gebruiken:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial009_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1  4"
+{!> ../../../docs_src/python_types/tutorial009.py!}
+```
+
+////
+
+//// tab | Python 3.8+ alternative
+
+```Python hl_lines="1  4"
+{!> ../../../docs_src/python_types/tutorial009b.py!}
+```
+
+////
+
+#### Gebruik van `Union` of `Optional`
+
+Als je een Python versie lager dan 3.10 gebruikt, is dit een tip vanuit mijn **subjectieve** standpunt:
+
+* 🚨 Vermijd het gebruik van `Optional[EenType]`.
+* Gebruik in plaats daarvan **`Union[EenType, None]`** ✨.
+
+Beide zijn gelijkwaardig en onderliggend zijn ze hetzelfde, maar ik zou `Union` aanraden in plaats van `Optional` omdat het woord “**optional**” lijkt te impliceren dat de waarde optioneel is, en het eigenlijk betekent “het kan `None` zijn”, zelfs als het niet optioneel is en nog steeds vereist is.
+
+Ik denk dat `Union[SomeType, None]` explicieter is over wat het betekent.
+
+Het gaat alleen om de woorden en naamgeving. Maar die naamgeving kan invloed hebben op hoe jij en je teamgenoten over de code denken.
+
+Laten we als voorbeeld deze functie nemen:
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009c.py!}
+```
+
+De parameter `name` is gedefinieerd als `Optional[str]`, maar is **niet optioneel**, je kunt de functie niet aanroepen zonder de parameter:
+
+```Python
+say_hi()  # Oh, nee, dit geeft een foutmelding! 😱
+```
+
+De `name` parameter is **nog steeds vereist** (niet *optioneel*) omdat het geen standaardwaarde heeft. Toch accepteert `name` `None` als waarde:
+
+```Python
+say_hi(name=None)  # Dit werkt, None is geldig 🎉
+```
+
+Het goede nieuws is dat als je eenmaal Python 3.10 gebruikt, je je daar geen zorgen meer over hoeft te maken, omdat je dan gewoon `|` kunt gebruiken om unions van types te definiëren:
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009c_py310.py!}
+```
+
+Dan hoef je je geen zorgen te maken over namen als `Optional` en `Union`. 😎
+
+#### Generieke typen
+
+De types die typeparameters in vierkante haakjes gebruiken, worden **Generieke types** of **Generics** genoemd, bijvoorbeeld:
+
+//// tab | Python 3.10+
+
+Je kunt dezelfde ingebouwde types gebruiken als generics (met vierkante haakjes en types erin):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+Hetzelfde als bij Python 3.8, uit de `typing`-module:
+
+* `Union`
+* `Optional` (hetzelfde als bij Python 3.8)
+* ...en anderen.
+
+In Python 3.10 kun je , als alternatief voor de generieke `Union` en `Optional`, de <abbr title='ook wel "bitwise or operator" genoemd, maar die betekenis is hier niet relevant'>verticale lijn (`|`)</abbr> gebruiken om unions van typen te voorzien, dat is veel beter en eenvoudiger.
+
+////
+
+//// tab | Python 3.9+
+
+Je kunt dezelfde ingebouwde types gebruiken als generieke types (met vierkante haakjes en types erin):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+En hetzelfde als met Python 3.8, vanuit de `typing`-module:
+
+* `Union`
+* `Optional`
+* ...en anderen.
+
+////
+
+//// tab | Python 3.8+
+
+* `List`
+* `Tuple`
+* `Set`
+* `Dict`
+* `Union`
+* `Optional`
+* ...en anderen.
+
+////
+
+### Klassen als types
+
+Je kunt een klasse ook declareren als het type van een variabele.
+
+Stel dat je een klasse `Person` hebt, met een naam:
+
+```Python hl_lines="1-3"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+Vervolgens kun je een variabele van het type `Persoon` declareren:
+
+```Python hl_lines="6"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+Dan krijg je ook nog eens volledige editorondersteuning:
+
+<img src="/img/python-types/image06.png">
+
+Merk op dat dit betekent dat "`one_person` een **instantie** is van de klasse `Person`".
+
+Dit betekent niet dat `one_person` de **klasse** is met de naam `Person`.
+
+## Pydantic modellen
+
+<a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a> is een Python-pakket voor het uitvoeren van datavalidatie.
+
+Je declareert de "vorm" van de data als klassen met attributen.
+
+Elk attribuut heeft een type.
+
+Vervolgens maak je een instantie van die klasse met een aantal waarden en het valideert de waarden, converteert ze naar het juiste type (als dat het geval is) en geeft je een object met alle data terug.
+
+Daarnaast krijg je volledige editorondersteuning met dat resulterende object.
+
+Een voorbeeld uit de officiële Pydantic-documentatie:
+
+//// tab | Python 3.10+
+
+```Python
+{!> ../../../docs_src/python_types/tutorial011_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!> ../../../docs_src/python_types/tutorial011_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python
+{!> ../../../docs_src/python_types/tutorial011.py!}
+```
+
+////
+
+/// info
+
+Om meer te leren over <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic, bekijk de documentatie</a>.
+
+///
+
+**FastAPI** is volledig gebaseerd op Pydantic.
+
+Je zult veel meer van dit alles in de praktijk zien in de [Tutorial - Gebruikershandleiding](tutorial/index.md){.internal-link target=_blank}.
+
+/// tip
+
+Pydantic heeft een speciaal gedrag wanneer je `Optional` of `Union[EenType, None]` gebruikt zonder een standaardwaarde, je kunt er meer over lezen in de Pydantic-documentatie over <a href="https://docs.pydantic.dev/2.3/usage/models/#required-fields" class="external-link" target="_blank">Verplichte optionele velden</a>.
+
+///
+
+## Type Hints met Metadata Annotaties
+
+Python heeft ook een functie waarmee je **extra <abbr title="Data over de data, in dit geval informatie over het type, bijvoorbeeld een beschrijving.">metadata</abbr>** in deze type hints kunt toevoegen met behulp van `Annotated`.
+
+//// tab | Python 3.9+
+
+In Python 3.9 is `Annotated` onderdeel van de standaardpakket, dus je kunt het importeren vanuit `typing`.
+
+```Python hl_lines="1  4"
+{!> ../../../docs_src/python_types/tutorial013_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+In versies lager dan Python 3.9 importeer je `Annotated` vanuit `typing_extensions`.
+
+Het wordt al geïnstalleerd met **FastAPI**.
+
+```Python hl_lines="1  4"
+{!> ../../../docs_src/python_types/tutorial013.py!}
+```
+
+////
+
+Python zelf doet niets met deze `Annotated` en voor editors en andere hulpmiddelen is het type nog steeds een `str`.
+
+Maar je kunt deze ruimte in `Annotated` gebruiken om **FastAPI** te voorzien van extra metadata over hoe je wilt dat je applicatie zich gedraagt.
+
+Het belangrijkste om te onthouden is dat **de eerste *typeparameter*** die je doorgeeft aan `Annotated` het **werkelijke type** is. De rest is gewoon metadata voor andere hulpmiddelen.
+
+Voor nu hoef je alleen te weten dat `Annotated` bestaat en dat het standaard Python is. 😎
+
+Later zul je zien hoe **krachtig** het kan zijn.
+
+/// tip
+
+Het feit dat dit **standaard Python** is, betekent dat je nog steeds de **best mogelijke ontwikkelaarservaring** krijgt in je editor, met de hulpmiddelen die je gebruikt om je code te analyseren en te refactoren, enz. ✨
+
+Daarnaast betekent het ook dat je code zeer verenigbaar zal zijn met veel andere Python-hulpmiddelen en -pakketten. 🚀
+
+///
+
+## Type hints in **FastAPI**
+
+**FastAPI** maakt gebruik van type hints om verschillende dingen te doen.
+
+Met **FastAPI** declareer je parameters met type hints en krijg je:
+
+* **Editor ondersteuning**.
+* **Type checks**.
+
+...en **FastAPI** gebruikt dezelfde declaraties om:
+
+* **Vereisten te definïeren **: van request pad parameters, query parameters, headers, bodies, dependencies, enz.
+* **Data te converteren**: van de request naar het vereiste type.
+* **Data te valideren**: afkomstig van elke request:
+    * **Automatische foutmeldingen** te genereren die naar de client worden geretourneerd wanneer de data ongeldig is.
+* De API met OpenAPI te **documenteren**:
+    * die vervolgens wordt gebruikt door de automatische interactieve documentatie gebruikersinterfaces.
+
+Dit klinkt misschien allemaal abstract. Maak je geen zorgen. Je ziet dit allemaal in actie in de [Tutorial - Gebruikershandleiding](tutorial/index.md){.internal-link target=_blank}.
+
+Het belangrijkste is dat door standaard Python types te gebruiken, op één plek (in plaats van meer klassen, decorators, enz. toe te voegen), **FastAPI** een groot deel van het werk voor je doet.
+
+/// info
+
+Als je de hele tutorial al hebt doorgenomen en terug bent gekomen om meer te weten te komen over types, is een goede bron <a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">het "cheat sheet" van `mypy`</a>.
+
+///

From 492943fdb1f726800ab7a42ead08e297813c8e68 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 12 Sep 2024 17:01:01 +0000
Subject: [PATCH 127/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 01c9fb225..c3bf2bb8d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Translations
+
+* 🌐 Add Dutch translation for `docs/nl/docs/python-types.md`. PR [#12158](https://github.com/fastapi/fastapi/pull/12158) by [@maxscheijen](https://github.com/maxscheijen).
+
 ### Internal
 
 * ➕ Add inline-snapshot for tests. PR [#12189](https://github.com/fastapi/fastapi/pull/12189) by [@tiangolo](https://github.com/tiangolo).

From 4a94fe3c8249e2c13999964ac9f707ab0ca069ee Mon Sep 17 00:00:00 2001
From: Waket Zheng <waketzheng@gmail.com>
Date: Fri, 13 Sep 2024 01:01:54 +0800
Subject: [PATCH 128/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Chinese=20translat?=
 =?UTF-8?q?ion=20for=20`docs/zh/docs/project-generation.md`=20(#12170)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/zh/docs/project-generation.md | 112 ++++++++---------------------
 1 file changed, 28 insertions(+), 84 deletions(-)

diff --git a/docs/zh/docs/project-generation.md b/docs/zh/docs/project-generation.md
index 0655cb0a9..9b3735539 100644
--- a/docs/zh/docs/project-generation.md
+++ b/docs/zh/docs/project-generation.md
@@ -1,84 +1,28 @@
-# 项目生成 - 模板
-
-项目生成器一般都会提供很多初始设置、安全措施、数据库，甚至还准备好了第一个 API 端点，能帮助您快速上手。
-
-项目生成器的设置通常都很主观，您可以按需更新或修改，但对于您的项目来说，它是非常好的起点。
-
-## 全栈 FastAPI + PostgreSQL
-
-GitHub：<a href="https://github.com/tiangolo/full-stack-fastapi-postgresql" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-fastapi-postgresql</a>
-
-### 全栈 FastAPI + PostgreSQL - 功能
-
-* 完整的 **Docker** 集成（基于 Docker）
-* Docker Swarm 开发模式
-* **Docker Compose** 本地开发集成与优化
-* **生产可用**的 Python 网络服务器，使用 Uvicorn 或 Gunicorn
-* Python <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">**FastAPI**</a> 后端：
-* * **速度快**：可与 **NodeJS** 和 **Go** 比肩的极高性能（归功于 Starlette 和 Pydantic）
-    * **直观**：强大的编辑器支持，处处皆可<abbr title="也叫自动完成、智能感知">自动补全</abbr>，减少调试时间
-    * **简单**：易学、易用，阅读文档所需时间更短
-    * **简短**：代码重复最小化，每次参数声明都可以实现多个功能
-    * **健壮**： 生产级别的代码，还有自动交互文档
-    * **基于标准**：完全兼容并基于 API 开放标准：<a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a> 和 <a href="https://json-schema.org/" class="external-link" target="_blank">JSON Schema</a>
-    * <a href="https://fastapi.tiangolo.com/features/" class="external-link" target="_blank">**更多功能**</a>包括自动验证、序列化、交互文档、OAuth2 JWT 令牌身份验证等
-* **安全密码**，默认使用密码哈希
-* **JWT 令牌**身份验证
-* **SQLAlchemy** 模型（独立于 Flask 扩展，可直接用于 Celery Worker）
-* 基础的用户模型（可按需修改或删除）
-* **Alembic** 迁移
-* **CORS**（跨域资源共享）
-* **Celery** Worker 可从后端其它部分有选择地导入并使用模型和代码
-* REST 后端测试基于 Pytest，并与 Docker 集成，可独立于数据库实现完整的 API 交互测试。因为是在 Docker 中运行，每次都可从头构建新的数据存储（使用 ElasticSearch、MongoDB、CouchDB 等数据库，仅测试 API 运行）
-* Python 与 **Jupyter Kernels** 集成，用于远程或 Docker 容器内部开发，使用 Atom Hydrogen 或 Visual Studio Code 的 Jupyter 插件
-* **Vue** 前端：
-    * 由 Vue CLI 生成
-    * **JWT 身份验证**处理
-    * 登录视图
-    * 登录后显示主仪表盘视图
-    * 主仪表盘支持用户创建与编辑
-    * 用户信息编辑
-    * **Vuex**
-    * **Vue-router**
-    * **Vuetify** 美化组件
-    * **TypeScript**
-    * 基于 **Nginx** 的 Docker 服务器（优化了 Vue-router 配置）
-    * Docker 多阶段构建，无需保存或提交编译的代码
-    * 在构建时运行前端测试（可禁用）
-    * 尽量模块化，开箱即用，但仍可使用 Vue CLI 重新生成或创建所需项目，或复用所需内容
-* 使用 **PGAdmin** 管理 PostgreSQL 数据库，可轻松替换为 PHPMyAdmin 或 MySQL
-* 使用 **Flower** 监控 Celery 任务
-* 使用 **Traefik** 处理前后端负载平衡，可把前后端放在同一个域下，按路径分隔，但在不同容器中提供服务
-* Traefik 集成，包括自动生成 Let's Encrypt **HTTPS** 凭证
-* GitLab **CI**（持续集成），包括前后端测试
-
-## 全栈 FastAPI + Couchbase
-
-GitHub：<a href="https://github.com/tiangolo/full-stack-fastapi-couchbase" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-fastapi-couchbase</a>
-
-⚠️ **警告** ⚠️
-
-如果您想从头开始创建新项目，建议使用以下备选方案。
-
-例如，项目生成器<a href="https://github.com/tiangolo/full-stack-fastapi-postgresql" class="external-link" target="_blank">全栈 FastAPI + PostgreSQL </a>会更适用，这个项目的维护积极，用的人也多，还包括了所有新功能和改进内容。
-
-当然，您也可以放心使用这个基于 Couchbase 的生成器，它也能正常使用。就算用它生成项目也没有任何问题（为了更好地满足需求，您可以自行更新这个项目）。
-
-详见资源仓库中的文档。
-
-## 全栈 FastAPI + MongoDB
-
-……敬请期待，得看我有没有时间做这个项目。😅 🎉
-
-## FastAPI + spaCy 机器学习模型
-
-GitHub：<a href="https://github.com/microsoft/cookiecutter-spacy-fastapi" class="external-link" target="_blank">https://github.com/microsoft/cookiecutter-spacy-fastapi</a>
-
-### FastAPI + spaCy 机器学习模型 - 功能
-
-* 集成 **spaCy** NER 模型
-* 内置 **Azure 认知搜索**请求格式
-* **生产可用**的 Python 网络服务器，使用 Uvicorn 与 Gunicorn
-* 内置 **Azure DevOps** Kubernetes (AKS) CI/CD 开发
-* **多语**支持，可在项目设置时选择 spaCy 内置的语言
-* 不仅局限于 spaCy，可**轻松扩展**至其它模型框架（Pytorch、TensorFlow）
+# FastAPI全栈模板
+
+模板通常带有特定的设置，而且被设计为灵活和可定制的。这允许您根据项目的需求修改和调整它们，使它们成为一个很好的起点。🏁
+
+您可以使用此模板开始，因为它包含了许多已经为您完成的初始设置、安全性、数据库和一些API端点。
+
+代码仓： <a href="https://github.com/fastapi/full-stack-fastapi-template" class="external-link" target="_blank">Full Stack FastAPI Template</a>
+
+## FastAPI全栈模板 - 技术栈和特性
+
+- ⚡ [**FastAPI**](https://fastapi.tiangolo.com) 用于Python后端API.
+    - 🧰 [SQLModel](https://sqlmodel.tiangolo.com) 用于Python和SQL数据库的集成（ORM）。
+    - 🔍 [Pydantic](https://docs.pydantic.dev) FastAPI的依赖项之一，用于数据验证和配置管理。
+    - 💾 [PostgreSQL](https://www.postgresql.org) 作为SQL数据库。
+- 🚀 [React](https://react.dev) 用于前端。
+    - 💃 使用了TypeScript、hooks、Vite和其他一些现代化的前端技术栈。
+    - 🎨 [Chakra UI](https://chakra-ui.com) 用于前端组件。
+    - 🤖 一个自动化生成的前端客户端。
+    - 🧪 Playwright用于端到端测试。
+    - 🦇 支持暗黑主题（Dark mode）。
+- 🐋 [Docker Compose](https://www.docker.com) 用于开发环境和生产环境。
+- 🔒 默认使用密码哈希来保证安全。
+- 🔑 JWT令牌用于权限验证。
+- 📫 使用邮箱来进行密码恢复。
+- ✅ 单元测试用了[Pytest](https://pytest.org).
+- 📞 [Traefik](https://traefik.io) 用于反向代理和负载均衡。
+- 🚢 部署指南（Docker Compose）包含了如何起一个Traefik前端代理来自动化HTTPS认证。
+- 🏭 CI（持续集成）和 CD（持续部署）基于GitHub Actions。

From 93e50e373b0651c22a6743a4e907dafbadc8d27e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 12 Sep 2024 17:03:26 +0000
Subject: [PATCH 129/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c3bf2bb8d..ac2398759 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Chinese translation for `docs/zh/docs/project-generation.md`. PR [#12170](https://github.com/fastapi/fastapi/pull/12170) by [@waketzheng](https://github.com/waketzheng).
 * 🌐 Add Dutch translation for `docs/nl/docs/python-types.md`. PR [#12158](https://github.com/fastapi/fastapi/pull/12158) by [@maxscheijen](https://github.com/maxscheijen).
 
 ### Internal

From e50facaf227f4725d64c7166c2fe3438367705c7 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Thu, 12 Sep 2024 14:03:48 -0300
Subject: [PATCH 130/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/request-form-models.md`?=
 =?UTF-8?q?=20(#12175)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/pt/docs/tutorial/request-form-models.md | 134 +++++++++++++++++++
 1 file changed, 134 insertions(+)
 create mode 100644 docs/pt/docs/tutorial/request-form-models.md

diff --git a/docs/pt/docs/tutorial/request-form-models.md b/docs/pt/docs/tutorial/request-form-models.md
new file mode 100644
index 000000000..a9db18e9d
--- /dev/null
+++ b/docs/pt/docs/tutorial/request-form-models.md
@@ -0,0 +1,134 @@
+# Modelos de Formulários
+
+Você pode utilizar **Modelos Pydantic** para declarar **campos de formulários** no FastAPI.
+
+/// info | "Informação"
+
+Para utilizar formulários, instale primeiramente o <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
+
+Certifique-se de criar um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, ativá-lo, e então instalar. Por exemplo:
+
+```console
+$ pip install python-multipart
+```
+
+///
+
+/// note | "Nota"
+
+Isto é suportado desde a versão `0.113.0` do FastAPI. 🤓
+
+///
+
+## Modelos Pydantic para Formulários
+
+Você precisa apenas declarar um **modelo Pydantic** com os campos que deseja receber como **campos de formulários**, e então declarar o parâmetro como um `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 | "Dica"
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="7-9  13"
+{!> ../../../docs_src/request_form_models/tutorial001.py!}
+```
+
+////
+
+O **FastAPI** irá **extrair** as informações para **cada campo** dos **dados do formulário** na requisição e dar para você o modelo Pydantic que você definiu.
+
+## Confira os Documentos
+
+Você pode verificar na UI de documentação em `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/request-form-models/image01.png">
+</div>
+
+## Proibir Campos Extras de Formulários
+
+Em alguns casos de uso especiais (provavelmente não muito comum), você pode desejar **restringir** os campos do formulário para aceitar apenas os declarados no modelo Pydantic. E **proibir** qualquer campo **extra**.
+
+/// note | "Nota"
+
+Isso é suportado deste a versão `0.114.0` do FastAPI. 🤓
+
+///
+
+Você pode utilizar a configuração de modelo do Pydantic para `proibir` qualquer campo `extra`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="12"
+{!> ../../../docs_src/request_form_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/request_form_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/request_form_models/tutorial002.py!}
+```
+
+////
+
+Caso um cliente tente enviar informações adicionais, ele receberá um retorno de **erro**.
+
+Por exemplo, se o cliente tentar enviar os campos de formulário:
+
+* `username`: `Rick`
+* `password`: `Portal Gun`
+* `extra`: `Mr. Poopybutthole`
+
+Ele receberá um retorno de erro informando-o que o campo `extra` não é permitido:
+
+```json
+{
+    "detail": [
+        {
+            "type": "extra_forbidden",
+            "loc": ["body", "extra"],
+            "msg": "Extra inputs are not permitted",
+            "input": "Mr. Poopybutthole"
+        }
+    ]
+}
+```
+
+## Resumo
+
+Você pode utilizar modelos Pydantic para declarar campos de formulários no FastAPI. 😎

From ed66d705139b67665db1742797fdbeba7490c0e2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 12 Sep 2024 17:06:34 +0000
Subject: [PATCH 131/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ac2398759..6534adb03 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request-form-models.md`. PR [#12175](https://github.com/fastapi/fastapi/pull/12175) by [@ceb10n](https://github.com/ceb10n).
 * 🌐 Add Chinese translation for `docs/zh/docs/project-generation.md`. PR [#12170](https://github.com/fastapi/fastapi/pull/12170) by [@waketzheng](https://github.com/waketzheng).
 * 🌐 Add Dutch translation for `docs/nl/docs/python-types.md`. PR [#12158](https://github.com/fastapi/fastapi/pull/12158) by [@maxscheijen](https://github.com/maxscheijen).
 

From 2a4351105ed968002ad15530dec35c6bb453a042 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 13 Sep 2024 11:14:46 +0200
Subject: [PATCH 132/146] =?UTF-8?q?=F0=9F=92=A1=20Add=20comments=20with=20?=
 =?UTF-8?q?instructions=20for=20Playwright=20screenshot=20scripts=20(#1219?=
 =?UTF-8?q?3)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 scripts/playwright/request_form_models/image01.py      | 4 +++-
 scripts/playwright/separate_openapi_schemas/image01.py | 3 +++
 scripts/playwright/separate_openapi_schemas/image02.py | 3 +++
 scripts/playwright/separate_openapi_schemas/image03.py | 3 +++
 scripts/playwright/separate_openapi_schemas/image04.py | 3 +++
 scripts/playwright/separate_openapi_schemas/image05.py | 3 +++
 6 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/scripts/playwright/request_form_models/image01.py b/scripts/playwright/request_form_models/image01.py
index 15bd3858c..fe4da32fc 100644
--- a/scripts/playwright/request_form_models/image01.py
+++ b/scripts/playwright/request_form_models/image01.py
@@ -8,11 +8,13 @@ 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()
+    # Update the viewport manually
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
     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()
+    # Manually add the screenshot
     page.screenshot(path="docs/en/docs/img/tutorial/request-form-models/image01.png")
 
     # ---------------------
diff --git a/scripts/playwright/separate_openapi_schemas/image01.py b/scripts/playwright/separate_openapi_schemas/image01.py
index 0b40f3bbc..0eb55fb73 100644
--- a/scripts/playwright/separate_openapi_schemas/image01.py
+++ b/scripts/playwright/separate_openapi_schemas/image01.py
@@ -3,13 +3,16 @@ import subprocess
 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)
+    # Update the viewport manually
     context = browser.new_context(viewport={"width": 960, "height": 1080})
     page = context.new_page()
     page.goto("http://localhost:8000/docs")
     page.get_by_text("POST/items/Create Item").click()
     page.get_by_role("tab", name="Schema").first.click()
+    # Manually add the screenshot
     page.screenshot(
         path="docs/en/docs/img/tutorial/separate-openapi-schemas/image01.png"
     )
diff --git a/scripts/playwright/separate_openapi_schemas/image02.py b/scripts/playwright/separate_openapi_schemas/image02.py
index f76af7ee2..0eb6c3c79 100644
--- a/scripts/playwright/separate_openapi_schemas/image02.py
+++ b/scripts/playwright/separate_openapi_schemas/image02.py
@@ -3,14 +3,17 @@ import subprocess
 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)
+    # Update the viewport manually
     context = browser.new_context(viewport={"width": 960, "height": 1080})
     page = context.new_page()
     page.goto("http://localhost:8000/docs")
     page.get_by_text("GET/items/Read Items").click()
     page.get_by_role("button", name="Try it out").click()
     page.get_by_role("button", name="Execute").click()
+    # Manually add the screenshot
     page.screenshot(
         path="docs/en/docs/img/tutorial/separate-openapi-schemas/image02.png"
     )
diff --git a/scripts/playwright/separate_openapi_schemas/image03.py b/scripts/playwright/separate_openapi_schemas/image03.py
index 127f5c428..b68e9d7db 100644
--- a/scripts/playwright/separate_openapi_schemas/image03.py
+++ b/scripts/playwright/separate_openapi_schemas/image03.py
@@ -3,14 +3,17 @@ import subprocess
 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)
+    # Update the viewport manually
     context = browser.new_context(viewport={"width": 960, "height": 1080})
     page = context.new_page()
     page.goto("http://localhost:8000/docs")
     page.get_by_text("GET/items/Read Items").click()
     page.get_by_role("tab", name="Schema").click()
     page.get_by_label("Schema").get_by_role("button", name="Expand all").click()
+    # Manually add the screenshot
     page.screenshot(
         path="docs/en/docs/img/tutorial/separate-openapi-schemas/image03.png"
     )
diff --git a/scripts/playwright/separate_openapi_schemas/image04.py b/scripts/playwright/separate_openapi_schemas/image04.py
index 208eaf8a0..a36c2f6b2 100644
--- a/scripts/playwright/separate_openapi_schemas/image04.py
+++ b/scripts/playwright/separate_openapi_schemas/image04.py
@@ -3,14 +3,17 @@ import subprocess
 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)
+    # Update the viewport manually
     context = browser.new_context(viewport={"width": 960, "height": 1080})
     page = context.new_page()
     page.goto("http://localhost:8000/docs")
     page.get_by_role("button", name="Item-Input").click()
     page.get_by_role("button", name="Item-Output").click()
     page.set_viewport_size({"width": 960, "height": 820})
+    # Manually add the screenshot
     page.screenshot(
         path="docs/en/docs/img/tutorial/separate-openapi-schemas/image04.png"
     )
diff --git a/scripts/playwright/separate_openapi_schemas/image05.py b/scripts/playwright/separate_openapi_schemas/image05.py
index 83966b449..0da5db0cf 100644
--- a/scripts/playwright/separate_openapi_schemas/image05.py
+++ b/scripts/playwright/separate_openapi_schemas/image05.py
@@ -3,13 +3,16 @@ import subprocess
 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)
+    # Update the viewport manually
     context = browser.new_context(viewport={"width": 960, "height": 1080})
     page = context.new_page()
     page.goto("http://localhost:8000/docs")
     page.get_by_role("button", name="Item", exact=True).click()
     page.set_viewport_size({"width": 960, "height": 700})
+    # Manually add the screenshot
     page.screenshot(
         path="docs/en/docs/img/tutorial/separate-openapi-schemas/image05.png"
     )

From 0fc6e34135b2436a8749f5aa3b8f8ad92da106d5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 13 Sep 2024 09:15:10 +0000
Subject: [PATCH 133/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6534adb03..f00c3fed3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -15,6 +15,7 @@ hide:
 
 ### Internal
 
+* 💡 Add comments with instructions for Playwright screenshot scripts. PR [#12193](https://github.com/fastapi/fastapi/pull/12193) by [@tiangolo](https://github.com/tiangolo).
 * ➕ Add inline-snapshot for tests. PR [#12189](https://github.com/fastapi/fastapi/pull/12189) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.114.1

From 88d4f2cb1814392f54011b2bbd3fe55c5f2a3278 Mon Sep 17 00:00:00 2001
From: Nico Tonnhofer <github@wurstnase.de>
Date: Fri, 13 Sep 2024 11:51:00 +0200
Subject: [PATCH 134/146] =?UTF-8?q?=F0=9F=90=9B=20Fix=20form=20field=20reg?=
 =?UTF-8?q?ression=20(#12194)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/dependencies/utils.py    |  2 +-
 tests/test_forms_single_model.py | 10 +++++++---
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index f18eace9d..7548cf0c7 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -788,7 +788,7 @@ async def _extract_form_body(
                     tg.start_soon(process_fn, sub_value.read)
             value = serialize_sequence_value(field=field, value=results)
         if value is not None:
-            values[field.name] = value
+            values[field.alias] = value
     for key, value in received_body.items():
         if key not in values:
             values[key] = value
diff --git a/tests/test_forms_single_model.py b/tests/test_forms_single_model.py
index 7ed3ba3a2..880ab3820 100644
--- a/tests/test_forms_single_model.py
+++ b/tests/test_forms_single_model.py
@@ -3,7 +3,7 @@ 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 pydantic import BaseModel, Field
 from typing_extensions import Annotated
 
 app = FastAPI()
@@ -14,6 +14,7 @@ class FormModel(BaseModel):
     lastname: str
     age: Optional[int] = None
     tags: List[str] = ["foo", "bar"]
+    alias_with: str = Field(alias="with", default="nothing")
 
 
 @app.post("/form/")
@@ -32,6 +33,7 @@ def test_send_all_data():
             "lastname": "Sanchez",
             "age": "70",
             "tags": ["plumbus", "citadel"],
+            "with": "something",
         },
     )
     assert response.status_code == 200, response.text
@@ -40,6 +42,7 @@ def test_send_all_data():
         "lastname": "Sanchez",
         "age": 70,
         "tags": ["plumbus", "citadel"],
+        "with": "something",
     }
 
 
@@ -51,6 +54,7 @@ def test_defaults():
         "lastname": "Sanchez",
         "age": None,
         "tags": ["foo", "bar"],
+        "with": "nothing",
     }
 
 
@@ -100,13 +104,13 @@ def test_no_data():
                     "type": "missing",
                     "loc": ["body", "username"],
                     "msg": "Field required",
-                    "input": {"tags": ["foo", "bar"]},
+                    "input": {"tags": ["foo", "bar"], "with": "nothing"},
                 },
                 {
                     "type": "missing",
                     "loc": ["body", "lastname"],
                     "msg": "Field required",
-                    "input": {"tags": ["foo", "bar"]},
+                    "input": {"tags": ["foo", "bar"], "with": "nothing"},
                 },
             ]
         }

From 3a5fd71f5596ad7437394597fc09f1b8e8ec73f2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 13 Sep 2024 09:51:26 +0000
Subject: [PATCH 135/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f00c3fed3..9370a1f3f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Fixes
+
+* 🐛 Fix form field regression with `alias`. PR [#12194](https://github.com/fastapi/fastapi/pull/12194) by [@Wurstnase](https://github.com/Wurstnase).
+
 ### Translations
 
 * 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request-form-models.md`. PR [#12175](https://github.com/fastapi/fastapi/pull/12175) by [@ceb10n](https://github.com/ceb10n).

From 2ada1615a338a415a0ad7a9b879a1e7c09b9cce6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 13 Sep 2024 22:46:33 +0200
Subject: [PATCH 136/146] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
 =?UTF-8?q?4.2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 fastapi/__init__.py           | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9370a1f3f..3f0b60fd3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.114.2
+
 ### Fixes
 
 * 🐛 Fix form field regression with `alias`. PR [#12194](https://github.com/fastapi/fastapi/pull/12194) by [@Wurstnase](https://github.com/Wurstnase).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index c2ed4859a..3925d3603 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.114.1"
+__version__ = "0.114.2"
 
 from starlette import status as status
 

From 8eb3c5621ff2b946e7dd7a1a7ffd709e27de9ac6 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Sun, 15 Sep 2024 16:04:17 -0300
Subject: [PATCH 137/146] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/security/http-basic-auth.?=
 =?UTF-8?q?md`=20(#12195)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../docs/advanced/security/http-basic-auth.md | 192 ++++++++++++++++++
 1 file changed, 192 insertions(+)
 create mode 100644 docs/pt/docs/advanced/security/http-basic-auth.md

diff --git a/docs/pt/docs/advanced/security/http-basic-auth.md b/docs/pt/docs/advanced/security/http-basic-auth.md
new file mode 100644
index 000000000..12b8ab01c
--- /dev/null
+++ b/docs/pt/docs/advanced/security/http-basic-auth.md
@@ -0,0 +1,192 @@
+# HTTP Basic Auth
+
+Para os casos mais simples, você pode utilizar o HTTP Basic Auth.
+
+No HTTP Basic Auth, a aplicação espera um cabeçalho que contém um usuário e uma senha.
+
+Caso ela não receba, ela retorna um erro HTTP 401 "Unauthorized" (*Não Autorizado*).
+
+E retorna um cabeçalho `WWW-Authenticate` com o valor `Basic`, e um parâmetro opcional `realm`.
+
+Isso sinaliza ao navegador para mostrar o prompt integrado para um usuário e senha.
+
+Então, quando você digitar o usuário e senha, o navegador os envia automaticamente no cabeçalho.
+
+## HTTP Basic Auth Simples
+
+* Importe `HTTPBasic` e `HTTPBasicCredentials`.
+* Crie um "esquema `security`" utilizando `HTTPBasic`.
+* Utilize o `security` com uma dependência em sua *operação de rota*.
+* Isso retorna um objeto do tipo `HTTPBasicCredentials`:
+    * Isto contém o `username` e o `password` enviado.
+
+//// tab | Python 3.9+
+
+```Python hl_lines="4  8  12"
+{!> ../../../docs_src/security/tutorial006_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="2  7  11"
+{!> ../../../docs_src/security/tutorial006_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="2  6  10"
+{!> ../../../docs_src/security/tutorial006.py!}
+```
+
+////
+
+Quando você tentar abrir a URL pela primeira vez (ou clicar no botão "Executar" nos documentos) o navegador vai pedir pelo seu usuário e senha:
+
+<img src="/img/tutorial/security/image12.png">
+
+## Verifique o usuário
+
+Aqui está um exemplo mais completo.
+
+Utilize uma dependência para verificar se o usuário e a senha estão corretos.
+
+Para isso, utilize o módulo padrão do Python <a href="https://docs.python.org/3/library/secrets.html" class="external-link" target="_blank">`secrets`</a> para verificar o usuário e senha.
+
+O `secrets.compare_digest()` necessita receber `bytes` ou `str` que possuem apenas caracteres ASCII (os em Inglês). Isso significa que não funcionaria com caracteres como o `á`, como em `Sebastián`.
+
+Para lidar com isso, primeiramente nós convertemos o `username` e o `password` para `bytes`, codificando-os com UTF-8.
+
+Então nós podemos utilizar o `secrets.compare_digest()` para garantir que o `credentials.username` é `"stanleyjobson"`, e que o `credentials.password` é `"swordfish"`.
+
+//// tab | Python 3.9+
+
+```Python hl_lines="1  12-24"
+{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1  12-24"
+{!> ../../../docs_src/security/tutorial007_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="1  11-21"
+{!> ../../../docs_src/security/tutorial007.py!}
+```
+
+////
+
+Isso seria parecido com:
+
+```Python
+if not (credentials.username == "stanleyjobson") or not (credentials.password == "swordfish"):
+    # Return some error
+    ...
+```
+
+Porém ao utilizar o `secrets.compare_digest()`, isso estará seguro contra um tipo de ataque chamado "ataque de temporização (timing attacks)".
+
+### Ataques de Temporização
+
+Mas o que é um "ataque de temporização"?
+
+Vamos imaginar que alguns invasores estão tentando adivinhar o usuário e a senha.
+
+E eles enviam uma requisição com um usuário `johndoe` e uma senha `love123`.
+
+Então o código Python em sua aplicação seria equivalente a algo como:
+
+```Python
+if "johndoe" == "stanleyjobson" and "love123" == "swordfish":
+    ...
+```
+
+Mas no exato momento que o Python compara o primeiro `j` em `johndoe` contra o primeiro `s` em `stanleyjobson`, ele retornará `False`, porque ele já sabe que aquelas duas strings não são a mesma, pensando que "não existe a necessidade de desperdiçar mais poder computacional comparando o resto das letras". E a sua aplicação dirá "Usuário ou senha incorretos".
+
+Mas então os invasores vão tentar com o usuário `stanleyjobsox` e a senha `love123`.
+
+E a sua aplicação faz algo como:
+
+```Python
+if "stanleyjobsox" == "stanleyjobson" and "love123" == "swordfish":
+    ...
+```
+
+O Python terá que comparar todo o `stanleyjobso` tanto em `stanleyjobsox` como em `stanleyjobson` antes de perceber que as strings não são a mesma. Então isso levará alguns microsegundos a mais para retornar "Usuário ou senha incorretos".
+
+#### O tempo para responder ajuda os invasores
+
+Neste ponto, ao perceber que o servidor demorou alguns microsegundos a mais para enviar o retorno "Usuário ou senha incorretos", os invasores irão saber que eles acertaram _alguma coisa_, algumas das letras iniciais estavam certas.
+
+E eles podem tentar de novo sabendo que provavelmente é algo mais parecido com `stanleyjobsox` do que com `johndoe`.
+
+#### Um ataque "profissional"
+
+Claro, os invasores não tentariam tudo isso de forma manual, eles escreveriam um programa para fazer isso, possivelmente com milhares ou milhões de testes por segundo. E obteriam apenas uma letra a mais por vez.
+
+Mas fazendo isso, em alguns minutos ou horas os invasores teriam adivinhado o usuário e senha corretos, com a "ajuda" da nossa aplicação, apenas usando o tempo levado para responder.
+
+#### Corrija com o `secrets.compare_digest()`
+
+Mas em nosso código nós estamos utilizando o `secrets.compare_digest()`.
+
+Resumindo, levará o mesmo tempo para comparar `stanleyjobsox` com `stanleyjobson` do que comparar `johndoe` com `stanleyjobson`. E o mesmo para a senha.
+
+Deste modo, ao utilizar `secrets.compare_digest()` no código de sua aplicação, ela esterá a salvo contra toda essa gama de ataques de segurança.
+
+
+### Retorne o erro
+
+Depois de detectar que as credenciais estão incorretas, retorne um `HTTPException` com o status 401 (o mesmo retornado quando nenhuma credencial foi informada) e adicione o cabeçalho `WWW-Authenticate` para fazer com que o navegador mostre o prompt de login novamente:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="26-30"
+{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="26-30"
+{!> ../../../docs_src/security/tutorial007_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="23-27"
+{!> ../../../docs_src/security/tutorial007.py!}
+```
+
+////

From 35df20c79c8ce482c314934098e8875cf011c56e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 15 Sep 2024 19:04:38 +0000
Subject: [PATCH 138/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3f0b60fd3..7f5e86b30 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Translations
+
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/http-basic-auth.md`. PR [#12195](https://github.com/fastapi/fastapi/pull/12195) by [@ceb10n](https://github.com/ceb10n).
+
 ## 0.114.2
 
 ### Fixes

From 4b2b14a8e89a46a3c37dbf49746c5cd0e6f678f2 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 17 Sep 2024 00:00:09 +0200
Subject: [PATCH 139/146] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
 =?UTF-8?q?t=20autoupdate=20(#12204)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.4 → v0.6.5](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.4...v0.6.5)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 .pre-commit-config.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index f74816f12..4b1b10a68 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -14,7 +14,7 @@ repos:
     -   id: end-of-file-fixer
     -   id: trailing-whitespace
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.4
+    rev: v0.6.5
     hooks:
     -   id: ruff
         args:

From 0903da78c9940b094e13732264b5e462a426e5cc Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 16 Sep 2024 22:00:35 +0000
Subject: [PATCH 140/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7f5e86b30..d6d2a05b3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
 
 * 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/http-basic-auth.md`. PR [#12195](https://github.com/fastapi/fastapi/pull/12195) by [@ceb10n](https://github.com/ceb10n).
 
+### Internal
+
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12204](https://github.com/fastapi/fastapi/pull/12204) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+
 ## 0.114.2
 
 ### Fixes

From 55035f440bf852f739e3ccd71b67034016ae9bba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 17 Sep 2024 20:54:10 +0200
Subject: [PATCH 141/146] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20Pydan?=
 =?UTF-8?q?tic=20models=20for=20parameters=20using=20`Query`,=20`Cookie`,?=
 =?UTF-8?q?=20`Header`=20(#12199)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../tutorial/cookie-param-models/image01.png  | Bin 0 -> 45217 bytes
 .../tutorial/header-param-models/image01.png  | Bin 0 -> 62257 bytes
 .../tutorial/query-param-models/image01.png   | Bin 0 -> 45571 bytes
 docs/en/docs/tutorial/cookie-param-models.md  | 154 ++++++++++
 docs/en/docs/tutorial/header-param-models.md  | 184 ++++++++++++
 docs/en/docs/tutorial/query-param-models.md   | 196 ++++++++++++
 docs/en/mkdocs.yml                            |   3 +
 docs_src/cookie_param_models/tutorial001.py   |  17 ++
 .../cookie_param_models/tutorial001_an.py     |  18 ++
 .../tutorial001_an_py310.py                   |  17 ++
 .../tutorial001_an_py39.py                    |  17 ++
 .../cookie_param_models/tutorial001_py310.py  |  15 +
 docs_src/cookie_param_models/tutorial002.py   |  19 ++
 .../cookie_param_models/tutorial002_an.py     |  20 ++
 .../tutorial002_an_py310.py                   |  19 ++
 .../tutorial002_an_py39.py                    |  19 ++
 .../cookie_param_models/tutorial002_pv1.py    |  20 ++
 .../cookie_param_models/tutorial002_pv1_an.py |  21 ++
 .../tutorial002_pv1_an_py310.py               |  20 ++
 .../tutorial002_pv1_an_py39.py                |  20 ++
 .../tutorial002_pv1_py310.py                  |  18 ++
 .../cookie_param_models/tutorial002_py310.py  |  17 ++
 docs_src/header_param_models/tutorial001.py   |  19 ++
 .../header_param_models/tutorial001_an.py     |  20 ++
 .../tutorial001_an_py310.py                   |  19 ++
 .../tutorial001_an_py39.py                    |  19 ++
 .../header_param_models/tutorial001_py310.py  |  17 ++
 .../header_param_models/tutorial001_py39.py   |  19 ++
 docs_src/header_param_models/tutorial002.py   |  21 ++
 .../header_param_models/tutorial002_an.py     |  22 ++
 .../tutorial002_an_py310.py                   |  21 ++
 .../tutorial002_an_py39.py                    |  21 ++
 .../header_param_models/tutorial002_pv1.py    |  22 ++
 .../header_param_models/tutorial002_pv1_an.py |  23 ++
 .../tutorial002_pv1_an_py310.py               |  22 ++
 .../tutorial002_pv1_an_py39.py                |  22 ++
 .../tutorial002_pv1_py310.py                  |  20 ++
 .../tutorial002_pv1_py39.py                   |  22 ++
 .../header_param_models/tutorial002_py310.py  |  19 ++
 .../header_param_models/tutorial002_py39.py   |  21 ++
 docs_src/query_param_models/tutorial001.py    |  19 ++
 docs_src/query_param_models/tutorial001_an.py |  19 ++
 .../tutorial001_an_py310.py                   |  18 ++
 .../query_param_models/tutorial001_an_py39.py |  17 ++
 .../query_param_models/tutorial001_py310.py   |  18 ++
 .../query_param_models/tutorial001_py39.py    |  17 ++
 docs_src/query_param_models/tutorial002.py    |  21 ++
 docs_src/query_param_models/tutorial002_an.py |  21 ++
 .../tutorial002_an_py310.py                   |  20 ++
 .../query_param_models/tutorial002_an_py39.py |  19 ++
 .../query_param_models/tutorial002_pv1.py     |  22 ++
 .../query_param_models/tutorial002_pv1_an.py  |  22 ++
 .../tutorial002_pv1_an_py310.py               |  21 ++
 .../tutorial002_pv1_an_py39.py                |  20 ++
 .../tutorial002_pv1_py310.py                  |  21 ++
 .../tutorial002_pv1_py39.py                   |  20 ++
 .../query_param_models/tutorial002_py310.py   |  20 ++
 .../query_param_models/tutorial002_py39.py    |  19 ++
 fastapi/dependencies/utils.py                 |  90 +++++-
 fastapi/openapi/utils.py                      |  86 +++---
 .../playwright/cookie_param_models/image01.py |  39 +++
 .../playwright/header_param_models/image01.py |  38 +++
 .../playwright/query_param_models/image01.py  |  41 +++
 .../test_cookie_param_models/__init__.py      |   0
 .../test_tutorial001.py                       | 205 +++++++++++++
 .../test_tutorial002.py                       | 233 +++++++++++++++
 .../test_header_param_models/__init__.py      |   0
 .../test_tutorial001.py                       | 238 +++++++++++++++
 .../test_tutorial002.py                       | 249 ++++++++++++++++
 .../test_query_param_models/__init__.py       |   0
 .../test_tutorial001.py                       | 260 ++++++++++++++++
 .../test_tutorial002.py                       | 282 ++++++++++++++++++
 72 files changed, 3253 insertions(+), 45 deletions(-)
 create mode 100644 docs/en/docs/img/tutorial/cookie-param-models/image01.png
 create mode 100644 docs/en/docs/img/tutorial/header-param-models/image01.png
 create mode 100644 docs/en/docs/img/tutorial/query-param-models/image01.png
 create mode 100644 docs/en/docs/tutorial/cookie-param-models.md
 create mode 100644 docs/en/docs/tutorial/header-param-models.md
 create mode 100644 docs/en/docs/tutorial/query-param-models.md
 create mode 100644 docs_src/cookie_param_models/tutorial001.py
 create mode 100644 docs_src/cookie_param_models/tutorial001_an.py
 create mode 100644 docs_src/cookie_param_models/tutorial001_an_py310.py
 create mode 100644 docs_src/cookie_param_models/tutorial001_an_py39.py
 create mode 100644 docs_src/cookie_param_models/tutorial001_py310.py
 create mode 100644 docs_src/cookie_param_models/tutorial002.py
 create mode 100644 docs_src/cookie_param_models/tutorial002_an.py
 create mode 100644 docs_src/cookie_param_models/tutorial002_an_py310.py
 create mode 100644 docs_src/cookie_param_models/tutorial002_an_py39.py
 create mode 100644 docs_src/cookie_param_models/tutorial002_pv1.py
 create mode 100644 docs_src/cookie_param_models/tutorial002_pv1_an.py
 create mode 100644 docs_src/cookie_param_models/tutorial002_pv1_an_py310.py
 create mode 100644 docs_src/cookie_param_models/tutorial002_pv1_an_py39.py
 create mode 100644 docs_src/cookie_param_models/tutorial002_pv1_py310.py
 create mode 100644 docs_src/cookie_param_models/tutorial002_py310.py
 create mode 100644 docs_src/header_param_models/tutorial001.py
 create mode 100644 docs_src/header_param_models/tutorial001_an.py
 create mode 100644 docs_src/header_param_models/tutorial001_an_py310.py
 create mode 100644 docs_src/header_param_models/tutorial001_an_py39.py
 create mode 100644 docs_src/header_param_models/tutorial001_py310.py
 create mode 100644 docs_src/header_param_models/tutorial001_py39.py
 create mode 100644 docs_src/header_param_models/tutorial002.py
 create mode 100644 docs_src/header_param_models/tutorial002_an.py
 create mode 100644 docs_src/header_param_models/tutorial002_an_py310.py
 create mode 100644 docs_src/header_param_models/tutorial002_an_py39.py
 create mode 100644 docs_src/header_param_models/tutorial002_pv1.py
 create mode 100644 docs_src/header_param_models/tutorial002_pv1_an.py
 create mode 100644 docs_src/header_param_models/tutorial002_pv1_an_py310.py
 create mode 100644 docs_src/header_param_models/tutorial002_pv1_an_py39.py
 create mode 100644 docs_src/header_param_models/tutorial002_pv1_py310.py
 create mode 100644 docs_src/header_param_models/tutorial002_pv1_py39.py
 create mode 100644 docs_src/header_param_models/tutorial002_py310.py
 create mode 100644 docs_src/header_param_models/tutorial002_py39.py
 create mode 100644 docs_src/query_param_models/tutorial001.py
 create mode 100644 docs_src/query_param_models/tutorial001_an.py
 create mode 100644 docs_src/query_param_models/tutorial001_an_py310.py
 create mode 100644 docs_src/query_param_models/tutorial001_an_py39.py
 create mode 100644 docs_src/query_param_models/tutorial001_py310.py
 create mode 100644 docs_src/query_param_models/tutorial001_py39.py
 create mode 100644 docs_src/query_param_models/tutorial002.py
 create mode 100644 docs_src/query_param_models/tutorial002_an.py
 create mode 100644 docs_src/query_param_models/tutorial002_an_py310.py
 create mode 100644 docs_src/query_param_models/tutorial002_an_py39.py
 create mode 100644 docs_src/query_param_models/tutorial002_pv1.py
 create mode 100644 docs_src/query_param_models/tutorial002_pv1_an.py
 create mode 100644 docs_src/query_param_models/tutorial002_pv1_an_py310.py
 create mode 100644 docs_src/query_param_models/tutorial002_pv1_an_py39.py
 create mode 100644 docs_src/query_param_models/tutorial002_pv1_py310.py
 create mode 100644 docs_src/query_param_models/tutorial002_pv1_py39.py
 create mode 100644 docs_src/query_param_models/tutorial002_py310.py
 create mode 100644 docs_src/query_param_models/tutorial002_py39.py
 create mode 100644 scripts/playwright/cookie_param_models/image01.py
 create mode 100644 scripts/playwright/header_param_models/image01.py
 create mode 100644 scripts/playwright/query_param_models/image01.py
 create mode 100644 tests/test_tutorial/test_cookie_param_models/__init__.py
 create mode 100644 tests/test_tutorial/test_cookie_param_models/test_tutorial001.py
 create mode 100644 tests/test_tutorial/test_cookie_param_models/test_tutorial002.py
 create mode 100644 tests/test_tutorial/test_header_param_models/__init__.py
 create mode 100644 tests/test_tutorial/test_header_param_models/test_tutorial001.py
 create mode 100644 tests/test_tutorial/test_header_param_models/test_tutorial002.py
 create mode 100644 tests/test_tutorial/test_query_param_models/__init__.py
 create mode 100644 tests/test_tutorial/test_query_param_models/test_tutorial001.py
 create mode 100644 tests/test_tutorial/test_query_param_models/test_tutorial002.py

diff --git a/docs/en/docs/img/tutorial/cookie-param-models/image01.png b/docs/en/docs/img/tutorial/cookie-param-models/image01.png
new file mode 100644
index 0000000000000000000000000000000000000000..85c370f80a42e52768a412c066e686e4f2773ccd
GIT binary patch
literal 45217
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

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/tutorial/header-param-models/image01.png b/docs/en/docs/img/tutorial/header-param-models/image01.png
new file mode 100644
index 0000000000000000000000000000000000000000..849dea3d8b6fd9a857065208bb49ef7d33fa1568
GIT binary patch
literal 62257
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
B?=t`Z

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/tutorial/query-param-models/image01.png b/docs/en/docs/img/tutorial/query-param-models/image01.png
new file mode 100644
index 0000000000000000000000000000000000000000..e7a61b61fb4f66857abe4b63aea3e901efd7482c
GIT binary patch
literal 45571
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%0A>3X(
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

literal 0
HcmV?d00001

diff --git a/docs/en/docs/tutorial/cookie-param-models.md b/docs/en/docs/tutorial/cookie-param-models.md
new file mode 100644
index 000000000..2aa3a1f59
--- /dev/null
+++ b/docs/en/docs/tutorial/cookie-param-models.md
@@ -0,0 +1,154 @@
+# Cookie Parameter Models
+
+If you have a group of **cookies** that are related, you can create a **Pydantic model** to declare them. 🍪
+
+This would allow you to **re-use the model** in **multiple places** and also to declare validations and metadata for all the parameters at once. 😎
+
+/// note
+
+This is supported since FastAPI version `0.115.0`. 🤓
+
+///
+
+/// tip
+
+This same technique applies to `Query`, `Cookie`, and `Header`. 😎
+
+///
+
+## Cookies with a Pydantic Model
+
+Declare the **cookie** parameters that you need in a **Pydantic model**, and then declare the parameter as `Cookie`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9-12  16"
+{!> ../../../docs_src/cookie_param_models/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-12  16"
+{!> ../../../docs_src/cookie_param_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10-13  17"
+{!> ../../../docs_src/cookie_param_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="7-10  14"
+{!> ../../../docs_src/cookie_param_models/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="9-12  16"
+{!> ../../../docs_src/cookie_param_models/tutorial001.py!}
+```
+
+////
+
+**FastAPI** will **extract** the data for **each field** from the **cookies** received in the request and give you the Pydantic model you defined.
+
+## Check the Docs
+
+You can see the defined cookies in the docs UI at `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/cookie-param-models/image01.png">
+</div>
+
+/// info
+
+Have in mind that, as **browsers handle cookies** in special ways and behind the scenes, they **don't** easily allow **JavaScript** to touch them.
+
+If you go to the **API docs UI** at `/docs` you will be able to see the **documentation** for cookies for your *path operations*.
+
+But even if you **fill the data** and click "Execute", because the docs UI works with **JavaScript**, the cookies won't be sent, and you will see an **error** message as if you didn't write any values.
+
+///
+
+## Forbid Extra Cookies
+
+In some special use cases (probably not very common), you might want to **restrict** the cookies that you want to receive.
+
+Your API now has the power to control its own <abbr title="This is a joke, just in case. It has nothing to do with cookie consents, but it's funny that even the API can now reject the poor cookies. Have a cookie. 🍪">cookie consent</abbr>. 🤪🍪
+
+You can use Pydantic's model configuration to `forbid` any `extra` fields:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="10"
+{!> ../../../docs_src/cookie_param_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/cookie_param_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/cookie_param_models/tutorial002.py!}
+```
+
+////
+
+If a client tries to send some **extra cookies**, they will receive an **error** response.
+
+Poor cookie banners with all their effort to get your consent for the <abbr title="This is another joke. Don't pay attention to me. Have some coffee for your cookie. ☕">API to reject it</abbr>. 🍪
+
+For example, if the client tries to send a `santa_tracker` cookie with a value of `good-list-please`, the client will receive an **error** response telling them that the `santa_tracker` <abbr title="Santa disapproves the lack of cookies. 🎅 Okay, no more cookie jokes.">cookie is not allowed</abbr>:
+
+```json
+{
+    "detail": [
+        {
+            "type": "extra_forbidden",
+            "loc": ["cookie", "santa_tracker"],
+            "msg": "Extra inputs are not permitted",
+            "input": "good-list-please",
+        }
+    ]
+}
+```
+
+## Summary
+
+You can use **Pydantic models** to declare <abbr title="Have a last cookie before you go. 🍪">**cookies**</abbr> in **FastAPI**. 😎
diff --git a/docs/en/docs/tutorial/header-param-models.md b/docs/en/docs/tutorial/header-param-models.md
new file mode 100644
index 000000000..8deb0a455
--- /dev/null
+++ b/docs/en/docs/tutorial/header-param-models.md
@@ -0,0 +1,184 @@
+# Header Parameter Models
+
+If you have a group of related **header parameters**, you can create a **Pydantic model** to declare them.
+
+This would allow you to **re-use the model** in **multiple places** and also to declare validations and metadata for all the parameters at once. 😎
+
+/// note
+
+This is supported since FastAPI version `0.115.0`. 🤓
+
+///
+
+## Header Parameters with a Pydantic Model
+
+Declare the **header parameters** that you need in a **Pydantic model**, and then declare the parameter as `Header`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9-14  18"
+{!> ../../../docs_src/header_param_models/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-14  18"
+{!> ../../../docs_src/header_param_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10-15  19"
+{!> ../../../docs_src/header_param_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="7-12  16"
+{!> ../../../docs_src/header_param_models/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="9-14  18"
+{!> ../../../docs_src/header_param_models/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="7-12  16"
+{!> ../../../docs_src/header_param_models/tutorial001_py310.py!}
+```
+
+////
+
+**FastAPI** will **extract** the data for **each field** from the **headers** in the request and give you the Pydantic model you defined.
+
+## Check the Docs
+
+You can see the required headers in the docs UI at `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/header-param-models/image01.png">
+</div>
+
+## Forbid Extra Headers
+
+In some special use cases (probably not very common), you might want to **restrict** the headers that you want to receive.
+
+You can use Pydantic's model configuration to `forbid` any `extra` fields:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="10"
+{!> ../../../docs_src/header_param_models/tutorial002_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="10"
+{!> ../../../docs_src/header_param_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/header_param_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="8"
+{!> ../../../docs_src/header_param_models/tutorial002_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/header_param_models/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/header_param_models/tutorial002.py!}
+```
+
+////
+
+If a client tries to send some **extra headers**, they will receive an **error** response.
+
+For example, if the client tries to send a `tool` header with a value of `plumbus`, they will receive an **error** response telling them that the header parameter `tool` is not allowed:
+
+```json
+{
+    "detail": [
+        {
+            "type": "extra_forbidden",
+            "loc": ["header", "tool"],
+            "msg": "Extra inputs are not permitted",
+            "input": "plumbus",
+        }
+    ]
+}
+```
+
+## Summary
+
+You can use **Pydantic models** to declare **headers** in **FastAPI**. 😎
diff --git a/docs/en/docs/tutorial/query-param-models.md b/docs/en/docs/tutorial/query-param-models.md
new file mode 100644
index 000000000..02e36dc0f
--- /dev/null
+++ b/docs/en/docs/tutorial/query-param-models.md
@@ -0,0 +1,196 @@
+# Query Parameter Models
+
+If you have a group of **query parameters** that are related, you can create a **Pydantic model** to declare them.
+
+This would allow you to **re-use the model** in **multiple places** and also to declare validations and metadata for all the parameters at once. 😎
+
+/// note
+
+This is supported since FastAPI version `0.115.0`. 🤓
+
+///
+
+## Query Parameters with a Pydantic Model
+
+Declare the **query parameters** that you need in a **Pydantic model**, and then declare the parameter as `Query`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9-13  17"
+{!> ../../../docs_src/query_param_models/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="8-12  16"
+{!> ../../../docs_src/query_param_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10-14  18"
+{!> ../../../docs_src/query_param_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="9-13  17"
+{!> ../../../docs_src/query_param_models/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="8-12 16"
+{!> ../../../docs_src/query_param_models/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="9-13  17"
+{!> ../../../docs_src/query_param_models/tutorial001_py310.py!}
+```
+
+////
+
+**FastAPI** will **extract** the data for **each field** from the **query parameters** in the request and give you the Pydantic model you defined.
+
+## Check the Docs
+
+You can see the query parameters in the docs UI at `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/query-param-models/image01.png">
+</div>
+
+## Forbid Extra Query Parameters
+
+In some special use cases (probably not very common), you might want to **restrict** the query parameters that you want to receive.
+
+You can use Pydantic's model configuration to `forbid` any `extra` fields:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="10"
+{!> ../../../docs_src/query_param_models/tutorial002_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9"
+{!> ../../../docs_src/query_param_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/query_param_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/query_param_models/tutorial002_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="9"
+{!> ../../../docs_src/query_param_models/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="11"
+{!> ../../../docs_src/query_param_models/tutorial002.py!}
+```
+
+////
+
+If a client tries to send some **extra** data in the **query parameters**, they will receive an **error** response.
+
+For example, if the client tries to send a `tool` query parameter with a value of `plumbus`, like:
+
+```http
+https://example.com/items/?limit=10&tool=plumbus
+```
+
+They will receive an **error** response telling them that the query parameter `tool` is not allowed:
+
+```json
+{
+    "detail": [
+        {
+            "type": "extra_forbidden",
+            "loc": ["query", "tool"],
+            "msg": "Extra inputs are not permitted",
+            "input": "plumbus"
+        }
+    ]
+}
+```
+
+## Summary
+
+You can use **Pydantic models** to declare **query parameters** in **FastAPI**. 😎
+
+/// tip
+
+Spoiler alert: you can also use Pydantic models to declare cookies and headers, but you will read about that later in the tutorial. 🤫
+
+///
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 7c810c2d7..5161b891b 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -118,6 +118,7 @@ nav:
     - tutorial/body.md
     - tutorial/query-params-str-validations.md
     - tutorial/path-params-numeric-validations.md
+    - tutorial/query-param-models.md
     - tutorial/body-multiple-params.md
     - tutorial/body-fields.md
     - tutorial/body-nested-models.md
@@ -125,6 +126,8 @@ nav:
     - tutorial/extra-data-types.md
     - tutorial/cookie-params.md
     - tutorial/header-params.md
+    - tutorial/cookie-param-models.md
+    - tutorial/header-param-models.md
     - tutorial/response-model.md
     - tutorial/extra-models.md
     - tutorial/response-status-code.md
diff --git a/docs_src/cookie_param_models/tutorial001.py b/docs_src/cookie_param_models/tutorial001.py
new file mode 100644
index 000000000..cc65c43e1
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial001.py
@@ -0,0 +1,17 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    session_id: str
+    fatebook_tracker: Union[str, None] = None
+    googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial001_an.py b/docs_src/cookie_param_models/tutorial001_an.py
new file mode 100644
index 000000000..e5839ffd5
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial001_an.py
@@ -0,0 +1,18 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    session_id: str
+    fatebook_tracker: Union[str, None] = None
+    googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial001_an_py310.py b/docs_src/cookie_param_models/tutorial001_an_py310.py
new file mode 100644
index 000000000..24cc889a9
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial001_an_py310.py
@@ -0,0 +1,17 @@
+from typing import Annotated
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    session_id: str
+    fatebook_tracker: str | None = None
+    googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial001_an_py39.py b/docs_src/cookie_param_models/tutorial001_an_py39.py
new file mode 100644
index 000000000..3d90c2007
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial001_an_py39.py
@@ -0,0 +1,17 @@
+from typing import Annotated, Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    session_id: str
+    fatebook_tracker: Union[str, None] = None
+    googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial001_py310.py b/docs_src/cookie_param_models/tutorial001_py310.py
new file mode 100644
index 000000000..7cdee5a92
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial001_py310.py
@@ -0,0 +1,15 @@
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    session_id: str
+    fatebook_tracker: str | None = None
+    googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial002.py b/docs_src/cookie_param_models/tutorial002.py
new file mode 100644
index 000000000..9679e890f
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002.py
@@ -0,0 +1,19 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    session_id: str
+    fatebook_tracker: Union[str, None] = None
+    googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_an.py b/docs_src/cookie_param_models/tutorial002_an.py
new file mode 100644
index 000000000..ce5644b7b
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_an.py
@@ -0,0 +1,20 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    session_id: str
+    fatebook_tracker: Union[str, None] = None
+    googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_an_py310.py b/docs_src/cookie_param_models/tutorial002_an_py310.py
new file mode 100644
index 000000000..7fa70fe92
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_an_py310.py
@@ -0,0 +1,19 @@
+from typing import Annotated
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    session_id: str
+    fatebook_tracker: str | None = None
+    googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_an_py39.py b/docs_src/cookie_param_models/tutorial002_an_py39.py
new file mode 100644
index 000000000..a906ce6a1
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_an_py39.py
@@ -0,0 +1,19 @@
+from typing import Annotated, Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    session_id: str
+    fatebook_tracker: Union[str, None] = None
+    googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_pv1.py b/docs_src/cookie_param_models/tutorial002_pv1.py
new file mode 100644
index 000000000..13f78b850
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_pv1.py
@@ -0,0 +1,20 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    session_id: str
+    fatebook_tracker: Union[str, None] = None
+    googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_pv1_an.py b/docs_src/cookie_param_models/tutorial002_pv1_an.py
new file mode 100644
index 000000000..ddfda9b6f
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_pv1_an.py
@@ -0,0 +1,21 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    session_id: str
+    fatebook_tracker: Union[str, None] = None
+    googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_pv1_an_py310.py b/docs_src/cookie_param_models/tutorial002_pv1_an_py310.py
new file mode 100644
index 000000000..ac00360b6
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_pv1_an_py310.py
@@ -0,0 +1,20 @@
+from typing import Annotated
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    session_id: str
+    fatebook_tracker: str | None = None
+    googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_pv1_an_py39.py b/docs_src/cookie_param_models/tutorial002_pv1_an_py39.py
new file mode 100644
index 000000000..573caea4b
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_pv1_an_py39.py
@@ -0,0 +1,20 @@
+from typing import Annotated, Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    session_id: str
+    fatebook_tracker: Union[str, None] = None
+    googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_pv1_py310.py b/docs_src/cookie_param_models/tutorial002_pv1_py310.py
new file mode 100644
index 000000000..2c59aad12
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_pv1_py310.py
@@ -0,0 +1,18 @@
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    session_id: str
+    fatebook_tracker: str | None = None
+    googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+    return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_py310.py b/docs_src/cookie_param_models/tutorial002_py310.py
new file mode 100644
index 000000000..f011aa1af
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_py310.py
@@ -0,0 +1,17 @@
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    session_id: str
+    fatebook_tracker: str | None = None
+    googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+    return cookies
diff --git a/docs_src/header_param_models/tutorial001.py b/docs_src/header_param_models/tutorial001.py
new file mode 100644
index 000000000..4caaba87b
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001.py
@@ -0,0 +1,19 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+    return headers
diff --git a/docs_src/header_param_models/tutorial001_an.py b/docs_src/header_param_models/tutorial001_an.py
new file mode 100644
index 000000000..b55c6b56b
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001_an.py
@@ -0,0 +1,20 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+    return headers
diff --git a/docs_src/header_param_models/tutorial001_an_py310.py b/docs_src/header_param_models/tutorial001_an_py310.py
new file mode 100644
index 000000000..acfb6b9bf
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001_an_py310.py
@@ -0,0 +1,19 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    host: str
+    save_data: bool
+    if_modified_since: str | None = None
+    traceparent: str | None = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+    return headers
diff --git a/docs_src/header_param_models/tutorial001_an_py39.py b/docs_src/header_param_models/tutorial001_an_py39.py
new file mode 100644
index 000000000..51a5f94fc
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001_an_py39.py
@@ -0,0 +1,19 @@
+from typing import Annotated, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+    return headers
diff --git a/docs_src/header_param_models/tutorial001_py310.py b/docs_src/header_param_models/tutorial001_py310.py
new file mode 100644
index 000000000..7239c64ce
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001_py310.py
@@ -0,0 +1,17 @@
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    host: str
+    save_data: bool
+    if_modified_since: str | None = None
+    traceparent: str | None = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+    return headers
diff --git a/docs_src/header_param_models/tutorial001_py39.py b/docs_src/header_param_models/tutorial001_py39.py
new file mode 100644
index 000000000..4c1137813
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001_py39.py
@@ -0,0 +1,19 @@
+from typing import Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002.py b/docs_src/header_param_models/tutorial002.py
new file mode 100644
index 000000000..3f9aac58d
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002.py
@@ -0,0 +1,21 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_an.py b/docs_src/header_param_models/tutorial002_an.py
new file mode 100644
index 000000000..771135d77
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_an.py
@@ -0,0 +1,22 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_an_py310.py b/docs_src/header_param_models/tutorial002_an_py310.py
new file mode 100644
index 000000000..e9535f045
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_an_py310.py
@@ -0,0 +1,21 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    host: str
+    save_data: bool
+    if_modified_since: str | None = None
+    traceparent: str | None = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_an_py39.py b/docs_src/header_param_models/tutorial002_an_py39.py
new file mode 100644
index 000000000..ca5208c9d
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_an_py39.py
@@ -0,0 +1,21 @@
+from typing import Annotated, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1.py b/docs_src/header_param_models/tutorial002_pv1.py
new file mode 100644
index 000000000..7e56cd993
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1.py
@@ -0,0 +1,22 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1_an.py b/docs_src/header_param_models/tutorial002_pv1_an.py
new file mode 100644
index 000000000..236778231
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1_an.py
@@ -0,0 +1,23 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1_an_py310.py b/docs_src/header_param_models/tutorial002_pv1_an_py310.py
new file mode 100644
index 000000000..e99e24ea5
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1_an_py310.py
@@ -0,0 +1,22 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    host: str
+    save_data: bool
+    if_modified_since: str | None = None
+    traceparent: str | None = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1_an_py39.py b/docs_src/header_param_models/tutorial002_pv1_an_py39.py
new file mode 100644
index 000000000..18398b726
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1_an_py39.py
@@ -0,0 +1,22 @@
+from typing import Annotated, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1_py310.py b/docs_src/header_param_models/tutorial002_pv1_py310.py
new file mode 100644
index 000000000..3dbff9d7b
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1_py310.py
@@ -0,0 +1,20 @@
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    host: str
+    save_data: bool
+    if_modified_since: str | None = None
+    traceparent: str | None = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1_py39.py b/docs_src/header_param_models/tutorial002_pv1_py39.py
new file mode 100644
index 000000000..86e19be0d
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1_py39.py
@@ -0,0 +1,22 @@
+from typing import Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_py310.py b/docs_src/header_param_models/tutorial002_py310.py
new file mode 100644
index 000000000..3d2296345
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_py310.py
@@ -0,0 +1,19 @@
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    host: str
+    save_data: bool
+    if_modified_since: str | None = None
+    traceparent: str | None = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+    return headers
diff --git a/docs_src/header_param_models/tutorial002_py39.py b/docs_src/header_param_models/tutorial002_py39.py
new file mode 100644
index 000000000..f8ce559a7
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_py39.py
@@ -0,0 +1,21 @@
+from typing import Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    host: str
+    save_data: bool
+    if_modified_since: Union[str, None] = None
+    traceparent: Union[str, None] = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+    return headers
diff --git a/docs_src/query_param_models/tutorial001.py b/docs_src/query_param_models/tutorial001.py
new file mode 100644
index 000000000..0c0ab315e
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001.py
@@ -0,0 +1,19 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial001_an.py b/docs_src/query_param_models/tutorial001_an.py
new file mode 100644
index 000000000..28375057c
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001_an.py
@@ -0,0 +1,19 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial001_an_py310.py b/docs_src/query_param_models/tutorial001_an_py310.py
new file mode 100644
index 000000000..71427acae
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001_an_py310.py
@@ -0,0 +1,18 @@
+from typing import Annotated, Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial001_an_py39.py b/docs_src/query_param_models/tutorial001_an_py39.py
new file mode 100644
index 000000000..ba690d3e3
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001_an_py39.py
@@ -0,0 +1,17 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial001_py310.py b/docs_src/query_param_models/tutorial001_py310.py
new file mode 100644
index 000000000..3ebf9f4d7
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001_py310.py
@@ -0,0 +1,18 @@
+from typing import Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial001_py39.py b/docs_src/query_param_models/tutorial001_py39.py
new file mode 100644
index 000000000..54b52a054
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001_py39.py
@@ -0,0 +1,17 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002.py b/docs_src/query_param_models/tutorial002.py
new file mode 100644
index 000000000..1633bc464
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002.py
@@ -0,0 +1,21 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_an.py b/docs_src/query_param_models/tutorial002_an.py
new file mode 100644
index 000000000..69705d4b4
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_an.py
@@ -0,0 +1,21 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_an_py310.py b/docs_src/query_param_models/tutorial002_an_py310.py
new file mode 100644
index 000000000..975956502
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_an_py310.py
@@ -0,0 +1,20 @@
+from typing import Annotated, Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_an_py39.py b/docs_src/query_param_models/tutorial002_an_py39.py
new file mode 100644
index 000000000..2d4c1a62b
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_an_py39.py
@@ -0,0 +1,19 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1.py b/docs_src/query_param_models/tutorial002_pv1.py
new file mode 100644
index 000000000..71ccd961d
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1.py
@@ -0,0 +1,22 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1_an.py b/docs_src/query_param_models/tutorial002_pv1_an.py
new file mode 100644
index 000000000..1dd29157a
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1_an.py
@@ -0,0 +1,22 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1_an_py310.py b/docs_src/query_param_models/tutorial002_pv1_an_py310.py
new file mode 100644
index 000000000..d635aae88
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1_an_py310.py
@@ -0,0 +1,21 @@
+from typing import Annotated, Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1_an_py39.py b/docs_src/query_param_models/tutorial002_pv1_an_py39.py
new file mode 100644
index 000000000..494fef11f
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1_an_py39.py
@@ -0,0 +1,20 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1_py310.py b/docs_src/query_param_models/tutorial002_pv1_py310.py
new file mode 100644
index 000000000..9ffdeefc0
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1_py310.py
@@ -0,0 +1,21 @@
+from typing import Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1_py39.py b/docs_src/query_param_models/tutorial002_pv1_py39.py
new file mode 100644
index 000000000..7fa456a79
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1_py39.py
@@ -0,0 +1,20 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    class Config:
+        extra = "forbid"
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_py310.py b/docs_src/query_param_models/tutorial002_py310.py
new file mode 100644
index 000000000..6ec418499
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_py310.py
@@ -0,0 +1,20 @@
+from typing import Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+    return filter_query
diff --git a/docs_src/query_param_models/tutorial002_py39.py b/docs_src/query_param_models/tutorial002_py39.py
new file mode 100644
index 000000000..f9bba028c
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_py39.py
@@ -0,0 +1,19 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+    return filter_query
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 7548cf0c7..5cebbf00f 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -201,14 +201,23 @@ def get_flat_dependant(
     return flat_dependant
 
 
+def _get_flat_fields_from_params(fields: List[ModelField]) -> List[ModelField]:
+    if not fields:
+        return fields
+    first_field = fields[0]
+    if len(fields) == 1 and lenient_issubclass(first_field.type_, BaseModel):
+        fields_to_extract = get_cached_model_fields(first_field.type_)
+        return fields_to_extract
+    return fields
+
+
 def get_flat_params(dependant: Dependant) -> List[ModelField]:
     flat_dependant = get_flat_dependant(dependant, skip_repeats=True)
-    return (
-        flat_dependant.path_params
-        + flat_dependant.query_params
-        + flat_dependant.header_params
-        + flat_dependant.cookie_params
-    )
+    path_params = _get_flat_fields_from_params(flat_dependant.path_params)
+    query_params = _get_flat_fields_from_params(flat_dependant.query_params)
+    header_params = _get_flat_fields_from_params(flat_dependant.header_params)
+    cookie_params = _get_flat_fields_from_params(flat_dependant.cookie_params)
+    return path_params + query_params + header_params + cookie_params
 
 
 def get_typed_signature(call: Callable[..., Any]) -> inspect.Signature:
@@ -479,7 +488,15 @@ def analyze_param(
                 field=field
             ), "Path params must be of one of the supported types"
         elif isinstance(field_info, params.Query):
-            assert is_scalar_field(field) or is_scalar_sequence_field(field)
+            assert (
+                is_scalar_field(field)
+                or is_scalar_sequence_field(field)
+                or (
+                    lenient_issubclass(field.type_, BaseModel)
+                    # For Pydantic v1
+                    and getattr(field, "shape", 1) == 1
+                )
+            )
 
     return ParamDetails(type_annotation=type_annotation, depends=depends, field=field)
 
@@ -686,11 +703,14 @@ def _validate_value_with_model_field(
         return v_, []
 
 
-def _get_multidict_value(field: ModelField, values: Mapping[str, Any]) -> Any:
+def _get_multidict_value(
+    field: ModelField, values: Mapping[str, Any], alias: Union[str, None] = None
+) -> Any:
+    alias = alias or field.alias
     if is_sequence_field(field) and isinstance(values, (ImmutableMultiDict, Headers)):
-        value = values.getlist(field.alias)
+        value = values.getlist(alias)
     else:
-        value = values.get(field.alias, None)
+        value = values.get(alias, None)
     if (
         value is None
         or (
@@ -712,7 +732,55 @@ def request_params_to_args(
     received_params: Union[Mapping[str, Any], QueryParams, Headers],
 ) -> Tuple[Dict[str, Any], List[Any]]:
     values: Dict[str, Any] = {}
-    errors = []
+    errors: List[Dict[str, Any]] = []
+
+    if not fields:
+        return values, errors
+
+    first_field = fields[0]
+    fields_to_extract = fields
+    single_not_embedded_field = False
+    if len(fields) == 1 and lenient_issubclass(first_field.type_, BaseModel):
+        fields_to_extract = get_cached_model_fields(first_field.type_)
+        single_not_embedded_field = True
+
+    params_to_process: Dict[str, Any] = {}
+
+    processed_keys = set()
+
+    for field in fields_to_extract:
+        alias = None
+        if isinstance(received_params, Headers):
+            # Handle fields extracted from a Pydantic Model for a header, each field
+            # doesn't have a FieldInfo of type Header with the default convert_underscores=True
+            convert_underscores = getattr(field.field_info, "convert_underscores", True)
+            if convert_underscores:
+                alias = (
+                    field.alias
+                    if field.alias != field.name
+                    else field.name.replace("_", "-")
+                )
+        value = _get_multidict_value(field, received_params, alias=alias)
+        if value is not None:
+            params_to_process[field.name] = value
+        processed_keys.add(alias or field.alias)
+        processed_keys.add(field.name)
+
+    for key, value in received_params.items():
+        if key not in processed_keys:
+            params_to_process[key] = value
+
+    if single_not_embedded_field:
+        field_info = first_field.field_info
+        assert isinstance(
+            field_info, params.Param
+        ), "Params must be subclasses of Param"
+        loc: Tuple[str, ...] = (field_info.in_.value,)
+        v_, errors_ = _validate_value_with_model_field(
+            field=first_field, value=params_to_process, values=values, loc=loc
+        )
+        return {first_field.name: v_}, errors_
+
     for field in fields:
         value = _get_multidict_value(field, received_params)
         field_info = field.field_info
diff --git a/fastapi/openapi/utils.py b/fastapi/openapi/utils.py
index 79ad9f83f..947eca948 100644
--- a/fastapi/openapi/utils.py
+++ b/fastapi/openapi/utils.py
@@ -16,11 +16,15 @@ from fastapi._compat import (
 )
 from fastapi.datastructures import DefaultPlaceholder
 from fastapi.dependencies.models import Dependant
-from fastapi.dependencies.utils import get_flat_dependant, get_flat_params
+from fastapi.dependencies.utils import (
+    _get_flat_fields_from_params,
+    get_flat_dependant,
+    get_flat_params,
+)
 from fastapi.encoders import jsonable_encoder
 from fastapi.openapi.constants import METHODS_WITH_BODY, REF_PREFIX, REF_TEMPLATE
 from fastapi.openapi.models import OpenAPI
-from fastapi.params import Body, Param
+from fastapi.params import Body, ParamTypes
 from fastapi.responses import Response
 from fastapi.types import ModelNameMap
 from fastapi.utils import (
@@ -87,9 +91,9 @@ def get_openapi_security_definitions(
     return security_definitions, operation_security
 
 
-def get_openapi_operation_parameters(
+def _get_openapi_operation_parameters(
     *,
-    all_route_params: Sequence[ModelField],
+    dependant: Dependant,
     schema_generator: GenerateJsonSchema,
     model_name_map: ModelNameMap,
     field_mapping: Dict[
@@ -98,33 +102,47 @@ def get_openapi_operation_parameters(
     separate_input_output_schemas: bool = True,
 ) -> List[Dict[str, Any]]:
     parameters = []
-    for param in all_route_params:
-        field_info = param.field_info
-        field_info = cast(Param, field_info)
-        if not field_info.include_in_schema:
-            continue
-        param_schema = get_schema_from_model_field(
-            field=param,
-            schema_generator=schema_generator,
-            model_name_map=model_name_map,
-            field_mapping=field_mapping,
-            separate_input_output_schemas=separate_input_output_schemas,
-        )
-        parameter = {
-            "name": param.alias,
-            "in": field_info.in_.value,
-            "required": param.required,
-            "schema": param_schema,
-        }
-        if field_info.description:
-            parameter["description"] = field_info.description
-        if field_info.openapi_examples:
-            parameter["examples"] = jsonable_encoder(field_info.openapi_examples)
-        elif field_info.example != Undefined:
-            parameter["example"] = jsonable_encoder(field_info.example)
-        if field_info.deprecated:
-            parameter["deprecated"] = True
-        parameters.append(parameter)
+    flat_dependant = get_flat_dependant(dependant, skip_repeats=True)
+    path_params = _get_flat_fields_from_params(flat_dependant.path_params)
+    query_params = _get_flat_fields_from_params(flat_dependant.query_params)
+    header_params = _get_flat_fields_from_params(flat_dependant.header_params)
+    cookie_params = _get_flat_fields_from_params(flat_dependant.cookie_params)
+    parameter_groups = [
+        (ParamTypes.path, path_params),
+        (ParamTypes.query, query_params),
+        (ParamTypes.header, header_params),
+        (ParamTypes.cookie, cookie_params),
+    ]
+    for param_type, param_group in parameter_groups:
+        for param in param_group:
+            field_info = param.field_info
+            # field_info = cast(Param, field_info)
+            if not getattr(field_info, "include_in_schema", True):
+                continue
+            param_schema = get_schema_from_model_field(
+                field=param,
+                schema_generator=schema_generator,
+                model_name_map=model_name_map,
+                field_mapping=field_mapping,
+                separate_input_output_schemas=separate_input_output_schemas,
+            )
+            parameter = {
+                "name": param.alias,
+                "in": param_type.value,
+                "required": param.required,
+                "schema": param_schema,
+            }
+            if field_info.description:
+                parameter["description"] = field_info.description
+            openapi_examples = getattr(field_info, "openapi_examples", None)
+            example = getattr(field_info, "example", None)
+            if openapi_examples:
+                parameter["examples"] = jsonable_encoder(openapi_examples)
+            elif example != Undefined:
+                parameter["example"] = jsonable_encoder(example)
+            if getattr(field_info, "deprecated", None):
+                parameter["deprecated"] = True
+            parameters.append(parameter)
     return parameters
 
 
@@ -247,9 +265,8 @@ def get_openapi_path(
                 operation.setdefault("security", []).extend(operation_security)
             if security_definitions:
                 security_schemes.update(security_definitions)
-            all_route_params = get_flat_params(route.dependant)
-            operation_parameters = get_openapi_operation_parameters(
-                all_route_params=all_route_params,
+            operation_parameters = _get_openapi_operation_parameters(
+                dependant=route.dependant,
                 schema_generator=schema_generator,
                 model_name_map=model_name_map,
                 field_mapping=field_mapping,
@@ -379,6 +396,7 @@ def get_openapi_path(
                     deep_dict_update(openapi_response, process_response)
                     openapi_response["description"] = description
             http422 = str(HTTP_422_UNPROCESSABLE_ENTITY)
+            all_route_params = get_flat_params(route.dependant)
             if (all_route_params or route.body_field) and not any(
                 status in operation["responses"]
                 for status in [http422, "4XX", "default"]
diff --git a/scripts/playwright/cookie_param_models/image01.py b/scripts/playwright/cookie_param_models/image01.py
new file mode 100644
index 000000000..77c91bfe2
--- /dev/null
+++ b/scripts/playwright/cookie_param_models/image01.py
@@ -0,0 +1,39 @@
+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)
+    # Update the viewport manually
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context()
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_role("link", name="/items/").click()
+    # Manually add the screenshot
+    page.screenshot(path="docs/en/docs/img/tutorial/cookie-param-models/image01.png")
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["fastapi", "run", "docs_src/cookie_param_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/scripts/playwright/header_param_models/image01.py b/scripts/playwright/header_param_models/image01.py
new file mode 100644
index 000000000..53914251e
--- /dev/null
+++ b/scripts/playwright/header_param_models/image01.py
@@ -0,0 +1,38 @@
+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)
+    # Update the viewport manually
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_role("button", name="GET /items/ Read Items").click()
+    page.get_by_role("button", name="Try it out").click()
+    # Manually add the screenshot
+    page.screenshot(path="docs/en/docs/img/tutorial/header-param-models/image01.png")
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["fastapi", "run", "docs_src/header_param_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/scripts/playwright/query_param_models/image01.py b/scripts/playwright/query_param_models/image01.py
new file mode 100644
index 000000000..0ea1d0df4
--- /dev/null
+++ b/scripts/playwright/query_param_models/image01.py
@@ -0,0 +1,41 @@
+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)
+    # Update the viewport manually
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    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="GET /items/ Read Items").click()
+    page.get_by_role("button", name="Try it out").click()
+    page.get_by_role("heading", name="Servers").click()
+    # Manually add the screenshot
+    page.screenshot(path="docs/en/docs/img/tutorial/query-param-models/image01.png")
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["fastapi", "run", "docs_src/query_param_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_tutorial/test_cookie_param_models/__init__.py b/tests/test_tutorial/test_cookie_param_models/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_cookie_param_models/test_tutorial001.py b/tests/test_tutorial/test_cookie_param_models/test_tutorial001.py
new file mode 100644
index 000000000..60643185a
--- /dev/null
+++ b/tests/test_tutorial/test_cookie_param_models/test_tutorial001.py
@@ -0,0 +1,205 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310
+
+
+@pytest.fixture(
+    name="client",
+    params=[
+        "tutorial001",
+        pytest.param("tutorial001_py310", marks=needs_py310),
+        "tutorial001_an",
+        pytest.param("tutorial001_an_py39", marks=needs_py39),
+        pytest.param("tutorial001_an_py310", marks=needs_py310),
+    ],
+)
+def get_client(request: pytest.FixtureRequest):
+    mod = importlib.import_module(f"docs_src.cookie_param_models.{request.param}")
+
+    client = TestClient(mod.app)
+    return client
+
+
+def test_cookie_param_model(client: TestClient):
+    with client as c:
+        c.cookies.set("session_id", "123")
+        c.cookies.set("fatebook_tracker", "456")
+        c.cookies.set("googall_tracker", "789")
+        response = c.get("/items/")
+    assert response.status_code == 200
+    assert response.json() == {
+        "session_id": "123",
+        "fatebook_tracker": "456",
+        "googall_tracker": "789",
+    }
+
+
+def test_cookie_param_model_defaults(client: TestClient):
+    with client as c:
+        c.cookies.set("session_id", "123")
+        response = c.get("/items/")
+    assert response.status_code == 200
+    assert response.json() == {
+        "session_id": "123",
+        "fatebook_tracker": None,
+        "googall_tracker": None,
+    }
+
+
+def test_cookie_param_model_invalid(client: TestClient):
+    response = client.get("/items/")
+    assert response.status_code == 422
+    assert response.json() == snapshot(
+        IsDict(
+            {
+                "detail": [
+                    {
+                        "type": "missing",
+                        "loc": ["cookie", "session_id"],
+                        "msg": "Field required",
+                        "input": {},
+                    }
+                ]
+            }
+        )
+        | IsDict(
+            # TODO: remove when deprecating Pydantic v1
+            {
+                "detail": [
+                    {
+                        "type": "value_error.missing",
+                        "loc": ["cookie", "session_id"],
+                        "msg": "field required",
+                    }
+                ]
+            }
+        )
+    )
+
+
+def test_cookie_param_model_extra(client: TestClient):
+    with client as c:
+        c.cookies.set("session_id", "123")
+        c.cookies.set("extra", "track-me-here-too")
+        response = c.get("/items/")
+    assert response.status_code == 200
+    assert response.json() == snapshot(
+        {"session_id": "123", "fatebook_tracker": None, "googall_tracker": None}
+    )
+
+
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == snapshot(
+        {
+            "openapi": "3.1.0",
+            "info": {"title": "FastAPI", "version": "0.1.0"},
+            "paths": {
+                "/items/": {
+                    "get": {
+                        "summary": "Read Items",
+                        "operationId": "read_items_items__get",
+                        "parameters": [
+                            {
+                                "name": "session_id",
+                                "in": "cookie",
+                                "required": True,
+                                "schema": {"type": "string", "title": "Session Id"},
+                            },
+                            {
+                                "name": "fatebook_tracker",
+                                "in": "cookie",
+                                "required": False,
+                                "schema": IsDict(
+                                    {
+                                        "anyOf": [{"type": "string"}, {"type": "null"}],
+                                        "title": "Fatebook Tracker",
+                                    }
+                                )
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "type": "string",
+                                        "title": "Fatebook Tracker",
+                                    }
+                                ),
+                            },
+                            {
+                                "name": "googall_tracker",
+                                "in": "cookie",
+                                "required": False,
+                                "schema": IsDict(
+                                    {
+                                        "anyOf": [{"type": "string"}, {"type": "null"}],
+                                        "title": "Googall Tracker",
+                                    }
+                                )
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "type": "string",
+                                        "title": "Googall Tracker",
+                                    }
+                                ),
+                            },
+                        ],
+                        "responses": {
+                            "200": {
+                                "description": "Successful Response",
+                                "content": {"application/json": {"schema": {}}},
+                            },
+                            "422": {
+                                "description": "Validation Error",
+                                "content": {
+                                    "application/json": {
+                                        "schema": {
+                                            "$ref": "#/components/schemas/HTTPValidationError"
+                                        }
+                                    }
+                                },
+                            },
+                        },
+                    }
+                }
+            },
+            "components": {
+                "schemas": {
+                    "HTTPValidationError": {
+                        "properties": {
+                            "detail": {
+                                "items": {
+                                    "$ref": "#/components/schemas/ValidationError"
+                                },
+                                "type": "array",
+                                "title": "Detail",
+                            }
+                        },
+                        "type": "object",
+                        "title": "HTTPValidationError",
+                    },
+                    "ValidationError": {
+                        "properties": {
+                            "loc": {
+                                "items": {
+                                    "anyOf": [{"type": "string"}, {"type": "integer"}]
+                                },
+                                "type": "array",
+                                "title": "Location",
+                            },
+                            "msg": {"type": "string", "title": "Message"},
+                            "type": {"type": "string", "title": "Error Type"},
+                        },
+                        "type": "object",
+                        "required": ["loc", "msg", "type"],
+                        "title": "ValidationError",
+                    },
+                }
+            },
+        }
+    )
diff --git a/tests/test_tutorial/test_cookie_param_models/test_tutorial002.py b/tests/test_tutorial/test_cookie_param_models/test_tutorial002.py
new file mode 100644
index 000000000..30adadc8a
--- /dev/null
+++ b/tests/test_tutorial/test_cookie_param_models/test_tutorial002.py
@@ -0,0 +1,233 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310, needs_pydanticv1, needs_pydanticv2
+
+
+@pytest.fixture(
+    name="client",
+    params=[
+        pytest.param("tutorial002", marks=needs_pydanticv2),
+        pytest.param("tutorial002_py310", marks=[needs_py310, needs_pydanticv2]),
+        pytest.param("tutorial002_an", marks=needs_pydanticv2),
+        pytest.param("tutorial002_an_py39", marks=[needs_py39, needs_pydanticv2]),
+        pytest.param("tutorial002_an_py310", marks=[needs_py310, needs_pydanticv2]),
+        pytest.param("tutorial002_pv1", marks=[needs_pydanticv1, needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_py310", marks=[needs_py310, needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_an", marks=[needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_an_py39", marks=[needs_py39, needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_an_py310", marks=[needs_py310, needs_pydanticv1]),
+    ],
+)
+def get_client(request: pytest.FixtureRequest):
+    mod = importlib.import_module(f"docs_src.cookie_param_models.{request.param}")
+
+    client = TestClient(mod.app)
+    return client
+
+
+def test_cookie_param_model(client: TestClient):
+    with client as c:
+        c.cookies.set("session_id", "123")
+        c.cookies.set("fatebook_tracker", "456")
+        c.cookies.set("googall_tracker", "789")
+        response = c.get("/items/")
+    assert response.status_code == 200
+    assert response.json() == {
+        "session_id": "123",
+        "fatebook_tracker": "456",
+        "googall_tracker": "789",
+    }
+
+
+def test_cookie_param_model_defaults(client: TestClient):
+    with client as c:
+        c.cookies.set("session_id", "123")
+        response = c.get("/items/")
+    assert response.status_code == 200
+    assert response.json() == {
+        "session_id": "123",
+        "fatebook_tracker": None,
+        "googall_tracker": None,
+    }
+
+
+def test_cookie_param_model_invalid(client: TestClient):
+    response = client.get("/items/")
+    assert response.status_code == 422
+    assert response.json() == snapshot(
+        IsDict(
+            {
+                "detail": [
+                    {
+                        "type": "missing",
+                        "loc": ["cookie", "session_id"],
+                        "msg": "Field required",
+                        "input": {},
+                    }
+                ]
+            }
+        )
+        | IsDict(
+            # TODO: remove when deprecating Pydantic v1
+            {
+                "detail": [
+                    {
+                        "type": "value_error.missing",
+                        "loc": ["cookie", "session_id"],
+                        "msg": "field required",
+                    }
+                ]
+            }
+        )
+    )
+
+
+def test_cookie_param_model_extra(client: TestClient):
+    with client as c:
+        c.cookies.set("session_id", "123")
+        c.cookies.set("extra", "track-me-here-too")
+        response = c.get("/items/")
+    assert response.status_code == 422
+    assert response.json() == snapshot(
+        IsDict(
+            {
+                "detail": [
+                    {
+                        "type": "extra_forbidden",
+                        "loc": ["cookie", "extra"],
+                        "msg": "Extra inputs are not permitted",
+                        "input": "track-me-here-too",
+                    }
+                ]
+            }
+        )
+        | IsDict(
+            # TODO: remove when deprecating Pydantic v1
+            {
+                "detail": [
+                    {
+                        "type": "value_error.extra",
+                        "loc": ["cookie", "extra"],
+                        "msg": "extra fields not permitted",
+                    }
+                ]
+            }
+        )
+    )
+
+
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == snapshot(
+        {
+            "openapi": "3.1.0",
+            "info": {"title": "FastAPI", "version": "0.1.0"},
+            "paths": {
+                "/items/": {
+                    "get": {
+                        "summary": "Read Items",
+                        "operationId": "read_items_items__get",
+                        "parameters": [
+                            {
+                                "name": "session_id",
+                                "in": "cookie",
+                                "required": True,
+                                "schema": {"type": "string", "title": "Session Id"},
+                            },
+                            {
+                                "name": "fatebook_tracker",
+                                "in": "cookie",
+                                "required": False,
+                                "schema": IsDict(
+                                    {
+                                        "anyOf": [{"type": "string"}, {"type": "null"}],
+                                        "title": "Fatebook Tracker",
+                                    }
+                                )
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "type": "string",
+                                        "title": "Fatebook Tracker",
+                                    }
+                                ),
+                            },
+                            {
+                                "name": "googall_tracker",
+                                "in": "cookie",
+                                "required": False,
+                                "schema": IsDict(
+                                    {
+                                        "anyOf": [{"type": "string"}, {"type": "null"}],
+                                        "title": "Googall Tracker",
+                                    }
+                                )
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "type": "string",
+                                        "title": "Googall Tracker",
+                                    }
+                                ),
+                            },
+                        ],
+                        "responses": {
+                            "200": {
+                                "description": "Successful Response",
+                                "content": {"application/json": {"schema": {}}},
+                            },
+                            "422": {
+                                "description": "Validation Error",
+                                "content": {
+                                    "application/json": {
+                                        "schema": {
+                                            "$ref": "#/components/schemas/HTTPValidationError"
+                                        }
+                                    }
+                                },
+                            },
+                        },
+                    }
+                }
+            },
+            "components": {
+                "schemas": {
+                    "HTTPValidationError": {
+                        "properties": {
+                            "detail": {
+                                "items": {
+                                    "$ref": "#/components/schemas/ValidationError"
+                                },
+                                "type": "array",
+                                "title": "Detail",
+                            }
+                        },
+                        "type": "object",
+                        "title": "HTTPValidationError",
+                    },
+                    "ValidationError": {
+                        "properties": {
+                            "loc": {
+                                "items": {
+                                    "anyOf": [{"type": "string"}, {"type": "integer"}]
+                                },
+                                "type": "array",
+                                "title": "Location",
+                            },
+                            "msg": {"type": "string", "title": "Message"},
+                            "type": {"type": "string", "title": "Error Type"},
+                        },
+                        "type": "object",
+                        "required": ["loc", "msg", "type"],
+                        "title": "ValidationError",
+                    },
+                }
+            },
+        }
+    )
diff --git a/tests/test_tutorial/test_header_param_models/__init__.py b/tests/test_tutorial/test_header_param_models/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_header_param_models/test_tutorial001.py b/tests/test_tutorial/test_header_param_models/test_tutorial001.py
new file mode 100644
index 000000000..06b2404cf
--- /dev/null
+++ b/tests/test_tutorial/test_header_param_models/test_tutorial001.py
@@ -0,0 +1,238 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310
+
+
+@pytest.fixture(
+    name="client",
+    params=[
+        "tutorial001",
+        pytest.param("tutorial001_py39", marks=needs_py39),
+        pytest.param("tutorial001_py310", marks=needs_py310),
+        "tutorial001_an",
+        pytest.param("tutorial001_an_py39", marks=needs_py39),
+        pytest.param("tutorial001_an_py310", marks=needs_py310),
+    ],
+)
+def get_client(request: pytest.FixtureRequest):
+    mod = importlib.import_module(f"docs_src.header_param_models.{request.param}")
+
+    client = TestClient(mod.app)
+    return client
+
+
+def test_header_param_model(client: TestClient):
+    response = client.get(
+        "/items/",
+        headers=[
+            ("save-data", "true"),
+            ("if-modified-since", "yesterday"),
+            ("traceparent", "123"),
+            ("x-tag", "one"),
+            ("x-tag", "two"),
+        ],
+    )
+    assert response.status_code == 200
+    assert response.json() == {
+        "host": "testserver",
+        "save_data": True,
+        "if_modified_since": "yesterday",
+        "traceparent": "123",
+        "x_tag": ["one", "two"],
+    }
+
+
+def test_header_param_model_defaults(client: TestClient):
+    response = client.get("/items/", headers=[("save-data", "true")])
+    assert response.status_code == 200
+    assert response.json() == {
+        "host": "testserver",
+        "save_data": True,
+        "if_modified_since": None,
+        "traceparent": None,
+        "x_tag": [],
+    }
+
+
+def test_header_param_model_invalid(client: TestClient):
+    response = client.get("/items/")
+    assert response.status_code == 422
+    assert response.json() == snapshot(
+        {
+            "detail": [
+                IsDict(
+                    {
+                        "type": "missing",
+                        "loc": ["header", "save_data"],
+                        "msg": "Field required",
+                        "input": {
+                            "x_tag": [],
+                            "host": "testserver",
+                            "accept": "*/*",
+                            "accept-encoding": "gzip, deflate",
+                            "connection": "keep-alive",
+                            "user-agent": "testclient",
+                        },
+                    }
+                )
+                | IsDict(
+                    # TODO: remove when deprecating Pydantic v1
+                    {
+                        "type": "value_error.missing",
+                        "loc": ["header", "save_data"],
+                        "msg": "field required",
+                    }
+                )
+            ]
+        }
+    )
+
+
+def test_header_param_model_extra(client: TestClient):
+    response = client.get(
+        "/items/", headers=[("save-data", "true"), ("tool", "plumbus")]
+    )
+    assert response.status_code == 200, response.text
+    assert response.json() == snapshot(
+        {
+            "host": "testserver",
+            "save_data": True,
+            "if_modified_since": None,
+            "traceparent": None,
+            "x_tag": [],
+        }
+    )
+
+
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == snapshot(
+        {
+            "openapi": "3.1.0",
+            "info": {"title": "FastAPI", "version": "0.1.0"},
+            "paths": {
+                "/items/": {
+                    "get": {
+                        "summary": "Read Items",
+                        "operationId": "read_items_items__get",
+                        "parameters": [
+                            {
+                                "name": "host",
+                                "in": "header",
+                                "required": True,
+                                "schema": {"type": "string", "title": "Host"},
+                            },
+                            {
+                                "name": "save_data",
+                                "in": "header",
+                                "required": True,
+                                "schema": {"type": "boolean", "title": "Save Data"},
+                            },
+                            {
+                                "name": "if_modified_since",
+                                "in": "header",
+                                "required": False,
+                                "schema": IsDict(
+                                    {
+                                        "anyOf": [{"type": "string"}, {"type": "null"}],
+                                        "title": "If Modified Since",
+                                    }
+                                )
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "type": "string",
+                                        "title": "If Modified Since",
+                                    }
+                                ),
+                            },
+                            {
+                                "name": "traceparent",
+                                "in": "header",
+                                "required": False,
+                                "schema": IsDict(
+                                    {
+                                        "anyOf": [{"type": "string"}, {"type": "null"}],
+                                        "title": "Traceparent",
+                                    }
+                                )
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "type": "string",
+                                        "title": "Traceparent",
+                                    }
+                                ),
+                            },
+                            {
+                                "name": "x_tag",
+                                "in": "header",
+                                "required": False,
+                                "schema": {
+                                    "type": "array",
+                                    "items": {"type": "string"},
+                                    "default": [],
+                                    "title": "X Tag",
+                                },
+                            },
+                        ],
+                        "responses": {
+                            "200": {
+                                "description": "Successful Response",
+                                "content": {"application/json": {"schema": {}}},
+                            },
+                            "422": {
+                                "description": "Validation Error",
+                                "content": {
+                                    "application/json": {
+                                        "schema": {
+                                            "$ref": "#/components/schemas/HTTPValidationError"
+                                        }
+                                    }
+                                },
+                            },
+                        },
+                    }
+                }
+            },
+            "components": {
+                "schemas": {
+                    "HTTPValidationError": {
+                        "properties": {
+                            "detail": {
+                                "items": {
+                                    "$ref": "#/components/schemas/ValidationError"
+                                },
+                                "type": "array",
+                                "title": "Detail",
+                            }
+                        },
+                        "type": "object",
+                        "title": "HTTPValidationError",
+                    },
+                    "ValidationError": {
+                        "properties": {
+                            "loc": {
+                                "items": {
+                                    "anyOf": [{"type": "string"}, {"type": "integer"}]
+                                },
+                                "type": "array",
+                                "title": "Location",
+                            },
+                            "msg": {"type": "string", "title": "Message"},
+                            "type": {"type": "string", "title": "Error Type"},
+                        },
+                        "type": "object",
+                        "required": ["loc", "msg", "type"],
+                        "title": "ValidationError",
+                    },
+                }
+            },
+        }
+    )
diff --git a/tests/test_tutorial/test_header_param_models/test_tutorial002.py b/tests/test_tutorial/test_header_param_models/test_tutorial002.py
new file mode 100644
index 000000000..e07655a0c
--- /dev/null
+++ b/tests/test_tutorial/test_header_param_models/test_tutorial002.py
@@ -0,0 +1,249 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310, needs_pydanticv1, needs_pydanticv2
+
+
+@pytest.fixture(
+    name="client",
+    params=[
+        pytest.param("tutorial002", marks=needs_pydanticv2),
+        pytest.param("tutorial002_py310", marks=[needs_py310, needs_pydanticv2]),
+        pytest.param("tutorial002_an", marks=needs_pydanticv2),
+        pytest.param("tutorial002_an_py39", marks=[needs_py39, needs_pydanticv2]),
+        pytest.param("tutorial002_an_py310", marks=[needs_py310, needs_pydanticv2]),
+        pytest.param("tutorial002_pv1", marks=[needs_pydanticv1, needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_py310", marks=[needs_py310, needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_an", marks=[needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_an_py39", marks=[needs_py39, needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_an_py310", marks=[needs_py310, needs_pydanticv1]),
+    ],
+)
+def get_client(request: pytest.FixtureRequest):
+    mod = importlib.import_module(f"docs_src.header_param_models.{request.param}")
+
+    client = TestClient(mod.app)
+    client.headers.clear()
+    return client
+
+
+def test_header_param_model(client: TestClient):
+    response = client.get(
+        "/items/",
+        headers=[
+            ("save-data", "true"),
+            ("if-modified-since", "yesterday"),
+            ("traceparent", "123"),
+            ("x-tag", "one"),
+            ("x-tag", "two"),
+        ],
+    )
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "host": "testserver",
+        "save_data": True,
+        "if_modified_since": "yesterday",
+        "traceparent": "123",
+        "x_tag": ["one", "two"],
+    }
+
+
+def test_header_param_model_defaults(client: TestClient):
+    response = client.get("/items/", headers=[("save-data", "true")])
+    assert response.status_code == 200
+    assert response.json() == {
+        "host": "testserver",
+        "save_data": True,
+        "if_modified_since": None,
+        "traceparent": None,
+        "x_tag": [],
+    }
+
+
+def test_header_param_model_invalid(client: TestClient):
+    response = client.get("/items/")
+    assert response.status_code == 422
+    assert response.json() == snapshot(
+        {
+            "detail": [
+                IsDict(
+                    {
+                        "type": "missing",
+                        "loc": ["header", "save_data"],
+                        "msg": "Field required",
+                        "input": {"x_tag": [], "host": "testserver"},
+                    }
+                )
+                | IsDict(
+                    # TODO: remove when deprecating Pydantic v1
+                    {
+                        "type": "value_error.missing",
+                        "loc": ["header", "save_data"],
+                        "msg": "field required",
+                    }
+                )
+            ]
+        }
+    )
+
+
+def test_header_param_model_extra(client: TestClient):
+    response = client.get(
+        "/items/", headers=[("save-data", "true"), ("tool", "plumbus")]
+    )
+    assert response.status_code == 422, response.text
+    assert response.json() == snapshot(
+        {
+            "detail": [
+                IsDict(
+                    {
+                        "type": "extra_forbidden",
+                        "loc": ["header", "tool"],
+                        "msg": "Extra inputs are not permitted",
+                        "input": "plumbus",
+                    }
+                )
+                | IsDict(
+                    # TODO: remove when deprecating Pydantic v1
+                    {
+                        "type": "value_error.extra",
+                        "loc": ["header", "tool"],
+                        "msg": "extra fields not permitted",
+                    }
+                )
+            ]
+        }
+    )
+
+
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == snapshot(
+        {
+            "openapi": "3.1.0",
+            "info": {"title": "FastAPI", "version": "0.1.0"},
+            "paths": {
+                "/items/": {
+                    "get": {
+                        "summary": "Read Items",
+                        "operationId": "read_items_items__get",
+                        "parameters": [
+                            {
+                                "name": "host",
+                                "in": "header",
+                                "required": True,
+                                "schema": {"type": "string", "title": "Host"},
+                            },
+                            {
+                                "name": "save_data",
+                                "in": "header",
+                                "required": True,
+                                "schema": {"type": "boolean", "title": "Save Data"},
+                            },
+                            {
+                                "name": "if_modified_since",
+                                "in": "header",
+                                "required": False,
+                                "schema": IsDict(
+                                    {
+                                        "anyOf": [{"type": "string"}, {"type": "null"}],
+                                        "title": "If Modified Since",
+                                    }
+                                )
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "type": "string",
+                                        "title": "If Modified Since",
+                                    }
+                                ),
+                            },
+                            {
+                                "name": "traceparent",
+                                "in": "header",
+                                "required": False,
+                                "schema": IsDict(
+                                    {
+                                        "anyOf": [{"type": "string"}, {"type": "null"}],
+                                        "title": "Traceparent",
+                                    }
+                                )
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "type": "string",
+                                        "title": "Traceparent",
+                                    }
+                                ),
+                            },
+                            {
+                                "name": "x_tag",
+                                "in": "header",
+                                "required": False,
+                                "schema": {
+                                    "type": "array",
+                                    "items": {"type": "string"},
+                                    "default": [],
+                                    "title": "X Tag",
+                                },
+                            },
+                        ],
+                        "responses": {
+                            "200": {
+                                "description": "Successful Response",
+                                "content": {"application/json": {"schema": {}}},
+                            },
+                            "422": {
+                                "description": "Validation Error",
+                                "content": {
+                                    "application/json": {
+                                        "schema": {
+                                            "$ref": "#/components/schemas/HTTPValidationError"
+                                        }
+                                    }
+                                },
+                            },
+                        },
+                    }
+                }
+            },
+            "components": {
+                "schemas": {
+                    "HTTPValidationError": {
+                        "properties": {
+                            "detail": {
+                                "items": {
+                                    "$ref": "#/components/schemas/ValidationError"
+                                },
+                                "type": "array",
+                                "title": "Detail",
+                            }
+                        },
+                        "type": "object",
+                        "title": "HTTPValidationError",
+                    },
+                    "ValidationError": {
+                        "properties": {
+                            "loc": {
+                                "items": {
+                                    "anyOf": [{"type": "string"}, {"type": "integer"}]
+                                },
+                                "type": "array",
+                                "title": "Location",
+                            },
+                            "msg": {"type": "string", "title": "Message"},
+                            "type": {"type": "string", "title": "Error Type"},
+                        },
+                        "type": "object",
+                        "required": ["loc", "msg", "type"],
+                        "title": "ValidationError",
+                    },
+                }
+            },
+        }
+    )
diff --git a/tests/test_tutorial/test_query_param_models/__init__.py b/tests/test_tutorial/test_query_param_models/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_query_param_models/test_tutorial001.py b/tests/test_tutorial/test_query_param_models/test_tutorial001.py
new file mode 100644
index 000000000..5b7bc7b42
--- /dev/null
+++ b/tests/test_tutorial/test_query_param_models/test_tutorial001.py
@@ -0,0 +1,260 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310
+
+
+@pytest.fixture(
+    name="client",
+    params=[
+        "tutorial001",
+        pytest.param("tutorial001_py39", marks=needs_py39),
+        pytest.param("tutorial001_py310", marks=needs_py310),
+        "tutorial001_an",
+        pytest.param("tutorial001_an_py39", marks=needs_py39),
+        pytest.param("tutorial001_an_py310", marks=needs_py310),
+    ],
+)
+def get_client(request: pytest.FixtureRequest):
+    mod = importlib.import_module(f"docs_src.query_param_models.{request.param}")
+
+    client = TestClient(mod.app)
+    return client
+
+
+def test_query_param_model(client: TestClient):
+    response = client.get(
+        "/items/",
+        params={
+            "limit": 10,
+            "offset": 5,
+            "order_by": "updated_at",
+            "tags": ["tag1", "tag2"],
+        },
+    )
+    assert response.status_code == 200
+    assert response.json() == {
+        "limit": 10,
+        "offset": 5,
+        "order_by": "updated_at",
+        "tags": ["tag1", "tag2"],
+    }
+
+
+def test_query_param_model_defaults(client: TestClient):
+    response = client.get("/items/")
+    assert response.status_code == 200
+    assert response.json() == {
+        "limit": 100,
+        "offset": 0,
+        "order_by": "created_at",
+        "tags": [],
+    }
+
+
+def test_query_param_model_invalid(client: TestClient):
+    response = client.get(
+        "/items/",
+        params={
+            "limit": 150,
+            "offset": -1,
+            "order_by": "invalid",
+        },
+    )
+    assert response.status_code == 422
+    assert response.json() == snapshot(
+        IsDict(
+            {
+                "detail": [
+                    {
+                        "type": "less_than_equal",
+                        "loc": ["query", "limit"],
+                        "msg": "Input should be less than or equal to 100",
+                        "input": "150",
+                        "ctx": {"le": 100},
+                    },
+                    {
+                        "type": "greater_than_equal",
+                        "loc": ["query", "offset"],
+                        "msg": "Input should be greater than or equal to 0",
+                        "input": "-1",
+                        "ctx": {"ge": 0},
+                    },
+                    {
+                        "type": "literal_error",
+                        "loc": ["query", "order_by"],
+                        "msg": "Input should be 'created_at' or 'updated_at'",
+                        "input": "invalid",
+                        "ctx": {"expected": "'created_at' or 'updated_at'"},
+                    },
+                ]
+            }
+        )
+        | IsDict(
+            # TODO: remove when deprecating Pydantic v1
+            {
+                "detail": [
+                    {
+                        "type": "value_error.number.not_le",
+                        "loc": ["query", "limit"],
+                        "msg": "ensure this value is less than or equal to 100",
+                        "ctx": {"limit_value": 100},
+                    },
+                    {
+                        "type": "value_error.number.not_ge",
+                        "loc": ["query", "offset"],
+                        "msg": "ensure this value is greater than or equal to 0",
+                        "ctx": {"limit_value": 0},
+                    },
+                    {
+                        "type": "value_error.const",
+                        "loc": ["query", "order_by"],
+                        "msg": "unexpected value; permitted: 'created_at', 'updated_at'",
+                        "ctx": {
+                            "given": "invalid",
+                            "permitted": ["created_at", "updated_at"],
+                        },
+                    },
+                ]
+            }
+        )
+    )
+
+
+def test_query_param_model_extra(client: TestClient):
+    response = client.get(
+        "/items/",
+        params={
+            "limit": 10,
+            "offset": 5,
+            "order_by": "updated_at",
+            "tags": ["tag1", "tag2"],
+            "tool": "plumbus",
+        },
+    )
+    assert response.status_code == 200
+    assert response.json() == {
+        "limit": 10,
+        "offset": 5,
+        "order_by": "updated_at",
+        "tags": ["tag1", "tag2"],
+    }
+
+
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == snapshot(
+        {
+            "openapi": "3.1.0",
+            "info": {"title": "FastAPI", "version": "0.1.0"},
+            "paths": {
+                "/items/": {
+                    "get": {
+                        "summary": "Read Items",
+                        "operationId": "read_items_items__get",
+                        "parameters": [
+                            {
+                                "name": "limit",
+                                "in": "query",
+                                "required": False,
+                                "schema": {
+                                    "type": "integer",
+                                    "maximum": 100,
+                                    "exclusiveMinimum": 0,
+                                    "default": 100,
+                                    "title": "Limit",
+                                },
+                            },
+                            {
+                                "name": "offset",
+                                "in": "query",
+                                "required": False,
+                                "schema": {
+                                    "type": "integer",
+                                    "minimum": 0,
+                                    "default": 0,
+                                    "title": "Offset",
+                                },
+                            },
+                            {
+                                "name": "order_by",
+                                "in": "query",
+                                "required": False,
+                                "schema": {
+                                    "enum": ["created_at", "updated_at"],
+                                    "type": "string",
+                                    "default": "created_at",
+                                    "title": "Order By",
+                                },
+                            },
+                            {
+                                "name": "tags",
+                                "in": "query",
+                                "required": False,
+                                "schema": {
+                                    "type": "array",
+                                    "items": {"type": "string"},
+                                    "default": [],
+                                    "title": "Tags",
+                                },
+                            },
+                        ],
+                        "responses": {
+                            "200": {
+                                "description": "Successful Response",
+                                "content": {"application/json": {"schema": {}}},
+                            },
+                            "422": {
+                                "description": "Validation Error",
+                                "content": {
+                                    "application/json": {
+                                        "schema": {
+                                            "$ref": "#/components/schemas/HTTPValidationError"
+                                        }
+                                    }
+                                },
+                            },
+                        },
+                    }
+                }
+            },
+            "components": {
+                "schemas": {
+                    "HTTPValidationError": {
+                        "properties": {
+                            "detail": {
+                                "items": {
+                                    "$ref": "#/components/schemas/ValidationError"
+                                },
+                                "type": "array",
+                                "title": "Detail",
+                            }
+                        },
+                        "type": "object",
+                        "title": "HTTPValidationError",
+                    },
+                    "ValidationError": {
+                        "properties": {
+                            "loc": {
+                                "items": {
+                                    "anyOf": [{"type": "string"}, {"type": "integer"}]
+                                },
+                                "type": "array",
+                                "title": "Location",
+                            },
+                            "msg": {"type": "string", "title": "Message"},
+                            "type": {"type": "string", "title": "Error Type"},
+                        },
+                        "type": "object",
+                        "required": ["loc", "msg", "type"],
+                        "title": "ValidationError",
+                    },
+                }
+            },
+        }
+    )
diff --git a/tests/test_tutorial/test_query_param_models/test_tutorial002.py b/tests/test_tutorial/test_query_param_models/test_tutorial002.py
new file mode 100644
index 000000000..4432c9d8a
--- /dev/null
+++ b/tests/test_tutorial/test_query_param_models/test_tutorial002.py
@@ -0,0 +1,282 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310, needs_pydanticv1, needs_pydanticv2
+
+
+@pytest.fixture(
+    name="client",
+    params=[
+        pytest.param("tutorial002", marks=needs_pydanticv2),
+        pytest.param("tutorial002_py39", marks=[needs_py39, needs_pydanticv2]),
+        pytest.param("tutorial002_py310", marks=[needs_py310, needs_pydanticv2]),
+        pytest.param("tutorial002_an", marks=needs_pydanticv2),
+        pytest.param("tutorial002_an_py39", marks=[needs_py39, needs_pydanticv2]),
+        pytest.param("tutorial002_an_py310", marks=[needs_py310, needs_pydanticv2]),
+        pytest.param("tutorial002_pv1", marks=[needs_pydanticv1, needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_py39", marks=[needs_py39, needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_py310", marks=[needs_py310, needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_an", marks=[needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_an_py39", marks=[needs_py39, needs_pydanticv1]),
+        pytest.param("tutorial002_pv1_an_py310", marks=[needs_py310, needs_pydanticv1]),
+    ],
+)
+def get_client(request: pytest.FixtureRequest):
+    mod = importlib.import_module(f"docs_src.query_param_models.{request.param}")
+
+    client = TestClient(mod.app)
+    return client
+
+
+def test_query_param_model(client: TestClient):
+    response = client.get(
+        "/items/",
+        params={
+            "limit": 10,
+            "offset": 5,
+            "order_by": "updated_at",
+            "tags": ["tag1", "tag2"],
+        },
+    )
+    assert response.status_code == 200
+    assert response.json() == {
+        "limit": 10,
+        "offset": 5,
+        "order_by": "updated_at",
+        "tags": ["tag1", "tag2"],
+    }
+
+
+def test_query_param_model_defaults(client: TestClient):
+    response = client.get("/items/")
+    assert response.status_code == 200
+    assert response.json() == {
+        "limit": 100,
+        "offset": 0,
+        "order_by": "created_at",
+        "tags": [],
+    }
+
+
+def test_query_param_model_invalid(client: TestClient):
+    response = client.get(
+        "/items/",
+        params={
+            "limit": 150,
+            "offset": -1,
+            "order_by": "invalid",
+        },
+    )
+    assert response.status_code == 422
+    assert response.json() == snapshot(
+        IsDict(
+            {
+                "detail": [
+                    {
+                        "type": "less_than_equal",
+                        "loc": ["query", "limit"],
+                        "msg": "Input should be less than or equal to 100",
+                        "input": "150",
+                        "ctx": {"le": 100},
+                    },
+                    {
+                        "type": "greater_than_equal",
+                        "loc": ["query", "offset"],
+                        "msg": "Input should be greater than or equal to 0",
+                        "input": "-1",
+                        "ctx": {"ge": 0},
+                    },
+                    {
+                        "type": "literal_error",
+                        "loc": ["query", "order_by"],
+                        "msg": "Input should be 'created_at' or 'updated_at'",
+                        "input": "invalid",
+                        "ctx": {"expected": "'created_at' or 'updated_at'"},
+                    },
+                ]
+            }
+        )
+        | IsDict(
+            # TODO: remove when deprecating Pydantic v1
+            {
+                "detail": [
+                    {
+                        "type": "value_error.number.not_le",
+                        "loc": ["query", "limit"],
+                        "msg": "ensure this value is less than or equal to 100",
+                        "ctx": {"limit_value": 100},
+                    },
+                    {
+                        "type": "value_error.number.not_ge",
+                        "loc": ["query", "offset"],
+                        "msg": "ensure this value is greater than or equal to 0",
+                        "ctx": {"limit_value": 0},
+                    },
+                    {
+                        "type": "value_error.const",
+                        "loc": ["query", "order_by"],
+                        "msg": "unexpected value; permitted: 'created_at', 'updated_at'",
+                        "ctx": {
+                            "given": "invalid",
+                            "permitted": ["created_at", "updated_at"],
+                        },
+                    },
+                ]
+            }
+        )
+    )
+
+
+def test_query_param_model_extra(client: TestClient):
+    response = client.get(
+        "/items/",
+        params={
+            "limit": 10,
+            "offset": 5,
+            "order_by": "updated_at",
+            "tags": ["tag1", "tag2"],
+            "tool": "plumbus",
+        },
+    )
+    assert response.status_code == 422
+    assert response.json() == snapshot(
+        {
+            "detail": [
+                IsDict(
+                    {
+                        "type": "extra_forbidden",
+                        "loc": ["query", "tool"],
+                        "msg": "Extra inputs are not permitted",
+                        "input": "plumbus",
+                    }
+                )
+                | IsDict(
+                    # TODO: remove when deprecating Pydantic v1
+                    {
+                        "type": "value_error.extra",
+                        "loc": ["query", "tool"],
+                        "msg": "extra fields not permitted",
+                    }
+                )
+            ]
+        }
+    )
+
+
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == snapshot(
+        {
+            "openapi": "3.1.0",
+            "info": {"title": "FastAPI", "version": "0.1.0"},
+            "paths": {
+                "/items/": {
+                    "get": {
+                        "summary": "Read Items",
+                        "operationId": "read_items_items__get",
+                        "parameters": [
+                            {
+                                "name": "limit",
+                                "in": "query",
+                                "required": False,
+                                "schema": {
+                                    "type": "integer",
+                                    "maximum": 100,
+                                    "exclusiveMinimum": 0,
+                                    "default": 100,
+                                    "title": "Limit",
+                                },
+                            },
+                            {
+                                "name": "offset",
+                                "in": "query",
+                                "required": False,
+                                "schema": {
+                                    "type": "integer",
+                                    "minimum": 0,
+                                    "default": 0,
+                                    "title": "Offset",
+                                },
+                            },
+                            {
+                                "name": "order_by",
+                                "in": "query",
+                                "required": False,
+                                "schema": {
+                                    "enum": ["created_at", "updated_at"],
+                                    "type": "string",
+                                    "default": "created_at",
+                                    "title": "Order By",
+                                },
+                            },
+                            {
+                                "name": "tags",
+                                "in": "query",
+                                "required": False,
+                                "schema": {
+                                    "type": "array",
+                                    "items": {"type": "string"},
+                                    "default": [],
+                                    "title": "Tags",
+                                },
+                            },
+                        ],
+                        "responses": {
+                            "200": {
+                                "description": "Successful Response",
+                                "content": {"application/json": {"schema": {}}},
+                            },
+                            "422": {
+                                "description": "Validation Error",
+                                "content": {
+                                    "application/json": {
+                                        "schema": {
+                                            "$ref": "#/components/schemas/HTTPValidationError"
+                                        }
+                                    }
+                                },
+                            },
+                        },
+                    }
+                }
+            },
+            "components": {
+                "schemas": {
+                    "HTTPValidationError": {
+                        "properties": {
+                            "detail": {
+                                "items": {
+                                    "$ref": "#/components/schemas/ValidationError"
+                                },
+                                "type": "array",
+                                "title": "Detail",
+                            }
+                        },
+                        "type": "object",
+                        "title": "HTTPValidationError",
+                    },
+                    "ValidationError": {
+                        "properties": {
+                            "loc": {
+                                "items": {
+                                    "anyOf": [{"type": "string"}, {"type": "integer"}]
+                                },
+                                "type": "array",
+                                "title": "Location",
+                            },
+                            "msg": {"type": "string", "title": "Message"},
+                            "type": {"type": "string", "title": "Error Type"},
+                        },
+                        "type": "object",
+                        "required": ["loc", "msg", "type"],
+                        "title": "ValidationError",
+                    },
+                }
+            },
+        }
+    )

From 7eadeb69bdc579f7de92d0e7762a7825a5da192a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 17 Sep 2024 18:54:35 +0000
Subject: [PATCH 142/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d6d2a05b3..405d70c37 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Features
+
+* ✨ Add support for Pydantic models for parameters using `Query`, `Cookie`, `Header`. PR [#12199](https://github.com/fastapi/fastapi/pull/12199) by [@tiangolo](https://github.com/tiangolo).
+
 ### Translations
 
 * 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/http-basic-auth.md`. PR [#12195](https://github.com/fastapi/fastapi/pull/12195) by [@ceb10n](https://github.com/ceb10n).

From b36047b54ae4f965d03426872dbc1fa1f32c746b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 17 Sep 2024 21:06:26 +0200
Subject: [PATCH 143/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 120 ++++++++++++++++++++++++++++++++++
 1 file changed, 120 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 405d70c37..722bc5008 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,126 @@ hide:
 
 ## Latest Changes
 
+### Highlights
+
+Now you can declare `Query`, `Header`, and `Cookie` parameters with Pydantic models. 🎉
+
+#### `Query` Parameter Models
+
+Use Pydantic models for `Query` parameters:
+
+```python
+from typing import Annotated, Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
+```
+
+Read the new docs: [Query Parameter Models](https://fastapi.tiangolo.com/tutorial/query-param-models/).
+
+#### `Header` Parameter Models
+
+Use Pydantic models for `Header` parameters:
+
+```python
+from typing import Annotated
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+    host: str
+    save_data: bool
+    if_modified_since: str | None = None
+    traceparent: str | None = None
+    x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+    return headers
+```
+
+Read the new docs: [Header Parameter Models](https://fastapi.tiangolo.com/tutorial/header-param-models/).
+
+#### `Cookie` Parameter Models
+
+Use Pydantic models for `Cookie` parameters:
+
+```python
+from typing import Annotated
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+    session_id: str
+    fatebook_tracker: str | None = None
+    googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+    return cookies
+```
+
+Read the new docs: [Cookie Parameter Models](https://fastapi.tiangolo.com/tutorial/cookie-param-models/).
+
+#### Forbid Extra Query (Cookie, Header) Parameters
+
+Use Pydantic models to restrict extra values for `Query` parameters (also applies to `Header` and `Cookie` parameters).
+
+To achieve it, use Pydantic's `model_config = {"extra": "forbid"}`:
+
+```python
+from typing import Annotated, Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    limit: int = Field(100, gt=0, le=100)
+    offset: int = Field(0, ge=0)
+    order_by: Literal["created_at", "updated_at"] = "created_at"
+    tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+    return filter_query
+```
+
+This applies to `Query`, `Header`, and `Cookie` parameters, read the new docs:
+
+* [Forbid Extra Query Parameters](https://fastapi.tiangolo.com/tutorial/query-param-models/#forbid-extra-query-parameters)
+* [Forbid Extra Headers](https://fastapi.tiangolo.com/tutorial/header-param-models/#forbid-extra-headers)
+* [Forbid Extra Cookies](https://fastapi.tiangolo.com/tutorial/cookie-param-models/#forbid-extra-cookies)
+
 ### Features
 
 * ✨ Add support for Pydantic models for parameters using `Query`, `Cookie`, `Header`. PR [#12199](https://github.com/fastapi/fastapi/pull/12199) by [@tiangolo](https://github.com/tiangolo).

From 40e33e492dbf4af6172997f4e3238a32e56cbe26 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 17 Sep 2024 21:07:35 +0200
Subject: [PATCH 144/146] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
 =?UTF-8?q?5.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 fastapi/__init__.py           | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 722bc5008..ea7ac9215 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.115.0
+
 ### Highlights
 
 Now you can declare `Query`, `Header`, and `Cookie` parameters with Pydantic models. 🎉
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 3925d3603..7dd74c28f 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.114.2"
+__version__ = "0.115.0"
 
 from starlette import status as status
 

From 42e0e368bca7bf94f425c4bd2eca0b4ac4b5cab0 Mon Sep 17 00:00:00 2001
From: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
Date: Wed, 18 Sep 2024 18:09:57 +0200
Subject: [PATCH 145/146] =?UTF-8?q?=F0=9F=93=9D=20Fix=20small=20typos=20in?=
 =?UTF-8?q?=20the=20documentation=20(#12213)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/advanced/additional-responses.md               | 2 +-
 docs/en/docs/advanced/async-tests.md                        | 2 +-
 docs/en/docs/advanced/behind-a-proxy.md                     | 2 +-
 docs/en/docs/advanced/custom-response.md                    | 6 +++---
 docs/en/docs/advanced/middleware.md                         | 4 ++--
 .../docs/advanced/path-operation-advanced-configuration.md  | 2 +-
 docs/en/docs/advanced/response-directly.md                  | 2 +-
 docs/en/docs/advanced/security/http-basic-auth.md           | 2 +-
 docs/en/docs/advanced/security/oauth2-scopes.md             | 2 +-
 docs/en/docs/advanced/settings.md                           | 2 +-
 docs/en/docs/deployment/concepts.md                         | 2 +-
 docs/en/docs/deployment/docker.md                           | 2 +-
 docs/en/docs/deployment/server-workers.md                   | 2 +-
 docs/en/docs/release-notes.md                               | 2 +-
 14 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/docs/en/docs/advanced/additional-responses.md b/docs/en/docs/advanced/additional-responses.md
index 674f0672c..4fec41213 100644
--- a/docs/en/docs/advanced/additional-responses.md
+++ b/docs/en/docs/advanced/additional-responses.md
@@ -18,7 +18,7 @@ But for those additional responses you have to make sure you return a `Response`
 
 You can pass to your *path operation decorators* a parameter `responses`.
 
-It receives a `dict`, the keys are status codes for each response, like `200`, and the values are other `dict`s with the information for each of them.
+It receives a `dict`: the keys are status codes for each response (like `200`), and the values are other `dict`s with the information for each of them.
 
 Each of those response `dict`s can have a key `model`, containing a Pydantic model, just like `response_model`.
 
diff --git a/docs/en/docs/advanced/async-tests.md b/docs/en/docs/advanced/async-tests.md
index 580d9142c..a528c80fe 100644
--- a/docs/en/docs/advanced/async-tests.md
+++ b/docs/en/docs/advanced/async-tests.md
@@ -102,6 +102,6 @@ As the testing function is now asynchronous, you can now also call (and `await`)
 
 /// tip
 
-If you encounter a `RuntimeError: Task attached to a different loop` when integrating asynchronous function calls in your tests (e.g. when using <a href="https://stackoverflow.com/questions/41584243/runtimeerror-task-attached-to-a-different-loop" class="external-link" target="_blank">MongoDB's MotorClient</a>) Remember to instantiate objects that need an event loop only within async functions, e.g. an `'@app.on_event("startup")` callback.
+If you encounter a `RuntimeError: Task attached to a different loop` when integrating asynchronous function calls in your tests (e.g. when using <a href="https://stackoverflow.com/questions/41584243/runtimeerror-task-attached-to-a-different-loop" class="external-link" target="_blank">MongoDB's MotorClient</a>), remember to instantiate objects that need an event loop only within async functions, e.g. an `'@app.on_event("startup")` callback.
 
 ///
diff --git a/docs/en/docs/advanced/behind-a-proxy.md b/docs/en/docs/advanced/behind-a-proxy.md
index 5ff64016c..e642b1910 100644
--- a/docs/en/docs/advanced/behind-a-proxy.md
+++ b/docs/en/docs/advanced/behind-a-proxy.md
@@ -303,7 +303,7 @@ This is a more advanced use case. Feel free to skip it.
 
 By default, **FastAPI** will create a `server` in the OpenAPI schema with the URL for the `root_path`.
 
-But you can also provide other alternative `servers`, for example if you want *the same* docs UI to interact with a staging and production environments.
+But you can also provide other alternative `servers`, for example if you want *the same* docs UI to interact with both a staging and a production environment.
 
 If you pass a custom list of `servers` and there's a `root_path` (because your API lives behind a proxy), **FastAPI** will insert a "server" with this `root_path` at the beginning of the list.
 
diff --git a/docs/en/docs/advanced/custom-response.md b/docs/en/docs/advanced/custom-response.md
index 79f755815..1cefe979f 100644
--- a/docs/en/docs/advanced/custom-response.md
+++ b/docs/en/docs/advanced/custom-response.md
@@ -142,7 +142,7 @@ It accepts the following parameters:
 * `headers` - A `dict` of strings.
 * `media_type` - A `str` giving the media type. E.g. `"text/html"`.
 
-FastAPI (actually Starlette) will automatically include a Content-Length header. It will also include a Content-Type header, based on the media_type and appending a charset for text types.
+FastAPI (actually Starlette) will automatically include a Content-Length header. It will also include a Content-Type header, based on the `media_type` and appending a charset for text types.
 
 ```Python hl_lines="1  18"
 {!../../../docs_src/response_directly/tutorial002.py!}
@@ -154,7 +154,7 @@ Takes some text or bytes and returns an HTML response, as you read above.
 
 ### `PlainTextResponse`
 
-Takes some text or bytes and returns an plain text response.
+Takes some text or bytes and returns a plain text response.
 
 ```Python hl_lines="2  7  9"
 {!../../../docs_src/custom_response/tutorial005.py!}
@@ -273,7 +273,7 @@ Asynchronously streams a file as the response.
 
 Takes a different set of arguments to instantiate than the other response types:
 
-* `path` - The filepath to the file to stream.
+* `path` - The file path to the file to stream.
 * `headers` - Any custom headers to include, as a dictionary.
 * `media_type` - A string giving the media type. If unset, the filename or path will be used to infer a media type.
 * `filename` - If set, this will be included in the response `Content-Disposition`.
diff --git a/docs/en/docs/advanced/middleware.md b/docs/en/docs/advanced/middleware.md
index 70415adca..ab7778db0 100644
--- a/docs/en/docs/advanced/middleware.md
+++ b/docs/en/docs/advanced/middleware.md
@@ -24,7 +24,7 @@ app = SomeASGIApp()
 new_app = UnicornMiddleware(app, some_config="rainbow")
 ```
 
-But FastAPI (actually Starlette) provides a simpler way to do it that makes sure that the internal middlewares to handle server errors and custom exception handlers work properly.
+But FastAPI (actually Starlette) provides a simpler way to do it that makes sure that the internal middlewares handle server errors and custom exception handlers work properly.
 
 For that, you use `app.add_middleware()` (as in the example for CORS).
 
@@ -55,7 +55,7 @@ For the next examples, you could also use `from starlette.middleware.something i
 
 Enforces that all incoming requests must either be `https` or `wss`.
 
-Any incoming requests to `http` or `ws` will be redirected to the secure scheme instead.
+Any incoming request to `http` or `ws` will be redirected to the secure scheme instead.
 
 ```Python hl_lines="2  6"
 {!../../../docs_src/advanced_middleware/tutorial001.py!}
diff --git a/docs/en/docs/advanced/path-operation-advanced-configuration.md b/docs/en/docs/advanced/path-operation-advanced-configuration.md
index c8874bad9..d599006d2 100644
--- a/docs/en/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/en/docs/advanced/path-operation-advanced-configuration.md
@@ -149,7 +149,7 @@ For example, you could decide to read and validate the request with your own cod
 
 You could do that with `openapi_extra`:
 
-```Python hl_lines="20-37  39-40"
+```Python hl_lines="19-36  39-40"
 {!../../../docs_src/path_operation_advanced_configuration/tutorial006.py!}
 ```
 
diff --git a/docs/en/docs/advanced/response-directly.md b/docs/en/docs/advanced/response-directly.md
index 2251659c5..092aeceb1 100644
--- a/docs/en/docs/advanced/response-directly.md
+++ b/docs/en/docs/advanced/response-directly.md
@@ -28,7 +28,7 @@ This gives you a lot of flexibility. You can return any data type, override any
 
 ## Using the `jsonable_encoder` in a `Response`
 
-Because **FastAPI** doesn't do any change to a `Response` you return, you have to make sure its contents are ready for it.
+Because **FastAPI** doesn't make any changes to a `Response` you return, you have to make sure its contents are ready for it.
 
 For example, you cannot put a Pydantic model in a `JSONResponse` without first converting it to a `dict` with all the data types (like `datetime`, `UUID`, etc) converted to JSON-compatible types.
 
diff --git a/docs/en/docs/advanced/security/http-basic-auth.md b/docs/en/docs/advanced/security/http-basic-auth.md
index c302bf8dc..e669d10d8 100644
--- a/docs/en/docs/advanced/security/http-basic-auth.md
+++ b/docs/en/docs/advanced/security/http-basic-auth.md
@@ -144,7 +144,7 @@ And then they can try again knowing that it's probably something more similar to
 
 #### A "professional" attack
 
-Of course, the attackers would not try all this by hand, they would write a program to do it, possibly with thousands or millions of tests per second. And would get just one extra correct letter at a time.
+Of course, the attackers would not try all this by hand, they would write a program to do it, possibly with thousands or millions of tests per second. And they would get just one extra correct letter at a time.
 
 But doing that, in some minutes or hours the attackers would have guessed the correct username and password, with the "help" of our application, just using the time taken to answer.
 
diff --git a/docs/en/docs/advanced/security/oauth2-scopes.md b/docs/en/docs/advanced/security/oauth2-scopes.md
index ff52d7bb8..fdd8db7b9 100644
--- a/docs/en/docs/advanced/security/oauth2-scopes.md
+++ b/docs/en/docs/advanced/security/oauth2-scopes.md
@@ -769,7 +769,7 @@ But if you are building an OAuth2 application that others would connect to (i.e.
 
 The most common is the implicit flow.
 
-The most secure is the code flow, but is more complex to implement as it requires more steps. As it is more complex, many providers end up suggesting the implicit flow.
+The most secure is the code flow, but it's more complex to implement as it requires more steps. As it is more complex, many providers end up suggesting the implicit flow.
 
 /// note
 
diff --git a/docs/en/docs/advanced/settings.md b/docs/en/docs/advanced/settings.md
index 22bf7de20..8c04d2507 100644
--- a/docs/en/docs/advanced/settings.md
+++ b/docs/en/docs/advanced/settings.md
@@ -374,7 +374,7 @@ Prefer to use the `Annotated` version if possible.
 
 ////
 
-Then for any subsequent calls of `get_settings()` in the dependencies for the next requests, instead of executing the internal code of `get_settings()` and creating a new `Settings` object, it will return the same object that was returned on the first call, again and again.
+Then for any subsequent call of `get_settings()` in the dependencies for the next requests, instead of executing the internal code of `get_settings()` and creating a new `Settings` object, it will return the same object that was returned on the first call, again and again.
 
 #### `lru_cache` Technical Details
 
diff --git a/docs/en/docs/deployment/concepts.md b/docs/en/docs/deployment/concepts.md
index 69ee71a73..e71a7487a 100644
--- a/docs/en/docs/deployment/concepts.md
+++ b/docs/en/docs/deployment/concepts.md
@@ -257,7 +257,7 @@ But in most cases, you will want to perform these steps only **once**.
 
 So, you will want to have a **single process** to perform those **previous steps**, before starting the application.
 
-And you will have to make sure that it's a single process running those previous steps *even* if afterwards, you start **multiple processes** (multiple workers) for the application itself. If those steps were run by **multiple processes**, they would **duplicate** the work by running it on **parallel**, and if the steps were something delicate like a database migration, they could cause conflicts with each other.
+And you will have to make sure that it's a single process running those previous steps *even* if afterwards, you start **multiple processes** (multiple workers) for the application itself. If those steps were run by **multiple processes**, they would **duplicate** the work by running it in **parallel**, and if the steps were something delicate like a database migration, they could cause conflicts with each other.
 
 Of course, there are some cases where there's no problem in running the previous steps multiple times, in that case, it's a lot easier to handle.
 
diff --git a/docs/en/docs/deployment/docker.md b/docs/en/docs/deployment/docker.md
index 2d832a238..b106f7ac3 100644
--- a/docs/en/docs/deployment/docker.md
+++ b/docs/en/docs/deployment/docker.md
@@ -615,6 +615,6 @@ Using container systems (e.g. with **Docker** and **Kubernetes**) it becomes fai
 * Memory
 * Previous steps before starting
 
-In most cases, you probably won't want to use any base image, and instead **build a container image from scratch** one based on the official Python Docker image.
+In most cases, you probably won't want to use any base image, and instead **build a container image from scratch** based on the official Python Docker image.
 
 Taking care of the **order** of instructions in the `Dockerfile` and the **Docker cache** you can **minimize build times**, to maximize your productivity (and avoid boredom). 😎
diff --git a/docs/en/docs/deployment/server-workers.md b/docs/en/docs/deployment/server-workers.md
index 5e369e071..622c10a30 100644
--- a/docs/en/docs/deployment/server-workers.md
+++ b/docs/en/docs/deployment/server-workers.md
@@ -139,7 +139,7 @@ From the list of deployment concepts from above, using workers would mainly help
 
 ## Containers and Docker
 
-In the next chapter about [FastAPI in Containers - Docker](docker.md){.internal-link target=_blank} I'll tell some strategies you could use to handle the other **deployment concepts**.
+In the next chapter about [FastAPI in Containers - Docker](docker.md){.internal-link target=_blank} I'll explain some strategies you could use to handle the other **deployment concepts**.
 
 I'll show you how to **build your own image from scratch** to run a single Uvicorn process. It is a simple process and is probably what you would want to do when using a distributed container management system like **Kubernetes**.
 
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ea7ac9215..5e8815e65 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -494,7 +494,7 @@ Discussed here: [#11522](https://github.com/fastapi/fastapi/pull/11522) and here
 ### Upgrades
 
 * ➖ Remove `orjson` and `ujson` from default dependencies. PR [#11842](https://github.com/tiangolo/fastapi/pull/11842) by [@tiangolo](https://github.com/tiangolo).
-    * These dependencies are still installed when you install with `pip install "fastapi[all]"`. But they not included in `pip install fastapi`.
+    * These dependencies are still installed when you install with `pip install "fastapi[all]"`. But they are not included in `pip install fastapi`.
 * 📝 Restored Swagger-UI links to use the latest version possible. PR [#11459](https://github.com/tiangolo/fastapi/pull/11459) by [@UltimateLobster](https://github.com/UltimateLobster).
 
 ### Docs

From 4d6cab3ec619ee1186b975f9520d1f396010f9a4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 18 Sep 2024 16:10:21 +0000
Subject: [PATCH 146/146] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5e8815e65..0411bbdda 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Docs
+
+* 📝 Fix small typos in the documentation. PR [#12213](https://github.com/fastapi/fastapi/pull/12213) by [@svlandeg](https://github.com/svlandeg).
+
 ## 0.115.0
 
 ### Highlights