diff --git a/.github/DISCUSSION_TEMPLATE/translations.yml b/.github/DISCUSSION_TEMPLATE/translations.yml
new file mode 100644
index 000000000..16e304d99
--- /dev/null
+++ b/.github/DISCUSSION_TEMPLATE/translations.yml
@@ -0,0 +1,45 @@
+labels: [lang-all]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thanks for your interest in helping translate the FastAPI docs! đ
+
+ Please follow these instructions carefully to propose a new language translation. đ
+
+ This structured process helps ensure translations can be properly maintained long-term.
+ - type: checkboxes
+ id: checks
+ attributes:
+ label: Initial Checks
+ description: Please confirm and check all the following options.
+ options:
+ - label: I checked that this language is not already being translated in FastAPI docs.
+ required: true
+ - label: I searched existing discussions to ensure no one else proposed this language.
+ required: true
+ - label: I am a native speaker of the language I want to help translate.
+ required: true
+ - type: input
+ id: language
+ attributes:
+ label: Target Language
+ description: What language do you want to translate the FastAPI docs into?
+ placeholder: e.g. Latin
+ validations:
+ required: true
+ - type: textarea
+ id: additional_info
+ attributes:
+ label: Additional Information
+ description: Any other relevant information about your translation proposal
+ - type: markdown
+ attributes:
+ value: |
+ Translations are automatized with AI and then reviewed by native speakers. đ¤ đ
+
+ This allows us to keep them consistent and up-to-date.
+
+ If there are several native speakers commenting on this discussion and
+ committing to help review new translations, the FastAPI team will review it
+ and potentially make it an official translation. đ
diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index 6ecdf487c..e84e4e4ab 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -53,7 +53,7 @@ jobs:
with:
python-version: "3.11"
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
@@ -95,7 +95,7 @@ jobs:
with:
python-version: "3.11"
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
diff --git a/.github/workflows/contributors.yml b/.github/workflows/contributors.yml
index 87abfe3a1..34b54b452 100644
--- a/.github/workflows/contributors.yml
+++ b/.github/workflows/contributors.yml
@@ -30,7 +30,7 @@ jobs:
with:
python-version: "3.11"
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index aec327f48..9ca69b208 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -29,7 +29,7 @@ jobs:
with:
python-version: "3.11"
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
diff --git a/.github/workflows/label-approved.yml b/.github/workflows/label-approved.yml
index 02070146c..908a9453d 100644
--- a/.github/workflows/label-approved.yml
+++ b/.github/workflows/label-approved.yml
@@ -26,7 +26,7 @@ jobs:
with:
python-version: "3.11"
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
diff --git a/.github/workflows/notify-translations.yml b/.github/workflows/notify-translations.yml
index c96992689..621d1253a 100644
--- a/.github/workflows/notify-translations.yml
+++ b/.github/workflows/notify-translations.yml
@@ -34,7 +34,7 @@ jobs:
with:
python-version: "3.11"
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
diff --git a/.github/workflows/people.yml b/.github/workflows/people.yml
index 6ec3c1ad2..c1df3455e 100644
--- a/.github/workflows/people.yml
+++ b/.github/workflows/people.yml
@@ -30,7 +30,7 @@ jobs:
with:
python-version: "3.11"
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
@@ -51,3 +51,4 @@ jobs:
run: python ./scripts/people.py
env:
GITHUB_TOKEN: ${{ secrets.FASTAPI_PEOPLE }}
+ SLEEP_INTERVAL: ${{ vars.PEOPLE_SLEEP_INTERVAL }}
diff --git a/.github/workflows/smokeshow.yml b/.github/workflows/smokeshow.yml
index a0ffd55e6..d8a5dfb30 100644
--- a/.github/workflows/smokeshow.yml
+++ b/.github/workflows/smokeshow.yml
@@ -26,7 +26,7 @@ jobs:
with:
python-version: '3.9'
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
diff --git a/.github/workflows/sponsors.yml b/.github/workflows/sponsors.yml
index a5230c834..6da4d90e1 100644
--- a/.github/workflows/sponsors.yml
+++ b/.github/workflows/sponsors.yml
@@ -30,7 +30,7 @@ jobs:
with:
python-version: "3.11"
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 5e8092641..c3940be01 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -29,7 +29,7 @@ jobs:
with:
python-version: "3.11"
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
@@ -67,7 +67,7 @@ jobs:
with:
python-version: ${{ matrix.python-version }}
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
@@ -112,7 +112,7 @@ jobs:
with:
python-version: '3.8'
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
diff --git a/.github/workflows/topic-repos.yml b/.github/workflows/topic-repos.yml
index 3c5c881f1..433aeb00b 100644
--- a/.github/workflows/topic-repos.yml
+++ b/.github/workflows/topic-repos.yml
@@ -25,7 +25,7 @@ jobs:
with:
python-version: "3.11"
- name: Setup uv
- uses: astral-sh/setup-uv@v5
+ uses: astral-sh/setup-uv@v6
with:
version: "0.4.15"
enable-cache: true
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 05c33a608..e461b0133 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.9.4
+ rev: v0.12.4
hooks:
- id: ruff
args:
diff --git a/README.md b/README.md
index 9a1260b90..b3eaa6b35 100644
--- a/README.md
+++ b/README.md
@@ -48,22 +48,21 @@ The key features are:
jinja2python-multipart"parsing" , with `request.form()`.
-Used by FastAPI / Starlette:
+Used by FastAPI:
* uvicornFastAPI Cloud .
### Without `standard` Dependencies
If you don't want to include the `standard` optional dependencies, you can install with `pip install fastapi` instead of `pip install "fastapi[standard]"`.
+### Without `fastapi-cloud-cli`
+
+If you want to install FastAPI with the standard dependencies but without the `fastapi-cloud-cli`, you can install with `pip install "fastapi[standard-no-fastapi-cloud-cli]"`.
+
### Additional Optional Dependencies
There are some additional dependencies you might want to install.
diff --git a/docs/bn/docs/about/index.md b/docs/bn/docs/about/index.md
new file mode 100644
index 000000000..b6d611ae9
--- /dev/null
+++ b/docs/bn/docs/about/index.md
@@ -0,0 +1,3 @@
+# āĻ¸āĻŽā§āĻĒāĻ°ā§āĻā§
+
+**FastAPI** āĻ¸āĻŽā§āĻĒāĻ°ā§āĻā§ āĻŦāĻŋāĻ¸ā§āĻ¤āĻžāĻ°āĻŋāĻ¤ â āĻāĻ° āĻĄāĻŋāĻāĻžāĻāĻ¨, āĻ
āĻ¨ā§āĻĒā§āĻ°ā§āĻ°āĻŖāĻž āĻ āĻāĻ°āĻ āĻ
āĻ¨ā§āĻ āĻāĻŋāĻā§āĨ¤ đ¤
diff --git a/docs/bn/docs/environment-variables.md b/docs/bn/docs/environment-variables.md
new file mode 100644
index 000000000..9122ca5bf
--- /dev/null
+++ b/docs/bn/docs/environment-variables.md
@@ -0,0 +1,298 @@
+# āĻāĻ¨āĻāĻžāĻ¯āĻŧāĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛āĻ¸
+
+/// tip
+
+āĻāĻĒāĻ¨āĻŋ āĻ¯āĻĻāĻŋ "āĻāĻ¨āĻāĻžāĻ¯āĻŧāĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛āĻ¸" āĻā§ āĻāĻŦāĻ āĻ¸ā§āĻā§āĻ˛ā§ āĻā§āĻāĻžāĻŦā§ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°āĻ¤ā§ āĻšāĻ¯āĻŧ āĻ¸ā§āĻāĻž āĻāĻžāĻ¨ā§āĻ¨, āĻ¤āĻžāĻšāĻ˛ā§ āĻāĻ āĻ
āĻāĻļāĻāĻŋ āĻ¸ā§āĻāĻŋāĻĒ āĻāĻ°ā§ āĻ¯ā§āĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ¨āĨ¤
+
+///
+
+āĻāĻ¨āĻāĻžāĻ¯āĻŧāĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ (āĻ¸āĻāĻā§āĻˇā§āĻĒā§ "**env var**" āĻ¨āĻžāĻŽā§āĻ āĻĒāĻ°āĻŋāĻāĻŋāĻ¤) āĻšāĻ˛ā§ āĻāĻŽāĻ¨ āĻāĻāĻāĻŋ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ āĻ¯āĻž āĻĒāĻžāĻāĻĨāĻ¨ āĻā§āĻĄā§āĻ° **āĻŦāĻžāĻāĻ°ā§**, **āĻ
āĻĒāĻžāĻ°ā§āĻāĻŋāĻ āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽā§** āĻĨāĻžāĻā§ āĻāĻŦāĻ āĻāĻĒāĻ¨āĻžāĻ° āĻĒāĻžāĻāĻĨāĻ¨ āĻā§āĻĄ (āĻŦāĻž āĻ
āĻ¨ā§āĻ¯āĻžāĻ¨ā§āĻ¯ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽ) āĻĻā§āĻŦāĻžāĻ°āĻž āĻ¯āĻžāĻā§ āĻ°āĻŋāĻĄ āĻāĻ°āĻž āĻ¯āĻžāĻ¯āĻŧāĨ¤
+
+āĻāĻ¨āĻāĻžāĻ¯āĻŧāĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛āĻ¸ āĻ
ā§āĻ¯āĻžāĻĒā§āĻ˛āĻŋāĻā§āĻļāĻ¨ā§āĻ° **āĻ¸ā§āĻāĻŋāĻāĻ¸** āĻĒāĻ°āĻŋāĻāĻžāĻ˛āĻ¨āĻž āĻāĻ°āĻ¤ā§, āĻĒāĻžāĻāĻĨāĻ¨ā§āĻ° **āĻāĻ¨āĻ¸ā§āĻāĻ˛ā§āĻļāĻ¨** āĻĒā§āĻ°āĻā§āĻ°āĻŋāĻ¯āĻŧāĻžāĻ° āĻ
āĻāĻļ āĻšāĻŋāĻ¸ā§āĻŦā§, āĻāĻ¤ā§āĻ¯āĻžāĻĻāĻŋ āĻāĻžāĻā§ āĻāĻĒāĻ¯ā§āĻā§ āĻšāĻ¤ā§ āĻĒāĻžāĻ°ā§āĨ¤
+
+## Env Vars āĻ¤ā§āĻ°ā§ āĻāĻŦāĻ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ°
+
+āĻāĻĒāĻ¨āĻŋ **āĻļā§āĻ˛ (āĻāĻžāĻ°ā§āĻŽāĻŋāĻ¨āĻžāĻ˛)**-āĻ, āĻĒāĻžāĻāĻĨāĻ¨ā§āĻ° āĻĒā§āĻ°āĻ¯āĻŧā§āĻāĻ¨ āĻāĻžāĻĄāĻŧāĻžāĻ, āĻāĻ¨āĻāĻžāĻ¯āĻŧāĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛āĻ¸ **āĻ¤ā§āĻ°āĻŋ** āĻāĻŦāĻ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°āĻŦā§āĻ¨āĻ
+
+//// tab | āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸, āĻŽā§āĻ¯āĻžāĻāĻāĻāĻ¸, āĻāĻāĻ¨ā§āĻĄā§āĻ Bash
+
+
+
+```console
+// āĻāĻĒāĻ¨āĻŋ āĻāĻžāĻāĻ˛ā§ MY_NAME āĻ¨āĻžāĻŽā§ āĻāĻāĻāĻŋ env var āĻ¤ā§āĻ°āĻŋ āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ¨
+$ export MY_NAME="Wade Wilson"
+
+// āĻ¤āĻžāĻ°āĻĒāĻ°ā§ āĻāĻāĻŋāĻā§ āĻāĻžāĻāĻ˛ā§ āĻ
āĻ¨ā§āĻ¯āĻžāĻ¨ā§āĻ¯ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽā§ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ¨
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+
+
+////
+
+//// tab | āĻāĻāĻ¨ā§āĻĄā§āĻ āĻĒāĻžāĻā§āĻžāĻ°āĻļā§āĻ˛
+
+
+
+```console
+// MY_NAME āĻ¨āĻžāĻŽā§ env var āĻ¤ā§āĻ°āĻŋ
+$ $Env:MY_NAME = "Wade Wilson"
+
+// āĻ
āĻ¨ā§āĻ¯āĻžāĻ¨ā§āĻ¯ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽā§ āĻāĻāĻŋāĻā§ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ°
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+
+
+////
+
+## āĻĒāĻžāĻāĻĨāĻ¨ā§ env vars āĻ°āĻŋāĻĄ āĻāĻ°āĻž
+
+āĻāĻĒāĻ¨āĻŋ āĻāĻžāĻāĻ˛ā§ āĻĒāĻžāĻāĻĨāĻ¨ā§āĻ° **āĻŦāĻžāĻāĻ°ā§**, āĻāĻžāĻ°ā§āĻŽāĻŋāĻ¨āĻžāĻ˛ā§ (āĻŦāĻž āĻ
āĻ¨ā§āĻ¯ āĻā§āĻ¨ā§ āĻāĻĒāĻžāĻ¯āĻŧā§) āĻāĻ¨āĻāĻžāĻ¯āĻŧāĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛āĻ¸ āĻ¤ā§āĻ°āĻŋ āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ¨, āĻāĻŦāĻ āĻĒāĻ°ā§ āĻ¸ā§āĻā§āĻ˛ā§ **āĻĒāĻžāĻāĻĨāĻ¨ā§ āĻ°āĻŋāĻĄ** (āĻ
ā§āĻ¯āĻžāĻā§āĻ¸ā§āĻ¸ āĻāĻ°āĻ¤ā§) āĻĒāĻžāĻ°ā§āĻ¨āĨ¤
+
+āĻāĻĻāĻžāĻšāĻ°āĻŖāĻ¸ā§āĻŦāĻ°ā§āĻĒ, āĻāĻĒāĻ¨āĻžāĻ° `main.py` āĻ¨āĻžāĻŽā§ āĻāĻāĻāĻŋ āĻĢāĻžāĻāĻ˛ āĻĨāĻžāĻāĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip
+
+`os.getenv()` āĻāĻ° āĻĻā§āĻŦāĻŋāĻ¤ā§ā§ āĻāĻ°ā§āĻā§āĻŽā§āĻ¨ā§āĻāĻāĻŋ āĻšāĻ˛ā§ āĻāĻ° āĻĄāĻŋāĻĢāĻ˛ā§āĻ āĻā§āĻ¯āĻžāĻ˛ā§ āĻ¯āĻž āĻ°āĻŋāĻāĻžāĻ°ā§āĻ¨ āĻāĻ°āĻž āĻšāĻŦā§āĨ¤
+
+āĻ¯āĻĻāĻŋ āĻāĻāĻŋ āĻĻā§āĻā§āĻž āĻ¨āĻž āĻšā§, āĻĄāĻŋāĻĢāĻ˛ā§āĻāĻāĻžāĻŦā§ `None` āĻŦā§āĻ¯āĻŦāĻšā§āĻ¤ āĻšāĻŦā§, āĻāĻāĻžāĻ¨ā§ āĻāĻŽāĻ°āĻž āĻĄāĻŋāĻĢāĻ˛ā§āĻ āĻā§āĻ¯āĻžāĻ˛ā§ āĻšāĻŋāĻ¸ā§āĻŦā§ `"World"` āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°ā§āĻāĻŋāĨ¤
+
+///
+
+āĻ¤āĻžāĻ°āĻĒāĻ°ā§ āĻĒāĻžāĻāĻĨāĻ¨ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻāĻŋāĻā§ āĻ¨āĻŋāĻŽā§āĻ¨ā§āĻā§āĻ¤āĻāĻžāĻŦā§ āĻāĻ˛ āĻāĻ°āĻž āĻ¯āĻžāĻŦā§āĻ
+
+//// tab | āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸, āĻŽā§āĻ¯āĻžāĻāĻāĻāĻ¸, āĻāĻāĻ¨ā§āĻĄā§āĻ Bash
+
+
+
+```console
+// āĻāĻāĻ¨ā§ āĻāĻŽāĻ°āĻž āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ āĻ¸ā§āĻ āĻāĻ°āĻŋāĻ¨āĻŋ
+$ python main.py
+
+// āĻ¯ā§āĻšā§āĻ¤ā§ env var āĻ¸ā§āĻ āĻāĻ°āĻž āĻšā§āĻ¨āĻŋ, āĻ¤āĻžāĻ āĻāĻŽāĻ°āĻž āĻĄāĻŋāĻĢāĻ˛ā§āĻ āĻā§āĻ¯āĻžāĻ˛ā§ āĻĒāĻžāĻā§āĻāĻŋ
+
+Hello World from Python
+
+// āĻāĻŋāĻ¨ā§āĻ¤ā§ āĻāĻŽāĻ°āĻž āĻĒā§āĻ°āĻĨāĻŽā§ āĻ¯āĻĻāĻŋ āĻāĻāĻāĻž āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻāĻžāĻ°āĻŋā§ā§āĻŦāĻ˛ āĻ¤ā§āĻ°āĻŋ āĻāĻ°ā§ āĻ¨ā§āĻ
+$ export MY_NAME="Wade Wilson"
+
+// āĻāĻŦāĻ āĻ¤āĻžāĻ°āĻĒāĻ° āĻāĻŦāĻžāĻ° āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻāĻŋāĻā§ āĻāĻ˛ āĻāĻ°āĻŋ
+$ python main.py
+
+// āĻāĻāĻ¨ āĻāĻāĻŋ āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ āĻ°āĻŋāĻĄ āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°āĻŦā§
+
+Hello Wade Wilson from Python
+```
+
+
+
+////
+
+//// tab | āĻāĻāĻ¨ā§āĻĄā§āĻ āĻĒāĻžāĻā§āĻžāĻ°āĻļā§āĻ˛
+
+
+
+```console
+// āĻāĻāĻ¨ā§ āĻāĻŽāĻ°āĻž āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ āĻ¸ā§āĻ āĻāĻ°āĻŋāĻ¨āĻŋ
+$ python main.py
+
+// āĻ¯ā§āĻšā§āĻ¤ā§ env var āĻ¸ā§āĻ āĻāĻ°āĻž āĻšā§āĻ¨āĻŋ, āĻ¤āĻžāĻ āĻāĻŽāĻ°āĻž āĻĄāĻŋāĻĢāĻ˛ā§āĻ āĻā§āĻ¯āĻžāĻ˛ā§ āĻĒāĻžāĻā§āĻāĻŋ
+
+Hello World from Python
+
+// āĻāĻŋāĻ¨ā§āĻ¤ā§ āĻāĻŽāĻ°āĻž āĻĒā§āĻ°āĻĨāĻŽā§ āĻ¯āĻĻāĻŋ āĻāĻāĻāĻž āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻāĻžāĻ°āĻŋā§ā§āĻŦāĻ˛ āĻ¤ā§āĻ°āĻŋ āĻāĻ°ā§ āĻ¨ā§āĻ
+$ $Env:MY_NAME = "Wade Wilson"
+
+// āĻāĻŦāĻ āĻ¤āĻžāĻ°āĻĒāĻ° āĻāĻŦāĻžāĻ° āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻāĻŋāĻā§ āĻāĻ˛ āĻāĻ°āĻŋ
+$ python main.py
+
+// āĻāĻāĻ¨ āĻāĻāĻŋ āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ āĻ°āĻŋāĻĄ āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°āĻŦā§
+
+Hello Wade Wilson from Python
+```
+
+
+
+////
+
+āĻ¯ā§āĻšā§āĻ¤ā§ āĻāĻ¨āĻāĻžāĻ¯āĻŧāĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛āĻ¸ āĻā§āĻĄā§āĻ° āĻŦāĻžāĻāĻ°ā§ āĻ¸ā§āĻ āĻāĻ°āĻž āĻ¯āĻžāĻ¯āĻŧ, āĻāĻŋāĻ¨ā§āĻ¤ā§ āĻĒāĻ°āĻŦāĻ°ā§āĻ¤ā§āĻ¤ā§ āĻā§āĻĄ āĻĻā§āĻŦāĻžāĻ°āĻž āĻ°āĻŋāĻĄ āĻāĻ°āĻž āĻ¯āĻžāĻ¯āĻŧ, āĻāĻŦāĻ āĻŦāĻžāĻāĻŋ āĻĢāĻžāĻāĻ˛āĻā§āĻ˛ā§āĻ° āĻ¸āĻžāĻĨā§ āĻ°āĻžāĻāĻ¤ā§ (`git` āĻ āĻāĻŽāĻŋāĻ) āĻšā§ āĻ¨āĻž, āĻ¤āĻžāĻ āĻāĻ¨āĻĢāĻŋāĻāĻžāĻ°ā§āĻļāĻ¨āĻ¸ āĻŦāĻž **āĻ¸ā§āĻāĻŋāĻāĻ¸** āĻāĻ° āĻāĻ¨ā§āĻ¯ āĻāĻā§āĻ˛ā§ āĻ¸āĻžāĻ§āĻžāĻ°āĻŖāĻ¤ āĻŦā§āĻ¯āĻŦāĻšā§āĻ¤ āĻšā§ā§ āĻĨāĻžāĻā§āĨ¤
+
+āĻāĻĒāĻ¨āĻŋ āĻāĻāĻāĻŋ āĻāĻ¨āĻāĻžāĻ¯āĻŧāĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ āĻļā§āĻ§ā§āĻŽāĻžāĻ¤ā§āĻ° āĻāĻāĻāĻŋ **āĻ¨āĻŋāĻ°ā§āĻĻāĻŋāĻˇā§āĻ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽ āĻāĻ¨āĻā§āĻā§āĻļāĻ¨ā§āĻ°** āĻāĻ¨ā§āĻ¯āĻ āĻ¤ā§āĻ°āĻŋ āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ¨, āĻ¯āĻž āĻļā§āĻ§ā§āĻŽāĻžāĻ¤ā§āĻ° āĻ¸ā§āĻ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽā§āĻ° āĻāĻ¨ā§āĻ¯āĻ āĻāĻā§āĻāĻ˛ā§āĻŦāĻ˛ āĻĨāĻžāĻāĻŦā§ āĻāĻŦāĻ āĻļā§āĻ§ā§āĻŽāĻžāĻ¤ā§āĻ° āĻ¤āĻžāĻ° āĻāĻ˛āĻžāĻāĻžāĻ˛ā§āĻ¨ āĻ¸āĻŽāĻ¯āĻŧ āĻĒāĻ°ā§āĻ¯āĻ¨ā§āĻ¤āĻ āĻ¸āĻā§āĻ°āĻŋāĻ¯āĻŧ āĻĨāĻžāĻāĻŦā§āĨ¤
+
+āĻāĻāĻŋ āĻāĻ°āĻ¤ā§, āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻāĻŋ āĻ°āĻžāĻ¨ āĻāĻ°āĻžāĻ° āĻ āĻŋāĻ āĻāĻā§āĻ, āĻāĻāĻ āĻ˛āĻžāĻāĻ¨ā§ āĻāĻ¨āĻāĻžāĻ¯āĻŧāĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ āĻ¤ā§āĻ°āĻŋ āĻāĻ°ā§āĻ¨:
+
+
+
+```console
+// āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻāĻŋ āĻāĻ˛ āĻāĻ°āĻžāĻ° āĻ¸āĻŽā§ āĻāĻāĻ āĻ˛āĻžāĻāĻ¨ā§ MY_NAME āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛ āĻ¤ā§āĻ°āĻŋ āĻāĻ°ā§āĻ¨
+$ MY_NAME="Wade Wilson" python main.py
+
+// āĻāĻāĻ¨ āĻāĻāĻŋ āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ¯āĻ°āĻŋā§ā§āĻŦāĻ˛āĻāĻŋāĻā§ āĻ°āĻŋāĻĄ āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°āĻŦā§
+
+Hello Wade Wilson from Python
+
+// āĻĒāĻ°āĻŦāĻ°ā§āĻ¤ā§āĻ¤ā§ āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛āĻāĻŋāĻā§ āĻāĻ° āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°āĻž āĻ¯āĻžāĻā§āĻā§ āĻ¨āĻž
+$ python main.py
+
+Hello World from Python
+```
+
+
+
+/// tip
+
+āĻāĻāĻŋ āĻ¨āĻŋā§ā§ āĻāĻ°ā§ āĻŦāĻŋāĻ¸ā§āĻ¤āĻžāĻ°āĻŋāĻ¤ āĻĒā§āĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ¨ āĻāĻāĻžāĻ¨ā§ The Twelve-Factor App: Config āĨ¤
+
+///
+
+## āĻāĻžāĻāĻĒāĻ¸ āĻāĻŦāĻ āĻā§āĻ¯āĻžāĻ˛āĻŋāĻĄā§āĻļāĻ¨
+
+āĻāĻ āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛āĻā§āĻ˛ā§ āĻļā§āĻ§ā§āĻŽāĻžāĻ¤ā§āĻ° **āĻā§āĻā§āĻ¸āĻ āĻ¸ā§āĻā§āĻ°āĻŋāĻāĻ¸** āĻšā§āĻ¯āĻžāĻ¨ā§āĻĄā§āĻ˛ āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°ā§, āĻ¯ā§āĻšā§āĻ¤ā§ āĻāĻā§āĻ˛ā§ āĻĒāĻžāĻāĻĨāĻ¨ā§āĻ° āĻŦāĻžāĻāĻ°ā§ āĻ
āĻŦāĻ¸ā§āĻĨāĻŋāĻ¤ āĻāĻŦāĻ āĻ
āĻ¨ā§āĻ¯āĻžāĻ¨ā§āĻ¯ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽ āĻāĻŦāĻ āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽā§āĻ° āĻŦāĻžāĻāĻŋ āĻ
āĻāĻļā§āĻ° (āĻāĻŽāĻ¨āĻāĻŋ āĻŦāĻŋāĻāĻŋāĻ¨ā§āĻ¨ āĻ
āĻĒāĻžāĻ°ā§āĻāĻŋāĻ āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽ āĻ¯ā§āĻŽāĻ¨ āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸, āĻāĻāĻ¨ā§āĻĄā§āĻ, āĻŽā§āĻ¯āĻžāĻāĻāĻāĻ¸) āĻ¸āĻžāĻĨā§ āĻ¸āĻžāĻŽāĻā§āĻāĻ¸ā§āĻ¯āĻĒā§āĻ°ā§āĻŖ āĻšāĻ¤ā§ āĻšāĻ¯āĻŧāĨ¤
+
+āĻāĻ° āĻ
āĻ°ā§āĻĨ āĻšāĻā§āĻā§ āĻĒāĻžāĻāĻĨāĻ¨ā§ āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ āĻĨā§āĻā§ āĻ°āĻŋāĻĄ āĻāĻ°āĻž **āĻ¯ā§āĻā§āĻ¨ā§ āĻā§āĻ¯āĻžāĻ˛ā§** āĻāĻāĻāĻŋ `str` āĻšāĻŦā§, āĻāĻŦāĻ āĻ
āĻ¨ā§āĻ¯ āĻā§āĻ¨ā§ āĻāĻžāĻāĻĒā§ āĻāĻ¨āĻāĻžāĻ°ā§āĻ¸āĻ¨ āĻŦāĻž āĻ¯ā§āĻā§āĻ¨ā§ āĻā§āĻ˛āĻŋāĻĄā§āĻļāĻ¨ āĻā§āĻĄā§ āĻāĻ˛āĻžāĻĻāĻžāĻāĻžāĻŦā§ āĻāĻ°āĻ¤ā§ āĻšāĻŦā§āĨ¤
+
+āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°ā§ **āĻāĻĒā§āĻ˛āĻŋāĻā§āĻļāĻ¨ āĻ¸ā§āĻāĻŋāĻāĻ¸** āĻšā§āĻ¯āĻžāĻ¨ā§āĻĄā§āĻ˛ āĻāĻ°āĻž āĻ¨āĻŋā§ā§ āĻāĻ°ā§ āĻŦāĻŋāĻ¸ā§āĻ¤āĻžāĻ°āĻŋāĻ¤ āĻāĻžāĻ¨āĻž āĻ¯āĻžāĻŦā§ [Advanced User Guide - Settings and Environment Variables](./advanced/settings.md){.internal-link target=_blank}.
+
+## `PATH` āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛
+
+**`PATH`** āĻ¨āĻžāĻŽā§ āĻāĻāĻāĻŋ **āĻŦāĻŋāĻļā§āĻˇ** āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛ āĻ°ā§ā§āĻā§, āĻ¯ā§āĻāĻŋ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽ āĻ°āĻžāĻ¨ āĻāĻ°āĻžāĻ° āĻāĻ¨ā§āĻ¯ āĻ
āĻĒāĻžāĻ°ā§āĻāĻŋāĻ āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽāĻ¸ (āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸, āĻŽā§āĻ¯āĻžāĻāĻāĻāĻ¸, āĻāĻāĻ¨ā§āĻĄā§āĻ) āĻĻā§āĻŦāĻžāĻ°āĻž āĻŦā§āĻ¯āĻŦāĻšā§āĻ¤ āĻšā§āĨ¤
+
+`PATH` āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛ āĻāĻ° āĻā§āĻ¯āĻžāĻ˛ā§ āĻšāĻā§āĻā§ āĻāĻāĻāĻŋ āĻŦāĻŋāĻļāĻžāĻ˛ āĻ¸ā§āĻā§āĻ°āĻŋāĻ āĻ¯āĻž āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋāĻā§ āĻā§āĻ˛āĻ¨ `:` āĻĻāĻŋā§ā§ āĻāĻ˛āĻžāĻĻāĻž āĻāĻ°āĻžāĻ° āĻŽāĻžāĻ§ā§āĻ¯āĻŽā§ āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸ā§ āĻ āĻŽā§āĻ¯āĻžāĻāĻāĻāĻ¸ āĻ, āĻāĻŦāĻ āĻ¸ā§āĻŽāĻŋāĻā§āĻ˛āĻ¨ `;` āĻāĻ° āĻŽāĻžāĻ§ā§āĻ¯āĻŽā§ āĻāĻāĻ¨ā§āĻĄā§āĻ āĻ āĻ¤ā§āĻ°āĻŋ āĻāĻ°āĻž āĻĨāĻžāĻā§āĨ¤
+
+āĻāĻĻāĻžāĻšāĻ°āĻŖāĻ¸ā§āĻŦāĻ°ā§āĻĒ, `PATH` āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛ āĻ¨āĻŋāĻā§āĻ° āĻŽāĻ¤ā§ āĻĻā§āĻāĻ¤ā§ āĻšāĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ
+
+//// tab | āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸, āĻŽā§āĻ¯āĻžāĻāĻāĻāĻ¸
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+āĻ¤āĻžāĻ°āĻŽāĻžāĻ¨ā§ āĻšāĻ˛ā§ āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻā§āĻ˛ā§āĻā§ āĻ¨āĻŋāĻā§āĻ° āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋāĻā§āĻ˛ā§āĻ¤ā§ āĻā§āĻāĻāĻŦā§āĻ
+
+* `/usr/local/bin`
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | āĻāĻāĻ¨ā§āĻĄā§āĻ
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+āĻ¤āĻžāĻ°āĻŽāĻžāĻ¨ā§ āĻšāĻ˛ā§ āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻā§āĻ˛ā§āĻā§ āĻ¨āĻŋāĻā§āĻ° āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋāĻā§āĻ˛ā§āĻ¤ā§ āĻā§āĻāĻāĻŦā§āĻ
+
+* `C:\Program Files\Python312\Scripts`
+* `C:\Program Files\Python312`
+* `C:\Windows\System32`
+
+////
+
+āĻ¯āĻāĻ¨ āĻāĻĒāĻ¨āĻŋ āĻāĻžāĻ°ā§āĻŽāĻŋāĻ¨āĻžāĻ˛ā§ āĻā§āĻ¨ā§ **āĻāĻŽāĻžāĻ¨ā§āĻĄ** āĻ˛āĻŋāĻāĻŦā§āĻ¨, āĻ
āĻĒāĻžāĻ°ā§āĻāĻŋāĻ āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽ **āĻĒā§āĻ°āĻ¤ā§āĻ¯ā§āĻāĻāĻŋ āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋāĻ¤ā§** āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻāĻŋ **āĻā§āĻāĻāĻŦā§** āĻ¯ā§āĻā§āĻ˛ā§ `PATH` āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛ āĻ āĻ˛āĻŋāĻ¸ā§āĻ āĻāĻ°āĻž āĻāĻā§āĨ¤
+
+āĻāĻĻāĻžāĻšāĻ°āĻŖāĻ¸ā§āĻŦāĻ°ā§āĻĒ, āĻ¯āĻāĻ¨ āĻāĻĒāĻ¨āĻŋ āĻāĻžāĻ°ā§āĻŽāĻŋāĻ¨āĻžāĻ˛ā§ `python` āĻāĻžāĻāĻĒ āĻāĻ°āĻŦā§āĻ¨, āĻ
āĻĒāĻžāĻ°ā§āĻāĻŋāĻ āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽ āĻāĻ āĻ˛āĻŋāĻ¸ā§āĻ āĻāĻ° **āĻĒā§āĻ°āĻĨāĻŽ āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋāĻ¤ā§** `python` āĻ¨āĻžāĻŽā§āĻ° āĻāĻāĻāĻŋ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽ āĻā§āĻāĻāĻŦā§āĨ¤
+
+āĻ¯āĻĻāĻŋ āĻāĻāĻŋ āĻā§āĻāĻā§ āĻĒāĻžā§, āĻ¤āĻžāĻšāĻ˛ā§ āĻāĻāĻŋ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻāĻŋāĻā§ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°āĻŦā§āĨ¤ āĻ
āĻ¨ā§āĻ¯āĻĨāĻžā§ āĻāĻāĻŋ **āĻ
āĻ¨ā§āĻ¯āĻžāĻ¨ā§āĻ¯ āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋāĻā§āĻ˛ā§āĻ¤ā§** āĻāĻāĻŋāĻā§ āĻā§āĻāĻāĻ¤ā§ āĻĨāĻžāĻāĻŦā§āĨ¤
+
+### āĻĒāĻžāĻāĻĨāĻ¨ āĻāĻ¨āĻ¸ā§āĻāĻ˛ āĻāĻŦāĻ `PATH` āĻāĻĒāĻĄā§āĻ
+
+āĻ¯āĻāĻ¨ āĻāĻĒāĻ¨āĻŋ āĻĒāĻžāĻāĻĨāĻ¨ āĻāĻ¨āĻ¸ā§āĻāĻ˛ āĻāĻ°ā§āĻ¨, āĻāĻĒāĻ¨āĻŋ `PATH` āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛ āĻāĻĒāĻĄā§āĻ āĻāĻ°āĻ¤ā§ āĻāĻžāĻ¨ āĻāĻŋāĻ¨āĻž āĻ¸ā§āĻāĻž āĻāĻŋāĻā§āĻā§āĻ¸ āĻāĻ°āĻž āĻšāĻ¤ā§ āĻĒāĻžāĻ°ā§āĨ¤
+
+//// tab | āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸, āĻŽā§āĻ¯āĻžāĻāĻāĻāĻ¸
+
+āĻ§āĻ°āĻž āĻ¯āĻžāĻ āĻāĻĒāĻ¨āĻŋ āĻĒāĻžāĻāĻĨāĻ¨ āĻāĻ¨āĻ¸ā§āĻāĻ˛ āĻāĻ°āĻ˛ā§āĻ¨ āĻāĻŦāĻ āĻāĻāĻŋ `/opt/custompython/bin` āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋāĻ¤ā§ āĻāĻ¨āĻ¸ā§āĻāĻ˛ āĻšāĻā§āĻā§āĨ¤
+
+āĻ¯āĻĻāĻŋ āĻāĻĒāĻ¨āĻŋ "Yes" āĻ¸āĻŋāĻ˛ā§āĻā§āĻ āĻāĻ°ā§ `PATH` āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛ āĻāĻĒāĻĄā§āĻ āĻāĻ°āĻ¤ā§ āĻāĻžāĻ¨, āĻ¤āĻžāĻšāĻ˛ā§ āĻāĻ¨āĻ¸ā§āĻāĻ˛āĻžāĻ° `/opt/custompython/bin` āĻā§ `PATH` āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛ āĻ āĻāĻĄ āĻāĻ°ā§ āĻĻāĻŋāĻŦā§āĨ¤
+
+āĻāĻāĻž āĻĻā§āĻāĻ¤ā§ āĻāĻŽāĻ¨āĻāĻž āĻšāĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+āĻāĻāĻāĻžāĻŦā§, āĻāĻĒāĻ¨āĻŋ āĻ¯āĻāĻ¨ āĻāĻžāĻ°ā§āĻŽāĻŋāĻ¨āĻžāĻ˛ā§ `python` āĻāĻžāĻāĻĒ āĻāĻ°ā§āĻ¨, āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽ āĻĒāĻžāĻāĻĨāĻ¨ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻāĻŋāĻā§ `/opt/custompython/bin` (āĻ¸āĻ°ā§āĻŦāĻļā§āĻˇ āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋ) āĻ¤ā§ āĻā§āĻāĻā§ āĻĒāĻžāĻŦā§ āĻāĻŦāĻ āĻāĻāĻžāĻā§ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°āĻŦā§āĨ¤
+
+////
+
+//// tab | āĻāĻāĻ¨ā§āĻĄā§āĻ
+
+āĻ§āĻ°āĻž āĻ¯āĻžāĻ āĻāĻĒāĻ¨āĻŋ āĻĒāĻžāĻāĻĨāĻ¨ āĻāĻ¨āĻ¸ā§āĻāĻ˛ āĻāĻ°āĻ˛ā§āĻ¨ āĻāĻŦāĻ āĻāĻāĻŋ `C:\opt\custompython\bin` āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋāĻ¤ā§ āĻāĻ¨āĻ¸ā§āĻāĻ˛ āĻšāĻā§āĻā§āĨ¤
+
+āĻ¯āĻĻāĻŋ āĻāĻĒāĻ¨āĻŋ "Yes" āĻ¸āĻŋāĻ˛ā§āĻā§āĻ āĻāĻ°ā§ `PATH` āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛ āĻāĻĒāĻĄā§āĻ āĻāĻ°āĻ¤ā§ āĻāĻžāĻ¨, āĻ¤āĻžāĻšāĻ˛ā§ āĻāĻ¨āĻ¸ā§āĻāĻ˛āĻžāĻ° `C:\opt\custompython\bin` āĻā§ `PATH` āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛ āĻ āĻāĻĄ āĻāĻ°ā§ āĻĻāĻŋāĻŦā§āĨ¤
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+āĻāĻāĻāĻžāĻŦā§, āĻāĻĒāĻ¨āĻŋ āĻ¯āĻāĻ¨ āĻāĻžāĻ°ā§āĻŽāĻŋāĻ¨āĻžāĻ˛ā§ `python` āĻāĻžāĻāĻĒ āĻāĻ°ā§āĻ¨, āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽ āĻĒāĻžāĻāĻĨāĻ¨ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻāĻŋāĻā§ `C:\opt\custompython\bin` (āĻ¸āĻ°ā§āĻŦāĻļā§āĻˇ āĻĄāĻŋāĻ°ā§āĻā§āĻāĻ°āĻŋ) āĻ¤ā§ āĻā§āĻāĻā§ āĻĒāĻžāĻŦā§ āĻāĻŦāĻ āĻāĻāĻžāĻā§ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°āĻŦā§āĨ¤
+
+////
+
+āĻ¤āĻžāĻ, āĻāĻĒāĻ¨āĻŋ āĻ¯āĻĻāĻŋ āĻāĻžāĻāĻĒ āĻāĻ°ā§āĻ¨āĻ
+
+
+
+```console
+$ python
+```
+
+
+
+//// tab | āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸, āĻŽā§āĻ¯āĻžāĻāĻāĻāĻ¸
+
+āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽ `python` āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻā§ `/opt/custompython/bin` āĻ **āĻā§āĻāĻā§ āĻĒāĻžāĻŦā§** āĻāĻŦāĻ āĻāĻāĻžāĻā§ āĻ°āĻžāĻ¨ āĻāĻ°āĻŦā§āĨ¤
+
+āĻāĻāĻž āĻŽā§āĻāĻžāĻŽā§āĻāĻŋāĻāĻžāĻŦā§ āĻ¨āĻŋāĻā§āĻ° āĻŽāĻ¤ā§ āĻāĻ°ā§ āĻ˛ā§āĻāĻžāĻ° āĻ¸āĻŽāĻžāĻ¨ āĻšāĻŦā§āĻ
+
+
+
+```console
+$ /opt/custompython/bin/python
+```
+
+
+
+////
+
+//// tab | āĻāĻāĻ¨ā§āĻĄā§āĻ
+
+āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽ `python` āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻā§ `C:\opt\custompython\bin\python` āĻ **āĻā§āĻāĻā§ āĻĒāĻžāĻŦā§** āĻāĻŦāĻ āĻāĻāĻžāĻā§ āĻ°āĻžāĻ¨ āĻāĻ°āĻŦā§āĨ¤
+
+āĻāĻāĻž āĻŽā§āĻāĻžāĻŽā§āĻāĻŋāĻāĻžāĻŦā§ āĻ¨āĻŋāĻā§āĻ° āĻŽāĻ¤ā§ āĻāĻ°ā§ āĻ˛ā§āĻāĻžāĻ° āĻ¸āĻŽāĻžāĻ¨ āĻšāĻŦā§āĻ
+
+
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+
+
+////
+
+āĻāĻ āĻ¤āĻĨā§āĻ¯āĻā§āĻ˛ā§ [āĻāĻžāĻ°ā§āĻā§ā§āĻžāĻ˛ āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻāĻ¸](virtual-environments.md){.internal-link target=_blank} āĻļā§āĻāĻžāĻ° āĻā§āĻˇā§āĻ¤ā§āĻ°ā§ āĻ¸āĻšāĻžā§āĻ āĻšāĻŦā§āĨ¤
+
+## āĻāĻĒāĻ¸āĻāĻšāĻžāĻ°
+
+āĻāĻ° āĻŽāĻžāĻ§ā§āĻ¯āĻŽā§ āĻāĻĒāĻ¨āĻŋ **āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋā§ā§āĻŦāĻ˛āĻ¸** āĻāĻŋ āĻāĻŦāĻ āĻāĻāĻŋāĻā§ āĻĒāĻžāĻāĻĨāĻ¨ā§ āĻāĻŋāĻāĻžāĻŦā§ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°āĻ¤ā§ āĻšā§ āĻ¤āĻžāĻ° āĻ¸āĻŽā§āĻĒāĻ°ā§āĻā§ āĻŦā§āĻ¸āĻŋāĻ āĻ§āĻžāĻ°āĻ¨āĻž āĻĒā§āĻ˛ā§āĻ¨āĨ¤
+
+āĻāĻžāĻāĻ˛ā§ āĻāĻ āĻ¸āĻŽā§āĻĒāĻ°ā§āĻā§ āĻāĻ°ā§ āĻŦāĻŋāĻ¸ā§āĻ¤āĻžāĻ°āĻŋāĻ¤ āĻĒā§āĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ¨ Wikipedia for Environment Variable āĻāĨ¤
+
+āĻ
āĻ¨ā§āĻ āĻā§āĻˇā§āĻ¤ā§āĻ°ā§, āĻĻā§āĻāĻž āĻŽāĻžāĻ¤ā§āĻ°āĻ āĻāĻ¨āĻāĻžāĻ¯āĻŧāĻ°āĻ¨āĻŽā§āĻ¨ā§āĻ āĻā§āĻ°āĻŋāĻ¯āĻŧā§āĻŦāĻ˛ āĻā§āĻāĻžāĻŦā§ āĻĒā§āĻ°ā§ā§āĻāĻ¨ āĻšāĻŦā§ āĻ¤āĻž āĻ¸ā§āĻĒāĻˇā§āĻ āĻšā§ āĻ¨āĻžāĨ¤ āĻāĻŋāĻ¨ā§āĻ¤ā§ āĻĄā§āĻā§āĻ˛āĻĒāĻŽā§āĻ¨ā§āĻā§āĻ° āĻ¸āĻŽāĻ¯āĻŧ āĻāĻĒāĻ¨āĻŋ āĻ¨āĻžāĻ¨āĻž āĻ°āĻāĻŽ āĻĒāĻ°āĻŋāĻ¸ā§āĻĨāĻŋāĻ¤āĻŋāĻ¤ā§ āĻāĻā§āĻ˛ā§āĻ° āĻ¸āĻŽā§āĻŽā§āĻā§āĻ¨ āĻšāĻŦā§āĻ¨, āĻ¤āĻžāĻ āĻāĻā§āĻ˛ā§ āĻ¸āĻŽā§āĻĒāĻ°ā§āĻā§ āĻā§āĻ¨ā§ āĻ°āĻžāĻāĻž āĻāĻžāĻ˛ā§āĨ¤
+
+āĻāĻĻāĻžāĻšāĻ°āĻŖāĻ¸ā§āĻŦāĻ°ā§āĻĒ, āĻāĻĒāĻ¨āĻžāĻ° āĻāĻ āĻāĻ¨āĻĢāĻ°āĻŽā§āĻļāĻ¨āĻāĻŋ āĻĒāĻ°āĻŦāĻ°ā§āĻ¤ā§, [āĻāĻžāĻ°ā§āĻā§ā§āĻžāĻ˛ āĻāĻ¨āĻāĻžā§āĻ°āĻ¨āĻŽā§āĻ¨ā§āĻāĻ¸](virtual-environments.md) āĻ
āĻāĻļā§ āĻĻāĻ°āĻāĻžāĻ° āĻšāĻŦā§āĨ¤
diff --git a/docs/de/docs/advanced/generate-clients.md b/docs/de/docs/advanced/generate-clients.md
index 38a69031c..f491d29af 100644
--- a/docs/de/docs/advanced/generate-clients.md
+++ b/docs/de/docs/advanced/generate-clients.md
@@ -20,7 +20,7 @@ Einige von diesen ⨠[**sponsern FastAPI**](../help-fastapi.md#den-autor-sponse
Und es zeigt deren wahres Engagement fÃŧr FastAPI und seine **Community** (Sie), da diese Ihnen nicht nur einen **guten Service** bieten mÃļchten, sondern auch sicherstellen mÃļchten, dass Sie Ãŧber ein **gutes und gesundes Framework** verfÃŧgen, FastAPI. đ
-Beispielsweise kÃļnnten Sie Speakeasy ausprobieren.
+Beispielsweise kÃļnnten Sie Speakeasy ausprobieren.
Es gibt auch mehrere andere Unternehmen, welche ähnliche Dienste anbieten und die Sie online suchen und finden kÃļnnen. đ¤
diff --git a/docs/de/docs/deployment/concepts.md b/docs/de/docs/deployment/concepts.md
index 97ad854e2..907598e54 100644
--- a/docs/de/docs/deployment/concepts.md
+++ b/docs/de/docs/deployment/concepts.md
@@ -216,7 +216,7 @@ Dieser Manager-Prozess wäre wahrscheinlich derjenige, welcher der IP am **Port*
Diese Workerprozesse wÃŧrden Ihre Anwendung ausfÃŧhren, sie wÃŧrden die Hauptberechnungen durchfÃŧhren, um einen **Request** entgegenzunehmen und eine **Response** zurÃŧckzugeben, und sie wÃŧrden alles, was Sie in Variablen einfÃŧgen, in den RAM laden.
-TLS-Handshake ** bezeichnet.
@@ -111,7 +111,7 @@ Mithilfe der oben beschriebenen **SNI-Erweiterung** wÃŧrde der TLS-Terminierungs
In diesem Fall wÃŧrde er das Zertifikat fÃŧr `someapp.example.com` verwenden.
-`redoc.standalone.js`
+* `redoc.standalone.js`
Danach kÃļnnte Ihre Dateistruktur wie folgt aussehen:
@@ -129,14 +129,8 @@ Sie sollten eine sehr lange JavaScript-Datei fÃŧr **ReDoc** sehen.
Sie kÃļnnte beginnen mit etwas wie:
```JavaScript
-/*!
- * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
- * -------------------------------------------------------------
- * Version: "2.0.0-rc.18"
- * Repo: https://github.com/Redocly/redoc
- */
-!function(e,t){"object"==typeof exports&&"object"==typeof m
-
+/*! For license information please see redoc.standalone.js.LICENSE.txt */
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t(require("null")):
...
```
diff --git a/docs/de/docs/tutorial/bigger-applications.md b/docs/de/docs/tutorial/bigger-applications.md
index 59e91bdcc..514e3fd3a 100644
--- a/docs/de/docs/tutorial/bigger-applications.md
+++ b/docs/de/docs/tutorial/bigger-applications.md
@@ -52,7 +52,7 @@ from app.routers import items
* Es gibt auch ein Unterverzeichnis `app/internal/` mit einer weiteren Datei `__init__.py`, es handelt sich also um ein weiteres âPython-Subpackageâ: `app.internal`.
* Und die Datei `app/internal/admin.py` ist ein weiteres Submodul: `app.internal.admin`.
-Speakeasy
+* Speakeasy
* Stainless
-* liblab
+* liblab
There are also several other companies offering similar services that you can search and find online. đ¤
diff --git a/docs/en/docs/advanced/response-directly.md b/docs/en/docs/advanced/response-directly.md
index 691b1e7cd..759b762b5 100644
--- a/docs/en/docs/advanced/response-directly.md
+++ b/docs/en/docs/advanced/response-directly.md
@@ -58,7 +58,7 @@ You could put your XML content in a string, put that in a `Response`, and return
## Notes
-When you return a `Response` directly its data is not validated, converted (serialized), nor documented automatically.
+When you return a `Response` directly its data is not validated, converted (serialized), or documented automatically.
But you can still document it as described in [Additional Responses in OpenAPI](additional-responses.md){.internal-link target=_blank}.
diff --git a/docs/en/docs/async.md b/docs/en/docs/async.md
index 63bd8ca68..8207ec480 100644
--- a/docs/en/docs/async.md
+++ b/docs/en/docs/async.md
@@ -40,7 +40,7 @@ def results():
---
-If your application (somehow) doesn't have to communicate with anything else and wait for it to respond, use `async def`.
+If your application (somehow) doesn't have to communicate with anything else and wait for it to respond, use `async def`, even if you don't need to use `await` inside.
---
diff --git a/docs/en/docs/contributing.md b/docs/en/docs/contributing.md
index 1b70a0ea9..2583fd1fb 100644
--- a/docs/en/docs/contributing.md
+++ b/docs/en/docs/contributing.md
@@ -181,6 +181,28 @@ as Uvicorn by default will use the port `8000`, the documentation on port `8008`
### Translations
+/// warning | Attention
+
+**Update on Translations**
+
+We're updating the way we handle documentation translations.
+
+Until now, we invited community members to translate pages via pull requests, which were then reviewed by at least two native speakers. While this has helped bring FastAPI to many more users, weâve also run into several challenges - some languages have only a few translated pages, others are outdated and hard to maintain over time.
+To improve this, weâre working on automation tools đ¤ to manage translations more efficiently. Once ready, documentation will be machine-translated and still reviewed by at least two native speakers â
before publishing. This will allow us to keep translations up-to-date while reducing the review burden on maintainers.
+
+Whatâs changing now:
+
+* đĢ Weâre no longer accepting new community-submitted translation PRs.
+
+* âŗ Existing open PRs will be reviewed and can still be merged if completed within the next 3 weeks (since July 11 2025).
+
+* đ In the future, we will only support languages where at least three active native speakers are available to review and maintain translations.
+
+This transition will help us keep translations more consistent and timely while better supporting our contributors đ. Thank you to everyone who has contributed so far â your help has been invaluable! đ
+
+///
+
+
Help with translations is VERY MUCH appreciated! And it can't be done without the help from the community. đ đ
Here are the steps to help with translations.
@@ -293,30 +315,47 @@ Now you can translate it all and see how it looks as you save the file.
Some of these files are updated very frequently and a translation would always be behind, or they include the main content from English source files, etc.
+#### Request a New Language
+
+Let's say that you want to request translations for a language that is not yet translated, not even some pages. For example, Latin.
+
+If there is no discussion for that language, you can start by requesting the new language. For that, you can follow these steps:
+
+* Create a new discussion following the template.
+* Get a few native speakers to comment on the discussion and commit to help review translations for that language.
+
+Once there are several people in the discussion, the FastAPI team can evaluate it and can make it an official translation.
+
+Then the docs will be automatically translated using AI, and the team of native speakers can review the translation, and help tweak the AI prompts.
+
+Once there's a new translation, for example if docs are updated or there's a new section, there will be a comment in the same discussion with the link to the new translation to review.
+
#### New Language
-Let's say that you want to add translations for a language that is not yet translated, not even some pages.
+/// note
-Let's say you want to add translations for Creole, and it's not yet there in the docs.
+These steps will be performed by the FastAPI team.
+
+///
-Checking the link from above, the code for "Creole" is `ht`.
+Checking the link from above (List of ISO 639-1 codes), you can see that the 2-letter code for Latin is `la`.
-The next step is to run the script to generate a new translation directory:
+Now you can create a new directory for the new language, running the following script:
```console
// Use the command new-lang, pass the language code as a CLI argument
-$ python ./scripts/docs.py new-lang ht
+$ python ./scripts/docs.py new-lang la
-Successfully initialized: docs/ht
+Successfully initialized: docs/la
```
-Now you can check in your code editor the newly created directory `docs/ht/`.
+Now you can check in your code editor the newly created directory `docs/la/`.
-That command created a file `docs/ht/mkdocs.yml` with a simple config that inherits everything from the `en` version:
+That command created a file `docs/la/mkdocs.yml` with a simple config that inherits everything from the `en` version:
```yaml
INHERIT: ../en/mkdocs.yml
@@ -328,11 +367,11 @@ You could also simply create that file with those contents manually.
///
-That command also created a dummy file `docs/ht/index.md` for the main page, you can start by translating that one.
+That command also created a dummy file `docs/la/index.md` for the main page, you can start by translating that one.
You can continue with the previous instructions for an "Existing Language" for that process.
-You can make the first pull request with those two files, `docs/ht/mkdocs.yml` and `docs/ht/index.md`. đ
+You can make the first pull request with those two files, `docs/la/mkdocs.yml` and `docs/la/index.md`. đ
#### Preview the result
diff --git a/docs/en/docs/deployment/cloud.md b/docs/en/docs/deployment/cloud.md
index 471808851..d713379c3 100644
--- a/docs/en/docs/deployment/cloud.md
+++ b/docs/en/docs/deployment/cloud.md
@@ -14,5 +14,4 @@ You might want to try their services and follow their guides:
* Platform.sh
* Porter
-* Coherence
* Render
diff --git a/docs/en/docs/deployment/concepts.md b/docs/en/docs/deployment/concepts.md
index e71a7487a..ed635a920 100644
--- a/docs/en/docs/deployment/concepts.md
+++ b/docs/en/docs/deployment/concepts.md
@@ -65,7 +65,7 @@ The word **program** is commonly used to describe many things:
* The **code** that you write, the **Python files**.
* The **file** that can be **executed** by the operating system, for example: `python`, `python.exe` or `uvicorn`.
-* A particular program while it is **running** on the operating system, using the CPU, and storing things on memory. This is also called a **process**.
+* A particular program while it is **running** on the operating system, using the CPU, and storing things in memory. This is also called a **process**.
### What is a Process
@@ -216,7 +216,7 @@ This Manager Process would probably be the one listening on the **port** in the
Those worker processes would be the ones running your application, they would perform the main computations to receive a **request** and return a **response**, and they would load anything you put in variables in RAM.
-GitHub sponsors .
-
-There you could buy me a coffee âī¸ to say thanks. đ
-
-And you can also become a Silver or Gold sponsor for FastAPI. đ
đ
-
-## Sponsor the tools that power FastAPI
-
-As you have seen in the documentation, FastAPI stands on the shoulders of giants, Starlette and Pydantic.
-
-You can also sponsor:
-
-* Samuel Colvin (Pydantic)
-* Encode (Starlette, Uvicorn)
+If your **product/company** depends on or is related to **FastAPI** and you want to reach its users, you can sponsor the author (me) through GitHub sponsors . Depending on the tier, you could get some extra benefits, like a badge in the docs. đ
---
diff --git a/docs/en/docs/how-to/custom-docs-ui-assets.md b/docs/en/docs/how-to/custom-docs-ui-assets.md
index f717c98fa..9d2238e4f 100644
--- a/docs/en/docs/how-to/custom-docs-ui-assets.md
+++ b/docs/en/docs/how-to/custom-docs-ui-assets.md
@@ -98,7 +98,7 @@ You can probably right-click each link and select an option similar to `Save lin
And **ReDoc** uses the file:
-* `redoc.standalone.js`
+* `redoc.standalone.js`
After that, your file structure could look like:
@@ -129,14 +129,8 @@ You should see a very long JavaScript file for **ReDoc**.
It could start with something like:
```JavaScript
-/*!
- * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
- * -------------------------------------------------------------
- * Version: "2.0.0-rc.18"
- * Repo: https://github.com/Redocly/redoc
- */
-!function(e,t){"object"==typeof exports&&"object"==typeof m
-
+/*! For license information please see redoc.standalone.js.LICENSE.txt */
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t(require("null")):
...
```
diff --git a/docs/en/docs/img/deployment/concepts/process-ram.drawio b/docs/en/docs/img/deployment/concepts/process-ram.drawio
deleted file mode 100644
index b29c8a342..000000000
--- a/docs/en/docs/img/deployment/concepts/process-ram.drawio
+++ /dev/null
@@ -1,106 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/deployment/concepts/process-ram.drawio.svg b/docs/en/docs/img/deployment/concepts/process-ram.drawio.svg
new file mode 100644
index 000000000..a6a5c81d0
--- /dev/null
+++ b/docs/en/docs/img/deployment/concepts/process-ram.drawio.svg
@@ -0,0 +1,297 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Server
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ RAM
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ CPU
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Process
+
+
+
+ Manager
+
+
+
+
+
+
+ Process Manager
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Worker Process
+
+
+
+
+
+
+ Worker Process
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Worker Process
+
+
+
+
+
+
+ Worker Process
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Another Process
+
+
+
+
+
+
+ Another Process
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 1 GB
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 1 GB
+
+
+
+
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/deployment/concepts/process-ram.svg b/docs/en/docs/img/deployment/concepts/process-ram.svg
deleted file mode 100644
index c1bf0d589..000000000
--- a/docs/en/docs/img/deployment/concepts/process-ram.svg
+++ /dev/null
@@ -1,59 +0,0 @@
-Server RAM
- CPU
- Process Manager Worker Process Worker Process Another Process 1 GB 1 GB Viewer does not support full SVG 1.1
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/deployment/https/https.drawio.svg b/docs/en/docs/img/deployment/https/https.drawio.svg
new file mode 100644
index 000000000..c2a65b69f
--- /dev/null
+++ b/docs/en/docs/img/deployment/https/https.drawio.svg
@@ -0,0 +1,907 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DNS Servers
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Cert Renovation Program
+
+
+
+
+
+ Cert Renovation Program
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Let's Encrypt
+
+
+
+
+
+ Let's Encrypt
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FastAPI
+
+
+ app for: someapp.example.com
+
+
+
+
+
+
+ FastAPI app for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Another app
+
+
+ : another.example.com
+
+
+
+
+
+
+ Another app: another.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ One more app
+
+
+ : onemore.example.com
+
+
+
+
+
+
+ One more app: onemore.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A Database
+
+
+
+
+
+
+ A Database
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Plain response from: someapp.example.com
+
+
+
+
+
+
+ Plain response from: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Renew HTTPS cert for: someapp.example.com
+
+
+
+
+
+
+ Renew HTTPS cert for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ New HTTPS cert for: someapp.example.com
+
+
+
+
+
+
+ New HTTPS cert for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Encrypted response from: someapp.example.com
+
+
+
+
+
+
+ Encrypted response from: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Decrypted request for: someapp.example.com
+
+
+
+
+
+
+ Decrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/deployment/https/https.svg b/docs/en/docs/img/deployment/https/https.svg
deleted file mode 100644
index 69497518a..000000000
--- a/docs/en/docs/img/deployment/https/https.svg
+++ /dev/null
@@ -1,62 +0,0 @@
-Server(s) https://someapp.example.com
https://someapp.example.com DNS Servers TLS Termination Proxy
- Cert Renovation Program Let's Encrypt FastAPI app for: someapp.example.com
FastAPI app for: someapp.example.com Another app : another.example.com
Another app: another.example.com One more app : onemore.example.com
One more app: onemore.example.com A Database Plain response from: someapp.example.com
Plain response from: someapp.example.com Port 443 (HTTPS) Encrypted request for: someapp.example.com
Encrypted request for: someapp.example.com Who is: someapp.example.com
Who is: someapp.example.com IP:... Renew HTTPS cert for: someapp.example.com
Renew HTTPS cert for: someapp.example.com New HTTPS cert for: someapp.example.com
New HTTPS cert for: someapp.example.com TLS Handshake Encrypted response from: someapp.example.com
Encrypted response from: someapp.example.com HTTPS certificates
- someapp.example.com
- another.example.net
- onemore.example.org
- IP:... Decrypted request for: someapp.example.com
Decrypted request for: someapp.example.com Viewer does not support full SVG 1.1
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/deployment/https/https01.drawio.svg b/docs/en/docs/img/deployment/https/https01.drawio.svg
new file mode 100644
index 000000000..ea128daf8
--- /dev/null
+++ b/docs/en/docs/img/deployment/https/https01.drawio.svg
@@ -0,0 +1,131 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DNS Servers
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/deployment/https/https01.svg b/docs/en/docs/img/deployment/https/https01.svg
deleted file mode 100644
index 2edbd0623..000000000
--- a/docs/en/docs/img/deployment/https/https01.svg
+++ /dev/null
@@ -1,57 +0,0 @@
-https://someapp.example.com
https://someapp.example.com DNS Servers Who is: someapp.example.com
Who is: someapp.example.com IP:... Viewer does not support full SVG 1.1
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/deployment/https/https02.drawio.svg b/docs/en/docs/img/deployment/https/https02.drawio.svg
new file mode 100644
index 000000000..c29d59356
--- /dev/null
+++ b/docs/en/docs/img/deployment/https/https02.drawio.svg
@@ -0,0 +1,245 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DNS Servers
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/deployment/https/https02.svg b/docs/en/docs/img/deployment/https/https02.svg
deleted file mode 100644
index e16b7e94a..000000000
--- a/docs/en/docs/img/deployment/https/https02.svg
+++ /dev/null
@@ -1,57 +0,0 @@
-Server(s) https://someapp.example.com
https://someapp.example.com DNS Servers Port 443 (HTTPS) IP:... Who is: someapp.example.com
Who is: someapp.example.com IP:... TLS Handshake Viewer does not support full SVG 1.1
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/deployment/https/https03.drawio.svg b/docs/en/docs/img/deployment/https/https03.drawio.svg
new file mode 100644
index 000000000..6971e4c9c
--- /dev/null
+++ b/docs/en/docs/img/deployment/https/https03.drawio.svg
@@ -0,0 +1,715 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DNS Servers
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/deployment/https/https03.svg b/docs/en/docs/img/deployment/https/https03.svg
deleted file mode 100644
index 2badd1c7d..000000000
--- a/docs/en/docs/img/deployment/https/https03.svg
+++ /dev/null
@@ -1,62 +0,0 @@
-Server(s) https://someapp.example.com
https://someapp.example.com DNS Servers TLS Termination Proxy
- Port 443 (HTTPS) Who is: someapp.example.com
Who is: someapp.example.com IP:... TLS Handshake HTTPS certificates
- someapp.example.com
- another.example.net
- onemore.example.org
- IP:... Viewer does not support full SVG 1.1
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/deployment/https/https04.drawio.svg b/docs/en/docs/img/deployment/https/https04.drawio.svg
new file mode 100644
index 000000000..7e32bcdfe
--- /dev/null
+++ b/docs/en/docs/img/deployment/https/https04.drawio.svg
@@ -0,0 +1,419 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DNS Servers
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/deployment/https/https04.svg b/docs/en/docs/img/deployment/https/https04.svg
deleted file mode 100644
index 4513ac76b..000000000
--- a/docs/en/docs/img/deployment/https/https04.svg
+++ /dev/null
@@ -1,62 +0,0 @@
-Server(s) https://someapp.example.com
https://someapp.example.com DNS Servers TLS Termination Proxy
- Port 443 (HTTPS) Encrypted request for: someapp.example.com
Encrypted request for: someapp.example.com Who is: someapp.example.com
Who is: someapp.example.com IP:... TLS Handshake HTTPS certificates
- someapp.example.com
- another.example.net
- onemore.example.org
- IP:... Viewer does not support full SVG 1.1
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/deployment/https/https05.drawio.svg b/docs/en/docs/img/deployment/https/https05.drawio.svg
new file mode 100644
index 000000000..fed2fad16
--- /dev/null
+++ b/docs/en/docs/img/deployment/https/https05.drawio.svg
@@ -0,0 +1,641 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DNS Servers
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FastAPI
+
+
+ app for: someapp.example.com
+
+
+
+
+
+
+ FastAPI app for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Decrypted request for: someapp.example.com
+
+
+
+
+
+
+ Decrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/deployment/https/https05.svg b/docs/en/docs/img/deployment/https/https05.svg
deleted file mode 100644
index ddcd2760a..000000000
--- a/docs/en/docs/img/deployment/https/https05.svg
+++ /dev/null
@@ -1,62 +0,0 @@
-Server(s) https://someapp.example.com
https://someapp.example.com DNS Servers TLS Termination Proxy
- FastAPI app for: someapp.example.com
FastAPI app for: someapp.example.com Decrypted request for: someapp.example.com
Decrypted request for: someapp.example.com Port 443 (HTTPS) Encrypted request for: someapp.example.com
Encrypted request for: someapp.example.com Who is: someapp.example.com
Who is: someapp.example.com IP:... TLS Handshake HTTPS certificates
- someapp.example.com
- another.example.net
- onemore.example.org
- IP:... Viewer does not support full SVG 1.1
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/deployment/https/https06.drawio.svg b/docs/en/docs/img/deployment/https/https06.drawio.svg
new file mode 100644
index 000000000..e0bd9bc6e
--- /dev/null
+++ b/docs/en/docs/img/deployment/https/https06.drawio.svg
@@ -0,0 +1,673 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DNS Servers
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FastAPI
+
+
+ app for: someapp.example.com
+
+
+
+
+
+
+ FastAPI app for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Plain response from: someapp.example.com
+
+
+
+
+
+
+ Plain response from: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Decrypted request for: someapp.example.com
+
+
+
+
+
+
+ Decrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/deployment/https/https06.svg b/docs/en/docs/img/deployment/https/https06.svg
deleted file mode 100644
index 3695de40c..000000000
--- a/docs/en/docs/img/deployment/https/https06.svg
+++ /dev/null
@@ -1,62 +0,0 @@
-Server(s) https://someapp.example.com
https://someapp.example.com DNS Servers TLS Termination Proxy
- FastAPI app for: someapp.example.com
FastAPI app for: someapp.example.com Plain response from: someapp.example.com
Plain response from: someapp.example.com Decrypted request for: someapp.example.com
Decrypted request for: someapp.example.com Port 443 (HTTPS) Encrypted request for: someapp.example.com
Encrypted request for: someapp.example.com Who is: someapp.example.com
Who is: someapp.example.com IP:... TLS Handshake HTTPS certificates
- someapp.example.com
- another.example.net
- onemore.example.org
- IP:... Viewer does not support full SVG 1.1
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/deployment/https/https07.drawio.svg b/docs/en/docs/img/deployment/https/https07.drawio.svg
new file mode 100644
index 000000000..b74b33807
--- /dev/null
+++ b/docs/en/docs/img/deployment/https/https07.drawio.svg
@@ -0,0 +1,540 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DNS Servers
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FastAPI
+
+
+ app for: someapp.example.com
+
+
+
+
+
+
+ FastAPI app for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Plain response from: someapp.example.com
+
+
+
+
+
+
+ Plain response from: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Decrypted request for: someapp.example.com
+
+
+
+
+
+
+ Decrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Encrypted response from: someapp.example.com
+
+
+
+
+
+
+ Encrypted response from: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/deployment/https/https07.svg b/docs/en/docs/img/deployment/https/https07.svg
deleted file mode 100644
index 551354cef..000000000
--- a/docs/en/docs/img/deployment/https/https07.svg
+++ /dev/null
@@ -1,62 +0,0 @@
-Server(s) https://someapp.example.com
https://someapp.example.com DNS Servers TLS Termination Proxy
- FastAPI app for: someapp.example.com
FastAPI app for: someapp.example.com Plain response from: someapp.example.com
Plain response from: someapp.example.com Decrypted request for: someapp.example.com
Decrypted request for: someapp.example.com Port 443 (HTTPS) Encrypted request for: someapp.example.com
Encrypted request for: someapp.example.com Who is: someapp.example.com
Who is: someapp.example.com IP:... TLS Handshake Encrypted response from: someapp.example.com
Encrypted response from: someapp.example.com HTTPS certificates
- someapp.example.com
- another.example.net
- onemore.example.org
- IP:... Viewer does not support full SVG 1.1
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/deployment/https/https08.drawio.svg b/docs/en/docs/img/deployment/https/https08.drawio.svg
new file mode 100644
index 000000000..8fc0b31ec
--- /dev/null
+++ b/docs/en/docs/img/deployment/https/https08.drawio.svg
@@ -0,0 +1,625 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+ Server(s)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DNS Servers
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+ TLS Termination Proxy
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FastAPI
+
+
+ app for: someapp.example.com
+
+
+
+
+
+
+ FastAPI app for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Another app
+
+
+ : another.example.com
+
+
+
+
+
+
+ Another app: another.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ One more app
+
+
+ : onemore.example.com
+
+
+
+
+
+
+ One more app: onemore.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A Database
+
+
+
+
+
+
+ A Database
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Plain response from: someapp.example.com
+
+
+
+
+
+
+ Plain response from: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Decrypted request for: someapp.example.com
+
+
+
+
+
+
+ Decrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+ Port 443 (HTTPS)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+ Encrypted request for: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+ Who is: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+ TLS Handshake
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Encrypted response from: someapp.example.com
+
+
+
+
+
+
+ Encrypted response from: someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+ HTTPS certificates
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+ someapp.example.com
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+ another.example.net
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+ onemore.example.org
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ IP:
+
+
+ 123.124.125.126
+
+
+
+
+
+
+
+ IP:...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+ https://someapp.example.com
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/deployment/https/https08.svg b/docs/en/docs/img/deployment/https/https08.svg
deleted file mode 100644
index 2d4680dcc..000000000
--- a/docs/en/docs/img/deployment/https/https08.svg
+++ /dev/null
@@ -1,62 +0,0 @@
-Server(s) https://someapp.example.com
https://someapp.example.com DNS Servers TLS Termination Proxy
- FastAPI app for: someapp.example.com
FastAPI app for: someapp.example.com Another app : another.example.com
Another app: another.example.com One more app : onemore.example.com
One more app: onemore.example.com A Database Plain response from: someapp.example.com
Plain response from: someapp.example.com Decrypted request for: someapp.example.com
Decrypted request for: someapp.example.com Port 443 (HTTPS) Encrypted request for: someapp.example.com
Encrypted request for: someapp.example.com Who is: someapp.example.com
Who is: someapp.example.com IP:... TLS Handshake Encrypted response from: someapp.example.com
Encrypted response from: someapp.example.com HTTPS certificates
- someapp.example.com
- another.example.net
- onemore.example.org
- IP:... Viewer does not support full SVG 1.1
+ sponsorship-banner
+
+
+
+
+
+
+
diff --git a/docs/en/docs/img/sponsors/subtotal.svg b/docs/en/docs/img/sponsors/subtotal.svg
new file mode 100644
index 000000000..b944c1b2c
--- /dev/null
+++ b/docs/en/docs/img/sponsors/subtotal.svg
@@ -0,0 +1,31 @@
+
+
+ sponsorship-badge
+
+
diff --git a/docs/en/docs/img/sponsors/zuplo.png b/docs/en/docs/img/sponsors/zuplo.png
index 7a7c16862..6a4ed233e 100644
Binary files a/docs/en/docs/img/sponsors/zuplo.png and b/docs/en/docs/img/sponsors/zuplo.png differ
diff --git a/docs/en/docs/img/tutorial/bigger-applications/package.drawio b/docs/en/docs/img/tutorial/bigger-applications/package.drawio
deleted file mode 100644
index cab3de2ca..000000000
--- a/docs/en/docs/img/tutorial/bigger-applications/package.drawio
+++ /dev/null
@@ -1,43 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/en/docs/img/tutorial/bigger-applications/package.drawio.svg b/docs/en/docs/img/tutorial/bigger-applications/package.drawio.svg
new file mode 100644
index 000000000..7e28f4a68
--- /dev/null
+++ b/docs/en/docs/img/tutorial/bigger-applications/package.drawio.svg
@@ -0,0 +1,420 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Package app
+
+
+
+
+
+ Package app...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Module app.main
+
+
+ app/main.py
+
+
+
+
+
+
+ Module app.main...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Module app.dependencies
+
+
+ app/dependencies.py
+
+
+
+
+
+
+ Module app.dependencies...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Subpackage app.internal
+
+
+ app/internal/__init__.py
+
+
+
+
+
+
+
+
+ Subpackage app.internal...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Module app.internal.admin
+
+
+ app/internal/admin.py
+
+
+
+
+
+
+ Module app.internal.admin...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Subpackage app.routers
+
+
+
+
+
+
+ Subpackage app.routers...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Module app.routers.items
+
+
+ app/routers/items.py
+
+
+
+
+
+
+ Module app.routers.items...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Module app.routers.users
+
+
+ app/routers/users.py
+
+
+
+
+
+
+ Module app.routers.users...
+
+
+
+
+
+
+
+
+ Text is not SVG - cannot display
+
+
+
+
diff --git a/docs/en/docs/img/tutorial/bigger-applications/package.svg b/docs/en/docs/img/tutorial/bigger-applications/package.svg
deleted file mode 100644
index 44da1dc30..000000000
--- a/docs/en/docs/img/tutorial/bigger-applications/package.svg
+++ /dev/null
@@ -1 +0,0 @@
-Package app
Package app... Module app.main app/main.py
Module app.main... Module app.dependencies app/dependencies.py
Module app.dependencies... Subpackage app.internal app/internal/__init__.py
Subpackage app.internal... Module app.internal.admin app/internal/admin.py
Module app.internal.admin... Subpackage app.routers
Subpackage app.routers... Module app.routers.items app/routers/items.py
Module app.routers.items... Module app.routers.users app/routers/users.py
Module app.routers.users... Viewer does not support full SVG 1.1 jinja2python-multipart"parsing" , with `request.form()`.
-Used by FastAPI / Starlette:
+Used by FastAPI:
* uvicornFastAPI Cloud .
### Without `standard` Dependencies
If you don't want to include the `standard` optional dependencies, you can install with `pip install fastapi` instead of `pip install "fastapi[standard]"`.
+### Without `fastapi-cloud-cli`
+
+If you want to install FastAPI with the standard dependencies but without the `fastapi-cloud-cli`, you can install with `pip install "fastapi[standard-no-fastapi-cloud-cli]"`.
+
### Additional Optional Dependencies
There are some additional dependencies you might want to install.
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c900dc918..f3984fa9e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,13 +7,225 @@ hide:
## Latest Changes
+### Docs
+
+* đ Add discussion template for new language translation requests. PR [#13535](https://github.com/fastapi/fastapi/pull/13535) by [@alejsdev](https://github.com/alejsdev).
+
+### Translations
+
+* đ Update Portuguese Translation for `docs/pt/docs/async.md`. PR [#13863](https://github.com/fastapi/fastapi/pull/13863) by [@EdmilsonRodrigues](https://github.com/EdmilsonRodrigues).
+* đ Fix highlight line in `docs/ja/docs/tutorial/body.md`. PR [#13927](https://github.com/fastapi/fastapi/pull/13927) by [@KoyoMiyazaki](https://github.com/KoyoMiyazaki).
+* đ Add Persian translation for `docs/fa/docs/environment-variables.md`. PR [#13923](https://github.com/fastapi/fastapi/pull/13923) by [@Mohammad222PR](https://github.com/Mohammad222PR).
+* đ Add Persian translation for `docs/fa/docs/python-types.md`. PR [#13524](https://github.com/fastapi/fastapi/pull/13524) by [@Mohammad222PR](https://github.com/Mohammad222PR).
+* đ Update Portuguese Translation for `docs/pt/docs/project-generation.md`. PR [#13875](https://github.com/fastapi/fastapi/pull/13875) by [@EdmilsonRodrigues](https://github.com/EdmilsonRodrigues).
+* đ Add Persian translation for `docs/fa/docs/async.md`. PR [#13541](https://github.com/fastapi/fastapi/pull/13541) by [@Mohammad222PR](https://github.com/Mohammad222PR).
+* đ Add Bangali translation for `docs/bn/about/index.md`. PR [#13882](https://github.com/fastapi/fastapi/pull/13882) by [@sajjadrahman56](https://github.com/sajjadrahman56).
+
+### Internal
+
+* âī¸ Update translate script, show and update outdated translations. PR [#13933](https://github.com/fastapi/fastapi/pull/13933) by [@tiangolo](https://github.com/tiangolo).
+* đ¨ Refactor translate script with extra feedback (prints). PR [#13932](https://github.com/fastapi/fastapi/pull/13932) by [@tiangolo](https://github.com/tiangolo).
+* đ¨ Update translations script to remove old (removed) files. PR [#13928](https://github.com/fastapi/fastapi/pull/13928) by [@tiangolo](https://github.com/tiangolo).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13894](https://github.com/fastapi/fastapi/pull/13894) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* âŦ Update httpx requirement to >=0.23.0,<0.29.0. PR [#13114](https://github.com/fastapi/fastapi/pull/13114) by [@yan12125](https://github.com/yan12125).
+* đ§ Update sponsors: Add Mobb. PR [#13916](https://github.com/fastapi/fastapi/pull/13916) by [@tiangolo](https://github.com/tiangolo).
+* đĨ Update FastAPI People - Experts. PR [#13889](https://github.com/fastapi/fastapi/pull/13889) by [@tiangolo](https://github.com/tiangolo).
+* đ¨ Update FastAPI People sleep interval, use external settings. PR [#13888](https://github.com/fastapi/fastapi/pull/13888) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.116.1
+
+### Upgrades
+
+* âŦī¸ Upgrade Starlette supported version range to `>=0.40.0,<0.48.0`. PR [#13884](https://github.com/fastapi/fastapi/pull/13884) by [@tiangolo](https://github.com/tiangolo).
+
+### Docs
+
+* đ Add notification about impending changes in Translations to `docs/en/docs/contributing.md`. PR [#13886](https://github.com/fastapi/fastapi/pull/13886) by [@YuriiMotov](https://github.com/YuriiMotov).
+
+### Internal
+
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13871](https://github.com/fastapi/fastapi/pull/13871) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+
+## 0.116.0
+
+### Features
+
+* ⨠Add support for deploying to FastAPI Cloud with `fastapi deploy`. PR [#13870](https://github.com/fastapi/fastapi/pull/13870) by [@tiangolo](https://github.com/tiangolo).
+
+Installing `fastapi[standard]` now includes `fastapi-cloud-cli`.
+
+This will allow you to deploy to [FastAPI Cloud](https://fastapicloud.com) with the `fastapi deploy` command.
+
+If you want to install `fastapi` with the standard dependencies but without `fastapi-cloud-cli`, you can install instead `fastapi[standard-no-fastapi-cloud-cli]`.
+
+### Translations
+
+* đ Add Russian translation for `docs/ru/docs/advanced/response-directly.md`. PR [#13801](https://github.com/fastapi/fastapi/pull/13801) by [@NavesSapnis](https://github.com/NavesSapnis).
+* đ Add Russian translation for `docs/ru/docs/advanced/additional-status-codes.md`. PR [#13799](https://github.com/fastapi/fastapi/pull/13799) by [@NavesSapnis](https://github.com/NavesSapnis).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/body-updates.md`. PR [#13804](https://github.com/fastapi/fastapi/pull/13804) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+
+### Internal
+
+* âŦ Bump pillow from 11.1.0 to 11.3.0. PR [#13852](https://github.com/fastapi/fastapi/pull/13852) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* đĨ Update FastAPI People - Sponsors. PR [#13846](https://github.com/fastapi/fastapi/pull/13846) by [@tiangolo](https://github.com/tiangolo).
+* đĨ Update FastAPI GitHub topic repositories. PR [#13848](https://github.com/fastapi/fastapi/pull/13848) by [@tiangolo](https://github.com/tiangolo).
+* âŦ Bump mkdocs-material from 9.6.1 to 9.6.15. PR [#13849](https://github.com/fastapi/fastapi/pull/13849) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13843](https://github.com/fastapi/fastapi/pull/13843) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* đĨ Update FastAPI People - Contributors and Translators. PR [#13845](https://github.com/fastapi/fastapi/pull/13845) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.115.14
+
+### Fixes
+
+* đ Fix support for unions when using `Form`. PR [#13827](https://github.com/fastapi/fastapi/pull/13827) by [@patrick91](https://github.com/patrick91).
+
+### Docs
+
+* âī¸ Fix grammar mistake in `docs/en/docs/advanced/response-directly.md`. PR [#13800](https://github.com/fastapi/fastapi/pull/13800) by [@NavesSapnis](https://github.com/NavesSapnis).
+* đ Update Speakeasy URL to Speakeasy Sandbox. PR [#13697](https://github.com/fastapi/fastapi/pull/13697) by [@ndimares](https://github.com/ndimares).
+
+### Translations
+
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/response-model.md`. PR [#13792](https://github.com/fastapi/fastapi/pull/13792) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/security/index.md`. PR [#13805](https://github.com/fastapi/fastapi/pull/13805) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* âī¸ Fix typo in `docs/ja/docs/tutorial/encoder.md`. PR [#13815](https://github.com/fastapi/fastapi/pull/13815) by [@ruzia](https://github.com/ruzia).
+* âī¸ Fix typo in `docs/ja/docs/tutorial/handling-errors.md`. PR [#13814](https://github.com/fastapi/fastapi/pull/13814) by [@ruzia](https://github.com/ruzia).
+* âī¸ Fix typo in `docs/ja/docs/tutorial/body-fields.md`. PR [#13802](https://github.com/fastapi/fastapi/pull/13802) by [@ruzia](https://github.com/ruzia).
+* đ Add Russian translation for `docs/ru/docs/advanced/index.md`. PR [#13797](https://github.com/fastapi/fastapi/pull/13797) by [@NavesSapnis](https://github.com/NavesSapnis).
+
+### Internal
+
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13823](https://github.com/fastapi/fastapi/pull/13823) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+
+## 0.115.13
+
+### Fixes
+
+* đ Fix truncating the model's description with form feed (`\f`) character for Pydantic V2. PR [#13698](https://github.com/fastapi/fastapi/pull/13698) by [@YuriiMotov](https://github.com/YuriiMotov).
+
+### Refactors
+
+* ⨠Add `refreshUrl` parameter in `OAuth2PasswordBearer`. PR [#11460](https://github.com/fastapi/fastapi/pull/11460) by [@snosratiershad](https://github.com/snosratiershad).
+* đ¸ Set format to password for fields `password` and `client_secret` in `OAuth2PasswordRequestForm`, make docs show password fields for passwords. PR [#11032](https://github.com/fastapi/fastapi/pull/11032) by [@Thodoris1999](https://github.com/Thodoris1999).
+* â
Simplify tests for `settings`. PR [#13505](https://github.com/fastapi/fastapi/pull/13505) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* â
Simplify tests for `validate_response_recursive`. PR [#13507](https://github.com/fastapi/fastapi/pull/13507) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+
+### Upgrades
+
+* âŦī¸ Update ReDoc to version 2.x. PR [#9700](https://github.com/fastapi/fastapi/pull/9700) by [@joakimnordling](https://github.com/joakimnordling).
+
+### Docs
+
+* đ Add annotations to HTTP middleware example. PR [#11530](https://github.com/fastapi/fastapi/pull/11530) by [@Kilo59](https://github.com/Kilo59).
+* đ Clarify in CORS docs that wildcards and credentials are mutually exclusive. PR [#9829](https://github.com/fastapi/fastapi/pull/9829) by [@dfioravanti](https://github.com/dfioravanti).
+* âī¸ Fix typo in docstring. PR [#13532](https://github.com/fastapi/fastapi/pull/13532) by [@comp64](https://github.com/comp64).
+* đ Clarify guidance on using `async def` without `await`. PR [#13642](https://github.com/fastapi/fastapi/pull/13642) by [@swastikpradhan1999](https://github.com/swastikpradhan1999).
+* đ Update exclude-parameters-from-openapi documentation links. PR [#13600](https://github.com/fastapi/fastapi/pull/13600) by [@timonrieger](https://github.com/timonrieger).
+* đ Clarify the middleware execution order in docs. PR [#13699](https://github.com/fastapi/fastapi/pull/13699) by [@YuriiMotov](https://github.com/YuriiMotov).
+* đą Update Drawio diagrams SVGs, single file per diagram, sans-serif font. PR [#13706](https://github.com/fastapi/fastapi/pull/13706) by [@tiangolo](https://github.com/tiangolo).
+* đ Update docs for "Help FastAPI", simplify and reduce "sponsor" section. PR [#13670](https://github.com/fastapi/fastapi/pull/13670) by [@tiangolo](https://github.com/tiangolo).
+* đ Remove unnecessary bullet from docs. PR [#13641](https://github.com/fastapi/fastapi/pull/13641) by [@Adamowoc](https://github.com/Adamowoc).
+* âī¸ Fix syntax error in `docs/en/docs/tutorial/handling-errors.md`. PR [#13623](https://github.com/fastapi/fastapi/pull/13623) by [@gsheni](https://github.com/gsheni).
+* đ Fix typo in documentation. PR [#13599](https://github.com/fastapi/fastapi/pull/13599) by [@Taoup](https://github.com/Taoup).
+* đ Fix liblab client generation doc link. PR [#13571](https://github.com/fastapi/fastapi/pull/13571) by [@EFord36](https://github.com/EFord36).
+* âī¸ Fix talk information typo. PR [#13544](https://github.com/fastapi/fastapi/pull/13544) by [@blueswen](https://github.com/blueswen).
+* đ Add External Link: Taiwanese talk on FastAPI with observability . PR [#13527](https://github.com/fastapi/fastapi/pull/13527) by [@blueswen](https://github.com/blueswen).
+
+### Translations
+
+* đ Add Russian Translation for `docs/ru/docs/advanced/response-change-status-code.md`. PR [#13791](https://github.com/fastapi/fastapi/pull/13791) by [@NavesSapnis](https://github.com/NavesSapnis).
+* đ Add Persian translation for `docs/fa/docs/learn/index.md`. PR [#13518](https://github.com/fastapi/fastapi/pull/13518) by [@Mohammad222PR](https://github.com/Mohammad222PR).
+* đ Add Korean translation for `docs/ko/docs/advanced/sub-applications.md`. PR [#4543](https://github.com/fastapi/fastapi/pull/4543) by [@NinaHwang](https://github.com/NinaHwang).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/schema-extra-example.md`. PR [#13769](https://github.com/fastapi/fastapi/pull/13769) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* âī¸ Remove redundant words in docs/zh/docs/python-types.md. PR [#13774](https://github.com/fastapi/fastapi/pull/13774) by [@CharleeWa](https://github.com/CharleeWa).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/query-param-models.md`. PR [#13748](https://github.com/fastapi/fastapi/pull/13748) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Bengali translation for `docs/bn/docs/environment-variables.md`. PR [#13629](https://github.com/fastapi/fastapi/pull/13629) by [@SakibSibly](https://github.com/SakibSibly).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/query-params-str-validations.md` page. PR [#13546](https://github.com/fastapi/fastapi/pull/13546) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Russian translation for `docs/ru/docs/tutorial/cookie-param-models.md`. PR [#13616](https://github.com/fastapi/fastapi/pull/13616) by [@EgorOnishchuk](https://github.com/EgorOnishchuk).
+* đ Add Korean translation for `docs/ko/docs/tutorial/extra-models.md`. PR [#13063](https://github.com/fastapi/fastapi/pull/13063) by [@timothy-jeong](https://github.com/timothy-jeong).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/path-params-numeric-validations.md` page. PR [#13548](https://github.com/fastapi/fastapi/pull/13548) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/middleware.md` page. PR [#13520](https://github.com/fastapi/fastapi/pull/13520) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/background-tasks.md` page. PR [#13502](https://github.com/fastapi/fastapi/pull/13502) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/cors.md` page. PR [#13519](https://github.com/fastapi/fastapi/pull/13519) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Update Korean translation for `docs/ko/docs/advanced/events.md`. PR [#13487](https://github.com/fastapi/fastapi/pull/13487) by [@bom1215](https://github.com/bom1215).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/handling-errors.md` page. PR [#13420](https://github.com/fastapi/fastapi/pull/13420) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Russian translation for `docs/ru/docs/tutorial/request-form-models.md`. PR [#13552](https://github.com/fastapi/fastapi/pull/13552) by [@EgorOnishchuk](https://github.com/EgorOnishchuk).
+* đ Fix internal anchor link in Spanish deployment docs. PR [#13737](https://github.com/fastapi/fastapi/pull/13737) by [@fabianfalon](https://github.com/fabianfalon).
+* đ Update Korean translation for `docs/ko/docs/virtual-environments.md`. PR [#13630](https://github.com/fastapi/fastapi/pull/13630) by [@sungchan1](https://github.com/sungchan1).
+* đ Add Russian translation for `docs/ru/docs/tutorial/header-param-models.md`. PR [#13526](https://github.com/fastapi/fastapi/pull/13526) by [@minaton-ru](https://github.com/minaton-ru).
+* đ Update Chinese translation for `docs/zh/docs/tutorial/index.md`. PR [#13374](https://github.com/fastapi/fastapi/pull/13374) by [@Zhongheng-Cheng](https://github.com/Zhongheng-Cheng).
+* đ Update Chinese translation for `docs/zh/docs/deployment/manually.md`. PR [#13324](https://github.com/fastapi/fastapi/pull/13324) by [@Zhongheng-Cheng](https://github.com/Zhongheng-Cheng).
+* đ Update Chinese translation for `docs/zh/docs/deployment/server-workers.md`. PR [#13292](https://github.com/fastapi/fastapi/pull/13292) by [@Zhongheng-Cheng](https://github.com/Zhongheng-Cheng).
+* đ Update Chinese translation for `docs/zh/docs/tutorial/first-steps.md`. PR [#13348](https://github.com/fastapi/fastapi/pull/13348) by [@Zhongheng-Cheng](https://github.com/Zhongheng-Cheng).
+
+### Internal
+
+* đ¨ Resolve Pydantic deprecation warnings in internal script. PR [#13696](https://github.com/fastapi/fastapi/pull/13696) by [@emmanuel-ferdman](https://github.com/emmanuel-ferdman).
+* đ§ Update sponsors: remove Porter. PR [#13783](https://github.com/fastapi/fastapi/pull/13783) by [@tiangolo](https://github.com/tiangolo).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13781](https://github.com/fastapi/fastapi/pull/13781) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13757](https://github.com/fastapi/fastapi/pull/13757) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* âŦ Bump griffe-typingdoc from 0.2.7 to 0.2.8. PR [#13751](https://github.com/fastapi/fastapi/pull/13751) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* đą Update sponsors: Dribia badge size. PR [#13773](https://github.com/fastapi/fastapi/pull/13773) by [@tiangolo](https://github.com/tiangolo).
+* đ§ Update sponsors: add Dribia. PR [#13771](https://github.com/fastapi/fastapi/pull/13771) by [@tiangolo](https://github.com/tiangolo).
+* âŦ Bump typer from 0.15.3 to 0.16.0. PR [#13752](https://github.com/fastapi/fastapi/pull/13752) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* đĨ Update FastAPI GitHub topic repositories. PR [#13754](https://github.com/fastapi/fastapi/pull/13754) by [@tiangolo](https://github.com/tiangolo).
+* đĨ Update FastAPI People - Sponsors. PR [#13750](https://github.com/fastapi/fastapi/pull/13750) by [@tiangolo](https://github.com/tiangolo).
+* đĨ Update FastAPI People - Contributors and Translators. PR [#13749](https://github.com/fastapi/fastapi/pull/13749) by [@tiangolo](https://github.com/tiangolo).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13736](https://github.com/fastapi/fastapi/pull/13736) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* đ§ Update sponsors: Add InterviewPal. PR [#13728](https://github.com/fastapi/fastapi/pull/13728) by [@tiangolo](https://github.com/tiangolo).
+* đ§ Remove Google Analytics. PR [#13727](https://github.com/fastapi/fastapi/pull/13727) by [@tiangolo](https://github.com/tiangolo).
+* đ§ Update sponsors: remove MongoDB. PR [#13725](https://github.com/fastapi/fastapi/pull/13725) by [@tiangolo](https://github.com/tiangolo).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13711](https://github.com/fastapi/fastapi/pull/13711) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* đ§ Update sponsors: add Subtotal. PR [#13701](https://github.com/fastapi/fastapi/pull/13701) by [@tiangolo](https://github.com/tiangolo).
+* đ§ Update sponsors: remove deepset / Haystack. PR [#13700](https://github.com/fastapi/fastapi/pull/13700) by [@tiangolo](https://github.com/tiangolo).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13688](https://github.com/fastapi/fastapi/pull/13688) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* đĨ Update FastAPI People - Experts. PR [#13671](https://github.com/fastapi/fastapi/pull/13671) by [@tiangolo](https://github.com/tiangolo).
+* âŦ Bump typer from 0.12.5 to 0.15.3. PR [#13666](https://github.com/fastapi/fastapi/pull/13666) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* âŦ Bump sqlmodel from 0.0.23 to 0.0.24. PR [#13665](https://github.com/fastapi/fastapi/pull/13665) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* đ§ Update Sponsors: Zuplo logo and alt text. PR [#13645](https://github.com/fastapi/fastapi/pull/13645) by [@martyndavies](https://github.com/martyndavies).
+* đĨ Update FastAPI GitHub topic repositories. PR [#13667](https://github.com/fastapi/fastapi/pull/13667) by [@tiangolo](https://github.com/tiangolo).
+* đ§ Update links for LinkedIn and bottom. PR [#13669](https://github.com/fastapi/fastapi/pull/13669) by [@tiangolo](https://github.com/tiangolo).
+* đ§ Update sponsors: remove Bump.sh and Coherence. PR [#13668](https://github.com/fastapi/fastapi/pull/13668) by [@tiangolo](https://github.com/tiangolo).
+* đĨ Update FastAPI People - Sponsors. PR [#13664](https://github.com/fastapi/fastapi/pull/13664) by [@tiangolo](https://github.com/tiangolo).
+* đĨ Update FastAPI People - Contributors and Translators. PR [#13662](https://github.com/fastapi/fastapi/pull/13662) by [@tiangolo](https://github.com/tiangolo).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13656](https://github.com/fastapi/fastapi/pull/13656) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* â
Use `inline-snapshot` to support different Pydantic versions in the test suite. PR [#12534](https://github.com/fastapi/fastapi/pull/12534) by [@15r10nk](https://github.com/15r10nk).
+* âŦ Bump astral-sh/setup-uv from 5 to 6. PR [#13648](https://github.com/fastapi/fastapi/pull/13648) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13634](https://github.com/fastapi/fastapi/pull/13634) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13619](https://github.com/fastapi/fastapi/pull/13619) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#13594](https://github.com/fastapi/fastapi/pull/13594) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* đĨ Update FastAPI People - Experts. PR [#13568](https://github.com/fastapi/fastapi/pull/13568) by [@tiangolo](https://github.com/tiangolo).
+* đĨ Update FastAPI GitHub topic repositories. PR [#13565](https://github.com/fastapi/fastapi/pull/13565) by [@tiangolo](https://github.com/tiangolo).
+* đĨ Update FastAPI People - Sponsors. PR [#13559](https://github.com/fastapi/fastapi/pull/13559) by [@tiangolo](https://github.com/tiangolo).
+* đĨ Update FastAPI People - Contributors and Translators. PR [#13558](https://github.com/fastapi/fastapi/pull/13558) by [@tiangolo](https://github.com/tiangolo).
+* âŦ Bump dirty-equals from 0.8.0 to 0.9.0. PR [#13561](https://github.com/fastapi/fastapi/pull/13561) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* đ§ Clean up `docs/en/mkdocs.yml` configuration file. PR [#13542](https://github.com/fastapi/fastapi/pull/13542) by [@svlandeg](https://github.com/svlandeg).
+* âŦ [pre-commit.ci] pre-commit autoupdate. PR [#12986](https://github.com/fastapi/fastapi/pull/12986) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+
+## 0.115.12
+
+### Fixes
+
+* đ Fix `convert_underscores=False` for header Pydantic models. PR [#13515](https://github.com/fastapi/fastapi/pull/13515) by [@tiangolo](https://github.com/tiangolo).
+
+### Docs
+
+* đ Update `docs/en/docs/tutorial/middleware.md`. PR [#13444](https://github.com/fastapi/fastapi/pull/13444) by [@Rishat-F](https://github.com/Rishat-F).
+* đĨ Update FastAPI People - Experts. PR [#13493](https://github.com/fastapi/fastapi/pull/13493) by [@tiangolo](https://github.com/tiangolo).
+
### Translations
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/metadata.md` page. PR [#13459](https://github.com/fastapi/fastapi/pull/13459) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/response-status-code.md` page. PR [#13462](https://github.com/fastapi/fastapi/pull/13462) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/cookie-param-models.md` page. PR [#13460](https://github.com/fastapi/fastapi/pull/13460) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Ukrainian translation for `docs/uk/docs/tutorial/header-param-models.md` page. PR [#13461](https://github.com/fastapi/fastapi/pull/13461) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* đ Add Japanese translation for `docs/ja/docs/virtual-environments.md`. PR [#13304](https://github.com/fastapi/fastapi/pull/13304) by [@k94-ishi](https://github.com/k94-ishi).
* đ Add Korean translation for `docs/ko/docs/tutorial/security/oauth2-jwt.md`. PR [#13333](https://github.com/fastapi/fastapi/pull/13333) by [@yes0ng](https://github.com/yes0ng).
* đ Add Vietnamese translation for `docs/vi/docs/deployment/cloud.md`. PR [#13407](https://github.com/fastapi/fastapi/pull/13407) by [@ptt3199](https://github.com/ptt3199).
### Internal
+* âŦ Bump pydantic-ai from 0.0.15 to 0.0.30. PR [#13438](https://github.com/fastapi/fastapi/pull/13438) by [@dependabot[bot]](https://github.com/apps/dependabot).
* âŦ Bump sqlmodel from 0.0.22 to 0.0.23. PR [#13437](https://github.com/fastapi/fastapi/pull/13437) by [@dependabot[bot]](https://github.com/apps/dependabot).
* âŦ Bump black from 24.10.0 to 25.1.0. PR [#13436](https://github.com/fastapi/fastapi/pull/13436) by [@dependabot[bot]](https://github.com/apps/dependabot).
* âŦ Bump ruff to 0.9.4. PR [#13299](https://github.com/fastapi/fastapi/pull/13299) by [@dependabot[bot]](https://github.com/apps/dependabot).
diff --git a/docs/en/docs/tutorial/bigger-applications.md b/docs/en/docs/tutorial/bigger-applications.md
index 605ced0d3..f5f29a173 100644
--- a/docs/en/docs/tutorial/bigger-applications.md
+++ b/docs/en/docs/tutorial/bigger-applications.md
@@ -52,7 +52,7 @@ from app.routers import items
* There's also a subdirectory `app/internal/` with another file `__init__.py`, so it's another "Python subpackage": `app.internal`.
* And the file `app/internal/admin.py` is another submodule: `app.internal.admin`.
-simple CORS requests .
-* `allow_credentials` - Indicate that cookies should be supported for cross-origin requests. Defaults to `False`. Also, `allow_origins` cannot be set to `['*']` for credentials to be allowed, origins must be specified.
+* `allow_credentials` - Indicate that cookies should be supported for cross-origin requests. Defaults to `False`.
+
+ None of `allow_origins`, `allow_methods` and `allow_headers` can be set to `['*']` if `allow_credentials` is set to `True`. All of them must be explicitly specified .
+
* `expose_headers` - Indicate any response headers that should be made accessible to the browser. Defaults to `[]`.
* `max_age` - Sets a maximum time in seconds for browsers to cache CORS responses. Defaults to `600`.
diff --git a/docs/en/docs/tutorial/handling-errors.md b/docs/en/docs/tutorial/handling-errors.md
index 4d969747f..5b8e677e4 100644
--- a/docs/en/docs/tutorial/handling-errors.md
+++ b/docs/en/docs/tutorial/handling-errors.md
@@ -35,7 +35,7 @@ Because it's a Python exception, you don't `return` it, you `raise` it.
This also means that if you are inside a utility function that you are calling inside of your *path operation function*, and you raise the `HTTPException` from inside of that utility function, it won't run the rest of the code in the *path operation function*, it will terminate that request right away and send the HTTP error from the `HTTPException` to the client.
-The benefit of raising an exception over `return`ing a value will be more evident in the section about Dependencies and Security.
+The benefit of raising an exception over returning a value will be more evident in the section about Dependencies and Security.
In this example, when the client requests an item by an ID that doesn't exist, raise an exception with a status code of `404`:
@@ -252,4 +252,4 @@ If you want to use the exception along with the same default exception handlers
{* ../../docs_src/handling_errors/tutorial006.py hl[2:5,15,21] *}
-In this example you are just `print`ing the error with a very expressive message, but you get the idea. You can use the exception and then just reuse the default exception handlers.
+In this example you are just printing the error with a very expressive message, but you get the idea. You can use the exception and then just reuse the default exception handlers.
diff --git a/docs/en/docs/tutorial/header-param-models.md b/docs/en/docs/tutorial/header-param-models.md
index 73950a668..4cdf09705 100644
--- a/docs/en/docs/tutorial/header-param-models.md
+++ b/docs/en/docs/tutorial/header-param-models.md
@@ -51,6 +51,22 @@ For example, if the client tries to send a `tool` header with a value of `plumbu
}
```
+## Disable Convert Underscores
+
+The same way as with regular header parameters, when you have underscore characters in the parameter names, they are **automatically converted to hyphens**.
+
+For example, if you have a header parameter `save_data` in the code, the expected HTTP header will be `save-data`, and it will show up like that in the docs.
+
+If for some reason you need to disable this automatic conversion, you can do it as well for Pydantic models for header parameters.
+
+{* ../../docs_src/header_param_models/tutorial003_an_py310.py hl[19] *}
+
+/// warning
+
+Before setting `convert_underscores` to `False`, bear in mind that some HTTP proxies and servers disallow the usage of headers with underscores.
+
+///
+
## Summary
You can use **Pydantic models** to declare **headers** in **FastAPI**. đ
diff --git a/docs/en/docs/tutorial/index.md b/docs/en/docs/tutorial/index.md
index 4fe38256c..17f6fb685 100644
--- a/docs/en/docs/tutorial/index.md
+++ b/docs/en/docs/tutorial/index.md
@@ -76,10 +76,12 @@ $ pip install "fastapi[standard]"
/// note
-When you install with `pip install "fastapi[standard]"` it comes with some default optional standard dependencies.
+When you install with `pip install "fastapi[standard]"` it comes with some default optional standard dependencies, including `fastapi-cloud-cli`, which allows you to deploy to FastAPI Cloud .
If you don't want to have those optional dependencies, you can instead install `pip install fastapi`.
+If you want to install the standard dependencies but without the `fastapi-cloud-cli`, you can install with `pip install "fastapi[standard-no-fastapi-cloud-cli]"`.
+
///
## Advanced User Guide
diff --git a/docs/en/docs/tutorial/middleware.md b/docs/en/docs/tutorial/middleware.md
index 53c47a085..b7c03a319 100644
--- a/docs/en/docs/tutorial/middleware.md
+++ b/docs/en/docs/tutorial/middleware.md
@@ -15,7 +15,7 @@ A "middleware" is a function that works with every **request** before it is proc
If you have dependencies with `yield`, the exit code will run *after* the middleware.
-If there were any background tasks (documented later), they will run *after* all the middleware.
+If there were any background tasks (covered in the [Background Tasks](background-tasks.md){.internal-link target=_blank} section, you will see it later), they will run *after* all the middleware.
///
@@ -65,6 +65,29 @@ Here we use -
- Thanks for your feedback!
- - icon: material/emoticon-sad-outline
- name: This page could be improved
- data: 0
- note: >-
- Thanks for your feedback!
social:
- icon: fontawesome/brands/github-alt
link: https://github.com/fastapi/fastapi
@@ -331,14 +297,9 @@ extra:
- icon: fontawesome/brands/twitter
link: https://twitter.com/fastapi
- icon: fontawesome/brands/linkedin
- link: https://www.linkedin.com/in/tiangolo
- - icon: fontawesome/brands/dev
- link: https://dev.to/tiangolo
- - icon: fontawesome/brands/medium
- link: https://medium.com/@tiangolo
+ link: https://www.linkedin.com/company/fastapi
- icon: fontawesome/solid/globe
link: https://tiangolo.com
-
alternate:
- link: /
name: en - English
@@ -390,14 +351,11 @@ extra:
name: zh-hant - įšéĢä¸æ
- link: /em/
name: đ
-
extra_css:
- css/termynal.css
- css/custom.css
-
extra_javascript:
- js/termynal.js
- js/custom.js
-
hooks:
- ../../scripts/mkdocs_hooks.py
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 30973bfcb..22630e188 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -10,6 +10,13 @@
Follow @fastapi on Twitter to stay updated
+
-
@@ -34,18 +38,6 @@
-
-
-
-
+
+
{% endblock %}
diff --git a/docs/es/docs/advanced/generate-clients.md b/docs/es/docs/advanced/generate-clients.md
index bf2e5cb4f..b664bceac 100644
--- a/docs/es/docs/advanced/generate-clients.md
+++ b/docs/es/docs/advanced/generate-clients.md
@@ -22,7 +22,7 @@ Y muestra su verdadero compromiso con FastAPI y su **comunidad** (tÃē), ya que n
Por ejemplo, podrÃas querer probar:
-* Speakeasy
+* Speakeasy
* Stainless
* liblab
diff --git a/docs/es/docs/deployment/concepts.md b/docs/es/docs/deployment/concepts.md
index f5725c5dc..bcc7948bc 100644
--- a/docs/es/docs/deployment/concepts.md
+++ b/docs/es/docs/deployment/concepts.md
@@ -216,7 +216,7 @@ Este Proceso Administrador probablemente serÃa el que escuche en el **puerto**
Esos worker processes serÃan los que ejecutan tu aplicaciÃŗn, realizarÃan los cÃĄlculos principales para recibir un **request** y devolver un **response**, y cargarÃan cualquier cosa que pongas en variables en RAM.
-`redoc.standalone.js`
+* `redoc.standalone.js`
DespuÊs de eso, tu estructura de archivos podrÃa verse asÃ:
@@ -129,14 +129,8 @@ DeberÃas ver un archivo JavaScript muy largo de **ReDoc**.
PodrÃa comenzar con algo como:
```JavaScript
-/*!
- * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
- * -------------------------------------------------------------
- * Version: "2.0.0-rc.18"
- * Repo: https://github.com/Redocly/redoc
- */
-!function(e,t){"object"==typeof exports&&"object"==typeof m
-
+/*! For license information please see redoc.standalone.js.LICENSE.txt */
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t(require("null")):
...
```
diff --git a/docs/es/docs/tutorial/bigger-applications.md b/docs/es/docs/tutorial/bigger-applications.md
index 78165ef05..c3d8f0686 100644
--- a/docs/es/docs/tutorial/bigger-applications.md
+++ b/docs/es/docs/tutorial/bigger-applications.md
@@ -52,7 +52,7 @@ from app.routers import items
* TambiÊn hay un subdirectorio `app/internal/` con otro archivo `__init__.py`, por lo que es otro "subpaquete de Python": `app.internal`.
* Y el archivo `app/internal/admin.py` es otro submÃŗdulo: `app.internal.admin`.
-TL;DR: I/O Ø§Ø´Ø§ØąŲ Ø¯Ø§ØąŲ ÚŠŲ ŲØŗبØĒاŲ "ØĸØąŲŲ
" ŲØŗØĒŲ (ŲØŗبØĒ بŲ ØŗØąØšØĒ ŲžØąØ¯Ø§Ø˛ŲدŲ Ų ØاŲظŲ RAM)Ø Ų
ØĢŲ Ų
ŲØĒØ¸Øą Ų
ŲŲدŲ Ø¨ØąØ§Û:
+
+* دادŲâŲاÛÛ ÚŠŲ Ø§Ø˛ ÚŠŲاÛŲØĒ Ø§Ø˛ ØˇØąÛŲ شبڊŲ ŲØąØŗØĒادŲ Ų
ÛâØ´Ų
+* دادŲâŲاÛÛ ÚŠŲ Ø¨ØąŲاŲ
ŲâاØĒ ŲØąØŗØĒادŲ ØĒا Ø§Ø˛ ØˇØąÛŲ شبڊŲ بŲ ÚŠŲاÛŲØĒ Ø¨ØąØŗŲ
+* Ų
ØØĒŲØ§Û ÛŲ ŲاÛŲ ØĒŲÛ Ø¯ÛØŗÚŠ ÚŠŲ ØŗÛØŗØĒŲ
ب؎ŲŲدش Ų بŲ Ø¨ØąŲاŲ
ŲâاØĒ بدŲ
+* Ų
ØØĒŲاÛÛ ÚŠŲ Ø¨ØąŲاŲ
ŲâاØĒ بŲ ØŗÛØŗØĒŲ
دادŲ ØĒا ØĒŲÛ Ø¯ÛØŗÚŠ بŲŲÛØŗŲ
+* ÛŲ ØšŲ
ŲÛاØĒ API Ø§Ø˛ ØąØ§Ų دŲØą
+* ÛŲ ØšŲ
ŲÛاØĒ دÛØĒابÛØŗ ÚŠŲ ØĒŲ
ŲŲ
بشŲ
+* ÛŲ ÚŠŲØĻØąÛ Ø¯ÛØĒابÛØŗ ÚŠŲ ŲØĒاÛØŦØ´ Ø¨ØąÚ¯ØąØ¯Ų
+* Ų ØēÛØąŲ.
+
+ÚŲŲ Ø˛Ų
اŲ اØŦØąØ§ بÛØ´ØĒØą ØĩØąŲ اŲØĒØ¸Ø§Øą Ø¨ØąØ§Û ØšŲ
ŲÛاØĒ I/O Ų
ÛâØ´ŲØ Ø¨ŲØ´ŲŲ Ų
ÛâÚ¯Ų ØšŲ
ŲÛاØĒ "I/O bound".
+
+بŲØ´ "ŲاŲŲ
âØ˛Ų
اŲ" Ų
ÛâÚ¯Ų ÚŲŲ ڊاŲ
ŲžÛŲØĒØą / Ø¨ØąŲاŲ
Ų ŲØ§Ø˛Ų
ŲÛØŗØĒ با ÚŠØ§Øą ØĸØąŲŲ
"ŲŲ
âØ˛Ų
اŲ" باشŲØ Ų
ŲØĒØ¸Øą ŲØظŲ دŲÛŲ ØĒŲ
ŲŲ
شدŲ ÚŠØ§Øą بŲ
ŲŲŲØ Ø¯Øą ØاŲÛ ÚŠŲ ŲÛÚ ÚŠØ§ØąÛ ŲŲ
ÛâÚŠŲŲØ ØĒا ŲØĒÛØŦŲ ØąŲ بگÛØąŲ Ų ÚŠØ§ØąØ´ ØąŲ اداŲ
Ų بدŲ.
+
+بŲ ØŦØ§Ø´Ø ÚŲŲ ÛŲ ØŗÛØŗØĒŲ
"ŲاŲŲ
âØ˛Ų
اŲ" ŲØŗØĒØ ŲŲØĒÛ ÚŠØ§Øą ØĒŲ
ŲŲ
Ø´Ø¯Ø Ų
ÛâØĒŲŲŲ ÛŲ ÚŠŲ
ØĒŲÛ ØĩŲ Ų
ŲØĒØ¸Øą بŲ
ŲŲŲ (ÚŲد Ų
ÛÚŠØąŲØĢاŲÛŲ) ØĒا ڊاŲ
ŲžÛŲØĒØą / Ø¨ØąŲاŲ
Ų ŲØą ÚŠØ§ØąÛ ÚŠŲ ØąŲØĒŲ بڊŲŲ ØąŲ ØĒŲ
ŲŲ
ÚŠŲŲØ Ų بؚد Ø¨ØąÚ¯ØąØ¯Ų ŲØĒÛØŦŲ ØąŲ بگÛØąŲ Ų باŲاش ÚŠØ§Øą ÚŠŲŲ.
+
+Ø¨ØąØ§Û "ŲŲ
âØ˛Ų
اŲ" (Ø¨ØąØŽŲاŲ "ŲاŲŲ
âØ˛Ų
اŲ") Ų
ØšŲ
ŲŲاŲ Ø§Ø˛ اØĩØˇŲØ§Ø "ØĒØąØĒÛبÛ" ŲŲ
اØŗØĒŲادŲ Ų
ÛâÚŠŲŲØ ÚŲŲ ڊاŲ
ŲžÛŲØĒØą / Ø¨ØąŲاŲ
Ų ŲŲ
Ų Ų
ØąØ§ØŲ ØąŲ بŲ ØĒØąØĒÛب دŲباŲ Ų
ÛâÚŠŲŲ ŲبŲ Ø§Ø˛ اÛŲÚŠŲ Ø¨ØąŲ ØŗØąØ§Øē ÛŲ ÚŠØ§Øą دÛÚ¯ŲØ ØØĒÛ Ø§Ú¯Ų اŲŲ Ų
ØąØ§ØŲ شاŲ
Ų اŲØĒØ¸Ø§Øą باشŲ.
+
+### ŲŲ
âØ˛Ų
اŲÛ Ų Ø¨ØąÚ¯ØąŲا
+
+اÛŲ اÛدŲ **ŲاŲŲ
âØ˛Ų
اŲ** ÚŠŲ باŲا ØĒŲØļÛØ Ø¯Ø§Ø¯Ų
گاŲÛ Ø¨ŲØ´ **"ŲŲ
âØ˛Ų
اŲÛ"** ŲŲ
Ų
ÛâÚ¯Ų. با **"Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û"** ŲØąŲ Ø¯Ø§ØąŲ.
+
+**ŲŲ
âØ˛Ų
اŲÛ** Ų **Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û** ŲØą دŲ بŲ "اØĒŲاŲ اŲØĒادŲ ÚÛØ˛Ø§Û Ų
ØŽØĒŲŲ ÚŠŲ
âŲبÛØ´ ŲŲ
Ø˛Ų
اŲ" ØąØ¨Øˇ Ø¯Ø§ØąŲ.
+
+ŲŲÛ ØŦØ˛ØĻÛاØĒ بÛŲ *ŲŲ
âØ˛Ų
اŲÛ* Ų *Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û* ØŽÛŲÛ Ų
ØĒŲاŲØĒŲ.
+
+Ø¨ØąØ§Û Ø¯ÛدŲ ŲØąŲØ´Ø Ø§ÛŲ داØŗØĒاŲ Ø¯Øą Ų
ŲØąØ¯ Ø¨ØąÚ¯ØąŲا ØąŲ ØĒØĩŲØą ÚŠŲ:
+
+### Ø¨ØąÚ¯ØąŲØ§Û ŲŲ
âØ˛Ų
اŲ
+
+با ؚشŲØĒ Ų
ÛâØąÛ ŲØŗØĒâŲŲد بگÛØąÛŲØ ØĒŲÛ ØĩŲ ŲاÛŲ
ÛØŗØĒÛ Ø¯Øą ØاŲÛ ÚŠŲ ØĩŲدŲŲØ¯Ø§Øą ØŗŲØ§ØąØ´ ØĸدŲ
Ø§Û ØŦŲŲÛ ØĒŲ ØąŲ Ų
ÛâÚ¯ÛØąŲ. đ
+
+ÚŠØĒØąÛŲا ØĒاŲ
ŲžØŗŲŲ . đ¨
+
+///
+
+---
+
+ØĒØĩŲØą ÚŠŲ ØĒŲ ØĒŲÛ Ø§ÛŲ داØŗØĒاŲ ڊاŲ
ŲžÛŲØĒØą / Ø¨ØąŲاŲ
Ų đ¤ ŲØŗØĒÛ.
+
+ŲŲØĒÛ ØĒŲÛ ØĩŲ ŲØŗØĒÛØ ŲŲØˇ بÛÚŠØ§ØąÛ đ´Ø Ų
ŲØĒØ¸Øą ŲŲبØĒØĒ ŲØŗØĒÛØ ÚŠØ§Øą ØŽÛŲÛ "Ų
ŲÛدÛ" ŲŲ
ÛâÚŠŲÛ. ŲŲÛ ØĩŲ ØŗØąÛØš ŲžÛØ´ Ų
ÛâØąŲ ÚŲŲ ØĩŲدŲŲØ¯Ø§Øą ŲŲØˇ ØŗŲØ§ØąØ´ Ų
ÛâÚ¯ÛØąŲ (ØĸŲ
ادشŲŲ ŲŲ
ÛâÚŠŲŲ)Ø ŲžØŗ اÛŲ ØŽŲبŲ.
+
+Ø¨ØšØ¯Ø ŲŲØĒÛ ŲŲبØĒØĒ Ų
ÛâØ´ŲØ ÚŠØ§Øą "Ų
ŲÛد" ŲاŲØšÛ Ų
ÛâÚŠŲÛØ Ų
ŲŲ ØąŲ ŲžØąØ¯Ø§Ø˛Ø´ Ų
ÛâÚŠŲÛØ ØĒØĩŲ
ÛŲ
Ų
ÛâÚ¯ÛØąÛ ÚÛ Ų
ÛâØŽŲاÛØ Ø§ŲØĒ؎اب ؚشŲØĒ ØąŲ Ų
ÛâÚ¯ÛØąÛØ ŲžŲŲ Ų
ÛâدÛØ ÚÚŠ Ų
ÛâÚŠŲÛ Ø§ØŗÚŠŲاØŗ Ûا ÚŠØ§ØąØĒ Ø¯ØąØŗØĒ ØąŲ دادÛØ ÚÚŠ Ų
ÛâÚŠŲÛ Ø¯ØąØŗØĒ ØØŗاب شدŲØ ÚÚŠ Ų
ÛâÚŠŲÛ ØŗŲØ§ØąØ´ ØĸÛØĒŲ
Ø§Û Ø¯ØąØŗØĒ ØąŲ Ø¯Ø§ØąŲ Ų ØēÛØąŲ.
+
+ŲŲÛ Ø¨ØšØ¯Ø Ú¯ØąÚŲ ŲŲŲØ˛ Ø¨ØąÚ¯ØąŲاØĒ ØąŲ ŲØ¯Ø§ØąÛØ ÚŠØ§ØąØĒ با ØĩŲدŲŲØ¯Ø§Øą "Ų
ŲŲØĒاŲ Ų
ØĒŲŲŲ" ⸠Ų
ÛâØ´ŲØ ÚŲŲ باÛد Ų
ŲØĒØ¸Øą بŲ
ŲŲÛ đ ØĒا Ø¨ØąÚ¯ØąŲاØĒ ØĸŲ
ادŲ بشŲ.
+
+ŲŲÛ ŲŲØĒÛ Ø§Ø˛ ŲžÛØ´ØŽŲŲ دŲØą Ų
ÛâØ´Û Ų با Ø´Ų
Ø§ØąŲ ŲŲبØĒØĒ ØŗØą Ų
ÛØ˛ Ų
ÛâØ´ÛŲÛØ Ų
ÛâØĒŲŲÛ ØĒŲØŦŲØĒ ØąŲ đ بŲ ؚشŲØĒ Ø¨Ø¯Û Ų "ÚŠØ§Øą" ⯠đ¤ ØąŲ اŲŲ بڊŲÛ. بؚدش دŲØ¨Ø§ØąŲ Ø¯Ø§ØąÛ ÛŲ ÚÛØ˛ ØŽÛŲÛ "Ų
ŲÛد" اŲØŦاŲ
Ų
ÛâدÛØ Ų
ØĢŲ ŲاØŗ Ø˛Ø¯Ų با ؚشŲØĒ đ.
+
+بؚد ØĩŲدŲŲØ¯Ø§Øą đ با گذاشØĒŲ Ø´Ų
Ø§ØąŲâاØĒ ØąŲ ŲŲ
اÛØ´Ú¯Øą ŲžÛØ´ØŽŲŲ Ų
ÛâÚ¯Ų "Ų
Ų با Ø¯ØąØŗØĒ ÚŠØąØ¯Ų Ø¨ØąÚ¯ØąŲا ØĒŲ
ŲŲ
ÚŠØąØ¯Ų
"Ø ŲŲÛ ØĒŲ Ų
ØĢŲ دÛŲŲŲŲâŲا ŲŲØĒÛ Ø´Ų
Ø§ØąŲâاØĒ ØąŲ ŲŲ
اÛØ´Ú¯Øą Ų
Ûاد ŲŲØąÛ ŲŲ
ÛâŲžØąÛ. Ų
ÛâدŲŲÛ ÚŠØŗÛ Ø¨ØąÚ¯ØąŲاØĒ ØąŲ ŲŲ
ÛâØ¯Ø˛Ø¯Ų ÚŲŲ Ø´Ų
Ø§ØąŲ ŲŲبØĒØĒ ØąŲ Ø¯Ø§ØąÛØ Ų اŲŲا ŲŲ
Ų
اŲ ØŽŲدشŲŲ ØąŲ Ø¯Ø§ØąŲ.
+
+ŲžØŗ Ų
ŲØĒØ¸Øą Ų
ÛâŲ
ŲŲÛ ØĒا ؚشŲØĒ داØŗØĒاŲØ´ ØąŲ ØĒŲ
ŲŲ
ÚŠŲŲ (ÚŠØ§Øą ŲØšŲÛ â¯ / ŲظÛŲŲâØ§Û ÚŠŲ Ø¯Ø§ØąŲ ŲžØąØ¯Ø§Ø˛Ø´ Ų
ÛâØ´Ų đ¤)Ø ØĸØąŲŲ
Ųب؎Ųد Ų
ÛâØ˛ŲÛ Ų Ų
ÛâÚ¯Û ÚŠŲ Ų
ÛâØąÛ Ø¨ØąÚ¯ØąŲا ØąŲ بÛØ§ØąÛ â¸.
+
+بؚد Ų
ÛâØąÛ ŲžÛØ´ØŽŲŲ đØ Ø¨Ų ÚŠØ§Øą اŲŲÛŲ ÚŠŲ ØاŲا ØĒŲ
ŲŲ
شدŲ â¯Ø Ø¨ØąÚ¯ØąŲا ØąŲ Ų
ÛâÚ¯ÛØąÛØ ØĒØ´ÚŠØą Ų
ÛâÚŠŲÛ Ų Ų
ÛâØ¨ØąØ´ŲŲ ØŗØą Ų
ÛØ˛. اÛŲ Ų
ØąØŲŲ / ŲظÛŲŲ ØĒؚاŲ
Ų با ŲžÛØ´ØŽŲŲ ØąŲ ØĒŲ
ŲŲ
Ų
ÛâÚŠŲŲ âš. اÛŲ بŲ ŲŲبŲ ØŽŲدش ÛŲ ŲظÛŲŲ ØŦدÛØ¯Ø "ØŽŲØąØ¯Ų Ø¨ØąÚ¯ØąŲا" đ â¯Ø Ų
ÛâØŗØ§Ø˛ŲØ ŲŲÛ Ø§ŲŲ ŲبŲÛ ÚŠŲ "Ú¯ØąŲØĒŲ Ø¨ØąÚ¯ØąŲا" بŲد ØĒŲ
ŲŲ
شدŲ âš.
+
+### Ø¨ØąÚ¯ØąŲØ§Û Ų
ŲØ§Ø˛Û
+
+ØاŲا ŲØąØļ ÚŠŲ اÛŲا "Ø¨ØąÚ¯ØąŲØ§Û ŲŲ
âØ˛Ų
اŲ" ŲÛØŗØĒŲØ Ø¨ŲÚŠŲ "Ø¨ØąÚ¯ØąŲØ§Û Ų
ŲØ§Ø˛Û" ŲØŗØĒŲ.
+
+با ؚشŲØĒ Ų
ÛâØąÛ ŲØŗØĒâŲŲد Ų
ŲØ§Ø˛Û Ø¨Ú¯ÛØąÛ.
+
+ØĒŲÛ ØĩŲ ŲاÛŲ
ÛØŗØĒÛ Ø¯Øą ØاŲÛ ÚŠŲ ÚŲد ØĒا (Ų
ØĢŲاŲ 8 ØĒا) ØĩŲدŲŲØ¯Ø§Øą ÚŠŲ ŲŲ
Ø˛Ų
اŲ ØĸØ´ŲžØ˛ ŲŲ
ŲØŗØĒŲ ØŗŲØ§ØąØ´ ØĸدŲ
Ø§Û ØŦŲŲÛ ØĒŲ ØąŲ Ų
ÛâÚ¯ÛØąŲ.
+
+ŲŲ
Ų ŲبŲ ØĒŲ Ų
ŲØĒØ¸ØąŲ Ø¨ØąÚ¯ØąŲاشŲŲ ØĸŲ
ادŲ بشŲ ŲبŲ Ø§Ø˛ اÛŲÚŠŲ ŲžÛØ´ØŽŲŲ ØąŲ ØĒØąÚŠ ÚŠŲŲØ ÚŲŲ ŲØą ڊدŲŲ
Ø§Ø˛ 8 ØĒا ØĩŲدŲŲØ¯Ø§Øą Ų
ÛâØąŲ Ų Ø¨ØąÚ¯Øą ØąŲ ŲŲ
ŲŲ Ų
ŲŲØš Ø¯ØąØŗØĒ Ų
ÛâÚŠŲŲ ŲبŲ Ø§Ø˛ اÛŲÚŠŲ ØŗŲØ§ØąØ´ Ø¨ØšØ¯Û ØąŲ بگÛØąŲ.
+
+ÚŠØĒØąÛŲا ØĒاŲ
ŲžØŗŲŲ . đ¨
+
+///
+
+---
+
+ØĒŲÛ Ø§ÛŲ ØŗŲØ§ØąÛŲÛ Ø¨ØąÚ¯ØąŲØ§Û Ų
ŲØ§Ø˛ÛØ ØĒŲ ÛŲ ڊاŲ
ŲžÛŲØĒØą / Ø¨ØąŲاŲ
Ų đ¤ با دŲ ØĒا ŲžØąØ¯Ø§Ø˛ŲدŲ (ØĒŲ Ų ؚشŲØĒ) ŲØŗØĒÛØ ŲØą دŲ Ų
ŲØĒØ¸Øą đ Ų ØĒŲØŦŲØ´ŲŲ â¯ ØąŲ Ø¨ØąØ§Û Ų
دØĒ ØˇŲŲاŲÛ "اŲØĒØ¸Ø§Øą ØŦŲŲÛ ŲžÛØ´ØŽŲŲ" đ گذاشØĒŲ.
+
+ŲØŗØĒâŲŲد 8 ØĒا ŲžØąØ¯Ø§Ø˛ŲدŲ (ØĩŲدŲŲØ¯Ø§Øą/ØĸØ´ŲžØ˛) Ø¯Ø§ØąŲ. Ø¯Øą ØاŲÛ ÚŠŲ ŲØŗØĒâŲŲد Ø¨ØąÚ¯ØąŲØ§Û ŲŲ
âØ˛Ų
اŲ شاÛد ŲŲØˇ 2 ØĒا داشØĒŲ (ÛŲ ØĩŲدŲŲØ¯Ø§Øą Ų ÛŲ ØĸØ´ŲžØ˛).
+
+ŲŲÛ Ø¨Ø§ اÛŲ ØاŲØ ØĒØŦØąØ¨Ų ŲŲاÛÛ Ø¨ŲØĒØąÛŲ ŲÛØŗØĒ. đ
+
+---
+
+اÛŲ Ų
ؚادŲ Ų
ŲØ§Ø˛Û Ø¯Ø§ØŗØĒاŲ Ø¨ØąÚ¯ØąŲا بŲد. đ
+
+Ø¨ØąØ§Û ÛŲ Ų
ØĢاŲ "ŲاŲØšÛâØĒØą" Ø§Ø˛ Ø˛ŲدگÛØ ÛŲ باŲÚŠ ØąŲ ØĒØĩŲØą ÚŠŲ.
+
+ØĒا ŲŲ
ÛŲ ÚŲد ŲŲØĒ ŲžÛØ´Ø Ø¨ÛØ´ØĒØą باŲÚŠâŲا ÚŲد ØĒا ØĩŲدŲŲØ¯Ø§Øą đ¨âđŧđ¨âđŧđ¨âđŧđ¨âđŧ داشØĒŲ Ų ÛŲ ØĩŲ Ø¨Ø˛ØąÚ¯ đđđđđđđđ.
+
+ŲŲ
Ų ØĩŲدŲŲØ¯Ø§ØąŲا ÚŠØ§Øą ØąŲ با ÛŲ Ų
Ø´ØĒØąÛ Ø¨ØšØ¯ Ø§Ø˛ اŲŲ ÛÚŠÛ đ¨âđŧ⯠اŲØŦاŲ
Ų
ÛâدادŲ.
+
+Ų باÛد ØĒŲÛ ØĩŲ đ Ų
دØĒ Ø˛ÛØ§Ø¯Û Ų
ŲØĒØ¸Øą بŲ
ŲŲÛ ŲÚ¯ØąŲŲ ŲŲبØĒØĒ ØąŲ Ø§Ø˛ دØŗØĒ Ų
ÛâدÛ.
+
+اØØĒŲ
اŲاŲ ŲŲ
ÛâØŽŲØ§Û ØšØ´ŲØĒ đ ØąŲ با ØŽŲدØĒ Ø¨Ø¨ØąÛ Ø¨Ø§ŲÚŠ đĻ Ø¨ØąØ§Û ÚŠØ§ØąØ§Û ØąŲØ˛Ų
ØąŲ.
+
+### ŲØĒÛØŦŲâÚ¯ÛØąÛ Ø¨ØąÚ¯ØąŲا
+
+ØĒŲÛ Ø§ÛŲ ØŗŲØ§ØąÛŲÛ "Ø¨ØąÚ¯ØąŲØ§Û ŲØŗØĒâŲŲد با ؚشŲØĒ"Ø ÚŲŲ ÚŠŲÛ Ø§ŲØĒØ¸Ø§Øą đ ŲØŗØĒØ ØŽÛŲÛ Ų
ŲØˇŲÛâØĒØąŲ ÚŠŲ ÛŲ ØŗÛØŗØĒŲ
ŲŲ
âØ˛Ų
اŲ â¸đ⯠داشØĒŲ باشÛ.
+
+اÛŲ Ø¨ØąØ§Û Ø¨ÛØ´ØĒØą Ø¨ØąŲاŲ
ŲâŲØ§Û Ųب ŲŲ
ØĩدŲ Ų
ÛâÚŠŲŲ.
+
+ØŽÛŲÛ ØŽÛŲÛ ÚŠØ§ØąØ¨ØąØ ŲŲÛ ØŗØąŲØąØĒ Ų
ŲØĒØ¸Øą đ اØĒØĩاŲ ŲŲâÚŲداŲ ØŽŲبشŲŲ ŲØŗØĒ ØĒا Ø¯ØąØŽŲاØŗØĒâŲاشŲŲ ØąŲ بŲØąØŗØĒŲ.
+
+Ų بؚد دŲØ¨Ø§ØąŲ Ų
ŲØĒØ¸Øą đ ÚŠŲ ØŦŲابâŲا Ø¨ØąÚ¯ØąØ¯Ų.
+
+اÛŲ "اŲØĒØ¸Ø§Øą" đ ØĒŲÛ Ų
ÛÚŠØąŲØĢاŲÛŲâŲا اŲØ¯Ø§Ø˛ŲâÚ¯ÛØąÛ Ų
ÛâØ´ŲØ ŲŲÛ Ø¨Ø§ اÛŲ ØاŲØ ØŦŲ
ؚش ÚŠŲ بڊŲÛ ØĸØŽØąØ´ ÚŠŲÛ Ø§ŲØĒØ¸Ø§Øą Ų
ÛâØ´Ų.
+
+Ø¨ØąØ§Û ŲŲ
ÛŲ اØŗØĒŲادŲ Ø§Ø˛ ڊد ŲاŲŲ
âØ˛Ų
اŲ â¸đâ¯ Ø¨ØąØ§Û APIŲØ§Û Ųب ØŽÛŲÛ Ų
ŲØˇŲÛŲ.
+
+اÛŲ ŲŲØš ŲاŲŲ
âØ˛Ų
اŲÛ ÚÛØ˛ÛŲ ÚŠŲ NodeJS ØąŲ Ų
ØبŲب ÚŠØąØ¯ (Ú¯ØąÚŲ NodeJS Ų
ŲØ§Ø˛Û ŲÛØŗØĒ) Ų ŲŲØˇŲ ŲŲØĒ Go بŲâØšŲŲاŲ ÛŲ Ø˛Ø¨ŲŲ Ø¨ØąŲاŲ
ŲâŲŲÛØŗÛŲ.
+
+Ų ŲŲ
ŲŲ ØŗØˇØ ØšŲ
ŲÚŠØąØ¯Û ŲØŗØĒ ÚŠŲ با **FastAPI** Ų
ÛâÚ¯ÛØąÛ.
+
+Ų ÚŲŲ Ų
ÛâØĒŲŲÛ ŲŲ
âØ˛Ų
اŲÛ Ų Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û ØąŲ ŲŲ
Ø˛Ų
اŲ داشØĒŲ باشÛØ ØšŲ
ŲÚŠØąØ¯ باŲاØĒØąÛ Ø§Ø˛ بÛØ´ØĒØą ŲØąÛŲ
âŲØąÚŠâŲØ§Û ØĒØŗØĒâشدŲ NodeJS Ų
ÛâÚ¯ÛØąÛ Ų ŲŲ
âØĒØąØ§Ø˛ با GoØ ÚŠŲ ÛŲ Ø˛Ø¨ŲŲ ڊاŲ
ŲžØ§ÛŲâشدŲ ŲØ˛Ø¯ÛÚŠ بŲ C ŲØŗØĒ (ŲŲ
Ų اÛŲا بŲ ŲØˇŲ Starlette) .
+
+### ØĸÛا ŲŲ
âØ˛Ų
اŲÛ Ø§Ø˛ Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û Ø¨ŲØĒØąŲØ
+
+ŲŲ! اÛŲ ŲØĒÛØŦŲ داØŗØĒاŲ ŲÛØŗØĒ.
+
+ŲŲ
âØ˛Ų
اŲÛ Ø¨Ø§ Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û ŲØąŲ Ø¯Ø§ØąŲ. Ų ØĒŲÛ **ØŗŲØ§ØąÛŲŲØ§Û ØŽØ§Øĩ** ÚŠŲ ÚŠŲÛ Ø§ŲØĒØ¸Ø§Øą Ø¯Ø§ØąŲ بŲØĒØąŲ. بŲ ŲŲ
ÛŲ ØŽØ§ØˇØąØ Ų
ØšŲ
ŲŲاŲ Ø¨ØąØ§Û ØĒŲØŗØšŲ Ø¨ØąŲاŲ
ŲâŲØ§Û Ųب ØŽÛŲÛ Ø§Ø˛ Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û Ø¨ŲØĒØąŲ. ŲŲÛ ŲŲ Ø¨ØąØ§Û ŲŲ
ŲâÚÛØ˛.
+
+Ø¨ØąØ§Û Ø§ÛŲÚŠŲ ÛŲ ØĒؚادŲ Ø¨Ø°Ø§ØąÛŲ
Ø Ø§ÛŲ داØŗØĒاŲ ÚŠŲØĒاŲ ØąŲ ØĒØĩŲØą ÚŠŲ:
+
+> باÛد ÛŲ ØŽŲŲŲ Ø¨Ø˛ØąÚ¯ Ų ÚŠØĢÛŲ ØąŲ ØĒŲ
ÛØ˛ ÚŠŲÛ.
+
+*ØĸØąŲØ ÚŠŲ داØŗØĒاŲ ŲŲ
ÛŲŲ*.
+
+---
+
+ŲÛÚ Ø§ŲØĒØ¸Ø§ØąÛ đ اŲŲØŦا ŲÛØŗØĒØ ŲŲØˇ ÚŠŲÛ ÚŠØ§Øą Ø¨ØąØ§Û Ø§ŲØŦاŲ
دادŲ ØĒŲÛ ØŦاŲØ§Û Ų
ØŽØĒŲŲ ØŽŲŲŲ.
+
+Ų
ÛâØĒŲŲÛ Ų
ØĢŲ Ų
ØĢاŲ Ø¨ØąÚ¯ØąŲا ŲŲبØĒ Ø¨Ø°Ø§ØąÛØ Ø§ŲŲ ŲžØ°ÛØąØ§ÛÛØ Ø¨ØšØ¯ ØĸØ´ŲžØ˛ØŽŲŲŲØ ŲŲÛ ÚŲŲ Ų
ŲØĒØ¸Øą ÚÛØ˛Û ŲÛØŗØĒÛ đØ ŲŲØˇ Ø¯Ø§ØąÛ ØĒŲ
ÛØ˛ Ų
ÛâÚŠŲÛ Ų ØĒŲ
ÛØ˛ Ų
ÛâÚŠŲÛØ ŲŲبØĒâŲا ŲÛÚ ØĒØŖØĢÛØąÛ ŲØ¯Ø§ØąŲ.
+
+با ŲŲبØĒ Ûا بدŲŲ ŲŲبØĒ (ŲŲ
âØ˛Ų
اŲÛ) ŲŲ
ŲŲ ŲØ¯Øą ØˇŲŲ Ų
ÛâÚŠØ´Ų ØĒا ØĒŲ
ŲŲ
Ø´ ÚŠŲÛ Ų ŲŲ
ŲŲ Ų
ŲØ¯Ø§Øą ÚŠØ§Øą ØąŲ ÚŠØąØ¯Û.
+
+ŲŲÛ ØĒŲÛ Ø§ÛŲ Ų
ŲŲØšÛØĒØ Ø§Ú¯Ų بØĒŲŲÛ Ø§ŲŲ 8 ØĒا ØĩŲدŲŲØ¯Ø§Øą/ØĸØ´ŲžØ˛/ØاŲا-ØĒŲ
ÛØ˛ÚŠØ§Øą ØąŲ بÛØ§ØąÛØ Ų ŲØą ڊدŲŲ
Ø´ŲŲ (بŲâØšŲاŲŲ ØŽŲدØĒ) ÛŲ ŲØŗŲ
ØĒ Ø§Ø˛ ØŽŲŲŲ ØąŲ ØĒŲ
ÛØ˛ ÚŠŲŲØ Ų
ÛâØĒŲŲÛ ŲŲ
Ų ÚŠØ§Øą ØąŲ **Ų
ŲØ§Ø˛Û** اŲØŦاŲ
بدÛØ Ø¨Ø§ ÚŠŲ
ÚŠ اØļاŲÛØ Ų ØŽÛŲÛ Ø˛ŲدØĒØą ØĒŲ
ŲŲ
Ø´ ÚŠŲÛ.
+
+ØĒŲÛ Ø§ÛŲ ØŗŲØ§ØąÛŲØ ŲØą ڊدŲŲ
Ø§Ø˛ ØĒŲ
ÛØ˛ÚŠØ§ØąŲا (Ø§Ø˛ ØŦŲ
ŲŲ ØŽŲدØĒ) ÛŲ ŲžØąØ¯Ø§Ø˛ŲدŲâØŗØĒ ÚŠŲ ÚŠØ§Øą ØŽŲدش ØąŲ Ų
ÛâÚŠŲŲ.
+
+Ų ÚŲŲ بÛØ´ØĒØą Ø˛Ų
اŲ اØŦØąØ§ ØĩØąŲ ÚŠØ§Øą ŲاŲØšÛ Ų
ÛâØ´Ų (بŲ ØŦØ§Û Ø§ŲØĒØ¸Ø§Øą)Ø Ų ÚŠØ§Øą ØĒŲÛ ÚŠØ§Ų
ŲžÛŲØĒØą با CPU اŲØŦاŲ
Ų
ÛâØ´ŲØ Ø¨Ų اÛŲ Ų
Ø´ÚŠŲاØĒ Ų
ÛâÚ¯Ų "CPU bound".
+
+---
+
+Ų
ØĢاŲâŲØ§Û ØąØ§ÛØŦ ØšŲ
ŲÛاØĒ CPU bound ÚÛØ˛Ø§ÛÛ ŲØŗØĒŲ ÚŠŲ ŲÛØ§Ø˛ بŲ ŲžØąØ¯Ø§Ø˛Ø´ ØąÛاØļÛ ŲžÛÚÛدŲ Ø¯Ø§ØąŲ.
+
+Ų
ØĢŲاŲ:
+
+* ŲžØąØ¯Ø§Ø˛Ø´ **Øĩدا** Ûا **ØĒØĩŲÛØą**.
+* **بÛŲاÛÛ ÚŠØ§Ų
ŲžÛŲØĒØąÛ**: ÛŲ ØĒØĩŲÛØą Ø§Ø˛ Ų
ÛŲÛŲŲâŲا ŲžÛÚŠØŗŲ ØĒØ´ÚŠÛŲ شدŲØ ŲØą ŲžÛÚŠØŗŲ 3 ØĒا Ų
ŲØ¯Ø§Øą / ØąŲÚ¯ Ø¯Ø§ØąŲØ ŲžØąØ¯Ø§Ø˛Ø´Ø´ Ų
ØšŲ
ŲŲاŲ ŲÛØ§Ø˛ Ø¯Ø§ØąŲ ÚÛØ˛Û ØąŲ ØąŲ اŲŲ ŲžÛÚŠØŗŲâŲا ŲŲ
Ø˛Ų
اŲ ØØŗاب ÚŠŲÛ.
+* **ÛادگÛØąÛ Ų
اشÛŲ**: Ų
ØšŲ
ŲŲاŲ ÚŠŲÛ ØļØąØ¨ "Ų
اØĒØąÛØŗ" Ų "Ø¨ØąØ¯Ø§Øą" ŲØ§Ø˛Ų
Ø¯Ø§ØąŲ. ÛŲ ØŦدŲŲ Ø¨Ø˛ØąÚ¯ ŲžØą Ø§Ø˛ ؚدد ØąŲ ØĒØĩŲØą ÚŠŲ ÚŠŲ ŲŲ
ŲâØ´ŲŲ ØąŲ ŲŲ
Ø˛Ų
اŲ ØļØąØ¨ Ų
ÛâÚŠŲÛ.
+* **ÛادگÛØąÛ ØšŲ
ÛŲ**: اÛŲ ÛŲ Ø˛ÛØąØ´Ø§ØŽŲ Ø§Ø˛ ÛادگÛØąÛ Ų
اشÛŲŲØ ŲžØŗ ŲŲ
ŲŲ ŲØļÛŲ ØĩدŲ Ų
ÛâÚŠŲŲ. ŲŲØˇ اÛŲ ÚŠŲ ÛŲ ØŦدŲŲ ؚدد Ø¨ØąØ§Û ØļØąØ¨ ÚŠØąØ¯Ų ŲÛØŗØĒØ Ø¨ŲÚŠŲ ÛŲ Ų
ØŦŲ
ŲØšŲ Ø¨Ø˛ØąÚ¯ Ø§Ø˛ اŲŲا ŲØŗØĒØ Ų ØĒŲÛ ØŽÛŲÛ Ų
ŲØ§ØąØ¯ Ø§Ø˛ ÛŲ ŲžØąØ¯Ø§Ø˛ŲدŲ ؎اØĩ Ø¨ØąØ§Û Øŗا؎ØĒ Ų / Ûا اØŗØĒŲادŲ Ø§Ø˛ اÛŲ Ų
دŲâŲا اØŗØĒŲادŲ Ų
ÛâÚŠŲÛ.
+
+### ŲŲ
âØ˛Ų
اŲÛ + Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û: Ųب + ÛادگÛØąÛ Ų
اشÛŲ
+
+با **FastAPI** Ų
ÛâØĒŲŲÛ Ø§Ø˛ ŲŲ
âØ˛Ų
اŲÛ ÚŠŲ Ø¨ØąØ§Û ØĒŲØŗØšŲ Ųب ØŽÛŲÛ ØąØ§ÛØŦŲ (ŲŲ
ŲŲ ØŦذابÛØĒ اØĩŲÛ NodeJS) اØŗØĒŲادŲ ÚŠŲÛ.
+
+ŲŲÛ Ų
ÛâØĒŲŲÛ Ø§Ø˛ ŲŲاÛد Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û Ų ÚŲدŲžØąØ¯Ø§Ø˛Ø´Û (اØŦØąØ§Û ÚŲد ŲžØąŲØŗŲ بŲâØĩŲØąØĒ Ų
ŲØ§Ø˛Û) Ø¨ØąØ§Û ÚŠØ§ØąØ§Û **CPU bound** Ų
ØĢŲ ØŗÛØŗØĒŲ
âŲØ§Û ÛادگÛØąÛ Ų
اشÛŲ ŲŲ
بŲØąŲ Ø¨Ø¨ØąÛ.
+
+اÛŲØ Ø¨ŲâØšŲاŲŲ اÛŲ ŲاŲØšÛØĒ ØŗادŲ ÚŠŲ ŲžØ§ÛØĒŲŲ Ø˛Ø¨ŲŲ اØĩŲÛ Ø¨ØąØ§Û **ØšŲŲ
دادŲ**Ø ÛادگÛØąÛ Ų
اشÛŲ Ų بŲâØŽØĩŲØĩ ÛادگÛØąÛ ØšŲ
ÛŲŲØ Ø¨Ø§ØšØĢ Ų
ÛâØ´Ų FastAPI ÛŲ اŲØĒ؎اب ØŽÛŲÛ ØŽŲب Ø¨ØąØ§Û APIŲا Ų Ø¨ØąŲاŲ
ŲâŲØ§Û Ųب ØšŲŲ
دادŲ / ÛادگÛØąÛ Ų
اشÛŲ باشŲ (بÛŲ ØŽÛŲÛ ÚÛØ˛Ø§Û Ø¯ÛÚ¯Ų).
+
+Ø¨ØąØ§Û Ø¯ÛدŲ اÛŲÚŠŲ ÚØˇŲØą ØĒŲÛ Ų
ØÛØˇ ŲاŲØšÛ Ø¨Ų اÛŲ Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û Ø¨ØąØŗÛØ Ø¨ØŽØ´ [اØŗØĒŲØąØ§Øą](deployment/index.md){.internal-link target=_blank} ØąŲ ببÛŲ.
+
+## `async` Ų `await`
+
+ŲØŗØŽŲâŲØ§Û Ų
Ø¯ØąŲ ŲžØ§ÛØĒŲŲ ÛŲ ØąØ§Ų ØŽÛŲÛ ØŗادŲ Ų ŲابŲâŲŲŲ
Ø¨ØąØ§Û ØĒØšØąÛŲ ڊد ŲاŲŲ
âØ˛Ų
اŲ Ø¯Ø§ØąŲ. اÛŲ باؚØĢ Ų
ÛâØ´Ų Ų
ØĢŲ ڊد "ØĒØąØĒÛبÛ" Ų
ØšŲ
ŲŲÛ Ø¨Ų ŲØ¸Øą بÛاد Ų ØĒŲÛ ŲØظŲâŲØ§Û Ø¯ØąØŗØĒ "اŲØĒØ¸Ø§Øą" ØąŲ Ø¨ØąØ§ØĒ اŲØŦاŲ
بدŲ.
+
+ŲŲØĒÛ ÛŲ ØšŲ
ŲÛاØĒÛ ŲØŗØĒ ÚŠŲ ŲبŲ Ø§Ø˛ دادŲ ŲØĒÛØŦŲâŲا ŲÛØ§Ø˛ بŲ اŲØĒØ¸Ø§Øą Ø¯Ø§ØąŲ Ų Ø§Ø˛ اÛŲ ŲابŲÛØĒâŲØ§Û ØŦدÛد ŲžØ§ÛØĒŲŲ ŲžØ´ØĒÛباŲÛ Ų
ÛâÚŠŲŲØ Ų
ÛâØĒŲŲÛ Ø§ÛŲØŦŲØąÛ ÚŠØ¯ŲŲÛØŗÛØ´ ÚŠŲÛ:
+
+```Python
+burgers = await get_burgers(2)
+```
+
+ŲÚŠØĒŲ ÚŠŲÛØ¯Û Ø§ÛŲØŦا `await` ŲØŗØĒ. بŲ ŲžØ§ÛØĒŲŲ Ų
ÛâÚ¯Ų ÚŠŲ باÛد ⸠Ų
ŲØĒØ¸Øą بŲ
ŲŲŲ ØĒا `get_burgers(2)` ÚŠØ§ØąØ´ đ ØĒŲ
ŲŲ
بشŲ ŲبŲ Ø§Ø˛ اÛŲÚŠŲ ŲØĒÛØŦŲâŲا ØąŲ ØĒŲÛ `burgers` Ø°ØŽÛØąŲ ÚŠŲŲ. با اÛŲØ ŲžØ§ÛØĒŲŲ Ų
ÛâدŲŲŲ ÚŠŲ Ų
ÛâØĒŲŲŲ Ø¨ØąŲ ÛŲ ÚŠØ§Øą دÛÚ¯Ų đ ⯠ØĒŲÛ Ø§ÛŲ Ų
دØĒ بڊŲŲ (Ų
ØĢŲ Ú¯ØąŲØĒŲ ÛŲ Ø¯ØąØŽŲاØŗØĒ دÛÚ¯Ų).
+
+Ø¨ØąØ§Û Ø§ÛŲÚŠŲ `await` ÚŠØ§Øą ÚŠŲŲØ Ø¨Ø§Ûد ØĒŲÛ ÛŲ ØĒابؚ باشŲ ÚŠŲ Ø§Ø˛ اÛŲ ŲاŲŲ
âØ˛Ų
اŲÛ ŲžØ´ØĒÛباŲÛ ÚŠŲŲ. Ø¨ØąØ§Û Ø§ÛŲ ÚŠØ§ØąØ ŲŲØˇ با `async def` ØĒØšØąÛŲØ´ Ų
ÛâÚŠŲÛ:
+
+```Python hl_lines="1"
+async def get_burgers(number: int):
+ # ÛŲ ØŗØąÛ ÚŠØ§Øą ŲاŲŲ
âØ˛Ų
اŲ Ø¨ØąØ§Û Øŗا؎ØĒŲ Ø¨ØąÚ¯ØąŲا اŲØŦاŲ
بدŲ
+ return burgers
+```
+
+...بŲ ØŦØ§Û `def`:
+
+```Python hl_lines="2"
+# اÛŲ ŲاŲŲ
âØ˛Ų
اŲ ŲÛØŗØĒ
+def get_sequential_burgers(number: int):
+ # ÛŲ ØŗØąÛ ÚŠØ§Øą ØĒØąØĒÛØ¨Û Ø¨ØąØ§Û Øŗا؎ØĒŲ Ø¨ØąÚ¯ØąŲا اŲØŦاŲ
بدŲ
+ return burgers
+```
+
+با `async def`Ø ŲžØ§ÛØĒŲŲ Ų
ÛâدŲŲŲ ÚŠŲ ØĒŲÛ Ø§ŲŲ ØĒابؚ باÛد ØŲاØŗØ´ بŲ ØšØ¨Ø§ØąØĒâŲØ§Û `await` باشŲØ Ų Ų
ÛâØĒŲŲŲ اØŦØąØ§Û Ø§ŲŲ ØĒابؚ ØąŲ "Ų
ŲŲØĒاŲ Ų
ØĒŲŲŲ" ⸠ڊŲŲ Ų Ø¨ØąŲ ÛŲ ÚŠØ§Øą دÛÚ¯Ų đ ŲبŲ Ø§Ø˛ Ø¨ØąÚ¯Ø´ØĒŲ بڊŲŲ.
+
+ŲŲØĒÛ Ų
ÛâØŽŲØ§Û ÛŲ ØĒابؚ `async def` ØąŲ Øĩدا ÚŠŲÛØ Ø¨Ø§Ûد "Ų
ŲØĒØ¸ØąØ´" بŲ
ŲŲÛ. ŲžØŗ اÛŲ ÚŠØ§Øą ŲŲ
ÛâÚŠŲŲ:
+
+```Python
+# اÛŲ ÚŠØ§Øą ŲŲ
ÛâÚŠŲŲØ ÚŲŲ get_burgers با async def ØĒØšØąÛŲ شدŲ
+burgers = get_burgers(2)
+```
+
+---
+
+ŲžØŗØ Ø§Ú¯Ų Ø§Ø˛ ÛŲ ÚŠØĒاب؎ŲŲŲ اØŗØĒŲادŲ Ų
ÛâÚŠŲÛ ÚŠŲ بŲØĒ Ų
ÛâÚ¯Ų Ų
ÛâØĒŲŲÛ Ø¨Ø§ `await` Øĩداش ÚŠŲÛØ Ø¨Ø§Ûد *ØĒŲابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØąØĒ* ÚŠŲ Ø§Ø˛Ø´ اØŗØĒŲادŲ Ų
ÛâÚŠŲŲ ØąŲ با `async def` بØŗØ§Ø˛ÛØ Ų
ØĢŲ:
+
+```Python hl_lines="2-3"
+@app.get('/burgers')
+async def read_burgers():
+ burgers = await get_burgers(2)
+ return burgers
+```
+
+### ØŦØ˛ØĻÛاØĒ ŲŲÛâØĒØą
+
+شاÛد Ų
ØĒŲØŦŲ شدŲ Ø¨Ø§Ø´Û ÚŠŲ `await` ŲŲØˇ ØĒŲÛ ØĒŲØ§Ø¨ØšÛ ÚŠŲ با `async def` ØĒØšØąÛŲ شدŲ Ų
ÛâØĒŲŲŲ اØŗØĒŲادŲ بشŲ.
+
+ŲŲÛ Ø¯Øą ØšÛŲ ØاŲØ ØĒŲØ§Ø¨ØšÛ ÚŠŲ با `async def` ØĒØšØąÛŲ شدŲ باÛد "Ų
ŲØĒØ¸Øą"Ø´ŲŲ بŲ
ŲŲÛ. ŲžØŗ ØĒŲابؚ با `async def` ŲŲØˇ ØĒŲÛ ØĒŲØ§Ø¨ØšÛ ÚŠŲ با `async def` ØĒØšØąÛŲ شدŲ Ų
ÛâØĒŲŲŲ Øĩدا Ø˛Ø¯Ų بشŲ.
+
+ØاŲØ§Ø ŲØļÛŲ Ų
ØąØē Ų ØĒØŽŲ
âŲ
ØąØē ÚÛŲØ ÚØˇŲØą اŲŲÛŲ ØĒابؚ `async` ØąŲ Øĩدا Ų
ÛâÚŠŲÛØ
+
+اگŲ با **FastAPI** ÚŠØ§Øą Ų
ÛâÚŠŲÛØ ŲØ§Ø˛Ų
ŲÛØŗØĒ ŲÚ¯ØąØ§Ų اÛŲ باشÛØ ÚŲŲ اŲŲ "اŲŲÛŲ" ØĒØ§Ø¨ØšØ *ØĒابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØąØĒ* ŲØŗØĒØ Ų FastAPI Ų
ÛâدŲŲŲ ÚØˇŲØą ÚŠØ§Øą Ø¯ØąØŗØĒ ØąŲ بڊŲŲ.
+
+ŲŲÛ Ø§Ú¯Ų ب؎ŲØ§Û Ø¨Ø¯ŲŲ FastAPI Ø§Ø˛ `async` / `await` اØŗØĒŲادŲ ÚŠŲÛØ Ø§ÛŲŲ
Ų
Ų
ÚŠŲŲ.
+
+### ڊد ŲاŲŲ
âØ˛Ų
اŲ ØŽŲدØĒ ØąŲ بŲŲÛØŗ
+
+Starlette (Ų **FastAPI**) Ø¨Øą ŲžØ§ÛŲ AnyIO ŲØŗØĒŲØ ÚŠŲ باؚØĢ Ų
ÛâØ´Ų با ÚŠØĒاب؎ŲŲŲ اØŗØĒاŲØ¯Ø§ØąØ¯ ŲžØ§ÛØĒŲŲ asyncio Ų Trio ØŗØ§Ø˛Ú¯Ø§Øą باشŲ.
+
+بŲâØŽØĩŲØĩØ Ų
ÛâØĒŲŲÛ Ų
ØŗØĒŲÛŲ
اŲ Ø§Ø˛ AnyIO Ø¨ØąØ§Û Ų
ŲØ§ØąØ¯ اØŗØĒŲادŲ ŲžÛØ´ØąŲØĒŲ ŲŲ
âØ˛Ų
اŲÛ ÚŠŲ ŲÛØ§Ø˛ بŲ اŲÚ¯ŲŲØ§Û ŲžÛÚÛدŲâØĒØą ØĒŲÛ ÚŠØ¯ ØŽŲدØĒ Ø¯Ø§ØąŲ اØŗØĒŲادŲ ÚŠŲÛ.
+
+Ų ØØĒÛ Ø§Ú¯Ų Ø§Ø˛ FastAPI اØŗØĒŲادŲ ŲÚŠŲÛØ Ų
ÛâØĒŲŲÛ Ø¨ØąŲاŲ
ŲâŲØ§Û ŲاŲŲ
âØ˛Ų
اŲ ØŽŲدØĒ ØąŲ با AnyIO بŲŲÛØŗÛ ØĒا ØŽÛŲÛ ØŗØ§Ø˛Ú¯Ø§Øą باشŲ Ų ŲŲاÛدش ØąŲ بگÛØąÛ (Ų
ØĢŲ *ŲŲ
âØ˛Ų
اŲÛ Øŗا؎ØĒØ§ØąÛاŲØĒŲ*).
+
+Ų
Ų ÛŲ ÚŠØĒاب؎ŲŲŲ دÛÚ¯Ų ØąŲÛ AnyIO Øŗا؎ØĒŲ
Ø ÛŲ ŲاÛŲ ŲØ§Ø˛ÚŠ ØąŲØ´Ø ØĒا ÛŲ ÚŠŲ
annotationŲØ§Û ŲŲØš ØąŲ بŲØĒØą ÚŠŲŲ
Ų **ØĒÚŠŲ
ÛŲ ØŽŲØ¯ÚŠØ§Øą** بŲØĒØąØ **ØŽØˇØ§ŲØ§Û Ø¯ØąŲŲâØŽØˇÛ** Ų ØēÛØąŲ بگÛØąŲ
. ÛŲ Ų
ŲدŲ
Ų Ų ØĸŲ
ŲØ˛Ø´ ØŗادŲ ŲŲ
Ø¯Ø§ØąŲ ÚŠŲ بŲØĒ ÚŠŲ
ÚŠ Ų
ÛâÚŠŲŲ **بŲŲŲ
Û** Ų **ڊد ŲاŲŲ
âØ˛Ų
اŲ ØŽŲدØĒ ØąŲ بŲŲÛØŗÛ**: Asyncer . اگŲ ب؎ŲØ§Û **ڊد ŲاŲŲ
âØ˛Ų
اŲ ØąŲ با ڊد Ų
ØšŲ
ŲŲÛ** (بŲاڊâÚŠŲŲدŲ/ŲŲ
âØ˛Ų
اŲ) ØĒØąÚŠÛب ÚŠŲÛ ØŽÛŲÛ Ø¨ŲâØ¯ØąØ¯ØĒ Ų
ÛâØŽŲØąŲ.
+
+### Ø´ÚŠŲâŲØ§Û Ø¯ÛÚ¯Ų ڊد ŲاŲŲ
âØ˛Ų
اŲ
+
+اÛŲ Øŗبڊ اØŗØĒŲادŲ Ø§Ø˛ `async` Ų `await` ØĒŲÛ Ø˛Ø¨ŲŲ ŲØŗبØĒاŲ ØŦدÛدŲ.
+
+ŲŲÛ ÚŠØ§Øą با ڊد ŲاŲŲ
âØ˛Ų
اŲ ØąŲ ØŽÛŲÛ ØŗادŲâØĒØą Ų
ÛâÚŠŲŲ.
+
+ŲŲ
ÛŲ ØŗÛŲØĒÚŠØŗ (Ûا ØĒŲØąÛباŲ ÛÚŠØŗاŲ) ا؎ÛØąØ§Ų ØĒŲÛ ŲØŗØŽŲâŲØ§Û Ų
Ø¯ØąŲ ØŦاŲااØŗÚŠØąÛŲžØĒ (ØĒŲÛ Ų
ØąŲØąÚ¯Øą Ų NodeJS) ŲŲ
اØļاŲŲ شدŲ.
+
+ŲŲÛ ŲبŲ Ø§Ø˛ اŲŲØ Ų
دÛØąÛØĒ ڊد ŲاŲŲ
âØ˛Ų
اŲ ØŽÛŲÛ ŲžÛÚÛدŲâØĒØą Ų ØŗØŽØĒâØĒØą بŲد.
+
+ØĒŲÛ ŲØŗØŽŲâŲØ§Û ŲبŲÛ ŲžØ§ÛØĒŲŲØ Ų
ÛâØĒŲŲØŗØĒÛ Ø§Ø˛ ŲØŽâŲا Ûا Gevent اØŗØĒŲادŲ ÚŠŲÛ. ŲŲÛ ÚŠØ¯ ØŽÛŲÛ ŲžÛÚÛدŲâØĒØą Ų
ÛâØ´Ų Ø¨ØąØ§Û ŲŲŲ
ÛدŲØ Ø¯Ûباگ ÚŠØąØ¯Ų Ų ŲÚŠØą ÚŠØąØ¯Ų بŲØ´.
+
+ØĒŲÛ ŲØŗØŽŲâŲØ§Û ŲبŲÛ NodeJS / ØŦاŲااØŗÚŠØąÛŲžØĒ Ų
ØąŲØąÚ¯ØąØ Ø§Ø˛ "ڊاŲâبڊâŲا" اØŗØĒŲادŲ Ų
ÛâÚŠØąØ¯Û. ÚŠŲ Ų
ÛâØąØŗÛد بŲ ØŦŲاŲ ڊاŲâبڊâŲا .
+
+## ÚŠØąŲØĒÛŲâŲا
+
+**ÚŠØąŲØĒÛŲ** ŲŲØˇ ÛŲ اØĩØˇŲØ§Ø ØŽÛŲÛ Ø´ÛÚŠ Ø¨ØąØ§Û ÚÛØ˛ÛŲ ÚŠŲ ÛŲ ØĒابؚ `async def` Ø¨ØąŲ
ÛâÚ¯ØąØ¯ŲŲŲ. ŲžØ§ÛØĒŲŲ Ų
ÛâدŲŲŲ ÚŠŲ اÛŲ ÛŲ ÚÛØ˛Û Ų
ØĢŲ ØĒابؚ ŲØŗØĒØ Ų
ÛâØĒŲŲŲ Ø´ØąŲØš بشŲ Ų ÛŲ ØŦاÛÛ ØĒŲ
ŲŲ
بشŲØ ŲŲÛ Ų
Ų
ÚŠŲŲ دا؎ŲØ´ ŲŲ
Ų
ŲŲŲ ⸠بشŲØ ŲØą ŲŲØĒ ÛŲ `await` ØĒŲØ´ باشŲ.
+
+ŲŲÛ ŲŲ
Ų اÛŲ ŲابŲÛØĒ اØŗØĒŲادŲ Ø§Ø˛ ڊد ŲاŲŲ
âØ˛Ų
اŲ با `async` Ų `await` ØŽÛŲÛ ŲŲØĒا ØŽŲاØĩŲ Ų
ÛâØ´Ų بŲ اØŗØĒŲادŲ Ø§Ø˛ "ÚŠØąŲØĒÛŲâŲا". اÛŲ ŲابŲ Ų
ŲاÛØŗŲ با ŲÛÚÚ¯Û Ø§ØĩŲÛ GoØ ÛØšŲÛ "GoroutineŲا" ŲØŗØĒ.
+
+## ŲØĒÛØŦŲâÚ¯ÛØąÛ
+
+بÛاÛد ŲŲ
ŲŲ ØŦŲ
ŲŲ Ø§Ø˛ باŲا ØąŲ ببÛŲÛŲ
:
+
+> ŲØŗØŽŲâŲØ§Û Ų
Ø¯ØąŲ ŲžØ§ÛØĒŲŲ Ø§Ø˛ **"ڊد ŲاŲŲ
âØ˛Ų
اŲ"** با ÚÛØ˛Û ÚŠŲ بŲØ´ **"ÚŠØąŲØĒÛŲ"** Ų
ÛâÚ¯Ų ŲžØ´ØĒÛباŲÛ Ų
ÛâÚŠŲŲØ Ø¨Ø§ ØŗÛŲØĒÚŠØŗ **`async` Ų `await`**.
+
+ØاŲا باÛد بÛØ´ØĒØą Ø¨ØąØ§ØĒ Ų
ØšŲÛ Ø¨Ø¯Ų. â¨
+
+ŲŲ
Ų اÛŲا ÚÛØ˛ÛŲ ÚŠŲ بŲ FastAPI (Ø§Ø˛ ØˇØąÛŲ Starlette) ŲØ¯ØąØĒ Ų
ÛâدŲ Ų باؚØĢ Ų
ÛâØ´Ų ØšŲ
ŲÚŠØąØ¯ ÚØ´Ų
Ú¯ÛØąÛ Ø¯Ø§Ø´ØĒŲ باشŲ.
+
+## ØŦØ˛ØĻÛاØĒ ØŽÛŲÛ ŲŲÛ
+
+/// warning
+
+اØØĒŲ
اŲاŲ Ų
ÛâØĒŲŲÛ Ø§ÛŲŲ ØąØ¯ ÚŠŲÛ.
+
+اÛŲا ØŦØ˛ØĻÛاØĒ ØŽÛŲÛ ŲŲÛ Ø§Ø˛ ŲØŲŲ ÚŠØ§Øą **FastAPI** Ø˛ÛØą ŲžŲØŗØĒŲâØŗØĒ.
+
+اگŲ ÛŲ ÚŠŲ
داŲØ´ ŲŲÛ (ÚŠØąŲØĒÛŲâŲØ§Ø ŲØŽâŲØ§Ø Ø¨Ųاڊ ÚŠØąØ¯Ų Ų ØēÛØąŲ) Ø¯Ø§ØąÛ Ų ÚŠŲØŦڊاŲÛ ÚŠŲ FastAPI ÚØˇŲØą `async def` ØąŲ Ø¯Øą Ų
ŲابŲ `def` Ų
ØšŲ
ŲŲÛ Ų
دÛØąÛØĒ Ų
ÛâÚŠŲŲØ Ø§Ø¯Ø§Ų
Ų بدŲ.
+
+///
+
+### ØĒŲابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØą
+
+ŲŲØĒÛ ÛŲ *ØĒابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØą* ØąŲ با `def` Ų
ØšŲ
ŲŲÛ Ø¨Ų ØŦØ§Û `async def` ØĒØšØąÛŲ Ų
ÛâÚŠŲÛØ ØĒŲÛ ÛŲ اØŗØĒØŽØą ŲØŽ ØŽØ§ØąØŦÛ Ø§ØŦØąØ§ Ų
ÛâØ´Ų ÚŠŲ بؚدش Ų
ŲØĒØ¸ØąØ´ Ų
ÛâŲ
ŲŲŲØ Ø¨Ų ØŦØ§Û Ø§ÛŲÚŠŲ Ų
ØŗØĒŲÛŲ
Øĩداش ÚŠŲŲ (ÚŲŲ ØŗØąŲØą ØąŲ بŲاڊ Ų
ÛâÚŠŲŲ).
+
+اگŲ Ø§Ø˛ ÛŲ ŲØąÛŲ
âŲØąÚŠ ŲاŲŲ
âØ˛Ų
اŲ دÛÚ¯Ų Ų
ÛØ§Û ÚŠŲ بŲ ØąŲØ´ باŲا ÚŠØ§Øą ŲŲ
ÛâÚŠŲŲ Ų ؚادØĒ Ø¯Ø§ØąÛ *ØĒŲابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØą* ØŗادŲ ŲŲØˇ Ų
ØاØŗباØĒÛ ØąŲ با `def` Ų
ØšŲ
ŲŲÛ Ø¨ØąØ§Û ÛŲ ØŗŲد ÚŠŲÚÛÚŠ ØšŲ
ŲÚŠØąØ¯ (ØدŲد 100 ŲاŲŲØĢاŲÛŲ) ØĒØšØąÛŲ ÚŠŲÛØ ØĒŲØŦŲ ÚŠŲ ÚŠŲ ØĒŲÛ **FastAPI** اØĢØąØ´ ڊاŲ
ŲاŲ Ø¨ØąØšÚŠØŗŲ. ØĒŲÛ Ø§ÛŲ Ų
ŲØ§ØąØ¯Ø Ø¨ŲØĒØąŲ Ø§Ø˛ `async def` اØŗØĒŲادŲ ÚŠŲÛ Ų
Ú¯Ų اÛŲÚŠŲ *ØĒŲابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØąØĒ* ÚŠØ¯Û Ø¯Ø§Ø´ØĒŲ باشŲ ÚŠŲ ØšŲ
ŲÛاØĒ I/O بŲاڊâÚŠŲŲدŲ اŲØŦاŲ
بدŲ.
+
+با اÛŲ ØاŲØ ØĒŲÛ ŲØą دŲ Ų
ŲŲØšÛØĒØ Ø§ØØĒŲ
اŲØ´ Ø˛ÛادŲ ÚŠŲ **FastAPI** ŲŲŲØ˛ [ØŗØąÛØšâØĒØą](index.md#performance){.internal-link target=_blank} Ø§Ø˛ ŲØąÛŲ
âŲØąÚŠ ŲبŲÛâاØĒ باشŲ (Ûا ØداŲŲ ŲابŲ Ų
ŲاÛØŗŲ باŲاش).
+
+### ŲابØŗØĒÚ¯ÛâŲا
+
+ŲŲ
ÛŲ Ø¨ØąØ§Û [ŲابØŗØĒÚ¯ÛâŲا](tutorial/dependencies/index.md){.internal-link target=_blank} ŲŲ
ØĩدŲ Ų
ÛâÚŠŲŲ. اگŲ ÛŲ ŲابØŗØĒÚ¯Û ÛŲ ØĒابؚ `def` Ų
ØšŲ
ŲŲÛ Ø¨Ų ØŦØ§Û `async def` باشŲØ ØĒŲÛ Ø§ØŗØĒØŽØą ŲØŽ ØŽØ§ØąØŦÛ Ø§ØŦØąØ§ Ų
ÛâØ´Ų.
+
+### Ø˛ÛØąŲابØŗØĒÚ¯ÛâŲا
+
+Ų
ÛâØĒŲŲÛ ÚŲد ØĒا ŲابØŗØĒÚ¯Û Ų [Ø˛ÛØąŲابØŗØĒÚ¯Û](tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} داشØĒŲ Ø¨Ø§Ø´Û ÚŠŲ ŲŲ
دÛÚ¯Ų ØąŲ ŲÛØ§Ø˛ Ø¯Ø§ØąŲ (بŲâØšŲŲاŲ ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û ØĒØšØąÛŲ ØĒابؚ)Ø Ø¨ØšØļÛâŲاشŲŲ Ų
Ų
ÚŠŲŲ با `async def` Øŗا؎ØĒŲ بشŲ Ų بؚØļÛâŲا با `def` Ų
ØšŲ
ŲŲÛ. Ø¨Ø§Ø˛Ų
ÚŠØ§Øą Ų
ÛâÚŠŲŲØ Ų اŲŲاÛÛ ÚŠŲ با `def` Ų
ØšŲ
ŲŲÛ Øŗا؎ØĒŲ شدŲ ØĒŲÛ ÛŲ ŲØŽ ØŽØ§ØąØŦÛ (Ø§Ø˛ اØŗØĒØŽØą ŲØŽ) Øĩدا Ø˛Ø¯Ų Ų
ÛâØ´Ų بŲ ØŦØ§Û Ø§ÛŲÚŠŲ "Ų
ŲØĒØ¸ØąØ´ŲŲ" بŲ
ŲŲŲ.
+
+### ØĒŲابؚ ÚŠØ§ØąØ¨ØąØ¯Û Ø¯ÛÚ¯Ų
+
+ŲØą ØĒابؚ ÚŠØ§ØąØ¨ØąØ¯Û Ø¯ÛÚ¯ŲâØ§Û ÚŠŲ Ų
ØŗØĒŲÛŲ
ØŽŲدØĒ Øĩداش Ų
ÛâÚŠŲÛ Ų
ÛâØĒŲŲŲ با `def` Ų
ØšŲ
ŲŲÛ Ûا `async def` Øŗا؎ØĒŲ بشŲ Ų FastAPI ØąŲ ŲØŲŲ ØĩØ¯Ø§Ø˛Ø¯ŲØ´ ØĒØŖØĢÛØą ŲŲ
ÛâØ°Ø§ØąŲ.
+
+اÛŲ Ø¨ØąØŽŲاŲ ØĒŲØ§Ø¨ØšÛ ŲØŗØĒ ÚŠŲ FastAPI Ø¨ØąØ§ØĒ ØĩداشŲŲ Ų
ÛâÚŠŲŲ: *ØĒŲابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØą* Ų ŲابØŗØĒÚ¯ÛâŲا.
+
+اگŲ ØĒابؚ ÚŠØ§ØąØ¨ØąØ¯ÛØĒ ÛŲ ØĒابؚ Ų
ØšŲ
ŲŲÛ Ø¨Ø§ `def` باشŲØ Ų
ØŗØĒŲÛŲ
Øĩداش Ų
ÛâÚŠŲŲ (ŲŲ
ŲŲâØˇŲØą ÚŠŲ ØĒŲÛ ÚŠØ¯ØĒ ŲŲØ´ØĒÛ)Ø ŲŲ ØĒŲÛ Ø§ØŗØĒØŽØą ŲØŽØ Ø§Ú¯Ų ØĒابؚ با `async def` Øŗا؎ØĒŲ شدŲ باشŲØ Ø¨Ø§Ûد ŲŲØĒÛ ØĒŲÛ ÚŠØ¯ØĒ Øĩداش Ų
ÛâÚŠŲÛ `await`Ø´ ÚŠŲÛ.
+
+---
+
+دŲØ¨Ø§ØąŲØ Ø§ÛŲا ØŦØ˛ØĻÛاØĒ ØŽÛŲÛ ŲŲÛ ŲØŗØĒŲ ÚŠŲ اØØĒŲ
اŲاŲ اگŲ دŲباŲØ´ŲŲ اŲŲ
دŲ Ø¨Ø§Ø´Û Ø¨ØąØ§ØĒ Ų
ŲÛد باشŲ.
+
+ŲÚ¯ØąŲŲØ Ø¨Ø§ ØąØ§ŲŲŲ
اÛÛâŲØ§Û Ø¨ØŽØ´ باŲا باÛد ØŽŲب باشÛ: ØšØŦŲŲ Ø¯Ø§ØąÛØ .
diff --git a/docs/fa/docs/environment-variables.md b/docs/fa/docs/environment-variables.md
new file mode 100644
index 000000000..75309ce1f
--- /dev/null
+++ b/docs/fa/docs/environment-variables.md
@@ -0,0 +1,298 @@
+# Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ
+
+/// tip
+
+اگŲ Ø§Ø˛ ŲبŲ Ų
ÛâدŲŲÛ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ ÚÛ ŲØŗØĒŲ Ų ÚØˇŲØą Ø§Ø˛Ø´ŲŲ اØŗØĒŲادŲ Ų
ÛâØ´ŲØ Ų
ÛâØĒŲŲÛ Ø§ÛŲ ب؎ش ØąŲ ØąØ¯ ÚŠŲÛ.
+
+///
+
+ÛŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ (ÚŠŲ بŲØ´ "**env var**" ŲŲ
Ų
ÛâÚ¯Ų) ÛŲ Ų
ØĒØēÛØąÛŲ ÚŠŲ **ØŽØ§ØąØŦ** Ø§Ø˛ ڊد ŲžØ§ÛØĒŲŲØ ØĒŲÛ **ØŗÛØŗØĒŲ
âؚاŲ
Ų** Ø˛ŲØ¯Ú¯Û Ų
ÛâÚŠŲŲ Ų Ų
ÛâØĒŲŲŲ ØĒŲØŗØˇ ڊد ŲžØ§ÛØĒŲŲØĒ (Ûا Ø¨ØąŲاŲ
ŲâŲØ§Û Ø¯ÛÚ¯Ų) ØŽŲŲدŲ بشŲ.
+
+Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ Ų
ÛâØĒŲŲŲ Ø¨ØąØ§Û Ų
دÛØąÛØĒ **ØĒŲظÛŲ
اØĒ** Ø¨ØąŲاŲ
ŲØ Ø¨ŲâØšŲŲاŲ Ø¨ØŽØ´Û Ø§Ø˛ **ŲØĩب** ŲžØ§ÛØĒŲŲ Ų ØēÛØąŲ Ų
ŲÛد باشŲ.
+
+## Øŗا؎ØĒ Ų اØŗØĒŲادŲ Ø§Ø˛ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ
+
+Ų
ÛâØĒŲŲÛ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ ØąŲ ØĒŲÛ **Ø´Ų (ØĒØąŲ
ÛŲاŲ)** **بØŗØ§Ø˛Û** Ų Ø§Ø˛Ø´ŲŲ اØŗØĒŲادŲ ÚŠŲÛØ Ø¨Ø¯ŲŲ اÛŲÚŠŲ بŲ ŲžØ§ÛØĒŲŲ ŲÛØ§Ø˛ داشØĒŲ باشÛ:
+
+//// tab | ŲÛŲŲÚŠØŗØ Ų
ÚŠâاŲاØŗØ ŲÛŲدŲØ˛ بش
+
+
+
+```console
+// Ų
ÛâØĒŲŲÛ ÛŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ Ø¨Ų اØŗŲ
MY_NAME بØŗØ§Ø˛Û Ø¨Ø§
+$ export MY_NAME="Wade Wilson"
+
+// بؚد Ų
ÛâØĒŲŲÛ Ø¨Ø§ Ø¨ØąŲاŲ
ŲâŲØ§Û Ø¯ÛÚ¯Ų Ø§Ø˛Ø´ اØŗØĒŲادŲ ÚŠŲÛØ Ų
ØĢŲ
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+
+
+////
+
+//// tab | ŲÛŲدŲØ˛ ŲžØ§ŲØąØ´Ų
+
+
+
+```console
+// ÛŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ Ø¨Ų اØŗŲ
MY_NAME بØŗØ§Ø˛
+$ $Env:MY_NAME = "Wade Wilson"
+
+// با Ø¨ØąŲاŲ
ŲâŲØ§Û Ø¯ÛÚ¯Ų Ø§Ø˛Ø´ اØŗØĒŲادŲ ÚŠŲØ Ų
ØĢŲ
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+
+
+////
+
+## ØŽŲŲدŲ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ ØĒŲÛ ŲžØ§ÛØĒŲŲ
+
+Ų
ÛâØĒŲŲÛ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ ØąŲ **ØŽØ§ØąØŦ** Ø§Ø˛ ŲžØ§ÛØĒŲŲØ ØĒŲÛ ØĒØąŲ
ÛŲاŲ (Ûا با ŲØą ØąŲØ´ دÛÚ¯Ų) بØŗØ§Ø˛ÛØ Ų بؚد ØĒŲÛ **ŲžØ§ÛØĒŲŲ** اŲŲا ØąŲ ب؎ŲŲÛ.
+
+Ų
ØĢŲاŲ Ų
ÛâØĒŲŲÛ ÛŲ ŲاÛŲ `main.py` داشØĒŲ Ø¨Ø§Ø´Û Ø¨Ø§:
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip
+
+ØĸØąÚ¯ŲŲ
اŲ دŲŲ
`os.getenv()` Ų
ŲØ¯Ø§Øą ŲžÛØ´âŲØąØļÛŲ ÚŠŲ Ø¨ØąŲ
ÛâÚ¯ØąØ¯ŲŲŲ.
+
+اگŲ ŲدÛØ Ø¨ŲâØĩŲØąØĒ ŲžÛØ´âŲØąØļ `None` ŲØŗØĒØ Ø§ÛŲØŦا Ų
ا `"World"` ØąŲ بŲâØšŲŲاŲ Ų
ŲØ¯Ø§Øą ŲžÛØ´âŲØąØļ گذاشØĒÛŲ
.
+
+///
+
+بؚد Ų
ÛâØĒŲŲÛ Ø§ŲŲ Ø¨ØąŲاŲ
Ų ŲžØ§ÛØĒŲŲ ØąŲ Øĩدا ÚŠŲÛ:
+
+//// tab | ŲÛŲŲÚŠØŗØ Ų
ÚŠâاŲاØŗØ ŲÛŲدŲØ˛ بش
+
+
+
+```console
+// اÛŲØŦا ŲŲŲØ˛ Ų
ØĒØēÛØą Ų
ØÛØˇÛ ØąŲ ØĒŲظÛŲ
ŲÚŠØąØ¯ÛŲ
+$ python main.py
+
+// ÚŲŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ ØąŲ ØĒŲظÛŲ
ŲÚŠØąØ¯ÛŲ
Ø Ų
ŲØ¯Ø§Øą ŲžÛØ´âŲØąØļ ØąŲ Ų
ÛâÚ¯ÛØąÛŲ
+
+Hello World from Python
+
+// ŲŲÛ Ø§Ú¯Ų اŲŲ ÛŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ Ø¨ØŗØ§Ø˛ÛŲ
+$ export MY_NAME="Wade Wilson"
+
+// Ų بؚد دŲØ¨Ø§ØąŲ Ø¨ØąŲاŲ
Ų ØąŲ Øĩدا ÚŠŲÛŲ
+$ python main.py
+
+// ØاŲا Ų
ÛâØĒŲŲŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ ØąŲ ب؎ŲŲŲ
+
+Hello Wade Wilson from Python
+```
+
+
+
+////
+
+//// tab | ŲÛŲدŲØ˛ ŲžØ§ŲØąØ´Ų
+
+
+
+```console
+// اÛŲØŦا ŲŲŲØ˛ Ų
ØĒØēÛØą Ų
ØÛØˇÛ ØąŲ ØĒŲظÛŲ
ŲÚŠØąØ¯ÛŲ
+$ python main.py
+
+// ÚŲŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ ØąŲ ØĒŲظÛŲ
ŲÚŠØąØ¯ÛŲ
Ø Ų
ŲØ¯Ø§Øą ŲžÛØ´âŲØąØļ ØąŲ Ų
ÛâÚ¯ÛØąÛŲ
+
+Hello World from Python
+
+// ŲŲÛ Ø§Ú¯Ų اŲŲ ÛŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ Ø¨ØŗØ§Ø˛ÛŲ
+$ $Env:MY_NAME = "Wade Wilson"
+
+// Ų بؚد دŲØ¨Ø§ØąŲ Ø¨ØąŲاŲ
Ų ØąŲ Øĩدا ÚŠŲÛŲ
+$ python main.py
+
+// ØاŲا Ų
ÛâØĒŲŲŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ ØąŲ ب؎ŲŲŲ
+
+Hello Wade Wilson from Python
+```
+
+
+
+////
+
+ÚŲŲ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ Ų
ÛâØĒŲŲŲ ØŽØ§ØąØŦ Ø§Ø˛ ڊد ØĒŲظÛŲ
بشŲØ ŲŲÛ ÚŠØ¯ Ų
ÛâØĒŲŲŲ اŲŲا ØąŲ ب؎ŲŲŲØ Ų ŲØ§Ø˛Ų
ŲÛØŗØĒ با بŲÛŲ ŲاÛŲâŲا Ø°ØŽÛØąŲ (ÚŠŲ
ÛØĒÛ Ø¨Ų `git`) بشŲØ Ų
ØšŲ
ŲŲاŲ Ø¨ØąØ§Û ŲžÛÚŠØąØ¨ŲØ¯Û Ûا **ØĒŲظÛŲ
اØĒ** اØŗØĒŲادŲ Ų
ÛâØ´Ų.
+
+ŲŲ
ÚŲÛŲ Ų
ÛâØĒŲŲÛ ÛŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ ØąŲ ŲŲØˇ Ø¨ØąØ§Û **ÛŲ اØŦØąØ§Û ØŽØ§Øĩ Ø¨ØąŲاŲ
Ų** بØŗØ§Ø˛ÛØ ÚŠŲ ŲŲØˇ Ø¨ØąØ§Û Ø§ŲŲ Ø¨ØąŲاŲ
Ų Ų ŲŲØˇ Ø¨ØąØ§Û Ų
دØĒ Ø˛Ų
اŲ اØŦØąØ§Ø´ Ø¯Øą دØŗØĒØąØŗŲ.
+
+Ø¨ØąØ§Û Ø§ÛŲ ÚŠØ§ØąØ Ø¯ØąØŗØĒ ŲبŲ Ø§Ø˛ ØŽŲد Ø¨ØąŲاŲ
ŲØ ØĒŲÛ ŲŲ
ŲŲ ØŽØˇ بØŗØ§Ø˛Ø´:
+
+
+
+```console
+// ÛŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ MY_NAME ØąŲ ØĒŲÛ ØŽØˇ Ø¨ØąØ§Û Ø§ÛŲ اØŦØąØ§Û Ø¨ØąŲاŲ
Ų بØŗØ§Ø˛
+$ MY_NAME="Wade Wilson" python main.py
+
+// ØاŲا Ų
ÛâØĒŲŲŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ ØąŲ ب؎ŲŲŲ
+
+Hello Wade Wilson from Python
+
+// Ų
ØĒØēÛØą Ų
ØÛØˇÛ Ø¨ØšØ¯Ø´ دÛÚ¯Ų ŲØŦŲد ŲØ¯Ø§ØąŲ
+$ python main.py
+
+Hello World from Python
+```
+
+
+
+/// tip
+
+Ų
ÛâØĒŲŲÛ Ø¨ÛØ´ØĒØą Ø¯Øą Ų
ŲØąØ¯Ø´ ØĒŲÛ Ø¨ØąŲاŲ
Ų دŲØ§Ø˛Ø¯ŲâŲاڊØĒŲØąÛ: ŲžÛÚŠØąØ¨ŲØ¯Û Ø¨ØŽŲŲÛ.
+
+///
+
+## ŲŲØšâŲا Ų اؚØĒØ¨Ø§ØąØŗŲØŦÛ
+
+اÛŲ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ ŲŲØˇ Ų
ÛâØĒŲŲŲ **ØąØ´ØĒŲâŲØ§Û Ų
ØĒŲÛ** ØąŲ ŲÚ¯Ų Ø¯Ø§ØąŲØ ÚŲŲ ØŽØ§ØąØŦ Ø§Ø˛ ŲžØ§ÛØĒŲŲ ŲØŗØĒŲ Ų باÛد با Ø¨ØąŲاŲ
ŲâŲØ§Û Ø¯ÛÚ¯Ų Ų بŲÛŲ ØŗÛØŗØĒŲ
(Ų ØØĒÛ ØŗÛØŗØĒŲ
âؚاŲ
ŲâŲØ§Û Ų
ØŽØĒŲŲ Ų
ØĢŲ ŲÛŲŲÚŠØŗØ ŲÛŲدŲØ˛Ø Ų
ÚŠâاŲاØŗ) ØŗØ§Ø˛Ú¯Ø§Øą باشŲ.
+
+ÛØšŲÛ **ŲØą Ų
ŲØ¯Ø§ØąÛ** ÚŠŲ ØĒŲÛ ŲžØ§ÛØĒŲŲ Ø§Ø˛ ÛŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ ØŽŲŲدŲ Ų
ÛâØ´Ų ÛŲ `str` ŲØŗØĒØ Ų ŲØą ØĒبدÛŲ بŲ ŲŲØš دÛÚ¯Ų Ûا ŲØą اؚØĒØ¨Ø§ØąØŗŲØŦÛ Ø¨Ø§Ûد ØĒŲÛ ÚŠØ¯ اŲØŦاŲ
بشŲ.
+
+ØĒŲÛ [ØąØ§ŲŲŲ
Ø§Û ÚŠØ§ØąØ¨Øą ŲžÛØ´ØąŲØĒŲ - ØĒŲظÛŲ
اØĒ Ų Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ](./advanced/settings.md){.internal-link target=_blank} بÛØ´ØĒØą Ø¯Øą Ų
ŲØąØ¯ اØŗØĒŲادŲ Ø§Ø˛ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ Ø¨ØąØ§Û Ų
دÛØąÛØĒ **ØĒŲظÛŲ
اØĒ Ø¨ØąŲاŲ
Ų** Ûاد Ų
ÛâÚ¯ÛØąÛ.
+
+## Ų
ØĒØēÛØą Ų
ØÛØˇÛ `PATH`
+
+ÛŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ **؎اØĩ** بŲ اØŗŲ
**`PATH`** ŲØŦŲد Ø¯Ø§ØąŲ ÚŠŲ ØŗÛØŗØĒŲ
âؚاŲ
ŲâŲا (ŲÛŲŲÚŠØŗØ Ų
ÚŠâاŲاØŗØ ŲÛŲدŲØ˛) Ø§Ø˛Ø´ Ø¨ØąØ§Û ŲžÛدا ÚŠØąØ¯Ų Ø¨ØąŲاŲ
ŲâŲاÛÛ ÚŠŲ ŲØąØ§ØąŲ اØŦØąØ§ بشŲ اØŗØĒŲادŲ Ų
ÛâÚŠŲŲ.
+
+Ų
ŲØ¯Ø§Øą Ų
ØĒØēÛØą `PATH` ÛŲ ØąØ´ØĒŲ ØˇŲŲاŲÛ Ø§Ø˛ ŲžŲØ´ŲâŲاØŗØĒ ÚŠŲ ØĒŲÛ ŲÛŲŲÚŠØŗ Ų Ų
ÚŠâاŲاØŗ با دŲŲŲØˇŲ `:` Ų ØĒŲÛ ŲÛŲدŲØ˛ با ŲŲØˇŲâŲÛØąÚ¯ŲŲ `;` Ø§Ø˛ ŲŲ
ØŦدا شدŲ.
+
+Ų
ØĢŲاŲØ Ų
ØĒØēÛØą Ų
ØÛØˇÛ `PATH` Ų
ÛâØĒŲŲŲ اÛŲØŦŲØąÛ Ø¨Ø§Ø´Ų:
+
+//// tab | ŲÛŲŲÚŠØŗØ Ų
ÚŠâاŲاØŗ
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+ÛØšŲÛ ØŗÛØŗØĒŲ
باÛد دŲباŲ Ø¨ØąŲاŲ
ŲâŲا ØĒŲÛ Ø§ÛŲ ŲžŲØ´ŲâŲا Ø¨Ú¯ØąØ¯Ų:
+
+* `/usr/local/bin`
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | ŲÛŲدŲØ˛
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+ÛØšŲÛ ØŗÛØŗØĒŲ
باÛد دŲباŲ Ø¨ØąŲاŲ
ŲâŲا ØĒŲÛ Ø§ÛŲ ŲžŲØ´ŲâŲا Ø¨Ú¯ØąØ¯Ų:
+
+* `C:\Program Files\Python312\Scripts`
+* `C:\Program Files\Python312`
+* `C:\Windows\System32`
+
+////
+
+ŲŲØĒÛ ÛŲ **دØŗØĒŲØą** ØĒŲÛ ØĒØąŲ
ÛŲاŲ ØĒاÛŲž Ų
ÛâÚŠŲÛØ ØŗÛØŗØĒŲ
âؚاŲ
Ų **دŲباŲ** Ø¨ØąŲاŲ
Ų ØĒŲÛ **ŲØą ڊدŲŲ
Ø§Ø˛ اÛŲ ŲžŲØ´ŲâŲا** ÚŠŲ ØĒŲÛ Ų
ØĒØēÛØą Ų
ØÛØˇÛ `PATH` ŲÛØŗØĒ شدŲ Ų
ÛâÚ¯ØąØ¯Ų.
+
+Ų
ØĢŲاŲØ ŲŲØĒÛ ØĒŲÛ ØĒØąŲ
ÛŲاŲ `python` ØĒاÛŲž Ų
ÛâÚŠŲÛØ ØŗÛØŗØĒŲ
âؚاŲ
Ų دŲباŲ ÛŲ Ø¨ØąŲاŲ
Ų بŲ اØŗŲ
`python` ØĒŲÛ **اŲŲÛŲ ŲžŲØ´Ų** ØĒŲÛ Ø§ŲŲ ŲÛØŗØĒ Ų
ÛâÚ¯ØąØ¯Ų.
+
+اگŲ ŲžÛداش ÚŠŲŲØ **اØŗØĒŲادŲâØ´ Ų
ÛâÚŠŲŲ**. ŲÚ¯ØąŲŲ ØĒŲÛ **ŲžŲØ´ŲâŲØ§Û Ø¨ØšØ¯Û** دŲباŲØ´ Ų
ÛâÚ¯ØąØ¯Ų.
+
+### ŲØĩب ŲžØ§ÛØĒŲŲ Ų بŲâØąŲØ˛ØąØŗاŲÛ `PATH`
+
+ŲŲØĒÛ ŲžØ§ÛØĒŲŲ ØąŲ ŲØĩب Ų
ÛâÚŠŲÛØ Ų
Ų
ÚŠŲŲ Ø§Ø˛ØĒ بŲžØąØŗŲ ØĸÛا Ų
ÛâØŽŲØ§Û Ų
ØĒØēÛØą Ų
ØÛØˇÛ `PATH` ØąŲ بŲâØąŲØ˛ØąØŗاŲÛ ÚŠŲÛ.
+
+//// tab | ŲÛŲŲÚŠØŗØ Ų
ÚŠâاŲاØŗ
+
+ŲØąØļ ÚŠŲ ŲžØ§ÛØĒŲŲ ØąŲ ŲØĩب ÚŠØąØ¯Û Ų ØĒŲÛ ÛŲ ŲžŲØ´Ų `/opt/custompython/bin` ŲØąØ§Øą Ú¯ØąŲØĒŲ.
+
+اگŲ Ø¨Ú¯Û Ø¨ŲŲ Ø¨ØąØ§Û Ø¨ŲâØąŲØ˛ØąØŗاŲÛ Ų
ØĒØēÛØą Ų
ØÛØˇÛ `PATH`Ø ŲØĩاب `/opt/custompython/bin` ØąŲ بŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ `PATH` اØļاŲŲ Ų
ÛâÚŠŲŲ.
+
+Ų
Ų
ÚŠŲŲ اÛŲØŦŲØąÛ Ø¨Ø´Ų:
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+اÛŲâØŦŲØąÛØ ŲŲØĒÛ ØĒŲÛ ØĒØąŲ
ÛŲاŲ `python` ØĒاÛŲž Ų
ÛâÚŠŲÛØ ØŗÛØŗØĒŲ
Ø¨ØąŲاŲ
Ų ŲžØ§ÛØĒŲŲ ØąŲ ØĒŲÛ `/opt/custompython/bin` (ØĸØŽØąÛŲ ŲžŲØ´Ų) ŲžÛدا Ų
ÛâÚŠŲŲ Ų Ø§Ø˛ اŲŲ اØŗØĒŲادŲ Ų
ÛâÚŠŲŲ.
+
+////
+
+//// tab | ŲÛŲدŲØ˛
+
+ŲØąØļ ÚŠŲ ŲžØ§ÛØĒŲŲ ØąŲ ŲØĩب ÚŠØąØ¯Û Ų ØĒŲÛ ÛŲ ŲžŲØ´Ų `C:\opt\custompython\bin` ŲØąØ§Øą Ú¯ØąŲØĒŲ.
+
+اگŲ Ø¨Ú¯Û Ø¨ŲŲ Ø¨ØąØ§Û Ø¨ŲâØąŲØ˛ØąØŗاŲÛ Ų
ØĒØēÛØą Ų
ØÛØˇÛ `PATH`Ø ŲØĩاب `C:\opt\custompython\bin` ØąŲ بŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ `PATH` اØļاŲŲ Ų
ÛâÚŠŲŲ.
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+اÛŲâØŦŲØąÛØ ŲŲØĒÛ ØĒŲÛ ØĒØąŲ
ÛŲاŲ `python` ØĒاÛŲž Ų
ÛâÚŠŲÛØ ØŗÛØŗØĒŲ
Ø¨ØąŲاŲ
Ų ŲžØ§ÛØĒŲŲ ØąŲ ØĒŲÛ `C:\opt\custompython\bin` (ØĸØŽØąÛŲ ŲžŲØ´Ų) ŲžÛدا Ų
ÛâÚŠŲŲ Ų Ø§Ø˛ اŲŲ اØŗØĒŲادŲ Ų
ÛâÚŠŲŲ.
+
+////
+
+ŲžØŗØ Ø§Ú¯Ų ØĒاÛŲž ÚŠŲÛ:
+
+
+
+```console
+$ python
+```
+
+
+
+//// tab | ŲÛŲŲÚŠØŗØ Ų
ÚŠâاŲاØŗ
+
+ØŗÛØŗØĒŲ
Ø¨ØąŲاŲ
Ų `python` ØąŲ ØĒŲÛ `/opt/custompython/bin` **ŲžÛدا** Ų
ÛâÚŠŲŲ Ų اØŦØąØ§Ø´ Ų
ÛâÚŠŲŲ.
+
+ØĒŲØąÛباŲ Ų
ؚادŲ اÛŲŲ ÚŠŲ ØĒاÛŲž ÚŠŲÛ:
+
+
+
+```console
+$ /opt/custompython/bin/python
+```
+
+
+
+////
+
+//// tab | ŲÛŲدŲØ˛
+
+ØŗÛØŗØĒŲ
Ø¨ØąŲاŲ
Ų `python` ØąŲ ØĒŲÛ `C:\opt\custompython\bin\python` **ŲžÛدا** Ų
ÛâÚŠŲŲ Ų اØŦØąØ§Ø´ Ų
ÛâÚŠŲŲ.
+
+ØĒŲØąÛباŲ Ų
ؚادŲ اÛŲŲ ÚŠŲ ØĒاÛŲž ÚŠŲÛ:
+
+
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+
+
+////
+
+اÛŲ Ø§ØˇŲاؚاØĒ ŲŲØĒÛ Ø¯Øą Ų
ŲØąØ¯ [Ų
ØÛØˇâŲØ§Û Ų
ØŦØ§Ø˛Û](virtual-environments.md){.internal-link target=_blank} Ûاد Ų
ÛâÚ¯ÛØąÛ Ø¨ŲâØ¯ØąØ¯ØĒ Ų
ÛâØŽŲØąŲ.
+
+## ŲØĒÛØŦŲâÚ¯ÛØąÛ
+
+با اÛŲ باÛد ÛŲ Ø¯ØąÚŠ ŲžØ§ÛŲâØ§Û Ø§Ø˛ **Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ** Ų ŲØŲŲ اØŗØĒŲادŲâØ´ŲŲ ØĒŲÛ ŲžØ§ÛØĒŲŲ داشØĒŲ باشÛ.
+
+Ų
ÛâØĒŲŲÛ Ø¨ÛØ´ØĒØą Ø¯Øą Ų
ŲØąØ¯Ø´ŲŲ ØĒŲÛ ŲÛÚŠÛâŲžØ¯Ûا Ø¨ØąØ§Û Ų
ØĒØēÛØą Ų
ØÛØˇÛ Ø¨ØŽŲŲÛ.
+
+ØĒŲÛ ØŽÛŲÛ Ų
ŲØ§ØąØ¯ Ų
Ø´ØŽØĩ ŲÛØŗØĒ ÚŠŲ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ ÚØˇŲØą Ų
ÛâØĒŲŲŲ ŲŲØąÛ Ų
ŲÛد Ų ÚŠØ§ØąØ¨ØąØ¯Û Ø¨Ø§Ø´Ų. ŲŲÛ ØĒŲÛ Ų
ŲŲØšÛØĒâŲØ§Û Ų
ØŽØĒŲŲ ØĒŲØŗØšŲ Ų
داŲ
ŲžÛداشŲŲ Ų
ÛâØ´ŲØ ŲžØŗ ØŽŲبŲ ÚŠŲ Ø¯Øą Ų
ŲØąØ¯Ø´ŲŲ بدŲŲÛ.
+
+Ų
ØĢŲاŲØ ØĒŲÛ Ø¨ØŽØ´ Ø¨ØšØ¯Û Ø¯Øą Ų
ŲØąØ¯ [Ų
ØÛØˇâŲØ§Û Ų
ØŦØ§Ø˛Û](virtual-environments.md) بŲ اÛŲ Ø§ØˇŲاؚاØĒ ŲÛØ§Ø˛ Ø¯Ø§ØąÛ.
diff --git a/docs/fa/docs/learn/index.md b/docs/fa/docs/learn/index.md
new file mode 100644
index 000000000..06aa7f00e
--- /dev/null
+++ b/docs/fa/docs/learn/index.md
@@ -0,0 +1,5 @@
+# ÛادگÛØąÛ
+
+اÛŲØŦا ب؎شâŲØ§Û Ų
ŲدŲ
اØĒÛ Ų ØĸŲ
ŲØ˛Ø´âŲاÛÛ ŲØŗØĒŲ ÚŠŲ Ø¨ØąØ§Û ÛادگÛØąÛ **FastAPI** بŲØĒ ÚŠŲ
ÚŠ Ų
ÛâÚŠŲŲ.
+
+Ų
ÛâØĒŲŲÛ Ø§ÛŲŲ ÛŲ **ÚŠØĒاب**Ø ÛŲ **دŲØąŲ ØĸŲ
ŲØ˛Ø´Û**Ø Ûا ØąØ§Ų **ØąØŗŲ
Û** Ų ŲžÛØ´ŲŲØ§Ø¯Û Ø¨ØąØ§Û ÛادگÛØąÛ FastAPI Ø¯Øą ŲØ¸Øą بگÛØąÛ. đ
diff --git a/docs/fa/docs/python-types.md b/docs/fa/docs/python-types.md
new file mode 100644
index 000000000..c428acbf7
--- /dev/null
+++ b/docs/fa/docs/python-types.md
@@ -0,0 +1,578 @@
+# Ų
ŲدŲ
ŲâØ§Û Ø¨Øą اŲŲاؚ ŲŲØš Ø¯Øą ŲžØ§ÛØĒŲŲ
+
+ŲžØ§ÛØĒŲŲ Ø§Ø˛ "ŲŲØšâŲŲ
ا"ŲØ§Û Ø§ØŽØĒÛØ§ØąÛ (ÚŠŲ بŲØ´ŲŲ "type hints" Ûا "type annotations" ŲŲ
Ų
ÛâÚ¯Ų) ŲžØ´ØĒÛباŲÛ Ų
ÛâÚŠŲŲ.
+
+اÛŲ **"ŲŲØšâŲŲ
اŲا"** Ûا annotationŲا ÛŲ ØŗÛŲØĒÚŠØŗ ؎اØĩ ŲØŗØĒŲ ÚŠŲ بŲØĒ اØŦØ§Ø˛Ų Ų
ÛâدŲ ŲŲØš ÛŲ Ų
ØĒØēÛØą ØąŲ Ų
Ø´ØŽØĩ ÚŠŲÛ.
+
+با Ų
Ø´ØŽØĩ ÚŠØąØ¯Ų ŲŲØš Ų
ØĒØēÛØąŲØ§Ø ŲÛØąØ§ÛØ´Ú¯ØąŲا Ų Ø§Ø¨Ø˛Ø§ØąŲا Ų
ÛâØĒŲŲŲ ŲžØ´ØĒÛباŲÛ Ø¨ŲØĒØąÛ Ø¨ŲØĒ بدŲ.
+
+اÛŲ ŲŲØˇ ÛŲ **ØĸŲ
ŲØ˛Ø´ ØŗØąÛØš / ÛادØĸŲØąÛ** Ø¯Øą Ų
ŲØąØ¯ ŲŲØšâŲŲ
اŲØ§Û ŲžØ§ÛØĒŲŲŲ. ŲŲØˇ ØداŲŲ ÚÛØ˛Ø§ÛÛ ÚŠŲ Ø¨ØąØ§Û Ø§ØŗØĒŲادŲ Ø§Ø˛Ø´ŲŲ با **FastAPI** ŲØ§Ø˛Ų
Ų ØąŲ ŲžŲشش Ų
ÛâدŲ... ÚŠŲ Ø¯Øą ŲاŲØš ØŽÛŲÛ ÚŠŲ
Ų.
+
+**FastAPI** ڊاŲ
ŲاŲ Ø¨Øą ŲžØ§ÛŲ اÛŲ ŲŲØšâŲŲ
اŲاØŗØĒ Ų اÛŲ بŲØ´ ÚŠŲÛ Ų
Ø˛ÛØĒ Ų ŲاÛدŲ Ų
ÛâدŲ.
+
+ŲŲÛ ØØĒÛ Ø§Ú¯Ų ŲÛÚâŲŲØĒ Ø§Ø˛ **FastAPI** اØŗØĒŲادŲ ŲÚŠŲÛØ Ø¨Ø§Ø˛Ų
ÛادگÛØąÛ ÛŲ ÚŠŲ
Ø¯Øą Ų
ŲØąØ¯Ø´ŲŲ بŲ ŲŲØšØĒŲ.
+
+/// note
+
+اگŲ ØØąŲŲâØ§Û ŲžØ§ÛØĒŲŲÛ Ų ŲŲ
ŲâÚÛØ˛ ØąŲ Ø¯Øą Ų
ŲØąØ¯ ŲŲØšâŲŲ
اŲا Ų
ÛâدŲŲÛØ Ø¨ØąŲ ØŗØąØ§Øē ŲØĩŲ بؚدÛ.
+
+///
+
+## اŲÚ¯ÛØ˛Ų
+
+بÛاÛد با ÛŲ Ų
ØĢاŲ ØŗادŲ Ø´ØąŲØš ÚŠŲÛŲ
:
+
+{* ../../docs_src/python_types/tutorial001.py *}
+
+ŲŲØĒÛ Ø§ÛŲ Ø¨ØąŲاŲ
Ų ØąŲ اØŦØąØ§ ÚŠŲÛØ ØŽØąŲØŦÛ Ø§ÛŲŲ:
+
+```
+John Doe
+```
+
+اÛŲ ØĒابؚ اÛŲ ÚŠØ§ØąØ§ ØąŲ Ų
ÛâÚŠŲŲ:
+
+* ÛŲ `first_name` Ų `last_name` Ų
ÛâÚ¯ÛØąŲ.
+* ØØąŲ اŲŲ ŲØą ڊدŲŲ
ØąŲ با `title()` Ø¨Ø˛ØąÚ¯ Ų
ÛâÚŠŲŲ.
+* ØĒØąÚŠÛبشŲŲ Ų
ÛâÚŠŲŲ با ÛŲ ŲاØĩŲŲ ŲØŗØˇØ´ŲŲ.
+
+{* ../../docs_src/python_types/tutorial001.py hl[2] *}
+
+### ŲÛØąØ§Ûشش ÚŠŲ
+
+اÛŲ ÛŲ Ø¨ØąŲاŲ
Ų ØŽÛŲÛ ØŗادŲâØŗØĒ.
+
+ŲŲÛ ØاŲا ØĒØĩŲØą ÚŠŲ Ø¯Ø§ØąÛ Ø§Ø˛ ØĩŲØą Ų
ÛâŲŲÛØŗÛØ´.
+
+ÛŲ ØŦاÛÛ Ø´ØąŲØš ÚŠØąØ¯Û Ø¨Ų ØĒØšØąÛŲ ØĒØ§Ø¨ØšØ ŲžØ§ØąØ§Ų
ØĒØąŲاØĒ ØĸŲ
ادŲâØŗØĒ...
+
+ŲŲÛ Ø¨ØšØ¯ باÛد "اŲŲ Ų
ØĒØ¯Û ÚŠŲ ØØąŲ اŲŲ ØąŲ Ø¨Ø˛ØąÚ¯ Ų
ÛâÚŠŲŲ" ØąŲ Øĩدا ÚŠŲÛ.
+
+ØĸÛا اØŗŲ
Ø´ `upper` بŲØ¯Ø Ûا `uppercase`Ø Ø´Ø§Ûد `first_uppercase`Ø Ûا `capitalize`Ø
+
+Ø¨ØšØ¯Ø Ø¨Ø§ دŲØŗØĒ ŲدÛŲ
Û Ø¨ØąŲاŲ
ŲâŲŲÛØŗØ§Ø ØĒÚŠŲ
ÛŲ ØŽŲØ¯ÚŠØ§Øą ŲÛØąØ§ÛØ´Ú¯ØąØ Ø§Ų
ØĒØاŲ Ų
ÛâÚŠŲÛ.
+
+ŲžØ§ØąØ§Ų
ØĒØą اŲŲ ØĒØ§Ø¨ØšØ `first_name` ØąŲ ØĒاÛŲž Ų
ÛâÚŠŲÛØ Ø¨ØšØ¯ ÛŲ ŲŲØˇŲ (`.`) Ų
ÛâØ°Ø§ØąÛ Ų `Ctrl+Space` ØąŲ Ų
ÛâØ˛ŲÛ ØĒا ØĒÚŠŲ
ÛŲ ØŽŲØ¯ÚŠØ§Øą بÛاد.
+
+ŲŲÛ Ų
ØĒØŖØŗŲاŲŲØ ÚÛØ˛ Ų
ŲÛØ¯Û ŲŲ
ÛâÚ¯ÛØąÛ:
+
+ØŽØˇ ØšŲ
ŲØ¯Û (`|`) ØŦدا ÚŠŲÛ.
+
+//// 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!}
+```
+
+////
+
+ØĒŲÛ ŲØą دŲ ØاŲØĒ ÛØšŲÛ `item` Ų
ÛâØĒŲŲŲ ÛŲ `int` Ûا ÛŲ `str` باشŲ.
+
+#### شاÛد `None`
+
+Ų
ÛâØĒŲŲÛ ØĒØšØąÛŲ ÚŠŲÛ ÚŠŲ ÛŲ Ų
ŲØ¯Ø§Øą Ų
ÛâØĒŲŲŲ ÛŲ ŲŲØš باشŲØ Ų
ØĢŲاŲ `str`Ø ŲŲÛ Ų
ÛâØĒŲŲŲ `None` ŲŲ
باشŲ.
+
+ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.6 Ų باŲاØĒØą (Ø§Ø˛ ØŦŲ
ŲŲ ŲžØ§ÛØĒŲŲ 3.10) Ų
ÛâØĒŲŲÛ Ø¨Ø§ ŲØ§ØąØ¯ ÚŠØąØ¯Ų Ų اØŗØĒŲادŲ Ø§Ø˛ `Optional` Ø§Ø˛ Ų
اÚŲŲ `typing` اÛŲŲ ØĒØšØąÛŲ ÚŠŲÛ.
+
+```Python hl_lines="1 4"
+{!../../docs_src/python_types/tutorial009.py!}
+```
+
+اØŗØĒŲادŲ Ø§Ø˛ `Optional[str]` بŲ ØŦØ§Û ŲŲØˇ `str` بŲ ŲÛØąØ§ÛØ´Ú¯Øą ÚŠŲ
ÚŠ Ų
ÛâÚŠŲŲ ØŽØˇØ§ŲاÛÛ ÚŠŲ Ų
Ų
ÚŠŲŲ ŲÚŠØą ÚŠŲÛ ÛŲ Ų
ŲØ¯Ø§Øą ŲŲ
ÛØ´Ų `str` ŲØŗØĒ ØąŲ ŲžÛدا ÚŠŲŲØ Ø¯Øą ØاŲÛ ÚŠŲ Ų
ÛâØĒŲŲŲ `None` ŲŲ
باشŲ.
+
+`Optional[Something]` Ø¯Øą ŲاŲØš Ų
ÛاŲâØ¨Øą Ø¨ØąØ§Û `Union[Something, None]` ŲØŗØĒØ Ø§ÛŲ دŲ ØĒا Ų
ؚادŲŲ.
+
+ÛØšŲÛ ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.10Ø Ų
ÛâØĒŲŲÛ Ø§Ø˛ `Something | None` اØŗØĒŲادŲ ÚŠŲÛ:
+
+//// 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+ ØŦاÛÚ¯Ø˛ÛŲ
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial009b.py!}
+```
+
+////
+
+#### اØŗØĒŲادŲ Ø§Ø˛ `Union` Ûا `Optional`
+
+اگŲ Ø§Ø˛ ŲØŗØŽŲ ŲžØ§ÛØĒŲŲ Ø˛ÛØą 3.10 اØŗØĒŲادŲ Ų
ÛâÚŠŲÛØ ÛŲ ŲÚŠØĒŲ Ø§Ø˛ دÛد ØŽÛŲÛ **Ø´ØŽØĩÛ** ØŽŲدŲ
:
+
+* đ¨ Ø§Ø˛ `Optional[SomeType]` اØŗØĒŲادŲ ŲÚŠŲ
+* بŲ ØŦاش ⨠**Ø§Ø˛ `Union[SomeType, None]` اØŗØĒŲادŲ ÚŠŲ** â¨.
+
+ŲØą دŲ Ų
ؚادŲŲ Ų Ø˛ÛØą ŲžŲØŗØĒŲ ÛÚŠÛâاŲØ ŲŲÛ Ų
Ų `Union` ØąŲ بŲ `Optional` ØĒØąØŦÛØ Ų
ÛâدŲ
ÚŲŲ ÚŠŲŲ
Ų "**ا؎ØĒÛØ§ØąÛ**" اŲÚ¯Ø§Øąæį¤ē Ų
ÛâÚŠŲŲ ÚŠŲ Ų
ŲØ¯Ø§Øą ا؎ØĒÛØ§ØąÛŲØ Ø¯Øą ØاŲÛ ÚŠŲ Ø¯Øą ŲاŲØš ÛØšŲÛ "Ų
ÛâØĒŲŲŲ `None` باشŲ"Ø ØØĒÛ Ø§Ú¯Ų ا؎ØĒÛØ§ØąÛ ŲباشŲ Ų ŲŲŲØ˛ ŲØ§Ø˛Ų
باشŲ.
+
+ŲÚŠØą Ų
ÛâÚŠŲŲ
`Union[SomeType, None]` ŲاØļØâØĒØą ŲØ´ŲŲ Ų
ÛâدŲ ÚÛ Ų
ØšŲÛ Ų
ÛâدŲ.
+
+ŲŲØˇ بØØĢ ÚŠŲŲ
اØĒ Ų اØŗŲ
âŲاØŗØĒ. ŲŲÛ Ø§ÛŲ ÚŠŲŲ
اØĒ Ų
ÛâØĒŲŲŲ ØąŲ ØˇØąØ˛ ŲÚŠØą ØĒŲ Ų ØĒÛŲ
ØĒ ŲØŗبØĒ بŲ ڊد ØĒØŖØĢÛØą Ø¨Ø°Ø§ØąŲ.
+
+بŲâØšŲŲاŲ Ų
ØĢاŲØ Ø§ÛŲ ØĒابؚ ØąŲ ببÛŲ:
+
+{* ../../docs_src/python_types/tutorial009c.py hl[1,4] *}
+
+ŲžØ§ØąØ§Ų
ØĒØą `name` بŲâØšŲŲاŲ `Optional[str]` ØĒØšØąÛŲ شدŲØ ŲŲÛ **ا؎ØĒÛØ§ØąÛ ŲÛØŗØĒ**Ø ŲŲ
ÛâØĒŲŲÛ ØĒابؚ ØąŲ بدŲŲ ŲžØ§ØąØ§Ų
ØĒØą Øĩدا ÚŠŲÛ:
+
+```Python
+say_hi() # اŲŲ ŲŲØ Ø§ÛŲ ØŽØˇØ§ Ų
ÛâدŲ! đą
+```
+
+ŲžØ§ØąØ§Ų
ØĒØą `name` **ŲŲŲØ˛ ŲØ§Ø˛Ų
Ų** (ŲŲ *ا؎ØĒÛØ§ØąÛ*) ÚŲŲ Ų
ŲØ¯Ø§Øą ŲžÛØ´âŲØąØļ ŲØ¯Ø§ØąŲ. با اÛŲ ØاŲØ `name` Ų
ŲØ¯Ø§Øą `None` ØąŲ ŲبŲŲ Ų
ÛâÚŠŲŲ:
+
+```Python
+say_hi(name=None) # اÛŲ ÚŠØ§Øą Ų
ÛâÚŠŲŲØ None Ų
ØšØĒØ¨ØąŲ đ
+```
+
+ØŽØ¨Øą ØŽŲب اÛŲŲ ÚŠŲ ŲŲØĒÛ ØąŲ ŲžØ§ÛØĒŲŲ 3.10 باشÛØ ŲØ§Ø˛Ų
ŲÛØŗØĒ ŲÚ¯ØąØ§Ų اÛŲ باشÛØ ÚŲŲ Ų
ÛâØĒŲŲÛ Ø¨ŲâØŗØ§Ø¯Ú¯Û Ø§Ø˛ `|` Ø¨ØąØ§Û ØĒØšØąÛŲ اØĒØادÛŲ ŲŲØšâŲا اØŗØĒŲادŲ ÚŠŲÛ:
+
+{* ../../docs_src/python_types/tutorial009c_py310.py hl[1,4] *}
+
+اŲŲ Ų
ŲŲØš دÛÚ¯Ų ŲØ§Ø˛Ų
ŲÛØŗØĒ ŲÚ¯ØąØ§Ų اØŗŲ
âŲاÛÛ Ų
ØĢŲ `Optional` Ų `Union` باشÛ. đ
+
+#### ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û
+
+اÛŲ ŲŲØšâŲاÛÛ ÚŠŲ ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û ŲŲØš ØąŲ ØĒŲÛ ÚŠØąŲØ´ŲâŲا Ų
ÛâÚ¯ÛØąŲ بŲØ´ŲŲ **ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û** Ûا **Generics** Ų
ÛâÚ¯ŲØ Ų
ØĢŲاŲ:
+
+//// tab | Python 3.10+
+
+Ų
ÛâØĒŲŲÛ Ø§Ø˛ ŲŲ
ŲŲ ŲŲØšâŲØ§Û Ø¯Ø§ØŽŲÛ Ø¨ŲâØšŲŲاŲ ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û Ø§ØŗØĒŲادŲ ÚŠŲÛ (با ÚŠØąŲØ´ŲâŲا Ų ŲŲØšâŲا دا؎ŲØ´ŲŲ):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+Ų ŲŲ
ŲŲâØˇŲØą ÚŠŲ ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.8 بŲØ¯Ø Ø§Ø˛ Ų
اÚŲŲ `typing`:
+
+* `Union`
+* `Optional` (ŲŲ
ŲŲâØˇŲØą ÚŠŲ ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.8 بŲد)
+* ...Ų بŲÛŲ.
+
+ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.10Ø Ø¨ŲâØšŲŲاŲ ØŦاÛÚ¯Ø˛ÛŲ Ø¨ØąØ§Û Ø§ØŗØĒŲادŲ Ø§Ø˛ ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û `Union` Ų `Optional`Ø Ų
ÛâØĒŲŲÛ Ø§Ø˛ ØŽØˇ ØšŲ
ŲØ¯Û (`|`) Ø¨ØąØ§Û ØĒØšØąÛŲ اØĒØادÛŲ ŲŲØšâŲا اØŗØĒŲادŲ ÚŠŲÛØ ÚŠŲ ØŽÛŲÛ Ø¨ŲØĒØą Ų ØŗادŲâØĒØąŲ.
+
+////
+
+//// tab | Python 3.9+
+
+Ų
ÛâØĒŲŲÛ Ø§Ø˛ ŲŲ
ŲŲ ŲŲØšâŲØ§Û Ø¯Ø§ØŽŲÛ Ø¨ŲâØšŲŲاŲ ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û Ø§ØŗØĒŲادŲ ÚŠŲÛ (با ÚŠØąŲØ´ŲâŲا Ų ŲŲØšâŲا دا؎ŲØ´ŲŲ):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+Ų ŲŲ
ŲŲâØˇŲØą ÚŠŲ ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.8 بŲØ¯Ø Ø§Ø˛ Ų
اÚŲŲ `typing`:
+
+* `Union`
+* `Optional`
+* ...Ų بŲÛŲ.
+
+////
+
+//// tab | Python 3.8+
+
+* `List`
+* `Tuple`
+* `Set`
+* `Dict`
+* `Union`
+* `Optional`
+* ...Ų بŲÛŲ.
+
+////
+
+### ÚŠŲاØŗâŲا بŲâØšŲŲاŲ ŲŲØš
+
+Ų
ÛâØĒŲŲÛ ÛŲ ÚŠŲاØŗ ØąŲ ŲŲ
بŲâØšŲŲاŲ ŲŲØš ÛŲ Ų
ØĒØēÛØą ØĒØšØąÛŲ ÚŠŲÛ.
+
+ŲØąØļ ÚŠŲ ÛŲ ÚŠŲاØŗ `Person` Ø¯Ø§ØąÛØ Ø¨Ø§ ÛŲ ŲاŲ
:
+
+{* ../../docs_src/python_types/tutorial010.py hl[1:3] *}
+
+بؚد Ų
ÛâØĒŲŲÛ ÛŲ Ų
ØĒØēÛØą ØąŲ Ø§Ø˛ ŲŲØš `Person` ØĒØšØąÛŲ ÚŠŲÛ:
+
+{* ../../docs_src/python_types/tutorial010.py hl[6] *}
+
+Ų Ø¨ØšØ¯Ø Ø¯ŲØ¨Ø§ØąŲØ ŲŲ
Ų ŲžØ´ØĒÛباŲÛ ŲÛØąØ§ÛØ´Ú¯Øą ØąŲ Ø¯Ø§ØąÛ:
+
+Pydantic ÛŲ ÚŠØĒاب؎ŲŲŲ ŲžØ§ÛØĒŲŲŲ Ø¨ØąØ§Û Ø§ØšØĒØ¨Ø§ØąØŗŲØŦÛ Ø¯Ø§Ø¯ŲâŲا.
+
+"Ø´ÚŠŲ" دادŲâŲا ØąŲ بŲâØšŲŲاŲ ÚŠŲاØŗâŲاÛÛ Ø¨Ø§ ŲÛÚÚ¯ÛâŲا ØĒØšØąÛŲ Ų
ÛâÚŠŲÛ.
+
+Ų ŲØą ŲÛÚÚ¯Û ÛŲ ŲŲØš Ø¯Ø§ØąŲ.
+
+بؚد ÛŲ ŲŲ
ŲŲŲ Ø§Ø˛ اŲŲ ÚŠŲاØŗ ØąŲ با ÛŲ ØŗØąÛ Ų
ŲØ¯Ø§Øą Ų
ÛâØŗØ§Ø˛Û Ų اŲŲ Ų
ŲØ¯Ø§ØąŲا ØąŲ اؚØĒØ¨Ø§ØąØŗŲØŦÛ Ų
ÛâÚŠŲŲØ Ø¨Ų ŲŲØš Ų
ŲاØŗب ØĒبدÛŲØ´ŲŲ Ų
ÛâÚŠŲŲ (اگŲ ŲØ§Ø˛Ų
باشŲ) Ų ÛŲ Ø´ÛØĄ با ŲŲ
Ų دادŲâŲا بŲØĒ Ų
ÛâدŲ.
+
+Ų با اŲŲ Ø´ÛØĄ ŲŲاÛÛ ŲŲ
Ų ŲžØ´ØĒÛباŲÛ ŲÛØąØ§ÛØ´Ú¯Øą ØąŲ Ų
ÛâÚ¯ÛØąÛ.
+
+ÛŲ Ų
ØĢاŲ Ø§Ø˛ Ų
ØŗØĒŲداØĒ ØąØŗŲ
Û Pydantic:
+
+//// 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
+
+Ø¨ØąØ§Û Ø§ØˇŲاؚاØĒ بÛØ´ØĒØą Ø¯Øą Ų
ŲØąØ¯ PydanticØ Ų
ØŗØĒŲداØĒØ´ ØąŲ ÚÚŠ ÚŠŲ .
+
+///
+
+**FastAPI** ڊاŲ
ŲاŲ Ø¨Øą ŲžØ§ÛŲ Pydantic ŲØŗØĒ.
+
+ØĒŲÛ [ØĸŲ
ŲØ˛Ø´ - ØąØ§ŲŲŲ
Ø§Û ÚŠØ§ØąØ¨Øą](tutorial/index.md){.internal-link target=_blank} ØŽÛŲÛ Ø¨ÛØ´ØĒØą Ø§Ø˛ اÛŲا ØąŲ ØĒŲÛ ØšŲ
Ų Ų
ÛâبÛŲÛ.
+
+/// tip
+
+Pydantic ÛŲ ØąŲØĒØ§Øą ؎اØĩ Ø¯Ø§ØąŲ ŲŲØĒÛ Ø§Ø˛ `Optional` Ûا `Union[Something, None]` بدŲŲ Ų
ŲØ¯Ø§Øą ŲžÛØ´âŲØąØļ اØŗØĒŲادŲ Ų
ÛâÚŠŲÛØ Ų
ÛâØĒŲŲÛ ØĒŲÛ Ų
ØŗØĒŲداØĒ Pydantic Ø¯Øą Ų
ŲØąØ¯ ŲÛŲدŲØ§Û Ø§ØŽØĒÛØ§ØąÛ ŲØ§Ø˛Ų
بÛØ´ØĒØą ب؎ŲŲÛ.
+
+///
+
+## ŲŲØšâŲŲ
اŲا با AnnotationŲØ§Û Ų
ØĒادÛØĒا
+
+ŲžØ§ÛØĒŲŲ ÛŲ ŲابŲÛØĒ ŲŲ
Ø¯Ø§ØąŲ ÚŠŲ بŲØĒ اØŦØ§Ø˛Ų Ų
ÛâدŲ **Ų
ØĒادÛØĒا اØļاŲÛ** ØąŲ ØĒŲÛ Ø§ÛŲ ŲŲØšâŲŲ
اŲا Ø¨Ø°Ø§ØąÛ Ø¨Ø§ اØŗØĒŲادŲ Ø§Ø˛ `Annotated`.
+
+//// tab | Python 3.9+
+
+ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.9Ø `Annotated` Ø¨ØŽØ´Û Ø§Ø˛ ÚŠØĒاب؎ŲŲŲ اØŗØĒاŲØ¯Ø§ØąØ¯ŲØ ŲžØŗ Ų
ÛâØĒŲŲÛ Ø§Ø˛ `typing` ŲØ§ØąØ¯Ø´ ÚŠŲÛ.
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial013_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+ØĒŲÛ ŲØŗØŽŲâŲØ§Û Ø˛ÛØą ŲžØ§ÛØĒŲŲ 3.9Ø `Annotated` ØąŲ Ø§Ø˛ `typing_extensions` ŲØ§ØąØ¯ Ų
ÛâÚŠŲÛ.
+
+با **FastAPI** Ø§Ø˛ ŲبŲ ŲØĩب شدŲ.
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial013.py!}
+```
+
+////
+
+ØŽŲد ŲžØ§ÛØĒŲŲ با اÛŲ `Annotated` ÚŠØ§ØąÛ ŲŲ
ÛâÚŠŲŲ. Ų Ø¨ØąØ§Û ŲÛØąØ§ÛØ´Ú¯ØąŲا Ų Ø§Ø¨Ø˛Ø§ØąŲØ§Û Ø¯ÛÚ¯ŲØ ŲŲØš ŲŲŲØ˛ `str` ŲØŗØĒ.
+
+ŲŲÛ Ų
ÛâØĒŲŲÛ Ø§Ø˛ اÛŲ ŲØļا ØĒŲÛ `Annotated` اØŗØĒŲادŲ ÚŠŲÛ ØĒا بŲ **FastAPI** Ų
ØĒادÛØĒØ§Û Ø§ØļاŲÛ Ø¯Øą Ų
ŲØąØ¯ اÛŲÚŠŲ ÚØˇŲØą Ų
ÛâØŽŲØ§Û Ø¨ØąŲاŲ
ŲâاØĒ ØąŲØĒØ§Øą ÚŠŲŲ بدÛ.
+
+ŲÚŠØĒŲ Ų
ŲŲ
اÛŲŲ ÚŠŲ **اŲŲÛŲ *ŲžØ§ØąØ§Ų
ØĒØą ŲŲØš*** ÚŠŲ بŲ `Annotated` Ų
ÛâدÛØ **ŲŲØš ŲاŲØšÛ** ŲØŗØĒ. بŲÛØ´ ŲŲØˇ Ų
ØĒادÛØĒا Ø¨ØąØ§Û Ø§Ø¨Ø˛Ø§ØąŲØ§Û Ø¯ÛÚ¯ŲâØŗØĒ.
+
+اŲاŲ ŲŲØˇ باÛد بدŲŲÛ ÚŠŲ `Annotated` ŲØŦŲد Ø¯Ø§ØąŲØ Ų اÛŲÚŠŲ ŲžØ§ÛØĒŲŲ اØŗØĒاŲØ¯Ø§ØąØ¯Ų. đ
+
+بؚداŲ Ų
ÛâبÛŲÛ ÚŠŲ ÚŲØ¯Øą **ŲŲÛ** Ų
ÛâØĒŲŲŲ باشŲ.
+
+/// tip
+
+اÛŲÚŠŲ اÛŲ **ŲžØ§ÛØĒŲŲ اØŗØĒاŲØ¯Ø§ØąØ¯Ų** ÛØšŲÛ ŲŲŲØ˛ **بŲØĒØąÛŲ ØĒØŦØąØ¨Ų ØĒŲØŗØšŲâدŲŲدŲ** ØąŲ ØĒŲÛ ŲÛØąØ§ÛØ´Ú¯ØąØĒØ Ø¨Ø§ Ø§Ø¨Ø˛Ø§ØąŲاÛÛ ÚŠŲ Ø¨ØąØ§Û ØĒØŲÛŲ Ų Ø¨Ø§Ø˛ØŗØ§Ø˛Û ÚŠØ¯ØĒ اØŗØĒŲادŲ Ų
ÛâÚŠŲÛ Ų ØēÛØąŲ Ų
ÛâÚ¯ÛØąÛ. â¨
+
+Ų ŲŲ
ÛŲâØˇŲØą ڊدØĒ با ØŽÛŲÛ Ø§Ø˛ Ø§Ø¨Ø˛Ø§ØąŲا Ų ÚŠØĒاب؎ŲŲŲâŲØ§Û Ø¯ÛÚ¯Ų ŲžØ§ÛØĒŲŲ ØŽÛŲÛ ØŗØ§Ø˛Ú¯Ø§Øą Ų
ÛâŲ
ŲŲŲ. đ
+
+///
+
+## ŲŲØšâŲŲ
اŲا ØĒŲÛ **FastAPI**
+
+**FastAPI** Ø§Ø˛ اÛŲ ŲŲØšâŲŲ
اŲا اØŗØĒŲادŲ Ų
ÛâÚŠŲŲ ØĒا ÚŲد ØĒا ÚŠØ§Øą بڊŲŲ.
+
+با **FastAPI** ŲžØ§ØąØ§Ų
ØĒØąŲا ØąŲ با ŲŲØšâŲŲ
اŲا ØĒØšØąÛŲ Ų
ÛâÚŠŲÛ Ų اÛŲا ØąŲ Ų
ÛâÚ¯ÛØąÛ:
+
+* **ŲžØ´ØĒÛباŲÛ ŲÛØąØ§ÛØ´Ú¯Øą**.
+* **ÚÚŠ ŲŲØšâŲا**.
+
+...Ų **FastAPI** Ø§Ø˛ ŲŲ
ŲŲ ØĒØšØąÛŲâŲا Ø¨ØąØ§Û Ø§ÛŲا اØŗØĒŲادŲ Ų
ÛâÚŠŲŲ:
+
+* **ØĒØšØąÛŲ ŲÛØ§Ø˛Ųا**: Ø§Ø˛ ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û Ų
ØŗÛØą Ø¯ØąØŽŲاØŗØĒØ ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û ÚŠŲØĻØąÛØ ŲØ¯ØąŲØ§Ø Ø¨Ø¯ŲŲâŲØ§Ø ŲابØŗØĒÚ¯ÛâŲا Ų ØēÛØąŲ.
+* **ØĒبدÛŲ دادŲ**: Ø§Ø˛ Ø¯ØąØŽŲاØŗØĒ بŲ ŲŲØš Ų
ŲØąØ¯ ŲÛØ§Ø˛.
+* **اؚØĒØ¨Ø§ØąØŗŲØŦÛ Ø¯Ø§Ø¯Ų**: ÚŠŲ Ø§Ø˛ ŲØą Ø¯ØąØŽŲاØŗØĒ Ų
Ûاد:
+ * ØĒŲŲÛد **ØŽØˇØ§ŲØ§Û ØŽŲØ¯ÚŠØ§Øą** ÚŠŲ بŲ ÚŠŲاÛŲØĒ Ø¨ØąŲ
ÛâÚ¯ØąØ¯Ų ŲŲØĒÛ Ø¯Ø§Ø¯Ų ŲاŲ
ØšØĒØ¨ØąŲ.
+* **Ų
ØŗØĒŲدØŗØ§Ø˛Û** API با اØŗØĒŲادŲ Ø§Ø˛ OpenAPI:
+ * ÚŠŲ بؚدش ØĒŲØŗØˇ ØąØ§Ø¨ØˇâŲØ§Û ÚŠØ§ØąØ¨ØąÛ Ų
ØŗØĒŲداØĒ ØĒؚاŲ
ŲÛ ØŽŲØ¯ÚŠØ§Øą اØŗØĒŲادŲ Ų
ÛâØ´Ų.
+
+اÛŲا شاÛد ŲŲ
ŲâØ´ اŲØĒØ˛Ø§ØšÛ Ø¨Ų ŲØ¸Øą بÛاد. ŲÚ¯ØąØ§Ų Ųباش. ŲŲ
Ų اÛŲا ØąŲ ØĒŲÛ ØšŲ
Ų ØĒŲÛ [ØĸŲ
ŲØ˛Ø´ - ØąØ§ŲŲŲ
Ø§Û ÚŠØ§ØąØ¨Øą](tutorial/index.md){.internal-link target=_blank} Ų
ÛâبÛŲÛ.
+
+ŲÚŠØĒŲ Ų
ŲŲ
اÛŲŲ ÚŠŲ با اØŗØĒŲادŲ Ø§Ø˛ ŲŲØšâŲØ§Û Ø§ØŗØĒاŲØ¯Ø§ØąØ¯ ŲžØ§ÛØĒŲŲØ ØĒŲÛ ÛŲ ØŦا (بŲ ØŦØ§Û Ø§ØļاŲŲ ÚŠØąØ¯Ų ÚŠŲاØŗâŲØ§Û Ø¨ÛØ´ØĒØąØ Ø¯ÚŠŲØąØ§ØĒŲØąŲا Ų ØēÛØąŲ)Ø **FastAPI** ÚŠŲÛ Ø§Ø˛ ÚŠØ§Øą ØąŲ Ø¨ØąØ§ØĒ اŲØŦاŲ
Ų
ÛâدŲ.
+
+/// info
+
+اگŲ ŲŲ
Ų ØĸŲ
ŲØ˛Ø´ ØąŲ Ú¯Ø°ØąŲŲØ¯Û Ų Ø¨ØąÚ¯Ø´ØĒÛ ÚŠŲ بÛØ´ØĒØą Ø¯Øą Ų
ŲØąØ¯ ŲŲØšâŲا ببÛŲÛØ ÛŲ Ų
Ųبؚ ØŽŲب "ØĒŲŲبâŲاŲ
Ų" Ø§Ø˛ `mypy` ŲØŗØĒ.
+
+///
diff --git a/docs/ja/docs/deployment/concepts.md b/docs/ja/docs/deployment/concepts.md
index c6b21fd1b..a0d4fb35b 100644
--- a/docs/ja/docs/deployment/concepts.md
+++ b/docs/ja/docs/deployment/concepts.md
@@ -219,7 +219,7 @@ FastAPI ãĸããĒãąãŧãˇã§ãŗã§ã¯ãUvicorn ãŽãããĒãĩãŧããŧãã
ããããŽã¯ãŧãĢãŧãģãããģãšã¯ããĸããĒãąãŧãˇã§ãŗãåŽčĄããããŽã§ããã**ãĒã¯ã¨ãšã**ãåããĻ**ãŦãšããŗãš**ãčŋããããŽä¸ģčĻãĒč¨įŽãčĄããããĒããå¤æ°ãĢå
ĨããããŽã¯äŊã§ãRAMãĢããŧãããžãã
-uv ããčŠĻããã ããã
+
+///
+
+## ããã¸ã§ã¯ããŽäŊæ
+
+ãžããããã¸ã§ã¯ãį¨ãŽããŖãŦã¯ããĒãäŊæããžãã
+
+į§ã¯é常 home/user ããŖãŦã¯ããĒãŽä¸ãĢ `code` ã¨ããããŖãŦã¯ããĒãį¨æããĻããĻãããã¸ã§ã¯ããã¨ãĢ1ã¤ãŽããŖãŦã¯ããĒãããŽä¸ãĢäŊæããĻããžãã
+
+
+
+```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
+```
+
+
+
+## äģŽæŗį°åĸãŽäŊæ
+
+Pythonããã¸ã§ã¯ãã§ãŽ**åããĻãŽ**äŊæĨãéå§ããéãĢã¯ã**ããã¸ã§ã¯ãå
**ãĢäģŽæŗį°åĸãäŊæããĻãã ããã
+
+/// tip | čąįĨč
+
+ãããčĄããŽã¯ã**ããã¸ã§ã¯ããã¨ãĢ1åã ã**ã§ããäŊæĨãŽããŗãĢčĄãåŋ
čĻã¯ãããžããã
+
+///
+
+//// tab | `venv`
+
+äģŽæŗį°åĸãäŊæãããĢã¯ãPythonãĢäģåąããĻãã `venv` ãĸã¸ãĨãŧãĢãäŊŋį¨ã§ããžãã
+
+
+
+```console
+$ python -m venv .venv
+```
+
+
+
+/// details | ããŽãŗããŗããŽæåŗ
+
+- `python` : `python` ã¨ããããã°ãŠã ãåŧãŗåēããžã
+- `-m` : ãĸã¸ãĨãŧãĢããšã¯ãĒããã¨ããĻåŧãŗåēããžãããŠãŽãĸã¸ãĨãŧãĢãåŧãŗåēããŽããããŽæŦĄãĢæåŽããžã
+- `venv` : é常PythonãĢäģéããĻã¤ãŗãšããŧãĢããã `venv`ãĸã¸ãĨãŧãĢãäŊŋį¨ããžã
+- `.venv` : äģŽæŗį°åĸã`.venv`ã¨ããæ°ããããŖãŦã¯ããĒãĢäŊæããžã
+
+///
+
+////
+
+//// tab | `uv`
+
+ãã `uv` ãã¤ãŗãšããŧãĢæ¸ãŋãĒããäģŽæŗį°åĸãäŊæãããããĢ `uv` ãäŊŋããã¨ãã§ããžãã
+
+
+
+```console
+$ uv venv
+```
+
+
+
+/// tip | čąįĨč
+
+ãããŠãĢãã§ã¯ã `uv` 㯠`.venv` ã¨ããããŖãŦã¯ããĒãĢäģŽæŗį°åĸãäŊæããžãã
+
+ãã ããčŋŊå ãŽåŧæ°ãĢããŖãŦã¯ããĒåãä¸ããĻãĢãšãŋãã¤ãēãããã¨ãã§ããžãã
+
+///
+
+////
+
+ããŽãŗããŗã㯠`.venv` ã¨ããããŖãŦã¯ããĒãĢæ°ããäģŽæŗį°åĸãäŊæããžãã
+
+/// details | `.venv` ãžãã¯ããŽäģãŽåå
+
+äģŽæŗį°åĸãåĨãŽããŖãŦã¯ããĒãĢäŊæãããã¨ãå¯čŊã§ããã `.venv` ã¨åäģãããŽãä¸čŦįãĒæ
Ŗįŋã§ãã
+
+///
+
+## äģŽæŗį°åĸãŽæåšå
+
+åŽčĄãããPythonãŗããŗããã¤ãŗãšããŧãĢããããããąãŧã¸ãæ°ããäŊæããäģŽæŗį°åĸãäŊŋį¨ãããããããŽäģŽæŗį°åĸãæåšåããžãããã
+
+/// tip | čąįĨč
+
+ããŽããã¸ã§ã¯ããŽäŊæĨã§**æ°ãããŋãŧãããĢãģããˇã§ãŗ**ãéå§ããéãĢã¯ã**æ¯å**æåšåãåŋ
čĻã§ãã
+
+///
+
+//// tab | Linux, macOS
+
+
+
+```console
+$ source .venv/bin/activate
+```
+
+
+
+////
+
+//// tab | Windows PowerShell
+
+
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+
+
+////
+
+//// tab | Windows Bash
+
+ããWindowsã§BashãäŊŋį¨ããĻããå ´å (Git Bash ãĒãŠ):
+
+
+
+```console
+$ source .venv/Scripts/activate
+```
+
+
+
+////
+
+/// tip | čąįĨč
+
+**æ°ãããããąãŧã¸**ãäģŽæŗį°åĸãĢã¤ãŗãšããŧãĢããã¨ããĢã¯ãååēĻ**æåšå**ããĻãã ããã
+
+ãããããã¨ã§ãããŽãããąãŧã¸ãã¤ãŗãšããŧãĢãã**ãŋãŧãããĢīŧCLI īŧããã°ãŠã **ãäŊŋį¨ããå ´åãĢãäģŽæŗį°åĸå
ãŽããŽãįĸēåŽãĢäŊŋãããã°ããŧããĢį°åĸãĢã¤ãŗãšããŧãĢãããĻããåĨãŽããŽīŧããããåŋ
čĻãĒããŽã¨ã¯į°ãĒãããŧã¸ã§ãŗīŧãčĒ¤ãŖãĻäŊŋį¨ãããã¨ãé˛ããžãã
+
+///
+
+## äģŽæŗį°åĸãæåšã§ãããã¨ãįĸēčĒãã
+
+äģŽæŗį°åĸãæåšã§ããīŧåãŽãŗããŗããæŖ常ãĢæŠčŊããīŧãã¨ãįĸēčĒããžãã
+
+/// tip | čąįĨč
+
+ããã¯**äģģæ**ã§ãããããšãĻãæåž
éããĢæŠčŊããæåŗããäģŽæŗį°åĸãäŊŋį¨ããĻãããã¨ã**įĸēčĒãã**č¯ãæšæŗã§ãã
+
+///
+
+//// tab | Linux, macOS, Windows Bash
+
+
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+
+
+`.venv/bin/python` ãĢãã `python` ãã¤ããĒããããã¸ã§ã¯ãīŧããŽå ´å㯠`awesome-project` īŧå
ãĢ襨į¤ēãããĻããã°ãæŖ常ãĢåäŊããĻããžã đã
+
+////
+
+//// tab | Windows PowerShell
+
+
+
+``` console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+
+
+`.venv\Scripts\python` ãĢãã `python` ãã¤ããĒããããã¸ã§ã¯ãīŧããŽå ´å㯠`awesome-project` īŧå
ãĢ襨į¤ēãããĻããã°ãæŖ常ãĢåäŊããĻããžã đã
+
+////
+
+## `pip` ããĸããã°ãŦãŧããã
+
+/// tip | čąįĨč
+
+ãã `uv` ãäŊŋį¨ããĻããå ´åã¯ã `pip` ãŽäģŖãããĢ `uv` ãäŊŋãŖãĻã¤ãŗãšããŧãĢãčĄãããã `pip` ããĸããã°ãŦãŧãããåŋ
čĻã¯ãããžãã đã
+
+///
+
+ãããããąãŧã¸ãŽã¤ãŗãšããŧãĢãĢ `pip`īŧPythonãĢæ¨æēã§äģåąããĻããžãīŧãäŊŋį¨ããĻãããĒãã `pip` ãææ°ããŧã¸ã§ãŗãĢ**ãĸããã°ãŦãŧã**ããžãããã
+
+ãããąãŧã¸ãŽã¤ãŗãšããŧãĢä¸ãĢįēįããæŗåŽå¤ãŽã¨ãŠãŧãŽå¤ãã¯ãæåãĢ `pip` ããĸããã°ãŦãŧãããĻããã ãã§č§Ŗæąēãããžãã
+
+/// tip | čąįĨč
+
+é常ãããã¯äģŽæŗį°åĸãäŊæããį´åžãĢ**ä¸åēĻã ã**åŽčĄããžãã
+
+///
+
+äģŽæŗį°åĸãæåšã§ãããã¨ãīŧä¸ã§čĒŦæãããŗããŗãã§īŧįĸēčĒãããĸããã°ãŦãŧããåŽčĄããžãããīŧ
+
+
+
+```console
+$ python -m pip install --upgrade pip
+
+---> 100%
+```
+
+
+
+## `.gitignore` ãčŋŊå ãã
+
+**Git**ãäŊŋį¨ããĻããå ´åīŧäŊŋį¨ãããšãã§ãããīŧã `.gitignore` ããĄã¤ãĢãčŋŊå ããĻã `.venv` å
ãŽããããããĄã¤ãĢãGitãŽįŽĄįå¯žčąĄããé¤å¤ããžãã
+
+/// tip | čąįĨč
+
+ãã `uv` ãäŊŋį¨ããĻäģŽæŗį°åĸãäŊæããå ´åããã§ãĢããŽäŊæĨã¯æ¸ãã§ãããŽã§ãããŽæé ããšãããã§ããžã đã
+
+///
+
+/// tip | čąįĨč
+
+ããããäģŽæŗį°åĸãäŊæããį´åžãĢ**ä¸åēĻã ã**åŽčĄããžãã
+
+///
+
+
+
+```console
+$ echo "*" > .venv/.gitignore
+```
+
+
+
+/// details | ããŽãŗããŗããŽæåŗ
+
+- `echo "*"` : ãŋãŧãããĢãĢ `*` ã¨ãããããšããã襨į¤ēããããã¨ããžããīŧæŦĄãŽé¨åãĢããŖãĻããŽåäŊãå°ãå¤ãããžãīŧ
+- `>` : `>` ãŽåˇĻå´ãŽãŗããŗãããŋãŧãããĢãĢ襨į¤ēãããã¨ããå
厚ãããŋãŧãããĢãĢã¯čĄ¨į¤ēããã `>` ãŽåŗå´ãŽããĄã¤ãĢãĢæ¸ãčžŧãŋãžãã
+- `.gitignore` : `*` ãæ¸ãčžŧãããĄã¤ãĢåã
+
+ããã§ãGitãĢããã `*` ã¯ãããšãĻããæåŗãããŽã§ãããŽãŗããŗããĢããŖãĻ `.venv` ããŖãŦã¯ããĒå
ãŽããšãĻãGitãĢįĄčĻããããããĢãĒããžãã
+
+ããŽãŗããŗãã¯äģĨä¸ãŽãããšããæ㤠`.gitignore` ããĄã¤ãĢãäŊæããžãīŧ
+
+```gitignore
+*
+```
+
+///
+
+## ãããąãŧã¸ãŽã¤ãŗãšããŧãĢ
+
+äģŽæŗį°åĸãæåšåããåžãããŽä¸ã§ãããąãŧã¸ãã¤ãŗãšããŧãĢã§ããžãã
+
+/// tip | čąįĨč
+
+ããã¸ã§ã¯ããĢåŋ
čĻãĒãããąãŧã¸ãã¤ãŗãšããŧãĢãžãã¯ãĸããã°ãŦãŧãããå ´åãããã**ä¸åēĻ**åŽčĄããžãã
+
+ããæ°ãããããąãŧã¸ãčŋŊå ããããããŧã¸ã§ãŗããĸããã°ãŦãŧãããåŋ
čĻãããå ´åã¯ããã**ä¸åēĻããŽæé ãįš°ãčŋã**ãžãã
+
+///
+
+### ãããąãŧã¸ãį´æĨã¤ãŗãšããŧãĢãã
+
+æĨãã§ããĻãããã¸ã§ã¯ããŽãããąãŧã¸čĻäģļãåŽŖč¨ããããĄã¤ãĢãäŊŋããããĒãå ´åããããąãŧã¸ãį´æĨã¤ãŗãšããŧãĢã§ããžãã
+
+/// tip | čąįĨč
+
+ããã°ãŠã ãåŋ
čĻã¨ãããããąãŧã¸ã¨ããŧã¸ã§ãŗãããĄã¤ãĢīŧäžãã° `requirements.txt` ã `pyproject.toml` īŧãĢč¨čŧããĻãããŽã¯ãīŧã¨ãĻãīŧč¯ãčãã§ãã
+
+///
+
+//// tab | `pip`
+
+
+
+```console
+$ pip install "fastapi[standard]"
+
+---> 100%
+```
+
+
+
+////
+
+//// tab | `uv`
+
+ãã `uv` ãäŊŋį¨ã§ãããĒã:
+
+
+
+```console
+$ uv pip install "fastapi[standard]"
+---> 100%
+```
+
+
+
+////
+
+### `requirements.txt` ããã¤ãŗãšããŧãĢãã
+
+ãã `requirements.txt` ããããĒãããããąãŧã¸ãŽã¤ãŗãšããŧãĢãĢäŊŋį¨ã§ããžãã
+
+//// tab | `pip`
+
+
+
+```console
+$ pip install -r requirements.txt
+---> 100%
+```
+
+
+
+////
+
+//// tab | `uv`
+
+ãã `uv` ãäŊŋį¨ã§ãããĒã:
+
+
+
+```console
+$ uv pip install -r requirements.txt
+---> 100%
+```
+
+
+
+////
+
+/// details | `requirements.txt`
+
+ãããąãŧã¸ãč¨čŧããã `requirements.txt` ã¯äģĨä¸ãŽãããĢãĒãŖãĻããžã:
+
+```requirements.txt
+fastapi[standard]==0.113.0
+pydantic==2.8.0
+```
+
+///
+
+## ããã°ãŠã ãåŽčĄãã
+
+äģŽæŗį°åĸãæåšåããåžãããã°ãŠã ãåŽčĄã§ããžããããŽéãäģŽæŗį°åĸå
ãŽPythonã¨ããããĢã¤ãŗãšããŧãĢãããããąãŧã¸ãäŊŋį¨ãããžãã
+
+
+
+```console
+$ python main.py
+
+Hello World
+```
+
+
+
+## ã¨ããŖãŋãŽč¨åŽ
+
+ããã¸ã§ã¯ãã§ã¯ããããã¨ããŖãŋãäŊŋį¨ããã§ãããããŗãŧãčŖåŽãã¤ãŗãŠã¤ãŗã¨ãŠãŧãŽčĄ¨į¤ēãã§ãããããĢãäŊæããäģŽæŗį°åĸãã¨ããŖãŋã§ãäŊŋããããč¨åŽããĻãã ãããīŧå¤ããŽå ´åãčĒåæ¤åēãããžãīŧ
+
+č¨åŽäž:
+
+* VS Code
+* PyCharm
+
+/// tip | čąįĨč
+
+ããŽč¨åŽã¯é常ãäģŽæŗį°åĸãäŊæããéãĢ**ä¸åēĻã ã**čĄããžãã
+
+///
+
+## äģŽæŗį°åĸãŽįĄåšå
+
+ããã¸ã§ã¯ããŽäŊæĨãįĩäēããããããŽäģŽæŗį°åĸã**įĄåšå**ã§ããžãã
+
+
+
+```console
+$ deactivate
+```
+
+
+
+ãããĢããã `python` ãŗããŗããåŽčĄããĻããããŽããã¸ã§ã¯ãį¨īŧãŽãããąãŧã¸ãã¤ãŗãšããŧãĢãããīŧäģŽæŗį°åĸãã `python` ããã°ãŠã ãåŧãŗåēããã¨ã¯ããĒããĒããžãã
+
+## äŊæĨæēååŽäē
+
+ãããžã§ã§ãããã¸ã§ã¯ããŽäŊæĨãå§ããæēåãæ´ããžããã
+
+/// tip | čąįĨč
+
+ä¸č¨ãŽå
厚ãįč§Ŗãããã§ããīŧ
+
+ãããããĒããäģĨä¸ãčĒãŋé˛ããĻãã ãããđđ¤
+
+///
+
+## ãĒãäģŽæŗį°åĸīŧ
+
+FastAPIãäŊŋãŖãäŊæĨããããĢã¯ã [Python](https://www.python.org/) ãŽã¤ãŗãšããŧãĢãåŋ
čĻã§ãã
+
+ãããããFastAPIããäŊŋį¨ãããããŽäģãŽ**ãããąãŧã¸**ã**ã¤ãŗãšããŧãĢ**ããåŋ
čĻããããžãã
+
+ãããąãŧã¸ãã¤ãŗãšããŧãĢãããĢã¯ãé常ãPython ãĢäģåąãã `pip` ãŗããŗã (ãžãã¯åæ§ãŽäģŖæŋãŗããŗã) ãäŊŋį¨ããžãã
+
+ãã ãã`pip` ãį´æĨäŊŋį¨ããã¨ããããąãŧã¸ã¯**ã°ããŧããĢãĒPythonį°åĸ**īŧOSå
¨äŊãĢã¤ãŗãšããŧãĢãããPythonį°åĸīŧãĢã¤ãŗãšããŧãĢãããžãã
+
+### åéĄįš
+
+ã§ã¯ãã°ããŧããĢPythonį°åĸãĢãããąãŧã¸ãã¤ãŗãšããŧãĢãããã¨ãŽåéĄįšã¯äŊã§ããããīŧ
+
+ããæįšã§ãããĒãã¯**į°ãĒããããąãŧã¸**ãĢäžåããå¤ããŽããã°ãŠã ãæ¸ããã¨ãĢãĒãã§ãããããããĻãããããŽä¸ãĢã¯åããããąãŧã¸ãŽ**į°ãĒãããŧã¸ã§ãŗ**ãĢäžåããããŽãåēãĻããã§ããããđą
+
+äžãã°ã `philosophers-stone` īŧčŗĸč
ãŽįŗīŧã¨ããããã¸ã§ã¯ããäŊæããã¨ããžããããŽããã°ãŠã 㯠**`harry` īŧããĒãŧīŧã¨ãããããąãŧã¸ãŽããŧã¸ã§ãŗ `1`**ãĢäžåããĻããžããããŽããã `harry` īŧããĒãŧīŧãã¤ãŗãšããŧãĢããåŋ
čĻããããžãã
+
+```mermaid
+flowchart LR
+ stone(philosophers-stone) -->|requires| harry-1[harry v1]
+```
+
+ããããã `prisoner-of-azkaban` īŧãĸãēãĢããŗãŽåäēēīŧã¨ããåĨãŽããã¸ã§ã¯ããäŊæããã¨ããžããããŽããã¸ã§ã¯ãã `harry` īŧããĒãŧīŧãĢäžåããĻããžããã**`harry` īŧããĒãŧīŧãŽããŧã¸ã§ãŗ `3`**ãåŋ
čĻã§ãã
+
+```mermaid
+flowchart LR
+ azkaban(prisoner-of-azkaban) --> |requires| harry-3[harry v3]
+```
+
+ããããããã§åéĄãĢãĒããŽã¯ãããããŧãĢãĢãŽ**äģŽæŗį°åĸ**ã§ã¯ãĒãã°ããŧããĢīŧį°åĸīŧãĢãããąãŧã¸ãã¤ãŗãšããŧãĢãããĒãã `harry` īŧããĒãŧīŧãŽãŠãŽããŧã¸ã§ãŗãã¤ãŗãšããŧãĢãããé¸ã°ãĒãã¨ãããĒããã¨ã§ãã
+
+äžãã°ã `philosophers-stone` īŧčŗĸč
ãŽįŗīŧãåŽčĄãããĢã¯ããžã `harry` īŧããĒãŧīŧãŽããŧã¸ã§ãŗ `1` ãã¤ãŗãšããŧãĢããåŋ
čĻããããžãīŧ
+
+
+
+```console
+$ pip install "harry==1"
+```
+
+
+
+ãããĢããã`harry` īŧããĒãŧīŧããŧã¸ã§ãŗ1ãã°ããŧããĢãĒPythonį°åĸãĢã¤ãŗãšããŧãĢãããžãã
+
+```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
+```
+
+ãããã `prisoner-of-azkaban` īŧãĸãēãĢããŗãŽåäēēīŧãåŽčĄãããå ´åã¯ã`harry` īŧããĒãŧīŧãŽããŧã¸ã§ãŗ `1` ããĸãŗã¤ãŗãšããŧãĢãã`harry` īŧããĒãŧīŧãŽããŧã¸ã§ãŗ `3` ãã¤ãŗãšããŧãĢãį´ãåŋ
čĻããããžããīŧãããã¯ãåãĢ`harry` īŧããĒãŧīŧãŽããŧã¸ã§ãŗ `3` ãã¤ãŗãšããŧãĢãããã¨ã§ãčĒåįãĢããŧã¸ã§ãŗ `1` ããĸãŗã¤ãŗãšããŧãĢãããžãīŧ
+
+
+
+```console
+$ pip install "harry==3"
+```
+
+
+
+ããŽãããĢããĻãã°ããŧããĢį°åĸã¸ãŽ `harry` īŧããĒãŧīŧãŽããŧã¸ã§ãŗ `3` ãŽã¤ãŗãšããŧãĢãåŽäēããžãã
+
+ããããã `philosophers-stone` īŧčŗĸč
ãŽįŗīŧãåãŗåŽčĄãããã¨ããã¨ãããŽããã°ãŠã 㯠`harry` īŧããĒãŧīŧãŽããŧã¸ã§ãŗ `1` ãåŋ
čĻãĒããã**åäŊããĒããĒã**å¯čŊæ§ããããžãã
+
+```mermaid
+flowchart LR
+ subgraph global[global env]
+ harry-1[harry v1 ]
+ 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 | čąįĨč
+
+PythonãŽãããąãŧã¸ã§ã¯ã**æ°ããããŧã¸ã§ãŗ**ã§**äēææ§ãæãĒãå¤æ´ãéŋãã**ããåĒãããŽãä¸čŦįã§ãããããã§ãæŗ¨æãåŋ
čĻã§ããããšãĻãæŖ常ãĢåäŊãããã¨ãããšãã§įĸēčĒããĻãããæåŗįãĢæåŽããĻæ°ããããŧã¸ã§ãŗãã¤ãŗãšããŧãĢãããŽãč¯ãã§ãããã
+
+///
+
+ããĒããŽããšãĻãŽ**ããã¸ã§ã¯ããäžåããĻãã**ã**å¤æ°ãŽ**äģãŽ**ãããąãŧã¸**ãä¸č¨ãŽåéĄãæąããĻããã¨æŗåããĻãã ãããããã¯įŽĄįãé常ãĢå°éŖã§ãããããĻã**äēææ§ãŽãĒãããŧã¸ã§ãŗ**ãŽãããąãŧã¸ãäŊŋãŖãĻããã¸ã§ã¯ããåŽčĄãããĒãåäŊããĒããŽãåãããĒããĒãã§ãããã
+
+ãžããäŊŋį¨ããĻããOSīŧLinuxãWindowsãmacOS ãĒãŠīŧãĢããŖãĻã¯ãPythonããã§ãĢã¤ãŗãšããŧãĢãããĻãããã¨ããããžããããŽå ´åãįšåŽãŽããŧã¸ã§ãŗãŽãããąãŧã¸ã**OSãŽåäŊãĢåŋ
čĻã§ãã**ãã¨ããããžããã°ããŧããĢį°åĸãĢãããąãŧã¸ãã¤ãŗãšããŧãĢããã¨ãOSãĢäģåąããããã°ãŠã ã**åŖããĻããžã**å¯čŊæ§ããããžãã
+
+## ãããąãŧã¸ãŽã¤ãŗãšããŧãĢå
+
+Pythonãã¤ãŗãšããŧãĢããã¨ããããĄã¤ãĢãåĢãã ããã¤ããŽããŖãŦã¯ããĒãäŊæãããžãã
+
+ããããŽä¸ãĢã¯ãã¤ãŗãšããŧãĢããããããąãŧã¸ãäŋåãããããŽããŽããããžãã
+
+äģĨä¸ãŽãŗããŗããåŽčĄããã¨ãīŧ
+
+
+
+```console
+// Don't run this now, it's just an example đ¤
+$ pip install "fastapi[standard]"
+---> 100%
+```
+
+
+
+FastAPIãŽãŗãŧããåĢãå§į¸ŽããĄã¤ãĢããé常㯠[PyPI](https://pypi.org/project/fastapi/) ããããĻãŗããŧããããžãã
+
+ãžããFastAPIãäžåããäģãŽãããąãŧã¸ã**ããĻãŗããŧã**ãããžãã
+
+ãããããããããŽããĄã¤ãĢã¯**č§Ŗå**ããããŗãŗããĨãŧãŋãŽããããŖãŦã¯ããĒãĢé
įŊŽãããžãã
+
+ãããŠãĢãã§ã¯ãããããŽããĄã¤ãĢã¯PythonãŽã¤ãŗãšããŧãĢæãĢäŊæãããããŖãŦã¯ããĒãã¤ãžã**ã°ããŧããĢį°åĸ**ãĢé
įŊŽãããžãã
+
+## äģŽæŗį°åĸã¨ã¯
+
+ããšãĻãŽãããąãŧã¸ãã°ããŧããĢį°åĸãĢé
įŊŽãããã¨ãĢããŖãĻįããåéĄãŽč§Ŗæąēįã¯ãäŊæĨãã**ããã¸ã§ã¯ããã¨ãŽäģŽæŗį°åĸ**ãäŊŋį¨ãããã¨ã§ãã
+
+äģŽæŗį°åĸã¯**ããŖãŦã¯ããĒ**ã§ãããã°ããŧããĢį°åĸã¨é常ãĢäŧŧãĻããĻãä¸ã¤ãŽããã¸ã§ã¯ãã§äŊŋãįšåŽãŽãããąãŧã¸įž¤ãã¤ãŗãšããŧãĢã§ããå ´æã§ãã
+
+ããŽãããĢããĻããããããŽããã¸ã§ã¯ããįŦčĒãŽäģŽæŗį°åĸīŧ`.venv` ããŖãŦã¯ããĒīŧãĢįŦčĒãŽãããąãŧã¸įž¤ãæã¤ãã¨ãã§ããžãã
+
+```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
+```
+
+## äģŽæŗį°åĸãŽæåšåã¨ã¯
+
+äģŽæŗį°åĸãæåšãĢããã¨ããäžãã°æŦĄãŽãŗããŗããåŽčĄããå ´åãčããžãīŧ
+
+//// tab | Linux, macOS
+
+
+
+```console
+$ source .venv/bin/activate
+```
+
+
+
+////
+
+//// tab | Windows PowerShell
+
+
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+
+
+////
+
+//// tab | Windows Bash
+
+ãããã¯ãWindowsã§BashãäŊŋį¨ããĻããå ´å (Git Bash ãĒãŠ):
+
+
+
+```console
+$ source .venv/Scripts/activate
+```
+
+
+
+////
+
+ãããĢããŖãĻãããã¤ã㎠[į°åĸå¤æ°](environment-variables.md){.internal-link target=_blank} ãäŊæãģäŋŽæŖãããæŦĄãĢåŽčĄããããŗããŗãã§äŊŋį¨ã§ãããããĢãĒããžãã
+
+ããããŽį°åĸå¤æ°ãŽã˛ã¨ã¤ãĢã `PATH` å¤æ°ããããžãã
+
+/// tip | čąįĨč
+
+`PATH` å¤æ°ãĢã¤ããĻãŽčŠŗį´°ã¯ [į°åĸå¤æ°](environment-variables.md#pathį°åĸå¤æ°){.internal-link target=_blank} ãåį
§ããĻãã ããã
+
+///
+
+äģŽæŗį°åĸãæåšãĢããã¨ãããŽäģŽæŗį°åĸãŽããš `.venv/bin` īŧLinuxã¨macOSīŧãããã㯠`.venv\Scripts` īŧWindowsīŧã `PATH` å¤æ°ãĢčŋŊå ãããžãã
+
+ããŽį°åĸãæåšãĢããå㎠`PATH` å¤æ°ãæŦĄãŽãããĢãĒãŖãĻããã¨ããžãã
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+ããã¯ãOSãäģĨä¸ãŽããŖãŦã¯ããĒä¸ã§ããã°ãŠã ãæĸããã¨ãæåŗããžãīŧ
+
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Windows\System32
+```
+
+ããã¯ãOSãäģĨä¸ãŽããŖãŦã¯ããĒä¸ã§ããã°ãŠã ãæĸããã¨ãæåŗããžãīŧ
+
+* `C:\Windows\System32`
+
+////
+
+äģŽæŗį°åĸãæåšãĢããã¨ã `PATH` å¤æ°ã¯æŦĄãŽãããĢãĒããžãã
+
+//// tab | Linux, macOS
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+ããã¯ãOSãäģãŽããŖãŦã¯ããĒãæĸãããåãĢãæåãĢäģĨä¸ãŽããŖãŦã¯ããĒä¸ã§ããã°ãŠã ãæĸãå§ãããã¨ãæåŗããžãīŧ
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin
+```
+
+ããŽããããŋãŧãããĢ㧠`python` ã¨å
ĨåããéãĢãOSã¯Pythonããã°ãŠã ãäģĨä¸ãŽããšã§įēčĻããäŊŋį¨ããžãã
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts;C:\Windows\System32
+```
+
+ããã¯ãOSãäģãŽããŖãŦã¯ããĒãæĸãããåãĢãæåãĢäģĨä¸ãŽããŖãŦã¯ããĒä¸ã§ããã°ãŠã ãæĸãå§ãããã¨ãæåŗããžãīŧ
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts
+```
+
+ããŽããããŋãŧãããĢ㧠`python` ã¨å
ĨåããéãĢãOSã¯Pythonããã°ãŠã ãäģĨä¸ãŽããšã§įēčĻããäŊŋį¨ããžãã
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+////
+
+éčĻãĒįšã¯ãäģŽæŗį°åĸãŽããšã `PATH` å¤æ°ãŽ**å
é **ãĢé
įŊŽãããã¨ã§ããOSã¯åŠį¨å¯čŊãĒäģãŽPythonãčĻã¤ãããã**åãĢ**ãããŽäģŽæŗį°åĸãŽPythonãčĻã¤ãããããĢãĒããžããããŽãããĢããĻã `python` ãåŽčĄããã¨ããĢãäģ㎠`python` īŧäžãã°ã°ããŧããĢį°åĸ㎠`python` īŧã§ã¯ãĒãã**ããŽäģŽæŗį°åĸãŽ**PythonãäŊŋį¨ãããããĢãĒããžãã
+
+äģŽæŗį°åĸãæåšãĢããĻå¤æ´ããããã¨ã¯äģãĢããããžããããããæãéčĻãĒå¤æ´ãŽã˛ã¨ã¤ã§ãã
+
+## äģŽæŗį°åĸãŽįĸēčĒ
+
+äģŽæŗį°åĸãæåšããŠãããäžãã°æŦĄãŽãããĢįĸēčĒã§ããžããīŧ
+
+//// tab | Linux, macOS, Windows Bash
+
+
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+
+
+////
+
+//// tab | Windows PowerShell
+
+
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+
+
+////
+
+ããã¯ãäŊŋį¨ããã `python` ããã°ãŠã ã**ããŽäģŽæŗį°åĸãŽ**ããŽã§ãããã¨ãæåŗããžãã
+
+LinuxãmacOSã§ã¯ `which` ããWindows PowerShellã§ã¯ `Get-Command` ãäŊŋį¨ããžãã
+
+ããŽãŗããŗããŽåäŊã¯ã `PATH`å¤æ°ãĢč¨åŽããã**ãããããŽããšãé ãĢ**įĸēčĒããĻãããåŧã°ããĻãã `python` ããã°ãŠã ãæĸããžãããããĻãčĻã¤ããæŦĄįŦŦããŽããã°ãŠã ã¸ãŽ**ããšã襨į¤ēããžã**ã
+
+æãéčĻãĒãã¨ã¯ã `python` ãåŧã°ããã¨ããĢããžããĢããŽãŗããŗãã§įĸēčĒãã "`python`" ãåŽčĄããããã¨ã§ãã
+
+ããããĻãčĒåãæŗåŽéããŽäģŽæŗį°åĸãĢããããįĸēčĒã§ããžãã
+
+/// tip | čąįĨč
+
+ããäģŽæŗį°åĸãæåšãĢããããŽPythonãäŊŋį¨ãããžãž**äģãŽããã¸ã§ã¯ããĢį§ģåããĻ**ããžããã¨ã¯į°ĄåãĢčĩˇããåžãžãã
+
+ãããĻãããŽįŦŦäēãŽããã¸ã§ã¯ãã¯åäŊããĒãã§ãããããĒããĒãåĨãŽããã¸ã§ã¯ããŽäģŽæŗį°åĸãŽ**čĒ¤ãŖãPython**ãäŊŋį¨ããĻããããã§ãã
+
+ããŽããããŠãŽ `python` ãäŊŋį¨ãããĻãããŽãįĸēčĒã§ãããã¨ã¯åŊšįĢãĄãžããđ¤
+
+///
+
+## ãĒãäģŽæŗį°åĸãįĄåšåãããŽã
+
+äžãã°ã`philosophers-stone` īŧčŗĸč
ãŽįŗīŧã¨ããããã¸ã§ã¯ãã§äŊæĨãããĻããĻã**ããŽäģŽæŗį°åĸãæåšãĢã**ãåŋ
čĻãĒãããąãŧã¸ãã¤ãŗãšããŧãĢããĻããŽį°åĸå
ã§äŊæĨãé˛ããĻããã¨ããžãã
+
+ããããã**åĨãŽããã¸ã§ã¯ã**ã `prisoner-of-azkaban` īŧãĸãēãĢããŗãŽåäēēīŧãĢåãæãããã¨ããžãã
+
+ããŽããã¸ã§ã¯ãããŖãŦã¯ããĒã¸į§ģåããžãīŧ
+
+
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+```
+
+
+
+ãã `philosophers-stone` īŧčŗĸč
ãŽįŗīŧãŽäģŽæŗį°åĸãįĄåšåããĻããĒãã¨ã`python` ãåŽčĄããã¨ãã ãŋãŧãããĢ㯠`philosophers-stone` īŧčŗĸč
ãŽįŗīŧãŽPythonãäŊŋį¨ãããã¨ããžãã
+
+
+
+```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
+ import sirius
+```
+
+
+
+ããããããŽäģŽæŗį°åĸãįĄåšåãã `prisoner-of-azkaban` īŧãĸãēãĢããŗãŽåäēēīŧãŽãããŽæ°ããäģŽæŗį°åĸãæåšãĢããã°ã `python` ãåŽčĄããã¨ããĢ `prisoner-of-azkaban` īŧãĸãēãĢããŗãŽåäēēīŧãŽäģŽæŗį°åĸ㎠Python ãäŊŋį¨ããããããĢãĒããžãã
+
+
+
+```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 đē
+```
+
+
+
+## äģŖæŋææŽĩ
+
+ããã¯ãããããäģįĩãŋã**æ šæŦãã**åĻãļãããŽãˇãŗããĢãĒå
ĨéãŦã¤ãã§ãã
+
+äģŽæŗį°åĸããããąãŧã¸ãŽäžåéĸäŋīŧrequirementsīŧãããã¸ã§ã¯ããŽįŽĄįãĢã¯ãå¤ããŽ**äģŖæŋææŽĩ**ããããžãã
+
+æēåãæ´ãããããąãŧã¸ãŽäžåéĸäŋãäģŽæŗį°åĸãĒãŠ**ããã¸ã§ã¯ãå
¨äŊãŽįŽĄį**ããŧãĢãäŊŋãããã¨čããããuv ãčŠĻããĻãŋããã¨ãããããããžãã
+
+`uv` ã§ã¯äģĨä¸ãŽãããĒå¤ããŽãã¨ãã§ããžãīŧ
+
+* į°ãĒãããŧã¸ã§ãŗãåĢãã**Python ãŽã¤ãŗãšããŧãĢ**
+* ããã¸ã§ã¯ããã¨ãŽ**äģŽæŗį°åĸ**ãŽįŽĄį
+* **ãããąãŧã¸**ãŽã¤ãŗãšããŧãĢ
+* ããã¸ã§ã¯ããŽãããąãŧã¸ãŽ**äžåéĸäŋãããŧã¸ã§ãŗ**ãŽįŽĄį
+* ãããąãŧã¸ã¨ããŽããŧã¸ã§ãŗãŽãäžåéĸäŋãåĢãã**åŗå¯ãĒ**įĩãŋåãããäŋæãããããĢããŖãĻãæŦįĒį°åĸã§ãéįēį°åĸã¨å
¨ãåããããĢããã¸ã§ã¯ããåŽčĄã§ããīŧããã¯**locking**ã¨åŧã°ããžãīŧ
+* ããŽäģãŽããžããžãĒæŠčŊ
+
+## ãžã¨ã
+
+ãããžã§čĒãŋããšãĻįč§ŖãããĒããä¸éãŽå¤ããŽéįēč
ã¨æ¯ãšãĻãäģŽæŗį°åĸãĢã¤ããĻ**ããĒãã¯ããå¤ããŽãã¨ãįĨãŖãĻããžã**ãđ¤
+
+ããããŽčŠŗį´°ãįĨããã¨ã¯ãå°æĨãč¤éãĢčĻããäŊããŽãããã°ãĢããŖã¨åŊšįĢã¤ã§ããããããããããŽé ãĢã¯ãããĒãã¯**ããŽããšãĻãŽåäŊãæ šæŦãã**įč§ŖããĻããã§ããããđ
diff --git a/docs/ko/docs/advanced/events.md b/docs/ko/docs/advanced/events.md
index ae349e7be..5f8fe0f1e 100644
--- a/docs/ko/docs/advanced/events.md
+++ b/docs/ko/docs/advanced/events.md
@@ -1,53 +1,165 @@
-# ė´ë˛¤í¸: startupęŗŧ shutdown
+# Lifespan ė´ë˛¤í¸
-íėė ë°ëŧ ėėŠ íëĄęˇ¸ë¨ė´ ėėë기 ė ė´ë ėĸ
ëŖë ë ė¤íëë ė´ë˛¤í¸ í¸ë¤ëŦ(í¨ė)ëĨŧ ė ėí ė ėėĩëë¤.
+ė íëĻŦėŧė´ė
**ėė ė **ė ė¤íëė´ėŧ íë ëĄė§(ėŊë)ė ė ėí ė ėėĩëë¤. ė´ë ė´ ėŊëę° **í ë˛**ë§ ė¤íë늰, **ė íëĻŦėŧė´ė
ė´ ėė˛ė ë°ę¸° ėėí기 ė **ė ė¤íëë¤ë ė미ė
ëë¤.
-ė´ í¨ėë¤ė `async def` ëë íë˛íę˛ `def`ėŧëĄ ė ė¸í ė ėėĩëë¤.
+ë§ė°Ŧę°ė§ëĄ, ė íëĻŦėŧė´ė
ė´ **ėĸ
ëŖë ë** ė¤íëė´ėŧ íë ëĄė§(ėŊë)ė ė ėí ė ėėĩëë¤. ė´ ę˛Ŋė°, ė´ ėŊëë **í ë˛**ë§ ė¤íë늰, **ėŦëŦ ėė˛ė ė˛ëĻŦí í**ė ė¤íëŠëë¤.
+
+ė´ ėŊëę° ė íëĻŦėŧė´ė
ė´ **ėė˛ė ë°ę¸° ėėí기 ė ė** ė¤íëęŗ , ėė˛ ė˛ëĻŦę° ëë í **ėĸ
ëŖ ė§ė ė** ė¤íë기 ëëŦ¸ė ė ė˛´ ė íëĻŦėŧė´ė
ė **ėëĒ
(Lifespan)**ė ë¤ëŖšëë¤. (ė ė í "ėëĒ
"ė´ëŧë ë¨ė´ę° ė¤ėí´ė§ëë¤ đ)
+
+ė´ ë°Šë˛ė ė ė˛´ ė íëĻŦėŧė´ė
ėė ėŦėŠí´ėŧ íë **ėė**ė ė¤ė íęą°ë ėė˛ ę°ė **ęŗĩė ëë** ėėė ė¤ė íęŗ , ëë ꡸ íė **ė ëĻŦ**íë ë° ë§¤ė° ė ėŠí ė ėėĩëë¤. ėëĨŧ ë¤ė´, ë°ė´í°ë˛ ė´ė¤ ė°ę˛° í ëë ęŗĩė ëë 머ė ëŦë ëĒ¨ë¸ė ëĄëíë ę˛Ŋė°ė
ëë¤.
+
+
+## ėŦėŠ ėŦëĄ
+
+ë¨ŧė **ėŦėŠ ėŦëĄ**ëĨŧ ėëĄ ë¤ė´ëŗ´ęŗ , ė´ëĨŧ ė´ëģę˛ í´ę˛°í ė ėëė§ ė´í´ëŗ´ę˛ ėĩëë¤.
+
+ė°ëĻŦę° ėė˛ė ė˛ëĻŦí기 ėí´ ėŦėŠíęŗ ėļė **머ė ëŦë ëĒ¨ë¸**ė´ ėë¤ęŗ ėėí´ ë´
ėë¤. đ¤
+
+ė´ ëĒ¨ë¸ë¤ė ėė˛ ę°ė ęŗĩė ëë¯ëĄ, ėė˛ë§ë¤ ëĒ¨ë¸ė´ íëėŠ ėë ę˛ė´ ėëëŧ, ėŦëŦ ėė˛ėė ëėŧí ëĒ¨ë¸ė ėŦėŠíŠëë¤.
+
+ëĒ¨ë¸ė ëĄëíë ë° **ėëší ėę°ė´ 깸ëĻ°ë¤ęŗ ėėí´ ë´
ėë¤**, ėëí늴 ëĒ¨ë¸ė´ **ëė¤íŦėė ë§ė ë°ė´í°ëĨŧ ėŊė´ėŧ** í기 ëëŦ¸ė
ëë¤. ë°ëŧė ëĒ¨ë ėė˛ė ëí´ ëĒ¨ë¸ė ë§¤ë˛ ëĄëíęŗ ėļė§ ėėĩëë¤.
+
+ëĒ¨ë/íėŧė ėĩėėėė ëĒ¨ë¸ė ëĄëí ėë ėė§ë§, ꡸ëŦ늴 **ëĒ¨ë¸ė ëĄëíëë°** ėę°ė´ 깸ëĻŦ기 ëëŦ¸ė, ë¨ėí ėëíë í
ė¤í¸ëĨŧ ė¤íí ëë ëĒ¨ë¸ė´ ëĄëë ëęšė§ 기ë¤ë ¤ėŧ í´ė **í
ė¤í¸ ėëę° ëë ¤ė§ëë¤**.
+
+ė´ ëŦ¸ė ëĨŧ í´ę˛°íë ¤ęŗ íë ę˛ė
ëë¤. ėė˛ė ė˛ëĻŦí기 ė ė ëĒ¨ë¸ė ëĄëíë, ė íëĻŦėŧė´ė
ė´ ėė˛ė ë°ę¸° ėėí기 ė§ė ėë§ ëĄëíęŗ , ėŊëę° ëĄëëë ëėė ëĄëíė§ ėëëĄ íę˛ ėĩëë¤.
+
+## Lifespan
+
+`FastAPI` ė íëĻŦėŧė´ė
ė `lifespan` 매ę°ëŗėė "ėģ¨í
ė¤í¸ 매ëė "ëĨŧ ėŦėŠíėŦ *ėė*ęŗŧ *ėĸ
ëŖ* ëĄė§ė ė ėí ė ėėĩëë¤. (ėģ¨í
ė¤í¸ 매ëė ę° ëŦ´ėė¸ė§ ė ė íė ė¤ëĒ
ëëĻŦę˛ ėĩëë¤.)
+
+ėė ëĨŧ íĩí´ ėėíęŗ , ꡸ íė ėė¸í ė´í´ëŗ´ę˛ ėĩëë¤.
+
+ė°ëĻŦë `yield`ëĨŧ ėŦėŠíėŦ ëšë기 í¨ė `lifespan()`ė ë¤ėęŗŧ ę°ė´ ėėąíŠëë¤:
+
+{* ../../docs_src/events/tutorial003.py hl[16,19] *}
+
+ėŦ기ė ė°ëĻŦë ëĒ¨ë¸ė ëĄëíë ëšėŧ *ėė* ėė
ė ėëŽŦë ė´ė
íęŗ ėėĩëë¤. `yield` ėėė (ę°ė§) ëĒ¨ë¸ í¨ėëĨŧ 머ė ëŦë ëĒ¨ë¸ė´ ë´ę¸´ ëė
ëëĻŦė ëŖėĩëë¤. ė´ ėŊëë **ė íëĻŦėŧė´ė
ė´ ėė˛ė ë°ę¸° ėėí기 ė **, *ėė* ëėė ė¤íëŠëë¤.
+
+꡸ëĻŦęŗ `yield` ė§íėë ëĒ¨ë¸ė ė¸ëĄëíŠëë¤. ė´ ėŊëë **ė íëĻŦėŧė´ė
ė´ ėė˛ ė˛ëĻŦ ėëŖ í**, *ėĸ
ëŖ* ė§ė ė ė¤íëŠëë¤. ėëĨŧ ë¤ė´, ëŠëĒ¨ëĻŦë GPUė ę°ė ėėė í´ė íë ėė
ė í ė ėėĩëë¤.
+
+/// tip | í
+
+`shutdown`ė ė íëĻŦėŧė´ė
ė **ėĸ
ëŖ**í ë ë°ėíŠëë¤.
+
+ėëĄė´ ë˛ė ė ėėí´ėŧ íęą°ë, ꡸ëĨ ė¤íė ëŠėļęŗ ėļė ėë ėėĩëë¤. đ¤ˇ
+
+///
+
+### Lifespan í¨ė
+
+ë¨ŧė ėŖŧëĒŠí ė ė, `yield`ëĨŧ ėŦėŠíėŦ ëšë기 í¨ė(async function)ëĨŧ ė ėíęŗ ėë¤ë ę˛ė
ëë¤. ė´ë `yield`ëĨŧ ėŦėŠí ėėĄ´ėąęŗŧ 매ė° ė ėŦíŠëë¤.
+
+{* ../../docs_src/events/tutorial003.py hl[14:19] *}
+
+í¨ėė ė˛Ģ ë˛ė§¸ ëļëļ, ėĻ `yield` ė´ė ė ėŊëë ė íëĻŦėŧė´ė
ė´ ėėë기 **ė ė** ė¤íëŠëë¤.
+
+꡸ëĻŦęŗ `yield` ė´íė ëļëļė ė íëĻŦėŧė´ė
ė´ ėëŖë í **ëė¤ė** ė¤íëŠëë¤.
+
+### ëšë기 ėģ¨í
ė¤í¸ 매ëė
+
+í¨ėëĨŧ íė¸í´ëŗ´ëŠ´, `@asynccontextmanager`ëĄ ėĨėëė´ ėėĩëë¤.
+
+ė´ę˛ė í¨ėëĨŧ "**ëšë기 ėģ¨í
ė¤í¸ 매ëė **"ëŧęŗ ëļëĻŦë ę˛ėŧëĄ ëŗíėíĩëë¤.
+
+{* ../../docs_src/events/tutorial003.py hl[1,13] *}
+
+íė´ėŦėė **ėģ¨í
ė¤í¸ 매ëė **ë `with` ëŦ¸ėė ėŦėŠí ė ėë ę˛ė
ëë¤. ėëĨŧ ë¤ė´, `open()`ė ėģ¨í
ė¤í¸ 매ëė ëĄ ėŦėŠí ė ėėĩëë¤:
+
+```Python
+with open("file.txt") as file:
+ file.read()
+```
+ėĩęˇŧ ë˛ė ė íė´ėŦėėë **ëšë기 ėģ¨í
ė¤í¸ 매ëė **ë ėėĩëë¤. ė´ëĨŧ `async with`ė í¨ęģ ėŦėŠíŠëë¤:
+
+```Python
+async with lifespan(app):
+ await do_stuff()
+```
+
+ėģ¨í
ė¤í¸ 매ëė ë ėė ę°ė ëšë기 ėģ¨í
ė¤í¸ 매ëė ëĨŧ ë§ë¤ëŠ´, `with` ë¸ëĄė ë¤ė´ę°ę¸° ė ė `yield` ė´ė ė ėŊëę° ė¤íëęŗ , `with` ë¸ëĄė ë˛ė´ë íėë `yield` ė´íė ėŊëę° ė¤íëŠëë¤.
+
+ėė ėŊë ėė ėėë ė§ė ėŦėŠíė§ ėęŗ , FastAPIė ė ëŦíėŦ ėŦėŠíëëĄ íŠëë¤.
+
+`FastAPI` ė íëĻŦėŧė´ė
ė `lifespan` 매ę°ëŗėë **ëšë기 ėģ¨í
ė¤í¸ 매ëė **ëĨŧ ë°ę¸° ëëŦ¸ė, ėëĄė´ `lifespan` ëšë기 ėģ¨í
ė¤í¸ 매ëė ëĨŧ FastAPIė ė ëŦí ė ėėĩëë¤.
+
+{* ../../docs_src/events/tutorial003.py hl[22] *}
+
+## ëė˛´ ė´ë˛¤í¸ (ėŦėŠ ė¤ë¨)
/// warning | ę˛Ŋęŗ
-ė´ë˛¤í¸ í¸ë¤ëŦë ėŖŧ ėėŠ íëĄęˇ¸ë¨ėėë§ ėëíŠëë¤. [íė ėėŠ íëĄęˇ¸ë¨ - ë§ė´í¸](./sub-applications.md){.internal-link target=_blank}ėėë ėëíė§ ėėĩëë¤.
+*ėė*ęŗŧ *ėĸ
ëŖ*ëĨŧ ė˛ëĻŦíë ęļėĨ ë°Šë˛ė ėėė ė¤ëĒ
í ëëĄ `FastAPI` ė íëĻŦėŧė´ė
ė `lifespan` 매ę°ëŗėëĨŧ ėŦėŠíë ę˛ė
ëë¤. `lifespan` 매ę°ëŗėëĨŧ ė ęŗĩí늴 `startup`ęŗŧ `shutdown` ė´ë˛¤í¸ í¸ë¤ëŦë ë ė´ė í¸ėļëė§ ėėĩëë¤. `lifespan`ė ėŦėŠí ė§, ëĒ¨ë ė´ë˛¤í¸ëĨŧ ėŦėŠí ė§ ė íí´ėŧ í늰 ë ë¤ ėŦėŠí ėë ėėĩëë¤.
+
+ė´ ëļëļė ęą´ëë°ė
ë ėĸėĩëë¤.
///
-## `startup` ė´ë˛¤í¸
+*ėė*ęŗŧ *ėĸ
ëŖ* ëė ė¤íë ė´ ëĄė§ė ė ėíë ëė˛´ ë°Šë˛ė´ ėėĩëë¤.
+
+ė íëĻŦėŧė´ė
ė´ ėėë기 ė ė ëë ėĸ
ëŖë ë ė¤íí´ėŧ íë ė´ë˛¤í¸ í¸ë¤ëŦ(í¨ė)ëĨŧ ė ėí ė ėėĩëë¤.
-ėėŠ íëĄęˇ¸ë¨ė ėėí기 ė ė ė¤ííë ¤ë í¨ėëĨŧ "startup" ė´ë˛¤í¸ëĄ ė ė¸íŠëë¤:
+ė´ í¨ėë¤ė `async def` ëë ėŧë° `def`ëĄ ė ė¸í ė ėėĩëë¤.
+
+### `startup` ė´ë˛¤í¸
+
+ė íëĻŦėŧė´ė
ė´ ėėë기 ė ė ė¤íëė´ėŧ íë í¨ėëĨŧ ėļę°íë ¤ëŠ´, `"startup"` ė´ë˛¤í¸ëĄ ė ė¸íŠëë¤:
{* ../../docs_src/events/tutorial001.py hl[8] *}
-ė´ ę˛Ŋė° `startup` ė´ë˛¤í¸ í¸ë¤ëŦ í¨ėë ë¨ėí ëĒ ę°ė§ ę°ėŧëĄ ęĩŦėąë `dict` íėė "ë°ė´í°ë˛ ė´ė¤"ëĨŧ ė´ę¸°ííŠëë¤.
+ė´ ę˛Ŋė°, `startup` ė´ë˛¤í¸ í¸ë¤ëŦ í¨ėë "database"ëŧë íëĒŠ(ë¨ė§ `dict`)ė ėŧëļ ę°ėŧëĄ ė´ę¸°ííŠëë¤.
-íë ė´ėė ė´ë˛¤í¸ í¸ë¤ëŦ í¨ėëĨŧ ėļę°í ėë ėėĩëë¤.
+ėŦëŦ ę°ė ė´ë˛¤í¸ í¸ë¤ëŦ í¨ėëĨŧ ėļę°í ė ėėĩëë¤.
-꡸ëĻŦęŗ ėėŠ íëĄęˇ¸ë¨ė ëĒ¨ë `startup` ė´ë˛¤í¸ í¸ë¤ëŦę° ėëŖë ëęšė§ ėė˛ė ë°ė§ ėėĩëë¤.
+ė íëĻŦėŧė´ė
ė ëĒ¨ë `startup` ė´ë˛¤í¸ í¸ë¤ëŦę° ėëŖë ëęšė§ ėė˛ė ë°ę¸° ėėíė§ ėėĩëë¤.
-## `shutdown` ė´ë˛¤í¸
+### `shutdown` ė´ë˛¤í¸
-ėėŠ íëĄęˇ¸ë¨ė´ ėĸ
ëŖë ë ė¤ííë ¤ë í¨ėëĨŧ ėļę°íë ¤ëŠ´ `"shutdown"` ė´ë˛¤í¸ëĄ ė ė¸íŠëë¤:
+ė íëĻŦėŧė´ė
ė´ ėĸ
ëŖë ë ė¤íëė´ėŧ íë í¨ėëĨŧ ėļę°íë ¤ëŠ´, `"shutdown"` ė´ë˛¤í¸ëĄ ė ė¸íŠëë¤:
{* ../../docs_src/events/tutorial002.py hl[6] *}
-ė´ ėė ėė `shutdown` ė´ë˛¤í¸ í¸ë¤ëŦ í¨ėë `"Application shutdown"`ė´ëŧë í
ė¤í¸ę° ė í `log.txt` íėŧė ėļę°í ę˛ė
ëë¤.
+ėŦ기ė, `shutdown` ė´ë˛¤í¸ í¸ë¤ëŦ í¨ėë `"Application shutdown"`ė´ëŧë í
ė¤í¸ëĨŧ `log.txt` íėŧė 기ëĄíŠëë¤.
/// info | ė ëŗ´
-`open()` í¨ėėė `mode="a"`ë "ėļę°"ëĨŧ ė미íŠëë¤. ë°ëŧė ė´ë¯¸ ėĄ´ėŦíë íėŧė ë´ėŠė ëŽė´ė°ė§ ėęŗ ėëĄė´ ė¤ė ėļę°íŠëë¤.
+`open()` í¨ėėė `mode="a"`ë "ėļę°"ëĨŧ ė미íë¯ëĄ, íėŧė ėë 기ėĄ´ ë´ėŠė ëŽė´ė°ė§ ėęŗ ėëĄė´ ė¤ė´ ėļę°ëŠëë¤.
///
/// tip | í
-ė´ ėė ėėë íėŧęŗŧ ėí¸ėėŠ í기 ėí´ íė´ėŦ íė¤ í¨ėė¸ `open()`ė ėŦėŠíęŗ ėėĩëë¤.
+ė´ ę˛Ŋė°, ė°ëĻŦë íė¤ íė´ėŦ `open()` í¨ėëĨŧ ėŦėŠíėŦ íėŧęŗŧ ėí¸ėėŠíęŗ ėėĩëë¤.
-ë°ëŧė ëė¤íŦė ë°ė´í°ëĨŧ ė°ę¸° ėí´ "ë기"ę° íėí I/O (ė
ë Ĩ/ėļë Ĩ) ėė
ė ėííŠëë¤.
+ë°ëŧė I/O(ė
ėļë Ĩ) ėė
ė´ íŦí¨ëė´ ėė´ ëė¤íŦė 기ëĄëë ę˛ė "기ë¤ëĻŦë" ęŗŧė ė´ íėíŠëë¤.
-꡸ëŦë `open()`ė `async`ė `await`ė ėŦėŠíė§ ė기 ëëŦ¸ė ė´ë˛¤í¸ í¸ë¤ëŦ í¨ėë `async def`ę° ėë íė¤ `def`ëĄ ė ė¸íęŗ ėėĩëë¤.
+íė§ë§ `open()`ė `async`ė `await`ëĨŧ ėŦėŠíė§ ėėĩëë¤.
+
+꡸ëė ė°ëĻŦë ė´ë˛¤í¸ í¸ë¤ëŦ í¨ėëĨŧ `async def` ëė ėŧë° `def`ëĄ ė ė¸íŠëë¤.
///
+### `startup`ęŗŧ `shutdown`ė í¨ęģ ėŦėŠ
+
+*ėė*ęŗŧ *ėĸ
ëŖ* ëĄė§ė´ ė°ę˛°ë ę°ëĨėąė´ ëėĩëë¤. ėëĨŧ ë¤ė´, ëŦ´ė¸ę°ëĨŧ ėėí í ëë´ęą°ë, ėėė íëí í í´ė íë ëąė ėė
ė í ė ėėĩëë¤.
+
+ė´ëŦí ėė
ė ëŗëė í¨ėëĄ ė˛ëĻŦí늴 ėëĄ ëĄė§ė´ë ëŗėëĨŧ ęŗĩė íė§ ė기 ëëŦ¸ė ë ė´ë ¤ėė§ëë¤. ę°ë¤ė ė ė ëŗėė ė ėĨíęą°ë ëšėˇí í¸ëĻė ėŦėŠí´ėŧ í ė ėėĩëë¤.
+
+꡸ë 기 ëëŦ¸ė ėėė ė¤ëĒ
í ëëĄ `lifespan`ė ėŦėŠíë ę˛ė´ ęļėĨëŠëë¤.
+
+## 기ė ė ė¸ëļėŦí
+
+í¸ę¸°ėŦ ë§ė ëļë¤ė ėí 기ė ė ė¸ ė¸ëļėŦíė
ëë¤. đ¤
+
+ASGI 기ė ėŦėė ë°ëĨ´ëŠ´, ė´ë Lifespan Protocol ė ėŧëļė´ëŠ°, `startup`ęŗŧ `shutdown`ė´ëŧë ė´ë˛¤í¸ëĨŧ ė ėíŠëë¤.
+
/// info | ė ëŗ´
-ė´ë˛¤í¸ í¸ë¤ëŦė ę´í ë´ėŠė Starlette ė´ë˛¤í¸ ëŦ¸ė ėė ėļę°ëĄ íė¸í ė ėėĩëë¤.
+Starletteė `lifespan` í¸ë¤ëŦė ëí´ ë ėŊęŗ ėļë¤ëŠ´ Starletteė Lifespan ëŦ¸ė ėė íė¸í ė ėėĩëë¤.
+
+ė´ ëŦ¸ėėë ėŊëė ë¤ëĨ¸ ėėėė ėŦėŠí ė ėë lifespan ėíëĨŧ ė˛ëĻŦíë ë°Šë˛ë íŦí¨ëė´ ėėĩëë¤.
///
+
+## ėë¸ ė íëĻŦėŧė´ė
+
+đ¨ ė´ lifespan ė´ë˛¤í¸(`startup`ęŗŧ `shutdown`)ë ëŠė¸ ė íëĻŦėŧė´ė
ė ëí´ėë§ ė¤íë늰, [ėë¸ ė íëĻŦėŧė´ė
- Mounts](sub-applications.md){.internal-link target=_blank}ėë ė¤íëė§ ėėė ė ėíė¸ė.
diff --git a/docs/ko/docs/advanced/sub-applications.md b/docs/ko/docs/advanced/sub-applications.md
new file mode 100644
index 000000000..c5835de15
--- /dev/null
+++ b/docs/ko/docs/advanced/sub-applications.md
@@ -0,0 +1,67 @@
+# íė ėėŠíëĄęˇ¸ë¨ - ë§ė´í¸
+
+ë§ėŊ ę°ę°ė ë
ëĻŊė ė¸ OpenAPIė ëŦ¸ė UIëĨŧ ę°ë ë ę°ė ë
ëĻŊė ė¸ FastAPI ėėŠíëĄęˇ¸ë¨ė´ íėíë¤ëŠ´, ëŠė¸ ė´íëĻŦėŧė´ė
ė íë (ëë ꡸ ė´ėė) íė-ėėŠíëĄęˇ¸ë¨(ë¤)ė âë§ė´í¸"í´ė ėŦėŠí ė ėėĩëë¤.
+
+## **FastAPI** ėėŠíëĄęˇ¸ë¨ ë§ė´í¸
+
+âë§ė´í¸"ė´ë ėė í âë
ëĻŊė ė¸" ėėŠíëĄęˇ¸ë¨ė íšė ę˛ŊëĄė ėļę°íėŦ í´ëš íė ėėŠíëĄęˇ¸ë¨ėė ė ė¸ë *ę˛ŊëĄ ëė*ė íĩí´ í´ëš ę˛ŊëĄ ėëė ėë ëĒ¨ë ėė
ë¤ė ė˛ëĻŦí ė ėëëĄ íë ę˛ė ė미íŠëë¤.
+
+### ėĩėë¨ ėėŠíëĄęˇ¸ë¨
+
+ë¨ŧė , ëŠė¸, ėĩėë¨ė **FastAPI** ėėŠíëĄęˇ¸ë¨ęŗŧ ė´ę˛ė *ę˛ŊëĄ ëė*ė ėėąíŠëë¤:
+
+{* ../../docs_src/sub_applications/tutorial001.py hl[3, 6:8] *}
+
+### íė ėėŠíëĄęˇ¸ë¨
+
+ë¤ėėŧëĄ, íė ėėŠíëĄęˇ¸ë¨ęŗŧ ė´ę˛ė *ę˛ŊëĄ ëė*ė ėėąíŠëë¤:
+
+ė´ íė ėėŠíëĄęˇ¸ë¨ė ë ë¤ëĨ¸ íė¤ FastAPI ėėŠíëĄęˇ¸ë¨ė
ëë¤. ë¤ë§ ė´ę˛ė âë§ė´í¸âë ę˛ė
ëë¤:
+
+{* ../../docs_src/sub_applications/tutorial001.py hl[11, 14:16] *}
+
+### íė ėėŠíëĄęˇ¸ë¨ ë§ė´í¸
+
+ėĩėë¨ ėėŠíëĄęˇ¸ë¨, `app`ė íė ėėŠíëĄęˇ¸ë¨, `subapi`ëĨŧ ë§ė´í¸íŠëë¤.
+
+ė´ ėėėė, íė ėėŠíëĄęˇ¸ë¨ė
ė `/subapi` ę˛ŊëĄė ë§ė´í¸ ë ę˛ė
ëë¤:
+
+{* ../../docs_src/sub_applications/tutorial001.py hl[11, 19] *}
+
+### ėëėŧëĄ ėėąë API ëŦ¸ė íė¸
+
+ė´ė , `uvicorn`ėŧëĄ ëŠė¸ ėėŠíëĄęˇ¸ë¨ė ė¤ííėėė¤. ëšė ė íėŧė´ `main.py`ëŧ늴, ė´ë ę˛ ė¤ííŠëë¤:
+
+
+
+```console
+$ uvicorn main:app --reload
+
+INFO : Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+
+
+꡸ëĻŦęŗ http://127.0.0.1:8000/docs ėė ëŦ¸ėëĨŧ ėŦėėė¤.
+
+ëŠė¸ ėėŠíëĄęˇ¸ë¨ė *ę˛ŊëĄ ëė*ë§ė íŦí¨íë, ëŠė¸ ėėŠíëĄęˇ¸ë¨ė ëí ėë API ëŦ¸ėëĨŧ íė¸í ė ėėĩëë¤:
+
+http://127.0.0.1:8000/subapi/docs ėė íė ėėŠíëĄęˇ¸ë¨ė ëŦ¸ėëĨŧ ėŦėėė¤.
+
+íė ę˛ŊëĄ ė ëėŦ `/subapi` ėëė ė ė¸ë *ę˛ŊëĄ ëė* ė íŦí¨íë, íė ėėŠíëĄęˇ¸ë¨ė ëí ėë API ëŦ¸ėëĨŧ íė¸í ė ėėĩëë¤:
+
+`typing.Union` ė ėŦėŠí ė ėėĩëë¤:
+
+/// note | ė°¸ęŗ
+
+`Union` ė ė ėí ëë ë ęĩŦė˛´ė ė¸ íė
ė ë¨ŧė íŦí¨íęŗ , ë ęĩŦė˛´ė ė¸ íė
ė ꡸ ë¤ė ëė´í´ėŧíŠëë¤. ėë ėė ėėë `Union[PlaneItem, CarItem]` ëĨŧ ëŗ´ëŠ´, ë ęĩŦė˛´ė ė¸ `PlaneItem`ė´ `CarItem`ëŗ´ë¤ ėė ėėšíŠëë¤.
+
+///
+
+{* ../../docs_src/extra_models/tutorial003_py310.py hl[1,14:15,18:20,33] *}
+
+
+### Python 3.10ėė `Union`
+
+ėė ėė ėėë `response_model` ė¸ė ę°ėŧëĄ `Union[PlaneItem, CarItem]`ė ė ëŦíŠëë¤.
+
+ė´ ę˛Ŋė°, ė´ëĨŧ **íė
ė´ë
¸í
ė´ė
(type annotation)** ė´ ėë **ė¸ė ę°(argument value)** ėŧëĄ ė ëŦíęŗ ė기 ëëŦ¸ė Python 3.10ėėë `Union`ė ėŦėŠí´ėŧ íŠëë¤.
+
+ë§ėŊ íė
ė´ë
¸í
ė´ė
ė ėŦėŠíë¤ëŠ´, ë¤ėęŗŧ ę°ė´ ėė§ ë§ë(|)ëĨŧ ėŦėŠí ė ėėĩëë¤:
+
+```Python
+some_variable: PlaneItem | CarItem
+```
+
+íė§ë§ ė´ëĨŧ `response_model=PlaneItem | CarItem`ęŗŧ ę°ė´ í ëší늴 ėëŦę° ë°ėíŠëë¤. ė´ë Pythonė´ ė´ëĨŧ íė
ė´ë
¸í
ė´ė
ėŧëĄ í´ėíė§ ėęŗ , `PlaneItem`ęŗŧ `CarItem` ėŦė´ė **ėëĒģë ė°ė°(invalid operation)**ė ėëí기 ëëŦ¸ė
ëë¤
+
+## ëĒ¨ë¸ ëĻŦė¤í¸
+
+ë§ė°Ŧę°ė§ëĄ, ę°ė˛´ ëĻŦė¤í¸ ííė ėëĩė ė ė¸í ėë ėėĩëë¤.
+
+ė´ëĨŧ ėí´ íė¤ Pythonė `typing.List`ëĨŧ ėŦėŠíė¸ė(ëë Python 3.9 ė´ėėėë ë¨ėí `list`ëĨŧ ėŦėŠí ė ėėĩëë¤):
+
+{* ../../docs_src/extra_models/tutorial004_py39.py hl[18] *}
+
+
+## ėėė `dict` ėëĩ
+
+Pydantic ëĒ¨ë¸ė ėŦėŠíė§ ėęŗ , í¤ė ę°ė íė
ë§ ė ė¸íėŦ íë˛í ėėė `dict`ëĄ ėëĩė ė ė¸í ėë ėėĩëë¤.
+
+ė´ë Pydantic ëĒ¨ë¸ė íėí ė í¨í íë/ėėą ė´ëĻė ėŦė ė ė ė ėë ę˛Ŋė°ė ė ėŠíŠëë¤.
+
+ė´ ę˛Ŋė°, `typing.Dict`ëĨŧ ėŦėŠí ė ėėĩëë¤(ëë Python 3.9 ė´ėėėë ë¨ėí `dict`ëĨŧ ėŦėŠí ė ėėĩëë¤):
+
+{* ../../docs_src/extra_models/tutorial005_py39.py hl[6] *}
+
+
+## ėėŊ
+
+ėŦëŦ Pydantic ëĒ¨ë¸ė ėŦėŠíęŗ , ę° ę˛Ŋė°ė ë§ę˛ ėė ëĄę˛ ėėíė¸ė.
+
+ėí°í°ę° ėëĄ ë¤ëĨ¸ "ėí"ëĨŧ ę°ė ¸ėŧ íë ę˛Ŋė°, ėí°í°ëš ë¨ėŧ ë°ė´í° ëĒ¨ë¸ė ėŦėŠí íėë ėėĩëë¤. ėëĨŧ ë¤ė´, ėŦėŠė "ėí°í°"ę° `password`, `password_hash`, ëë ëšë°ë˛í¸ę° ėë ėíëĨŧ íŦí¨í ė ėë ę˛Ŋė°ė˛ëŧ ë§ė
ëë¤.
diff --git a/docs/ko/docs/virtual-environments.md b/docs/ko/docs/virtual-environments.md
new file mode 100644
index 000000000..0d10c3200
--- /dev/null
+++ b/docs/ko/docs/virtual-environments.md
@@ -0,0 +1,846 @@
+# ę°ė íę˛Ŋ
+
+Python íëĄė í¸ëĨŧ ėė
í ëë **ę°ė íę˛Ŋ** (ëë ė´ė ė ėŦí ëęĩŦ)ė ėŦėŠíë ę˛ė´ ėĸėĩëë¤. ę° íëĄė í¸ ë§ë¤ ė¤ėšíë í¨í¤ė§ëĨŧ ëļëĻŦíėŦ ę´ëĻŦí ė ėėĩëë¤.
+
+/// info | ė ëŗ´
+
+ė´ë¯¸ ę°ė íę˛Ŋė ëí´ ė ėęŗ ėë¤ëŠ´, ė´ ėšė
ė ęą´ë ë°ė´ë ę´ė°Žėĩëë¤. đ¤
+
+///
+
+/// tip | í
+
+**ę°ė íę˛Ŋ(Virtual Environment)** ė **íę˛Ŋ ëŗė(Environment Variable)** ė ë¤ëĻ
ëë¤.
+
+**íę˛Ŋ ëŗė**ë ėė¤í
ė ėĄ´ėŦí늰, íëĄęˇ¸ë¨ė´ ėŦėŠí ė ėë ëŗėė
ëë¤.
+
+**ę°ė íę˛Ŋ**ė ëĒëĒ íėŧëĄ ęĩŦėąë íëė ëë í°ëĻŦė
ëë¤.
+
+///
+
+/// info | ė ëŗ´
+
+ė´ íė´ė§ėėë **ę°ė íę˛Ŋ**ė ėŦėŠ ë°Šë˛ęŗŧ ėë ë°Šėė ė¤ëĒ
íŠëë¤.
+
+ë§ėŊ **ëĒ¨ë ę˛ė ę´ëĻŦí´ėŖŧë ëęĩŦ** (Python ė¤ėšęšė§ íŦí¨)ëĨŧ ėŦėŠíęŗ ėļë¤ëŠ´ uv ëĨŧ ėŦėŠí´ëŗ´ė¸ė.
+
+///
+
+## íëĄė í¸ ėėą
+
+ë¨ŧė , íëĄė í¸ëĨŧ ėí ëë í°ëĻŦëĨŧ íë ėėąíŠëë¤.
+
+ëŗ´íĩ ėŦėŠė í ëë í°ëĻŦ ėė `code`ëŧë ëë í°ëĻŦëĨŧ ë§ë¤ęŗ , ꡸ ėė íëĄė í¸ë§ë¤ íëėŠ ëë í°ëĻŦëĨŧ ë§ë¤ė´ ę´ëĻŦíŠëë¤.
+
+
+
+```console
+// í ëë í°ëĻŦëĄ ė´ë
+$ cd
+// ëĒ¨ë ėŊë íëĄė í¸ëĨŧ ėí ëë í°ëĻŦ ėėą
+$ mkdir code
+// code ëë í°ëĻŦëĄ ė´ë
+$ cd code
+// ė´ë˛ íëĄė í¸ëĨŧ ėí ëë í°ëĻŦ ėėą
+$ mkdir awesome-project
+// í´ëš íëĄė í¸ ëë í°ëĻŦëĄ ė´ë
+$ cd awesome-project
+```
+
+
+
+## ę°ė íę˛Ŋ ėėą
+
+Python íëĄė í¸ëĨŧ **ė˛ė ėėí ë**, ę°ė íę˛Ŋė **íëĄė í¸ ë´ëļ **ė ėėąíŠëë¤.
+
+/// tip | í
+
+ė´ ėė
ė **íëĄė í¸ëĨŧ ė˛ė ė¤ė í ë íë˛ë§** í´ėŖŧ늴 ëŠëë¤. ė´í ėė
í ë ë°ëŗĩí íėë ėėĩëë¤.
+
+///
+
+//// tab | `venv`
+
+Python íė¤ ëŧė´ë¸ëŦëĻŦė íŦí¨ë venv ëĒ¨ëė ėŦėŠí´ ę°ė íę˛Ŋė ėėąí ė ėėĩëë¤.
+
+
+
+```console
+$ python -m venv .venv
+```
+
+
+
+/// details | ëĒ
ë šė´ ėė¸ ė¤ëĒ
+
+* `python`: `python` íëĄęˇ¸ë¨ė ė¤ííŠëë¤.
+* `-m`: íšė ëĒ¨ëė ė¤íŦëĻŊí¸ė˛ëŧ ė¤ííŠëë¤. ëė ëĒ¨ëė ë°ëĄ ë¤ė ė§ė íŠëë¤.
+* `venv`: Python íė¤ ëŧė´ë¸ëŦëĻŦė íŦí¨ë `venv` ëĒ¨ëė ė¤ííŠëë¤.
+* `.venv`: ę°ė íę˛Ŋė `.venv` ëë í°ëĻŦė ėėąíŠëë¤.
+
+///
+
+////
+
+//// tab | `uv`
+
+`uv` ę° ė¤ėšëė´ ėë¤ëŠ´, uvëĨŧ íĩí´ ę°ė íę˛Ŋė ėėąí ė ėėĩëë¤.
+
+
+
+```console
+$ uv venv
+```
+
+
+
+/// tip | í
+
+`uv`ë 기ëŗ¸ė ėŧëĄ `.venv` ëë í°ëĻŦė ę°ė íę˛Ŋė ėėąíŠëë¤.
+
+ëŗëëĄ ëë í°ëĻŦ ė´ëĻė ėļę° ė¸ėëĄ ë겨 ėŖŧ늴 ę˛ŊëĄëĨŧ ė§ė í ė ėėĩëë¤.
+
+///
+
+////
+
+í´ëš ëĒ
ë šė´ë `.venv` ëë í°ëĻŦė ėëĄė´ ę°ė íę˛Ŋė ėėąíŠëë¤.
+
+/// details | `.venv` ëë ë¤ëĨ¸ ė´ëĻ
+
+ę°ė íę˛Ŋė ë¤ëĨ¸ ëë í°ëĻŦė ėėąí ėë ėė§ë§, ę´ëĄė ėŧëĄ `.venv` ëë í°ëĻŦ ė´ëĻė ėŦėŠíŠëë¤.
+
+///
+
+## ę°ė íę˛Ŋ íėąí
+
+ė´í ė¤ííë Python ëĒ
ë šė´ė í¨í¤ė§ ė¤ėšę° ę°ė íę˛Ŋė ë°ëĨ´ëëĄ, ę°ė íę˛Ŋė íėąííė¸ė.
+
+/// tip | í
+
+**í°ë¯¸ëė ėëĄ ė´ęŗ ** íëĄė í¸ ėė
ė ėėí ëë, **íė ė´ ėė
ė** í´ėŖŧė¸ė.
+
+///
+
+//// tab | Linux, macOS
+
+
+
+```console
+$ source .venv/bin/activate
+```
+
+
+
+////
+
+//// tab | Windows PowerShell
+
+
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+
+
+////
+
+//// tab | Windows Bash
+
+Windowsėė Bash(ė: Git Bash )ëĨŧ ėŦėŠíë ę˛Ŋė°:
+
+
+
+```console
+$ source .venv/Scripts/activate
+```
+
+
+
+////
+
+/// tip | í
+
+ę°ė íę˛Ŋė ėëĄė´ í¨í¤ė§ëĨŧ ė¤ėší ëë§ë¤, í´ëš íę˛Ŋė ë¤ė íėąííė¸ė.
+
+ė´ë ę˛ í늴 í´ëš í¨í¤ė§ëĄ ė¤ėšë **í°ë¯¸ë(CLI ) íëĄęˇ¸ë¨**ė ėŦėŠí ë, ė ėė ė¤ėšë ë¤ëĨ¸ ë˛ė ė´ ėëëŧ, ę°ė íę˛Ŋ ėė ė¤ėšë ė íí ë˛ė ė ėŦėŠíŠëë¤.
+
+///
+
+## ę°ė íę˛Ŋė´ íėąí ėŦëļ íė¸
+
+ę°ė íę˛Ŋė´ íėąíëėëė§ íė¸íŠëë¤. (ė´ė ëĒ
ë šė´ę° ė ëëĄ ėëíëė§ íė¸íŠëë¤).
+
+/// tip | í
+
+ė´ ë¨ęŗë **ė í ėŦí**ė´ė§ë§, ëĒ¨ë ę˛ė´ ėėëëĄ ėëíęŗ ėëė§, ꡸ëĻŦęŗ ėëí ę°ė íę˛Ŋė´ íėąí ëėë ė§ **íė¸**íë ėĸė ë°Šë˛ė
ëë¤.
+
+///
+
+//// tab | Linux, macOS, Windows Bash
+
+
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+
+
+`python` ėėšę° íëĄė í¸ ë´ëļ(ė´ ėėėėë `awesome-project`)ė `.venv/bin/python` ę˛ŊëĄëĄ íėëë¤ëŠ´ ėąęŗĩė
ëë¤. đ
+
+////
+
+//// tab | Windows PowerShell
+
+
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+
+
+`python` ėėšę° íëĄė í¸ ë´ëļ(ė´ ėėėėë `awesome-project`)ė `.venv\bin\python` ę˛ŊëĄëĄ íėëë¤ëŠ´ ėąęŗĩė
ëë¤. đ
+
+////
+
+## pip ė
꡸ë ė´ë
+
+/// tip | í
+
+`uv` ëĨŧ ėŦėŠíë¤ëŠ´, `pip` ëė `uv`ëĄ í¨í¤ė§ëĨŧ ė¤ėšíę˛ ëë¯ëĄ `pip`ė ė
꡸ë ė´ëí íėę° ėėĩëë¤. đ
+
+///
+
+`pip`ė ėŦėŠíėŦ í¨í¤ė§ëĨŧ ė¤ėšíë ę˛Ŋė° (Python íė¤ ëŧė´ë¸ëŦëĻŦė íŦí¨ëė´ ėėĩëë¤), **ėĩė ë˛ė ėŧëĄ ė
꡸ë ė´ë**íë ę˛ė´ ėĸėĩëë¤.
+
+í¨í¤ė§ ė¤ėš ė¤ ë°ėíë ë¤ėíęŗ íšė´í ėëŦë¤ė `pip` ė
꡸ë ė´ëëĄ ėŊę˛ í´ę˛°ëë ę˛Ŋė°ę° ë§ėĩëë¤.
+
+/// tip | í
+
+ė´ ėė
ė ëŗ´íĩ ę°ė íę˛Ŋė ėėąí **ė§í í ë˛ë§** í늴 ëŠëë¤.
+
+///
+
+ę°ė íę˛Ŋė´ íėąíë ėíė¸ė§ íė¸í í(ėė ė¤ëĒ
í ëĒ
ë šė´ ėŦėŠ), ėë ëĒ
ë šė´ëĨŧ ė¤ííė¸ė:
+
+
+
+```console
+$ python -m pip install --upgrade pip
+
+---> 100%
+```
+
+
+
+## `.gitignore` ėļę°í기
+
+**Git**ė ėŦėŠíęŗ ėë¤ëŠ´ (ėŦėŠíë ę˛ė´ ėĸėĩëë¤), `.gitignore` íėŧė ėļę°í´ė `.venv` ëë í°ëĻŦ ė ė˛´ëĨŧ Gitėė ė ė¸íė¸ė.
+
+/// tip | í
+
+`uv` ëĨŧ ėŦėŠí´ ę°ė íę˛Ŋė ėėąíë¤ëŠ´, ė´ë¯¸ ė´ ėė
ė´ ėëėŧëĄ ė˛ëĻŦëė´ ėėŧë¯ëĄ ė´ ë¨ęŗë ęą´ëë°ė´ë ëŠëë¤. đ
+
+///
+
+/// tip | í
+
+ė´ ėė
ë ë§ė°Ŧę°ė§ëĄ, ę°ė íę˛Ŋė ėėąí **ė§í í ë˛ë§** í늴 ëŠëë¤.
+
+///
+
+
+
+```console
+$ echo "*" > .venv/.gitignore
+```
+
+
+
+/// details | ëĒ
ë šė´ ėė¸ ė¤ëĒ
+
+* `echo "*"`: í°ë¯¸ëė `*` í
ė¤í¸ëĨŧ "ėļë Ĩ"íŠëë¤ (ë¤ė ė¤ëĒ
ėė ėĄ°ę¸ ë°ëëë¤)
+* `>`: ėŧėĒŊ ëĒ
ë šė´ė ėļë Ĩ ë´ėŠė í°ë¯¸ëė ėļë Ĩíė§ ėęŗ , ė¤ëĨ¸ėĒŊė ė§ė ë íėŧëĄ **기ëĄ(write)** íëŧë ė미ė
ëë¤.
+* `.gitignore`: ėļë Ĩë í
ė¤í¸ę° 기ëĄë íėŧ ė´ëĻė
ëë¤.
+
+꡸ëĻŦęŗ Gitėė `*`ë "ëĒ¨ë ę˛"ė ė미íŠëë¤. ë°ëŧė `.venv` ëë í°ëĻŦ ėė ëĒ¨ë ę˛ė ëŦ´ėíę˛ ëŠëë¤.
+
+ė´ ëĒ
ë šė´ë ë¤ėęŗŧ ę°ė ë´ėŠė ę°ė§ `.gitignore` íėŧė ėėąíŠëë¤:
+
+
+```gitignore
+*
+```
+
+///
+
+## í¨í¤ė§ ė¤ėš
+
+ę°ė íę˛Ŋė íėąíí í, ꡸ ėė íėí í¨í¤ė§ë¤ė ė¤ėší ė ėėĩëë¤.
+
+/// tip | í
+
+íëĄė í¸ėė íėí í¨í¤ė§ëĨŧ ė¤ėšíęą°ë ė
꡸ë ė´ëí ëë ė´ ėė
ė **í ë˛ë§** í늴 ëŠëë¤.
+
+ë§ėŊ íšė í¨í¤ė§ė ë˛ė ė ė
꡸ë ė´ëíęą°ë, ėëĄė´ í¨í¤ė§ëĨŧ ėļę°í íėę° ė기늴 **ë¤ė ė´ ėė
ė ë°ëŗĩ**í늴 ëŠëë¤.
+
+///
+
+### í¨í¤ė§ ė§ė ė¤ėš
+
+ę¸íę˛ ėė
íęą°ë, íëĄė í¸ė íėí í¨í¤ė§ ëĒŠëĄė ë°ëĄ íėŧëĄ ę´ëĻŦíęŗ ėļė§ ėė ę˛Ŋė°, í¨í¤ė§ëĨŧ ė§ė ė¤ėší ėë ėėĩëë¤.
+
+/// tip | í
+
+í¨í¤ė§ ė´ëĻęŗŧ ë˛ė ė ëŗ´ëĨŧ íėŧė ė ëĻŦí´ëë ę˛(ė: `requirements.txt` ëë `pyproject.toml`)ė (매ė°) ėĸė ėę°ė
ëë¤.
+
+///
+
+//// tab | `pip`
+
+
+
+```console
+$ pip install "fastapi[standard]"
+
+---> 100%
+```
+
+
+
+////
+
+//// tab | `uv`
+
+`uv` ëĨŧ ėŦėŠíë ę˛Ŋė°:
+
+
+
+```console
+$ uv pip install "fastapi[standard]"
+---> 100%
+```
+
+
+
+////
+
+### `requirements.txt`ėė ė¤ėš
+
+`requirements.txt` íėŧė´ ėë¤ëŠ´, ꡸ ėė ëĒ
ėë í¨í¤ė§ë¤ė í ë˛ė ė¤ėší ė ėėĩëë¤.
+
+//// tab | `pip`
+
+
+
+```console
+$ pip install -r requirements.txt
+---> 100%
+```
+
+
+
+////
+
+//// tab | `uv`
+
+`uv` ëĨŧ ėŦėŠíë ę˛Ŋė°:
+
+
+
+```console
+$ uv pip install -r requirements.txt
+---> 100%
+```
+
+
+
+////
+
+/// details | `requirements.txt`
+
+ë¤ėė ëĒ ę°ė§ í¨í¤ė§ëĨŧ íŦí¨í `requirements.txt`ė ėėė
ëë¤:
+
+```requirements.txt
+fastapi[standard]==0.113.0
+pydantic==2.8.0
+```
+
+///
+
+## íëĄęˇ¸ë¨ ė¤í
+
+ę°ė íę˛Ŋė íėąíí íėë íëĄęˇ¸ë¨ė ė¤íí ė ėėĩëë¤. ė´ë í´ëš ę°ė íę˛Ŋė ė¤ėšë Pythonęŗŧ í¨í¤ė§ë¤ė´ ėŦėŠëŠëë¤.
+
+
+
+```console
+$ python main.py
+
+Hello World
+```
+
+
+
+## ėëí° ė¤ė
+
+ėëí°ëĨŧ ėŦėŠí ę˛Ŋė°, ėė ë§ë ę°ė íę˛Ŋė ėŦėŠíëëĄ ė¤ė íë ę˛ė´ ėĸėĩëë¤. (ëëļëļė ėëí°ë ėëėŧëĄ ę°ė§í기ë íŠëë¤.)
+ė´ë ę˛ í늴 ėë ėėą 기ëĨė´ë ėŊë ë´ ė¤ëĨ íė 기ëĨė ė ëëĄ ėŦėŠí ė ėėĩëë¤.
+
+ėė:
+
+* VS Code
+* PyCharm
+
+/// tip | í
+
+ė´ ė¤ė ė ëŗ´íĩ ę°ė íę˛Ŋė **ė˛ė ë§ë¤ėė ë í ë˛ë§** í´ėŖŧ늴 ëŠëë¤.
+
+///
+
+## ę°ė íę˛Ŋ ëšíėąí
+
+íëĄė í¸ ėė
ė´ ëëŦë¤ëŠ´, ę°ė íę˛Ŋė **ëšíėąí**í ė ėėĩëë¤.
+
+
+
+```console
+$ deactivate
+```
+
+
+
+ė´ë ę˛ í늴 ė´íė `python` ëĒ
ë šė´ëĨŧ ė¤ííė ë, ę°ė íę˛Ŋė Pythonė´ë ꡸ ėė ė¤ėšë í¨í¤ė§ë¤ė ėŦėŠíė§ ėę˛ ëŠëë¤.
+
+## ė´ė ėė
í ė¤ëšę° ëėėĩëë¤
+
+ė´ė íëĄė í¸ ėė
ė ėėí ė¤ëšę° ėëŖëėėĩëë¤.
+
+
+/// tip | í
+
+ė ë´ėŠė ë ęšė´ ė´í´íęŗ ėļėŧė ę°ė?
+
+꡸ë ë¤ëŠ´ ęŗė ėŊė´ ėŖŧė¸ė. đđ¤
+
+///
+
+## ę°ė íę˛Ŋė ė ėŦėŠíëę°
+
+FastAPIëĨŧ ėŦėŠíë ¤ëŠ´ ë¨ŧė Python ė ė¤ėší´ėŧ íŠëë¤.
+
+꡸ íėë FastAPIė í¨ęģ ėŦėŠí **기í í¨í¤ė§ë¤**ė **ė¤ėš**í´ėŧ íŠëë¤.
+
+í¨í¤ė§ëĨŧ ė¤ėší ë ëŗ´íĩ Pythonė 기ëŗ¸ íŦí¨ë `pip` ëĒ
ë šė´(ëë ė ėŦí ëęĩŦ)ëĨŧ ėŦėŠíŠëë¤.
+
+íė§ë§ `pip`ė ꡸ëĨ ė§ė ėŦėŠí늴, í´ëš í¨í¤ė§ë¤ė **ė ė Python íę˛Ŋ**(ėė¤í
ė ė˛´ė ė¤ėšë Python)ė ė¤ėšëŠëë¤.
+
+### ëŦ¸ė ė
+
+꡸ë ë¤ëŠ´, ė ė Python íę˛Ŋė í¨í¤ė§ëĨŧ ė¤ėší늴 ė´ë¤ ëŦ¸ė ę° ë°ėí ęšė?
+
+ė´ë ėė ė´ ë늴, **ėëĄ ë¤ëĨ¸ í¨í¤ė§ë¤**ė ėėĄ´íë ėŦëŦ ę°ė íëĄęˇ¸ë¨ė ėėąíę˛ ë ę˛ė
ëë¤. ꡸ëĻŦęŗ ė´ë¤ ė¤ ėŧëļë **ę°ė í¨í¤ė§ė ėëĄ ë¤ëĨ¸ ë˛ė **ė íėëĄ í ė ėėĩëë¤. đą
+
+ėëĨŧ ë¤ė´, `ë§ë˛ėŦė ë(philosophers-stone)` íëĄė í¸ëĨŧ ë§ë¤ėë¤ęŗ ę°ė í´ë´
ėë¤. ė´ íëĄęˇ¸ë¨ė `í´ëĻŦ íŦí°(harry)`ëŧë í¨í¤ė§ė `v1` ë˛ė ė **ėėĄ´**íŠëë¤. ë°ëŧė `harry`ëĨŧ ė¤ėší´ėŧ íŠëë¤.
+
+```mermaid
+flowchart LR
+ stone(philosophers-stone) -->|requires| harry-1[harry v1]
+```
+
+꡸ë°ë° ëė¤ė `ėėĻėš´ë°ė ėŖė(prisoner-of-azkaban)`ė´ëŧë ë ë¤ëĨ¸ íëĄė í¸ëĨŧ ë§ë¤ę˛ ëėęŗ , ė´ íëĄė í¸ë ėė `harry` í¨í¤ė§ëĨŧ ėŦėŠíŠëë¤. ꡸ë°ë° ė´ íëĄė í¸ë `harry`ė `v3` ë˛ė ė´ íėíŠëë¤.
+
+```mermaid
+flowchart LR
+ azkaban(prisoner-of-azkaban) --> |requires| harry-3[harry v3]
+```
+
+íė§ë§ ė´ė ëŦ¸ė ę° ėęšëë¤. ëĄėģŦ ę°ė íę˛Ŋ ëė ė ė ė íę˛Ŋė í¨í¤ė§ëĨŧ ė¤ėšíę˛ ë늴, ė´ë¤ ë˛ė ė `harry`ëĨŧ ė¤ėší ė§ëĨŧ ė íí´ėŧ í기 ëëŦ¸ė
ëë¤.
+
+ėëĨŧ ë¤ė´, `ë§ë˛ėŦė ë(philosophers-stone)`ė ė¤ííęŗ ėļë¤ëŠ´ ë¨ŧė `harry` `v1` ë˛ė ė ë¤ėęŗŧ ę°ė´ ė¤ėš í´ėŧ íŠëë¤:
+
+
+
+```console
+$ pip install "harry==1"
+```
+
+
+
+꡸ëŦ늴 결ęĩ ė ė Python íę˛Ŋėë `harry` `v1`ë˛ė ė´ ė¤ėšë ėíę° ëŠëë¤.
+
+```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
+```
+
+íė§ë§ ė´ė `ėėĻėš´ë°ė ėŖė(prisoner-of-azkaban)`ė ė¤ííęŗ ėļë¤ëŠ´, `harry` `v1`ë˛ė ė ė ęą°íęŗ `harry` `v3`ë˛ė ė ė¤ėší´ėŧ íŠëë¤. (ëë ë¨ėí `v3`ë˛ė ė ė¤ėšíë ę˛ë§ėŧëĄë 기ėĄ´ė `v1`ë˛ė ė´ ėëėŧëĄ ė ęą°ëŠëë¤.)
+
+
+
+```console
+$ pip install "harry==3"
+```
+
+
+
+꡸ë ę˛ í늴 ė´ė ė ė Python íę˛Ŋėë `harry` `v3`ë˛ė ė´ ė¤ėšë ėíę° ëŠëë¤.
+
+꡸ëĻŦęŗ ë¤ė `ë§ë˛ėŦė ë(philosophers-stone)`ė ė¤ííë ¤ęŗ í늴, **ėëíė§** ėė ė ėėĩëë¤. ėëí늴 ė´ íëĄęˇ¸ë¨ė `harry` `v1`ë˛ė ė íėëĄ í기 ëëŦ¸ė
ëë¤.
+
+```mermaid
+flowchart LR
+ subgraph global[global env]
+ harry-1[harry v1 ]
+ 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 | í
+
+Python í¨í¤ė§ë¤ė **ė ë˛ė **ėė **í¸íėą ëŦ¸ė (breaking changes)**ę° ë°ėíė§ ėëëĄ ėĩëí ë
¸ë Ĩíë ę˛ė´ ėŧë°ė ė
ëë¤. íė§ë§ ꡸ëë ėė íę˛ ėė
íë ¤ëŠ´, í
ė¤í¸ëĨŧ ė¤íí´ëŗ´ëŠ´ė ė ë˛ė ė ėëė ėŧëĄ ė¤ėšíë ę˛ė´ ėĸėĩëë¤.
+
+///
+
+ė´ė , ė´ë° ėŧė´ ėŦëŦëļė **ëĒ¨ë íëĄė í¸**ę° ėŦėŠíë **ėë§ė í¨í¤ė§ë¤**ėė ëėė ë°ėíë¤ęŗ ėėí´ëŗ´ė¸ė. ė´ë 매ė° ę´ëĻŦí기 ė´ë ¤ė°ëŠ°, 결ęĩ **ėëĄ í¸íëė§ ėë ë˛ė **ė í¨í¤ė§ëĄ íëĄė í¸ëĨŧ ė¤ííę˛ ë ę°ëĨėąė´ ëęŗ , ęˇ¸ëĄ ė¸í´ ė´ë¤ ëŦ¸ė ę° ė ë°ėíëė§ ė ė ėę˛ ë ė ėėĩëë¤.
+
+ëí ėŦėŠíë ė´ėė˛´ė (Linux, Windows, macOS ëą)ė ë°ëŧ Pythonė´ **미ëĻŦ ė¤ėšëė´ ėė ėë** ėėĩëë¤. ė´ë° ę˛Ŋė°ėë ė´ėė˛´ė ė ëėė íėí íšė ë˛ė ė í¨í¤ė§ë¤ė´ í¨ęģ ė¤ėšëė´ ėė ė ėėĩëë¤. ė´ ėíėė ė ė Python íę˛Ŋė ėėė í¨í¤ė§ëĨŧ ė¤ėší늴, ė´ėė˛´ė ė íŦí¨ë íëĄęˇ¸ë¨ ėŧëļę° **ꚨė§ ėí**ë ėėĩëë¤.
+
+## í¨í¤ė§ë¤ė ė´ëė ė¤ėšëëę°
+
+Pythonė ė¤ėší늴, ėģ´í¨í°ė ėŦëŦ ëë í°ëĻŦė íėŧë¤ė´ ėėąëŠëë¤.
+
+ė´ ė¤ ėŧëļ ëë í°ëĻŦë ėŦėŠėę° ė¤ėší í¨í¤ė§ë¤ė ëŗ´ę´íë ėí ė íŠëë¤.
+
+ėëĨŧ ë¤ė´, ėë ëĒ
ë šė´ëĨŧ ė¤íí늴:
+
+
+
+```console
+// ė§ę¸ ė¤ííė§ ėėë ëŠëë¤, ꡸ëĨ ėė ėŧ ëŋė´ėė đ¤
+$ pip install "fastapi[standard]"
+---> 100%
+```
+
+
+
+í´ëš ëĒ
ë šė´ë FastAPI ėŊëëĨŧ íŦí¨í ėėļ íėŧė ë¤ė´ëĄëíŠëë¤. ė´ íėŧė ëŗ´íĩ PyPI ėė ë°ėėĩëë¤.
+
+ëí FastAPIę° ėėĄ´íë ë¤ëĨ¸ í¨í¤ė§ë¤ë í¨ęģ **ë¤ė´ëĄë**ëŠëë¤.
+
+꡸ëĻŦęŗ ꡸ ëĒ¨ë íėŧë¤ė **ėėļ í´ė **í ë¤, ėģ´í¨í°ė íšė ëë í°ëĻŦė ė ėĨíŠëë¤.
+
+기ëŗ¸ė ėŧëĄ ė´ íėŧë¤ė Pythonė´ ė¤ėšë ëë í°ëĻŦ ė, ėĻ **ė ė íę˛Ŋ**ė ë´ė ëë í°ëĻŦė ė ėĨëŠëë¤.
+
+## ę°ė íę˛Ŋė´ë
+
+ė ė íę˛Ŋė ëĒ¨ë í¨í¤ė§ëĨŧ ė¤ėší늴ė ë°ėíë ëŦ¸ė ė ëí í´ę˛°ėą
ė, ėė
íë **ę° íëĄė í¸ë§ë¤ ę°ė íę˛Ŋ**ė ėŦėŠíë ę˛ė
ëë¤.
+
+ę°ė íę˛Ŋė ė ė íę˛Ŋęŗŧ 매ė° ė ėŦí íëė **ëë í°ëĻŦ**ė´ëŠ°, ꡸ ėė í´ëš íëĄė í¸ëĨŧ ėí í¨í¤ė§ë¤ė ė¤ėší ė ėėĩëë¤.
+
+ė´ë ę˛ í늴 ę° íëĄė í¸ë ėė˛´ė ė¸ ę°ė íę˛Ŋ(`.venv` ëë í°ëĻŦ)ė ę°ė§ę˛ ë늰, ꡸ ėė í´ëš íëĄė í¸ ė ėŠ í¨í¤ė§ë¤ė ëŗ´ė íę˛ ëŠëë¤.
+
+
+```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
+```
+
+## ę°ė íę˛Ŋ íėąí ė미
+
+ę°ė íę˛Ŋė íėąííë¤ë ę˛ė, ėëĨŧ ë¤ė´ ë¤ėęŗŧ ę°ė ëĒ
ë šė´ëĨŧ ė¤ííë ę˛ė ė미íŠëë¤:
+
+//// tab | Linux, macOS
+
+
+
+```console
+$ source .venv/bin/activate
+```
+
+
+
+////
+
+//// tab | Windows PowerShell
+
+
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+
+
+////
+
+//// tab | Windows Bash
+
+Windowsėė Bash(ė: Git Bash )ëĨŧ ėŦėŠíë ę˛Ŋė°:
+
+
+
+```console
+$ source .venv/Scripts/activate
+```
+
+
+
+////
+
+ė´ ëĒ
ë šė´ë ė´íė ė¤íë ëĒ
ë šė´ėė ėŦėŠë [íę˛Ŋ ëŗė](environment-variables.md){.internal-link target=_blank} ëĒ ę°ëĨŧ ėėąíęą°ë ėė íŠëë¤.
+
+ė´ ëŗėë¤ ė¤ íëę° ë°ëĄ `PATH` ëŗėė
ëë¤.
+
+/// tip | í
+
+`PATH` íę˛Ŋ ëŗėė ëí´ ë ėęŗ ėļë¤ëŠ´ [íę˛Ŋ ëŗė ëŦ¸ėė PATH íę˛Ŋ ëŗė ėšė
](environment-variables.md#path-environment-variable){.internal-link target=_blank}ė ė°¸ęŗ íė¸ė.
+
+///
+
+ę°ė íę˛Ŋė íėąíí늴, ę°ė íę˛Ŋė ę˛ŊëĄė¸ `.venv/bin` (Linuxė macOS) ëë `.venv\Scripts`(Windows)ëĨŧ `PATH` íę˛Ŋ ëŗėė ėļę°ëŠëë¤.
+
+ėëĨŧ ë¤ė´, ę°ė íę˛Ŋė íėąíí기 ė ė `PATH` ëŗėë ë¤ėęŗŧ ę°ėë¤ęŗ ę°ė í´ë´
ėë¤:
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+ėė¤í
ė ë¤ė ę˛ŊëĄë¤ėė íëĄęˇ¸ë¨ė ė°žę˛ ëŠëë¤:
+
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Windows\System32
+```
+
+ėė¤í
ė ë¤ė ę˛ŊëĄë¤ėė íëĄęˇ¸ë¨ė ė°žę˛ ëŠëë¤:
+
+* `C:\Windows\System32`
+
+////
+
+ę°ė íę˛Ŋė íėąíí íėë, `PATH` ëŗėë ë¤ėęŗŧ ę°ė ííę° ëŠëë¤:
+
+//// tab | Linux, macOS
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+ėė¤í
ė ę°ėĨ ë¨ŧė ë¤ė ę˛ŊëĄėė íëĄęˇ¸ë¨ė ė°žę¸° ėėíŠëë¤:
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin
+```
+
+꡸ íė ë¤ëĨ¸ ëë í°ëĻŦë¤ė íėíŠëë¤.
+
+ë°ëŧė í°ë¯¸ëė `python`ė ė
ë Ĩí늴, ėė¤í
ė ë¤ė ėėšė ėë Python íëĄęˇ¸ë¨ė ė°žę˛ ëŠëë¤:
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+꡸ëĻŦęŗ í´ëš Pythonė ėŦėŠíę˛ ëŠëë¤.
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts;C:\Windows\System32
+```
+
+ėė¤í
ė ę°ėĨ ë¨ŧė ë¤ė ę˛ŊëĄėė íëĄęˇ¸ë¨ė ė°žę¸° ėėíŠëë¤:
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts
+```
+
+꡸ íė ë¤ëĨ¸ ëë í°ëĻŦë¤ė íėíŠëë¤.
+
+ë°ëŧė í°ë¯¸ëė `python`ė ė
ë Ĩí늴, ėė¤í
ė ë¤ė ę˛ŊëĄė ėë Python íëĄęˇ¸ë¨ė ė°žę˛ ëŠëë¤:
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+꡸ëĻŦęŗ í´ëš Pythonė ėŦėŠíę˛ ëŠëë¤.
+
+////
+
+ė¤ėí ė¸ëļ ėŦí ė¤ íëë, ę°ė íę˛Ŋė ę˛ŊëĄę° `PATH` ëŗėė ę°ėĨ **ė**ė ėļę°ëë¤ë ė ė
ëë¤. ėė¤í
ė ėŦėŠ ę°ëĨí ë¤ëĨ¸ Pythonë¤ëŗ´ë¤ **ë¨ŧė ** ė´ ę˛ŊëĄëĨŧ ė°žėĩëë¤. ꡸ëė í°ë¯¸ëėė `python`ė ė¤íí늴, ė ė íę˛Ŋė Pythonė´ ėë **ę°ė íę˛Ŋė ėë** Pythonė´ ėŦėŠëŠëë¤. (ė: ė ė íę˛Ŋė ė¤ėšë `python`ė´ ėëëŧë ꡸ëŗ´ë¤ ė°ė íŠëë¤.)
+
+ę°ė íę˛Ŋė íėąíí늴 ė´ ė¸ėë ëĒ ę°ė§ ë¤ëĨ¸ ę˛ë¤ė´ ëŗę˛Ŋëė§ë§, ė´ë ꡸ė¤ėėë ę°ėĨ ė¤ėí ëŗí ė¤ íëė
ëë¤.
+
+## ę°ė íę˛Ŋ íė¸í기
+
+ę°ė íę˛Ŋė´ íėąí ëėëė§ íė¸íë ¤ëŠ´, ėë ëĒ
ë šė´ëĨŧ ėŦėŠí ė ėėĩëë¤:
+
+//// tab | Linux, macOS, Windows Bash
+
+
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+
+
+////
+
+//// tab | Windows PowerShell
+
+
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+
+
+////
+
+ėĻ, íėŦ ėŦėŠëë `python` íëĄęˇ¸ë¨ė **ę°ė íę˛Ŋ ë´ëļė ėë ę˛**ė
ëë¤.
+
+Linuxė macOSėėë `which`, Windows PowerShellėėë `Get-Command` ëĒ
ë šė´ëĨŧ ėŦėŠíŠëë¤.
+
+ė´ ëĒ
ë šė´ë `PATH` íę˛Ŋ ëŗėė ė§ė ë ę˛ŊëĄë¤ė **ėėëëĄ íė**í늴ė `python`ė´ëŧë ė´ëĻė íëĄęˇ¸ë¨ė ė°žėĩëë¤.
+ė°žë ėĻė, í´ëš íëĄęˇ¸ë¨ė **ę˛ŊëĄëĨŧ ėļë Ĩ**íŠëë¤.
+
+ė¤ėí ė ė í°ë¯¸ëėė `python`ė ė¤ííė ë, ė¤ė ëĄ ė¤íëë "`python`"ė´ ė´ë¤ ę˛ė¸ė§ ė íí ė ė ėë¤ë ę˛ė
ëë¤.
+
+ë°ëŧė íėŦ ėŦë°ëĨ¸ ę°ė íę˛Ŋė ėëė§ íė¸í ė ėėĩëë¤.
+
+/// tip | í
+
+íëė ę°ė íę˛Ŋė íėąíí ë¤, í´ëš Pythonė ę°ė§ ėíėė **ë ë¤ëĨ¸ íëĄė í¸**ëĄ ė´ëíë ę˛ė íí ë°ėíŠëë¤.
+
+íė§ë§ ė´ë ė´ė íëĄė í¸ė ę°ė íę˛Ŋė ėë **ėëĒģë Python ė¤í íėŧ**ė ėŦėŠíę˛ ëė´ ė íëĄė í¸ę° **ė ė ėëíė§ ėė ė ėėĩëë¤.**
+
+꡸ëė íėŦ ė´ë¤ `python`ė´ ėŦėŠëęŗ ėëė§ íė¸í ė ėë ëĨë Ĩė 매ė° ė ėŠíŠëë¤. đ¤
+
+///
+
+## ę°ė íę˛Ŋė ëšíėąííë ė´ė
+
+ėëĨŧ ë¤ė´ `ë§ë˛ėŦė ë(philosophers-stone)`ė´ëŧë íëĄė í¸ėė ėė
ė¤ė´ëŧęŗ í´ëŗ´ę˛ ėĩëë¤. ė´ë í´ëš **ę°ė íę˛Ŋė íėąí**íęŗ , íėí í¨í¤ė§ëĨŧ ė¤ėší늰 ėė
ė ė§ííŠëë¤.
+
+꡸ë°ë° ė´ė ë **ë¤ëĨ¸ íëĄė í¸**ė¸ `ėėĻėš´ë°ė ėŖė(prisoner-of-azkaban)`ė ėė
íęŗ ėļė´ėĄėĩëë¤.
+
+꡸ëė ꡸ íëĄė í¸ ëë í°ëĻŦëĄ ė´ëíŠëë¤:
+
+
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+```
+
+
+
+ë§ėŊ `ë§ë˛ėŦė ë(philosophers-stone)`ė ę°ė íę˛Ŋė ëšíėąííė§ ėėë¤ëŠ´, í°ë¯¸ëėė `python`ė ė¤íí ë ėŦė í `ë§ë˛ėŦė ë(philosophers-stone)` ę°ė íę˛Ŋė Pythonė ėŦėŠíę˛ ëŠëë¤.
+
+
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+
+$ python main.py
+
+// siriusëĨŧ ėíŦí¸íë ë° ė¤í¨íėĩëë¤. ė¤ėšëė´ ėė§ ėėė đą
+Traceback (most recent call last):
+ File "main.py", line 1, in
+ import sirius
+```
+
+
+
+íė§ë§ `ë§ë˛ėŦė ë(philosophers-stone)`ė ę°ė íę˛Ŋė ëšíėąíí ë¤ė, `ėėĻėš´ë°ė ėŖė(prisoner-of-azkaban)` íëĄė í¸ė ę°ė íę˛Ŋė íėąíí늴, ė´ė `python` ëĒ
ë šė´ë `ėėĻėš´ë°ė ėŖė(prisoner-of-azkaban)` ę°ė íę˛Ŋė Pythonė ėŦėŠíę˛ ëŠëë¤.
+
+
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+
+// ė´ė ëë í°ëĻŦė ėė íė ėė´, ė´ëėë ę°ė íę˛Ŋė ëšíėąíí ė ėėĩëë¤. ë¤ëĨ¸ íëĄė í¸ ëë í°ëĻŦëĄ ė´ëí íėë ę´ė°Žėė đ
+$ deactivate
+
+// prisoner-of-azkaban/.venv ę°ė íę˛Ŋė íėąííŠëë¤ đ
+$ source .venv/bin/activate
+
+// ė´ė pythonė ė¤íí늴, ė´ ę°ė íę˛Ŋė ė¤ėšë sirius í¨í¤ė§ëĨŧ ė°žę˛ ëŠëë¤ â¨
+$ python main.py
+
+ëĒģë ė§ė ęž¸ë¯¸ęŗ ėėė ėėí 맚ė¸íŠëë¤.đ§
+ImportErrorë ė´ė ėėĩëë¤. đē
+```
+
+
+
+## ëėë¤
+
+ė´ ëŦ¸ėë ėŦëŦëļė´ Python íëĄė í¸ëĨŧ ėėíęŗ , **꡸ ë´ëļėė** ė´ëģę˛ ëėę°ëė§ ėë ¤ėŖŧë ę°ë¨í ę°ė´ëė
ëë¤.
+
+ę°ė íę˛Ŋ, í¨í¤ė§ ėėĄ´ėą(Requirements), íëĄė í¸ëĨŧ ę´ëĻŦíë ë°Šë˛ėë ė´ ė¸ėë ë¤ėí **ëė**ë¤ė´ ėĄ´ėŦíŠëë¤.
+
+ë§ėŊ ė¤ëšę° ëėë¤ëŠ´, **íëĄė í¸ ė ė˛´**, í¨í¤ė§ ėėĄ´ėą, ę°ė íę˛Ŋ ëąė íĩíŠė ėŧëĄ **ę´ëĻŦ**í ė ėë ëęĩŦëĨŧ ė¨ëŗ´ë ę˛ë ėĸėĩëë¤. ęˇ¸ë´ ë ėļė˛íë ëęĩŦę° ë°ëĄ uv ė
ëë¤.
+
+`uv`ë ë¤ėí 기ëĨė ė§ėíŠëë¤:
+
+* ë¤ėí ë˛ė ė **Python ė¤ėš**
+* ę° íëĄė í¸ ëŗ **ę°ė íę˛Ŋ ę´ëĻŦ**
+* **í¨í¤ė§ ė¤ėš**
+* íëĄė í¸ė **ėėĄ´ėąęŗŧ ë˛ė ** ę´ëĻŦ
+* ė¤ėšë í¨í¤ė§ë¤ęŗŧ ꡸ ë˛ė ė **ė íí ęŗ ė (lock)**í´ė,ę°ë° íę˛Ŋęŗŧ ė´ė íę˛Ŋė´ ėė í ëėŧíę˛ ėëí ė ėëëĄ ëŗ´ėĨ
+* ė´ ė¸ėë ë¤ėí 기ëĨė ė§ė
+
+## 결ëĄ
+
+ėŦ기ęšė§ ëĒ¨ë ėŊęŗ ė´í´íë¤ëŠ´, ė´ė ë§ė ę°ë°ėë¤ëŗ´ë¤ ę°ė íę˛Ŋė **í¨ėŦ ë ęšė´ ėę˛ ė´í´**íę˛ ëė
¨ėĩëë¤. đ¤
+
+ė´ë° ė¸ëļė ė¸ ë´ėŠė ėęŗ ėėŧ늴, ė¸ė ę° ëŗĩėĄí´ ëŗ´ė´ë ëŦ¸ė ëĨŧ ëë˛ęš
í ë ëļëĒ
í í° ëėė´ ë ę˛ė
ëë¤. ė´ė ë **ė´ ëĒ¨ë ę˛ë¤ė´ ë´ëļėė ė´ëģę˛ ėëíëė§** ėęŗ ė기 ëëŦ¸ė
ëë¤. đ
diff --git a/docs/pt/docs/advanced/generate-clients.md b/docs/pt/docs/advanced/generate-clients.md
index 04d7c0071..dc6b29511 100644
--- a/docs/pt/docs/advanced/generate-clients.md
+++ b/docs/pt/docs/advanced/generate-clients.md
@@ -22,7 +22,7 @@ E isso mostra o verdadeiro compromisso deles com o FastAPI e sua **comunidade**
Por exemplo, vocÃĒ pode querer experimentar:
-* Speakeasy
+* Speakeasy
* Stainless
* liblab
diff --git a/docs/pt/docs/async.md b/docs/pt/docs/async.md
index 0d6bdbf0e..4425eba77 100644
--- a/docs/pt/docs/async.md
+++ b/docs/pt/docs/async.md
@@ -40,7 +40,7 @@ def results():
---
-Se sua aplicaçÃŖo (de alguma forma) nÃŖo tem que se comunicar com nada mais e tem que esperar que o respondam, use `async def`.
+Se sua aplicaçÃŖo (de alguma forma) nÃŖo tem que se comunicar com nada mais e esperar que o respondam, use `async def`.
---
@@ -52,7 +52,7 @@ Se vocÃĒ simplesmente nÃŖo sabe, use apenas `def`.
De qualquer forma, em ambos os casos acima, FastAPI irÃĄ trabalhar assincronamente e ser extremamente rÃĄpido.
-Seguindo os passos acima, ele serÃĄ capaz de fazer algumas otimizaçÃĩes de performance.
+Mas, seguindo os passos acima, ele serÃĄ capaz de fazer algumas otimizaçÃĩes de performance.
## Detalhes TÊcnicos
@@ -66,36 +66,36 @@ Vamos ver aquela frase por partes na seçÃŖo abaixo:
## CÃŗdigo assÃncrono
-CÃŗdigo assÃncrono apenas significa que a linguagem đŦ tem um jeito de dizer para o computador / programa đ¤ que em certo ponto, ele đ¤ terÃĄ que esperar por *algo* para finalizar em outro lugar. Vamos dizer que esse *algo* seja chamado "arquivo lento" đ.
+CÃŗdigo assÃncrono apenas significa que a linguagem đŦ tem um jeito de dizer para o computador / programa đ¤ que em certo ponto do cÃŗdigo, ele đ¤ terÃĄ que esperar *algo* finalizar em outro lugar. Vamos dizer que esse *algo* seja chamado "arquivo lento" đ.
-EntÃŖo, durante esse tempo, o computador pode ir e fazer outro trabalho, enquanto o "arquivo lento" đ termine.
+EntÃŖo, durante esse tempo, o computador pode ir e fazer outro trabalho, enquanto o "arquivo lento" đ termina.
-EntÃŖo o computador / programa đ¤ irÃĄ voltar toda hora que tiver uma chance porquÃĒ ele ainda estÃĄ esperando o "arquivo lento", ou ele đ¤ nunca irÃĄ terminar todo o trabalho que tem atÊ esse ponto. E ele đ¤ irÃĄ ver se alguma das tarefas que estava esperando jÃĄ terminaram, fazendo o que quer que tinham que fazer.
+EntÃŖo o computador / programa đ¤ irÃĄ voltar sempre que tiver uma chance, seja porque ele estÃĄ esperando novamente, ou quando ele đ¤ terminar todo o trabalho que tem atÊ esse ponto. E ele đ¤ irÃĄ ver se alguma das tarefas que estava esperando jÃĄ terminaram de fazer o que quer que tinham que fazer.
-Depois, ele đ¤ pega a primeira tarefa para finalizar (vamos dizer, nosso "arquivo lento" đ) e continua o que ele tem que fazer com isso.
+Depois, ele đ¤ pega a primeira tarefa para finalizar (vamos dizer, nosso "arquivo lento" đ) e continua o que tem que fazer com ela.
-Esse "esperar por algo" normalmente se refere a operaçÃĩes I/O que sÃŖo relativamente "lentas" (comparadas a velocidade do processador e da memÃŗria RAM), como esperar por:
+Esse "esperar por algo" normalmente se refere a operaçÃĩes I/O que sÃŖo relativamente "lentas" (comparadas à velocidade do processador e da memÃŗria RAM), como esperar por:
* dados do cliente para serem enviados atravÊs da rede
-* dados enviados pelo seu programa para serem recebidos pelo clente atravÊs da rede
-* conteÃēdo de um arquivo no disco pra ser lido pelo sistema e entregar ao seu programa
+* dados enviados pelo seu programa serem recebidos pelo clente atravÊs da rede
+* conteÃēdo de um arquivo no disco ser lido pelo sistema e entregue ao seu programa
* conteÃēdo que seu programa deu ao sistema para ser escrito no disco
-* uma operaçÃŖo remota API
-* uma operaçÃŖo no banco de dados para finalizar
-* uma solicitaçÃŖo no banco de dados esperando o retorno do resultado
+* uma operaçÃŖo em uma API remota
+* uma operaçÃŖo no banco de dados finalizar
+* uma solicitaçÃŖo no banco de dados retornar o resultado
* etc.
-Enquanto o tempo de execuçÃŖo Ê consumido mais pela espera das operaçÃĩes I/O , essas operaçÃĩes sÃŖo chamadas de operaçÃĩes "limitadas por I/O".
+Quanto o tempo de execuçÃŖo Ê consumido majoritariamente pela espera de operaçÃĩes I/O , essas operaçÃĩes sÃŖo chamadas operaçÃĩes "limitadas por I/O".
-Isso Ê chamado de "assÃncrono" porquÃĒ o computador / programa nÃŖo tem que ser "sincronizado" com a tarefa lenta, esperando pelo exato momento que a tarefa finalize, enquanto nÃŖo faz nada, para ser capaz de pegar o resultado da tarefa e dar continuidade ao trabalho.
+Isso Ê chamado de "assÃncrono" porque o computador / programa nÃŖo tem que ser "sincronizado" com a tarefa lenta, esperando pelo momento exato em que a tarefa finaliza, enquanto nÃŖo faz nada, para ser capaz de pegar o resultado da tarefa e dar continuidade ao trabalho.
-Ao invÊs disso, sendo um sistema "assÃncrono", uma vez finalizada, a tarefa pode esperar um pouco (alguns microssegundos) para que o computador / programa finalize o que quer que esteja fazendo,e entÃŖo volte para pegar o resultado e continue trabalhando com ele.
+Ao invÊs disso, sendo um sistema "assÃncrono", uma vez finalizada, a tarefa pode esperar na fila um pouco (alguns microssegundos) para que o computador / programa finalize o que quer que esteja fazendo, e entÃŖo volte para pegar o resultado e continue trabalhando com ele.
-Para "sÃncrono" (contrÃĄrio de "assÃncrono") tambÊm Ê utilizado o termo "sequencial", porquÃĒ o computador / programa segue todos os passos, na sequÃĒncia, antes de trocar para uma tarefa diferente, mesmo se alguns passos envolvam esperar.
+Para "sÃncrono" (contrÃĄrio de "assÃncrono") tambÊm Ê utilizado o termo "sequencial", porquÃĒ o computador / programa segue todos os passos, em sequÃĒncia, antes de trocar para uma tarefa diferente, mesmo se alguns passos envolvam esperar.
### ConcorrÃĒncia e hambÃērgueres
-Essa idÊia de cÃŗdigo **assÃncrono** descrito acima Ê algo à s vezes chamado de **"concorrÃĒncia"**. E Ê diferente de **"paralelismo"**.
+Essa idÊia de cÃŗdigo **assÃncrono** descrita acima Ê à s vezes chamado de **"concorrÃĒncia"**. Isso Ê diferente de **"paralelismo"**.
**ConcorrÃĒncia** e **paralelismo** ambos sÃŖo relacionados a "diferentes coisas acontecendo mais ou menos ao mesmo tempo".
@@ -105,117 +105,115 @@ Para ver essa diferença, imagine a seguinte histÃŗria sobre hambÃērgueres:
### HambÃērgueres concorrentes
-VocÃĒ vai com seu _crush_ :heart_eyes: na lanchonete, fica na fila enquanto o caixa pega os pedidos das pessoas na sua frente.
+VocÃĒ vai com seu _crush_ na lanchonete, e fica na fila enquanto o caixa pega os pedidos das pessoas na sua frente. đ
-EntÃŖo chega a sua vez, vocÃĒ pede dois saborosos hambÃērgueres para vocÃĒ e seu _crush_ :heart_eyes:.
+EntÃŖo chega a sua vez, vocÃĒ pede dois saborosos hambÃērgueres para vocÃĒ e seu _crush_. đđ
-VocÃĒ paga.
+O caixa diz alguma coisa para o cozinheiro na cozinha para que eles saivam que tÃĒm que preparar seus hambÃērgueres (mesmo que ele esteja atualmente preparando os lanches dos outros clientes).
-O caixa diz alguma coisa para o cara na cozinha para que ele tenha que preparar seus hambÃērgueres (mesmo embora ele esteja preparando os lanches dos outros clientes).
+VocÃĒ paga. đ¸
O caixa te entrega seu nÃēmero de chamada.
-Enquanto vocÃĒ espera, vocÃĒ vai com seu _crush_ :heart_eyes: e pega uma mesa, senta e conversa com seu _crush_ :heart_eyes: por um bom tempo (como seus hambÃērgueres sÃŖo muito saborosos, leva um tempo para serem preparados).
+Enquanto vocÃĒ espera, vocÃĒ vai com seu _crush_ e pega uma mesa, senta e conversa com seu _crush_ por um bom tempo (jÃĄ que seus hambÃērgueres sÃŖo muito saborosos, e leva um tempo para serem preparados).
-Enquanto vocÃĒ estÃĄ sentado na mesa com seu _crush_ :heart_eyes:, esperando os hambÃērgueres, vocÃĒ pode gastar o tempo admirando como lindo, maravilhoso e esperto Ê seu _crush_ :heart_eyes:.
+JÃĄ que vocÃĒ estÃĄ sentado na mesa com seu _crush_, esperando os hambÃērgueres, vocÃĒ pode passar esse tempo admirando o quÃŖo lindo, maravilhoso e esperto Ê seu _crush_ â¨đâ¨.
-Enquanto espera e conversa com seu _crush_ :heart_eyes:, de tempos em tempos, vocÃĒ verifica o nÃēmero de chamada exibido no balcÃŖo para ver se jÃĄ Ê sua vez.
+Enquanto espera e conversa com seu _crush_, de tempos em tempos, vocÃĒ verifica o nÃēmero da chamada exibido no balcÃŖo para ver se jÃĄ Ê sua vez.
-EntÃŖo a certo ponto, Ê finalmente sua vez. VocÃĒ vai no balcÃŖo, pega seus hambÃērgueres e volta para a mesa.
+EntÃŖo em algum momento, Ê finalmente sua vez. VocÃĒ vai ao balcÃŖo, pega seus hambÃērgueres e volta para a mesa.
-VocÃĒ e seu _crush_ :heart_eyes: comem os hambÃērgueres e aproveitam o tempo.
+VocÃĒ e seu _crush_ comem os hambÃērgueres e aproveitam o tempo. â¨
---
-Imagine que vocÃĒ seja o computador / programa nessa histÃŗria.
+Imagine que vocÃĒ seja o computador / programa nessa histÃŗria.
-Enquanto vocÃĒ estÃĄ na fila, tranquilo, esperando por sua vez, nÃŖo estÃĄ fazendo nada "produtivo". Mas a fila Ê rÃĄpida porquÃĒ o caixa sÃŗ estÃĄ pegando os pedidos, entÃŖo estÃĄ tudo bem.
+Enquanto vocÃĒ estÃĄ na fila, vocÃĒ estÃĄ somente ocioso đ´, esperando por sua vez, sem fazer nada muito "produtivo". Mas a fila Ê rÃĄpida porque o caixa sÃŗ estÃĄ pegando os pedidos (nÃŖo os preparando), entÃŖo estÃĄ tudo bem.
-EntÃŖo, quando Ê sua vez, vocÃĒ faz o trabalho "produtivo" de verdade, vocÃĒ processa o menu, decide o que quer, pega a escolha de seu _crush_ :heart_eyes:, paga, verifica se entregou o valor correto em dinheiro ou cartÃŖo de crÊdito, verifica se foi cobrado corretamente, verifica se seu pedido estÃĄ correto etc.
+EntÃŖo, quando Ê sua vez, vocÃĒ faz trabalho realmente "produtivo", vocÃĒ processa o menu, decide o que quer, pega a escolha de seu _crush_, paga, verifica se entregou o cartÃŖo ou a cÊdula correta, verifica se foi cobrado corretamente, verifica se seu pedido estÃĄ correto etc.
-Mas entÃŖo, embora vocÃĒ ainda nÃŖo tenha os hambÃērgueres, seu trabalho no caixa estÃĄ "pausado", porquÃĒ vocÃĒ tem que esperar seus hambÃērgueres estarem prontos.
+Mas entÃŖo, embora vocÃĒ ainda nÃŖo tenha os hambÃērgueres, seu trabalho no caixa estÃĄ "pausado" â¸, porque vocÃĒ tem que esperar đ seus hambÃērgueres ficarem prontos.
-Mas enquanto vocÃĒ se afasta do balcÃŖo e senta na mesa com o nÃēmero da sua chamada, vocÃĒ pode trocar sua atençÃŖo para seu _crush_ :heart_eyes:, e "trabalhar" nisso. EntÃŖo vocÃĒ estÃĄ novamente fazendo algo muito "produtivo", como flertar com seu _crush_ :heart_eyes:.
+Contudo, à medida que vocÃĒ se afasta do balcÃŖo e senta na mesa, com um nÃēmero para sua chamada, vocÃĒ pode trocar đ sua atençÃŖo para seu _crush_, e "trabalhar" ⯠đ¤ nisso. EntÃŖo vocÃĒ estÃĄ novamente fazendo algo muito "produtivo", como flertar com seu _crush_ đ.
-EntÃŖo o caixa diz que "seus hambÃērgueres estÃŖo prontos" colocando seu nÃēmero no balcÃŖo, mas vocÃĒ nÃŖo corre que nem um maluco imediatamente quando o nÃēmero exibido Ê o seu. VocÃĒ sabe que ninguÊm irÃĄ roubar seus hambÃērgueres porquÃĒ vocÃĒ tem o nÃēmero de chamada, e os outros tem os nÃēmeros deles.
+EntÃŖo o caixa đ diz que "seus hambÃērgueres estÃŖo prontos" colocando seu nÃēmero no balcÃŖo, mas vocÃĒ nÃŖo corre que nem um maluco imediatamente quando o nÃēmero exibido Ê o seu. VocÃĒ sabe que ninguÊm irÃĄ roubar seus hambÃērgueres porque vocÃĒ tem o seu nÃēmero da chamada, e os outros tÃĒm os deles.
-EntÃŖo vocÃĒ espera que seu _crush_ :heart_eyes: termine a histÃŗria que estava contando (terminar o trabalho atual / tarefa sendo processada), sorri gentilmente e diz que vocÃĒ estÃĄ indo buscar os hambÃērgueres.
+EntÃŖo vocÃĒ espera seu _crush_ terminar a histÃŗria que estava contando (terminar o trabalho atual ⯠/ tarefa sendo processada đ¤), sorri gentilmente e diz que vocÃĒ estÃĄ indo buscar os hambÃērgueres.
-EntÃŖo vocÃĒ vai no balcÃŖo, para a tarefa inicial que agora estÃĄ finalizada, pega os hambÃērgueres, e leva para a mesa. Isso finaliza esse passo / tarefa da interaçÃŖo com o balcÃŖo. Agora Ê criada uma nova tarefa, "comer hambÃērgueres", mas a tarefa anterior, "pegar os hambÃērgueres" jÃĄ estÃĄ finalizada.
+EntÃŖo vocÃĒ vai ao balcÃŖo đ, para a tarefa inicial que agora estÃĄ finalizadaâ¯, pega os hambÃērgueres, agradece, e leva-os para a mesa. Isso finaliza esse passo / tarefa da interaçÃŖo com o balcÃŖo âš. Isso, por sua vez, cria uma nova tarefa, a de "comer hambÃērgueres" đ â¯, mas a tarefa anterior de "pegar os hambÃērgueres" jÃĄ estÃĄ finalizada âš.
### HambÃērgueres paralelos
-VocÃĒ vai com seu _crush_ :heart_eyes: em uma lanchonete paralela.
+Agora vamos imaginar que esses nÃŖo sÃŖo "HambÃērgueres Concorrentes", e sim "HambÃērgueres Paralelos"
-VocÃĒ fica na fila enquanto alguns (vamos dizer 8) caixas pegam os pedidos das pessoas na sua frente.
+VocÃĒ vai com seu _crush_ na lanchonete paralela.
-Todo mundo antes de vocÃĒ estÃĄ esperando pelos hambÃērgueres estarem prontos antes de deixar o caixa porquÃĒ cada um dos 8 caixas vai e prepara o hambÃērguer antes de pegar o prÃŗximo pedido.
+VocÃĒ fica na fila enquanto vÃĄrios (vamos dizer 8) caixas que tambÊm sÃŖo cozinheiros pegam os pedidos das pessoas na sua frente.
-EntÃŖo Ê finalmente sua vez, e pede 2 hambÃērgueres muito saborosos para vocÃĒ e seu _crush_ :heart_eyes:.
+Todo mundo na sua frente estÃĄ esperando seus hambÃērgueres ficarem prontos antes de deixar o caixa porque cada um dos 8 caixas vai e prepara o hambÃērguer logo apÃŗs receber o pedido, antes de pegar o prÃŗximo pedido.
-VocÃĒ paga.
+EntÃŖo Ê finalmente sua vez, vocÃĒ pede 2 hambÃērgueres muito saborosos para vocÃĒ e seu _crush_.
+
+VocÃĒ paga đ¸.
O caixa vai para a cozinha.
-VocÃĒ espera, na frente do balcÃŖo, para que ninguÊm pegue seus hambÃērgueres antes de vocÃĒ, jÃĄ que nÃŖo tem nÃēmeros de chamadas.
+VocÃĒ espera, na frente do balcÃŖo đ, para que ninguÊm pegue seus hambÃērgueres antes de vocÃĒ, jÃĄ que nÃŖo tem nÃēmeros de chamadas.
-Enquanto vocÃĒ e seu _crush_ :heart_eyes: estÃŖo ocupados nÃŖo permitindo que ninguÊm passe a frente e pegue seus hambÃērgueres assim que estiverem prontos, vocÃĒ nÃŖo pode dar atençÃŖo ao seu _crush_ :heart_eyes:.
+Como vocÃĒ e seu _crush_ estÃŖo ocupados nÃŖo permitindo que ninguÊm passe na frente e pegue seus hambÃērgueres assim que estiverem prontos, vocÃĒ nÃŖo pode dar atençÃŖo ao seu _crush_. đ
-Isso Ê trabalho "sÃncrono", vocÃĒ estÃĄ "sincronizado" com o caixa / cozinheiro. VocÃĒ tem que esperar e estar lÃĄ no exato momento que o caixa / cozinheiro terminar os hambÃērgueres e dÃĄ-los a vocÃĒ, ou entÃŖo, outro alguÊm pode pegÃĄ-los.
+Isso Ê trabalho "sÃncrono", vocÃĒ estÃĄ "sincronizado" com o caixa / cozinheirođ¨âđŗ. VocÃĒ tem que esperar đ e estar lÃĄ no exato momento que o caixa / cozinheiro đ¨âđŗ terminar os hambÃērgueres e os der a vocÃĒ, ou entÃŖo, outro alguÊm pode pegÃĄ-los.
-EntÃŖo seu caixa / cozinheiro finalmente volta com seus hambÃērgueres, depois de um longo tempo esperando por eles em frente ao balcÃŖo.
+EntÃŖo seu caixa / cozinheiro đ¨âđŗ finalmente volta com seus hambÃērgueres, depois de um longo tempo esperando đ por eles em frente ao balcÃŖo.
-VocÃĒ pega seus hambÃērgueres e vai para a mesa com seu _crush_ :heart_eyes:.
+VocÃĒ pega seus hambÃērgueres e vai para a mesa com seu _crush_.
-VocÃĒs comem os hambÃērgueres, e o trabalho estÃĄ terminado.
+VocÃĒs comem os hambÃērgueres, e o trabalho estÃĄ terminado. âš
-NÃŖo houve muita conversa ou flerte jÃĄ que a maior parte do tempo foi gasto esperando os lanches na frente do balcÃŖo.
+NÃŖo houve muita conversa ou flerte jÃĄ que a maior parte do tempo foi gasto esperando đ na frente do balcÃŖo. đ
---
-Nesse cenÃĄrio dos hambÃērgueres paralelos, vocÃĒ Ê um computador / programa com dois processadores (vocÃĒ e seu _crush_ :heart_eyes:), ambos esperando e dedicando a atençÃŖo de estar "esperando no balcÃŖo" por um bom tempo.
+Nesse cenÃĄrio dos hambÃērgueres paralelos, vocÃĒ Ê um computador / programa com dois processadores (vocÃĒ e seu _crush_), ambos esperando đ e dedicando sua atençÃŖo ⯠"esperando no balcÃŖo" đ por um bom tempo.
-A lanchonete paralela tem 8 processadores (caixas / cozinheiros). Enquanto a lanchonete dos hambÃērgueres concorrentes tinham apenas 2 (um caixa e um cozinheiro).
+A lanchonete paralela tem 8 processadores (caixas / cozinheiros), enquanto a lanchonete dos hambÃērgueres concorrentes tinha apenas 2 (um caixa e um cozinheiro).
-Ainda assim, a Ãēltima experiÃĒncia nÃŖo foi a melhor.
+Ainda assim, a experiÃĒncia final nÃŖo foi a melhor. đ
---
-Essa poderia ser a histÃŗria paralela equivalente aos hambÃērgueres.
+Essa seria o equivalente paralelo à histÃŗrio dos hambÃērgueres. đ
Para um exemplo "mais real", imagine um banco.
-AtÊ recentemente, a maioria dos bancos tinha muitos caixas e uma grande fila.
+AtÊ recentemente, a maioria dos bancos tinham muitos caixas đ¨âđŧđ¨âđŧđ¨âđŧđ¨âđŧ e uma grande fila đđđđđđđđ.
-Todos os caixas fazendo todo o trabalho, um cliente apÃŗs o outro.
+Todos os caixas fazendo todo o trabalho, um cliente apÃŗs o outro đ¨âđŧâ¯.
-E vocÃĒ tinha que esperar na fila por um longo tempo ou poderia perder a vez.
+E vocÃĒ tinha que esperar đ na fila por um longo tempo ou poderia perder a vez.
-VocÃĒ provavelmente nÃŖo gostaria de levar seu _crush_ :heart_eyes: com vocÃĒ para um rolezinho no banco.
+VocÃĒ provavelmente nÃŖo gostaria de levar seu _crush_ đ com vocÃĒ para um rolezinho no banco đĻ.
### ConclusÃŖo dos hambÃērgueres
-Nesse cenÃĄrio dos "hambÃērgueres com seu _crush_ :heart_eyes:", como tem muita espera, faz mais sentido ter um sistema concorrente.
+Nesse cenÃĄrio dos "hambÃērgueres com seu _crush_", como tem muita espera, faz mais sentido ter um sistema concorrente â¸đâ¯.
Esse Ê o caso da maioria das aplicaçÃĩes web.
-Geralmente sÃŖo muitos usuÃĄrios, e seu servidor estÃĄ esperando pelas suas conexÃĩes nÃŖo tÃŖo boas para enviar as requisiçÃĩes.
-
-E entÃŖo esperando novamente pelas respostas voltarem.
-
-Essa "espera" Ê medida em microssegundos, e ainda assim, somando tudo, Ê um monte de espera no final.
+Muitos, muitos usuÃĄrios, mas seu servidor estÃĄ esperando đ pela sua conexÃŖo nÃŖo tÃŖo boa enviar suas requisiçÃĩes.
-Por isso que faz muito mais sentido utilizar cÃŗdigo assÃncrono para APIs web.
+E entÃŖo esperando đ novamente as respostas voltarem.
-A maioria dos frameworks Python existentes mais populares (incluindo Flask e Django) foram criados antes que os novos recursos assÃncronos existissem em Python. EntÃŖo, os meios que eles podem ser colocados em produçÃŖo para suportar execuçÃŖo paralela mais a forma antiga de execuçÃŖo assÃncrona nÃŖo sÃŖo tÃŖo poderosos quanto as novas capacidades.
+Essa "espera" đ Ê medida em microssegundos, mas ainda assim, somando tudo, Ê um monte de espera no final.
-Mesmo embora a especificaçÃŖo principal para web assÃncrono em Python (ASGI) foi desenvolvida no Django, para adicionar suporte para WebSockets.
+Por isso que faz bastante sentido utilizar cÃŗdigo assÃncrono â¸đ⯠para APIs web.
-Esse tipo de assincronicidade Ê o que fez NodeJS popular (embora NodeJS nÃŖo seja paralelo) e que essa seja a força do Go como uma linguagem de programa.
+Esse tipo de assincronicidade Ê o que fez NodeJS popular (embora NodeJS nÃŖo seja paralelo) e essa Ê a força do Go como uma linguagem de programaçÃŖo.
E esse Ê o mesmo nÃvel de performance que vocÃĒ tem com o **FastAPI**.
-E como vocÃĒ pode ter paralelismo e sincronicidade ao mesmo tempo, vocÃĒ tem uma maior performance do que a maioria dos frameworks NodeJS testados e lado a lado com Go, que Ê uma linguagem compilada prÃŗxima ao C (tudo graças ao Starlette) .
+E como vocÃĒ pode ter paralelismo e assincronicidade ao mesmo tempo, vocÃĒ tem uma maior performance do que a maioria dos frameworks NodeJS testados e lado a lado com Go, que Ê uma linguagem compilada, mais prÃŗxima ao C (tudo graças ao Starlette) .
### ConcorrÃĒncia Ê melhor que paralelismo?
@@ -225,64 +223,64 @@ ConcorrÃĒncia Ê diferente de paralelismo. E Ê melhor em cenÃĄrios **especÃfic
EntÃŖo, para equilibrar tudo, imagine a seguinte historinha:
-> VocÃĒ tem que limpar uma grande casa suja.
+> VocÃĒ tem que limpar uma casa grande e suja.
*Sim, essa Ê toda a histÃŗria*.
---
-NÃŖo hÃĄ espera em lugar algum, apenas um monte de trabalho para ser feito, em mÃēltiplos cômodos da casa.
+NÃŖo hÃĄ espera đ em lugar algum, apenas um monte de trabalho para ser feito, em mÃēltiplos cômodos da casa.
-VocÃĒ poderia ter chamadas como no exemplo dos hambÃērgueres, primeiro a sala de estar, entÃŖo a cozinha, mas vocÃĒ nÃŖo estÃĄ esperando por nada, apenas limpar e limpar, as chamadas nÃŖo afetariam em nada.
+VocÃĒ poderia ter turnos como no exemplo dos hambÃērgueres, primeiro a sala de estar, entÃŖo a cozinha, mas como vocÃĒ nÃŖo estÃĄ esperando por nada, apenas limpando e limpando, as chamadas nÃŖo afetariam em nada.
-Levaria o mesmo tempo para finalizar com ou sem chamadas (concorrÃĒncia) e vocÃĒ teria feito o mesmo tanto de trabalho.
+Levaria o mesmo tempo para finalizar com ou sem turnos (concorrÃĒncia) e vocÃĒ teria feito o mesmo tanto de trabalho.
Mas nesse caso, se vocÃĒ trouxesse os 8 ex-caixas / cozinheiros / agora-faxineiros, e cada um deles (mais vocÃĒ) pudessem dividir a casa para limpÃĄ-la, vocÃĒs fariam toda a limpeza em **paralelo**, com a ajuda extra, e terminariam muito mais cedo.
Nesse cenÃĄrio, cada um dos faxineiros (incluindo vocÃĒ) poderia ser um processador, fazendo a sua parte do trabalho.
-E a maior parte do tempo de execuçÃŖo Ê tomada por trabalho (ao invÊs de ficar esperando), e o trabalho em um computador Ê feito pela CPU , que podem gerar problemas que sÃŖo chamados de "limite de CPU".
+E a maior parte do tempo de execuçÃŖo Ê tomada por trabalho real (ao invÊs de ficar esperando), e o trabalho em um computador Ê feito pela CPU . Eles chamam esses problemas de "limitados por CPU".
---
-Exemplos comuns de limite de CPU sÃŖo coisas que exigem processamento matemÃĄtico complexo.
+Exemplos comuns de operaçÃĩes limitadas por CPU sÃŖo coisas que exigem processamento matemÃĄtico complexo.
Por exemplo:
* **Processamento de ÃĄudio** ou **imagem**
-* **VisÃŖo do Computador**: uma imagem Ê composta por milhÃĩes de pixels, cada pixel tem 3 valores (cores, processamento que normalmente exige alguma computaçÃŖo em todos esses pixels ao mesmo tempo)
+* **VisÃŖo Computacional**: uma imagem Ê composta por milhÃĩes de pixels, cada pixel tem 3 valores / cores, processar isso normalmente exige alguma computaçÃŖo em todos esses pixels ao mesmo tempo
-* **Machine Learning**: Normalmente exige muita multiplicaçÃŖo de matrizes e vetores. Pense numa grande folha de papel com nÃēmeros e multiplicando todos eles juntos e ao mesmo tempo.
+* **Machine Learning**: Normalmente exige muita multiplicaçÃŖo de matrizes e vetores. Pense numa grande planilha com nÃēmeros e em multiplicar todos eles juntos e ao mesmo tempo.
-* **Deep Learning**: Esse Ê um subcampo do Machine Learning, entÃŖo o mesmo se aplica. A diferença Ê que nÃŖo hÃĄ apenas uma grande folha de papel com nÃēmeros para multiplicar, mas um grande conjunto de folhas de papel, e em muitos casos, vocÃĒ utiliza um processador especial para construir e/ou usar modelos.
+* **Deep Learning**: Esse Ê um subcampo do Machine Learning, entÃŖo, o mesmo se aplica. A diferença Ê que nÃŖo hÃĄ apenas uma grande planilha com nÃēmeros para multiplicar, mas um grande conjunto delas, e em muitos casos, vocÃĒ utiliza um processador especial para construir e/ou usar esses modelos.
### ConcorrÃĒncia + Paralelismo: Web + Machine learning
Com **FastAPI** vocÃĒ pode levar a vantagem da concorrÃĒncia que Ê muito comum para desenvolvimento web (o mesmo atrativo de NodeJS).
-Mas vocÃĒ tambÊm pode explorar os benefÃcios do paralelismo e multiprocessamento (tendo mÃēltiplos processadores rodando em paralelo) para trabalhos pesados que geram **limite de CPU** como aqueles em sistemas de Machine Learning.
+Mas vocÃĒ tambÊm pode explorar os benefÃcios do paralelismo e multiprocessamento (tendo mÃēltiplos processadores rodando em paralelo) para trabalhos **limitados por CPU** como aqueles em sistemas de Machine Learning.
-Isso, mais o simples fato que Python Ê a principal linguagem para **Data Science**, Machine Learning e especialmente Deep Learning, faz do FastAPI uma Ãŗtima escolha para APIs web e aplicaçÃĩes com Data Science / Machine Learning (entre muitas outras).
+Isso, somado ao simples fato que Python Ê a principal linguagem para **Data Science**, Machine Learning e especialmente Deep Learning, faz do FastAPI uma Ãŗtima escolha para APIs web e aplicaçÃĩes com Data Science / Machine Learning (entre muitas outras).
Para ver como alcançar esse paralelismo em produçÃŖo veja a seçÃŖo sobre [Deployment](deployment/index.md){.internal-link target=_blank}.
## `async` e `await`
-VersÃĩes modernas do Python tem um modo muito intuitivo para definir cÃŗdigo assÃncrono. Isso faz parecer normal o cÃŗdigo "sequencial" e fazer o "esperar" para vocÃĒ nos momentos certos.
+VersÃĩes modernas do Python tÃĒm um modo muito intuitivo para definir cÃŗdigo assÃncrono. Isso faz parecer do mesmo jeito do cÃŗdigo normal "sequencial" e fazer a "espera" para vocÃĒ nos momentos certos.
-Quando tem uma operaçÃŖo que exigirÃĄ espera antes de dar os resultados e tem suporte para esses recursos Python, vocÃĒ pode escrever assim:
+Quando tem uma operaçÃŖo que exigirÃĄ espera antes de dar os resultados e tem suporte para esses novos recursos do Python, vocÃĒ pode escrever assim:
```Python
burgers = await get_burgers(2)
```
-A chave aqui Ê o `await`. Ele diz ao Python que ele tem que esperar por `get_burgers(2)` para finalizar suas coisas antes de armazenar os resultados em `burgers`. Com isso, o Python saberÃĄ que ele pode ir e fazer outras coisas nesse meio tempo (como receber outra requisiçÃŖo).
+A chave aqui Ê o `await`. Ele diz ao Python que ele tem que esperar por `get_burgers(2)` finalizar suas coisas đ antes de armazenar os resultados em `burgers`. Com isso, o Python saberÃĄ que ele pode ir e fazer outras coisas đ ⯠nesse meio tempo (como receber outra requisiçÃŖo).
Para o `await` funcionar, tem que estar dentro de uma funçÃŖo que suporte essa assincronicidade. Para fazer isso, apenas declare a funçÃŖo com `async def`:
```Python hl_lines="1"
async def get_burgers(number: int):
- # Fazer alguma coisa assÃncrona para criar os hambÃērgueres
+ # Faz alguma coisa assÃncrona para criar os hambÃērgueres
return burgers
```
@@ -295,9 +293,9 @@ def get_sequential_burgers(number: int):
return burgers
```
-Com `async def`, o Python sabe que, dentro dessa funçÃŖo, tem que estar ciente das expressÃĩes `await`, e que isso pode "pausar" a execuçÃŖo dessa funçÃŖo, e poderÃĄ fazer outra coisa antes de voltar.
+Com `async def`, o Python sabe que, dentro dessa funçÃŖo, ele deve estar ciente das expressÃĩes `await`, e que isso poderÃĄ "pausar" ⸠a execuçÃŖo dessa funçÃŖo, e ir fazer outra coisa đ antes de voltar.
-Quando vocÃĒ quiser chamar uma funçÃŖo `async def`, vocÃĒ tem que "esperar". EntÃŖo, isso nÃŖo funcionarÃĄ:
+Quando vocÃĒ quiser chamar uma funçÃŖo `async def`, vocÃĒ tem que "esperar" ela. EntÃŖo, isso nÃŖo funcionarÃĄ:
```Python
# Isso nÃŖo irÃĄ funcionar, porquÃĒ get_burgers foi definido com: async def
@@ -319,13 +317,24 @@ async def read_burgers():
VocÃĒ deve ter observado que `await` pode ser usado somente dentro de funçÃĩes definidas com `async def`.
-Mas ao mesmo tempo, funçÃĩes definidas com `async def` tem que ser aguardadas. EntÃŖo, funçÃĩes com `async def` pdem ser chamadas somente dentro de funçÃĩes definidas com `async def` tambÊm.
+Mas ao mesmo tempo, funçÃĩes definidas com `async def` tÃĒm que ser "aguardadas". EntÃŖo, funçÃĩes com `async def` pdem ser chamadas somente dentro de funçÃĩes definidas com `async def` tambÊm.
EntÃŖo, sobre o ovo e a galinha, como vocÃĒ chama a primeira funçÃŖo async?
Se vocÃĒ estivar trabalhando com **FastAPI** nÃŖo terÃĄ que se preocupar com isso, porquÃĒ essa "primeira" funçÃŖo serÃĄ a sua *funçÃŖo de operaçÃŖo de rota*, e o FastAPI saberÃĄ como fazer a coisa certa.
-Mas se vocÃĒ quiser usar `async` / `await` sem FastAPI, verifique a documentaçÃŖo oficial Python .
+Mas se vocÃĒ quiser usar `async` / `await` sem FastAPI, vocÃĒ tambÊm pode fazÃĒ-lo.
+
+### Escreva seu prÃŗprio cÃŗdigo assÃncrono
+
+Starlette (e **FastAPI**) sÃŖo baseados no AnyIO , o que o torna compatÃvel com ambos o asyncio da biblioteca padrÃŖo do Python, e o Trio .
+
+Em particular, vocÃĒ pode usar diretamente o AnyIO para seus casos de uso avançados de concorrÃĒncia que requerem padrÃĩes mais avançados no seu prÃŗprio cÃŗdigo.
+
+E atÊ se vocÃĒ nÃŖo estiver utilizando FastAPI, vocÃĒ tambÊm pode escrever suas prÃŗprias aplicaçÃĩes assÃncronas com o AnyIO por ser altamente compatÃvel e ganhar seus benefÃcios (e.g. *concorrÃĒncia estruturada*).
+
+Eu criei outra biblioteca em cima do AnyIO, como uma fina camada acima, para melhorar um pouco as anotaçÃĩes de tipo e obter melhor **autocompletar**, **erros de linha**, etc. Ela tambÊm possui uma introduçÃŖo amigÃĄvel e um tutorial para ajudar vocÃĒ a **entender** e escrever **seu prÃŗprio cÃŗdigo async**: Asyncer . Seria particularmente Ãētil se vocÃĒ precisar **combinar cÃŗdigo async com cÃŗdigo regular** (bloqueador/sÃncrono).
+
### Outras formas de cÃŗdigo assÃncrono
@@ -337,25 +346,25 @@ Essa mesma sintaxe (ou quase a mesma) foi tambÊm incluÃda recentemente em vers
Mas antes disso, controlar cÃŗdigo assÃncrono era bem mais complexo e difÃcil.
-Nas versÃĩes anteriores do Python, vocÃĒ poderia utilizar threads ou Gevent . Mas o cÃŗdigo Ê um pouco mais complexo de entender, debugar, e pensar sobre.
+Nas versÃĩes anteriores do Python, vocÃĒ poderia utilizar threads ou Gevent . Mas o cÃŗdigo Ê bem mais complexo de entender, debugar, e pensar sobre.
-Nas versÃĩes anteriores do NodeJS / Navegador JavaScript, vocÃĒ poderia utilizar "callbacks". O que leva ao inferno do callback .
+Nas versÃĩes anteriores do NodeJS / Navegador JavaScript, vocÃĒ utilizaria "callbacks". O que leva ao inferno do callback .
## Corrotinas
-**Corrotina** Ê apenas um jeito bonitinho para a coisa que Ê retornada de uma funçÃŖo `async def`. O Python sabe que Ê uma funçÃŖo que pode começar e terminar em algum ponto, mas que pode ser pausada internamente tambÊm, sempre que tiver um `await` dentro dela.
+**Corrotina** Ê apenas um jeito bonitinho para a coisa que Ê retornada de uma funçÃŖo `async def`. O Python sabe que Ê algo como uma funçÃŖo, que pode começar e que vai terminar em algum ponto, mas que pode ser pausada ⸠internamente tambÊm, sempre que tiver um `await` dentro dela.
-Mas toda essa funcionalidade de cÃŗdigo assÃncrono com `async` e `await` Ê muitas vezes resumida como "corrotina". à comparÃĄvel ao principal recurso chave do Go, a "Gorotina".
+Mas toda essa funcionalidade de cÃŗdigo assÃncrono com `async` e `await` Ê muitas vezes resumida como usando "corrotinas". à comparÃĄvel ao principal recurso chave do Go, a "Gorrotina".
## ConclusÃŖo
-Vamos ver a mesma frase com o conteÃēdo cima:
+Vamos ver a mesma frase de cima:
-> VersÃĩes modernas do Python tem suporte para **"cÃŗdigo assÃncrono"** usando algo chamado **"corrotinas"**, com sintaxe **`async` e `await`**.
+> VersÃĩes modernas do Python tÃĒm suporte para **"cÃŗdigo assÃncrono"** usando algo chamado **"corrotinas"**, com sintaxe **`async` e `await`**.
-Isso pode fazer mais sentido agora.
+Isso pode fazer mais sentido agora. â¨
-Tudo isso Ê o que deixa o FastAPI poderoso (atravÊs do Starlette) e que o faz ter uma performance impressionante.
+Tudo isso Ê o que empodera o FastAPI (atravÊs do Starlette) e que o faz ter uma performance tÃŖo impressionante.
## Detalhes muito tÊcnicos
@@ -365,25 +374,25 @@ VocÃĒ pode provavelmente pular isso.
Esses sÃŖo detalhes muito tÊcnicos de como **FastAPI** funciona por baixo do capô.
-Se vocÃĒ tem algum conhecimento tÊcnico (corrotinas, threads, blocking etc) e estÃĄ curioso sobre como o FastAPI controla o `async def` vs normal `def`, vÃĄ em frente.
+Se vocÃĒ tem certo conhecimento tÊcnico (corrotinas, threads, blocking etc) e estÃĄ curioso sobre como o FastAPI controla o `async def` vs normal `def`, vÃĄ em frente.
///
### FunçÃĩes de operaçÃŖo de rota
-Quando vocÃĒ declara uma *funçÃŖo de operaçÃŖo de rota* com `def` normal ao invÊs de `async def`, ela Ê rodada em uma threadpool externa que entÃŖo Ê aguardada, ao invÊs de ser chamada diretamente (ela poderia bloquear o servidor).
+Quando vocÃĒ declara uma *funçÃŖo de operaçÃŖo de rota* com `def` normal ao invÊs de `async def`, ela Ê rodada em uma threadpool externa que Ê entÃŖo aguardada, ao invÊs de ser chamada diretamente (jÃĄ que ela bloquearia o servidor).
-Se vocÃĒ estÃĄ chegando de outro framework assÃncrono que nÃŖo faz o trabalho descrito acima e vocÃĒ estÃĄ acostumado a definir triviais *funçÃĩes de operaçÃŖo de rota* com simples `def` para ter um mÃnimo ganho de performance (cerca de 100 nanosegundos), por favor observe que no **FastAPI** o efeito pode ser bem o oposto. Nesses casos, Ê melhor usar `async def` a menos que suas *funçÃĩes de operaçÃŖo de rota* utilizem cÃŗdigo que performem bloqueamento IO .
+Se vocÃĒ estÃĄ chegando de outro framework assÃncrono que nÃŖo funciona como descrito acima e vocÃĒ estÃĄ acostumado a definir *funçÃĩes de operaçÃŖo de rota* triviais somente de computaçÃŖo com simples `def` para ter um mÃnimo ganho de performance (cerca de 100 nanosegundos), por favor observe que no **FastAPI** o efeito pode ser bem o oposto. Nesses casos, Ê melhor usar `async def` a menos que suas *funçÃĩes de operaçÃŖo de rota* utilizem cÃŗdigo que performe bloqueamento IO .
-Ainda, em ambas as situaçÃĩes, as chances sÃŖo que o **FastAPI** serÃĄ [ainda mais rÃĄpido](index.md#performance){.internal-link target=_blank} do que (ou ao menos comparÃĄvel a) seus frameworks antecessores.
+Ainda, em ambas as situaçÃĩes, as chances sÃŖo que o **FastAPI** [ainda serÃĄ mais rÃĄpido](index.md#performance){.internal-link target=_blank} do que (ou ao menos comparÃĄvel a) seu framework anterior.
### DependÃĒncias
-O mesmo se aplica para as dependÃĒncias. Se uma dependÃĒncia tem as funçÃĩes com padrÃŖo `def` ao invÊs de `async def`, ela Ê rodada no threadpool externo.
+O mesmo se aplica para as [dependÃĒncias](tutorial/dependencies/index.md){.internal-link target=_blank}. Se uma dependÃĒncia tem as funçÃĩes com padrÃŖo `def` ao invÊs de `async def`, ela Ê rodada no threadpool externo.
### Sub-dependÃĒncias
-VocÃĒ pode ter mÃēltiplas dependÃĒncias e sub-dependÃĒncias exigindo uma a outra (como parÃĸmetros de definiçÃĩes de funçÃĩes), algumas delas podem ser criadas com `async def` e algumas com `def` normal. Isso ainda poderia funcionar, e aquelas criadas com `def` podem ser chamadas em uma thread externa ao invÊs de serem "aguardadas".
+VocÃĒ pode ter mÃēltiplas dependÃĒncias e [sub-dependÃĒncias](tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} requisitando uma à outra (como parÃĸmetros de definiçÃĩes de funçÃĩes), algumas delas podem ser criadas com `async def` e algumas com `def` normal. Isso ainda funcionaria, e aquelas criadas com `def` normal seriam chamadas em uma thread externa (do threadpool) ao invÊs de serem "aguardadas".
### Outras funçÃĩes de utilidade
@@ -395,6 +404,6 @@ Se sua funçÃŖo de utilidade Ê uma funçÃŖo normal com `def`, ela serÃĄ chamada
---
-Novamente, esses sÃŖo detalhes muito tÊcnicos que provavelmente possam ser Ãēteis caso vocÃĒ esteja procurando por eles.
+Novamente, esses sÃŖo detalhes muito tÊcnicos que provavelmente seriam Ãēteis caso vocÃĒ esteja procurando por eles.
Caso contrÃĄrio, vocÃĒ deve ficar bem com as dicas da seçÃŖo acima: Com pressa? .
diff --git a/docs/pt/docs/deployment/concepts.md b/docs/pt/docs/deployment/concepts.md
index 8cf70d0b4..014ca3797 100644
--- a/docs/pt/docs/deployment/concepts.md
+++ b/docs/pt/docs/deployment/concepts.md
@@ -216,7 +216,7 @@ Este Processo de Gerenciador provavelmente seria o que escutaria na **porta** no
Esses processos de trabalho seriam aqueles que executariam seu aplicativo, eles executariam os cÃĄlculos principais para receber uma **solicitaçÃŖo** e retornar uma **resposta**, e carregariam qualquer coisa que vocÃĒ colocasse em variÃĄveis ââna RAM.
-`redoc.standalone.js`
+* `redoc.standalone.js`
Depois disso, sua estrutura de arquivos deve se parecer com:
@@ -129,14 +129,8 @@ VocÃĒ deverÃĄ ver um arquivo JavaScript muito longo para o **ReDoc**.
Esse arquivo pode começar com algo como:
```JavaScript
-/*!
- * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
- * -------------------------------------------------------------
- * Version: "2.0.0-rc.18"
- * Repo: https://github.com/Redocly/redoc
- */
-!function(e,t){"object"==typeof exports&&"object"==typeof m
-
+/*! For license information please see redoc.standalone.js.LICENSE.txt */
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t(require("null")):
...
```
diff --git a/docs/pt/docs/project-generation.md b/docs/pt/docs/project-generation.md
index e5c935fd2..e337ad762 100644
--- a/docs/pt/docs/project-generation.md
+++ b/docs/pt/docs/project-generation.md
@@ -1,84 +1,28 @@
-# GeraçÃŖo de Projetos - Modelo
-
-VocÃĒ pode usar um gerador de projetos para começar, por jÃĄ incluir configuraçÃĩes iniciais, segurança, banco de dados e os primeiros _endpoints_ API jÃĄ feitos para vocÃĒ.
-
-Um gerador de projetos sempre terÃĄ uma prÊ-configuraçÃŖo que vocÃĒ pode atualizar e adaptar para suas prÃŗprias necessidades, mas pode ser um bom ponto de partida para seu projeto.
-
-## Full Stack FastAPI PostgreSQL
-
-GitHub: https://github.com/tiangolo/full-stack-fastapi-postgresql
-
-### Full Stack FastAPI PostgreSQL - Recursos
-
-* IntegraçÃŖo completa **Docker**.
-* Modo de implantaçÃŖo Docker Swarm.
-* IntegraçÃŖo e otimizaçÃŖo **Docker Compose** para desenvolvimento local.
-* **Pronto para ProduçÃŖo** com servidor _web_ usando Uvicorn e Gunicorn.
-* _Backend_ **FastAPI** Python:
- * **RÃĄpido**: Alta performance, no nÃvel de **NodeJS** e **Go** (graças ao Starlette e Pydantic).
- * **Intuitivo**: Ãtimo suporte de editor. _Auto-Complete_ em todo lugar. Menos tempo _debugando_.
- * **FÃĄcil**: Projetado para ser fÃĄcil de usar e aprender. Menos tempo lendo documentaçÃĩes.
- * **Curto**: Minimize duplicaçÃŖo de cÃŗdigo. MÃēltiplos recursos para cada declaraçÃŖo de parÃĸmetro.
- * **Robusto**: Tenha cÃŗdigo pronto para produçÃŖo. Com documentaçÃŖo interativa automÃĄtica.
- * **Baseado em PadrÃĩes**: Baseado em (e completamente compatÃvel com) padrÃĩes abertos para APIs: OpenAPI e JSON Schema .
- * **Muitos outros recursos** incluindo validaçÃŖo automÃĄtica, serializaçÃŖo, documentaçÃŖo interativa, autenticaçÃŖo com _tokens_ OAuth2 JWT etc.
-* **Senha segura** _hashing_ por padrÃŖo.
-* AutenticaçÃŖo **Token JWT**.
-* Modelos **SQLAlchemy** (independente de extensÃĩes Flask, para que eles possam ser usados com _workers_ Celery diretamente).
-* Modelos bÃĄsicos para usuÃĄrios (modifique e remova conforme suas necessidades).
-* MigraçÃĩes **Alembic**.
-* **CORS** (_Cross Origin Resource Sharing_ - Compartilhamento de Recursos Entre Origens).
-* _Worker_ **Celery** que pode importar e usar modelos e cÃŗdigos do resto do _backend_ seletivamente.
-* Testes _backend_ _REST_ baseados no **Pytest**, integrados com Docker, entÃŖo vocÃĒ pode testar a interaçÃŖo completa da API, independente do banco de dados. Como roda no Docker, ele pode construir um novo repositÃŗrio de dados do zero toda vez (assim vocÃĒ pode usar ElasticSearch, MongoDB, CouchDB, ou o que quiser, e apenas testar que a API esteja funcionando).
-* FÃĄcil integraçÃŖo com Python atravÊs dos **Kernels Jupyter** para desenvolvimento remoto ou no Docker com extensÃĩes como Atom Hydrogen ou Visual Studio Code Jupyter.
-* _Frontend_ **Vue**:
- * Gerado com Vue CLI.
- * Controle de **AutenticaçÃŖo JWT**.
- * VisualizaçÃŖo de _login_.
- * ApÃŗs o _login_, visualizaçÃŖo do painel de controle principal.
- * Painel de controle principal com criaçÃŖo e ediçÃŖo de usuÃĄrio.
- * EdiçÃŖo do prÃŗprio usuÃĄrio.
- * **Vuex**.
- * **Vue-router**.
- * **Vuetify** para belos componentes _material design_.
- * **TypeScript**.
- * Servidor Docker baseado em **Nginx** (configurado para rodar "lindamente" com Vue-router).
- * ConstruçÃŖo multi-estÃĄgio Docker, entÃŖo vocÃĒ nÃŖo precisa salvar ou _commitar_ cÃŗdigo compilado.
- * Testes _frontend_ rodados na hora da construçÃŖo (pode ser desabilitado tambÊm).
- * Feito tÃŖo modular quanto possÃvel, entÃŖo ele funciona fora da caixa, mas vocÃĒ pode gerar novamente com Vue CLI ou criar conforme vocÃĒ queira, e reutilizar o que quiser.
-* **PGAdmin** para banco de dados PostgreSQL, vocÃĒ pode modificar para usar PHPMyAdmin e MySQL facilmente.
-* **Flower** para monitoraçÃŖo de tarefas Celery.
-* Balanceamento de carga entre _frontend_ e _backend_ com **Traefik**, entÃŖo vocÃĒ pode ter ambos sob o mesmo domÃnio, separados por rota, mas servidos por diferentes containers.
-* IntegraçÃŖo Traefik, incluindo geraçÃŖo automÃĄtica de certificados **HTTPS** Let's Encrypt.
-* GitLab **CI** (integraçÃŖo contÃnua), incluindo testes _frontend_ e _backend_.
-
-## Full Stack FastAPI Couchbase
-
-GitHub: https://github.com/tiangolo/full-stack-fastapi-couchbase
-
-â ī¸ **WARNING** â ī¸
-
-Se vocÃĒ estÃĄ iniciando um novo projeto do zero, verifique as alternativas aqui.
-
-Por exemplo, o gerador de projetos Full Stack FastAPI PostgreSQL pode ser uma alternativa melhor, como ele Ê ativamente mantido e utilizado. E ele inclui todos os novos recursos e melhorias.
-
-VocÃĒ ainda Ê livre para utilizar o gerador baseado em Couchbase se quiser, ele provavelmente ainda funciona bem, e vocÃĒ jÃĄ tem um projeto gerado com ele que roda bem tambÊm (e vocÃĒ provavelmente jÃĄ atualizou ele para encaixar nas suas necessidades).
-
-VocÃĒ pode ler mais sobre nas documentaçÃŖoes do repositÃŗrio.
-
-## Full Stack FastAPI MongoDB
-
-...pode demorar, dependendo do meu tempo disponÃvel e outros fatores. đ
đ
-
-## Modelos de Aprendizado de MÃĄquina com spaCy e FastAPI
-
-GitHub: https://github.com/microsoft/cookiecutter-spacy-fastapi
-
-### Modelos de Aprendizado de MÃĄquina com spaCy e FastAPI - Recursos
-
-* IntegraçÃŖo com modelo NER **spaCy**.
-* Formato de requisiçÃŖo **Busca Cognitiva Azure** acoplado.
-* Servidor Python _web_ **Pronto para ProduçÃŖo** usando Uvicorn e Gunicorn.
-* ImplantaçÃŖo **Azure DevOps** Kubernetes (AKS) CI/CD acoplada.
-* **Multilingual** facilmente escolhido como uma das linguagens spaCy acopladas durante a configuraçÃŖo do projeto.
-* **Facilmente extensÃvel** para outros modelos de _frameworks_ (Pytorch, Tensorflow), nÃŖo apenas spaCy.
+# Full Stack FastAPI Template
+
+_Templates_, embora tipicamente venham com alguma configuraçÃŖo especÃfica, sÃŖo desenhados para serem flexÃveis e customizÃĄveis. Isso permite que vocÃĒ os modifique e adapte para as especificaçÃĩes do seu projeto, fazendo-os um excelente ponto de partida. đ
+
+VocÃĒ pode usar esse _template_ para começar, jÃĄ que ele inclui vÃĄrias configuraçÃĩes iniciais, segurança, banco de dados, e alguns _endpoints_ de API jÃĄ feitos para vocÃĒ.
+
+RepositÃŗrio GitHub: Full Stack FastAPI Template
+
+## Full Stack FastAPI Template - Pilha de Tecnologias e Recursos
+
+- ⥠[**FastAPI**](https://fastapi.tiangolo.com) para a API do backend em Python.
+ - 𧰠[SQLModel](https://sqlmodel.tiangolo.com) para as interaçÃĩes do Python com bancos de dados SQL (ORM).
+ - đ [Pydantic](https://docs.pydantic.dev), usado pelo FastAPI, para validaçÃŖo de dados e gerenciamento de configuraçÃĩes.
+ - đž [PostgreSQL](https://www.postgresql.org) como banco de dados SQL.
+- đ [React](https://react.dev) para o frontend.
+ - đ Usando TypeScript, hooks, [Vite](https://vitejs.dev), e outras partes de uma _stack_ frontend moderna.
+ - đ¨ [Chakra UI](https://chakra-ui.com) para os componentes de frontend.
+ - đ¤ Um cliente frontend automaticamente gerado.
+ - đ§Ē [Playwright](https://playwright.dev) para testes Ponta-a-Ponta.
+ - đĻ Suporte para modo escuro.
+- đ [Docker Compose](https://www.docker.com) para desenvolvimento e produçÃŖo.
+- đ _Hash_ seguro de senhas por padrÃŖo.
+- đ AutenticaçÃŖo por token JWT.
+- đĢ RecuperaçÃŖo de senhas baseada em email.
+- â
Testes com [Pytest](https://pytest.org).
+- đ [Traefik](https://traefik.io) como proxy reverso / balanceador de carga.
+- đĸ InstruçÃĩes de _deployment_ usando Docker Compose, incluindo como configurar um proxy frontend com Traefik para gerenciar automaticamente certificados HTTPS.
+- đ CI (IntegraçÃŖo ContÃnua) e CD (_Deploy_ ContÃnuo) baseado em GitHub Actions.
diff --git a/docs/pt/docs/tutorial/bigger-applications.md b/docs/pt/docs/tutorial/bigger-applications.md
index a094005fd..b621f3c72 100644
--- a/docs/pt/docs/tutorial/bigger-applications.md
+++ b/docs/pt/docs/tutorial/bigger-applications.md
@@ -52,7 +52,7 @@ from app.routers import items
* HÃĄ tambÊm um subdiretÃŗrio `app/internal/` com outro arquivo `__init__.py`, entÃŖo ele Ê outro "subpacote Python":`app.internal`.
* E o arquivo `app/internal/admin.py` Ê outro submÃŗdulo: `app.internal.admin`.
-XML .
+
+ĐŅ ĐŧĐžĐļĐĩŅĐĩ ĐŋĐžĐŧĐĩŅŅиŅŅ ваŅ XML-ĐēĐžĐŊŅĐĩĐŊŅ в ŅŅŅĐžĐēŅ, ĐŋĐžĐŧĐĩŅŅиŅŅ ĐĩŅ в `Response` и вĐĩŅĐŊŅŅŅ:
+
+{* ../../docs_src/response_directly/tutorial002.py hl[1,18] *}
+
+## ĐŅиĐŧĐĩŅĐ°ĐŊиŅ
+
+ĐĐžĐŗĐ´Đ° вŅ вОСвŅĐ°ŅĐ°ĐĩŅĐĩ ОйŅĐĩĐēŅ `Response` ĐŊĐ°ĐŋŅŅĐŧŅŅ, ĐĩĐŗĐž Đ´Đ°ĐŊĐŊŅĐĩ ĐŊĐĩ ваĐģидиŅŅŅŅŅŅ, ĐŊĐĩ ĐŋŅĐĩОйŅаСŅŅŅŅŅ (ĐŊĐĩ ŅĐĩŅиаĐģиСŅŅŅŅŅ) и ĐŊĐĩ Đ´ĐžĐēŅĐŧĐĩĐŊŅиŅŅŅŅŅŅ авŅĐžĐŧĐ°ŅиŅĐĩŅĐēи.
+
+ĐĐž вŅ вŅŅ ŅавĐŊĐž ĐŧĐžĐļĐĩŅĐĩ СадОĐēŅĐŧĐĩĐŊŅиŅОваŅŅ ŅŅĐž, ĐēĐ°Đē ĐžĐŋиŅĐ°ĐŊĐž в [ĐĐžĐŋĐžĐģĐŊиŅĐĩĐģŅĐŊŅĐĩ ĐžŅвĐĩŅŅ в OpenAPI](additional-responses.md){.internal-link target=_blank}.
+
+Đ ŅĐģĐĩĐ´ŅŅŅиŅ
ŅаСдĐĩĐģĐ°Ņ
вŅ ŅвидиŅĐĩ, ĐēĐ°Đē иŅĐŋĐžĐģŅСОваŅŅ/ОйŅŅвĐģŅŅŅ ŅĐ°ĐēиĐĩ ĐēĐ°ŅŅĐžĐŧĐŊŅĐĩ `Response`, ĐŋŅи ŅŅĐžĐŧ ŅĐžŅ
ŅĐ°ĐŊŅŅ авŅĐžĐŧĐ°ŅиŅĐĩŅĐēĐžĐĩ ĐŋŅĐĩОйŅаСОваĐŊиĐĩ Đ´Đ°ĐŊĐŊŅŅ
, Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅиŅ и Ņ.Đ´.
diff --git a/docs/ru/docs/deployment/concepts.md b/docs/ru/docs/deployment/concepts.md
index 7cdc29526..acfa1f4fe 100644
--- a/docs/ru/docs/deployment/concepts.md
+++ b/docs/ru/docs/deployment/concepts.md
@@ -216,7 +216,7 @@
ĐĐ°ĐļĐ´ŅĐš иС ŅŅиŅ
ĐŋŅĐžŅĐĩŅŅОв ĐąŅĐ´ĐĩŅ СаĐŋŅŅĐēĐ°ŅŅ ваŅĐĩ ĐŋŅиĐģĐžĐļĐĩĐŊиĐĩ Đ´ĐģŅ ОйŅайОŅĐēи ĐŋĐžĐģŅŅĐĩĐŊĐŊĐžĐŗĐž **СаĐŋŅĐžŅĐ°** и вОСвŅĐ°ŅĐĩĐŊиŅ вŅŅиŅĐģĐĩĐŊĐŊĐžĐŗĐž **ĐžŅвĐĩŅĐ°** и ĐžĐŊи ĐąŅĐ´ŅŅ иŅĐŋĐžĐģŅСОваŅŅ ĐžĐŋĐĩŅĐ°ŅивĐŊŅŅ ĐŋĐ°ĐŧŅŅŅ.
-
+
+
ĐŋŅиĐŊиĐŧĐ°ŅŅ Đģи cookies . đ¤ĒđĒ
+
+ĐŅ ĐŧĐžĐļĐĩŅĐĩ ŅĐēĐžĐŊŅиĐŗŅŅиŅОваŅŅ Pydantic-ĐŧОдĐĩĐģŅ ŅĐ°Đē, ŅŅОйŅ СаĐŋŅĐĩŅиŅŅ (`forbid`) ĐģŅĐąŅĐĩ Đ´ĐžĐŋĐžĐģĐŊиŅĐĩĐģŅĐŊŅĐĩ (`extra`) ĐŋĐžĐģŅ:
+
+{* ../../docs_src/cookie_param_models/tutorial002_an_py39.py hl[10] *}
+
+ĐŅĐģи ĐēĐģиĐĩĐŊŅ ĐŋĐžĐŋŅОйŅĐĩŅ ĐžŅĐŋŅавиŅŅ **Đ´ĐžĐŋĐžĐģĐŊиŅĐĩĐģŅĐŊŅĐĩ cookies**, ŅĐž в ĐžŅвĐĩŅ ĐžĐŊ ĐŋĐžĐģŅŅиŅ **ĐžŅийĐēŅ**.
+
+ĐĐĩĐ´ĐŊŅĐĩ йаĐŊĐŊĐĩŅŅ cookies, ĐžĐŊи вŅĐĩĐŧи ŅиĐģĐ°Đŧи ĐŋŅŅĐ°ŅŅŅŅ ĐŋĐžĐģŅŅиŅŅ ваŅĐĩ ŅĐžĐŗĐģĐ°ŅиĐĩ â и вŅŅ Ņади ŅĐžĐŗĐž, ŅŅОйŅ API ĐĩĐŗĐž ĐžŅĐēĐģĐžĐŊиĐģ . đĒ
+
+ĐĐ°ĐŋŅиĐŧĐĩŅ, ĐĩŅĐģи ĐēĐģиĐĩĐŊŅ ĐŋĐžĐŋŅŅĐ°ĐĩŅŅŅ ĐžŅĐŋŅавиŅŅ cookie `santa_tracker` ŅĐž СĐŊĐ°ŅĐĩĐŊиĐĩĐŧ `good-list-please`, ŅĐž в ĐžŅвĐĩŅ ĐžĐŊ ĐŋĐžĐģŅŅиŅ **ĐžŅийĐēŅ**, ŅООйŅĐ°ŅŅŅŅ ĐĩĐŧŅ, ŅŅĐž cookie `santa_tracker` ĐŊĐĩ ŅаСŅĐĩŅŅĐŊ :
+
+```json
+{
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["cookie", "santa_tracker"],
+ "msg": "Extra inputs are not permitted",
+ "input": "good-list-please"
+ }
+ ]
+}
+```
+
+## ĐĐ°ĐēĐģŅŅĐĩĐŊиĐĩ
+
+ĐŅ ĐŧĐžĐļĐĩŅĐĩ иŅĐŋĐžĐģŅСОваŅŅ **Pydantic-ĐŧОдĐĩĐģи** Đ´ĐģŅ ОйŅŅвĐģĐĩĐŊиŅ **cookies** в **FastAPI**. đ
diff --git a/docs/ru/docs/tutorial/header-param-models.md b/docs/ru/docs/tutorial/header-param-models.md
new file mode 100644
index 000000000..4f54e3e15
--- /dev/null
+++ b/docs/ru/docs/tutorial/header-param-models.md
@@ -0,0 +1,72 @@
+# ĐОдĐĩĐģи Header-ĐŋĐ°ŅĐ°ĐŧĐĩŅŅОв
+
+ĐŅĐģи Ņ ваŅ ĐĩŅŅŅ ĐŗŅŅĐŋĐŋĐ° ŅвŅСаĐŊĐŊŅŅ
**header-ĐŋĐ°ŅĐ°ĐŧĐĩŅŅОв**, ŅĐž вŅ ĐŧĐžĐļĐĩŅĐĩ ОйŅĐĩдиĐŊиŅŅ иŅ
в ОдĐŊŅ **Pydantic-ĐŧОдĐĩĐģŅ**.
+
+ĐŅĐž ĐŋОСвОĐģиŅ ваĐŧ **ĐŋĐĩŅĐĩиŅĐŋĐžĐģŅСОваŅŅ ĐŧОдĐĩĐģŅ** в **ŅаСĐŊŅŅ
ĐŧĐĩŅŅĐ°Ņ
**, Đ° ŅĐ°ĐēĐļĐĩ СадаŅŅ ваĐģидаŅиŅ и ĐŧĐĩŅĐ°Đ´Đ°ĐŊĐŊŅĐĩ ŅŅаСŅ Đ´ĐģŅ вŅĐĩŅ
ĐŋĐ°ŅĐ°ĐŧĐĩŅŅОв. đ
+
+/// note | ĐĐ°ĐŧĐĩŅĐēĐ°
+
+ĐŅĐžŅ ŅŅĐŊĐēŅиОĐŊĐ°Đģ Đ´ĐžŅŅŅĐŋĐĩĐŊ в FastAPI ĐŊĐ°ŅиĐŊĐ°Ņ Ņ вĐĩŅŅии `0.115.0`. đ¤
+
+///
+
+## Header-ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅ в видĐĩ Pydantic-ĐŧОдĐĩĐģи
+
+ĐĐąŅŅвиŅĐĩ ĐŊŅĐļĐŊŅĐĩ **header-ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅ** в **Pydantic-ĐŧОдĐĩĐģи** и СаŅĐĩĐŧ Đ°ĐŊĐŊĐžŅиŅŅĐšŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ĐēĐ°Đē `Header`:
+
+{* ../../docs_src/header_param_models/tutorial001_an_py310.py hl[9:14,18] *}
+
+**FastAPI** **иСвĐģĐĩŅŅŅ** Đ´Đ°ĐŊĐŊŅĐĩ Đ´ĐģŅ **ĐēĐ°ĐļĐ´ĐžĐŗĐž ĐŋĐžĐģŅ** иС **СаĐŗĐžĐģОвĐēОв** СаĐŋŅĐžŅĐ° и вŅĐ´Đ°ŅŅ СадаĐŊĐŊŅŅ ваĐŧи Pydantic-ĐŧОдĐĩĐģŅ.
+
+## ĐŅОвĐĩŅŅŅĐĩ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅиŅ
+
+ĐŅ ĐŧĐžĐļĐĩŅĐĩ ĐŋĐžŅĐŧĐžŅŅĐĩŅŅ ĐŊŅĐļĐŊŅĐĩ header-ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅ в ĐŗŅĐ°ŅиŅĐĩŅĐēĐžĐŧ иĐŊŅĐĩŅŅĐĩĐšŅĐĩ ŅĐŗĐĩĐŊĐĩŅиŅОваĐŊĐŊОК Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°Ņии ĐŋĐž ĐŋŅŅи `/docs`:
+
+
+
+
`python-multipart` .
+
+ĐŖĐąĐĩдиŅĐĩŅŅ, ŅŅĐž вŅ ŅОСдаĐģи и Đ°ĐēŅивиŅОваĐģи [виŅŅŅĐ°ĐģŅĐŊĐžĐĩ ĐžĐēŅŅĐļĐĩĐŊиĐĩ](../virtual-environments.md){.internal-link target=_blank}, Đ° СаŅĐĩĐŧ ŅŅŅĐ°ĐŊОвиŅĐĩ ĐŋĐ°ĐēĐĩŅ, ĐŊĐ°ĐŋŅиĐŧĐĩŅ:
+
+```console
+$ pip install python-multipart
+```
+
+///
+
+/// note | ĐĐ°ĐŧĐĩŅĐēĐ°
+
+ĐŅĐžŅ ŅŅĐŊĐēŅиОĐŊĐ°Đģ Đ´ĐžŅŅŅĐŋĐĩĐŊ Ņ вĐĩŅŅии `0.113.0`. đ¤
+
+///
+
+## Pydantic-ĐŧОдĐĩĐģŅ Đ´ĐģŅ ŅĐžŅĐŧŅ
+
+ĐĐ°Đŧ ĐŋŅĐžŅŅĐž ĐŊŅĐļĐŊĐž ОйŅŅвиŅŅ **Pydantic-ĐŧОдĐĩĐģŅ** Ņ ĐŋĐžĐģŅĐŧи, ĐēĐžŅĐžŅŅĐĩ вŅ Ņ
ĐžŅиŅĐĩ ĐŋĐžĐģŅŅиŅŅ ĐēĐ°Đē **ĐŋĐžĐģŅ ŅĐžŅĐŧŅ**, Đ° СаŅĐĩĐŧ ОйŅŅвиŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ĐēĐ°Đē `Form`:
+
+{* ../../docs_src/request_form_models/tutorial001_an_py39.py hl[9:11,15] *}
+
+**FastAPI** **иСвĐģĐĩŅŅŅ** Đ´Đ°ĐŊĐŊŅĐĩ Đ´ĐģŅ **ĐēĐ°ĐļĐ´ĐžĐŗĐž ĐŋĐžĐģŅ** иС **Đ´Đ°ĐŊĐŊŅŅ
ŅĐžŅĐŧŅ** в СаĐŋŅĐžŅĐĩ и вŅĐ´Đ°ŅŅ ваĐŧ ОйŅŅвĐģĐĩĐŊĐŊŅŅ Pydantic-ĐŧОдĐĩĐģŅ.
+
+## ĐŅОвĐĩŅĐēĐ° ŅĐŗĐĩĐŊĐĩŅиŅОваĐŊĐŊОК Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°Ņии
+
+ĐŅ ĐŧĐžĐļĐĩŅĐĩ ĐŋĐžŅĐŧĐžŅŅĐĩŅŅ ĐŋĐžĐģŅ ŅĐžŅĐŧŅ в ĐŗŅĐ°ŅиŅĐĩŅĐēĐžĐŧ иĐŊŅĐĩŅŅĐĩĐšŅĐĩ ĐĐžĐēŅĐŧĐĩĐŊŅĐ°Ņии ĐŋĐž ĐŋŅŅи `/docs`:
+
+
+
+
`starlette.background` .
+
+ĐŅĐŊ ŅĐŧĐŋĐžŅŅŅŅŅŅŅŅ ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž Ņ FastAPI, ŅОй Đи ĐŧĐžĐŗĐģи виĐēĐžŅиŅŅОвŅваŅи КОĐŗĐž С `fastapi` Ņ виĐŋĐ°Đ´ĐēОвО ĐŊĐĩ ŅĐŧĐŋĐžŅŅŅваĐģи `BackgroundTask` (ĐąĐĩС s в ĐēŅĐŊŅŅ) С `starlette.background`.
+
+Đ¯ĐēŅĐž виĐēĐžŅиŅŅОвŅваŅи ĐģиŅĐĩ `BackgroundTasks` (Đ° ĐŊĐĩ `BackgroundTask`), ŅĐž КОĐŗĐž ĐŧĐžĐļĐŊĐ° ĐŋĐĩŅĐĩдаваŅи ŅĐē ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ Ņ *ŅŅĐŊĐēŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*, Ņ **FastAPI** ĐŋОдйаŅ ĐŋŅĐž вŅĐĩ ŅĐŊŅĐĩ, ŅĐ°Đē ŅĐ°ĐŧĐž ŅĐē Ņ ĐŋŅĐž виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ Ой'ŅĐēŅĐ° `Request`.
+
+ĐĸĐ°ĐēĐžĐļ ĐŧĐžĐļĐŊĐ° виĐēĐžŅиŅŅОвŅваŅи `BackgroundTask` ĐžĐēŅĐĩĐŧĐž в FastAPI, Đ°ĐģĐĩ Đ´ĐģŅ ŅŅĐžĐŗĐž ĐĐ°Đŧ дОвĐĩĐ´ĐĩŅŅŅŅ ŅŅвОŅиŅи Ой'ŅĐēŅ Ņ ĐēОдŅ ŅĐ° ĐŋОвĐĩŅĐŊŅŅи Starlette `Response`, вĐēĐģŅŅĐ°ŅŅи КОĐŗĐž.
+
+ĐĐĩŅĐ°ĐģŅĐŊŅŅĐĩ ĐŧĐžĐļĐŊĐ° ĐŋĐžŅиŅĐ°Ņи в ĐžŅŅŅŅĐšĐŊŅĐš Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Starlette ĐŋŅĐž ŅĐžĐŊОвŅ СадаŅŅ .
+
+## ĐĐ°ŅŅĐĩŅĐĩĐļĐĩĐŊĐŊŅ
+
+Đ¯ĐēŅĐž ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž виĐēĐžĐŊŅваŅи ŅĐēĐģĐ°Đ´ĐŊŅ ŅĐžĐŊОвŅ ОйŅиŅĐģĐĩĐŊĐŊŅ, Ņ ĐŋŅи ŅŅĐžĐŧŅ ĐŊĐĩĐŧĐ° ĐŋĐžŅŅĐĩйи СаĐŋŅŅĐēĐ°Ņи ŅŅ
Ņ ŅĐžĐŧŅ Đļ ĐŋŅĐžŅĐĩŅŅ (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, ĐŊĐĩ ĐŋĐžŅŅŅĐąĐŊĐž ŅĐŋŅĐģŅĐŊĐžĐŗĐž Đ´ĐžŅŅŅĐŋŅ Đ´Đž ĐŋĐ°ĐŧâŅŅŅ Ņи СĐŧŅĐŊĐŊиŅ
), ĐŧĐžĐļĐģивО, ваŅŅĐž ŅĐēĐžŅиŅŅĐ°ŅиŅŅ ĐąŅĐģŅŅ ĐŋĐžŅŅĐļĐŊиĐŧи ŅĐŊŅŅŅŅĐŧĐĩĐŊŅĐ°Đŧи, ŅĐ°ĐēиĐŧи ŅĐē Celery .
+
+ĐĸĐ°ĐēŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи СаСвиŅĐ°Đš ĐŋĐžŅŅĐĩĐąŅŅŅŅ ŅĐēĐģĐ°Đ´ĐŊŅŅĐžŅ ĐēĐžĐŊŅŅĐŗŅŅĐ°ŅŅŅ ŅĐ° ĐŧĐĩĐŊĐĩĐ´ĐļĐĩŅĐ° ŅĐĩŅĐŗи ĐŋОвŅĐ´ĐžĐŧĐģĐĩĐŊŅ/СавдаĐŊŅ, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, RabbitMQ айО Redis. ĐĐ´ĐŊĐ°Đē вОĐŊи дОСвОĐģŅŅŅŅ виĐēĐžĐŊŅваŅи ŅĐžĐŊОвŅ СадаŅŅ в ĐēŅĐģŅĐēĐžŅ
ĐŋŅĐžŅĐĩŅĐ°Ņ
Ņ ĐŊавŅŅŅ ĐŊĐ° ĐēŅĐģŅĐēĐžŅ
ŅĐĩŅвĐĩŅĐ°Ņ
.
+
+Đ¯ĐēŅĐž Đļ ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž ĐžŅŅиĐŧĐ°Ņи Đ´ĐžŅŅŅĐŋ Đ´Đž СĐŧŅĐŊĐŊиŅ
Ņ ОйâŅĐēŅŅв ŅС ŅŅŅŅ Đļ **FastAPI** - ĐŋŅĐžĐŗŅĐ°Đŧи айО виĐēĐžĐŊŅваŅи ĐŊĐĩвĐĩĐģиĐēŅ ŅĐžĐŊОвŅ СавдаĐŊĐŊŅ (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, ĐŊĐ°Đ´ŅиĐģĐ°Ņи ŅĐŋОвŅŅĐĩĐŊĐŊŅ ĐĩĐģĐĩĐēŅŅĐžĐŊĐŊĐžŅ ĐŋĐžŅŅĐžŅ), Đ´ĐžŅŅĐ°ŅĐŊŅĐž ĐŋŅĐžŅŅĐž виĐēĐžŅиŅŅОвŅваŅи `BackgroundTasks`.
+
+## ĐŅĐ´ŅŅĐŧĐžĐē
+
+ĐĐŧĐŋĐžŅŅŅĐšŅĐĩ ŅĐ° виĐēĐžŅиŅŅОвŅĐšŅĐĩ `BackgroundTasks` ŅĐē ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ Ņ *ŅŅĐŊĐēŅŅŅŅ
ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ* ŅĐ° СаĐģĐĩĐļĐŊĐžŅŅŅŅ
, ŅОй дОдаваŅи ŅĐžĐŊОвŅ СадаŅŅ.
diff --git a/docs/uk/docs/tutorial/body-updates.md b/docs/uk/docs/tutorial/body-updates.md
new file mode 100644
index 000000000..e78b5a5bf
--- /dev/null
+++ b/docs/uk/docs/tutorial/body-updates.md
@@ -0,0 +1,116 @@
+# ĐĸŅĐģĐž â ĐĐŊОвĐģĐĩĐŊĐŊŅ
+
+## ĐĐŊОвĐģĐĩĐŊĐŊŅ С виĐēĐžŅиŅŅĐ°ĐŊĐŊŅĐŧ `PUT`
+
+ЊОй ĐžĐŊОвиŅи ĐĩĐģĐĩĐŧĐĩĐŊŅ, Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи HTTP `PUT` ĐžĐŋĐĩŅĐ°ŅŅŅ.
+
+Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи `jsonable_encoder`, ŅОй ĐŋĐĩŅĐĩŅвОŅиŅи вŅ
ŅĐ´ĐŊŅ Đ´Đ°ĐŊŅ ĐŊĐ° ŅĐ°ĐēŅ, ŅĐēŅ ĐŧĐžĐļĐŊĐ° СйĐĩŅŅĐŗĐ°Ņи ŅĐē JSON (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, Ņ NoSQL йаСŅ Đ´Đ°ĐŊиŅ
). ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ĐŋĐĩŅĐĩŅвОŅŅŅŅи `datetime` Ņ `str`.
+
+{* ../../docs_src/body_updates/tutorial001_py310.py hl[28:33] *}
+
+`PUT` виĐēĐžŅиŅŅОвŅŅŅŅŅŅ Đ´ĐģŅ ĐžŅŅиĐŧĐ°ĐŊĐŊŅ Đ´Đ°ĐŊиŅ
, ŅĐēŅ ĐŧĐ°ŅŅŅ СаĐŧŅĐŊиŅи ŅиĐŊĐŊŅ Đ´Đ°ĐŊŅ.
+
+### ĐĐžĐŋĐĩŅĐĩĐ´ĐļĐĩĐŊĐŊŅ ĐŋŅĐž СаĐŧŅĐŊŅ
+
+ĐĻĐĩ ОСĐŊĐ°ŅĐ°Ņ, ŅĐž ŅĐēŅĐž Đи Ņ
ĐžŅĐĩŅĐĩ ĐžĐŊОвиŅи ĐĩĐģĐĩĐŧĐĩĐŊŅ `bar`, виĐēĐžŅиŅŅОвŅŅŅи `PUT` С ŅŅĐģĐžĐŧ:
+
+```Python
+{
+ "name": "Barz",
+ "price": 3,
+ "description": None,
+}
+```
+
+ĐžŅĐēŅĐģŅĐēи вŅĐŊ ĐŊĐĩ ĐŧŅŅŅиŅŅ вĐļĐĩ СйĐĩŅĐĩĐļĐĩĐŊĐžĐŗĐž Đ°ŅŅийŅŅĐ° `"tax": 20.2`, ĐŧОдĐĩĐģŅ ввĐĩĐ´ĐĩĐŊĐŊŅ ĐŋŅиКĐŧĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ `"tax": 10.5`.
+
+Đ Đ´Đ°ĐŊŅ ĐąŅĐ´ŅŅŅ СйĐĩŅĐĩĐļĐĩĐŊŅ С ŅиĐŧ "ĐŊОвиĐŧ" СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ `tax` = `10.5`.
+
+## ЧаŅŅĐēОвŅ ĐžĐŊОвĐģĐĩĐŊĐŊŅ С `PATCH`
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ĐžĐŋĐĩŅĐ°ŅŅŅ HTTP `PATCH` Đ´ĐģŅ *ŅĐ°ŅŅĐēОвОĐŗĐž* ĐžĐŊОвĐģĐĩĐŊĐŊŅ Đ´Đ°ĐŊиŅ
.
+
+ĐĻĐĩ ОСĐŊĐ°ŅĐ°Ņ, ŅĐž Đи ĐŧĐžĐļĐĩŅĐĩ ĐŊĐ°Đ´ŅŅĐģĐ°Ņи ĐģиŅĐĩ ŅŅ Đ´Đ°ĐŊŅ, ŅĐēŅ Ņ
ĐžŅĐĩŅĐĩ ĐžĐŊОвиŅи, СаĐģиŅĐ°ŅŅи ŅĐŊŅŅ ĐąĐĩС СĐŧŅĐŊ.
+
+/// note | ĐŅиĐŧŅŅĐēĐ°
+
+`PATCH` ĐŧĐĩĐŊŅ вŅĐ´ĐžĐŧиК Ņ ŅŅĐ´ŅĐĩ виĐēĐžŅиŅŅОвŅŅŅŅŅŅ, ĐŊŅĐļ `PUT`.
+
+РйаĐŗĐ°ŅĐž ĐēĐžĐŧĐ°ĐŊĐ´ виĐēĐžŅиŅŅОвŅŅŅŅ ĐģиŅĐĩ `PUT`, ĐŊавŅŅŅ Đ´ĐģŅ ŅĐ°ŅŅĐēОвиŅ
ĐžĐŊОвĐģĐĩĐŊŅ.
+
+Đи **вŅĐģŅĐŊŅ** виĐēĐžŅиŅŅОвŅваŅи ŅŅ
ŅĐ°Đē, ŅĐē Ņ
ĐžŅĐĩŅĐĩ, **FastAPI** ĐŊĐĩ ĐŊĐ°ĐēĐģĐ°Đ´Đ°Ņ ОйĐŧĐĩĐļĐĩĐŊŅ.
+
+ĐĐģĐĩ ŅĐĩĐš ĐŋĐžŅŅĐąĐŊиĐē ĐŋĐžĐēаСŅŅ ĐĐ°Đŧ ĐąŅĐģŅŅ-ĐŧĐĩĐŊŅ ŅĐē ŅŅ
СадŅĐŧĐ°ĐŊĐž виĐēĐžŅиŅŅОвŅваŅи.
+
+///
+
+### ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `exclude_unset` Ņ Pydantic
+
+Đ¯ĐēŅĐž Đи Ņ
ĐžŅĐĩŅĐĩ ĐžŅŅиĐŧĐ°Ņи ŅĐ°ŅŅĐēОвŅ ĐžĐŊОвĐģĐĩĐŊĐŊŅ, Đ´ŅĐļĐĩ СŅŅŅĐŊĐž виĐēĐžŅиŅŅОвŅваŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `exclude_unset` Ņ ĐŧĐĩŅОдŅ `.model_dump()` ĐŧОдĐĩĐģŅ Pydantic.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´: `item.model_dump(exclude_unset=True)`.
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐŖ Pydantic v1 ŅĐĩĐš ĐŧĐĩŅОд ĐŊаСивавŅŅ `.dict()`, вŅĐŊ ĐąŅв СаŅŅĐ°ŅŅĐģиК (Đ°ĐģĐĩ вŅĐĩ ŅĐĩ ĐŋŅĐ´ŅŅиĐŧŅŅŅŅŅŅ) Ņ Pydantic v2, Ņ ĐąŅв ĐŋĐĩŅĐĩĐšĐŧĐĩĐŊОваĐŊиК Ņ `.model_dump()`.
+
+ĐŅиĐēĐģади ŅŅŅ виĐēĐžŅиŅŅОвŅŅŅŅ `.dict()` Đ´ĐģŅ ŅŅĐŧŅŅĐŊĐžŅŅŅ С Pydantic v1, Đ°ĐģĐĩ ĐĐ°Đŧ ŅĐģŅĐ´ виĐēĐžŅиŅŅОвŅваŅи `.model_dump()`, ŅĐēŅĐž ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи Pydantic v2.
+
+///
+
+ĐĻĐĩ ŅŅвОŅиŅŅ `dict` ĐģиŅĐĩ С ŅиĐŧи Đ´Đ°ĐŊиĐŧи, ŅĐēŅ ĐąŅĐģи ŅвĐŊĐž вŅŅĐ°ĐŊОвĐģĐĩĐŊŅ ĐŋŅĐ´ ŅĐ°Ņ ŅŅвОŅĐĩĐŊĐŊŅ ĐŧОдĐĩĐģŅ `item`, виĐēĐģŅŅĐ°ŅŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ.
+
+ĐĸОдŅ Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ŅĐĩ, ŅОй ŅŅвОŅиŅи `dict` ĐģиŅĐĩ С Đ´Đ°ĐŊиĐŧи, ŅĐēŅ ĐąŅĐģи вŅŅĐ°ĐŊОвĐģĐĩĐŊŅ (ĐŊĐ°Đ´ŅŅĐģĐ°ĐŊŅ Ņ СаĐŋиŅŅ), ĐŋŅĐžĐŋŅŅĐēĐ°ŅŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ:
+
+{* ../../docs_src/body_updates/tutorial002_py310.py hl[32] *}
+
+### ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `update` Ņ Pydantic
+
+ĐĸĐĩĐŋĐĩŅ Đи ĐŧĐžĐļĐĩŅĐĩ ŅŅвОŅиŅи ĐēĐžĐŋŅŅ ĐŊĐ°ŅвĐŊĐžŅ ĐŧОдĐĩĐģŅ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `.model_copy()`, Ņ ĐŋĐĩŅĐĩĐ´Đ°Ņи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `update` С `dict` , ŅĐēиК ĐŧŅŅŅиŅŅ Đ´Đ°ĐŊŅ Đ´ĐģŅ ĐžĐŊОвĐģĐĩĐŊĐŊŅ.
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐŖ Pydantic v1 ĐŧĐĩŅОд ĐŊаСивавŅŅ `.copy()`, вŅĐŊ ĐąŅв СаŅŅĐ°ŅŅĐģиК (Đ°ĐģĐĩ вŅĐĩ ŅĐĩ ĐŋŅĐ´ŅŅиĐŧŅŅŅŅŅŅ) Ņ Pydantic v2, Ņ ĐąŅв ĐŋĐĩŅĐĩĐšĐŧĐĩĐŊОваĐŊиК Ņ `.model_copy()`.
+
+ĐŅиĐēĐģади ŅŅŅ виĐēĐžŅиŅŅОвŅŅŅŅ `.copy()` Đ´ĐģŅ ŅŅĐŧŅŅĐŊĐžŅŅŅ С Pydantic v1, Đ°ĐģĐĩ ŅĐēŅĐž Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи Pydantic v2 â ĐĐ°Đŧ ŅĐģŅĐ´ виĐēĐžŅиŅŅОвŅваŅи `.model_copy()` СаĐŧŅŅŅŅ ŅŅĐžĐŗĐž.
+
+///
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´: `stored_item_model.model_copy(update=update_data)`:
+
+{* ../../docs_src/body_updates/tutorial002_py310.py hl[33] *}
+
+### ĐŅĐ´ŅŅĐŧĐžĐē ŅĐ°ŅŅĐēОвиŅ
ĐžĐŊОвĐģĐĩĐŊŅ
+
+ĐŖ ĐŋŅĐ´ŅŅĐŧĐēŅ, ŅОй СаŅŅĐžŅŅваŅи ŅĐ°ŅŅĐēОвŅ ĐžĐŊОвĐģĐĩĐŊĐŊŅ, Đи:
+
+* (ĐĐŋŅŅĐžĐŊĐ°ĐģŅĐŊĐž) виĐēĐžŅиŅŅОвŅŅŅĐĩ `PATCH` СаĐŧŅŅŅŅ `PUT`.
+* ĐŅŅиĐŧŅŅŅĐĩ СйĐĩŅĐĩĐļĐĩĐŊŅ Đ´Đ°ĐŊŅ.
+* ĐĐžĐŧŅŅĐ°ŅŅĐĩ ŅŅ Đ´Đ°ĐŊŅ в ĐŧОдĐĩĐģŅ Pydantic.
+* ĐĐĩĐŊĐĩŅŅŅŅĐĩ `dict` ĐąĐĩС СĐŊĐ°ŅĐĩĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ С ĐŧОдĐĩĐģŅ ввĐĩĐ´ĐĩĐŊĐŊŅ (виĐēĐžŅиŅŅОвŅŅŅи `exclude_unset`).
+ * ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ Đи ĐžĐŊОвиŅĐĩ ĐģиŅĐĩ ŅŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ, ŅĐēŅ ĐąŅĐģи ŅвĐŊĐž СадаĐŊŅ ĐēĐžŅиŅŅŅваŅĐĩĐŧ, СаĐŧŅŅŅŅ ŅĐžĐŗĐž, ŅОй ĐŋĐĩŅĐĩСаĐŋиŅŅваŅи вĐļĐĩ СйĐĩŅĐĩĐļĐĩĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ С ваŅĐžŅ ĐŧОдĐĩĐģŅ.
+* ĐĄŅвОŅŅŅŅĐĩ ĐēĐžĐŋŅŅ СйĐĩŅĐĩĐļĐĩĐŊĐžŅ ĐŧОдĐĩĐģŅ, ĐžĐŊОвĐģŅŅŅи ŅŅ Đ°ŅŅийŅŅи ĐžŅŅиĐŧĐ°ĐŊиĐŧи ŅĐ°ŅŅĐēОвиĐŧи ĐžĐŊОвĐģĐĩĐŊĐŊŅĐŧи (виĐēĐžŅиŅŅОвŅŅŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `update`).
+* ĐĐĩŅĐĩŅвОŅŅŅŅĐĩ ŅĐēĐžĐŋŅКОваĐŊŅ ĐŧОдĐĩĐģŅ ĐŊĐ° ŅĐžŅŅ, ŅĐž ĐŧĐžĐļĐŊĐ° СйĐĩŅĐĩĐŗŅи Ņ ваŅŅ ĐĐ (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, виĐēĐžŅиŅŅОвŅŅŅи `jsonable_encoder`).
+ * ĐĻĐĩ ĐŧĐžĐļĐŊĐ° ĐŋĐžŅŅвĐŊŅŅи С ĐŋОвŅĐžŅĐŊиĐŧ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅĐŧ ĐŧĐĩŅОдŅ `.model_dump()` ĐŧОдĐĩĐģŅ, Đ°ĐģĐĩ ŅĐĩ ĐŗĐ°ŅĐ°ĐŊŅŅŅ (Ņ ĐŋĐĩŅĐĩŅвОŅŅŅ) СĐŊĐ°ŅĐĩĐŊĐŊŅ Ņ ŅиĐŋи Đ´Đ°ĐŊиŅ
, ŅĐēŅ ĐŧĐžĐļĐŊĐ° ĐŋĐĩŅĐĩŅвОŅиŅи ĐŊĐ° JSON, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, `datetime` ĐŊĐ° `str`.
+* ĐĐąĐĩŅŅĐŗĐ°ŅŅĐĩ Đ´Đ°ĐŊŅ Ņ ваŅŅ ĐĐ.
+* ĐОвĐĩŅŅĐ°ŅŅĐĩ ĐžĐŊОвĐģĐĩĐŊŅ ĐŧОдĐĩĐģŅ.
+
+{* ../../docs_src/body_updates/tutorial002_py310.py hl[28:35] *}
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐĐ°ŅĐŋŅавдŅ Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ŅŅ ŅĐ°ĐŧŅ ŅĐĩŅ
ĐŊŅĐēŅ Ņ С ĐžĐŋĐĩŅĐ°ŅŅŅŅ HTTP `PUT`.
+
+ĐĐģĐĩ ĐŋŅиĐēĐģĐ°Đ´ ŅŅŅ виĐēĐžŅиŅŅОвŅŅ `PATCH`, ŅĐžĐŧŅ ŅĐž вŅĐŊ ĐąŅв ŅŅвОŅĐĩĐŊиК ŅĐ°ĐŧĐĩ Đ´ĐģŅ ŅĐ°ĐēиŅ
виĐŋĐ°Đ´ĐēŅв.
+
+///
+
+/// note | ĐŅиĐŧŅŅĐēĐ°
+
+ĐвĐĩŅĐŊŅŅŅ ŅваĐŗŅ, ŅĐž ĐŧОдĐĩĐģŅ СаĐŋиŅŅ вŅĐĩ ŅĐĩ ĐŋŅĐžŅ
ОдиŅŅ ваĐģŅĐ´Đ°ŅŅŅ.
+
+ĐĸĐžĐļ, ŅĐēŅĐž Đи Ņ
ĐžŅĐĩŅĐĩ ĐžŅŅиĐŧŅваŅи ŅĐ°ŅŅĐēОвŅ ĐžĐŊОвĐģĐĩĐŊĐŊŅ, ŅĐēŅ ĐŧĐžĐļŅŅŅ ĐŊĐĩ ĐŧŅŅŅиŅи ĐļОдĐŊĐžĐŗĐž Đ°ŅŅийŅŅĐ°, ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž ĐŧĐ°Ņи ĐŧОдĐĩĐģŅ, Đ´Đĩ вŅŅ Đ°ŅŅийŅŅи ĐŋОСĐŊĐ°ŅĐĩĐŊŅ ŅĐē ĐŊĐĩОйОвâŅСĐēОвŅ (СŅ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ айО `None`).
+
+ЊОй ŅОСŅŅСĐŊŅŅи ĐŧОдĐĩĐģŅ С ŅŅŅĐŧĐ° ĐŊĐĩОйОвâŅСĐēОвиĐŧи СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи Đ´ĐģŅ **ĐžĐŊОвĐģĐĩĐŊĐŊŅ** Ņ ĐŧОдĐĩĐģŅ С ОйОвâŅСĐēОвиĐŧи СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи Đ´ĐģŅ **ŅŅвОŅĐĩĐŊĐŊŅ**, Đи ĐŧĐžĐļĐĩŅĐĩ ŅĐēĐžŅиŅŅĐ°ŅиŅŅ ŅĐ´ĐĩŅĐŧи, ĐžĐŋиŅĐ°ĐŊиĐŧи Ņ [ĐОдаŅĐēОвŅ ĐŧОдĐĩĐģŅ](extra-models.md){.internal-link target=_blank}.
+
+///
diff --git a/docs/uk/docs/tutorial/cookie-param-models.md b/docs/uk/docs/tutorial/cookie-param-models.md
new file mode 100644
index 000000000..f070b6ac8
--- /dev/null
+++ b/docs/uk/docs/tutorial/cookie-param-models.md
@@ -0,0 +1,76 @@
+# ĐОдĐĩĐģŅ Đ´ĐģŅ Cookie-ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв
+
+Đ¯ĐēŅĐž Ņ ĐĐ°Ņ Ņ ĐŗŅŅĐŋĐ° **cookies** ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв, ŅĐēŅ ĐŋОв'ŅСаĐŊŅ ĐŧŅĐļ ŅОйОŅ, Đи ĐŧĐžĐļĐĩŅĐĩ ŅŅвОŅиŅи **Pydantic-ĐŧОдĐĩĐģŅ**, ŅОй ĐžĐŗĐžĐģĐžŅиŅи ŅŅ
. đĒ
+
+ĐĻĐĩ дОСвОĐģиŅŅ ĐĐ°Đŧ ĐŋОвŅĐžŅĐŊĐž **виĐēĐžŅиŅŅОвŅваŅи ĐŧОдĐĩĐģŅ** Ņ **ŅŅСĐŊиŅ
ĐŧŅŅŅŅŅ
**, Đ° ŅĐ°ĐēĐžĐļ ĐžĐŗĐžĐģĐžŅиŅи ваĐģŅĐ´Đ°ŅŅŅ ŅĐ° ĐŧĐĩŅĐ°Đ´Đ°ĐŊŅ Đ´ĐģŅ вŅŅŅ
ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв ОдĐŊĐžŅĐ°ŅĐŊĐž. đ
+
+/// note | ĐĐžŅĐ°ŅĐēи
+
+ĐĻĐĩ ĐŋŅĐ´ŅŅиĐŧŅŅŅŅŅŅ С вĐĩŅŅŅŅ FastAPI `0.115.0`. đ¤
+
+///
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐĻŅ Đļ ŅĐĩŅ
ĐŊŅĐēĐ° СаŅŅĐžŅОвŅŅŅŅŅŅ Đ´Đž `Query`, `Cookie`, ŅĐ° `Header`. đ
+
+///
+
+## Cookie С Pydantic-ĐŧОдĐĩĐģĐģŅ
+
+ĐĐŗĐžĐģĐžŅŅŅŅ **cookie-ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи**, ŅĐēŅ ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊŅ, Ņ **Pydantic-ĐŧОдĐĩĐģŅ**, Đ° ĐŋĐžŅŅĐŧ ĐžĐŗĐžĐģĐžŅŅŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ŅĐē `Cookie`:
+
+{* ../../docs_src/cookie_param_models/tutorial001_an_py310.py hl[9:12,16] *}
+
+**FastAPI** ĐąŅĐ´Đĩ **виŅŅĐŗŅваŅи** Đ´Đ°ĐŊŅ Đ´ĐģŅ **ĐēĐžĐļĐŊĐžĐŗĐž ĐŋĐžĐģŅ** С **cookie** ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв, ĐžŅŅиĐŧĐ°ĐŊиŅ
Ņ СаĐŋиŅŅ, Ņ ĐŋĐĩŅĐĩдаваŅи ĐĐ°Đŧ Pydantic-ĐŧОдĐĩĐģŅ, ŅĐēŅ Đи виСĐŊĐ°ŅиĐģи.
+
+## ĐĐĩŅĐĩвŅŅĐēĐ° Ņ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋОйаŅиŅи виСĐŊĐ°ŅĐĩĐŊŅ cookie в ŅĐŊŅĐĩŅŅĐĩĐšŅŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Са Đ°Đ´ŅĐĩŅĐžŅ `/docs`:
+
+
+
+
СĐŗОдŅ ĐŊĐ° cookie . đ¤ĒđĒ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ĐŊĐ°ĐģĐ°ŅŅŅваĐŊĐŊŅ ĐŧОдĐĩĐģŅ Pydantic, ŅОй `СайОŅĐžĐŊиŅи` ĐąŅĐ´Ņ-ŅĐēŅ `дОдаŅĐēОвŅ` ĐŋĐžĐģŅ:
+
+{* ../../docs_src/cookie_param_models/tutorial002_an_py39.py hl[10] *}
+
+Đ¯ĐēŅĐž ĐēĐģŅŅĐŊŅ ŅĐŋŅОйŅŅ ĐŊĐ°Đ´ŅŅĐģĐ°Ņи ŅĐēŅŅŅ **дОдаŅĐēОвŅ cookie**, вŅĐŊ ĐžŅŅиĐŧĐ°Ņ вŅĐ´ĐŋОвŅĐ´Ņ С **ĐŋĐžĐŧиĐģĐēĐžŅ**.
+
+ĐŅĐ´ĐŊŅ йаĐŊĐĩŅи cookie, ŅĐēŅ ŅĐ°Đē ŅŅĐ°ŅĐ°ĐŊĐŊĐž ĐŊĐ°ĐŧĐ°ĐŗĐ°ŅŅŅŅŅ ĐžŅŅиĐŧĐ°Ņи ĐĐ°ŅŅ СĐŗОдŅ, ŅОй API ŅŅ вŅĐ´Ņ
иĐģиĐģĐ° . đĒ
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐēŅĐž ĐēĐģŅŅĐŊŅ ŅĐŋŅОйŅŅ ĐŊĐ°Đ´ŅŅĐģĐ°Ņи cookie `santa_tracker` СŅ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ `good-list-please`, вŅĐŊ ĐžŅŅиĐŧĐ°Ņ вŅĐ´ĐŋОвŅĐ´Ņ С ĐŋĐžĐŧиĐģĐēĐžŅ, ŅĐēĐ° ĐŋОвŅĐ´ĐžĐŧиŅŅ, ŅĐž cookie `santa_tracker` ĐŊĐĩ дОСвОĐģĐĩĐŊĐž :
+
+```json
+{
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["cookie", "santa_tracker"],
+ "msg": "Extra inputs are not permitted",
+ "input": "good-list-please",
+ }
+ ]
+}
+```
+
+## ĐŅĐ´ŅŅĐŧĐžĐē
+
+Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи **Pydantic-ĐŧОдĐĩĐģŅ** Đ´ĐģŅ ĐžĐŗĐžĐģĐžŅĐĩĐŊĐŊŅ cookie Ņ FastAPI. đ
diff --git a/docs/uk/docs/tutorial/cors.md b/docs/uk/docs/tutorial/cors.md
new file mode 100644
index 000000000..95b204d0f
--- /dev/null
+++ b/docs/uk/docs/tutorial/cors.md
@@ -0,0 +1,89 @@
+# CORS (ĐĐąĐŧŅĐŊ ŅĐĩŅŅŅŅĐ°Đŧи ĐŧŅĐļ ŅŅСĐŊиĐŧи Đ´ĐļĐĩŅĐĩĐģĐ°Đŧи)
+
+CORS айО "ĐĐąĐŧŅĐŊ ŅĐĩŅŅŅŅĐ°Đŧи ĐŧŅĐļ ŅŅСĐŊиĐŧи Đ´ĐļĐĩŅĐĩĐģĐ°Đŧи" Ņ ŅиŅŅĐ°ŅŅŅ, ĐēĐžĐģи ŅŅĐžĐŊŅĐĩĐŊĐ´, ŅĐž ĐŋŅĐ°ŅŅŅ в ĐąŅĐ°ŅСĐĩŅŅ, ĐŧŅŅŅиŅŅ JavaScript-ĐēОд, ŅĐēиК вСаŅĐŧОдŅŅ С ĐąĐĩĐēĐĩĐŊĐ´ĐžĐŧ, ŅОСŅĐ°ŅОваĐŊиĐŧ в ŅĐŊŅĐžĐŧŅ "Đ´ĐļĐĩŅĐĩĐģŅ" (origin).
+
+## ĐĐļĐĩŅĐĩĐģĐž (Origin)
+
+ĐĐļĐĩŅĐĩĐģĐž виСĐŊĐ°ŅĐ°ŅŅŅŅŅ ĐēĐžĐŧĐąŅĐŊĐ°ŅŅŅŅ ĐŋŅĐžŅĐžĐēĐžĐģŅ (`http`, `https`), Đ´ĐžĐŧĐĩĐŊŅ (`myapp.com`, `localhost`, `localhost.tiangolo.com`), ĐŋĐžŅŅŅ (`80`, `443`, `8080`).
+
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐ°ĐēŅ Đ°Đ´ŅĐĩŅи вваĐļĐ°ŅŅŅŅŅ ŅŅСĐŊиĐŧи Đ´ĐļĐĩŅĐĩĐģĐ°Đŧи:
+
+* `http://localhost`
+* `https://localhost`
+* `http://localhost:8080`
+
+ĐавŅŅŅ ŅĐēŅĐž вОĐŊи вŅŅ ĐŧŅŅŅŅŅŅ `localhost`, вОĐŊи ĐŧĐ°ŅŅŅ ŅŅСĐŊŅ ĐŋŅĐžŅĐžĐēĐžĐģи айО ĐŋĐžŅŅи, ŅĐž ŅОйиŅŅ ŅŅ
ĐžĐēŅĐĩĐŧиĐŧи "Đ´ĐļĐĩŅĐĩĐģĐ°Đŧи".
+
+## ĐŅĐžĐēи
+
+ĐŅиĐŋŅŅŅиĐŧĐž, ŅĐž ĐĐ°Ņ ŅŅĐžĐŊŅĐĩĐŊĐ´ ĐŋŅĐ°ŅŅŅ в ĐąŅĐ°ŅСĐĩŅŅ ĐŊĐ° `http://localhost:8080`, Đ° КОĐŗĐž JavaScript ĐŊĐ°ĐŧĐ°ĐŗĐ°ŅŅŅŅŅ вŅĐ´ĐŋŅавиŅи СаĐŋиŅ Đ´Đž ĐąĐĩĐēĐĩĐŊĐ´Ņ, ŅĐēиК ĐŋŅĐ°ŅŅŅ ĐŊĐ° `http://localhost` (ĐŅĐēŅĐģŅĐēи Đŧи ĐŊĐĩ вĐēаСŅŅĐŧĐž ĐŋĐžŅŅ, ĐąŅĐ°ŅСĐĩŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ ĐŋŅиĐŋŅŅĐēĐ°Ņ ĐŋĐžŅŅ `80`).
+
+ĐĐžŅŅĐŧ ĐąŅĐ°ŅСĐĩŅ ĐŊĐ°Đ´ŅŅĐģĐĩ HTTP-СаĐŋиŅ `OPTIONS` Đ´Đž ĐąĐĩĐēĐĩĐŊĐ´Ņ ĐŊĐ° ĐŋĐžŅŅŅ `:80`, Ņ ŅĐēŅĐž ĐąĐĩĐēĐĩĐŊĐ´ ĐŊĐ°Đ´ŅŅĐģĐĩ вŅĐ´ĐŋОвŅĐ´ĐŊŅ СаĐŗĐžĐģОвĐēи, ŅĐž дОСвОĐģŅŅŅŅ ĐēĐžĐŧŅĐŊŅĐēĐ°ŅŅŅ С ŅŅĐžĐŗĐž ŅĐŊŅĐžĐŗĐž Đ´ĐļĐĩŅĐĩĐģĐ° (`http://localhost:8080`), ŅОдŅ ĐąŅĐ°ŅСĐĩŅ ĐŊĐ° ĐŋĐžŅŅŅ `:8080` дОСвОĐģиŅŅ JavaScript Ņ ŅŅĐžĐŊŅĐĩĐŊĐ´Ņ ĐŊĐ°Đ´ŅŅĐģĐ°Ņи ŅвŅĐš СаĐŋиŅ Đ´Đž ĐąĐĩĐēĐĩĐŊĐ´Ņ ĐŊĐ° ĐŋĐžŅŅŅ `:80`.
+
+ЊОй Đ´ĐžŅŅĐŗŅи ŅŅĐžĐŗĐž, ĐąĐĩĐēĐĩĐŊĐ´ ĐŊĐ° ĐŋĐžŅŅŅ `:80` ĐŋОвиĐŊĐĩĐŊ ĐŧĐ°Ņи ŅĐŋиŅĐžĐē "дОСвОĐģĐĩĐŊиŅ
Đ´ĐļĐĩŅĐĩĐģ".
+
+ĐŖ ŅŅĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ ŅĐŋиŅĐžĐē ĐŧĐ°Ņ ĐŧŅŅŅиŅи `http://localhost:8080`, ŅОй ŅŅĐžĐŊŅĐĩĐŊĐ´ ĐŊĐ° ĐŋĐžŅŅŅ `:8080` ĐŋŅĐ°ŅŅвав ĐēĐžŅĐĩĐēŅĐŊĐž.
+
+## ХиĐŧвОĐģŅĐŊĐĩ ĐŋŅĐ´ŅŅавĐģŅĐŊĐŊŅ
+
+ĐĐžĐļĐŊĐ° ŅĐ°ĐēĐžĐļ ĐžĐŗĐžĐģĐžŅиŅи ŅĐŋиŅĐžĐē ŅĐē `"*"` ("ŅиĐŧвОĐģŅĐŊĐĩ ĐŋŅĐ´ŅŅавĐģŅĐŊĐŊŅ"), ŅĐž ОСĐŊĐ°ŅĐ°Ņ дОСвŅĐģ Đ´ĐģŅ вŅŅŅ
Đ´ĐļĐĩŅĐĩĐģ.
+
+ĐĐ´ĐŊĐ°Đē ŅĐĩ дОСвОĐģиŅŅ ĐģиŅĐĩ ĐŋĐĩвĐŊŅ ŅиĐŋи ĐēĐžĐŧŅĐŊŅĐēĐ°ŅŅŅ, виĐēĐģŅŅĐ°ŅŅи вŅĐĩ, ŅĐž ĐŋОв'ŅСаĐŊĐĩ С ОйĐģŅĐēОвиĐŧи Đ´Đ°ĐŊиĐŧи: Cookies, СаĐŗĐžĐģОвĐēи авŅĐžŅиСаŅŅŅ, ŅĐ°ĐēŅ ŅĐē ŅŅ, ŅĐž виĐēĐžŅиŅŅОвŅŅŅŅŅŅ С Bearer ŅĐžĐēĐĩĐŊĐ°Đŧи ŅĐžŅĐž.
+
+ĐĸĐžĐŧŅ Đ´ĐģŅ ĐēĐžŅĐĩĐēŅĐŊĐžŅ ŅОйОŅи ĐēŅĐ°ŅĐĩ ŅвĐŊĐž вĐēаСŅваŅи дОСвОĐģĐĩĐŊŅ Đ´ĐļĐĩŅĐĩĐģĐ°.
+
+## ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ `CORSMiddleware`
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐŊĐ°ĐģĐ°ŅŅŅваŅи ŅĐĩ Ņ ĐĐ°ŅĐžĐŧŅ дОдаŅĐēŅ **FastAPI** Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `CORSMiddleware`.
+
+* ĐĐŧĐŋĐžŅŅŅĐšŅĐĩ `CORSMiddleware`.
+* ĐĄŅвОŅŅŅŅ ŅĐŋиŅĐžĐē дОСвОĐģĐĩĐŊиŅ
Đ´ĐļĐĩŅĐĩĐģ (Ņ виĐŗĐģŅĐ´Ņ ŅŅĐ´ĐēŅв).
+* ĐОдаКŅĐĩ КОĐŗĐž ŅĐē "middleware" Ņ ĐĐ°Ņ дОдаŅĐžĐē **FastAPI**.
+
+
+ĐĸĐ°ĐēĐžĐļ ĐŧĐžĐļĐŊĐ° вĐēаСаŅи, Ņи дОСвОĐģŅŅ ĐĐ°Ņ ĐąĐĩĐēĐĩĐŊĐ´:
+
+* ĐĐąĐģŅĐēОвŅ Đ´Đ°ĐŊŅ (СаĐŗĐžĐģОвĐēи авŅĐžŅиСаŅŅŅ, Ņookies, ŅĐžŅĐž).
+* ĐĐžĐŊĐēŅĐĩŅĐŊŅ HTTP-ĐŧĐĩŅОди (`POST`, `PUT`) айО вŅŅ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `"*"`
+* ĐĐžĐŊĐēŅĐĩŅĐŊŅ HTTP-СаĐŗĐžĐģОвĐēи айО вŅŅ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `"*"`.
+
+
+{* ../../docs_src/cors/tutorial001.py hl[2,6:11,13:19] *}
+
+ĐĐ°ŅĐ°ĐŧĐĩŅŅи Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ Ņ `CORSMiddleware` Ņ Đ´ĐžŅиŅŅ ОйĐŧĐĩĐļĐĩĐŊиĐŧи, ŅĐžĐŧŅ ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž ŅвĐŊĐž вĐēаСаŅи ĐēĐžĐŊĐēŅĐĩŅĐŊŅ Đ´ĐļĐĩŅĐĩĐģĐ°, ĐŧĐĩŅОди айО СаĐŗĐžĐģОвĐēи, ŅОй ĐąŅĐ°ŅСĐĩŅи ĐŧĐžĐŗĐģи виĐēĐžŅиŅŅОвŅваŅи ŅŅ
Ņ ĐēĐžĐŊŅĐĩĐēŅŅŅ СаĐŋиŅŅв ĐŧŅĐļ ŅŅСĐŊиĐŧи Đ´ĐžĐŧĐĩĐŊĐ°Đŧи.
+
+
+ĐŅĐ´ŅŅиĐŧŅŅŅŅŅŅ ŅĐ°ĐēŅ Đ°ŅĐŗŅĐŧĐĩĐŊŅи:
+
+* `allow_origins` - ĐĄĐŋиŅĐžĐē Đ´ĐļĐĩŅĐĩĐģ, ŅĐēиĐŧ дОСвОĐģĐĩĐŊĐž СдŅĐšŅĐŊŅваŅи ĐŧŅĐļĐ´ĐžĐŧĐĩĐŊĐŊŅ СаĐŋиŅи. ĐĐ°ĐŋŅиĐēĐģĐ°Đ´ `['https://example.org', 'https://www.example.org']`. Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ['*'], ŅОй дОСвОĐģиŅи вŅŅ Đ´ĐļĐĩŅĐĩĐģĐ°.
+* `allow_origin_regex` - Đ ŅĐ´ĐžĐē ŅĐĩĐŗŅĐģŅŅĐŊĐžĐŗĐž виŅаСŅ Đ´ĐģŅ вŅĐ´ĐŋОвŅĐ´ĐŊĐžŅŅŅ Đ´ĐļĐĩŅĐĩĐģĐ°Đŧ, ŅĐēиĐŧ дОСвОĐģĐĩĐŊĐž СдŅĐšŅĐŊŅваŅи ĐŧŅĐļĐ´ĐžĐŧĐĩĐŊĐŊŅ СаĐŋиŅи. ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, `'https://.*\.example\.org'`.
+* `allow_methods` - ĐĄĐŋиŅĐžĐē HTTP-ĐŧĐĩŅОдŅв, дОСвОĐģĐĩĐŊиŅ
Đ´ĐģŅ ĐŧŅĐļĐ´ĐžĐŧĐĩĐŊĐŊиŅ
СаĐŋиŅŅв. ĐĐ° СаĐŧОвŅŅваĐŊĐŊŅĐŧ `['GET']`. Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи `['*']`, ŅОй дОСвОĐģиŅи вŅŅ ŅŅĐ°ĐŊĐ´Đ°ŅŅĐŊŅ ĐŧĐĩŅОди.
+* `allow_headers` - ĐĄĐŋиŅĐžĐē HTTP-СаĐŗĐžĐģОвĐēŅв, ŅĐēŅ ĐŋŅĐ´ŅŅиĐŧŅŅŅŅŅŅ Đ´ĐģŅ ĐŧŅĐļĐ´ĐžĐŧĐĩĐŊĐŊиŅ
СаĐŋиŅŅв. ĐĐ° СаĐŧОвŅŅваĐŊĐŊŅĐŧ `[]`. Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи `['*']`, ŅОй дОСвОĐģиŅи вŅŅ СаĐŗĐžĐģОвĐēи. ĐĐ°ĐŗĐžĐģОвĐēи `Accept`, `Accept-Language`, `Content-Language` Ņ `Content-Type` СавĐļди дОСвОĐģĐĩĐŊŅ Đ´ĐģŅ ĐŋŅĐžŅŅиŅ
CORS-СаĐŋиŅŅв .
+* `allow_credentials` - ĐиСĐŊĐ°ŅĐ°Ņ, Ņи ĐŋŅĐ´ŅŅиĐŧŅŅŅŅŅŅ ŅĐ°ĐšĐģи cookie Đ´ĐģŅ ĐŧŅĐļĐ´ĐžĐŧĐĩĐŊĐŊиŅ
СаĐŋиŅŅв. ĐĐ° СаĐŧОвŅŅваĐŊĐŊŅĐŧ `False`. ĐĸĐ°ĐēĐžĐļ, ŅĐēŅĐž ĐŋĐžŅŅŅĐąĐŊĐž дОСвОĐģиŅи ОйĐŧŅĐŊ ОйĐģŅĐēОвиĐŧи Đ´Đ°ĐŊиĐŧи (`allow_credentials = True`), ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `allow_origins` ĐŊĐĩ ĐŧĐžĐļĐĩ ĐąŅŅи вŅŅĐ°ĐŊОвĐģĐĩĐŊиК ŅĐē `['*']`, ĐŊĐĩОйŅ
ŅĐ´ĐŊĐž вĐēаСаŅи ĐēĐžĐŊĐēŅĐĩŅĐŊŅ Đ´ĐļĐĩŅĐĩĐģĐ°.
+* `expose_headers` - ĐĐēаСŅŅ, ŅĐēŅ СаĐŗĐžĐģОвĐēи вŅĐ´ĐŋОвŅĐ´Ņ ĐŋОвиĐŊĐŊŅ ĐąŅŅи Đ´ĐžŅŅŅĐŋĐŊŅ Đ´ĐģŅ ĐąŅĐ°ŅСĐĩŅĐ°. ĐĐ° СаĐŧОвŅŅваĐŊĐŊŅĐŧ `[]`.
+* `max_age` - ĐŅŅĐ°ĐŊОвĐģŅŅ ĐŧĐ°ĐēŅиĐŧĐ°ĐģŅĐŊиК ŅĐ°Ņ (Ņ ŅĐĩĐēŅĐŊĐ´Đ°Ņ
) Đ´ĐģŅ ĐēĐĩŅŅваĐŊĐŊŅ CORS-вŅĐ´ĐŋОвŅĐ´ĐĩĐš Ņ ĐąŅĐ°ŅСĐĩŅĐ°Ņ
. ĐĐ° СаĐŧОвŅŅваĐŊĐŊŅĐŧ `600`.
+
+ĐĻĐĩĐš middleware ОйŅОйĐģŅŅ два ŅиĐŋи HTTP-СаĐŋиŅŅв...
+
+### ĐĐžĐŋĐĩŅĐĩĐ´ĐŊŅ CORS-СаĐŋиŅи (preflight requests)
+
+ĐĻĐĩ ĐąŅĐ´Ņ-ŅĐēŅ `OPTIONS` - СаĐŋиŅи, ŅĐž ĐŧŅŅŅŅŅŅ СаĐŗĐžĐģОвĐēи `Origin` ŅĐ° `Access-Control-Request-Method`.
+
+ĐŖ ŅĐ°ĐēĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ middleware ĐŋĐĩŅĐĩŅ
ĐžĐŋиŅŅ вŅ
ŅĐ´ĐŊиК СаĐŋиŅ Ņ вŅĐ´ĐŋОвŅŅŅŅ вŅĐ´ĐŋОвŅĐ´ĐŊиĐŧи CORS-СаĐŗĐžĐģОвĐēĐ°Đŧи, ĐŋОвĐĩŅŅĐ°ŅŅи айО `200`, айО `400` Đ´ĐģŅ ŅĐŊŅĐžŅĐŧĐ°ŅŅĐšĐŊиŅ
ŅŅĐģĐĩĐš.
+
+### ĐŅĐžŅŅŅ СаĐŋиŅи
+
+ĐŅĐ´Ņ-ŅĐēŅ СаĐŋиŅи ŅС СаĐŗĐžĐģОвĐēĐžĐŧ `Origin`. ĐŖ ŅŅĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ middleware ĐŋŅĐžĐŋŅŅŅиŅŅ СаĐŋиŅ ŅĐē СвиŅĐ°ĐšĐŊиК, Đ°ĐģĐĩ дОдаŅŅŅ вŅĐ´ĐŋОвŅĐ´ĐŊŅ CORS-СаĐŗĐžĐģОвĐēи Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+
+## ĐОдаŅĐēОва ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐŅĐģŅŅĐĩ ĐŋŅĐž CORS ĐŧĐžĐļĐŊĐ° Đ´ŅСĐŊĐ°ŅиŅŅ в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Mozilla .
+
+/// note | ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+ĐĸĐ°ĐēĐžĐļ ĐŧĐžĐļĐŊĐ° виĐēĐžŅиŅŅОвŅваŅи `from starlette.middleware.cors import CORSMiddleware`.
+
+**FastAPI** ĐŊĐ°Đ´Đ°Ņ ĐēŅĐģŅĐēĐ° middleware Ņ `fastapi.middleware` Đ´ĐģŅ СŅŅŅĐŊĐžŅŅŅ ŅОСŅОйĐŊиĐēŅв. ĐĐģĐĩ ĐąŅĐģŅŅŅŅŅŅ Đ´ĐžŅŅŅĐŋĐŊиŅ
middleware ĐŋĐžŅ
ОдŅŅŅ ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž СŅ Starlette.
+
+///
diff --git a/docs/uk/docs/tutorial/handling-errors.md b/docs/uk/docs/tutorial/handling-errors.md
new file mode 100644
index 000000000..12a356cd0
--- /dev/null
+++ b/docs/uk/docs/tutorial/handling-errors.md
@@ -0,0 +1,255 @@
+# ĐĐąŅОйĐēĐ° ĐĐžĐŧиĐģĐžĐē
+
+РйаĐŗĐ°ŅĐž ŅиŅŅĐ°ŅŅĐš, ĐēĐžĐģи ĐŋĐžŅŅŅĐąĐŊĐž ĐŋОвŅĐ´ĐžĐŧиŅи ĐēĐģŅŅĐŊŅĐ°, ŅĐēиК виĐēĐžŅиŅŅОвŅŅ ĐĐ°Ņ API, ĐŋŅĐž ĐŋĐžĐŧиĐģĐēŅ.
+
+ĐĻиĐŧ ĐēĐģŅŅĐŊŅĐžĐŧ ĐŧĐžĐļĐĩ ĐąŅŅи ĐąŅĐ°ŅСĐĩŅ ŅС ŅŅĐžĐŊŅĐĩĐŊĐ´ĐžĐŧ, ĐēОд ŅĐŊŅĐžĐŗĐž ŅОСŅОйĐŊиĐēĐ°, IoT-ĐŋŅиŅŅŅŅĐš ŅĐžŅĐž.
+
+ĐĐžĐļĐģивО, ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž ĐŋОвŅĐ´ĐžĐŧиŅи ĐēĐģŅŅĐŊŅĐ°, ŅĐž:
+
+* ĐŖ ĐŊŅĐžĐŗĐž ĐŊĐĩĐ´ĐžŅŅĐ°ŅĐŊŅĐž ĐŋŅав Đ´ĐģŅ виĐēĐžĐŊĐ°ĐŊĐŊŅ ŅŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅ.
+* ĐŅĐŊ ĐŊĐĩ ĐŧĐ°Ņ Đ´ĐžŅŅŅĐŋŅ Đ´Đž ŅŅĐžĐŗĐž ŅĐĩŅŅŅŅŅ.
+* ĐĐģĐĩĐŧĐĩĐŊŅ, Đ´Đž ŅĐēĐžĐŗĐž вŅĐŊ ĐŊĐ°ĐŧĐ°ĐŗĐ°ŅŅŅŅŅ ĐžŅŅиĐŧĐ°Ņи Đ´ĐžŅŅŅĐŋ, ĐŊĐĩ ŅŅĐŊŅŅ.
+* ŅĐžŅĐž.
+
+ĐŖ ŅĐ°ĐēиŅ
виĐŋĐ°Đ´ĐēĐ°Ņ
СаСвиŅĐ°Đš ĐŋОвĐĩŅŅĐ°ŅŅŅŅŅ **HTTP ŅŅĐ°ŅŅŅ-ĐēОд** в Đ´ŅĐ°ĐŋаСОĐŊŅ **400** (вŅĐ´ 400 Đ´Đž 499).
+
+ĐĻĐĩ ŅŅ
ĐžĐļĐĩ ĐŊĐ° HTTP ŅŅĐ°ŅŅŅ-ĐēОди 200 (вŅĐ´ 200 Đ´Đž 299). ĐĻŅ "200" ŅŅĐ°ŅŅŅ-ĐēОди ОСĐŊĐ°ŅĐ°ŅŅŅ, ŅĐž СаĐŋиŅ ĐŋŅОКŅОв ŅŅĐŋŅŅĐŊĐž.
+
+ĐĄŅĐ°ŅŅŅ-ĐēОди в Đ´ŅĐ°ĐŋаСОĐŊŅ 400 ОСĐŊĐ°ŅĐ°ŅŅŅ, ŅĐž ŅŅĐ°ĐģĐ°ŅŅ ĐŋĐžĐŧиĐģĐēĐ° С йОĐēŅ ĐēĐģŅŅĐŊŅĐ°.
+
+ĐĐ°Đŧ'ŅŅĐ°ŅŅĐĩ вŅŅ ŅŅ ĐŋĐžĐŧиĐģĐēи **404 Not Found** (Ņ ĐļĐ°ŅŅи ĐŋŅĐž ĐŊиŅ
)?
+
+## ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ `HTTPException`
+
+ЊОй ĐŋОвĐĩŅĐŊŅŅи HTTP-вŅĐ´ĐŋОвŅĐ´Ņ С ĐŋĐžĐŧиĐģĐēĐ°Đŧи ĐēĐģŅŅĐŊŅŅ, виĐēĐžŅиŅŅОвŅĐšŅĐĩ `HTTPException`.
+
+### ĐĐŧĐŋĐžŅŅ `HTTPException`
+
+{* ../../docs_src/handling_errors/tutorial001.py hl[1] *}
+
+### ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ `HTTPException` Ņ ĐēОдŅ
+
+`HTTPException` â ŅĐĩ СвиŅĐ°ĐšĐŊĐ° ĐŋĐžĐŧиĐģĐēĐ° Python ŅС дОдаŅĐēОвиĐŧи Đ´Đ°ĐŊиĐŧи, ŅĐēŅ ŅŅĐžŅŅŅŅŅŅŅ API.
+
+ĐŅĐēŅĐģŅĐēи ŅĐĩ ĐŋĐžĐŧиĐģĐēĐ° Python, Đи ĐŊĐĩ `ĐŋОвĐĩŅŅĐ°ŅŅĐĩ` КОĐŗĐž, Đ° `ĐŗĐĩĐŊĐĩŅŅŅŅĐĩ` (ĐŗĐĩĐŊĐĩŅŅŅŅĐĩ ĐŋĐžĐŧиĐģĐēŅ).
+
+ĐĻĐĩ ŅĐ°ĐēĐžĐļ ОСĐŊĐ°ŅĐ°Ņ, ŅĐž ŅĐēŅĐž Đи ĐŋĐĩŅĐĩĐąŅваŅŅĐĩ вŅĐĩŅĐĩдиĐŊŅ Đ´ĐžĐŋĐžĐŧŅĐļĐŊĐžŅ ŅŅĐŊĐēŅŅŅ, ŅĐēŅ виĐēĐģиĐēĐ°ŅŅĐĩ вŅĐĩŅĐĩдиĐŊŅ ŅвОŅŅ *ŅŅĐŊĐēŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*, Ņ ŅĐ°Đŧ ĐŗĐĩĐŊĐĩŅŅŅŅĐĩ `HTTPException`, вŅĐĩŅĐĩдиĐŊŅ ŅŅŅŅ Đ´ĐžĐŋĐžĐŧŅĐļĐŊĐžŅ ŅŅĐŊĐēŅŅŅ, ŅĐž ŅĐĩŅŅĐ° ĐēОдŅ в *ŅŅĐŊĐēŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ* ĐŊĐĩ ĐąŅĐ´Đĩ виĐēĐžĐŊĐ°ĐŊĐ°. ĐĐ°ĐŋиŅ ОдŅаСŅ СавĐĩŅŅиŅŅŅŅ, Ņ HTTP-ĐŋĐžĐŧиĐģĐēĐ° С `HTTPException` ĐąŅĐ´Đĩ ĐŊĐ°Đ´ŅŅĐģĐ°ĐŊĐ° ĐēĐģŅŅĐŊŅŅ.
+
+ĐĐĩŅĐĩваĐŗĐ° виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ `ĐŗĐĩĐŊĐĩŅĐ°ŅŅŅ` (raise) ĐŋĐžĐŧиĐģĐēи СаĐŧŅŅŅŅ `ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ` СĐŊĐ°ŅĐĩĐŊĐŊŅ (return) ŅŅĐ°ĐŊĐĩ ĐąŅĐģŅŅ ĐžŅĐĩвидĐŊиĐŧ в ŅОСдŅĐģŅ ĐŋŅĐž ĐĐ°ĐģĐĩĐļĐŊĐžŅŅŅ ŅĐ° ĐĐĩСĐŋĐĩĐēŅ.
+
+ĐŖ ŅŅĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ, ŅĐēŅĐž ĐēĐģŅŅĐŊŅ СаĐŋиŅŅŅ ĐĩĐģĐĩĐŧĐĩĐŊŅ Са ID, ŅĐēĐžĐŗĐž ĐŊĐĩ ŅŅĐŊŅŅ, ĐąŅĐ´Đĩ СĐŗĐĩĐŊĐĩŅОваĐŊĐž ĐŋĐžĐŧиĐģĐēŅ СŅ ŅŅĐ°ŅŅŅ-ĐēОдОĐŧ `404`:
+
+{* ../../docs_src/handling_errors/tutorial001.py hl[11] *}
+
+### ĐŅŅиĐŧĐ°ĐŊĐ° вŅĐ´ĐŋОвŅĐ´Ņ
+
+Đ¯ĐēŅĐž ĐēĐģŅŅĐŊŅ ŅОйиŅŅ СаĐŋиŅ Са ŅĐģŅŅ
ĐžĐŧ `http://example.com/items/foo` (Đ´Đĩ `item_id` `"foo"`), вŅĐŊ ĐžŅŅиĐŧĐ°Ņ ŅŅĐ°ŅŅŅ-ĐēОд 200 Ņ JSON вŅĐ´ĐŋОвŅĐ´Ņ:
+
+```JSON
+{
+ "item": "The Foo Wrestlers"
+}
+```
+
+ĐĐģĐĩ ŅĐēŅĐž ĐēĐģŅŅĐŊŅ ŅОйиŅŅ СаĐŋиŅ ĐŊĐ° `http://example.com/items/bar` (Đ´Đĩ `item_id` ĐŧĐ°Ņ ĐŊĐĩ ŅŅĐŊŅŅŅĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ `"bar"`), ŅĐž ĐžŅŅиĐŧĐ°Ņ ŅŅĐ°ŅŅŅ-ĐēОд 404 (ĐŋĐžĐŧиĐģĐēĐ° "ĐŊĐĩ СĐŊаКдĐĩĐŊĐž") ŅĐ° вŅĐ´ĐŋОвŅĐ´Ņ:
+
+```JSON
+{
+ "detail": "Item not found"
+}
+```
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐŅĐ´ ŅĐ°Ņ виĐēĐģиĐēŅ `HTTPException` Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋĐĩŅĐĩĐ´Đ°Ņи ĐąŅĐ´Ņ-ŅĐēĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ, ŅĐēĐĩ ĐŧĐžĐļĐĩ ĐąŅŅи ĐŋĐĩŅĐĩŅвОŅĐĩĐŊĐĩ в JSON, ŅĐē ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `detail`, Đ° ĐŊĐĩ ĐģиŅĐĩ ŅŅĐ´ĐžĐē (`str`).
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋĐĩŅĐĩĐ´Đ°Ņи `dict`, `list` ŅĐžŅĐž.
+
+ĐĐžĐŊи ОйŅОйĐģŅŅŅŅŅŅ авŅĐžĐŧĐ°ŅиŅĐŊĐž Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ **FastAPI** ŅĐ° ĐŋĐĩŅĐĩŅвОŅŅŅŅŅŅŅ в JSON.
+
+///
+
+## ĐОдаваĐŊĐŊŅ вĐģĐ°ŅĐŊиŅ
СаĐŗĐžĐģОвĐēŅв
+
+ĐĐŊОдŅ ĐŋĐžŅŅŅĐąĐŊĐž дОдаŅи вĐģĐ°ŅĐŊŅ СаĐŗĐžĐģОвĐēи Đ´Đž HTTP-ĐŋĐžĐŧиĐģĐēи, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, Đ´ĐģŅ ĐŋĐĩвĐŊиŅ
ŅиĐŋŅв ĐąĐĩСĐŋĐĩĐēи.
+
+ĐĐŧОвŅŅĐŊĐž, ĐĐ°Đŧ ĐŊĐĩ дОвĐĩĐ´ĐĩŅŅŅŅ виĐēĐžŅиŅŅОвŅваŅи ŅĐĩ ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž Ņ ŅвОŅĐŧŅ ĐēОдŅ.
+
+ĐĐģĐĩ ŅĐēŅĐž ĐĐ°Đŧ СĐŊадОйиŅŅŅŅ ŅĐĩ Đ´ĐģŅ ŅĐēĐģĐ°Đ´ĐŊĐžĐŗĐž ŅŅĐĩĐŊĐ°ŅŅŅ, Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи вĐģĐ°ŅĐŊŅ СаĐŗĐžĐģОвĐēи:
+
+{* ../../docs_src/handling_errors/tutorial002.py hl[14] *}
+
+## ĐŅŅĐ°ĐŊОвĐģĐĩĐŊĐŊŅ вĐģĐ°ŅĐŊиŅ
ОйŅОйĐŊиĐēŅв ĐŋĐžĐŧиĐģĐžĐē
+
+Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи вĐģĐ°ŅĐŊŅ ОйŅОйĐŊиĐēи ĐŋĐžĐŧиĐģĐžĐē Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ŅиŅ
ŅĐ°ĐŧиŅ
ŅŅиĐģŅŅ ОйŅОйĐēи ĐŋĐžĐŧиĐģĐžĐē СŅ Starlette .
+
+ĐŅиĐŋŅŅŅиĐŧĐž, Ņ ĐĐ°Ņ Ņ вĐģĐ°ŅĐŊиК ОйĘŧŅĐēŅ ĐŋĐžĐŧиĐģĐēи `UnicornException`, ŅĐēĐĩ Đи (айО ĐąŅĐąĐģŅĐžŅĐĩĐēĐ°, ŅĐēŅ Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ) ĐŧĐžĐļĐĩ `СĐŗĐĩĐŊĐĩŅŅваŅи` (`raise`).
+
+Đ Đи Ņ
ĐžŅĐĩŅĐĩ ОйŅОйĐģŅŅи ŅĐĩ виĐēĐģŅŅĐĩĐŊĐŊŅ ĐŗĐģОйаĐģŅĐŊĐž Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ FastAPI.
+
+Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи вĐģĐ°ŅĐŊиК ОйŅОйĐŊиĐē виĐēĐģŅŅĐĩĐŊŅ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `@app.exception_handler()`:
+
+{* ../../docs_src/handling_errors/tutorial003.py hl[5:7,13:18,24] *}
+
+ĐĸŅŅ, ŅĐēŅĐž Đи СвĐĩŅĐŊĐĩŅĐĩŅŅ Đ´Đž `/unicorns/yolo`, ŅĐž СĐŗĐĩĐŊĐĩŅŅŅŅŅŅŅ ĐŋĐžĐŧиĐģĐēĐ° `UnicornException`.
+
+ĐĐģĐĩ вОĐŊĐ° ĐąŅĐ´Đĩ ОйŅОйĐģĐĩĐŊĐ° ŅŅĐŊĐēŅŅŅŅ-ОйŅОйĐŊиĐēĐžĐŧ `unicorn_exception_handler`.
+
+ĐŅĐļĐĩ, Đи ĐžŅŅиĐŧĐ°ŅŅĐĩ СŅОСŅĐŧŅĐģŅ ĐŋĐžĐŧиĐģĐēŅ СŅ HTTP-ŅŅĐ°ŅŅŅĐžĐŧ `418` Ņ JSON-вŅĐ´ĐŋОвŅĐ´Đ´Ņ:
+
+```JSON
+{"message": "Oops! yolo did something. There goes a rainbow..."}
+```
+
+/// note | ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи `from starlette.requests import Request` Ņ `from starlette.responses import JSONResponse`.
+
+**FastAPI** ĐŊĐ°Đ´Đ°Ņ ŅŅ ŅĐ°ĐŧŅ `starlette.responses`, ŅĐž Đš `fastapi.responses`, ĐŋŅĐžŅŅĐž Đ´ĐģŅ СŅŅŅĐŊĐžŅŅŅ ŅОСŅОйĐŊиĐēĐ°. ĐĐģĐĩ ĐąŅĐģŅŅŅŅŅŅ Đ´ĐžŅŅŅĐŋĐŊиŅ
вŅĐ´ĐŋОвŅĐ´ĐĩĐš ĐŊĐ°Đ´Ņ
ОдŅŅŅ ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž СŅ Starlette. ĐĸĐĩ Đļ ŅĐ°ĐŧĐĩ ŅŅĐžŅŅŅŅŅŅŅ Ņ `Request`.
+
+///
+
+## ĐĐĩŅĐĩвиСĐŊĐ°ŅĐĩĐŊĐŊŅ ОйŅОйĐŊиĐēŅв ĐŋĐžĐŧиĐģĐžĐē Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ
+
+**FastAPI** ĐŧĐ°Ņ ĐēŅĐģŅĐēĐ° ОйŅОйĐŊиĐēŅв ĐŋĐžĐŧиĐģĐžĐē Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ.
+
+ĐĻŅ ОйŅОйĐŊиĐēи вŅĐ´ĐŋОвŅĐ´Đ°ŅŅŅ Са ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ ŅŅĐ°ĐŊĐ´Đ°ŅŅĐŊиŅ
JSON-вŅĐ´ĐŋОвŅĐ´ĐĩĐš, ĐēĐžĐģи Đи `ĐŗĐĩĐŊĐĩŅŅŅŅĐĩ` (`raise`) `HTTPException`, Đ° ŅĐ°ĐēĐžĐļ ĐēĐžĐģи СаĐŋиŅ ĐŧŅŅŅиŅŅ ĐŊĐĩĐēĐžŅĐĩĐēŅĐŊŅ Đ´Đ°ĐŊŅ.
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋĐĩŅĐĩвиСĐŊĐ°ŅиŅи ŅŅ ОйŅОйĐŊиĐēи, ŅŅвОŅивŅи вĐģĐ°ŅĐŊŅ.
+
+### ĐĐĩŅĐĩвиСĐŊĐ°ŅĐĩĐŊĐŊŅ ĐŋĐžĐŧиĐģĐžĐē ваĐģŅĐ´Đ°ŅŅŅ СаĐŋиŅŅ
+
+ĐĐžĐģи СаĐŋиŅ ĐŧŅŅŅиŅŅ ĐŊĐĩĐēĐžŅĐĩĐēŅĐŊŅ Đ´Đ°ĐŊŅ, **FastAPI** ĐŗĐĩĐŊĐĩŅŅŅ `RequestValidationError`.
+
+Đ ŅĐ°ĐēĐžĐļ вĐēĐģŅŅĐ°Ņ ОйŅОйĐŊиĐē ĐŋĐžĐŧиĐģĐžĐē Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ Đ´ĐģŅ ĐŊŅĐžĐŗĐž.
+
+ЊОй ĐŋĐĩŅĐĩвиСĐŊĐ°ŅиŅи КОĐŗĐž, ŅĐŧĐŋĐžŅŅŅĐšŅĐĩ `RequestValidationError` Ņ виĐēĐžŅиŅŅОвŅĐšŅĐĩ КОĐŗĐž С `@app.exception_handler(RequestValidationError)` Đ´ĐģŅ Đ´ĐĩĐēĐžŅŅваĐŊĐŊŅ ОйŅОйĐŊиĐēĐ° ĐŋĐžĐŧиĐģĐžĐē.
+
+ĐĐąŅОйĐŊиĐē ĐŋĐžĐŧиĐģĐžĐē ĐžŅŅиĐŧŅŅ `Request` Ņ ŅĐ°ĐŧŅ ĐŋĐžĐŧиĐģĐēŅ.
+
+{* ../../docs_src/handling_errors/tutorial004.py hl[2,14:16] *}
+
+ĐĸĐĩĐŋĐĩŅ, ŅĐēŅĐž Đи ĐŋĐĩŅĐĩКдĐĩŅĐĩ Са ĐŋĐžŅиĐģĐ°ĐŊĐŊŅĐŧ `/items/foo`, СаĐŧŅŅŅŅ ŅĐžĐŗĐž, ŅОй ĐžŅŅиĐŧĐ°Ņи ŅŅĐ°ĐŊĐ´Đ°ŅŅĐŊŅ JSON-ĐŋĐžĐŧиĐģĐēŅ:
+
+```JSON
+{
+ "detail": [
+ {
+ "loc": [
+ "path",
+ "item_id"
+ ],
+ "msg": "value is not a valid integer",
+ "type": "type_error.integer"
+ }
+ ]
+}
+```
+
+Đи ĐžŅŅиĐŧĐ°ŅŅĐĩ ŅĐĩĐēŅŅОвŅ вĐĩŅŅŅŅ:
+
+```
+1 validation error
+path -> item_id
+ value is not a valid integer (type=type_error.integer)
+```
+
+#### `RequestValidationError` ĐŋŅĐžŅи `ValidationError`
+
+/// warning | ĐŖваĐŗĐ°
+
+ĐĻĐĩ ŅĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ, ŅĐēŅ Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋŅĐžĐŋŅŅŅиŅи, ŅĐēŅĐž вОĐŊи СаŅаС ĐŊĐĩ ваĐļĐģивŅ Đ´ĐģŅ ĐĐ°Ņ.
+
+///
+
+`RequestValidationError` Ņ ĐŋŅĐ´ĐēĐģĐ°ŅĐžĐŧ Pydantic `ValidationError` .
+
+**FastAPI** виĐēĐžŅиŅŅОвŅŅ КОĐŗĐž Đ´ĐģŅ ŅĐžĐŗĐž, ŅĐēŅĐž Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ ĐŧОдĐĩĐģŅ Pydantic Ņ `response_model` Ņ Ņ ваŅиŅ
Đ´Đ°ĐŊиŅ
Ņ ĐŋĐžĐŧиĐģĐēĐ°, Đи ĐŋОйаŅиĐģи ĐŋĐžĐŧиĐģĐēŅ Ņ ŅвОŅĐŧŅ ĐļŅŅĐŊĐ°ĐģŅ.
+
+ĐĐģĐĩ ĐēĐģŅŅĐŊŅ/ĐēĐžŅиŅŅŅваŅ ĐŊĐĩ ĐŋОйаŅиŅŅ ŅŅ. ĐĐ°ŅĐžĐŧŅŅŅŅ ĐēĐģŅŅĐŊŅ ĐžŅŅиĐŧĐ°Ņ "Internal Server Error" СŅ ŅŅĐ°ŅŅŅĐžĐŧ HTTP `500`.
+
+ĐĸĐ°Đē ĐŧĐ°Ņ ĐąŅŅи, ŅĐēŅĐž Ņ ĐĐ°Ņ виĐŊиĐēĐģĐ° `ValidationError` Pydantic Ņ *вŅĐ´ĐŋОвŅĐ´Ņ* айО Đ´ĐĩŅĐŊĐ´Đĩ Ņ ваŅĐžĐŧŅ ĐēОдŅ (ĐŊĐĩ Ņ *СаĐŋиŅŅ* ĐēĐģŅŅĐŊŅĐ°), ŅĐĩ ĐŊĐ°ŅĐŋŅавдŅ Ņ ĐŋĐžĐŧиĐģĐēĐžŅ Ņ ĐĐ°ŅĐžĐŧŅ ĐēОдŅ.
+
+Đ ĐŋĐžĐēи Đи ŅŅ виĐŋŅавĐģŅŅŅĐĩ, ĐēĐģŅŅĐŊŅи/ĐēĐžŅиŅŅŅваŅŅ ĐŊĐĩ ĐŋОвиĐŊĐŊŅ ĐŧĐ°Ņи Đ´ĐžŅŅŅĐŋŅ Đ´Đž вĐŊŅŅŅŅŅĐŊŅĐžŅ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ ĐŋŅĐž ĐŋĐžĐŧиĐģĐēŅ, ĐžŅĐēŅĐģŅĐēи ŅĐĩ ĐŧĐžĐļĐĩ ĐŋŅиСвĐĩŅŅи Đ´Đž вŅаСĐģивОŅŅŅ ĐąĐĩСĐŋĐĩĐēи.
+
+### ĐĐĩŅĐĩвиСĐŊĐ°ŅĐĩĐŊĐŊŅ ОйŅОйĐŊиĐēĐ° ĐŋĐžĐŧиĐģĐžĐē `HTTPException`
+
+ĐĐŊĐ°ĐģĐžĐŗŅŅĐŊĐž, Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋĐĩŅĐĩвиСĐŊĐ°ŅиŅи ОйŅОйĐŊиĐē `HTTPException`.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, Đи ĐŧĐžĐļĐĩŅĐĩ СаŅ
ĐžŅŅŅи ĐŋОвĐĩŅĐŊŅŅи ŅĐĩĐēŅŅОвŅ вŅĐ´ĐŋОвŅĐ´Ņ СаĐŧŅŅŅŅ JSON Đ´ĐģŅ ŅиŅ
ĐŋĐžĐŧиĐģĐžĐē:
+
+{* ../../docs_src/handling_errors/tutorial004.py hl[3:4,9:11,22] *}
+
+/// note | ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи `from starlette.responses import PlainTextResponse`.
+
+**FastAPI** ĐŊĐ°Đ´Đ°Ņ ŅŅ ŅĐ°ĐŧŅ `starlette.responses`, ŅĐž Đš `fastapi.responses`, ĐŋŅĐžŅŅĐž Đ´ĐģŅ СŅŅŅĐŊĐžŅŅŅ ŅОСŅОйĐŊиĐēĐ°. ĐĐģĐĩ ĐąŅĐģŅŅŅŅŅŅ Đ´ĐžŅŅŅĐŋĐŊиŅ
вŅĐ´ĐŋОвŅĐ´ĐĩĐš ĐŊĐ°Đ´Ņ
ОдŅŅŅ ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž СŅ Starlette.
+
+///
+
+### ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ŅŅĐģĐ° `RequestValidationError`
+
+`RequestValidationError` ĐŧŅŅŅиŅŅ `body`, ŅĐēиК вŅĐŊ ĐžŅŅиĐŧав ŅС ĐŊĐĩĐēĐžŅĐĩĐēŅĐŊиĐŧи Đ´Đ°ĐŊиĐŧи.
+
+Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ŅĐĩ ĐŋŅĐ´ ŅĐ°Ņ ŅОСŅОйĐēи ŅвОĐŗĐž дОдаŅĐēĐ°, ŅОй ĐģĐžĐŗŅваŅи ŅŅĐģĐž СаĐŋиŅŅ ŅĐ° ĐŊĐ°ĐģĐ°ĐŗОдĐļŅваŅи КОĐŗĐž, ĐŋОвĐĩŅŅĐ°Ņи ĐēĐžŅиŅŅŅваŅĐĩвŅ ŅĐžŅĐž.
+
+{* ../../docs_src/handling_errors/tutorial005.py hl[14] *}
+
+ĐĸĐĩĐŋĐĩŅ ŅĐŋŅОйŅĐšŅĐĩ ĐŊĐ°Đ´ŅŅĐģĐ°Ņи ĐŊĐĩĐēĐžŅĐĩĐēŅĐŊиК ĐĩĐģĐĩĐŧĐĩĐŊŅ, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´:
+
+```JSON
+{
+ "title": "towel",
+ "size": "XL"
+}
+```
+Đи ĐžŅŅиĐŧĐ°ŅŅĐĩ вŅĐ´ĐŋОвŅĐ´Ņ, ŅĐēĐ° ĐŋОвŅĐ´ĐžĐŧиŅŅ ĐĐ°Đŧ, ŅĐēŅ ŅĐ°ĐŧĐĩ Đ´Đ°ĐŊŅ Ņ ĐŊĐĩĐēĐžŅĐĩĐēŅĐŊŅ Ņ ваŅĐžĐŧŅ ŅŅĐģŅ СаĐŋиŅŅ:
+
+
+```JSON hl_lines="12-15"
+{
+ "detail": [
+ {
+ "loc": [
+ "body",
+ "size"
+ ],
+ "msg": "value is not a valid integer",
+ "type": "type_error.integer"
+ }
+ ],
+ "body": {
+ "title": "towel",
+ "size": "XL"
+ }
+}
+```
+
+#### `HTTPException` FastAPI ĐŋŅĐžŅи `HTTPException` Starlette
+
+**FastAPI** ĐŧĐ°Ņ вĐģĐ°ŅĐŊиК `HTTPException`.
+
+Đ ĐēĐģĐ°Ņ ĐŋĐžĐŧиĐģĐēи `HTTPException` в **FastAPI** ŅŅĐŋĐ°Đ´ĐēОвŅŅŅŅŅŅ вŅĐ´ ĐēĐģĐ°ŅŅ ĐŋĐžĐŧиĐģĐēи `HTTPException` в Starlette.
+
+ĐдиĐŊĐ° ŅŅСĐŊиŅŅ ĐŋĐžĐģŅĐŗĐ°Ņ в ŅĐžĐŧŅ, ŅĐž `HTTPException` в **FastAPI** ĐŋŅиКĐŧĐ°Ņ ĐąŅĐ´Ņ-ŅĐēŅ Đ´Đ°ĐŊŅ, ŅĐēŅ ĐŧĐžĐļĐŊĐ° ĐŋĐĩŅĐĩŅвОŅиŅи ĐŊĐ° JSON, Đ´ĐģŅ ĐŋĐžĐģŅ `detail`, ŅОдŅ ŅĐē `HTTPException` Ņ Starlette ĐŋŅиКĐŧĐ°Ņ ŅŅĐģŅĐēи ŅŅĐ´Đēи.
+
+ĐŅĐļĐĩ, Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋŅОдОвĐļŅваŅи виĐēĐžŅиŅŅОвŅваŅи `HTTPException` в **FastAPI** ŅĐē СаСвиŅĐ°Đš Ņ ŅвОŅĐŧŅ ĐēОдŅ.
+
+ĐĐģĐĩ ĐēĐžĐģи Đи ŅĐĩŅŅŅŅŅŅŅĐĩ ОйŅОйĐŊиĐē виĐēĐģŅŅĐĩĐŊŅ, ŅĐģŅĐ´ ŅĐĩŅŅŅŅŅваŅи КОĐŗĐž Đ´ĐģŅ `HTTPException` СŅ Starlette.
+
+ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, ŅĐēŅĐž ĐąŅĐ´Ņ-ŅĐēĐ° ŅĐ°ŅŅиĐŊĐ° вĐŊŅŅŅŅŅĐŊŅĐžĐŗĐž ĐēОдŅ Starlette айО ŅОСŅиŅĐĩĐŊĐŊŅ Ņи ĐŋĐģĐ°ĐŗŅĐŊ Starlette СĐŗĐĩĐŊĐĩŅŅŅ (raise) `HTTPException`, ĐĐ°Ņ ОйŅОйĐŊиĐē СĐŧĐžĐļĐĩ ĐŋĐĩŅĐĩŅ
ĐžĐŋиŅи ŅĐ° ОйŅОйиŅи ŅŅ.
+
+ĐŖ ŅŅĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ, ŅОй ĐŧĐ°Ņи ĐŧĐžĐļĐģивŅŅŅŅ виĐēĐžŅиŅŅОвŅваŅи Ойидва `HTTPException` в ОдĐŊĐžĐŧŅ ĐēОдŅ, ĐŋĐžĐŧиĐģĐēĐ° Starlette ĐŋĐĩŅĐĩĐšĐŧĐĩĐŊОвŅŅŅŅŅŅ ĐŊĐ° `StarletteHTTPException`:
+
+```Python
+from starlette.exceptions import HTTPException as StarletteHTTPException
+```
+
+### ĐОвŅĐžŅĐŊĐĩ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ОйŅОйĐŊиĐēŅв ĐŋĐžĐŧиĐģĐžĐē **FastAPI**
+
+Đ¯ĐēŅĐž Đи Ņ
ĐžŅĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ĐŋĐžĐŧиĐģĐēи ŅаСОĐŧ ŅС ŅĐ°ĐēиĐŧи Đļ ОйŅОйĐŊиĐēĐ°Đŧи ĐŋĐžĐŧиĐģĐžĐē Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ, ŅĐē Ņ **FastAPI**, Đи ĐŧĐžĐļĐĩŅĐĩ ŅĐŧĐŋĐžŅŅŅваŅи ŅĐ° ĐŋОвŅĐžŅĐŊĐž виĐēĐžŅиŅŅОвŅваŅи ŅŅ
ŅС `fastapi.exception_handlers`:
+
+{* ../../docs_src/handling_errors/tutorial006.py hl[2:5,15,21] *}
+
+ĐŖ ŅŅĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ Đи ĐŋŅĐžŅŅĐž виĐēĐžŅиŅŅОвŅŅŅĐĩ `print` Đ´ĐģŅ вивĐĩĐ´ĐĩĐŊĐŊŅ Đ´ŅĐļĐĩ ŅĐŊŅĐžŅĐŧĐ°ŅивĐŊĐžĐŗĐž ĐŋОвŅĐ´ĐžĐŧĐģĐĩĐŊĐŊŅ, Đ°ĐģĐĩ Đи СŅОСŅĐŧŅĐģи ĐžŅĐŊОвĐŊŅ ŅĐ´ĐĩŅ. Đи ĐŧĐžĐļĐĩŅĐĩ ОйŅОйиŅи ĐŋĐžĐŧиĐģĐēŅ ŅĐ° ĐŋОвŅĐžŅĐŊĐž виĐēĐžŅиŅŅОвŅваŅи ОйŅОйĐŊиĐēи ĐŋĐžĐŧиĐģĐžĐē Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ.
diff --git a/docs/uk/docs/tutorial/header-param-models.md b/docs/uk/docs/tutorial/header-param-models.md
new file mode 100644
index 000000000..6f7b0bdae
--- /dev/null
+++ b/docs/uk/docs/tutorial/header-param-models.md
@@ -0,0 +1,58 @@
+# ĐОдĐĩĐģŅ ĐĐ°ŅĐ°ĐŧĐĩŅŅŅв ĐĐ°ĐŗĐžĐģОвĐēŅв
+
+Đ¯ĐēŅĐž Ņ ĐĐ°Ņ Ņ ĐŗŅŅĐŋĐ° ĐŋОвâŅСаĐŊиŅ
ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв СаĐŗĐžĐģОвĐēŅв, Đи ĐŧĐžĐļĐĩŅĐĩ ŅŅвОŅиŅи **Pydantic ĐŧОдĐĩĐģŅ** Đ´ĐģŅ ŅŅ
ĐžĐŗĐžĐģĐžŅĐĩĐŊĐŊŅ.
+
+ĐĻĐĩ дОСвОĐģиŅŅ ĐĐ°Đŧ ĐŋОвŅĐžŅĐŊĐž **виĐēĐžŅиŅŅОвŅваŅи ĐŧОдĐĩĐģŅ** в **ŅŅСĐŊиŅ
ĐŧŅŅŅŅŅ
**, Đ° ŅĐ°ĐēĐžĐļ ĐžĐŗĐžĐģĐžŅиŅи ваĐģŅĐ´Đ°ŅŅŅ ŅĐ° ĐŧĐĩŅĐ°Đ´Đ°ĐŊŅ Đ´ĐģŅ вŅŅŅ
ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв ОдĐŊĐžŅĐ°ŅĐŊĐž. đ
+
+/// note | ĐĐžŅĐ°ŅĐēи
+
+ĐĻŅ ĐŧĐžĐļĐģивŅŅŅŅ ĐŋŅĐ´ŅŅиĐŧŅŅŅŅŅŅ ĐŋĐžŅиĐŊĐ°ŅŅи С вĐĩŅŅŅŅ FastAPI `0.115.0`. đ¤
+
+///
+
+## ĐĐ°ŅĐ°ĐŧĐĩŅŅи ĐĐ°ĐŗĐžĐģОвĐēŅв С ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅĐŧ Pydantic Model
+
+ĐĐŗĐžĐģĐžŅŅŅŅ ĐŋĐžŅŅŅĐąĐŊŅ **ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи СаĐŗĐžĐģОвĐēŅв** Ņ **Pydantic ĐŧОдĐĩĐģŅ**, Đ° ĐŋĐžŅŅĐŧ ĐžĐŗĐžĐģĐžŅŅŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ŅĐē `Header`:
+
+{* ../../docs_src/header_param_models/tutorial001_an_py310.py hl[9:14,18] *}
+
+FastAPI ĐąŅĐ´Đĩ виŅŅĐŗŅваŅи Đ´Đ°ĐŊŅ Đ´ĐģŅ ĐēĐžĐļĐŊĐžĐŗĐž ĐŋĐžĐģŅ С СаĐŗĐžĐģОвĐēŅв Ņ СаĐŋиŅŅ ŅĐ° ĐŋĐĩŅĐĩдаваŅи ŅŅ
Ņ ŅŅвОŅĐĩĐŊŅ ĐĐ°Đŧи Pydantic ĐŧОдĐĩĐģŅ.
+
+**FastAPI** ĐąŅĐ´Đĩ **виŅŅĐŗŅваŅи** Đ´Đ°ĐŊŅ Đ´ĐģŅ **ĐēĐžĐļĐŊĐžĐŗĐž ĐŋĐžĐģŅ** С **СаĐŗĐžĐģОвĐēŅв** Ņ СаĐŋиŅŅ ŅĐ° ĐŋĐĩŅĐĩдаваŅи ŅŅ
Ņ ŅŅвОŅĐĩĐŊŅ ĐĐ°Đŧи Pydantic ĐŧОдĐĩĐģŅ.
+
+## ĐĐĩŅĐĩвŅŅĐēĐ° в ĐĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋОйаŅиŅи ĐŊĐĩОйŅ
ŅĐ´ĐŊŅ СаĐŗĐžĐģОвĐēи в ŅĐŊŅĐĩŅŅĐĩĐšŅŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Са Đ°Đ´ŅĐĩŅĐžŅ `/docs`:
+
+
+
+
ĐĐžŅŅŅĐŋĐŊĐž С OpenAPI 3.1.0, FastAPI 0.99.0. |
+| `description` | `str` | ĐŅĐģŅŅ Đ´ĐĩŅĐ°ĐģŅĐŊиК ĐžĐŋиŅ API. ĐĐžĐļĐĩ виĐēĐžŅиŅŅОвŅваŅи Markdown. |
+| `version` | `string` | ĐĐĩŅŅŅŅ API. ĐĻĐĩ вĐĩŅŅŅŅ ĐĐ°ŅĐžĐŗĐž дОдаŅĐēĐ°, Đ° ĐŊĐĩ OpenAPI. ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, `2.5.0`. |
+| `terms_of_service` | `str` | URL Đ´Đž ŅĐŧОв виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ API. Đ¯ĐēŅĐž вĐēаСаĐŊĐž, ĐŧĐ°Ņ ĐąŅŅи Ņ ŅĐžŅĐŧĐ°ŅŅ URL. |
+| `contact` | `dict` | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ Đ´ĐģŅ ĐēĐžĐŊŅĐ°ĐēŅŅ С API. ĐĐžĐļĐĩ ĐŧŅŅŅиŅи ĐēŅĐģŅĐēĐ° ĐŋĐžĐģŅв. contact ĐŋĐžĐģŅĐĐ°ŅĐ°ĐŧĐĩŅŅ ĐĸиĐŋ ĐĐŋиŅ namestrĐĐŧ'Ņ ĐēĐžĐŊŅĐ°ĐēŅĐŊĐžŅ ĐžŅОйи айО ĐžŅĐŗĐ°ĐŊŅСаŅŅŅ. urlstrURL С ŅĐŊŅĐžŅĐŧĐ°ŅŅŅŅ Đ´ĐģŅ ĐēĐžĐŊŅĐ°ĐēŅŅ. ĐОвиĐŊĐĩĐŊ ĐąŅŅи Ņ ŅĐžŅĐŧĐ°ŅŅ URL. emailstrEmail ĐēĐžĐŊŅĐ°ĐēŅĐŊĐžŅ ĐžŅОйи айО ĐžŅĐŗĐ°ĐŊŅСаŅŅŅ. ĐОвиĐŊĐĩĐŊ ĐąŅŅи Ņ ŅĐžŅĐŧĐ°ŅŅ ĐĩĐģĐĩĐēŅŅĐžĐŊĐŊĐžŅ ĐŋĐžŅŅи.
license_info ĐŋĐžĐģŅĐĐ°ŅĐ°ĐŧĐĩŅŅ ĐĸиĐŋ ĐĐŋиŅ namestrĐĐĐĐ'Đ¯ĐĐĐĐĐ (ŅĐēŅĐž вŅŅĐ°ĐŊОвĐģĐĩĐŊĐž license_info). ĐаСва ĐģŅŅĐĩĐŊСŅŅ Đ´ĐģŅ API.identifierstrĐŅŅĐĩĐŊСŅĐšĐŊиК виŅаС Са SPDX Đ´ĐģŅ API. ĐĐžĐģĐĩ identifier вСаŅĐŧОвиĐēĐģŅŅĐŊĐĩ С ĐŋĐžĐģĐĩĐŧ url. ĐĐžŅŅŅĐŋĐŊĐž С OpenAPI 3.1.0, FastAPI 0.99.0. urlstrURL Đ´Đž ĐģŅŅĐĩĐŊСŅŅ, ŅĐēĐ° виĐēĐžŅиŅŅОвŅŅŅŅŅŅ Đ´ĐģŅ API. ĐОвиĐŊĐĩĐŊ ĐąŅŅи Ņ ŅĐžŅĐŧĐ°ŅŅ URL.
ĐŋŅĐĩŅŅĐēŅ 'X-' .
+
+ĐĐģĐĩ ŅĐēŅĐž Ņ ĐĐ°Ņ Ņ вĐģĐ°ŅĐŊŅ СаĐŗĐžĐģОвĐēи, ŅĐēŅ Đи Ņ
ĐžŅĐĩŅĐĩ, ŅОй ĐąŅĐ°ŅСĐĩŅĐŊиК ĐēĐģŅŅĐŊŅ ĐŧŅĐŗ ĐŋОйаŅиŅи, ĐŋĐžŅŅŅĐąĐŊĐž дОдаŅи ŅŅ
Đ´Đž ĐĐ°ŅĐžŅ ĐēĐžĐŊŅŅĐŗŅŅĐ°ŅŅŅ CORS (див. [CORS (ĐĐąĐŧŅĐŊ ŅĐĩŅŅŅŅĐ°Đŧи ĐŧŅĐļ ŅŅСĐŊиĐŧи Đ´ĐļĐĩŅĐĩĐģĐ°Đŧи)](cors.md){.internal-link target=_blank} Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `expose_headers`, ĐžĐŋиŅĐ°ĐŊĐžĐŗĐž в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Starlette ĐŋĐž CORS .
+
+///
+
+/// note | ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи `from starlette.requests import Request`.
+
+**FastAPI** ĐŊĐ°Đ´Đ°Ņ ŅĐĩ Đ´ĐģŅ ĐĐ°ŅĐžŅ СŅŅŅĐŊĐžŅŅŅ ŅĐē ŅОСŅОйĐŊиĐēĐ°. ĐĐģĐĩ вŅĐŊ ĐŋĐžŅ
ОдиŅŅ ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž СŅ Starlette.
+
+///
+
+### ĐĐž Ņ ĐŋŅŅĐģŅ `response`(`вŅĐ´ĐŋОвŅĐ´Ņ`)
+
+Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи ĐēОд, ŅĐēиК ĐąŅĐ´Đĩ виĐēĐžĐŊŅваŅиŅŅ С `СаĐŋиŅĐžĐŧ` (`request`), Đ´Đž ŅĐžĐŗĐž, ŅĐē КОĐŗĐž ОйŅОйиŅŅ ĐąŅĐ´Ņ-ŅĐēĐ° *ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ* (*path operation*).
+
+ĐĸĐ°ĐēĐžĐļ Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи ĐēОд, ŅĐēиК ĐąŅĐ´Đĩ виĐēĐžĐŊŅваŅиŅŅ ĐŋŅŅĐģŅ ŅĐžĐŗĐž, ŅĐē `вŅĐ´ĐŋОвŅĐ´Ņ` (`response`) ĐąŅĐ´Đĩ СĐŗĐĩĐŊĐĩŅОваĐŊĐž, ĐŋĐĩŅĐĩĐ´ ŅиĐŧ ŅĐē КОĐŗĐž ĐŋОвĐĩŅĐŊŅŅи.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи вĐģĐ°ŅĐŊиК СаĐŗĐžĐģОвОĐē `X-Process-Time`, ŅĐēиК ĐŧŅŅŅиŅиĐŧĐĩ ŅĐ°Ņ Ņ ŅĐĩĐēŅĐŊĐ´Đ°Ņ
, ŅĐēиК виŅŅĐ°ŅивŅŅ ĐŊĐ° ОйŅОйĐēŅ СаĐŋиŅŅ ŅĐ° ĐŗĐĩĐŊĐĩŅĐ°ŅŅŅ вŅĐ´ĐŋОвŅĐ´Ņ:
+
+{* ../../docs_src/middleware/tutorial001.py hl[10,12:13] *}
+
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+ĐĸŅŅ Đŧи виĐēĐžŅиŅŅОвŅŅĐŧĐž `time.perf_counter()` СаĐŧŅŅŅŅ `time.time()` ĐžŅĐēŅĐģŅĐēи вŅĐŊ ĐŧĐžĐļĐĩ ĐąŅŅи ĐąŅĐģŅŅ ŅĐžŅĐŊиĐŧ Đ´ĐģŅ ŅĐ°ĐēиŅ
виĐŋĐ°Đ´ĐēŅв. đ¤
+
+///
+
+## ĐĐŊŅŅ middlewares
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋŅСĐŊŅŅĐĩ ĐŋŅĐžŅиŅĐ°Ņи ĐąŅĐģŅŅĐĩ ĐŋŅĐž ŅĐŊŅŅ middlewares в [Advanced User Guide: Advanced Middleware](../advanced/middleware.md){.internal-link target=_blank}.
+
+Đи Đ´ŅСĐŊĐ°ŅŅĐĩŅŅ, ŅĐē ОйŅОйĐģŅŅи CORS Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ middleware в ĐŊĐ°ŅŅŅĐŋĐŊĐžĐŧŅ ŅОСдŅĐģŅ.
diff --git a/docs/uk/docs/tutorial/path-params-numeric-validations.md b/docs/uk/docs/tutorial/path-params-numeric-validations.md
new file mode 100644
index 000000000..281ee183c
--- /dev/null
+++ b/docs/uk/docs/tutorial/path-params-numeric-validations.md
@@ -0,0 +1,165 @@
+# Path ĐĐ°ŅĐ°ĐŧĐĩŅŅи ŅĐ° ваĐģŅĐ´Đ°ŅŅŅ ŅиŅĐģОвиŅ
Đ´Đ°ĐŊиŅ
+
+ĐĸĐ°Đē ŅĐ°ĐŧĐž ŅĐē Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅŅваŅи дОдаŅĐēОвŅ ĐŋĐĩŅĐĩвŅŅĐēи ŅĐ° ĐŧĐĩŅĐ°Đ´Đ°ĐŊŅ Đ´ĐģŅ query ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `Query`, Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅŅваŅи ŅОК ŅĐ°ĐŧиК ŅиĐŋ ĐŋĐĩŅĐĩвŅŅĐžĐē Ņ ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
Đ´ĐģŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв ŅĐģŅŅ
Ņ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `Path`.
+
+## ĐĐŧĐŋĐžŅŅ Path
+
+ĐĄĐŋĐžŅĐ°ŅĐēŅ ŅĐŧĐŋĐžŅŅŅĐšŅĐĩ `Path` С `fastapi` Ņ ŅĐŧĐŋĐžŅŅŅĐšŅĐĩ `Annotated`:
+
+{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+FastAPI дОдав ĐŋŅĐ´ŅŅиĐŧĐēŅ `Annotated` (Ņ ĐŋĐžŅав ŅĐĩĐēĐžĐŧĐĩĐŊĐ´ŅваŅи КОĐŗĐž виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ) Ņ вĐĩŅŅŅŅ 0.95.0.
+
+Đ¯ĐēŅĐž Ņ ĐĐ°Ņ ŅŅĐ°ŅĐ° вĐĩŅŅŅŅ, ĐŋŅи ŅĐŋŅОйŅ виĐēĐžŅиŅŅĐ°Ņи `Annotated` ĐŧĐžĐļŅŅŅ виĐŊиĐēĐ°Ņи ĐŋĐžĐŧиĐģĐēи.
+
+ĐĐĩŅĐĩĐēĐžĐŊĐ°ĐšŅĐĩŅŅ, ŅĐž Đи [ĐžĐŊОвиĐģи вĐĩŅŅŅŅ FastAPI](../deployment/versions.md#upgrading-the-fastapi-versions){.internal-link target=_blank} ĐŋŅиĐŊĐ°ĐšĐŧĐŊŅ Đ´Đž вĐĩŅŅŅŅ 0.95.1 ĐŋĐĩŅĐĩĐ´ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅĐŧ `Annotated`.
+
+///
+
+## ĐĐŗĐžĐģĐžŅĐĩĐŊĐŊŅ ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅŅваŅи вŅŅ ŅŅ Đļ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи, ŅĐž Ņ Đ´ĐģŅ `Query`.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅОй ĐžĐŗĐžĐģĐžŅиŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
`title` Đ´ĐģŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° ŅĐģŅŅ
Ņ `item_id`, Đи ĐŧĐžĐļĐĩŅĐĩ ĐŊĐ°ĐŋиŅĐ°Ņи:
+
+{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[10] *}
+
+/// note | ĐŅиĐŧŅŅĐēĐ°
+
+ĐĐ°ŅĐ°ĐŧĐĩŅŅ ŅĐģŅŅ
Ņ СавĐļди Ņ ОйОвâŅСĐēОвиĐŧ, ĐžŅĐēŅĐģŅĐēи вŅĐŊ ĐŧĐ°Ņ ĐąŅŅи ŅĐ°ŅŅиĐŊĐžŅ ŅĐģŅŅ
Ņ. ĐавŅŅŅ ŅĐēŅĐž Đи ĐžĐŗĐžĐģĐžŅиŅĐĩ КОĐŗĐž СŅ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ `None` айО вŅŅĐ°ĐŊОвиŅĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ â вŅĐŊ вŅĐĩ ОдĐŊĐž СаĐģиŅĐ°ŅиĐŧĐĩŅŅŅŅ ОйОвâŅСĐēОвиĐŧ.
+
+///
+
+## ĐŖĐŋĐžŅŅĐ´ĐēОвŅĐšŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи, ŅĐē ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+ĐĻĐĩ, ĐŧĐ°ĐąŅŅŅ, ĐŊĐĩ ĐŊĐ°ŅŅŅĐģŅĐēи ваĐļĐģивО айО ĐŊĐĩОйŅ
ŅĐ´ĐŊĐž, ŅĐēŅĐž Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ `Annotated`.
+
+///
+
+ĐŅиĐŋŅŅŅиĐŧĐž, Đи Ņ
ĐžŅĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ `q` ŅĐē ОйОвâŅСĐēОвиК `str`.
+
+Đ ĐĐ°Đŧ ĐŊĐĩ ĐŋĐžŅŅŅĐąĐŊĐž ĐžĐŗĐžĐģĐžŅŅваŅи ĐŊŅŅĐžĐŗĐž ŅĐŊŅĐžĐŗĐž Đ´ĐģŅ ŅŅĐžĐŗĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°, ŅĐžĐŧŅ ĐŊĐĩĐŧĐ°Ņ ĐŋĐžŅŅĐĩйи виĐēĐžŅиŅŅОвŅваŅи `Query`.
+
+ĐĐģĐĩ ĐĐ°Đŧ вŅĐĩ ОдĐŊĐž ĐŋĐžŅŅŅĐąĐŊĐž виĐēĐžŅиŅŅОвŅваŅи `Path` Đ´ĐģŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° ŅĐģŅŅ
Ņ `item_id`. РС ĐŋĐĩвĐŊиŅ
ĐŋŅиŅиĐŊ Đи ĐŊĐĩ Ņ
ĐžŅĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи `Annotated`.
+
+Python видаŅŅŅ ĐŋĐžĐŧиĐģĐēŅ, ŅĐēŅĐž ŅОСĐŧŅŅŅиŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ С "default" ĐŋĐĩŅĐĩĐ´ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ, ŅĐēĐĩ ĐŊĐĩ ĐŧĐ°Ņ "default".
+
+ĐĐģĐĩ Đи ĐŧĐžĐļĐĩŅĐĩ СĐŧŅĐŊиŅи ĐŋĐžŅŅĐ´ĐžĐē Ņ ŅОСĐŧŅŅŅиŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐąĐĩС СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ (ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ `q`) ĐŋĐĩŅŅиĐŧ.
+
+
+ĐĐģŅ **FastAPI** ĐŋĐžŅŅĐ´ĐžĐē ĐŊĐĩ ĐŧĐ°Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ. ĐŅĐŊ виСĐŊĐ°ŅĐ°Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи Са ŅŅ
ŅĐŧĐĩĐŊĐ°Đŧи, ŅиĐŋĐ°Đŧи ŅĐ° СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ (`Query`, `Path` ŅĐžŅĐž) Ņ ĐŊĐĩ СвĐĩŅŅĐ°Ņ ŅваĐŗи ĐŊĐ° ĐŋĐžŅŅĐ´ĐžĐē.
+
+ĐĸĐžĐŧŅ Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ĐĐ°ŅŅ ŅŅĐŊĐēŅŅŅ ŅĐ°Đē:
+
+//// tab | Python 3.8 non-Annotated
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+ĐĐ° ĐŧĐžĐļĐģивОŅŅŅ вŅддаваКŅĐĩ ĐŋĐĩŅĐĩваĐŗŅ вĐĩŅŅŅŅ С виĐēĐžŅиŅŅĐ°ĐŊĐŊŅĐŧ `Annotated`.
+
+///
+
+{* ../../docs_src/path_params_numeric_validations/tutorial002.py hl[7] *}
+
+////
+
+ĐĐģĐĩ ĐŧĐ°ĐšŅĐĩ ĐŊĐ° ŅваСŅ, ŅĐž ŅĐēŅĐž Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ `Annotated`, ŅŅ ĐŋŅОйĐģĐĩĐŧĐ° ĐŊĐĩ виĐŊиĐēĐŊĐĩ, ĐžŅĐēŅĐģŅĐēи Đи ĐŊĐĩ виĐēĐžŅиŅŅОвŅŅŅĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ Đ´ĐģŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв `Query()` айО `Path()`.
+
+{* ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py *}
+
+## ĐŖĐŋĐžŅŅĐ´ĐēОвŅĐšŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи Са ĐŋĐžŅŅĐĩйОŅ, Ņ
иŅŅĐžŅŅ
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+ĐĻĐĩ, ĐŧĐ°ĐąŅŅŅ, ĐŊĐĩ ĐŊĐ°ŅŅŅĐģŅĐēи ваĐļĐģивО айО ĐŊĐĩОйŅ
ŅĐ´ĐŊĐž, ŅĐēŅĐž Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ `Annotated`.
+
+///
+
+ĐŅŅ **ĐŊĐĩвĐĩĐģиĐēĐ° Ņ
иŅŅŅŅŅŅ**, ŅĐēĐ° ĐŧĐžĐļĐĩ ŅŅĐ°Ņи в ĐŋŅиĐŗОдŅ, Ņ
ĐžŅĐ° вОĐŊĐ° ŅŅĐ´ĐēĐž СĐŊадОйиŅŅŅŅ.
+
+Đ¯ĐēŅĐž Đи Ņ
ĐžŅĐĩŅĐĩ:
+
+* ĐžĐŗĐžĐģĐžŅиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ `q` ĐąĐĩС виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ `Query` айО СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ
+* ĐžĐŗĐžĐģĐžŅиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ŅĐģŅŅ
Ņ `item_id`, виĐēĐžŅиŅŅОвŅŅŅи `Path`
+* ŅОСĐŧŅŅŅиŅи ŅŅ
Ņ ŅŅСĐŊĐžĐŧŅ ĐŋĐžŅŅĐ´ĐēŅ
+* ĐŊĐĩ виĐēĐžŅиŅŅОвŅваŅи `Annotated`
+
+...Ņ Python Ņ ŅĐŋĐĩŅŅĐ°ĐģŅĐŊиК ŅиĐŊŅĐ°ĐēŅиŅ Đ´ĐģŅ ŅŅĐžĐŗĐž.
+
+ĐĐĩŅĐĩĐ´Đ°ĐšŅĐĩ `*` ŅĐē ĐŋĐĩŅŅиК ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ŅŅĐŊĐēŅŅŅ.
+
+Python ĐŊŅŅĐžĐŗĐž ĐŊĐĩ СŅОйиŅŅ ŅС ŅŅŅŅ `*`, Đ°ĐģĐĩ ŅОСĐŋŅСĐŊĐ°Ņ, ŅĐž вŅŅ ĐŊĐ°ŅŅŅĐŋĐŊŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи ŅĐģŅĐ´ виĐēĐģиĐēĐ°Ņи ŅĐē Đ°ŅĐŗŅĐŧĐĩĐŊŅи Са ĐēĐģŅŅОвиĐŧ ŅĐģОвОĐŧ (ĐŋĐ°Ņи ĐēĐģŅŅ-СĐŊĐ°ŅĐĩĐŊĐŊŅ), ŅĐ°ĐēĐžĐļ вŅĐ´ĐžĐŧŅ ŅĐē kwargsgtgelt
+
+
0.95.0 ) `Query` виĐēĐžŅиŅŅОвŅвавŅŅ ŅĐē СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ Đ´ĐģŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°, Đ° ĐŊĐĩ вŅĐĩŅĐĩдиĐŊŅ `Annotated`. Đи, ĐšĐŧОвŅŅĐŊĐž, ĐŋОйаŅиŅĐĩ ĐēОд, ŅĐēиК виĐēĐžŅиŅŅОвŅŅ ŅĐĩĐš ĐŋŅĐ´Ņ
ŅĐ´, ŅĐžĐŧŅ ваŅŅĐž ŅОСĐŗĐģŅĐŊŅŅи КОĐŗĐž.
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+ĐĐģŅ ĐŊОвОĐŗĐž ĐēОдŅ ŅĐ° ĐēĐžĐģи ŅĐĩ ĐŧĐžĐļĐģивО, виĐēĐžŅиŅŅОвŅĐšŅĐĩ `Annotated`, ŅĐē ĐŋĐžĐēаСаĐŊĐž виŅĐĩ. ĐĻĐĩ ĐŧĐ°Ņ йаĐŗĐ°ŅĐž ĐŋĐĩŅĐĩваĐŗ (ĐŋĐžŅŅĐŊĐĩĐŊиŅ
ĐŊиĐļŅĐĩ) Ņ ĐŊĐĩ ĐŧĐ°Ņ ĐŊĐĩĐ´ĐžĐģŅĐēŅв. đ°
+
+///
+
+Đ Đ°ĐŊŅŅĐĩ Đŧи ĐŋиŅĐ°Đģи `Query()` ŅĐē СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ Đ´ĐģŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° ŅŅĐŊĐēŅŅŅ, вŅŅĐ°ĐŊОвĐģŅŅŅи `max_length` Ņ 50:
+
+{* ../../docs_src/query_params_str_validations/tutorial002_py310.py hl[7] *}
+
+ĐŅĐēŅĐģŅĐēи в ŅŅĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ (ĐąĐĩС `Annotated`) ĐŊĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž СаĐŧŅĐŊиŅи `None` Ņ ŅŅĐŊĐēŅŅŅ ĐŊĐ° `Query()`, ŅĐĩĐŋĐĩŅ Đŧи ĐŋОвиĐŊĐŊŅ ŅвĐŊĐž вŅŅĐ°ĐŊОвиŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ ŅĐĩŅĐĩС ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `Query(default=None)`. ĐĻĐĩ виĐēĐžĐŊŅŅ ŅŅ ŅĐ°ĐŧŅ ŅĐžĐģŅ виСĐŊĐ°ŅĐĩĐŊĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ (ĐŋŅиĐŊĐ°ĐšĐŧĐŊŅ Đ´ĐģŅ FastAPI).
+
+ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ:
+
+```Python
+q: str | None = Query(default=None)
+```
+
+...ŅОйиŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ĐŊĐĩОйОвâŅСĐēОвиĐŧ СŅ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ `None`, ŅĐž ĐĩĐēвŅваĐģĐĩĐŊŅĐŊĐž:
+
+
+```Python
+q: str | None = None
+```
+ĐĐģĐĩ Ņ вĐĩŅŅŅŅ С `Query` Đŧи ŅвĐŊĐž вĐēаСŅŅĐŧĐž, ŅĐž ŅĐĩ query ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ.
+
+ĐĐ°ĐģŅ Đŧи ĐŧĐžĐļĐĩĐŧĐž ĐŋĐĩŅĐĩдаваŅи `Query` дОдаŅĐēОвŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи, СОĐēŅĐĩĐŧĐ° `max_length`, ŅĐēиК СаŅŅĐžŅОвŅŅŅŅŅŅ Đ´Đž ŅŅĐ´ĐēŅв:
+
+```Python
+q: str | None = Query(default=None, max_length=50)
+```
+
+ĐĻĐĩ СайĐĩСĐŋĐĩŅиŅŅ ваĐģŅĐ´Đ°ŅŅŅ Đ´Đ°ĐŊиŅ
, вивĐĩĐ´Đĩ СŅОСŅĐŧŅĐģŅ ĐŋĐžĐŧиĐģĐēŅ Ņ ŅаСŅ ĐŊĐĩĐ´ŅĐšŅĐŊиŅ
Đ´Đ°ĐŊиŅ
Ņ СадОĐēŅĐŧĐĩĐŊŅŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ Ņ ŅŅ
ĐĩĐŧŅ OpenAPI *ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*.
+
+### `Query` ŅĐē СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ айО вŅĐĩŅĐĩдиĐŊŅ `Annotated`
+
+ĐĐ°ĐļĐģивО ĐŋĐ°ĐŧâŅŅĐ°Ņи, ŅĐēŅĐž виĐēĐžŅиŅŅОвŅваŅи `Query` вŅĐĩŅĐĩдиĐŊŅ `Annotated`, ĐŊĐĩ ĐŧĐžĐļĐŊĐ° СадаваŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `default` Ņ `Query`.
+
+ĐĐ°ĐŧŅŅŅŅ ŅŅĐžĐŗĐž виĐēĐžŅиŅŅОвŅĐšŅĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ Ņ ŅĐ°ĐŧŅĐš ŅŅĐŊĐēŅŅŅ. ĐĐŊĐ°ĐēŅĐĩ ŅĐĩ ĐąŅĐ´Đĩ ĐŊĐĩĐģĐžĐŗŅŅĐŊĐž.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐĩĐš ваŅŅĐ°ĐŊŅ Ņ ĐŊĐĩĐēĐžŅĐĩĐēŅĐŊиĐŧ:
+
+```Python
+q: Annotated[str, Query(default="rick")] = "morty"
+```
+
+...ŅĐžĐŧŅ, ŅĐž ĐŊĐĩ СŅОСŅĐŧŅĐģĐž, ŅĐēĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐŧĐ°Ņ ĐąŅŅи СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ: `"rick"` Ņи `"morty"`.
+
+ĐĐžŅĐĩĐēŅĐŊŅ ваŅŅĐ°ĐŊŅи:
+
+```Python
+q: Annotated[str, Query()] = "rick"
+```
+
+...айО Ņ ŅŅĐ°ŅиŅ
ĐēОдОвиŅ
йаСаŅ
Đи СĐŊаКдĐĩŅĐĩ:
+
+```Python
+q: str = Query(default="rick")
+```
+
+### ĐĐĩŅĐĩваĐŗи виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ `Annotated`
+
+**ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ `Annotated` Ņ ŅĐĩĐēĐžĐŧĐĩĐŊдОваĐŊиĐŧ** СаĐŧŅŅŅŅ СадаĐŊĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°Ņ
ŅŅĐŊĐēŅŅŅ, ĐžŅĐēŅĐģŅĐēи вОĐŊĐž **ĐēŅĐ°ŅĐĩ** С ĐēŅĐģŅĐēĐžŅ
ĐŋŅиŅиĐŊ. đ¤
+
+ĐĐŊĐ°ŅĐĩĐŊĐŊŅ **Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ** ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° **ŅŅĐŊĐēŅŅŅ** Ņ КОĐŗĐž **ŅĐ°ĐēŅиŅĐŊиĐŧ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ**, ŅĐž Ņ ĐąŅĐģŅŅ ŅĐŊŅŅŅŅивĐŊиĐŧ Ņ Python СаĐŗĐ°ĐģĐžĐŧ. đ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ **виĐēĐģиĐēĐ°Ņи** ŅŅ ŅĐ°ĐŧŅ ŅŅĐŊĐēŅŅŅ **в ŅĐŊŅиŅ
ĐŧŅŅŅŅŅ
** ĐąĐĩС FastAPI, Ņ вОĐŊĐ° **ĐŋŅĐ°ŅŅваŅиĐŧĐĩ ĐžŅŅĐēŅваĐŊĐž**. Đ¯ĐēŅĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ Ņ **ОйОвâŅСĐēОвиĐŧ** (ĐąĐĩС СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ), ĐĐ°Ņ **ŅĐĩĐ´Đ°ĐēŅĐžŅ** ĐŋОвŅĐ´ĐžĐŧиŅŅ ĐŋŅĐž ĐŋĐžĐŧиĐģĐēŅ, Đ° **Python** ŅĐ°ĐēĐžĐļ видаŅŅŅ ĐŋĐžĐŧиĐģĐēŅ, ŅĐēŅĐž Đи виĐēĐžĐŊĐ°ŅŅĐĩ ŅŅĐŊĐēŅŅŅ ĐąĐĩС ĐŋĐĩŅĐĩдаваĐŊĐŊŅ ŅŅĐžĐŗĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°.
+
+Đ¯ĐēŅĐž Đи ĐŊĐĩ виĐēĐžŅиŅŅОвŅŅŅĐĩ `Annotated`, Đ° виĐēĐžŅиŅŅОвŅŅŅĐĩ **(ŅŅĐ°ŅиК) ŅŅиĐģŅ СĐŊĐ°ŅĐĩĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ**, ŅĐž ĐŋŅи виĐēĐģиĐēŅ ŅŅŅŅ ŅŅĐŊĐēŅŅŅ ĐąĐĩС FastAPI **в ŅĐŊŅиŅ
ĐŧŅŅŅŅŅ
**, ĐŋĐžŅŅŅĐąĐŊĐž **ĐŊĐĩ СайŅŅи** ĐŋĐĩŅĐĩĐ´Đ°Ņи ŅĐš Đ°ŅĐŗŅĐŧĐĩĐŊŅи, ŅĐŊĐ°ĐēŅĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐąŅĐ´ŅŅŅ вŅĐ´ŅŅСĐŊŅŅиŅŅ вŅĐ´ ĐžŅŅĐēŅваĐŊиŅ
(ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, Đи ĐžŅŅиĐŧĐ°ŅŅĐĩ `QueryInfo` айО ĐŋОдŅĐąĐŊĐĩ СаĐŧŅŅŅŅ `str`). ĐĐ°Ņ ŅĐĩĐ´Đ°ĐēŅĐžŅ ĐŊĐĩ ĐŋОвŅĐ´ĐžĐŧиŅŅ ĐŋŅĐž ĐŋĐžĐŧиĐģĐēŅ, Ņ Python ŅĐ°ĐēĐžĐļ ĐŊĐĩ видаŅŅŅ ĐŋĐžĐŧиĐģĐēŅ ĐŋŅи СаĐŋŅŅĐēŅ ŅŅĐŊĐēŅŅŅ, ĐŋĐžĐēи ĐŊĐĩ виĐŊиĐēĐŊĐĩ ĐŋĐžĐŧиĐģĐēĐ° ĐŋŅĐ´ ŅĐ°Ņ виĐēĐžĐŊĐ°ĐŊĐŊŅ ĐžĐŋĐĩŅĐ°ŅŅĐš ŅŅĐĩŅĐĩдиĐŊŅ.
+
+ĐŅĐēŅĐģŅĐēи `Annotated` ĐŧĐžĐļĐĩ ĐŧŅŅŅиŅи ĐēŅĐģŅĐēĐ° Đ°ĐŊĐžŅĐ°ŅŅĐš ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
, Đи ĐŊавŅŅŅ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ŅŅ ŅĐ°ĐŧŅ ŅŅĐŊĐēŅŅŅ С ŅĐŊŅиĐŧи ŅĐŊŅŅŅŅĐŧĐĩĐŊŅĐ°Đŧи, ŅĐ°ĐēиĐŧи ŅĐē Typer . đ
+
+## ĐОдаваĐŊĐŊŅ дОдаŅĐēОвиŅ
ваĐģŅĐ´Đ°ŅŅĐš
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ дОдаŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `min_length`:
+
+{* ../../docs_src/query_params_str_validations/tutorial003_an_py310.py hl[10] *}
+
+## ĐОдаваĐŊĐŊŅ ŅĐĩĐŗŅĐģŅŅĐŊиŅ
виŅаСŅв
+
+Đи ĐŧĐžĐļĐĩŅĐĩ виСĐŊĐ°ŅиŅи ŅĐĩĐŗŅĐģŅŅĐŊиК виŅаС pattern, ŅĐēĐžĐŧŅ ĐŧĐ°Ņ вŅĐ´ĐŋОвŅĐ´Đ°Ņи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ:
+
+{* ../../docs_src/query_params_str_validations/tutorial004_an_py310.py hl[11] *}
+
+ĐĻĐĩĐš ĐēĐžĐŊĐēŅĐĩŅĐŊиК ŅĐ°ĐąĐģĐžĐŊ ŅĐĩĐŗŅĐģŅŅĐŊĐžĐŗĐž виŅаСŅ ĐŋĐĩŅĐĩвŅŅŅŅ, ŅĐž ĐžŅŅиĐŧĐ°ĐŊĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°:
+
+* `^`: ĐŋĐžŅиĐŊĐ°ŅŅŅŅŅ С ĐŊĐ°ŅŅŅĐŋĐŊиŅ
ŅиĐŧвОĐģŅв, ĐŋĐĩŅĐĩĐ´ ŅĐēиĐŧи ĐŊĐĩĐŧĐ°Ņ ŅĐŊŅиŅ
ŅиĐŧвОĐģŅв.
+* `fixedquery`: ŅĐžŅĐŊĐž вŅĐ´ĐŋОвŅĐ´Đ°Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ `fixedquery`.
+* `$`: СаĐēŅĐŊŅŅŅŅŅŅŅ ŅŅŅ, ĐŋŅŅĐģŅ `fixedquery` ĐŊĐĩĐŧĐ°Ņ ĐļОдĐŊиŅ
ŅиĐŧвОĐģŅв.
+
+Đ¯ĐēŅĐž Đи ĐŋĐžŅŅваŅŅĐĩŅŅ ŅОСĐŗŅĐąĐģĐĩĐŊĐž ŅОдО **"ŅĐĩĐŗŅĐģŅŅĐŊиŅ
виŅаСŅв"**, ĐŊĐĩ Ņ
виĐģŅĐšŅĐĩŅŅ. ĐĐžĐŊи Ņ ŅĐēĐģĐ°Đ´ĐŊĐžŅ ŅĐĩĐŧĐžŅ Đ´ĐģŅ йаĐŗĐ°ŅŅĐžŅ
ĐģŅĐ´ĐĩĐš. Đи вŅĐĩ ОдĐŊĐž ĐŧĐžĐļĐĩŅĐĩ СŅОйиŅи йаĐŗĐ°ŅĐž ŅĐĩŅĐĩĐš ĐąĐĩС ŅŅ
виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ.
+
+ĐĐģĐĩ ŅĐĩĐŋĐĩŅ Đи СĐŊĐ°ŅŅĐĩ, ŅĐž ĐēĐžĐģи вОĐŊи СĐŊадОйĐģŅŅŅŅŅ, ŅŅ
ĐŧĐžĐļĐŊĐ° СаŅŅĐžŅОвŅваŅи Ņ **FastAPI**.
+
+### Pydantic v1 `regex` СаĐŧŅŅŅŅ `pattern`
+
+ĐĐž вĐĩŅŅŅŅ Pydantic 2 Ņ FastAPI 0.100.0 ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ĐŊаСивавŅŅ `regex` СаĐŧŅŅŅŅ `pattern`, Đ°ĐģĐĩ ŅĐĩĐŋĐĩŅ вŅĐŊ СаŅŅĐ°ŅŅв.
+
+Đи вŅĐĩ ŅĐĩ ĐŧĐžĐļĐĩŅĐĩ СŅŅŅŅŅŅи ĐēОд, ŅĐēиК виĐēĐžŅиŅŅОвŅŅ КОĐŗĐž:
+
+//// tab | Pydantic v1
+
+{* ../../docs_src/query_params_str_validations/tutorial004_regex_an_py310.py hl[11] *}
+
+////
+
+ĐĐģĐĩ ĐŧĐ°ĐšŅĐĩ ĐŊĐ° ŅваСŅ, ŅĐž вŅĐŊ Ņ СаŅŅĐ°ŅŅĐģиĐŧ Ņ КОĐŗĐž ŅĐģŅĐ´ ĐžĐŊОвиŅи Đ´Đž ĐŊОвОĐŗĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `pattern`. đ¤
+
+## ĐĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ, вŅĐ´ĐŧŅĐŊĐŊŅ вŅĐ´ `None`.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐēŅĐž Đи Ņ
ĐžŅĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ `q` С `min_length` `3` Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ `"fixedquery"`:
+
+{* ../../docs_src/query_params_str_validations/tutorial005_an_py39.py hl[9] *}
+
+/// note | ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+ĐĐ°ŅвĐŊŅŅŅŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ ĐąŅĐ´Ņ-ŅĐēĐžĐŗĐž ŅиĐŋŅ, вĐēĐģŅŅĐ°ŅŅи `None`, ŅОйиŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ĐŊĐĩОйОвâŅСĐēОвиĐŧ (not required).
+
+///
+
+## ĐйОвâŅСĐēОвŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи
+
+Đ¯ĐēŅĐž ĐŊĐ°Đŧ ĐŊĐĩ ĐŋĐžŅŅŅĐąĐŊĐž вĐēаСŅваŅи дОдаŅĐēОвŅ ĐŋĐĩŅĐĩвŅŅĐēи айО ĐŧĐĩŅĐ°Đ´Đ°ĐŊŅ, Đŧи ĐŧĐžĐļĐĩĐŧĐž СŅОйиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `q` ОйОвâŅСĐēОвиĐŧ, ĐŋŅĐžŅŅĐž ĐŊĐĩ ĐžĐŗĐžĐģĐžŅŅŅŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´:
+
+```Python
+q: str
+```
+
+СаĐŧŅŅŅŅ:
+
+```Python
+q: str | None = None
+```
+
+ĐĐģĐĩ ŅĐĩĐŋĐĩŅ Đŧи ĐžĐŗĐžĐģĐžŅŅŅĐŧĐž КОĐŗĐž С `Query`, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´:
+
+//// tab | Annotated
+
+```Python
+q: Annotated[str | None, Query(min_length=3)] = None
+```
+
+////
+
+ĐĸĐžĐŧŅ, ŅĐēŅĐž ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž СŅОйиŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ ОйОвâŅСĐēОвиĐŧ, виĐēĐžŅиŅŅОвŅŅŅи `Query`, ĐŋŅĐžŅŅĐž ĐŊĐĩ вĐēаСŅĐšŅĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ:
+
+{* ../../docs_src/query_params_str_validations/tutorial006_an_py39.py hl[9] *}
+
+### ĐйОвâŅСĐēОвĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ, ŅĐēĐĩ ĐŧĐžĐļĐĩ ĐąŅŅи `None`
+
+Đи ĐŧĐžĐļĐĩŅĐĩ вĐēаСаŅи, ŅĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ĐŧĐžĐļĐĩ ĐŋŅиКĐŧĐ°Ņи `None`, Đ°ĐģĐĩ ĐŋŅи ŅŅĐžĐŧŅ СаĐģиŅĐ°ŅŅŅŅŅ ОйОвâŅСĐēОвиĐŧ. ĐĻĐĩ СĐŧŅŅиŅŅ ĐēĐģŅŅĐŊŅŅв ĐŊĐ°Đ´ŅŅĐģĐ°Ņи СĐŊĐ°ŅĐĩĐŊĐŊŅ, ĐŊавŅŅŅ ŅĐēŅĐž вОĐŊĐž Đ´ĐžŅŅвĐŊŅŅ `None`.
+
+ЊОй СŅОйиŅи ŅĐĩ, ĐžĐŗĐžĐģĐžŅŅŅŅ, ŅĐž `None` Ņ Đ´ĐžĐŋŅŅŅиĐŧиĐŧ ŅиĐŋĐžĐŧ, Đ°ĐģĐĩ ĐŊĐĩ вĐēаСŅĐšŅĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ:
+
+{* ../../docs_src/query_params_str_validations/tutorial006c_an_py310.py hl[9] *}
+
+## ĐĄĐŋиŅĐžĐē ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв СаĐŋиŅŅ / ĐēŅĐģŅĐēĐ° СĐŊĐ°ŅĐĩĐŊŅ
+
+Đ¯ĐēŅĐž Đи виСĐŊĐ°ŅĐ°ŅŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `Query`, Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ дОСвОĐģиŅи ĐžŅŅиĐŧĐ°ĐŊĐŊŅ ŅĐŋиŅĐēŅ СĐŊĐ°ŅĐĩĐŊŅ, ŅОйŅĐž дОСвОĐģиŅи ĐžŅŅиĐŧĐ°ĐŊĐŊŅ ĐēŅĐģŅĐēĐžŅ
СĐŊĐ°ŅĐĩĐŊŅ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅОй дОСвОĐģиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅ СаĐŋиŅŅ `q` С'ŅвĐģŅŅиŅŅ ĐēŅĐģŅĐēĐ° ŅаСŅв в URL, ĐŧĐžĐļĐŊĐ° ĐŊĐ°ĐŋиŅĐ°Ņи:
+
+{* ../../docs_src/query_params_str_validations/tutorial011_an_py310.py hl[9] *}
+
+ĐĸОдŅ, Ņ виĐŋĐ°Đ´ĐēŅ СаĐŋиŅŅ Са URL:
+
+```
+http://localhost:8000/items/?q=foo&q=bar
+```
+
+Đи ĐžŅŅиĐŧĐ°ŅŅĐĩ ĐēŅĐģŅĐēĐ° СĐŊĐ°ŅĐĩĐŊŅ *query ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°* `q` (`foo` Ņ `bar`) Ņ виĐŗĐģŅĐ´Ņ ŅĐŋиŅĐēŅ `list` в Python Ņ ĐĐ°ŅŅĐš *ŅŅĐŊĐēŅŅŅ ОйŅОйĐēи ŅĐģŅŅ
Ņ*, Ņ *ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅ ŅŅĐŊĐēŅŅŅ* `q`.
+
+ĐŅĐļĐĩ, вŅĐ´ĐŋОвŅĐ´Ņ ĐŊĐ° ŅĐĩĐš URL ĐąŅĐ´Đĩ:
+
+```JSON
+{
+ "q": [
+ "foo",
+ "bar"
+ ]
+}
+```
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+ЊОй ĐžĐŗĐžĐģĐžŅиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ С ŅиĐŋĐžĐŧ `list`, ŅĐē Ņ ĐŊавĐĩĐ´ĐĩĐŊĐžĐŧŅ виŅĐĩ ĐŋŅиĐēĐģĐ°Đ´Ņ, ĐŋĐžŅŅŅĐąĐŊĐž ŅвĐŊĐž виĐēĐžŅиŅŅОвŅваŅи `Query`, ŅĐŊĐ°ĐēŅĐĩ вŅĐŊ ĐąŅĐ´Đĩ ŅĐŊŅĐĩŅĐŋŅĐĩŅОваĐŊиК ŅĐē ŅŅĐģĐž СаĐŋиŅŅ.
+
+///
+
+ĐĐŊŅĐĩŅĐ°ĐēŅивĐŊĐ° API-Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ĐžĐŊОвиŅŅŅŅ вŅĐ´ĐŋОвŅĐ´ĐŊĐž, дОСвОĐģŅŅŅи ĐŋĐĩŅĐĩдаваŅи ĐēŅĐģŅĐēĐ° СĐŊĐ°ŅĐĩĐŊŅ:
+
+СаŅŅĐ°ŅŅĐģиĐŧ .
+
+ĐĸОдŅ Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋĐĩŅĐĩĐ´Đ°Ņи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `deprecated=True` Đ´Đž `Query`:
+
+{* ../../docs_src/query_params_str_validations/tutorial010_an_py310.py hl[19] *}
+
+ĐĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ĐąŅĐ´Đĩ ĐŋĐžĐēаСŅваŅи ŅĐĩ ŅĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ:
+
+Pydantic's `AfterValidator` в ŅĐĩŅĐĩдиĐŊŅ `Annotated`.
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+Pydantic ŅĐ°ĐēĐžĐļ ĐŧĐ°Ņ `BeforeValidator` ŅĐ° ŅĐŊŅŅ. đ¤
+
+///
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐĩĐš ĐēĐ°ŅŅĐžĐŧĐŊиК ваĐģŅĐ´Đ°ŅĐžŅ ĐŋĐĩŅĐĩвŅŅŅŅ, Ņи ĐŋĐžŅиĐŊĐ°ŅŅŅŅŅ ID ĐĩĐģĐĩĐŧĐĩĐŊŅĐ° С `isbn-` Đ´ĐģŅ ĐŊĐžĐŧĐĩŅĐ° ĐēĐŊиĐŗи ISBN айО С `imdb-` Đ´ĐģŅ ID URL ŅŅĐģŅĐŧŅ ĐŊĐ° IMDB :
+
+{* ../../docs_src/query_params_str_validations/tutorial015_an_py310.py hl[5,16:19,24] *}
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐĻĐĩ Đ´ĐžŅŅŅĐŋĐŊĐž С вĐĩŅŅŅŅ Pydantic 2 айО виŅĐĩ. đ
+
+///
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+Đ¯ĐēŅĐž ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž виĐēĐžĐŊĐ°Ņи ĐąŅĐ´Ņ-ŅĐēŅ ваĐģŅĐ´Đ°ŅŅŅ, ŅĐēĐ° виĐŧĐ°ĐŗĐ°Ņ вСаŅĐŧОдŅŅ С ĐąŅĐ´Ņ-ŅĐēиĐŧ **СОвĐŊŅŅĐŊŅĐŧ ĐēĐžĐŧĐŋĐžĐŊĐĩĐŊŅĐžĐŧ**, ŅĐ°ĐēиĐŧ ŅĐē йаСа Đ´Đ°ĐŊиŅ
Ņи ŅĐŊŅиК API, ви ĐŋОвиĐŊĐŊŅ СаĐŧŅŅŅŅ ŅŅĐžĐŗĐž виĐēĐžŅиŅŅОвŅваŅи **FastAPI Dependencies**. Đи Đ´ŅСĐŊĐ°ŅŅĐĩŅŅ ĐŋŅĐž ĐŊиŅ
ĐŋŅСĐŊŅŅĐĩ.
+
+ĐĻŅ ĐēĐ°ŅŅĐžĐŧĐŊŅ ваĐģŅĐ´Đ°ŅĐžŅи виĐēĐžŅиŅŅОвŅŅŅŅŅŅ Đ´ĐģŅ ŅĐĩŅĐĩĐš, ŅĐēŅ ĐŧĐžĐļĐŊĐ° ĐŋĐĩŅĐĩвŅŅиŅи ĐģиŅĐĩ С **ŅиĐŧи Đ´Đ°ĐŊиĐŧи**, ŅĐž ĐŊĐ°Đ´Đ°ĐŊŅ в СаĐŋиŅŅ.
+
+///
+
+### ĐŅОСŅĐŧŅĐšŅĐĩ ŅĐĩĐš ĐēОд
+
+ĐĐžĐģОвĐŊиК ĐŧĐžĐŧĐĩĐŊŅ â ŅĐĩ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ **`AfterValidator` С ŅŅĐŊĐēŅŅŅŅ вŅĐĩŅĐĩдиĐŊŅ `Annotated`**. ĐĐžĐļĐĩŅĐĩ ĐŋŅĐžĐŋŅŅŅиŅи ŅŅ ŅĐ°ŅŅиĐŊŅ, ŅĐēŅĐž Ņ
ĐžŅĐĩŅĐĩ. đ¤¸
+
+---
+
+ĐĐģĐĩ ŅĐēŅĐž ĐĐ°Đŧ ŅŅĐēавО ŅОСŅĐąŅĐ°ŅиŅŅ в ŅŅĐžĐŧŅ ĐēĐžĐŊĐēŅĐĩŅĐŊĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ ĐēОдŅ Ņ ĐĐ°Đŧ ŅĐĩ ĐŊĐĩ ĐŊĐ°ĐąŅидĐģĐž, ĐžŅŅ ĐēŅĐģŅĐēĐ° дОдаŅĐēОвиŅ
Đ´ĐĩŅĐ°ĐģĐĩĐš.
+
+#### Đ ŅĐ´ĐžĐē ŅС `value.startswith()`
+
+ĐвĐĩŅĐŊŅĐģи ŅваĐŗŅ? Đ ŅĐ´ĐžĐē ŅС `value.startswith()` ĐŧĐžĐļĐĩ ĐŋŅиКĐŧĐ°Ņи ĐēĐžŅŅĐĩĐļ, Ņ ŅОдŅ вŅĐŊ ĐŋĐĩŅĐĩвŅŅŅŅиĐŧĐĩ ĐēĐžĐļĐŊĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ в ĐēĐžŅŅĐĩĐļŅ:
+
+{* ../../docs_src/query_params_str_validations/tutorial015_an_py310.py ln[16:19] hl[17] *}
+
+#### ĐиĐŋĐ°Đ´ĐēОвиК ĐĩĐģĐĩĐŧĐĩĐŊŅ
+
+ĐĐ° Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `data.items()` Đŧи ĐžŅŅиĐŧŅŅĐŧĐž ŅŅĐĩŅĐ°ĐąĐĩĐģŅĐŊиК Ой'ŅĐēŅ ŅС ĐēĐžŅŅĐĩĐļĐ°Đŧи, ŅĐž ĐŧŅŅŅŅŅŅ ĐēĐģŅŅ Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ Đ´ĐģŅ ĐēĐžĐļĐŊĐžĐŗĐž ĐĩĐģĐĩĐŧĐĩĐŊŅĐ° ŅĐģОвĐŊиĐēĐ°.
+
+Đи ĐŋĐĩŅĐĩŅвОŅŅŅĐŧĐž ŅĐĩĐš ŅŅĐĩŅĐ°ĐąĐĩĐģŅĐŊиК Ой'ŅĐēŅ Ņ СвиŅĐ°ĐšĐŊиК `list` Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `list(data.items())`.
+
+ĐĐžŅŅĐŧ, виĐēĐžŅиŅŅОвŅŅŅи `random.choice()`, Đŧи ĐŧĐžĐļĐĩĐŧĐž ĐžŅŅиĐŧĐ°Ņи виĐŋĐ°Đ´ĐēОвĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ СŅ ŅĐŋиŅĐēŅ, ŅОйŅĐž ĐžŅŅиĐŧŅŅĐŧĐž ĐēĐžŅŅĐĩĐļ ŅС `(id, name)`. ĐĻĐĩ ĐŧĐžĐļĐĩ ĐąŅŅи ŅĐžŅŅ ĐŊĐ° СŅаСОĐē `("imdb-tt0371724", "The Hitchhiker's Guide to the Galaxy")`.
+
+ĐĐ°ĐģŅ Đŧи **ĐŋŅиŅвОŅŅĐŧĐž ŅŅ два СĐŊĐ°ŅĐĩĐŊĐŊŅ** ĐēĐžŅŅĐĩĐļŅ СĐŧŅĐŊĐŊиĐŧ `id` Ņ `name`.
+
+ĐĸĐžĐļ, ŅĐēŅĐž ĐēĐžŅиŅŅŅваŅ ĐŊĐĩ вĐēаСав ID ĐĩĐģĐĩĐŧĐĩĐŊŅĐ°, вŅĐŊ вŅĐĩ ОдĐŊĐž ĐžŅŅиĐŧĐ°Ņ виĐŋĐ°Đ´ĐēОвŅ ŅĐĩĐēĐžĐŧĐĩĐŊĐ´Đ°ŅŅŅ.
+
+...Ņ вŅĐĩ ŅĐĩ ŅĐĩĐ°ĐģŅСОваĐŊĐž в **ОдĐŊĐžĐŧŅ ŅŅĐ´ĐēŅ ĐēОдŅ**. đ¤¯ ĐĨŅйа ĐŊĐĩ ĐŋŅĐĩĐēŅĐ°ŅĐŊиК Python? đ
+
+{* ../../docs_src/query_params_str_validations/tutorial015_an_py310.py ln[22:30] hl[29] *}
+
+## ĐŅĐ´ŅŅĐŧĐžĐē
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅŅваŅи дОдаŅĐēОвŅ ваĐģŅĐ´Đ°ŅŅŅ ŅĐ° ĐŧĐĩŅĐ°ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ Đ´ĐģŅ ŅвОŅŅ
ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв.
+
+ĐĐ°ĐŗĐ°ĐģŅĐŊŅ ваĐģŅĐ´Đ°ŅŅŅ ŅĐ° ĐŧĐĩŅĐ°ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ:
+
+* `alias`
+* `title`
+* `description`
+* `deprecated`
+
+ĐĐ°ĐģŅĐ´Đ°ŅŅŅ, ŅĐŋĐĩŅиŅŅŅĐŊŅ Đ´ĐģŅ ŅŅĐ´ĐēŅв:
+
+* `min_length`
+* `max_length`
+* `pattern`
+
+ĐĐ°ŅŅĐžĐŧĐŊŅ ваĐģŅĐ´Đ°ŅŅŅ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `AfterValidator`.
+
+ĐŖ ŅиŅ
ĐŋŅиĐēĐģĐ°Đ´Đ°Ņ
Đи ĐŋОйаŅиĐģи, ŅĐē ĐžĐŗĐžĐģĐžŅŅваŅи ваĐģŅĐ´Đ°ŅŅŅ Đ´ĐģŅ СĐŊĐ°ŅĐĩĐŊŅ `str`.
+
+ĐивŅŅŅŅŅ ĐŊĐ°ŅŅŅĐŋĐŊŅ ŅОСдŅĐģи, ŅОй Đ´ŅСĐŊĐ°ŅиŅŅ, ŅĐē ĐžĐŗĐžĐģĐžŅŅваŅи ваĐģŅĐ´Đ°ŅŅŅ Đ´ĐģŅ ŅĐŊŅиŅ
ŅиĐŋŅв, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´ ŅиŅĐĩĐģ.
diff --git a/docs/uk/docs/tutorial/response-model.md b/docs/uk/docs/tutorial/response-model.md
new file mode 100644
index 000000000..def1f8a2d
--- /dev/null
+++ b/docs/uk/docs/tutorial/response-model.md
@@ -0,0 +1,358 @@
+# ĐОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ â ĐĸиĐŋ, ŅĐž ĐŋОвĐĩŅŅĐ°ŅŅŅŅŅ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ŅиĐŋ, ŅĐēиК виĐēĐžŅиŅŅОвŅваŅиĐŧĐĩŅŅŅŅ Ņ вŅĐ´ĐŋОвŅĐ´Ņ, Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ *Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ, ŅĐž ĐŋОвĐĩŅŅĐ°ŅŅŅŅŅ* *ŅŅĐŊĐēŅŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅŅ ŅĐģŅŅ
Ņ* (path operation)
+
+**ĐĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ** ĐŧĐžĐļĐŊĐ° вĐēаСаŅи ŅĐ°Đē ŅĐ°ĐŧĐž ŅĐē Ņ Đ´ĐģŅ вŅ
ŅĐ´ĐŊиŅ
**ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв** ŅŅĐŊĐēŅŅŅ: ŅĐĩ ĐŧĐžĐļŅŅŅ ĐąŅŅи ĐŧОдĐĩĐģŅ Pydantic, ŅĐŋиŅĐēи (lists), ŅĐģОвĐŊиĐēи (dictionaries), ŅĐēĐ°ĐģŅŅĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ, ŅĐē-ĐžŅ ŅŅĐģŅ ŅиŅĐģĐ° (integers), ĐąŅĐģĐĩвŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ (booleans) ŅĐžŅĐž.
+
+{* ../../docs_src/response_model/tutorial001_01_py310.py hl[16,21] *}
+
+FastAPI виĐēĐžŅиŅŅОвŅваŅиĐŧĐĩ ŅĐĩĐš ŅиĐŋ, ŅОй:
+
+* **ĐĐĩŅĐĩвŅŅиŅи ĐŋŅавиĐģŅĐŊŅŅŅŅ** ĐŋОвĐĩŅĐŊĐĩĐŊиŅ
Đ´Đ°ĐŊиŅ
.
+ * Đ¯ĐēŅĐž Đ´Đ°ĐŊŅ ĐŊĐĩ ваĐģŅĐ´ĐŊŅ (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, вŅĐ´ŅŅŅĐŊŅ ĐŋĐžĐģĐĩ), ŅĐĩ ОСĐŊĐ°ŅĐ°Ņ, ŅĐž ĐĐ°Ņ ĐēОд дОдаŅĐēŅ ĐŋŅĐ°ŅŅŅ ĐŊĐĩĐēĐžŅĐĩĐēŅĐŊĐž Ņ ĐŊĐĩ ĐŋОвĐĩŅŅĐ°Ņ ŅĐĩ, ŅĐž ĐŋОвиĐŊĐĩĐŊ. ĐŖ ŅĐ°ĐēĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ FastAPI ĐŋОвĐĩŅĐŊĐĩ ĐŋĐžĐŧиĐģĐēŅ ŅĐĩŅвĐĩŅĐ°, СаĐŧŅŅŅŅ ŅĐžĐŗĐž ŅОй вŅĐ´Đ´Đ°Ņи ĐŊĐĩĐ´ĐžĐŋŅŅŅиĐŧŅ Đ´Đ°ĐŊŅ. ĐĸĐ°Đē Đи ŅĐ° ĐĐ°ŅŅ ĐēĐģŅŅĐŊŅи ĐąŅĐ´ĐĩŅĐĩ вĐŋĐĩвĐŊĐĩĐŊŅ, ŅĐž ĐžŅŅиĐŧŅŅŅĐĩ ĐžŅŅĐēŅваĐŊŅ Đ´Đ°ĐŊŅ Ņ ĐŋŅавиĐģŅĐŊĐžĐŧŅ ŅĐžŅĐŧĐ°ŅŅ.
+
+* ĐОдаŅи **JSON Schema** вŅĐ´ĐŋОвŅĐ´Ņ Đ´Đž ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ OpenAPI в *ĐžĐŋĐĩŅĐ°ŅŅŅŅ
ŅĐģŅŅ
Ņ*.
+ * ĐĻĐĩ ĐąŅĐ´Đĩ виĐēĐžŅиŅŅĐ°ĐŊĐž в **авŅĐžĐŧĐ°ŅиŅĐŊŅĐš Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ**.
+ * Đ ŅĐ°ĐēĐžĐļ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅĐ°Đŧи, ŅĐēŅ авŅĐžĐŧĐ°ŅиŅĐŊĐž ĐŗĐĩĐŊĐĩŅŅŅŅŅ ĐēĐģŅŅĐŊŅŅŅĐēиК ĐēОд.
+
+ĐĐģĐĩ ĐŊĐ°ĐšĐŗĐžĐģОвĐŊŅŅĐĩ:
+
+* FastAPI **ОйĐŧĐĩĐļиŅŅ ŅĐ° вŅĐ´ŅŅĐģŅŅŅŅŅ** виŅ
ŅĐ´ĐŊŅ Đ´Đ°ĐŊŅ вŅĐ´ĐŋОвŅĐ´ĐŊĐž Đ´Đž ŅиĐŋŅ, вĐēаСаĐŊĐžĐŗĐž Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+ * ĐĻĐĩ ĐžŅОйĐģивО ваĐļĐģивО Đ´ĐģŅ **ĐąĐĩСĐŋĐĩĐēи**. ĐĐĩŅĐ°ĐģŅ ĐŊиĐļŅĐĩ.
+
+## ĐĐ°ŅĐ°ĐŧĐĩŅŅ `response_model`
+
+ĐĐŊОдŅ ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž айО СŅŅŅĐŊĐž ĐŋОвĐĩŅŅĐ°Ņи ŅĐŊŅŅ ŅиĐŋи Đ´Đ°ĐŊиŅ
, ĐŊŅĐļ ŅŅ, ŅĐž СаСĐŊĐ°ŅĐĩĐŊŅ ŅĐē ŅиĐŋ вŅĐ´ĐŋОвŅĐ´Ņ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, Đи ĐŧĐžĐļĐĩŅĐĩ **ĐŋОвĐĩŅŅĐ°Ņи ŅĐģОвĐŊиĐē** айО ОйâŅĐēŅ йаСи Đ´Đ°ĐŊиŅ
, Đ°ĐģĐĩ **ĐžĐŗĐžĐģĐžŅиŅи ĐŧОдĐĩĐģŅ Pydantic** ŅĐē ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ. ĐĸОдŅ ĐŧОдĐĩĐģŅ Pydantic авŅĐžĐŧĐ°ŅиŅĐŊĐž ОйŅОйĐģŅŅиĐŧĐĩ ваĐģŅĐ´Đ°ŅŅŅ, Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ŅĐžŅĐž.
+
+Đ¯ĐēŅĐž Đи дОдаŅŅĐĩ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ Đ´ĐģŅ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ, ŅĐĩĐ´Đ°ĐēŅĐžŅ ĐēОдŅ айО mypy ĐŧĐžĐļŅŅŅ ĐŋĐžŅĐēĐ°ŅĐļиŅиŅŅ, ŅĐž ŅŅĐŊĐēŅŅŅ ĐŋОвĐĩŅŅĐ°Ņ ŅĐŊŅиК ŅиĐŋ (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, dict СаĐŧŅŅŅŅ Item).
+
+ĐŖ ŅĐ°ĐēиŅ
виĐŋĐ°Đ´ĐēĐ°Ņ
ĐŧĐžĐļĐŊĐ° ŅĐēĐžŅиŅŅĐ°ŅиŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐžĐŧ `response_model` в Đ´ĐĩĐēĐžŅĐ°ŅĐžŅŅ ĐŧĐ°ŅŅŅŅŅŅ (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, @app.get()).
+
+ĐĐ°ŅĐ°ĐŧĐĩŅŅ `response_model` ĐŋŅĐ°ŅŅŅ С ĐąŅĐ´Ņ-ŅĐēиĐŧ *ĐžĐŋĐĩŅĐ°ŅĐžŅĐžĐŧ ŅĐģŅŅ
Ņ*:
+
+* `@app.get()`
+* `@app.post()`
+* `@app.put()`
+* `@app.delete()`
+* ŅĐžŅĐž.
+
+{* ../../docs_src/response_model/tutorial001_py310.py hl[17,22,24:27] *}
+
+/// note | ĐŅиĐŧŅŅĐēĐ°
+
+ĐвĐĩŅĐŊŅŅŅ ŅваĐŗŅ, ŅĐž `response_model` Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐžĐŧ ĐŧĐĩŅОдŅ-Đ´ĐĩĐēĐžŅĐ°ŅĐžŅĐ° (`get`, `post`, ŅĐžŅĐž), Đ° ĐŊĐĩ *ŅŅĐŊĐēŅŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅŅ ŅĐģŅŅ
Ņ* (path operation function), ŅĐē ŅĐĩ ŅОйиŅŅŅŅ С ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°Đŧи айО ŅŅĐģĐžĐŧ СаĐŋиŅŅ.
+
+///
+
+`response_model` ĐŋŅиКĐŧĐ°Ņ ŅĐ°ĐēиК ŅĐ°ĐŧиК ŅиĐŋ, ŅĐēиК Đи Đą вĐēаСаĐģи Đ´ĐģŅ ĐŋĐžĐģŅ ĐŧОдĐĩĐģŅ Pydantic. ĐĸОйŅĐž ŅĐĩ ĐŧĐžĐļĐĩ ĐąŅŅи ŅĐē Pydantic-ĐŧОдĐĩĐģŅ, ŅĐ°Đē Ņ, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, `list` ŅС ĐŧОдĐĩĐģĐĩĐš Pydantic â `List[Item]`.
+
+FastAPI виĐēĐžŅиŅŅОвŅваŅиĐŧĐĩ `response_model` Đ´ĐģŅ ŅŅвОŅĐĩĐŊĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ваĐģŅĐ´Đ°ŅŅŅ Đ´Đ°ĐŊиŅ
ŅĐ° â ĐŊаКваĐļĐģивŅŅĐĩ â **ĐŋĐĩŅĐĩŅвОŅĐĩĐŊĐŊŅ ŅĐ° ŅŅĐģŅŅŅĐ°ŅŅŅ виŅ
ŅĐ´ĐŊиŅ
Đ´Đ°ĐŊиŅ
** СĐŗŅĐ´ĐŊĐž С ĐžĐŗĐžĐģĐžŅĐĩĐŊиĐŧ ŅиĐŋĐžĐŧ.
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+Đ¯ĐēŅĐž Ņ ĐĐ°Ņ ŅвŅĐŧĐēĐŊĐĩĐŊĐž ŅŅвОŅŅ ĐŋĐĩŅĐĩвŅŅĐēŅ ŅиĐŋŅв Ņ ŅĐĩĐ´Đ°ĐēŅĐžŅŅ, mypy ŅĐžŅĐž, Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ ŅŅĐŊĐēŅŅŅ ŅĐē `Any`.
+
+ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, Đи ĐŋОвŅĐ´ĐžĐŧĐģŅŅŅĐĩ ŅĐĩĐ´Đ°ĐēŅĐžŅŅ, ŅĐž ŅвŅĐ´ĐžĐŧĐž ĐŋОвĐĩŅŅĐ°ŅŅĐĩ ĐąŅĐ´Ņ-ŅĐž. ĐĐģĐĩ FastAPI ŅŅĐĩ ОдĐŊĐž виĐēĐžĐŊŅваŅиĐŧĐĩ ŅŅвОŅĐĩĐŊĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ваĐģŅĐ´Đ°ŅŅŅ, ŅŅĐģŅŅŅĐ°ŅŅŅ ŅĐžŅĐž Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `response_model`.
+
+///
+
+### ĐŅŅĐžŅиŅĐĩŅ `response_model`
+
+Đ¯ĐēŅĐž Đи вĐēаСŅŅŅĐĩ Ņ ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ, Ņ `response_model`, ŅĐž FastAPI виĐēĐžŅиŅŅОвŅваŅиĐŧĐĩ `response_model` С ĐŋŅŅĐžŅиŅĐĩŅĐžĐŧ.
+
+ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи ĐŋŅавиĐģŅĐŊŅ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅв Đ´Đž ваŅиŅ
ŅŅĐŊĐēŅŅĐš, ĐŊавŅŅŅ ŅĐēŅĐž вОĐŊи ĐŋОвĐĩŅŅĐ°ŅŅŅ ŅиĐŋ, вŅĐ´ĐŧŅĐŊĐŊиК вŅĐ´ `response_model`. ĐĻĐĩ ĐąŅĐ´Đĩ ĐēĐžŅиŅĐŊĐž Đ´ĐģŅ ŅĐĩĐ´Đ°ĐēŅĐžŅŅв ĐēОдŅ ŅĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв, ŅĐ°ĐēиŅ
ŅĐē mypy. Đ ĐŋŅи ŅŅĐžĐŧŅ FastAPI ĐŋŅОдОвĐļиŅŅ виĐēĐžĐŊŅваŅи ваĐģŅĐ´Đ°ŅŅŅ Đ´Đ°ĐŊиŅ
, ĐŗĐĩĐŊĐĩŅŅваŅи Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ŅĐžŅĐž ĐŊĐ° ĐžŅĐŊОвŅ `response_model`.
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи `response_model=None`, ŅОй виĐŧĐēĐŊŅŅи ŅŅвОŅĐĩĐŊĐŊŅ ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ Đ´ĐģŅ ŅŅŅŅ *ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*. ĐĻĐĩ ĐŧĐžĐļĐĩ СĐŊадОйиŅиŅŅ, ŅĐēŅĐž Đи дОдаŅŅĐĩ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅв Đ´Đž Ой'ŅĐēŅŅв, ŅĐēŅ ĐŊĐĩ Ņ Đ´ĐžĐŋŅŅŅиĐŧиĐŧи ĐŋĐžĐģŅĐŧи Pydantic â ĐŋŅиĐēĐģĐ°Đ´ ŅŅĐžĐŗĐž Đи ĐŋОйаŅиŅĐĩ в ОдĐŊĐžĐŧŅ С ĐŊĐ°ŅŅŅĐŋĐŊиŅ
ŅОСдŅĐģŅв.
+
+## ĐОвĐĩŅĐŊŅŅи ŅŅ ŅĐ°ĐŧŅ вŅ
ŅĐ´ĐŊŅ Đ´Đ°ĐŊŅ
+
+ĐĸŅŅ Đŧи ĐžĐŗĐžĐģĐžŅŅŅĐŧĐž ĐŧОдĐĩĐģŅ `UserIn`, ŅĐēĐ° ĐŧŅŅŅиŅŅ СвиŅĐ°ĐšĐŊиК ŅĐĩĐēŅŅОвиК ĐŋĐ°ŅĐžĐģŅ:
+
+{* ../../docs_src/response_model/tutorial002_py310.py hl[7,9] *}
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ЊОй виĐēĐžŅиŅŅОвŅваŅи `EmailStr`, ŅĐŋĐžŅĐ°ŅĐēŅ вŅŅĐ°ĐŊОвŅŅŅ `email-validator` .
+
+ĐĐĩŅĐĩĐēĐžĐŊĐ°ĐšŅĐĩŅŅ, ŅĐž Đи ŅŅвОŅиĐģи [вŅŅŅŅĐ°ĐģŅĐŊĐĩ ŅĐĩŅĐĩдОвиŅĐĩ](../virtual-environments.md){.internal-link target=_blank}, Đ°ĐēŅивŅваĐģи КОĐŗĐž, Đ° ĐŋĐžŅŅĐŧ вŅŅĐ°ĐŊОвиĐģи ĐŋĐ°ĐēĐĩŅ, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´:
+
+```console
+$ pip install email-validator
+```
+
+or with:
+
+```console
+$ pip install "pydantic[email]"
+```
+
+///
+
+Đ Đŧи виĐēĐžŅиŅŅОвŅŅĐŧĐž ŅŅ ĐŧОдĐĩĐģŅ, ŅОй ĐžĐŗĐžĐģĐžŅиŅи Ņ вŅ
ŅĐ´ĐŊŅ, Ņ виŅ
ŅĐ´ĐŊŅ Đ´Đ°ĐŊŅ:
+
+{* ../../docs_src/response_model/tutorial002_py310.py hl[16] *}
+
+ĐĸĐĩĐŋĐĩŅ, ĐēĐžĐģи ĐąŅĐ°ŅСĐĩŅ ŅŅвОŅŅŅ ĐēĐžŅиŅŅŅваŅĐ° С ĐŋĐ°ŅĐžĐģĐĩĐŧ, API ĐŋОвĐĩŅĐŊĐĩ ŅОК ŅĐ°ĐŧиК ĐŋĐ°ŅĐžĐģŅ Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+
+ĐŖ ŅŅĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ ŅĐĩ ĐŧĐžĐļĐĩ ĐŊĐĩ ĐąŅŅи ĐŋŅОйĐģĐĩĐŧĐžŅ, Đ°Đ´ĐļĐĩ ŅĐ°ĐŧĐĩ ĐēĐžŅиŅŅŅваŅ ĐŊĐ°Đ´ŅŅĐģав ĐŋĐ°ŅĐžĐģŅ.
+
+ĐĐģĐĩ ŅĐēŅĐž Đŧи виĐēĐžŅиŅŅĐ°ŅĐŧĐž ŅŅ Đļ ĐŧОдĐĩĐģŅ Đ´ĐģŅ ŅĐŊŅĐžŅ ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ, Đŧи ĐŧĐžĐļĐĩĐŧĐž виĐŋĐ°Đ´ĐēОвО ĐŊĐ°Đ´ŅŅĐģĐ°Ņи ĐŋĐ°ŅĐžĐģŅ ĐŊĐ°ŅиŅ
ĐēĐžŅиŅŅŅваŅŅв ĐēĐžĐļĐŊĐžĐŧŅ ĐēĐģŅŅĐŊŅŅ.
+
+/// danger | ĐĐąĐĩŅĐĩĐļĐŊĐž
+
+ĐŅĐēĐžĐģи ĐŊĐĩ СйĐĩŅŅĐŗĐ°ĐšŅĐĩ ĐŋĐ°ŅĐžĐģŅ ĐēĐžŅиŅŅŅваŅĐ° Ņ вŅĐ´ĐēŅиŅĐžĐŧŅ виĐŗĐģŅĐ´Ņ ŅĐ° ĐŊĐĩ ĐŊĐ°Đ´ŅиĐģĐ°ĐšŅĐĩ КОĐŗĐž Ņ вŅĐ´ĐŋОвŅĐ´Ņ, ŅĐēŅĐž ŅŅĐģŅĐēи Đи ĐŊĐĩ СĐŊĐ°ŅŅĐĩ вŅŅ ŅиСиĐēи Ņ ŅĐžŅĐŊĐž ŅОСŅĐŧŅŅŅĐĩ, ŅĐž ŅОйиŅĐĩ.
+
+///
+
+## ĐОдаКŅĐĩ ĐžĐēŅĐĩĐŧŅ виŅ
ŅĐ´ĐŊŅ ĐŧОдĐĩĐģŅ
+
+ĐĐ°ĐŧŅŅŅŅ ŅŅĐžĐŗĐž Đŧи ĐŧĐžĐļĐĩĐŧĐž ŅŅвОŅиŅи вŅ
ŅĐ´ĐŊŅ ĐŧОдĐĩĐģŅ С вŅĐ´ĐēŅиŅиĐŧ ĐŋĐ°ŅĐžĐģĐĩĐŧ Ņ виŅ
ŅĐ´ĐŊŅ ĐŧОдĐĩĐģŅ ĐąĐĩС ĐŊŅĐžĐŗĐž:
+
+{* ../../docs_src/response_model/tutorial003_py310.py hl[9,11,16] *}
+
+ĐĸŅŅ, ĐŊавŅŅŅ ŅĐēŅĐž *ŅŅĐŊĐēŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ* ĐŋОвĐĩŅŅĐ°Ņ Ой'ŅĐēŅ ĐēĐžŅиŅŅŅваŅĐ°, ŅĐēиК ĐŧŅŅŅиŅŅ ĐŋĐ°ŅĐžĐģŅ:
+
+{* ../../docs_src/response_model/tutorial003_py310.py hl[24] *}
+
+...Đŧи ĐžĐŗĐžĐģĐžŅиĐģи `response_model` ŅĐē ĐŊĐ°ŅŅ ĐŧОдĐĩĐģŅ `UserOut`, ŅĐēĐ° ĐŊĐĩ ĐŧŅŅŅиŅŅ ĐŋĐ°ŅĐžĐģŅ:
+
+{* ../../docs_src/response_model/tutorial003_py310.py hl[22] *}
+
+ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, **FastAPI** авŅĐžĐŧĐ°ŅиŅĐŊĐž вŅĐ´ŅŅĐģŅŅŅŅŅ вŅŅ Đ´Đ°ĐŊŅ, ŅĐēŅ ĐŊĐĩ вĐēаСаĐŊŅ Ņ виŅ
ŅĐ´ĐŊŅĐš ĐŧОдĐĩĐģŅ (Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ Pydantic).
+
+### `response_model` айО ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ
+
+ĐŖ ŅŅĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ, ĐžŅĐēŅĐģŅĐēи двŅ ĐŧОдĐĩĐģŅ ŅŅСĐŊŅ, ŅĐēŅĐž Đŧи Đ°ĐŊĐžŅŅŅĐŧĐž ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ ŅŅĐŊĐēŅŅŅ ŅĐē `UserOut`, ŅĐĩĐ´Đ°ĐēŅĐžŅ Ņ ŅĐ°ĐēŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи, ŅĐē mypy, видадŅŅŅ ĐŋĐžĐŧиĐģĐēŅ, йО ŅĐ°ĐēŅиŅĐŊĐž Đŧи ĐŋОвĐĩŅŅĐ°ŅĐŧĐž ŅĐŊŅиК ŅиĐŋ.
+
+ĐĸĐžĐŧŅ в ŅŅĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ Đŧи виĐēĐžŅиŅŅОвŅŅĐŧĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `response_model`, Đ° ĐŊĐĩ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ.
+
+...Đ°ĐģĐĩ ŅиŅĐ°ĐšŅĐĩ Đ´Đ°ĐģŅ, ŅОй Đ´ŅСĐŊĐ°ŅиŅŅ, ŅĐē ОйŅĐšŅи ŅĐĩ ОйĐŧĐĩĐļĐĩĐŊĐŊŅ.
+
+## ĐĸиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ Ņ ŅŅĐģŅŅŅĐ°ŅŅŅ Đ´Đ°ĐŊиŅ
+
+ĐŅОдОвĐļиĐŧĐž С ĐŋĐžĐŋĐĩŅĐĩĐ´ĐŊŅĐžĐŗĐž ĐŋŅиĐēĐģĐ°Đ´Ņ. Đи Ņ
ĐžŅŅĐģи **Đ°ĐŊĐžŅŅваŅи ŅŅĐŊĐēŅŅŅ ОдĐŊиĐŧ ŅиĐŋĐžĐŧ**, Đ°ĐģĐĩ ĐŋŅи ŅŅĐžĐŧŅ ĐŋОвĐĩŅŅĐ°Ņи С ĐŊĐĩŅ ĐąŅĐģŅŅĐĩ Đ´Đ°ĐŊиŅ
.
+
+Đи Ņ
ĐžŅĐĩĐŧĐž, ŅОй FastAPI ĐŋŅОдОвĐļŅвав **ŅŅĐģŅŅŅŅваŅи** ŅŅ Đ´Đ°ĐŊŅ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ response_model. ĐĸОйŅĐž ĐŊавŅŅŅ ŅĐēŅĐž ŅŅĐŊĐēŅŅŅ ĐŋОвĐĩŅŅĐ°Ņ ĐąŅĐģŅŅĐĩ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ, Ņ вŅĐ´ĐŋОвŅĐ´Ņ ĐąŅĐ´ŅŅŅ ĐģиŅĐĩ ŅŅ ĐŋĐžĐģŅ, ŅĐēŅ вĐēаСаĐŊŅ Ņ response_model.
+
+ĐŖ ĐŋĐžĐŋĐĩŅĐĩĐ´ĐŊŅĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ, ĐžŅĐēŅĐģŅĐēи ĐēĐģĐ°Ņи ĐąŅĐģи ŅŅСĐŊŅ, ĐŊĐ°Đŧ дОвĐĩĐģĐžŅŅ виĐēĐžŅиŅŅОвŅваŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `response_model`. ĐĐģĐĩ ŅĐĩ ОСĐŊĐ°ŅĐ°Ņ, ŅĐž Đŧи ĐŊĐĩ ĐžŅŅиĐŧŅŅĐŧĐž ĐŋŅĐ´ŅŅиĐŧĐēи С йОĐēŅ ŅĐĩĐ´Đ°ĐēŅĐžŅĐ° ĐēОдŅ ŅĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв ĐŋĐĩŅĐĩвŅŅĐēи ŅиĐŋŅв ŅОдО ŅиĐŋŅ, ŅĐēиК ĐŋОвĐĩŅŅĐ°Ņ ŅŅĐŊĐēŅŅŅ.
+
+ĐŅĐžŅĐĩ в ĐąŅĐģŅŅĐžŅŅŅ виĐŋĐ°Đ´ĐēŅв, ĐēĐžĐģи ĐŊĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž СŅОйиŅи ŅĐžŅŅ ĐŋОдŅĐąĐŊĐĩ, Đŧи ĐŋŅĐžŅŅĐž Ņ
ĐžŅĐĩĐŧĐž, ŅОй ĐŧОдĐĩĐģŅ **вŅĐ´ŅŅĐģŅŅŅŅваĐģĐ° айО ĐŋŅийŅĐ°ĐģĐ°** ŅĐ°ŅŅиĐŊŅ Đ´Đ°ĐŊиŅ
, ŅĐē Ņ ŅŅĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ.
+
+ĐŖ ŅĐ°ĐēиŅ
виĐŋĐ°Đ´ĐēĐ°Ņ
Đŧи ĐŧĐžĐļĐĩĐŧĐž виĐēĐžŅиŅŅĐ°Ņи ĐēĐģĐ°Ņи ŅĐ° ŅĐŋĐ°Đ´ĐēŅваĐŊĐŊŅ, ŅОй ŅĐēĐžŅиŅŅĐ°ŅиŅŅ **Đ°ĐŊĐžŅĐ°ŅŅŅĐŧи ŅиĐŋŅв** ŅŅĐŊĐēŅŅĐš â ŅĐĩ Đ´Đ°Ņ ĐēŅĐ°ŅŅ ĐŋŅĐ´ŅŅиĐŧĐēŅ С йОĐēŅ ŅĐĩĐ´Đ°ĐēŅĐžŅĐ° ŅĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв ŅиĐŋŅ mypy, Ņ ĐŋŅи ŅŅĐžĐŧŅ FastAPI ĐŋŅОдОвĐļŅŅ виĐēĐžĐŊŅваŅи **ŅŅĐģŅŅŅĐ°ŅŅŅ Đ´Đ°ĐŊиŅ
** Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+
+{* ../../docs_src/response_model/tutorial003_01_py310.py hl[7:10,13:14,18] *}
+
+ĐавдŅĐēи ŅŅĐžĐŧŅ Đŧи ĐžŅŅиĐŧŅŅĐŧĐž ĐŋŅĐ´ŅŅиĐŧĐēŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв â вŅĐ´ ŅĐĩĐ´Đ°ĐēŅĐžŅŅв Ņ mypy, ĐžŅĐēŅĐģŅĐēи ŅĐĩĐš ĐēОд Ņ ĐēĐžŅĐĩĐēŅĐŊиĐŧ С ŅĐžŅĐēи СОŅŅ ŅиĐŋŅв, â Đ°ĐģĐĩ Đŧи ŅĐ°ĐēĐžĐļ ĐžŅŅиĐŧŅŅĐŧĐž ŅŅĐģŅŅŅĐ°ŅŅŅ Đ´Đ°ĐŊиŅ
вŅĐ´ FastAPI.
+
+Đ¯Đē ŅĐĩ ĐŋŅĐ°ŅŅŅ? ĐаваКŅĐĩ ŅОСйĐĩŅĐĩĐŧĐžŅŅ. đ¤
+
+### ĐĸиĐŋи ŅĐ° ĐŋŅĐ´ŅŅиĐŧĐēĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв
+
+ĐĄĐŋĐĩŅŅŅ ĐŋОдивиĐŧĐžŅŅ, ŅĐē ŅĐĩ йаŅĐ°ŅŅ ŅĐĩĐ´Đ°ĐēŅĐžŅи, mypy ŅĐ° ŅĐŊŅŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи.
+
+`BaseUser` ĐŧĐ°Ņ йаСОвŅ ĐŋĐžĐģŅ. ĐĐžŅŅĐŧ `UserIn` ŅŅĐŋĐ°Đ´ĐēОвŅŅ `BaseUser` Ņ дОдаŅ ĐŋĐžĐģĐĩ `password`, ĐžŅĐļĐĩ, вŅĐŊ ĐŧĐ°ŅиĐŧĐĩ вŅŅ ĐŋĐžĐģŅ С ОйОŅ
ĐŧОдĐĩĐģĐĩĐš.
+
+Đи СаСĐŊĐ°ŅĐ°ŅĐŧĐž ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ ŅŅĐŊĐēŅŅŅ ŅĐē `BaseUser`, Đ°ĐģĐĩ ŅĐ°ĐēŅиŅĐŊĐž ĐŋОвĐĩŅŅĐ°ŅĐŧĐž ĐĩĐēСĐĩĐŧĐŋĐģŅŅ `UserIn`.
+
+Đ ĐĩĐ´Đ°ĐēŅĐžŅ, mypy ŅĐ° ŅĐŊŅŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи ĐŊĐĩ ŅĐēĐ°ŅĐļиŅиĐŧŅŅŅŅŅ ĐŊĐ° ŅĐĩ, ŅĐžĐŧŅ ŅĐž С ŅĐžŅĐēи СОŅŅ ŅиĐŋŅСаŅŅŅ `UserIn` Ņ ĐŋŅĐ´ĐēĐģĐ°ŅĐžĐŧ `BaseUser`, Đ° ŅĐĩ ОСĐŊĐ°ŅĐ°Ņ, ŅĐž вŅĐŊ Ņ `ваĐģŅĐ´ĐŊиĐŧ` ŅиĐŋĐžĐŧ, ĐēĐžĐģи ĐžŅŅĐēŅŅŅŅŅŅ ĐąŅĐ´Ņ-ŅĐž, ŅĐž Ņ `BaseUser`.
+
+### ФŅĐģŅŅŅĐ°ŅŅŅ Đ´Đ°ĐŊиŅ
Ņ FastAPI
+
+ĐĸĐĩĐŋĐĩŅ Đ´ĐģŅ FastAPI вŅĐŊ йаŅиŅŅ ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ Ņ ĐŋĐĩŅĐĩĐēĐžĐŊŅŅŅŅŅŅ, ŅĐž ŅĐĩ, ŅĐž Đи ĐŋОвĐĩŅŅĐ°ŅŅĐĩ, ĐŧŅŅŅиŅŅ **ŅŅĐģŅĐēи** ĐŋĐžĐģŅ, ŅĐēŅ ĐžĐŗĐžĐģĐžŅĐĩĐŊŅ Ņ ŅŅĐžĐŧŅ ŅиĐŋŅ.
+
+FastAPI виĐēĐžĐŊŅŅ ĐēŅĐģŅĐēĐ° вĐŊŅŅŅŅŅĐŊŅŅ
ĐžĐŋĐĩŅĐ°ŅŅĐš С Pydantic, ŅОй ĐŗĐ°ŅĐ°ĐŊŅŅваŅи, ŅĐž ĐŋŅавиĐģĐ° ĐŊĐ°ŅĐģŅĐ´ŅваĐŊĐŊŅ ĐēĐģĐ°ŅŅв ĐŊĐĩ СаŅŅĐžŅОвŅŅŅŅŅŅ Đ´ĐģŅ ŅŅĐģŅŅŅĐ°ŅŅŅ ĐŋОвĐĩŅĐŊĐĩĐŊиŅ
Đ´Đ°ĐŊиŅ
, ŅĐŊĐ°ĐēŅĐĩ Đи ĐŧĐžĐŗĐģи Đą ĐŋОвĐĩŅĐŊŅŅи СĐŊĐ°ŅĐŊĐž ĐąŅĐģŅŅĐĩ Đ´Đ°ĐŊиŅ
, ĐŊŅĐļ ĐžŅŅĐēŅваĐģи.
+
+ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, Đи ĐžŅŅиĐŧŅŅŅĐĩ ĐŊĐ°ĐšĐēŅĐ°ŅĐĩ С двОŅ
ŅвŅŅŅв: Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅв **С ĐŋŅĐ´ŅŅиĐŧĐēĐžŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв** Ņ **ŅŅĐģŅŅŅĐ°ŅŅŅ Đ´Đ°ĐŊиŅ
**.
+
+## ĐОдивиŅиŅŅ Ņ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ
+
+ĐĐžĐģи Đи дивиŅĐĩŅŅ авŅĐžĐŧĐ°ŅиŅĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋОйаŅиŅи, ŅĐž вŅ
ŅĐ´ĐŊĐ° ĐŧОдĐĩĐģŅ Ņ виŅ
ŅĐ´ĐŊĐ° ĐŧОдĐĩĐģŅ ĐŧĐ°ŅŅŅ вĐģĐ°ŅĐŊŅ JSON-ŅŅ
ĐĩĐŧŅ:
+
+union ĐŧŅĐļ ŅŅСĐŊиĐŧи ŅиĐŋĐ°Đŧи, Đ´Đĩ ОдиĐŊ айО ĐąŅĐģŅŅĐĩ ĐŊĐĩ Ņ ваĐģŅĐ´ĐŊиĐŧи ŅиĐŋĐ°Đŧи Pydantic, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐĩ ŅĐŋŅиŅиĐŊиŅŅ ĐŋĐžĐŧиĐģĐēŅ đĨ:
+
+{* ../../docs_src/response_model/tutorial003_04_py310.py hl[8] *}
+
+...ŅĐĩ ĐŊĐĩ ĐŋŅĐ°ŅŅŅ, ŅĐžĐŧŅ ŅĐž ŅиĐŋ Đ°ĐŊĐžŅĐ°ŅŅŅ ĐŊĐĩ Ņ ŅиĐŋĐžĐŧ Pydantic Ņ ĐŊĐĩ Ņ ĐŋŅĐžŅŅĐž ĐēĐģĐ°ŅĐžĐŧ `Response` айО КОĐŗĐž ĐŋŅĐ´ĐēĐģĐ°ŅĐžĐŧ, Đ° Ņ ОйâŅĐ´ĐŊĐ°ĐŊĐŊŅĐŧ (union) â айО `Response`, айО `dict`.
+
+### ĐŅĐ´ĐēĐģŅŅĐĩĐŊĐŊŅ ĐОдĐĩĐģŅ ĐŅĐ´ĐŋОвŅĐ´Ņ
+
+ĐŅОдОвĐļŅŅŅи ĐŋŅиĐēĐģĐ°Đ´ виŅĐĩ, ĐŧĐžĐļĐģивО, Đи ĐŊĐĩ Ņ
ĐžŅĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ŅŅĐ°ĐŊĐ´Đ°ŅŅĐŊŅ ваĐģŅĐ´Đ°ŅŅŅ Đ´Đ°ĐŊиŅ
, авŅĐžĐŧĐ°ŅиŅĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ŅŅĐģŅŅŅĐ°ŅŅŅ ŅĐžŅĐž, ŅĐēŅ FastAPI виĐēĐžĐŊŅŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ.
+
+ĐĐģĐĩ ви вŅĐĩ ОдĐŊĐž ĐŧĐžĐļĐĩŅĐĩ СаĐģиŅиŅи Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ Ņ ŅŅĐŊĐēŅŅŅ, ŅОй СйĐĩŅĐĩĐŗŅи ĐŋŅĐ´ŅŅиĐŧĐēŅ С йОĐēŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв, ŅĐ°ĐēиŅ
ŅĐē ŅĐĩĐ´Đ°ĐēŅĐžŅи ĐēОдŅ айО ŅŅĐ°ŅиŅĐŊŅ ĐŋĐĩŅĐĩвŅŅĐēи ŅиĐŋŅв (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, mypy).
+
+ĐŖ ŅĐ°ĐēĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ ви ĐŧĐžĐļĐĩŅĐĩ виĐŧĐēĐŊŅŅи ĐŗĐĩĐŊĐĩŅĐ°ŅŅŅ ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ, вŅŅĐ°ĐŊОвивŅи `response_model=None`:
+
+{* ../../docs_src/response_model/tutorial003_05_py310.py hl[7] *}
+
+ĐĻĐĩ СĐŧŅŅиŅŅ FastAPI ĐŋŅĐžĐŋŅŅŅиŅи ĐŗĐĩĐŊĐĩŅĐ°ŅŅŅ ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ, Ņ ŅĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ Đи СĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ĐąŅĐ´Ņ-ŅĐēŅ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅв ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ ĐąĐĩС вĐŋĐģивŅ ĐŊĐ° ваŅŅ FastAPI Đ°ĐŋĐģŅĐēĐ°ŅŅŅ. đ¤
+
+## ĐĐ°ŅĐ°ĐŧĐĩŅŅи ĐēОдŅваĐŊĐŊŅ ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ
+
+ĐĐ°ŅĐ° ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ ĐŧĐžĐļĐĩ ĐŧĐ°Ņи СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´:
+
+{* ../../docs_src/response_model/tutorial004_py310.py hl[9,11:12] *}
+
+* `description: Union[str, None] = None` (айО `str | None = None` Ņ Python 3.10) ĐŧĐ°Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ `None`.
+* `tax: float = 10.5` ĐŧĐ°Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ `10.5`.
+* `tags: List[str] = []` ĐŧĐ°Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ ĐŋĐžŅĐžĐļĐŊŅĐš ŅĐŋиŅĐžĐē: `[]`.
+
+ĐĐģĐĩ Đи ĐŧĐžĐļĐĩŅĐĩ СаŅ
ĐžŅŅŅи ĐŊĐĩ вĐēĐģŅŅĐ°Ņи ŅŅ
Ņ ŅĐĩСŅĐģŅŅĐ°Ņ, ŅĐēŅĐž вОĐŊи ŅĐ°ĐēŅиŅĐŊĐž ĐŊĐĩ ĐąŅĐģи СйĐĩŅĐĩĐļĐĩĐŊŅ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐēŅĐž Ņ ĐĐ°Ņ Ņ ĐŧОдĐĩĐģŅ С йаĐŗĐ°ŅŅĐŧĐ° ĐŊĐĩОйОвâŅСĐēОвиĐŧи Đ°ŅŅийŅŅĐ°Đŧи Ņ NoSQL йаСŅ Đ´Đ°ĐŊиŅ
, Đ°ĐģĐĩ Đи ĐŊĐĩ Ņ
ĐžŅĐĩŅĐĩ вŅĐ´ĐŋŅавĐģŅŅи Đ´ŅĐļĐĩ дОвĐŗŅ JSON-вŅĐ´ĐŋОвŅĐ´Ņ, ĐŋОвĐŊŅ СĐŊĐ°ŅĐĩĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ.
+
+### ĐиĐēĐžŅиŅŅОвŅĐšŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `response_model_exclude_unset`
+
+Đи ĐŧĐžĐļĐĩŅĐĩ вŅŅĐ°ĐŊОвиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ Đ´ĐĩĐēĐžŅĐ°ŅĐžŅĐ° ŅĐģŅŅ
Ņ `response_model_exclude_unset=True`:
+
+{* ../../docs_src/response_model/tutorial004_py310.py hl[22] *}
+
+Ņ ŅŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ ĐŊĐĩ ĐąŅĐ´ŅŅŅ вĐēĐģŅŅĐĩĐŊŅ Ņ вŅĐ´ĐŋОвŅĐ´Ņ, ŅŅĐģŅĐēи ŅĐ°ĐēŅиŅĐŊĐž вŅŅĐ°ĐŊОвĐģĐĩĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ.
+
+ĐŅĐļĐĩ, ŅĐēŅĐž Đи ĐŊĐ°Đ´ŅŅĐģĐĩŅĐĩ СаĐŋиŅ Đ´Đž ŅŅĐžĐŗĐž ĐžĐŋĐĩŅĐ°ŅĐžŅĐ° ŅĐģŅŅ
Ņ Đ´ĐģŅ ĐĩĐģĐĩĐŧĐĩĐŊŅĐ° С item_id `foo`, вŅĐ´ĐŋОвŅĐ´Ņ (ĐąĐĩС вĐēĐģŅŅĐĩĐŊĐŊŅ СĐŊĐ°ŅĐĩĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ) ĐąŅĐ´Đĩ:
+
+```JSON
+{
+ "name": "Foo",
+ "price": 50.2
+}
+```
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐŖ Pydantic вĐĩŅŅŅŅ 1 ĐŧĐĩŅОд ĐŊаСивавŅŅ `.dict()`, вŅĐŊ ĐąŅв СаŅŅĐ°ŅŅĐģиК (Đ°ĐģĐĩ ŅĐĩ ĐŋŅĐ´ŅŅиĐŧŅŅŅŅŅŅ) Ņ Pydantic вĐĩŅŅŅŅ 2 Ņ ĐŋĐĩŅĐĩĐšĐŧĐĩĐŊОваĐŊиК Ņ `.model_dump()`.
+
+ĐŅиĐēĐģади ŅŅŅ виĐēĐžŅиŅŅОвŅŅŅŅ `.dict()` Đ´ĐģŅ ŅŅĐŧŅŅĐŊĐžŅŅŅ С Pydantic v1, Đ°ĐģĐĩ ĐĐ°Đŧ ŅĐģŅĐ´ виĐēĐžŅиŅŅОвŅваŅи `.model_dump()`, ŅĐēŅĐž Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи Pydantic v2.
+
+///
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+FastAPI виĐēĐžŅиŅŅОвŅŅ `.dict()` ĐŧОдĐĩĐģŅ Pydantic С ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐžĐŧ `exclude_unset` , ŅОй Đ´ĐžŅŅĐŗŅи ŅŅĐžĐŗĐž.
+
+///
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи:
+
+* `response_model_exclude_defaults=True`
+* `response_model_exclude_none=True`
+
+ŅĐē ĐžĐŋиŅĐ°ĐŊĐž в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Pydantic for `exclude_defaults` ŅĐ° `exclude_none`.
+
+///
+
+#### ĐĐ°ĐŊŅ СŅ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи Đ´ĐģŅ ĐŋĐžĐģŅв ŅС ŅиĐŋОвиĐŧи СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи
+
+ĐĐģĐĩ ŅĐēŅĐž ĐĐ°ŅŅ Đ´Đ°ĐŊŅ ĐŧĐ°ŅŅŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ Đ´ĐģŅ ĐŋĐžĐģŅв ĐŧОдĐĩĐģŅ С ŅиĐŋОвиĐŧи СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи, ŅĐē Ņ ĐĩĐģĐĩĐŧĐĩĐŊŅĐ° С item_id `bar`:
+
+```Python hl_lines="3 5"
+{
+ "name": "Bar",
+ "description": "The bartenders",
+ "price": 62,
+ "tax": 20.2
+}
+```
+вОĐŊи ĐąŅĐ´ŅŅŅ вĐēĐģŅŅĐĩĐŊŅ Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+
+#### ĐĐ°ĐŊŅ С ŅиĐŧи ŅĐ°ĐŧиĐŧи СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи, ŅĐž Đš ŅиĐŋОвŅ
+
+Đ¯ĐēŅĐž Đ´Đ°ĐŊŅ ĐŧĐ°ŅŅŅ ŅŅ ŅĐ°ĐŧŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ, ŅĐž Đš ŅиĐŋОвŅ, ŅĐē Ņ ĐĩĐģĐĩĐŧĐĩĐŊŅĐ° С item_id `baz`:
+
+```Python hl_lines="3 5-6"
+{
+ "name": "Baz",
+ "description": None,
+ "price": 50.2,
+ "tax": 10.5,
+ "tags": []
+}
+```
+
+FastAPI Đ´ĐžŅŅĐ°ŅĐŊŅĐž ŅОСŅĐŧĐŊиК (ĐŊĐ°ŅĐŋŅавдŅ, Pydantic Đ´ĐžŅŅĐ°ŅĐŊŅĐž ŅОСŅĐŧĐŊиК), ŅОй СŅОСŅĐŧŅŅи, ŅĐž, Ņ
ĐžŅĐ° `description`, `tax` Ņ `tags` ĐŧĐ°ŅŅŅ ŅŅ ŅĐ°ĐŧŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ, ŅĐž Đš ŅиĐŋОвŅ, вОĐŊи ĐąŅĐģи вŅŅĐ°ĐŊОвĐģĐĩĐŊŅ ŅвĐŊĐž (Đ° ĐŊĐĩ вСŅŅŅ ŅĐē СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ).
+
+ĐŅĐļĐĩ, вОĐŊи ĐąŅĐ´ŅŅŅ вĐēĐģŅŅĐĩĐŊŅ Ņ JSON-вŅĐ´ĐŋОвŅĐ´Ņ.
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐвĐĩŅĐŊŅŅŅ ŅваĐŗŅ, ŅĐž ŅиĐŋОвŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐŧĐžĐļŅŅŅ ĐąŅŅи ĐąŅĐ´Ņ-ŅĐēиĐŧи, ĐŊĐĩ ĐģиŅĐĩ `None`.
+
+ĐĻĐĩ ĐŧĐžĐļĐĩ ĐąŅŅи list (`[]`), `float` 10.5 ŅĐžŅĐž.
+
+///
+
+### `response_model_include` ŅĐ° `response_model_exclude`
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи *Đ´ĐĩĐēĐžŅĐ°ŅĐžŅĐ° ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ* `response_model_include` ŅĐ° `response_model_exclude`.
+
+ĐĐžĐŊи ĐŋŅиКĐŧĐ°ŅŅŅ `set` (ĐŧĐŊĐžĐļиĐŊŅ) ŅŅĐ´ĐēŅв (`str`) С ŅĐŧĐĩĐŊĐ°Đŧи Đ°ŅŅийŅŅŅв, ŅĐēŅ ĐŋĐžŅŅŅĐąĐŊĐž вĐēĐģŅŅиŅи (ĐŋŅĐžĐŋŅŅĐēĐ°ŅŅи ŅĐŊŅŅ) айО виĐēĐģŅŅиŅи (вĐēĐģŅŅĐ°ŅŅи ŅĐŊŅŅ).
+
+ĐĻĐĩ ĐŧĐžĐļĐŊĐ° виĐēĐžŅиŅŅОвŅваŅи ŅĐē ŅвидĐēиК ŅĐŋĐžŅŅĐą, ŅĐēŅĐž Ņ ĐĐ°Ņ Ņ ĐģиŅĐĩ ОдĐŊĐ° ĐŧОдĐĩĐģŅ Pydantic Ņ Đи Ņ
ĐžŅĐĩŅĐĩ видаĐģиŅи Đ´ĐĩŅĐēŅ Đ´Đ°ĐŊŅ С вивОдŅ.
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐĐģĐĩ вŅĐĩ Đļ ŅĐĩĐēĐžĐŧĐĩĐŊĐ´ŅŅŅŅŅŅ виĐēĐžŅиŅŅОвŅваŅи ĐžĐŋиŅĐ°ĐŊŅ виŅĐĩ ĐŋŅĐ´Ņ
Оди, ŅС СаŅŅĐžŅŅваĐŊĐŊŅĐŧ ĐēŅĐģŅĐēĐžŅ
ĐēĐģĐ°ŅŅв, СаĐŧŅŅŅŅ ŅиŅ
ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв.
+
+
+ĐĻĐĩ ŅĐžĐŧŅ, ŅĐž JSON Schema, ŅĐēиК ĐŗĐĩĐŊĐĩŅŅŅŅŅŅŅ Ņ ваŅĐžĐŧŅ OpenAPI дОдаŅĐēŅ (Ņ в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ), вŅĐĩ ОдĐŊĐž ĐąŅĐ´Đĩ вŅĐ´ĐŋОвŅĐ´Đ°Ņи ĐŋОвĐŊŅĐš ĐŧОдĐĩĐģŅ, ĐŊавŅŅŅ ŅĐēŅĐž Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ `response_model_include` айО `response_model_exclude` Đ´ĐģŅ виĐēĐģŅŅĐĩĐŊĐŊŅ Đ´ĐĩŅĐēиŅ
Đ°ŅŅийŅŅŅв.
+
+ĐĻĐĩ ŅĐ°ĐēĐžĐļ ŅŅĐžŅŅŅŅŅŅŅ `response_model_by_alias`, ŅĐēиК ĐŋŅĐ°ŅŅŅ ĐŋОдŅĐąĐŊиĐŧ ŅиĐŊĐžĐŧ.
+
+///
+
+{* ../../docs_src/response_model/tutorial005_py310.py hl[29,35] *}
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ХиĐŊŅĐ°ĐēŅиŅ `{"name", "description"}` ŅŅвОŅŅŅ `set` С ŅиĐŧи двОĐŧĐ° СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи.
+
+ĐŅĐŊ ĐĩĐēвŅваĐģĐĩĐŊŅĐŊиК `set(["name", "description"])`.
+
+///
+
+#### ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ `list` СаĐŧŅŅŅŅ `set`
+
+Đ¯ĐēŅĐž Đи СайŅĐ´ĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи `set` Ņ ĐŊĐ°ŅĐžĐŧŅŅŅŅ СаŅŅĐžŅŅŅŅĐĩ `list` айО `tuple`, FastAPI вŅĐĩ ОдĐŊĐž ĐŋĐĩŅĐĩŅвОŅиŅŅ ŅĐĩ ĐŊĐ° `set`, Ņ вŅĐĩ ĐŋŅĐ°ŅŅваŅиĐŧĐĩ ĐŋŅавиĐģŅĐŊĐž:
+
+{* ../../docs_src/response_model/tutorial006_py310.py hl[29,35] *}
+
+## ĐŅĐ´ŅŅĐŧĐžĐē
+
+ĐиĐēĐžŅиŅŅОвŅĐšŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `response_model` *Đ´ĐĩĐēĐžŅĐ°ŅĐžŅĐ° ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*, ŅОй виСĐŊĐ°ŅĐ°Ņи ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ, ĐžŅОйĐģивО ŅОй ĐŗĐ°ŅĐ°ĐŊŅŅваŅи ŅŅĐģŅŅŅĐ°ŅŅŅ ĐŋŅиваŅĐŊиŅ
Đ´Đ°ĐŊиŅ
.
+
+ĐиĐēĐžŅиŅŅОвŅĐšŅĐĩ `response_model_exclude_unset`, ŅОй ĐŋОвĐĩŅŅĐ°Ņи ĐģиŅĐĩ ŅвĐŊĐž вŅŅĐ°ĐŊОвĐģĐĩĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ.
diff --git a/docs/uk/docs/tutorial/response-status-code.md b/docs/uk/docs/tutorial/response-status-code.md
new file mode 100644
index 000000000..1ed69d6f2
--- /dev/null
+++ b/docs/uk/docs/tutorial/response-status-code.md
@@ -0,0 +1,100 @@
+# ĐĄŅĐ°ŅŅŅ ĐēОди ĐŅĐ´ĐŋОвŅĐ´ĐĩĐš
+
+ĐĸĐ°Đē ŅĐ°ĐŧĐž ŅĐē Đи ĐŧĐžĐļĐĩŅĐĩ вĐēаСаŅи ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ, Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи HTTP ĐēОд ŅŅĐ°ŅŅŅŅ Đ´ĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `status_code` в ĐąŅĐ´Ņ-ŅĐēŅĐš С *ĐžĐŋĐĩŅĐ°ŅŅĐš ŅĐģŅŅ
Ņ*:
+
+* `@app.get()`
+* `@app.post()`
+* `@app.put()`
+* `@app.delete()`
+* ŅĐžŅĐž.
+
+{* ../../docs_src/response_status_code/tutorial001.py hl[6] *}
+
+/// note | ĐĐžŅĐ°ŅĐēĐ°
+
+ĐвĐĩŅĐŊŅŅŅ ŅваĐŗŅ, ŅĐž `status_code` Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐžĐŧ ĐŧĐĩŅОдŅ "Đ´ĐĩĐēĐžŅĐ°ŅĐžŅĐ°" (`get`, `post` Ņ Ņ.Đ´.), Đ° ĐŊĐĩ ĐĐ°ŅĐžŅ *ŅŅĐŊĐēŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*, ŅĐē ŅŅŅ ŅĐŊŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи ŅĐ° ŅŅĐģĐž СаĐŋиŅŅ.
+
+///
+
+ĐĐ°ŅĐ°ĐŧĐĩŅŅ `status_code` ĐŋŅиКĐŧĐ°Ņ ŅиŅĐģĐž, ŅĐēĐĩ вŅĐ´ĐŋОвŅĐ´Đ°Ņ HTTP ĐēОдŅ ŅŅĐ°ŅŅŅŅ.
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+`status_code` ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩ ĐžŅŅиĐŧŅваŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ С `IntEnum`, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, С Python `http.HTTPStatus` .
+
+///
+
+ĐŅĐŊ ĐąŅĐ´Đĩ:
+
+* ĐОвĐĩŅŅĐ°Ņи вĐēаСаĐŊиК ĐēОд ŅŅĐ°ŅŅŅŅ Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+* ĐĐžĐēŅĐŧĐĩĐŊŅŅваŅи КОĐŗĐž ŅĐē ŅĐ°ĐēиК Ņ ŅŅ
ĐĩĐŧŅ OpenAPI (Ņ, ŅĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, в ŅĐŊŅĐĩŅŅĐĩĐšŅŅ ĐēĐžŅиŅŅŅваŅĐ°):
+
+MDN ĐŋŅĐž HTTP ĐēОди ŅŅĐ°ŅŅŅŅĐ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Pydantic: ĐĐžĐŊŅŅĐŗŅŅĐ°ŅŅŅ .
+
+Đи ĐŧĐžĐļĐĩŅĐĩ вŅŅĐ°ĐŊОвиŅи `"json_schema_extra"` ŅĐē `dict`, ŅĐž ĐŧŅŅŅиŅŅ ĐąŅĐ´Ņ-ŅĐēŅ дОдаŅĐēОвŅ Đ´Đ°ĐŊŅ, ŅĐēŅ Đи Ņ
ĐžŅĐĩŅĐĩ вŅдОйŅаСиŅи Ņ СĐŗĐĩĐŊĐĩŅОваĐŊŅĐš JSON-ŅŅ
ĐĩĐŧŅ, вĐēĐģŅŅĐ°ŅŅи `examples`.
+
+////
+
+//// tab | Pydantic v1
+
+ĐŖ вĐĩŅŅŅŅ Pydantic 1 виĐēĐžŅиŅŅОвŅŅŅŅŅŅ вĐŊŅŅŅŅŅĐŊŅĐš ĐēĐģĐ°Ņ `Config` Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `schema_extra`, ŅĐē ĐžĐŋиŅĐ°ĐŊĐž в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Pydantic: ĐĐ°ĐģĐ°ŅŅŅваĐŊĐŊŅ ŅŅ
ĐĩĐŧи .
+
+Đи ĐŧĐžĐļĐĩŅĐĩ СадаŅи `schema_extra` ŅĐē `dict`, ŅĐž ĐŧŅŅŅиŅŅ ĐąŅĐ´Ņ-ŅĐēŅ дОдаŅĐēОвŅ Đ´Đ°ĐŊŅ, ŅĐēŅ Đи Ņ
ĐžŅĐĩŅĐĩ йаŅиŅи Ņ СĐŗĐĩĐŊĐĩŅОваĐŊŅĐš JSON-ŅŅ
ĐĩĐŧŅ, вĐēĐģŅŅĐ°ŅŅи `examples`.
+
+////
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи ŅŅ Đļ ŅĐĩŅ
ĐŊŅĐēŅ, ŅОй ŅОСŅиŅиŅи JSON-ŅŅ
ĐĩĐŧŅ Ņ дОдаŅи вĐģĐ°ŅĐŊŅ дОдаŅĐēОвŅ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи ŅŅ Đ´ĐģŅ дОдаваĐŊĐŊŅ ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
Đ´ĐģŅ ŅĐŊŅĐĩŅŅĐĩĐšŅŅ ĐēĐžŅиŅŅŅваŅĐ° ĐŊĐ° ŅŅĐžĐŊŅĐĩĐŊĐ´Ņ ŅĐžŅĐž.
+
+///
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+OpenAPI 3.1.0 (ŅĐēиК виĐēĐžŅиŅŅОвŅŅŅŅŅŅ ĐŋĐžŅиĐŊĐ°ŅŅи С FastAPI 0.99.0) дОдав ĐŋŅĐ´ŅŅиĐŧĐēŅ `examples`, ŅĐž Ņ ŅĐ°ŅŅиĐŊĐžŅ ŅŅĐ°ĐŊĐ´Đ°ŅŅŅ **JSON-ŅŅ
ĐĩĐŧи**.
+
+ĐĐž ŅŅĐžĐŗĐž ĐŋŅĐ´ŅŅиĐŧŅвавŅŅ ĐģиŅĐĩ ĐēĐģŅŅ `example` С ОдĐŊиĐŧ ĐŋŅиĐēĐģĐ°Đ´ĐžĐŧ. ĐŅĐŊ вŅĐĩ ŅĐĩ ĐŋŅĐ´ŅŅиĐŧŅŅŅŅŅŅ в OpenAPI 3.1.0, Đ°ĐģĐĩ Ņ СаŅŅĐ°ŅŅĐģиĐŧ Ņ ĐŊĐĩ вŅ
ОдиŅŅ Đ´Đž ŅŅĐ°ĐŊĐ´Đ°ŅŅŅ JSON Schema. ĐĸĐžĐŧŅ ŅĐĩĐēĐžĐŧĐĩĐŊĐ´ŅŅŅŅŅŅ ĐŋĐĩŅĐĩĐšŅи С `example` ĐŊĐ° `examples`. đ¤
+
+ĐŅĐģŅŅĐĩ ĐŋŅĐž ŅĐĩ ĐŧĐžĐļĐŊĐ° ĐŋŅĐžŅиŅĐ°Ņи в ĐēŅĐŊŅŅ ŅŅŅŅ ŅŅĐžŅŅĐŊĐēи.
+
+///
+
+## ĐОдаŅĐēОвŅ Đ°ŅĐŗŅĐŧĐĩĐŊŅи `Field`
+
+ĐĐžĐģи ви виĐēĐžŅиŅŅОвŅŅŅĐĩ `Field()` Ņ ĐŧОдĐĩĐģŅŅ
Pydantic, Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ вĐēаСаŅи дОдаŅĐēОвŅ `examples`:
+
+{* ../../docs_src/schema_extra_example/tutorial002_py310.py hl[2,8:11] *}
+
+## `examples` Ņ JSON-ŅŅ
ĐĩĐŧŅ â OpenAPI
+
+ĐŅи виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ĐąŅĐ´Ņ-ĐēĐžĐŗĐž С ĐŊĐ°ŅŅŅĐŋĐŊĐžĐŗĐž:
+
+* `Path()`
+* `Query()`
+* `Header()`
+* `Cookie()`
+* `Body()`
+* `Form()`
+* `File()`
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ СадаŅи ĐŊĐ°ĐąŅŅ `examples` С дОдаŅĐēОвОŅ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅŅ, ŅĐēĐ° ĐąŅĐ´Đĩ дОдаĐŊĐ° Đ´Đž ŅŅ
ĐŊŅŅ
**JSON-ŅŅ
ĐĩĐŧ** Ņ **OpenAPI**.
+
+### `Body` С `examples`
+
+ĐĸŅŅ Đŧи ĐŋĐĩŅĐĩĐ´Đ°ŅĐŧĐž `examples`, ŅĐēŅ ĐŧŅŅŅŅŅŅ ОдиĐŊ ĐŋŅиĐēĐģĐ°Đ´ ĐžŅŅĐēŅваĐŊиŅ
Đ´Đ°ĐŊиŅ
Ņ `Body()`:
+
+{* ../../docs_src/schema_extra_example/tutorial003_an_py310.py hl[22:29] *}
+
+### ĐŅиĐēĐģĐ°Đ´ Ņ UI Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ
+
+ĐĐ° Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐąŅĐ´Ņ-ŅĐēĐžĐŗĐž С ĐŊавĐĩĐ´ĐĩĐŊиŅ
виŅĐĩ ĐŧĐĩŅОдŅв ŅĐĩ виĐŗĐģŅĐ´Đ°ŅиĐŧĐĩ ŅĐ°Đē Ņ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Са `/docs`:
+
+26 ŅĐĩŅĐŋĐŊŅ 2023 ), Swagger UI â ŅĐŊŅŅŅŅĐŧĐĩĐŊŅ, ŅĐēиК вŅĐ´ĐŋОвŅĐ´Đ°Ņ Са вŅдОйŅĐ°ĐļĐĩĐŊĐŊŅ UI Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ â ĐŊĐĩ ĐŋŅĐ´ŅŅиĐŧŅŅ ĐŋĐžĐēаС ĐēŅĐģŅĐēĐžŅ
ĐŋŅиĐēĐģĐ°Đ´Ņв Ņ **JSON-ŅŅ
ĐĩĐŧи**. ĐĐģĐĩ ĐŊиĐļŅĐĩ ĐŧĐžĐļĐŊĐ° ĐŋŅĐžŅиŅĐ°Ņи ĐŋŅĐž ОйŅ
ŅĐ´ĐŊиК ŅĐģŅŅ
.
+
+### ĐĄĐŋĐĩŅиŅŅŅĐŊŅ Đ´ĐģŅ OpenAPI `examples`
+
+ĐŠĐĩ Đ´Đž ŅĐžĐŗĐž, ŅĐē **JSON-ŅŅ
ĐĩĐŧĐ°** ĐŋĐžŅĐ°ĐģĐ° ĐŋŅĐ´ŅŅиĐŧŅваŅи `examples`, OpenAPI вĐļĐĩ ĐŧĐ°ĐģĐ° ĐŋŅĐ´ŅŅиĐŧĐēŅ ĐŋĐžĐģŅ С ŅĐ°ĐēĐžŅ Đļ ĐŊаСвОŅ â `examples`.
+
+ĐĻĐĩ **ŅĐŋĐĩŅиŅŅŅĐŊĐĩ Đ´ĐģŅ OpenAPI** ĐŋĐžĐģĐĩ `examples` ŅОСĐŧŅŅŅŅŅŅŅŅ в ŅĐŊŅŅĐš ŅĐ°ŅŅиĐŊŅ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ OpenAPI â Ņ **Đ´ĐĩŅĐ°ĐģŅŅ
ĐēĐžĐļĐŊĐžŅ *ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ***, Đ° ĐŊĐĩ вŅĐĩŅĐĩдиĐŊŅ ŅĐ°ĐŧĐžŅ JSON-ŅŅ
ĐĩĐŧи.
+
+Swagger UI вĐļĐĩ давĐŊĐž ĐŋŅĐ´ŅŅиĐŧŅŅ ŅĐĩ ĐŋĐžĐģĐĩ `examples`. ĐĸĐžĐŧŅ Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи КОĐŗĐž, ŅОй **вŅдОйŅĐ°ĐļĐ°Ņи** ĐēŅĐģŅĐēĐ° **ĐŋŅиĐēĐģĐ°Đ´Ņв Ņ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ**.
+
+ĐĻĐĩ ĐŋĐžĐģĐĩ `examples` Ņ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ OpenAPI â ŅĐĩ `dict` (ŅĐģОвĐŊиĐē) С **ĐēŅĐģŅĐēĐžĐŧĐ° ĐŋŅиĐēĐģĐ°Đ´Đ°Đŧи** (Đ° ĐŊĐĩ ŅĐŋиŅĐžĐē `list`), ĐēĐžĐļĐĩĐŊ ŅС ŅĐēиŅ
ĐŧĐžĐļĐĩ ĐŧŅŅŅиŅи дОдаŅĐēОвŅ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ, ŅĐž ĐąŅĐ´Đĩ дОдаĐŊĐ° Đ´Đž **OpenAPI**.
+
+ĐĐžĐŊĐž ĐŊĐĩ вĐēĐģŅŅĐ°ŅŅŅŅŅ Đ´Đž JSON Schema ĐēĐžĐļĐŊĐžĐŗĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°, Đ° ŅОСĐŧŅŅŅŅŅŅŅŅ СОвĐŊŅ, ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž в *ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*.
+
+### ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `openapi_examples`
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ŅĐŋĐĩŅиŅŅŅĐŊŅ Đ´ĐģŅ OpenAPI `examples` Ņ FastAPI Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `openapi_examples` Đ´ĐģŅ:
+
+* `Path()`
+* `Query()`
+* `Header()`
+* `Cookie()`
+* `Body()`
+* `Form()`
+* `File()`
+
+ĐĐģŅŅŅ ŅĐģОвĐŊиĐēĐ° (`dict`) ŅĐ´ĐĩĐŊŅиŅŅĐēŅŅŅŅ ĐēĐžĐļĐĩĐŊ ĐŋŅиĐēĐģĐ°Đ´, Đ° ĐēĐžĐļĐŊĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ `dict` â ĐēĐžĐļĐĩĐŊ ŅĐŋĐĩŅиŅŅŅĐŊиК ŅĐģОвĐŊиĐē `dict` в `examples` ĐŧĐžĐļĐĩ ĐŧŅŅŅиŅи:
+
+* `summary`: ĐēĐžŅĐžŅĐēиК ĐžĐŋиŅ ĐŋŅиĐēĐģĐ°Đ´Ņ.
+* `description`: ŅОСĐŗĐžŅĐŊŅŅиК ĐžĐŋиŅ (ĐŧĐžĐļĐĩ ĐŧŅŅŅиŅи Markdown).
+* `value`: ŅĐ°Đŧ ĐŋŅиĐēĐģĐ°Đ´, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐģОвĐŊиĐē (`dict`).
+* `externalValue`: Đ°ĐģŅŅĐĩŅĐŊĐ°Ņива `value`, URL-Đ°Đ´ŅĐĩŅĐ°, ŅĐž вĐēаСŅŅ ĐŊĐ° ĐŋŅиĐēĐģĐ°Đ´. ĐŅĐžŅĐĩ ŅŅ ĐžĐŋŅŅŅ ĐŧĐžĐļĐĩ ĐŊĐĩ ĐŋŅĐ´ŅŅиĐŧŅваŅиŅŅ ĐąŅĐģŅŅŅŅŅŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв, ĐŊĐ° вŅĐ´ĐŧŅĐŊŅ вŅĐ´ `value`.
+
+ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ виĐŗĐģŅĐ´Đ°Ņ ŅĐ°Đē:
+
+{* ../../docs_src/schema_extra_example/tutorial005_an_py310.py hl[23:49] *}
+
+### ĐŅиĐēĐģади OpenAPI Ņ UI Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ
+
+Đ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐžĐŧ `openapi_examples`, дОдаĐŊиĐŧ Đ´Đž `Body()`, Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ `/docs` виĐŗĐģŅĐ´Đ°ŅиĐŧĐĩ ŅĐ°Đē:
+
+`Parameter Object` (в ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ) виĐēĐžŅиŅŅОвŅŅŅŅŅŅ FastAPI Đ´ĐģŅ:
+ * `Path()`
+ * `Query()`
+ * `Header()`
+ * `Cookie()`
+* `Request Body Object`, в ĐŋĐžĐģŅ `content`, в `Media Type Object` (в ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ) виĐēĐžŅиŅŅОвŅŅŅŅŅŅ FastAPI Đ´ĐģŅ:
+ * `Body()`
+ * `File()`
+ * `Form()`
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐĻĐĩĐš ŅŅĐ°ŅиК ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `examples`, ŅĐŋĐĩŅиŅŅŅĐŊиК Đ´ĐģŅ OpenAPI, ŅĐĩĐŋĐĩŅ ĐŊаСиваŅŅŅŅŅ `openapi_examples`, ĐŋĐžŅиĐŊĐ°ŅŅи С FastAPI вĐĩŅŅŅŅ `0.103.0`.
+
+///
+
+### ĐĐžĐģĐĩ `examples` Ņ JSON Schema
+
+ĐŅСĐŊŅŅĐĩ JSON Schema дОдаĐģĐ° ĐŋĐžĐģĐĩ `examples` Ņ ĐŊОвŅ вĐĩŅŅŅŅ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ.
+
+РвĐļĐĩ OpenAPI 3.1.0 йаСŅŅŅŅŅŅ ĐŊĐ° ŅŅĐš ĐŊОвŅĐš вĐĩŅŅŅŅ (JSON Schema 2020-12), ŅĐēĐ° вĐēĐģŅŅĐ°Ņ ĐŋĐžĐģĐĩ `examples`.
+
+ĐĸĐĩĐŋĐĩŅ ŅĐĩ ĐŋĐžĐģĐĩ `examples` Ņ ĐŋŅŅĐžŅиŅĐĩŅĐŊиĐŧ Ņ СаĐŧŅĐŊŅŅ ŅŅĐ°ŅĐĩ (Ņ ĐēĐ°ŅŅĐžĐŧĐŊĐĩ) ĐŋĐžĐģĐĩ `example`, ŅĐēĐĩ ŅŅĐ°ĐģĐž СаŅŅĐ°ŅŅĐģиĐŧ.
+
+ĐОвĐĩ ĐŋĐžĐģĐĩ `examples` Ņ JSON Schema â ŅĐĩ **ĐŋŅĐžŅŅĐž ŅĐŋиŅĐžĐē (`list`)** ĐŋŅиĐēĐģĐ°Đ´Ņв, ĐąĐĩС дОдаŅĐēОвиŅ
ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
(ĐŊĐ° вŅĐ´ĐŧŅĐŊŅ вŅĐ´ OpenAPI).
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐавŅŅŅ ĐŋŅŅĐģŅ ŅĐžĐŗĐž, ŅĐē С'ŅвивŅŅ OpenAPI 3.1.0, ŅĐēиК ĐŋŅĐ´ŅŅиĐŧŅвав examples Ņ JSON Schema, ŅĐŊŅŅŅŅĐŧĐĩĐŊŅ Swagger UI ŅĐĩ Đ´ĐĩŅĐēиК ŅĐ°Ņ ĐŊĐĩ ĐŋŅĐ´ŅŅиĐŧŅвав ŅŅ вĐĩŅŅŅŅ (ĐŋŅĐ´ŅŅиĐŧĐēĐ° СâŅвиĐģĐ°ŅŅ С вĐĩŅŅŅŅ 5.0.0 đ).
+
+ЧĐĩŅĐĩС ŅĐĩ вĐĩŅŅŅŅ FastAPI Đ´Đž 0.99.0 вŅĐĩ ŅĐĩ виĐēĐžŅиŅŅОвŅваĐģи вĐĩŅŅŅŅ OpenAPI ĐŊиĐļŅŅ Са 3.1.0.
+
+///
+
+### `Examples` в Pydantic Ņ FastAPI
+
+ĐĐžĐģи Đи дОдаŅŅĐĩ `examples` Ņ ĐŧОдĐĩĐģŅ Pydantic ŅĐĩŅĐĩС `schema_extra` айО `Field(examples=["something"])`, ŅŅ ĐŋŅиĐēĐģади дОдаŅŅŅŅŅ Đ´Đž **JSON Schema** ŅŅŅŅ ĐŧОдĐĩĐģŅ.
+
+Đ ŅŅ **JSON Schema** Pydantic-ĐŧОдĐĩĐģŅ вĐēĐģŅŅĐ°ŅŅŅŅŅ Đ´Đž **OpenAPI** ĐĐ°ŅĐžĐŗĐž API, Đ° ĐŋĐžŅŅĐŧ виĐēĐžŅиŅŅОвŅŅŅŅŅŅ в UI Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ (docs UI).
+
+ĐŖ вĐĩŅŅŅŅŅ
FastAPI Đ´Đž 0.99.0 (ĐŋĐžŅиĐŊĐ°ŅŅи С 0.99.0 виĐēĐžŅиŅŅОвŅŅŅŅŅŅ ĐŊОвŅŅиК OpenAPI 3.1.0), ĐēĐžĐģи Đи виĐēĐžŅиŅŅОвŅваĐģи `example` айО `examples` С ŅĐŊŅиĐŧи ŅŅиĐģŅŅĐ°Đŧи (`Query()`, `Body()` ŅĐžŅĐž), ŅŅ ĐŋŅиĐēĐģади ĐŊĐĩ дОдаваĐģиŅŅ Đ´Đž JSON Schema, ŅĐēиК ĐžĐŋиŅŅŅ ŅŅ Đ´Đ°ĐŊŅ (ĐŊавŅŅŅ ĐŊĐĩ Đ´Đž вĐģĐ°ŅĐŊĐžŅ вĐĩŅŅŅŅ JSON Schema Ņ OpenAPI). ĐĐ°ŅĐžĐŧŅŅŅŅ вОĐŊи дОдаваĐģиŅŅ ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž Đ´Đž ĐžĐŋиŅŅ *ОйŅОйĐŊиĐēĐ° ŅĐģŅŅ
Ņ* *(path operation)* в OpenAPI (ŅОйŅĐž ĐŋОСа ĐŧĐĩĐļĐ°Đŧи ŅĐ°ŅŅиĐŊ, ŅĐēŅ виĐēĐžŅиŅŅОвŅŅŅŅ JSON Schema).
+
+ĐĐģĐĩ ŅĐĩĐŋĐĩŅ, ĐēĐžĐģи FastAPI 0.99.0 Ņ виŅĐĩ виĐēĐžŅиŅŅОвŅŅŅŅ OpenAPI 3.1.0, Đ° ŅОК â JSON Schema 2020-12, ŅаСОĐŧ ŅС Swagger UI 5.0.0 Ņ виŅĐĩ â вŅĐĩ ŅŅĐ°ĐģĐž ĐąŅĐģŅŅ ŅСĐŗОдĐļĐĩĐŊиĐŧ, Ņ examples ŅĐĩĐŋĐĩŅ вĐēĐģŅŅĐ°ŅŅŅŅŅ Đ´Đž JSON Schema.
+
+### Swagger UI ŅĐ° ŅĐŋĐĩŅиŅŅŅĐŊŅ Đ´ĐģŅ OpenAPI `examples`
+
+Đ Đ°ĐŊŅŅĐĩ (ŅŅĐ°ĐŊĐžĐŧ ĐŊĐ° 26 ŅĐĩŅĐŋĐŊŅ 2023 ŅĐžĐēŅ) Swagger UI ĐŊĐĩ ĐŋŅĐ´ŅŅиĐŧŅвав ĐēŅĐģŅĐēĐ° ĐŋŅиĐēĐģĐ°Đ´Ņв Ņ JSON Schema, ŅĐžĐŧŅ ĐēĐžŅиŅŅŅваŅŅ ĐŊĐĩ ĐŧĐ°Đģи ĐŧĐžĐļĐģивОŅŅŅ ĐŋĐžĐēаСаŅи Đ´ĐĩĐēŅĐģŅĐēĐ° ĐŋŅиĐēĐģĐ°Đ´Ņв Ņ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ.
+
+ЊОй виŅŅŅиŅи ŅĐĩ, FastAPI ĐŋĐžŅиĐŊĐ°ŅŅи С вĐĩŅŅŅŅ 0.103.0 **дОдав ĐŋŅĐ´ŅŅиĐŧĐēŅ** ŅŅĐ°ŅĐžĐŗĐž **OpenAPI-ŅĐŋĐĩŅиŅŅŅĐŊĐžĐŗĐž** ĐŋĐžĐģŅ `examples` ŅĐĩŅĐĩС ĐŊОвиК ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `openapi_examples`. đ¤
+
+### ĐŅĐ´ŅŅĐŧĐžĐē
+
+Đ Đ°ĐŊŅŅĐĩ Ņ ĐēаСав, ŅĐž ĐŊĐĩ ĐģŅĐąĐģŅ ŅŅŅĐžŅŅŅ... Đ° ŅĐĩĐŋĐĩŅ ĐžŅŅ Ņ â ŅОСĐŋОвŅĐ´Đ°Ņ "ŅĐĩŅ
ĐŊŅŅĐŊŅ ŅŅŅĐžŅиŅĐŊŅ" ĐģĐĩĐēŅŅŅ. đ
+
+ĐĐžŅĐžŅĐēĐž: **ĐžĐŊОвŅŅŅŅŅ Đ´Đž FastAPI 0.99.0 айО виŅĐĩ** â Ņ вŅĐĩ ŅŅĐ°ĐŊĐĩ СĐŊĐ°ŅĐŊĐž **ĐŋŅĐžŅŅŅŅиĐŧ, ŅСĐŗОдĐļĐĩĐŊиĐŧ ŅĐ° ŅĐŊŅŅŅŅивĐŊĐž СŅОСŅĐŧŅĐģиĐŧ**, Ņ ĐĐ°Đŧ ĐŊĐĩ дОвĐĩĐ´ĐĩŅŅŅŅ СĐŊĐ°Ņи вŅŅ ŅŅ ŅŅŅĐžŅиŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ. đ
diff --git a/docs/uk/docs/tutorial/security/index.md b/docs/uk/docs/tutorial/security/index.md
new file mode 100644
index 000000000..c3d94be8d
--- /dev/null
+++ b/docs/uk/docs/tutorial/security/index.md
@@ -0,0 +1,104 @@
+# ĐĐĩСĐŋĐĩĐēĐ°
+
+ĐŅĐŊŅŅ йаĐŗĐ°ŅĐž ŅĐŋĐžŅОйŅв ŅĐĩĐ°ĐģŅСŅваŅи ĐąĐĩСĐŋĐĩĐēŅ, авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ ŅĐ° авŅĐžŅиСаŅŅŅ.
+
+ĐĻĐĩ СаСвиŅĐ°Đš ŅĐēĐģĐ°Đ´ĐŊĐ° Ņ "ĐŊĐĩĐŋŅĐžŅŅĐ°" ŅĐĩĐŧĐ°.
+
+ĐŖ йаĐŗĐ°ŅŅĐžŅ
ŅŅĐĩĐšĐŧвОŅĐēĐ°Ņ
Ņ ŅиŅŅĐĩĐŧĐ°Ņ
СайĐĩСĐŋĐĩŅĐĩĐŊĐŊŅ ĐąĐĩСĐŋĐĩĐēи ŅĐ° авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ СаКĐŧĐ°Ņ вĐĩĐģиŅĐĩСĐŊŅ ŅĐ°ŅŅиĐŊŅ СŅŅиĐģŅ Ņ ĐēОдŅ (ŅĐŊОдŅ â ĐŋĐžĐŊĐ°Đ´ 50% вŅŅĐžĐŗĐž ĐŊĐ°ĐŋиŅĐ°ĐŊĐžĐŗĐž ĐēОдŅ).
+
+**FastAPI** ĐŊĐ°Đ´Đ°Ņ ĐēŅĐģŅĐēĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв, ŅĐēŅ Đ´ĐžĐŋĐžĐŧĐžĐļŅŅŅ ĐĐ°Đŧ вĐŋĐžŅĐ°ŅиŅŅ С **ĐąĐĩСĐŋĐĩĐēĐžŅ** ĐģĐĩĐŗĐēĐž, ŅвидĐēĐž, ŅŅĐ°ĐŊĐ´Đ°ŅŅĐŊиĐŧ ŅĐŋĐžŅОйОĐŧ, ĐąĐĩС ĐŊĐĩОйŅ
ŅĐ´ĐŊĐžŅŅŅ вивŅĐ°Ņи вŅŅ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ ĐąĐĩСĐŋĐĩĐēи.
+
+ĐĐģĐĩ ŅĐŋĐžŅĐ°ŅĐēŅ â ĐēŅĐģŅĐēĐ° ĐēĐžŅĐžŅĐēиŅ
ĐŋĐžĐŊŅŅŅ.
+
+## ĐĐžŅĐŋŅŅĐ°ŅŅĐĩ?
+
+Đ¯ĐēŅĐž ĐĐ°Đŧ ĐŊĐĩ ŅŅĐēавŅ вŅŅ ŅŅ ŅĐĩŅĐŧŅĐŊи Đš ĐŋŅĐžŅŅĐž ĐŋĐžŅŅŅĐąĐŊĐž *ŅвидĐēĐž* дОдаŅи авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ Са ĐģĐžĐŗŅĐŊĐžĐŧ Ņ ĐŋĐ°ŅĐžĐģĐĩĐŧ â ĐŋĐĩŅĐĩŅ
ОдŅŅĐĩ Đ´Đž ĐŊĐ°ŅŅŅĐŋĐŊиŅ
ŅОСдŅĐģŅв.
+
+## OAuth2
+
+OAuth2 â ŅĐĩ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ, ŅĐž ĐžĐŋиŅŅŅ ĐēŅĐģŅĐēĐ° ŅĐŋĐžŅОйŅв ОйŅОйĐēи авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ ŅĐ° авŅĐžŅиСаŅŅŅ.
+
+ĐĻĐĩ Đ´ĐžŅиŅŅ Ой'ŅĐŧĐŊĐ° ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ, ŅĐēĐ° ĐžŅ
ĐžĐŋĐģŅŅ ŅĐēĐģĐ°Đ´ĐŊŅ виĐŋĐ°Đ´Đēи виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ.
+
+ĐĐžĐŊĐ° вĐēĐģŅŅĐ°Ņ ŅĐŋĐžŅОйи авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ ŅĐĩŅĐĩС "ŅŅĐĩŅŅ ŅŅĐžŅĐžĐŊŅ".
+
+ĐĄĐ°ĐŧĐĩ ŅĐĩ ĐģĐĩĐļиŅŅ в ĐžŅĐŊОвŅ "вŅ
ОдŅ ŅĐĩŅĐĩС Google, Facebook, X (Twitter), GitHub" ŅĐžŅĐž.
+
+### OAuth 1
+
+Đ Đ°ĐŊŅŅĐĩ ŅŅĐŊŅвав OAuth 1, ŅĐēиК СĐŊĐ°ŅĐŊĐž вŅĐ´ŅŅСĐŊŅŅŅŅŅŅ вŅĐ´ OAuth2 Ņ Ņ ŅĐēĐģĐ°Đ´ĐŊŅŅиĐŧ, ĐžŅĐēŅĐģŅĐēи ĐŧŅŅŅив ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ Đ´ĐģŅ ŅиŅŅŅваĐŊĐŊŅ ĐēĐžĐŧŅĐŊŅĐēĐ°ŅŅĐš.
+
+ĐĐ°ŅаС ĐŧĐ°ĐšĐļĐĩ ĐŊĐĩ виĐēĐžŅиŅŅОвŅŅŅŅŅŅ.
+
+OAuth2 ĐŊĐĩ вĐēаСŅŅ, ŅĐē ŅĐ°ĐŧĐĩ ŅиŅŅŅваŅи С'ŅĐ´ĐŊĐ°ĐŊĐŊŅ â вОĐŊĐž ĐžŅŅĐēŅŅ, ŅĐž ваŅ СаŅŅĐžŅŅĐŊĐžĐē ĐŋŅĐ°ŅŅŅ ŅĐĩŅĐĩС HTTPS.
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐŖ ŅОСдŅĐģŅ ĐŋŅĐž **Đ´ĐĩĐŋĐģОК** Đи ĐŋОйаŅиŅĐĩ, ŅĐē ĐŊĐ°ĐģĐ°ŅŅŅваŅи HTTPS ĐąĐĩСĐēĐžŅŅОвĐŊĐž С Traefik ŅĐ° Let's Encrypt.
+
+///
+
+## OpenID Connect
+
+OpenID Connect â ŅĐĩ ОдĐŊĐ° ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ, ĐŋОйŅдОваĐŊĐ° ĐŊĐ° ĐžŅĐŊОвŅ **OAuth2**.
+
+ĐĐžĐŊĐ° ŅОСŅиŅŅŅ OAuth2, ŅŅĐžŅĐŊŅŅŅи Đ´ĐĩŅĐēŅ ĐŊĐĩОдĐŊОСĐŊĐ°ŅĐŊĐžŅŅŅ Đ´ĐģŅ Đ´ĐžŅŅĐŗĐŊĐĩĐŊĐŊŅ ĐēŅĐ°ŅĐžŅ ŅŅĐŧŅŅĐŊĐžŅŅŅ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, вŅ
ŅĐ´ ŅĐĩŅĐĩС Google виĐēĐžŅиŅŅОвŅŅ OpenID Connect (ŅĐēиК йаСŅŅŅŅŅŅ ĐŊĐ° OAuth2).
+
+ĐĐģĐĩ вŅ
ŅĐ´ ŅĐĩŅĐĩС Facebook â ĐŊŅ. ĐŅĐŊ ĐŧĐ°Ņ вĐģĐ°ŅĐŊŅ ŅĐĩĐ°ĐģŅСаŅŅŅ ĐŊĐ° йаСŅ OAuth2.
+
+### OpenID (ĐŊĐĩ "OpenID Connect")
+
+ĐŅĐŊŅваĐģĐ° ŅĐ°ĐēĐžĐļ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ "OpenID", ŅĐēĐ° ĐŊĐ°ĐŧĐ°ĐŗĐ°ĐģĐ°ŅŅ ŅОСвĘŧŅСаŅи ŅŅ ŅĐ°ĐŧŅ СадаŅŅ, ŅĐž Đš **OpenID Connect**, Đ°ĐģĐĩ ĐŊĐĩ йаСŅваĐģĐ°ŅŅ ĐŊĐ° OAuth2.
+
+ĐĻĐĩ ĐąŅĐģĐ° СОвŅŅĐŧ ŅĐŊŅĐ° ŅиŅŅĐĩĐŧĐ°, Ņ ŅŅĐžĐŗОдĐŊŅ вОĐŊĐ° ĐŧĐ°ĐšĐļĐĩ ĐŊĐĩ виĐēĐžŅиŅŅОвŅŅŅŅŅŅ.
+
+## OpenAPI
+
+OpenAPI (ŅĐ°ĐŊŅŅĐĩ Swagger) â ŅĐĩ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ Đ´ĐģŅ ĐŋОйŅдОви API (ŅĐĩĐŋĐĩŅ ĐŋŅĐ´ ĐĩĐŗŅĐ´ĐžŅ Linux Foundation).
+
+**FastAPI** йаСŅŅŅŅŅŅ ĐŊĐ° **OpenAPI**.
+
+ĐавдŅĐēи ŅŅĐžĐŧŅ Đи ĐžŅŅиĐŧŅŅŅĐĩ авŅĐžĐŧĐ°ŅиŅĐŊŅ ŅĐŊŅĐĩŅĐ°ĐēŅивĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ĐŗĐĩĐŊĐĩŅĐ°ŅŅŅ ĐēОдŅ ŅĐ° йаĐŗĐ°ŅĐž ŅĐŊŅĐžĐŗĐž.
+
+OpenAPI дОСвОĐģŅŅ ĐžĐŋиŅŅваŅи ŅŅСĐŊŅ "ŅŅ
ĐĩĐŧи" ĐąĐĩСĐŋĐĩĐēи.
+
+ĐиĐēĐžŅиŅŅОвŅŅŅи ŅŅ
, Đи ĐŧĐžĐļĐĩŅĐĩ ŅĐēĐžŅиŅŅĐ°ŅиŅŅ вŅŅĐŧĐ° ŅиĐŧи ŅĐŊŅŅŅŅĐŧĐĩĐŊŅĐ°Đŧи, ŅĐž йаСŅŅŅŅŅŅ ĐŊĐ° ŅŅĐ°ĐŊĐ´Đ°ŅŅĐ°Ņ
, СОĐēŅĐĩĐŧĐ° ŅĐŊŅĐĩŅĐ°ĐēŅивĐŊиĐŧи ŅиŅŅĐĩĐŧĐ°Đŧи Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ.
+
+OpenAPI виСĐŊĐ°ŅĐ°Ņ ŅĐ°ĐēŅ ŅŅ
ĐĩĐŧи ĐąĐĩСĐŋĐĩĐēи:
+
+* `apiKey`: ŅĐŋĐĩŅиŅŅŅĐŊиК Đ´ĐģŅ СаŅŅĐžŅŅĐŊĐēŅ ĐēĐģŅŅ, ŅĐēиК ĐŧĐžĐļĐĩ ĐŋĐĩŅĐĩдаваŅиŅŅ ŅĐĩŅĐĩС:
+ * ĐĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ.
+ * ĐĐ°ĐŗĐžĐģОвОĐē.
+ * Cookie.
+* `http`: ŅŅĐ°ĐŊĐ´Đ°ŅŅĐŊŅ ĐŧĐĩŅОди HTTP-авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ, вĐēĐģŅŅĐ°ŅŅи:
+ * `bearer`: СаĐŗĐžĐģОвОĐē `Authorization` СŅ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ `Bearer` ŅĐ° ŅĐžĐēĐĩĐŊĐžĐŧ. ĐĻĐĩ ŅŅĐŋĐ°Đ´ĐēОваĐŊĐž С OAuth2.
+ * HTTP Basic авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ
+ * HTTP Digest, ŅĐžŅĐž.
+* `oauth2`: ŅŅŅ ŅĐŋĐžŅОйи ОйŅОйĐēи ĐąĐĩСĐŋĐĩĐēи Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ OAuth2 (ŅĐ°Đē СваĐŊŅ ÂĢĐŋĐžŅĐžĐēиÂģ).
+ * ĐĐĩŅĐēŅ С ŅиŅ
ĐŋĐžŅĐžĐēŅв ĐŋŅĐ´Ņ
ОдŅŅŅ Đ´ĐģŅ ŅŅвОŅĐĩĐŊĐŊŅ вĐģĐ°ŅĐŊĐžĐŗĐž ĐŋŅОваКдĐĩŅĐ° авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ OAuth 2.0 (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, Google, Facebook, X (Twitter), GitHub ŅĐžŅĐž):
+ * `implicit`â ĐŊĐĩŅвĐŊиК
+ * `clientCredentials`â ОйĐģŅĐēОвŅ Đ´Đ°ĐŊŅ ĐēĐģŅŅĐŊŅĐ°
+ * `authorizationCode` â ĐēОд авŅĐžŅиСаŅŅŅ
+ * ĐĐģĐĩ Ņ ОдиĐŊ ĐžĐēŅĐĩĐŧиК ÂĢĐŋĐžŅŅĐēÂģ, ŅĐēиК ŅĐ´ĐĩĐ°ĐģŅĐŊĐž ĐŋŅĐ´Ņ
ОдиŅŅ Đ´ĐģŅ ŅĐĩĐ°ĐģŅСаŅŅŅ авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ вŅĐĩŅĐĩдиĐŊŅ ОдĐŊĐžĐŗĐž дОдаŅĐēŅ:
+ * `password`: Ņ ĐŊĐ°ŅŅŅĐŋĐŊиŅ
ŅОСдŅĐģĐ°Ņ
ĐąŅĐ´Đĩ ĐŋŅиĐēĐģĐ°Đ´ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ŅŅĐžĐŗĐž ĐŋĐžŅĐžĐēŅ.
+* `openIdConnect`: дОСвОĐģŅŅ авŅĐžĐŧĐ°ŅиŅĐŊĐž виŅвĐģŅŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ OAuth2.
+ * ĐĻĐĩ авŅĐžĐŧĐ°ŅиŅĐŊĐĩ виŅвĐģĐĩĐŊĐŊŅ виСĐŊĐ°ŅĐ°ŅŅŅŅŅ Ņ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ OpenID Connect.
+
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐĐŊŅĐĩĐŗŅĐ°ŅŅŅ ŅĐŊŅиŅ
ĐŋŅОваКдĐĩŅŅв авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ/авŅĐžŅиСаŅŅŅ, ŅĐ°ĐēиŅ
ŅĐē Google, Facebook, X (Twitter), GitHub ŅĐžŅĐž â ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐģива Ņ вŅĐ´ĐŊĐžŅĐŊĐž ĐŋŅĐžŅŅĐ°.
+
+ĐĐ°ĐšŅĐēĐģĐ°Đ´ĐŊŅŅĐĩ â ŅĐĩ ŅŅвОŅиŅи вĐģĐ°ŅĐŊĐžĐŗĐž ĐŋŅОваКдĐĩŅĐ° авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ/авŅĐžŅиСаŅŅŅ, ŅĐē Google Ņи Facebook. ĐĐģĐĩ **FastAPI** ĐŊĐ°Đ´Đ°Ņ ĐĐ°Đŧ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи, ŅОй СŅОйиŅи ŅĐĩ ĐģĐĩĐŗĐēĐž, ĐąĐĩŅŅŅи ĐŊĐ° ŅĐĩĐąĐĩ ваĐļĐēŅ ŅĐ°ŅŅиĐŊŅ ŅОйОŅи.
+
+///
+
+## ĐĐŊŅŅŅŅĐŧĐĩĐŊŅи **FastAPI**
+
+FastAPI ĐŊĐ°Đ´Đ°Ņ ĐēŅĐģŅĐēĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв Đ´ĐģŅ ĐēĐžĐļĐŊĐžŅ С ĐžĐŋиŅĐ°ĐŊиŅ
ŅŅ
ĐĩĐŧ ĐąĐĩСĐŋĐĩĐēи в ĐŧОдŅĐģŅ `fastapi.security`, ŅĐēŅ ŅĐŋŅĐžŅŅŅŅŅ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ŅиŅ
ĐŧĐĩŅ
Đ°ĐŊŅСĐŧŅв СаŅ
иŅŅŅ.
+
+ĐŖ ĐŊĐ°ŅŅŅĐŋĐŊиŅ
ŅОСдŅĐģĐ°Ņ
Đи ĐŋОйаŅиŅĐĩ, ŅĐē дОдаŅи ĐąĐĩСĐŋĐĩĐēŅ Đ´Đž ŅвОĐŗĐž API Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ŅиŅ
ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв **FastAPI**.
+
+Đ ŅĐ°ĐēĐžĐļ ĐŋОйаŅиŅĐĩ, ŅĐē вОĐŊĐ° авŅĐžĐŧĐ°ŅиŅĐŊĐž ŅĐŊŅĐĩĐŗŅŅŅŅŅŅŅ в ŅĐŊŅĐĩŅĐ°ĐēŅивĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ваŅĐžĐŗĐž API.
diff --git a/docs/zh/docs/deployment/concepts.md b/docs/zh/docs/deployment/concepts.md
index 7a0b6c3d2..f7208da7c 100644
--- a/docs/zh/docs/deployment/concepts.md
+++ b/docs/zh/docs/deployment/concepts.md
@@ -220,7 +220,7 @@
čŋäēåˇĨäŊčŋį¨å°æ¯čŋčĄæ¨įåēį¨į¨åēįčŋį¨īŧåŽäģŦå°æ§čĄä¸ģčĻ莥įŽäģĨæĨæļ **č¯ˇæą** åšļčŋå **ååē**īŧåšļä¸åŽäģŦå°å čŊŊæ¨æžå
Ĩ RAM ä¸įåéä¸įäģģäŊå
厚ã
-Uvicorn īŧéĢæ§čŊ ASGI æåĄå¨ã
-* Hypercorn īŧä¸ HTTP/2 å Trio įå
ŧ厚į ASGI æåĄå¨ã
-* Daphne īŧä¸ē Django Channels æåģēį ASGI æåĄå¨ã
-
-## æåĄå¨ä¸ģæēåæåĄå¨į¨åē
-
-å
ŗäēåį§°īŧæä¸ä¸Ēå°įģčéčĻ莰äŊã đĄ
-
-â**æåĄå¨**âä¸č¯é常į¨äēæčŋį¨/äē莥įŽæēīŧįŠįæēæčææēīŧäģĨåå¨č¯Ĩ莥įŽæēä¸čŋčĄįį¨åēīŧäžåĻ Uvicornīŧã
+
-č¯ˇčŽ°äŊīŧåŊæ¨ä¸čŦč¯ģå°âæåĄå¨âčŋä¸Ēåč¯æļīŧåŽå¯čŊæįæ¯čŋ两č
äšä¸ã
+```console
+$
fastapi run
main.py
-åŊæå°čŋį¨ä¸ģæēæļīŧé常å°å
ļį§°ä¸ē**æåĄå¨**īŧäŊäšį§°ä¸ē**æēå¨**(machine)ã**VM**īŧčææēīŧã**čįš**ã čŋäēéŊæ¯ææį§įąģåįčŋį¨čŽĄįŽæēīŧé常čŋčĄ Linuxīŧæ¨å¯äģĨå¨å
ļä¸čŋčĄį¨åēã
+
FastAPI Starting production server đ
+ Searching for package file structure from directories
+ with
__init__.py files
+ Importing from
/home/user/code/ awesomeapp
-## åŽčŖ
æåĄå¨į¨åē
+
module đ main.py
-æ¨å¯äģĨäŊŋį¨äģĨä¸åŊäģ¤åŽčŖ
ASGI å
ŧ厚æåĄå¨īŧ
+
code Importing the FastAPI app object from the module with
+ the following code:
-//// tab | Uvicorn
+
from main import app
-*
Uvicorn īŧä¸ä¸ĒåŋĢåĻéĒįĩ ASGI æåĄå¨īŧåēäē uvloop å httptools æåģēã
+
app Using import string:
main:app
-
+ server http://0.0.0.0:8000 server http://0.0.0.0:8000/docs INFO [ 2306215 ]
+ INFO INFO INFO http://0.0.0.0:8000 ( Press CTRL+C
+ to quit)
```
-/// tip
+čŋå¨å¤§å¤æ°æ
åĩä¸éŊčŊæŖ常čŋčĄãđ
-éčŋæˇģå `standard`īŧUvicorn å°åŽčŖ
åšļäŊŋį¨ä¸äēæ¨čįéĸå¤äžčĩ饚ã
+äžåĻīŧæ¨å¯äģĨäŊŋį¨č¯ĨåŊäģ¤å¨åŽšå¨ãæåĄå¨įį¯åĸä¸å¯å¨æ¨į **FastAPI** åēį¨ã
-å
ļä¸å
æŦ`uvloop`īŧåŽæ¯`asyncio`įéĢæ§čŊæŋäģŖåīŧåŽæäžäēåˇ¨å¤§įåšļåæ§čŊæåã
+## ASGI æåĄå¨
-///
+莊æäģŦæˇąå
Ĩäēč§Ŗä¸äēįģčã
-////
+FastAPI äŊŋį¨äēä¸į§į¨äēæåģē Python Web æĄæļåæåĄå¨įæ åīŧį§°ä¸ē
ASGI ãFastAPI æŦč´¨ä¸æ¯ä¸ä¸Ē ASGI Web æĄæļã
-//// tab | Hypercorn
+čĻå¨čŋį¨æåĄå¨ä¸čŋčĄ **FastAPI** åēį¨īŧæäģģäŊå
ļäģ ASGI åēį¨īŧīŧæ¨éčĻä¸ä¸Ē ASGI æåĄå¨į¨åēīŧäžåĻ **Uvicorn**ãåŽæ¯ `fastapi` åŊäģ¤éģ莤äŊŋį¨į ASGI æåĄå¨ã
-*
Hypercorn īŧä¸ä¸Ēäšä¸ HTTP/2 å
ŧ厚į ASGI æåĄå¨ã
-
-
+é¤æ¤äšå¤īŧčŋæå
ļäģä¸äēå¯éį ASGI æåĄå¨īŧäžåĻīŧ
-```console
-$ pip install hypercorn
-
----> 100%
-```
-
-
+*
Uvicorn īŧéĢæ§čŊ ASGI æåĄå¨ã
+*
Hypercorn īŧä¸ HTTP/2 å Trio įå
ŧ厚į ASGI æåĄå¨ã
+*
Daphne īŧä¸ē Django Channels æåģēį ASGI æåĄå¨ã
+*
Granian īŧåēäē Rust į HTTP æåĄå¨īŧä¸ä¸ē Python åēį¨čŽžčŽĄã
+*
NGINX Unit īŧNGINX Unit æ¯ä¸ä¸ĒčŊģéįē§ä¸įĩæ´ģį Web åēį¨čŋčĄæļį¯åĸã
-...æäģģäŊå
ļäģ ASGI æåĄå¨ã
+## æåĄå¨ä¸ģæēåæåĄå¨į¨åē
-////
+å
ŗäēåį§°īŧæä¸ä¸Ēå°įģčéčĻ莰äŊã đĄ
-## čŋčĄæåĄå¨į¨åē
+â**æåĄå¨**âä¸č¯é常į¨äēæčŋį¨/äē莥įŽæēīŧįŠįæēæčææēīŧäģĨåå¨č¯Ĩ莥įŽæēä¸čŋčĄįį¨åēīŧäžåĻ Uvicornīŧã
-æ¨å¯äģĨæį
§äšåæį¨ä¸įį¸åæšåŧčŋčĄåēį¨į¨åēīŧäŊä¸äŊŋį¨`--reload`é饚īŧäžåĻīŧ
+č¯ˇčŽ°äŊīŧåŊæ¨ä¸čŦč¯ģå°âæåĄå¨âčŋä¸Ēåč¯æļīŧåŽå¯čŊæįæ¯čŋ两č
äšä¸ã
-//// tab | Uvicorn
+åŊæå°čŋį¨ä¸ģæēæļīŧé常å°å
ļį§°ä¸ē**æåĄå¨**īŧäŊäšį§°ä¸ē**æēå¨**(machine)ã**VM**īŧčææēīŧã**čįš**ã čŋäēéŊæ¯ææį§įąģåįčŋį¨čŽĄįŽæēīŧé常čŋčĄ Linuxīŧæ¨å¯äģĨå¨å
ļä¸čŋčĄį¨åēã
-
-```console
-$ uvicorn main:app --host 0.0.0.0 --port 80
+## åŽčŖ
æåĄå¨į¨åē
-INFO : Uvicorn running on http://0.0.0.0:80 (Press CTRL+C to quit)
-```
+åŊæ¨åŽčŖ
FastAPI æļīŧåŽčĒå¸Ļä¸ä¸Ēįäē§į¯åĸæåĄå¨ââUvicornīŧåšļä¸æ¨å¯äģĨäŊŋį¨ `fastapi run` åŊäģ¤æĨå¯å¨åŽã
-
+ä¸čŋīŧæ¨äšå¯äģĨæå¨åŽčŖ
ASGI æåĄå¨ã
-////
+č¯ˇįĄŽäŋæ¨ååģēåšļæŋæ´ģä¸ä¸Ē[čæį¯åĸ](../virtual-environments.md){.internal-link target=_blank}īŧįļåååŽčŖ
æåĄå¨åēį¨į¨åēã
-//// tab | Hypercorn
+äžåĻīŧčĻåŽčŖ
Uvicornīŧå¯äģĨčŋčĄäģĨä¸åŊäģ¤īŧ
```console
-$ hypercorn main:app --bind 0.0.0.0:80
+$ pip install "uvicorn[standard]"
-Running on 0.0.0.0:8080 over http (CTRL + C to quit)
+---> 100%
```
-////
+įąģäŧŧįæĩį¨äšéį¨äēäģģäŊå
ļäģ ASGI æåĄå¨į¨åēã
-/// warning
+/// tip
-åĻææ¨æŖå¨äŊŋį¨`--reload`é饚īŧč¯ˇčŽ°äŊå é¤åŽã
+éčŋæˇģå `standard` é饚īŧUvicorn å°åŽčŖ
åšļäŊŋį¨ä¸äēæ¨čįéĸå¤äžčĩ饚ã
- `--reload` é饚æļčæ´å¤čĩæēīŧåšļä¸æ´ä¸į¨ŗåŽã
+å
ļä¸å
æŦ `uvloop`īŧčŋæ¯ `asyncio` įéĢæ§čŊæŋäģŖæšæĄīŧčŊå¤æžčæååšļåæ§čŊã
- åŽå¨**åŧå**æé´æåžå¤§å¸ŽåŠīŧäŊæ¨**ä¸åēč¯Ĩ**å¨**įäē§į¯åĸ**ä¸äŊŋį¨åŽã
+åŊæ¨äŊŋį¨ `pip install "fastapi[standard]"` åŽčŖ
FastAPI æļīŧåŽé
ä¸äšäŧåŽčŖ
`uvicorn[standard]`ã
///
-## Hypercorn with Trio
-
-Starlette å **FastAPI** åēäē
AnyIO īŧ æäģĨåŽäģŦæčŊåæļä¸ Python įæ ååē
asyncio å
Trio å
ŧ厚ã
-
-å°ŊįŽĄåĻæ¤īŧUvicorn įŽåäģ
ä¸ asyncio å
ŧ厚īŧåšļä¸é常äŊŋį¨
`uvloop` , åŽæ¯`asyncio`įéĢæ§čŊæŋäģŖåã
-
-äŊåĻæäŊ æŗį´æĨäŊŋį¨**Trio**īŧéŖäšäŊ å¯äģĨäŊŋį¨**Hypercorn**īŧå ä¸ēåŽæ¯æåŽã â¨
-
-### åŽčŖ
å
ˇæ Trio į Hypercorn
+## čŋčĄæåĄå¨į¨åē
-éĻå
īŧæ¨éčĻåŽčŖ
å
ˇæ Trio æ¯æį Hypercornīŧ
+åĻææ¨æå¨åŽčŖ
äē ASGI æåĄå¨īŧé常éčĻäģĨįšåŽæ ŧåŧäŧ éä¸ä¸Ēå¯ŧå
ĨåįŦĻ串īŧäģĨäžŋæåĄå¨čŊå¤æŖįĄŽå¯ŧå
Ĩæ¨į FastAPI åēį¨īŧ
```console
-$ pip install "hypercorn[trio]"
----> 100%
+$ uvicorn main:app --host 0.0.0.0 --port 80
+
+INFO : Uvicorn running on http://0.0.0.0:80 (Press CTRL+C to quit)
```
-### Run with Trio
+/// note
-įļåäŊ å¯äģĨäŧ éåŧ`trio`įģåŊäģ¤čĄé饚`--worker-class`:
+åŊäģ¤ `uvicorn main:app` įåĢäšåĻä¸īŧ
-
+* `main`īŧæįæ¯ `main.py` æäģļīŧåŗ Python âæ¨Ąåâīŧã
+* `app`īŧæįæ¯ `main.py` æäģļä¸éčŋ `app = FastAPI()` ååģēįå¯ščąĄã
-```console
-$ hypercorn main:app --worker-class trio
+åŽįäģˇäēäģĨä¸å¯ŧå
Ĩč¯åĨīŧ
+
+```Python
+from main import app
```
-
+///
+
+æ¯į§ ASGI æåĄå¨į¨åēé常éŊäŧæįąģäŧŧįåŊäģ¤īŧæ¨å¯äģĨå¨åŽäģŦįåŽæšææĄŖä¸æžå°æ´å¤äŋĄæ¯ã
+
+/// warning
+
+Uvicorn åå
ļäģæåĄå¨æ¯æ `--reload` é饚īŧč¯Ĩé饚å¨åŧåčŋį¨ä¸é常æį¨ã
-čŋå°éčŋæ¨įåēį¨į¨åēå¯å¨ HypercornīŧåšļäŊŋį¨ Trio äŊä¸ēåįĢ¯ã
+äŊ `--reload` é饚äŧæļčæ´å¤čĩæēīŧä¸į¸å¯šä¸į¨ŗåŽã
-į°å¨æ¨å¯äģĨå¨åēį¨į¨åēå
é¨äŊŋį¨ Trioã æč
æ´åĨŊįæ¯īŧæ¨å¯äģĨäŊŋį¨ AnyIOīŧäŊŋæ¨įäģŖį ä¸ Trio å asyncio å
ŧ厚ã đ
+åŽå¯šäē**åŧåéļæŽĩ**é常æ帎åŠīŧäŊå¨**įäē§į¯åĸ**ä¸**ä¸åēč¯Ĩ**äŊŋį¨ã
+
+///
## é¨įŊ˛æĻåŋĩ
-čŋäēį¤ēäžčŋčĄæåĄå¨į¨åēīŧäžåĻ Uvicornīŧīŧå¯å¨**åä¸Ēčŋį¨**īŧå¨ææ IPīŧ`0.0.0.0`)ä¸įåŦéĸåŽäšįĢ¯åŖīŧäžåĻ`80`)ã
+čŋäēį¤ēäžčŋčĄæåĄå¨į¨åēīŧäžåĻ Uvicornīŧīŧå¯å¨**åä¸Ēčŋį¨**īŧå¨ææ IPīŧ`0.0.0.0`īŧä¸įåŦéĸåŽäšįĢ¯åŖīŧäžåĻ`80`īŧã
čŋæ¯åēæŦæčˇ¯ã äŊæ¨å¯čŊéčĻå¤įä¸äēå
ļäģäēæ
īŧäžåĻīŧ
* åŽå
¨æ§ - HTTPS
* å¯å¨æļčŋčĄ
* éæ°å¯å¨
-* ReplicationīŧčŋčĄįčŋį¨æ°īŧ
+* å¤åļīŧčŋčĄįčŋį¨æ°īŧ
* å
å
* åŧå§åįæĨéĒ¤
diff --git a/docs/zh/docs/deployment/server-workers.md b/docs/zh/docs/deployment/server-workers.md
index eb0252a5c..e46ba7a09 100644
--- a/docs/zh/docs/deployment/server-workers.md
+++ b/docs/zh/docs/deployment/server-workers.md
@@ -1,4 +1,4 @@
-# Server Workers - Gunicorn with Uvicorn
+# æåĄå¨åˇĨäŊčŋį¨īŧWorkersīŧ - äŊŋį¨ Uvicorn įå¤åˇĨäŊčŋį¨æ¨Ąåŧ
莊æäģŦå饞ä¸ä¸äšåįé¨įŊ˛æĻåŋĩīŧ
@@ -9,125 +9,79 @@
* å
å
* å¯å¨åįå
åæĨéĒ¤
-å°įŽåä¸ēæĸīŧéčŋææĄŖä¸įæææį¨īŧæ¨å¯čŊåˇ˛įģå¨**åä¸Ēčŋį¨**ä¸čŋčĄäēå Uvicorn čŋæ ˇį**æåĄå¨į¨åē**ã
+å°įŽåä¸ēæĸīŧå¨ææĄŖä¸įæææį¨ä¸īŧæ¨å¯čŊä¸į´æ¯å¨čŋčĄä¸ä¸Ē**æåĄå¨į¨åē**īŧäžåĻäŊŋį¨ `fastapi` åŊäģ¤æĨå¯å¨ UvicornīŧčåŽéģ莤čŋčĄįæ¯**åčŋį¨æ¨Ąåŧ**ã
-é¨įŊ˛åēį¨į¨åēæļīŧæ¨å¯čŊå¸æčŋčĄä¸äē**čŋį¨å¤åļ**īŧäģĨåŠį¨**å¤æ ¸**åšļčŊå¤å¤įæ´å¤č¯ˇæąã
+é¨įŊ˛åēį¨į¨åēæļīŧæ¨å¯čŊå¸æčŋčĄä¸äē**čŋį¨å¤åļ**īŧäģĨåŠį¨**å¤æ ¸** CPU åšļčŊå¤å¤įæ´å¤č¯ˇæąã
æŖåĻæ¨å¨ä¸ä¸įĢ æå
ŗ[é¨įŊ˛æĻåŋĩ](concepts.md){.internal-link target=_blank}ä¸įå°įīŧæ¨å¯äģĨäŊŋį¨å¤į§įįĨã
-å¨čŋéæå°åæ¨åąį¤ēåĻäŊå°
**Gunicorn** ä¸ **Uvicorn worker čŋį¨** ä¸čĩˇäŊŋį¨ã
+å¨æŦįĢ čä¸īŧæå°åæ¨åąį¤ēåĻäŊäŊŋį¨ `fastapi` åŊäģ¤æį´æĨäŊŋį¨ `uvicorn` åŊäģ¤äģĨ**å¤åˇĨäŊčŋį¨æ¨Ąåŧ**čŋčĄ **Uvicorn**ã
/// info
åĻææ¨æŖå¨äŊŋį¨åŽšå¨īŧäžåĻ Docker æ Kubernetesīŧæå°å¨ä¸ä¸įĢ ä¸åč¯æ¨æ´å¤į¸å
ŗäŋĄæ¯īŧ[厚å¨ä¸į FastAPI - Docker](docker.md){.internal-link target=_blank}ã
-įšåĢæ¯īŧåŊå¨ **Kubernetes** ä¸čŋčĄæļīŧæ¨å¯čŊ**ä¸æŗ**äŊŋį¨ Gunicornīŧčæ¯čŋčĄ **æ¯ä¸Ē厚å¨ä¸ä¸Ē Uvicorn čŋį¨**īŧäŊæå°å¨æŦįĢ åéĸåč¯æ¨čŋä¸įšã
+æ¯čžįšåĢįæ¯īŧå¨ **Kubernetes** į¯åĸä¸čŋčĄæļīŧæ¨é常**ä¸éčĻ**äŊŋį¨å¤ä¸ĒåˇĨäŊčŋį¨īŧčæ¯**æ¯ä¸Ē厚å¨čŋčĄä¸ä¸Ē Uvicorn čŋį¨**ãä¸čŋīŧæäŧå¨æŦįĢ čįåįģé¨åč¯Ļįģäģįģčŋä¸įšã
///
-## Gunicorn with Uvicorn Workers
+## å¤ä¸ĒåˇĨäŊčŋį¨
-**Gunicorn**ä¸ģčĻæ¯ä¸ä¸ĒäŊŋį¨**WSGIæ å**įåēį¨æåĄå¨ã čŋæåŗį Gunicorn å¯äģĨä¸ē Flask å Django įåēį¨į¨åēæäžæåĄã Gunicorn æŦčēĢä¸ **FastAPI** ä¸å
ŧ厚īŧå ä¸ē FastAPI äŊŋį¨ææ°į **
ASGI æ å **ã
+æ¨å¯äģĨäŊŋį¨ `--workers` åŊäģ¤čĄé饚æĨå¯å¨å¤ä¸ĒåˇĨäŊčŋį¨īŧ
-äŊ Gunicorn æ¯æå
åŊ **čŋį¨įŽĄįå¨** åšļå
莸į¨æˇåč¯åŽčĻäŊŋį¨åĒä¸ĒįšåŽį **workerįąģ**ã įļå Gunicorn å°äŊŋį¨č¯Ĩįąģå¯å¨ä¸ä¸Ēæå¤ä¸Ē **workerčŋį¨**ã
+//// tab | `fastapi`
-**Uvicorn** æä¸ä¸Ē Gunicorn å
ŧ厚įworkerįąģã
-
-äŊŋį¨čŋį§įģåīŧGunicorn å°å
åŊ **čŋį¨įŽĄįå¨**īŧįåŦ **įĢ¯åŖ** å **IP**ã åŽäŧå°éäŋĄ**äŧ čž**å°čŋčĄ**Uvicornįąģ**įworkerčŋį¨ã
-
-įļåä¸Gunicornå
ŧ厚į**Uvicorn worker**įąģå°č´č´Ŗå°Gunicornåéįæ°æŽčŊŦæĸä¸ēASGIæ åäģĨäžFastAPIäŊŋį¨ã
-
-## åŽčŖ
Gunicorn å Uvicorn
+åĻææ¨äŊŋį¨ `fastapi` åŊäģ¤īŧ
```console
-$ pip install "uvicorn[standard]" gunicorn
-
----> 100%
-```
-
-
+$
fastapi run --workers 4
main.py
-čŋå°åŽčŖ
å¸Ļæ`standard`æŠåąå
īŧäģĨčˇåžéĢæ§čŊīŧį Uvicorn å Gunicornã
+
FastAPI Starting production server đ
-## Run Gunicorn with Uvicorn Workers
+ Searching for package file structure from directories with
+
__init__.py files
+ Importing from
/home/user/code/ awesomeapp
-æĨä¸æĨäŊ å¯äģĨéčŋäģĨä¸åŊäģ¤čŋčĄGunicorn:
-
-
-
-```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.
-```
-
-
+
module đ main.py
+
code Importing the FastAPI app object from the module with the
+ following code:
-莊æäģŦįįæ¯ä¸Ēé饚įåĢäšīŧ
+
from main import app
-* `main:app`īŧčŋä¸ Uvicorn äŊŋį¨įč¯æŗį¸åīŧ`main` 襨į¤ēåä¸ē"`main`"į Python æ¨Ąåīŧå æ¤æ¯æäģļ `main.py`ã `app` æ¯ **FastAPI** åēį¨į¨åēįåéåį§°ã
- * äŊ å¯äģĨæŗ蹥 `main:app` į¸åŊäēä¸ä¸Ē Python `import` č¯åĨīŧäžåĻīŧ
+
app Using import string:
main:app
- ```Python
- from main import app
- ```
+
server Server started at
http://0.0.0.0:8000
+
server Documentation at
http://0.0.0.0:8000/docs
- * å æ¤īŧ`main:app` ä¸įååˇį¸åŊäē `from main import app` ä¸į Python `import` é¨åã
+ Logs:
-* `--workers`īŧčĻäŊŋį¨įworkerčŋį¨æ°éīŧæ¯ä¸Ēčŋį¨å°čŋčĄä¸ä¸Ē Uvicorn workerčŋį¨īŧå¨æŦäžä¸ä¸ē 4 ä¸Ēworkerčŋį¨ã
-
-* `--worker-class`īŧå¨workerčŋį¨ä¸äŊŋį¨įä¸ Gunicorn å
ŧ厚įåˇĨäŊįąģã
- * čŋéæäģŦäŧ éäē Gunicorn å¯äģĨå¯ŧå
ĨåäŊŋį¨įįąģīŧ
-
- ```Python
- import uvicorn.workers.UvicornWorker
- ```
-
-* `--bind`īŧčŋåč¯ Gunicorn čĻįåŦį IP åįĢ¯åŖīŧäŊŋį¨ååˇ (`:`) åé IP åįĢ¯åŖã
- * åĻææ¨į´æĨčŋčĄ Uvicornīŧåå¯äģĨäŊŋį¨`--host 0.0.0.0`å`--port 80`īŧčä¸æ¯`--bind 0.0.0.0:80`īŧGunicorn é饚īŧã
-
-
-å¨čžåēä¸īŧæ¨å¯äģĨįå°åŽæžį¤ēäēæ¯ä¸Ēčŋį¨į **PID**īŧčŋį¨ IDīŧīŧåŽåĒæ¯ä¸ä¸Ēæ°åīŧã
-
-äŊ å¯äģĨįå°īŧ
-
-* Gunicorn **čŋį¨įŽĄįå¨** äģĨ PID `19499` åŧ头īŧå¨æ¨įæ
åĩä¸īŧåŽå°æ¯ä¸ä¸Ēä¸åįæ°åīŧã
-* įļååŽåŧå§`Listening at: http://0.0.0.0:80`ã
-* įļååŽæŖæĩå°åŽåŋ
éĄģäŊŋį¨ `uvicorn.workers.UvicornWorker` å¤įworkerįąģã
-* įļååŽå¯å¨**4ä¸Ēworker**īŧæ¯ä¸ĒéŊæčĒåˇąįPIDīŧ`19511`ã`19513`ã`19514`å`19515`ã
-
-Gunicorn čŋå°č´č´ŖįŽĄį**æģčŋį¨**å**éæ°å¯å¨**æ°čŋį¨īŧåĻæéčĻäŋæworkeræ°éīŧã å æ¤īŧčŋå¨ä¸åŽį¨åēĻä¸æåŠäēä¸éĸå襨ä¸**éå¯**įæĻåŋĩã
-
-å°ŊįŽĄåĻæ¤īŧæ¨å¯čŊčŋå¸ææä¸äēå¤é¨įä¸čĨŋīŧäģĨįĄŽäŋå¨åŋ
čĻæļ**éæ°å¯å¨ Gunicorn**īŧåšļä¸**å¨å¯å¨æļčŋčĄåŽ**įã
+
INFO Uvicorn running on
http://0.0.0.0:8000 ( Press CTRL+C to
+ quit
)
+
INFO Started parent process
[ 27365 ]
+
INFO Started server process
[ 27368 ]
+
INFO Started server process
[ 27369 ]
+
INFO Started server process
[ 27370 ]
+
INFO Started server process
[ 27367 ]
+
INFO Waiting for application startup.
+
INFO Waiting for application startup.
+
INFO Waiting for application startup.
+
INFO Waiting for application startup.
+
INFO Application startup complete.
+
INFO Application startup complete.
+
INFO Application startup complete.
+
INFO Application startup complete.
+```
-## Uvicorn with Workers
+
@@ -151,13 +105,15 @@ $ uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4
+////
+
čŋéå¯ä¸įæ°ééĄšæ¯ `--workers` åč¯ Uvicorn å¯å¨ 4 ä¸ĒåˇĨäŊčŋį¨ã
-æ¨čŋå¯äģĨįå°åŽæžį¤ēäēæ¯ä¸Ēčŋį¨į **PID**īŧįļčŋį¨īŧčŋæ¯ **čŋį¨įŽĄįå¨**īŧį PID ä¸ē`27365`īŧæ¯ä¸ĒåˇĨäŊčŋį¨į PID ä¸ēīŧ`27368`ã`27369`īŧ `27370`å`27367`ã
+æ¨čŋå¯äģĨįå°åŽæžį¤ēäēæ¯ä¸Ēčŋį¨į **PID**īŧįļčŋį¨īŧčŋæ¯**čŋį¨įŽĄįå¨**īŧį PID ä¸ē`27365`īŧæ¯ä¸ĒåˇĨäŊčŋį¨į PID ä¸ēīŧ`27368`ã`27369`īŧ `27370`å`27367`ã
## é¨įŊ˛æĻåŋĩ
-å¨čŋéīŧæ¨äēč§ŖäēåĻäŊäŊŋį¨ **Gunicorn**īŧæ UvicornīŧįŽĄį **Uvicorn åˇĨäŊčŋį¨**æĨ**åšļčĄ**åēį¨į¨åēįæ§čĄīŧåŠį¨ CPU ä¸į **å¤æ ¸**īŧåšļ čŊå¤æģĄčļŗ**æ´å¤č¯ˇæą**ã
+å¨čŋéīŧæ¨åĻäš äēåĻäŊäŊŋį¨å¤ä¸Ē**åˇĨäŊčŋį¨īŧworkersīŧ**æĨ莊åēį¨į¨åēįæ§čĄ**åšļčĄå**īŧå
ååŠį¨ CPU į**å¤æ ¸æ§čŊ**īŧåšļčŊå¤å¤į**æ´å¤įč¯ˇæą**ã
äģä¸éĸįé¨įŊ˛æĻåŋĩå襨æĨįīŧäŊŋį¨workerä¸ģčĻæåŠäē**å¤åļ**é¨åīŧåšļ寚**éæ°å¯å¨**æä¸įšå¸ŽåŠīŧäŊæ¨äģįļéčĻį
§éĄžå
ļäģé¨åīŧ
@@ -170,15 +126,13 @@ $ uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4
## 厚å¨å Docker
-å¨å
ŗäē [厚å¨ä¸į FastAPI - Docker](docker.md){.internal-link target=_blank} įä¸ä¸įĢ ä¸īŧæå°äģįģä¸äēå¯į¨äēå¤įå
ļäģ **é¨įŊ˛æĻåŋĩ** įįįĨã
-
-æčŋå°åæ¨åąį¤ē **åŽæš Docker éå**īŧå
ļä¸å
æŦ **Gunicorn å Uvicorn worker** äģĨåä¸äē寚įŽåæ
åĩæį¨įéģ莤é
įŊŽã
+å¨å
ŗäē [厚å¨ä¸į FastAPI - Docker](docker.md){.internal-link target=_blank} įä¸ä¸įĢ ä¸īŧæå°äģįģä¸äēå¯į¨äēå¤įå
ļäģ**é¨įŊ˛æĻåŋĩ**įįįĨã
-å¨éŖéīŧæčŋå°åæ¨åąį¤ēåĻäŊ **äģ头åŧå§æåģēčĒåˇąįéå** äģĨčŋčĄåä¸Ē Uvicorn čŋį¨īŧæ˛Ąæ Gunicornīŧã čŋæ¯ä¸ä¸ĒįŽåįčŋį¨īŧåšļä¸å¯čŊæ¯æ¨å¨äŊŋį¨å **Kubernetes** čŋæ ˇįåå¸åŧ厚å¨įŽĄįįŗģįģæļæŗčĻåįäēæ
ã
+æå°åæ¨åąį¤ēåĻäŊ**äģéļåŧå§æåģēčĒåˇąįéå**īŧäģĨčŋčĄä¸ä¸ĒåįŦį Uvicorn čŋį¨ãčŋä¸Ēčŋį¨į¸å¯šįŽåīŧåšļä¸å¨äŊŋį¨ **Kubernetes** įåå¸åŧ厚å¨įŽĄįįŗģįģæļīŧčŋé常æ¯æ¨éčĻéåįæšæŗã
## å饞
-æ¨å¯äģĨäŊŋį¨**Gunicorn**īŧæUvicornīŧäŊä¸ēUvicornåˇĨäŊčŋį¨įčŋį¨įŽĄįå¨īŧäģĨåŠį¨**å¤æ ¸CPU**īŧ**åšļčĄčŋčĄå¤ä¸Ēčŋį¨**ã
+æ¨å¯äģĨå¨äŊŋį¨ `fastapi` æ `uvicorn` åŊäģ¤æļīŧéčŋ `--workers` CLI é饚å¯į¨å¤ä¸ĒåˇĨäŊčŋį¨īŧworkersīŧīŧäģĨå
ååŠį¨**å¤æ ¸ CPU**īŧäģĨ**åšļčĄčŋčĄå¤ä¸Ēčŋį¨**ã
åĻææ¨čĻ莞įŊŽ**čĒåˇąįé¨įŊ˛įŗģįģ**īŧåæļčĒåˇąå¤įå
ļäģé¨įŊ˛æĻåŋĩīŧåå¯äģĨäŊŋį¨čŋäēåˇĨå
ˇåæŗæŗã
diff --git a/docs/zh/docs/python-types.md b/docs/zh/docs/python-types.md
index 5126cb847..ba767da87 100644
--- a/docs/zh/docs/python-types.md
+++ b/docs/zh/docs/python-types.md
@@ -228,7 +228,7 @@ John Doe
## Pydantic æ¨Ąå
-Pydantic æ¯ä¸ä¸Ēį¨æĨį¨æĨæ§čĄæ°æŽæ ĄéĒį Python åēã
+Pydantic æ¯ä¸ä¸Ēį¨æĨæ§čĄæ°æŽæ ĄéĒį Python åēã
äŊ å¯äģĨå°æ°æŽį"įģæ"åŖ°æä¸ēå
ˇæåąæ§įįąģã
diff --git a/docs/zh/docs/tutorial/bigger-applications.md b/docs/zh/docs/tutorial/bigger-applications.md
index 318e10fd7..554bc654f 100644
--- a/docs/zh/docs/tutorial/bigger-applications.md
+++ b/docs/zh/docs/tutorial/bigger-applications.md
@@ -52,7 +52,7 @@ from app.routers import items
* čŋæä¸ä¸ĒåįŽåŊ `app/internal/` å
åĢåĻä¸ä¸Ē `__init__.py` æäģļīŧå æ¤åŽæ¯åä¸ä¸ĒãPython åå
ãīŧ`app.internal`ã
* `app/internal/admin.py` æ¯åĻä¸ä¸Ēåæ¨Ąåīŧ`app.internal.admin`ã
-
```console
-$ uvicorn main:app --reload
+$ fastapi dev main.py
-INFO : Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
-INFO : Started reloader process [28720]
-INFO : Started server process [28722]
-INFO : Waiting for application startup.
-INFO : Application startup complete.
-```
+ FastAPI
+ Searching for package file structure from directories
+ with __init__.py files
+ Importing from /home/user/code/ awesomeapp
-/// note
+ module code from main import app app main:app
+
+ server http://127.0.0.1:8000 server http://127.0.0.1:8000/docs tip fastapi run
+
+ Logs:
+
+ INFO [ '/home/user/code/awesomeapp' ]
+ INFO http://127.0.0.1:8000 ( Press CTRL+C
+ to quit)
+ INFO [ 383138 ] using WatchFiles
+ INFO [ 383153 ]
+ INFO INFO http://127.0.0.1:8000/redoc ã
-äŊ å°äŧįå°å¯éįčĒå¨įæææĄŖ īŧįą ReDoc æäž)īŧ
+äŊ å°äŧįå°å¯éįčĒå¨įæææĄŖ īŧįą ReDoc æäžīŧīŧ
@@ -77,9 +92,9 @@ INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
#### APIãæ¨Ąåŧã
-å¨čŋį§åēæ¯ä¸īŧOpenAPI æ¯ä¸į§č§åŽåĻäŊåŽäš API æ¨Ąåŧįč§čã
+å¨čŋį§åēæ¯ä¸īŧOpenAPI æ¯ä¸į§č§åŽåĻäŊåŽäš API æ¨Ąåŧįč§čã
-åŽäšį OpenAPI æ¨Ąåŧå°å
æŦäŊ į API čˇ¯åžīŧäģĨååŽäģŦå¯čŊäŊŋį¨įåæ°įįã
+ãæ¨ĄåŧãįåŽäšå
æŦäŊ į API čˇ¯åžīŧäģĨååŽäģŦå¯čŊäŊŋį¨įåæ°įįã
#### æ°æŽãæ¨Ąåŧã
@@ -93,7 +108,7 @@ OpenAPI ä¸ēäŊ į API åŽäš API æ¨Ąåŧãč¯Ĩæ¨Ąåŧä¸å
åĢäēäŊ į API åé
#### æĨį `openapi.json`
-åĻæäŊ 寚åå§į OpenAPI æ¨Ąåŧéŋäģäšæ ˇåæå°åĨŊåĨīŧå
ļåŽåŽåĒæ¯ä¸ä¸ĒčĒå¨įæįå
åĢäēææ API æčŋ°į JSONã
+åĻæäŊ 寚åå§į OpenAPI æ¨Ąåŧéŋäģäšæ ˇåæå°åĨŊåĨīŧFastAPI čĒå¨įæäēå
åĢææ API æčŋ°į JSONīŧæ¨Ąåŧīŧã
äŊ å¯äģĨį´æĨå¨īŧhttp://127.0.0.1:8000/openapi.json įå°åŽã
@@ -101,7 +116,7 @@ OpenAPI ä¸ēäŊ į API åŽäš API æ¨Ąåŧãč¯Ĩæ¨Ąåŧä¸å
åĢäēäŊ į API åé
```JSON
{
- "openapi": "3.0.2",
+ "openapi": "3.1.0",
"info": {
"title": "FastAPI",
"version": "0.1.0"
@@ -140,7 +155,7 @@ OpenAPI ä¸ēäŊ į API åŽäš API æ¨Ąåŧãč¯Ĩæ¨Ąåŧä¸å
åĢäēäŊ į API åé
`FastAPI` æ¯į´æĨäģ `Starlette` įģ§æŋįįąģã
-äŊ å¯äģĨéčŋ `FastAPI` äŊŋį¨ææį Starlette įåčŊã
+äŊ å¯äģĨéčŋ `FastAPI` äŊŋį¨ææį Starlette įåčŊã
///
@@ -152,34 +167,6 @@ OpenAPI ä¸ēäŊ į API åŽäš API æ¨Ąåŧãč¯Ĩæ¨Ąåŧä¸å
åĢäēäŊ į API åé
čŋä¸ĒåŽäžå°æ¯ååģēäŊ ææ API įä¸ģčĻäē¤äēå¯ščąĄã
-čŋä¸Ē `app` åæ ˇå¨åĻä¸åŊäģ¤ä¸čĸĢ `uvicorn` æåŧį¨īŧ
-
-
-
-```console
-$ uvicorn main:app --reload
-
-INFO : Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
-```
-
-
-
-åĻæäŊ åä¸éĸčŋæ ˇååģēåēį¨īŧ
-
-{* ../../docs_src/first_steps/tutorial002.py hl[3] *}
-
-å°äģŖį æžå
Ĩ `main.py` æäģļä¸īŧįļåäŊ å¯äģĨåä¸éĸčŋæ ˇčŋčĄ `uvicorn`īŧ
-
-
-
-```console
-$ uvicorn main:my_awesome_api --reload
-
-INFO : Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
-```
-
-
-
### æĨéĒ¤ 3īŧååģēä¸ä¸Ē*čˇ¯åžæäŊ*
#### čˇ¯åž
@@ -279,13 +266,13 @@ https://example.com/items/foo
/// tip
-æ¨å¯äģĨéæäŊŋį¨äģģäŊä¸ä¸ĒæäŊīŧHTTPæšæŗīŧã
+äŊ å¯äģĨéæäŊŋį¨äģģäŊä¸ä¸ĒæäŊīŧHTTPæšæŗīŧã
**FastAPI** æ˛ĄæåŧēåļčĻæąæäŊæäģģäŊįšåŽįåĢäšã
æ¤å¤æäžįäŋĄæ¯äģ
äŊä¸ēæå¯ŧīŧčä¸æ¯čĻæąã
-æ¯åĻīŧåŊäŊŋį¨ GraphQL æļé常äŊ ææįå¨äŊéŊéčŋ `post` ä¸į§æšæŗæ§čĄã
+æ¯åĻīŧåŊäŊŋį¨ GraphQL æļé常äŊ ææįå¨äŊéŊéčŋ `POST` ä¸į§æšæŗæ§čĄã
///
@@ -331,6 +318,6 @@ https://example.com/items/foo
* å¯ŧå
Ĩ `FastAPI`ã
* ååģēä¸ä¸Ē `app` åŽäžã
-* įŧåä¸ä¸Ē**čˇ¯åžæäŊčŖ
éĨ°å¨**īŧåĻ `@app.get("/")`īŧã
-* įŧåä¸ä¸Ē**čˇ¯åžæäŊåŊæ°**īŧåĻä¸éĸį `def root(): ...`īŧã
-* čŋčĄåŧåæåĄå¨īŧåĻ `uvicorn main:app --reload`īŧã
+* įŧåä¸ä¸Ē**čˇ¯åžæäŊčŖ
éĨ°å¨**īŧåĻ `@app.get("/")`ã
+* åŽäšä¸ä¸Ē**čˇ¯åžæäŊåŊæ°**īŧåĻ `def root(): ...`ã
+* äŊŋį¨åŊäģ¤ `fastapi dev` čŋčĄåŧåæåĄå¨ã
diff --git a/docs/zh/docs/tutorial/index.md b/docs/zh/docs/tutorial/index.md
index ab19f02c5..3ca927337 100644
--- a/docs/zh/docs/tutorial/index.md
+++ b/docs/zh/docs/tutorial/index.md
@@ -1,34 +1,58 @@
# æį¨ - į¨æˇæå
-æŦæį¨å°ä¸æĨæĨåäŊ åąį¤ēåĻäŊäŊŋį¨ **FastAPI** įįģ大é¨åįšæ§ã
+æŦæį¨å°ä¸æĨæĨåæ¨åąį¤ēåĻäŊäŊŋį¨ **FastAPI** įįģ大é¨åįšæ§ã
-åä¸ĒįĢ čįå
厚åžĒåēæ¸čŋīŧäŊæ¯åå´įģįåįŦįä¸ģéĸīŧæäģĨäŊ å¯äģĨį´æĨčˇŗčŊŦå°æä¸ĒįĢ čäģĨč§ŖåŗäŊ įįšåŽéæąã
+åä¸ĒįĢ čįå
厚åžĒåēæ¸čŋīŧäŊæ¯åå´įģįåįŦįä¸ģéĸīŧæäģĨæ¨å¯äģĨį´æĨčˇŗčŊŦå°æä¸ĒįĢ čäģĨč§Ŗåŗæ¨įįšåŽéæąã
-æŦæį¨åæ ˇå¯äģĨäŊä¸ēå°æĨįåčæåã
-
-äŊ å¯äģĨéæļåå°æŦæį¨åšļæĨé
äŊ éčĻįå
厚ã
+æŦæį¨åæ ˇå¯äģĨäŊä¸ēå°æĨįåčæåīŧæäģĨæ¨å¯äģĨéæļåå°æŦæį¨åšļæĨé
æ¨éčĻįå
厚ã
## čŋčĄäģŖį
ææäģŖį įæŽĩéŊå¯äģĨå¤åļåį´æĨäŊŋį¨īŧåŽäģŦåŽé
ä¸æ¯įģčŋæĩč¯į Python æäģļīŧã
-čĻčŋčĄäģģäŊį¤ēäžīŧč¯ˇå°äģŖį å¤åļå° `main.py` æäģļä¸īŧįļåäŊŋį¨äģĨä¸åŊäģ¤å¯å¨ `uvicorn`īŧ
+čĻčŋčĄäģģäŊį¤ēäžīŧč¯ˇå°äģŖį å¤åļå° `main.py` æäģļä¸īŧįļåäŊŋį¨äģĨä¸åŊäģ¤å¯å¨ `fastapi dev`īŧ
```console
-$ uvicorn main:app --reload
+$ fastapi dev main.py
+
+ FastAPI __init__.py files
+ Importing from /home/user/code/ awesomeapp
+
+ module code from main import app app main:app
+
+ server http://127.0.0.1:8000 server http://127.0.0.1:8000/docs tip fastapi run
+
+ Logs:
-INFO : Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
-INFO : Started reloader process [28720]
-INFO : Started server process [28722]
-INFO : Waiting for application startup.
-INFO : Application startup complete.
+ INFO [ '/home/user/code/awesomeapp' ]
+ INFO http://127.0.0.1:8000 ( Press CTRL+C
+ to quit)
+ INFO [ 383138 ] using WatchFiles
+ INFO [ 383153 ]
+ INFO INFO
-åŧēįåģē莎äŊ å¨æŦå°įŧåæå¤åļäģŖį īŧ寚å
ļčŋčĄįŧčžåšļčŋčĄã
+**åŧēįåģē莎**æ¨å¨æŦå°įŧåæå¤åļäģŖį īŧ寚å
ļčŋčĄįŧčžåšļčŋčĄã
å¨įŧčžå¨ä¸äŊŋį¨ FastAPI äŧįæŖå°åąį°åēåŽįäŧåŋīŧåĒéčĻįŧååžå°įäģŖį īŧææįįąģåæŖæĨīŧäģŖį čĄĨå
¨įįã
@@ -36,48 +60,34 @@ $ uvicorn main:app --reload
## åŽčŖ
FastAPI
-įŦŦä¸ä¸ĒæĨéĒ¤æ¯åŽčŖ
FastAPIã
+įŦŦä¸ä¸ĒæĨéĒ¤æ¯åŽčŖ
FastAPI.
-ä¸ēäēäŊŋį¨æŦæį¨īŧäŊ å¯čŊéčĻåŽčŖ
ææįå¯éäžčĩå寚åēåčŊīŧ
+č¯ˇįĄŽäŋæ¨ååģēåšļæŋæ´ģä¸ä¸Ē[čæį¯åĸ](../virtual-environments.md){.internal-link target=_blank}īŧįļå**åŽčŖ
FastAPI**īŧ
```console
-$ pip install "fastapi[all]"
+$ pip install "fastapi[standard]"
---> 100%
```
-......äģĨä¸åŽčŖ
čŋå
æŦäē `uvicorn`īŧäŊ å¯äģĨå°å
ļį¨äŊčŋčĄäģŖį įæåĄå¨ã
-
/// note
-äŊ äšå¯äģĨååŧæĨåŽčŖ
ã
-
-ååĻäŊ æŗå°åēį¨į¨åēé¨įŊ˛å°įäē§į¯åĸīŧäŊ å¯čŊčĻæ§čĄäģĨä¸æäŊīŧ
-
-```
-pip install fastapi
-```
-
-åšļä¸åŽčŖ
`uvicorn`æĨäŊä¸ēæåĄå¨īŧ
-
-```
-pip install "uvicorn[standard]"
-```
+åŊæ¨äŊŋį¨ `pip install "fastapi[standard]"` čŋčĄåŽčŖ
æļīŧåŽäŧéå¸Ļä¸äēéģ莤įå¯éæ åäžčĩ饚ã
-įļå寚äŊ æŗäŊŋį¨įæ¯ä¸Ēå¯éäžčĩ饚äšæ§čĄį¸åįæäŊã
+åĻææ¨ä¸æŗåŽčŖ
čŋäēå¯éäžčĩīŧå¯äģĨéæŠåŽčŖ
`pip install fastapi`ã
///
## čŋéļį¨æˇæå
-å¨æŦ**æį¨-į¨æˇæå**äšåīŧäŊ å¯äģĨé
č¯ģ**čŋéļį¨æˇæå**ã
+å¨æŦ**æį¨-į¨æˇæå**äšåīŧæ¨å¯äģĨé
č¯ģ**čŋéļį¨æˇæå**ã
**čŋéļį¨æˇæå**äģĨæŦæį¨ä¸ēåēįĄīŧäŊŋį¨į¸åįæĻåŋĩīŧåšļææä¸äēéĸå¤įįšæ§ã
-äŊæ¯äŊ åēč¯Ĩå
é
č¯ģ**æį¨-į¨æˇæå**īŧåŗäŊ į°å¨æŖå¨é
č¯ģįå
厚īŧã
+äŊæ¯æ¨åēč¯Ĩå
é
č¯ģ**æį¨-į¨æˇæå**īŧåŗæ¨į°å¨æŖå¨é
č¯ģįå
厚īŧã
-æį¨įģčŋį˛žåŋ莞莥īŧäŊŋäŊ å¯äģĨäģ
éčŋ**æį¨-į¨æˇæå**æĨåŧåä¸ä¸ĒåŽæ´įåēį¨į¨åēīŧįļåæ šæŽäŊ įéčĻīŧäŊŋį¨**čŋéļį¨æˇæå**ä¸įä¸äēå
ļäģæĻåŋĩīŧäģĨä¸åįæšåŧæĨæŠåąåŽã
+æį¨įģčŋį˛žåŋ莞莥īŧäŊŋæ¨å¯äģĨäģ
éčŋ**æį¨-į¨æˇæå**æĨåŧåä¸ä¸ĒåŽæ´įåēį¨į¨åēīŧįļåæ šæŽæ¨įéčĻīŧäŊŋį¨**čŋéļį¨æˇæå**ä¸įä¸äēå
ļäģæĻåŋĩīŧäģĨä¸åįæšåŧæĨæŠåąåŽã
diff --git a/docs_src/custom_docs_ui/tutorial001.py b/docs_src/custom_docs_ui/tutorial001.py
index f7ceb0c2f..1cfcce19a 100644
--- a/docs_src/custom_docs_ui/tutorial001.py
+++ b/docs_src/custom_docs_ui/tutorial001.py
@@ -29,7 +29,7 @@ async def redoc_html():
return get_redoc_html(
openapi_url=app.openapi_url,
title=app.title + " - ReDoc",
- redoc_js_url="https://unpkg.com/redoc@next/bundles/redoc.standalone.js",
+ redoc_js_url="https://unpkg.com/redoc@2/bundles/redoc.standalone.js",
)
diff --git a/docs_src/header_param_models/tutorial003.py b/docs_src/header_param_models/tutorial003.py
new file mode 100644
index 000000000..dc2eb74bd
--- /dev/null
+++ b/docs_src/header_param_models/tutorial003.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(convert_underscores=False)):
+ return headers
diff --git a/docs_src/header_param_models/tutorial003_an.py b/docs_src/header_param_models/tutorial003_an.py
new file mode 100644
index 000000000..e3edb1189
--- /dev/null
+++ b/docs_src/header_param_models/tutorial003_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):
+ 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(convert_underscores=False)],
+):
+ return headers
diff --git a/docs_src/header_param_models/tutorial003_an_py310.py b/docs_src/header_param_models/tutorial003_an_py310.py
new file mode 100644
index 000000000..07bfa83bf
--- /dev/null
+++ b/docs_src/header_param_models/tutorial003_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):
+ 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(convert_underscores=False)],
+):
+ return headers
diff --git a/docs_src/header_param_models/tutorial003_an_py39.py b/docs_src/header_param_models/tutorial003_an_py39.py
new file mode 100644
index 000000000..8be6b01d0
--- /dev/null
+++ b/docs_src/header_param_models/tutorial003_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):
+ 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(convert_underscores=False)],
+):
+ return headers
diff --git a/docs_src/header_param_models/tutorial003_py310.py b/docs_src/header_param_models/tutorial003_py310.py
new file mode 100644
index 000000000..65e92a28c
--- /dev/null
+++ b/docs_src/header_param_models/tutorial003_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(convert_underscores=False)):
+ return headers
diff --git a/docs_src/header_param_models/tutorial003_py39.py b/docs_src/header_param_models/tutorial003_py39.py
new file mode 100644
index 000000000..848c34111
--- /dev/null
+++ b/docs_src/header_param_models/tutorial003_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(convert_underscores=False)):
+ return headers
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 757b76106..b02bf8b4f 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.115.11"
+__version__ = "0.116.1"
from starlette import status as status
diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index c07e4a3b0..227ad837d 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -16,6 +16,7 @@ from typing import (
Tuple,
Type,
Union,
+ cast,
)
from fastapi.exceptions import RequestErrorModel
@@ -231,6 +232,10 @@ if PYDANTIC_V2:
field_mapping, definitions = schema_generator.generate_definitions(
inputs=inputs
)
+ for item_def in cast(Dict[str, Dict[str, Any]], definitions).values():
+ if "description" in item_def:
+ item_description = cast(str, item_def["description"]).split("\f")[0]
+ item_def["description"] = item_description
return field_mapping, definitions # type: ignore[return-value]
def is_scalar_field(field: ModelField) -> bool:
diff --git a/fastapi/applications.py b/fastapi/applications.py
index 6d427cdc2..05c7bd2be 100644
--- a/fastapi/applications.py
+++ b/fastapi/applications.py
@@ -748,7 +748,7 @@ class FastAPI(Starlette):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -1720,7 +1720,7 @@ class FastAPI(Starlette):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -2093,7 +2093,7 @@ class FastAPI(Starlette):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -2471,7 +2471,7 @@ class FastAPI(Starlette):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -2849,7 +2849,7 @@ class FastAPI(Starlette):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -3222,7 +3222,7 @@ class FastAPI(Starlette):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -3595,7 +3595,7 @@ class FastAPI(Starlette):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -3968,7 +3968,7 @@ class FastAPI(Starlette):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -4346,7 +4346,7 @@ class FastAPI(Starlette):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -4425,7 +4425,7 @@ class FastAPI(Starlette):
app = FastAPI()
- @app.put("/items/{item_id}")
+ @app.trace("/items/{item_id}")
def trace_item(item_id: str):
return None
```
@@ -4515,14 +4515,17 @@ class FastAPI(Starlette):
```python
import time
+ from typing import Awaitable, Callable
- from fastapi import FastAPI, Request
+ from fastapi import FastAPI, Request, Response
app = FastAPI()
@app.middleware("http")
- async def add_process_time_header(request: Request, call_next):
+ async def add_process_time_header(
+ request: Request, call_next: Callable[[Request], Awaitable[Response]]
+ ) -> Response:
start_time = time.time()
response = await call_next(request)
process_time = time.time() - start_time
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index cf8f88e1c..5ce40b7c6 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -780,9 +780,15 @@ def request_params_to_args(
first_field = fields[0]
fields_to_extract = fields
single_not_embedded_field = False
+ default_convert_underscores = True
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
+ # If headers are in a Pydantic model, the way to disable convert_underscores
+ # would be with Header(convert_underscores=False) at the Pydantic model level
+ default_convert_underscores = getattr(
+ first_field.field_info, "convert_underscores", True
+ )
params_to_process: Dict[str, Any] = {}
@@ -793,7 +799,9 @@ def request_params_to_args(
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)
+ convert_underscores = getattr(
+ field.field_info, "convert_underscores", default_convert_underscores
+ )
if convert_underscores:
alias = (
field.alias
@@ -838,6 +846,25 @@ def request_params_to_args(
return values, errors
+def is_union_of_base_models(field_type: Any) -> bool:
+ """Check if field type is a Union where all members are BaseModel subclasses."""
+ from fastapi.types import UnionType
+
+ origin = get_origin(field_type)
+
+ # Check if it's a Union type (covers both typing.Union and types.UnionType in Python 3.10+)
+ if origin is not Union and origin is not UnionType:
+ return False
+
+ union_args = get_args(field_type)
+
+ for arg in union_args:
+ if not lenient_issubclass(arg, BaseModel):
+ return False
+
+ return True
+
+
def _should_embed_body_fields(fields: List[ModelField]) -> bool:
if not fields:
return False
@@ -851,10 +878,12 @@ def _should_embed_body_fields(fields: List[ModelField]) -> bool:
# 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
+ # If it's a Form (or File) field, it has to be a BaseModel (or a union of BaseModels) 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)
+ and not lenient_issubclass(first_field.type_, BaseModel)
+ and not is_union_of_base_models(first_field.type_)
):
return True
return False
diff --git a/fastapi/openapi/docs.py b/fastapi/openapi/docs.py
index c2ec358d2..f181b43c1 100644
--- a/fastapi/openapi/docs.py
+++ b/fastapi/openapi/docs.py
@@ -188,7 +188,7 @@ def get_redoc_html(
It is normally set to a CDN URL.
"""
),
- ] = "https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js",
+ ] = "https://cdn.jsdelivr.net/npm/redoc@2/bundles/redoc.standalone.js",
redoc_favicon_url: Annotated[
str,
Doc(
diff --git a/fastapi/openapi/utils.py b/fastapi/openapi/utils.py
index bd8f3c106..808646cc2 100644
--- a/fastapi/openapi/utils.py
+++ b/fastapi/openapi/utils.py
@@ -32,6 +32,7 @@ from fastapi.utils import (
generate_operation_id_for_path,
is_body_allowed_for_status_code,
)
+from pydantic import BaseModel
from starlette.responses import JSONResponse
from starlette.routing import BaseRoute
from starlette.status import HTTP_422_UNPROCESSABLE_ENTITY
@@ -113,6 +114,13 @@ def _get_openapi_operation_parameters(
(ParamTypes.header, header_params),
(ParamTypes.cookie, cookie_params),
]
+ default_convert_underscores = True
+ if len(flat_dependant.header_params) == 1:
+ first_field = flat_dependant.header_params[0]
+ if lenient_issubclass(first_field.type_, BaseModel):
+ default_convert_underscores = getattr(
+ first_field.field_info, "convert_underscores", True
+ )
for param_type, param_group in parameter_groups:
for param in param_group:
field_info = param.field_info
@@ -126,8 +134,21 @@ def _get_openapi_operation_parameters(
field_mapping=field_mapping,
separate_input_output_schemas=separate_input_output_schemas,
)
+ name = param.alias
+ convert_underscores = getattr(
+ param.field_info,
+ "convert_underscores",
+ default_convert_underscores,
+ )
+ if (
+ param_type == ParamTypes.header
+ and param.alias == param.name
+ and convert_underscores
+ ):
+ name = param.name.replace("_", "-")
+
parameter = {
- "name": param.alias,
+ "name": name,
"in": param_type.value,
"required": param.required,
"schema": param_schema,
diff --git a/fastapi/routing.py b/fastapi/routing.py
index 80d22cc3b..aa6658c5c 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -9,6 +9,7 @@ from typing import (
Any,
AsyncIterator,
Callable,
+ Collection,
Coroutine,
Dict,
List,
@@ -814,7 +815,7 @@ class APIRouter(routing.Router):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -862,7 +863,7 @@ class APIRouter(routing.Router):
def route(
self,
path: str,
- methods: Optional[List[str]] = None,
+ methods: Optional[Collection[str]] = None,
name: Optional[str] = None,
include_in_schema: bool = True,
) -> Callable[[DecoratedCallable], DecoratedCallable]:
@@ -1626,7 +1627,7 @@ class APIRouter(routing.Router):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -2003,7 +2004,7 @@ class APIRouter(routing.Router):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -2385,7 +2386,7 @@ class APIRouter(routing.Router):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -2767,7 +2768,7 @@ class APIRouter(routing.Router):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -3144,7 +3145,7 @@ class APIRouter(routing.Router):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -3521,7 +3522,7 @@ class APIRouter(routing.Router):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -3903,7 +3904,7 @@ class APIRouter(routing.Router):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
@@ -4285,7 +4286,7 @@ class APIRouter(routing.Router):
This affects the generated OpenAPI (e.g. visible at `/docs`).
Read more about it in the
- [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+ [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-parameters-from-openapi).
"""
),
] = True,
diff --git a/fastapi/security/oauth2.py b/fastapi/security/oauth2.py
index 5ffad5986..88e394db1 100644
--- a/fastapi/security/oauth2.py
+++ b/fastapi/security/oauth2.py
@@ -85,7 +85,7 @@ class OAuth2PasswordRequestForm:
],
password: Annotated[
str,
- Form(),
+ Form(json_schema_extra={"format": "password"}),
Doc(
"""
`password` string. The OAuth2 spec requires the exact field name
@@ -130,7 +130,7 @@ class OAuth2PasswordRequestForm:
] = None,
client_secret: Annotated[
Union[str, None],
- Form(),
+ Form(json_schema_extra={"format": "password"}),
Doc(
"""
If there's a `client_password` (and a `client_id`), they can be sent
@@ -457,11 +457,26 @@ class OAuth2PasswordBearer(OAuth2):
"""
),
] = True,
+ refreshUrl: Annotated[
+ Optional[str],
+ Doc(
+ """
+ The URL to refresh the token and obtain a new one.
+ """
+ ),
+ ] = None,
):
if not scopes:
scopes = {}
flows = OAuthFlowsModel(
- password=cast(Any, {"tokenUrl": tokenUrl, "scopes": scopes})
+ password=cast(
+ Any,
+ {
+ "tokenUrl": tokenUrl,
+ "refreshUrl": refreshUrl,
+ "scopes": scopes,
+ },
+ )
)
super().__init__(
flows=flows,
diff --git a/pyproject.toml b/pyproject.toml
index 1c540e2f6..7709451ff 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -43,7 +43,7 @@ classifiers = [
"Topic :: Internet :: WWW/HTTP",
]
dependencies = [
- "starlette>=0.40.0,<0.47.0",
+ "starlette>=0.40.0,<0.48.0",
"pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0",
"typing-extensions>=4.8.0",
]
@@ -58,7 +58,26 @@ Changelog = "https://fastapi.tiangolo.com/release-notes/"
[project.optional-dependencies]
standard = [
- "fastapi-cli[standard] >=0.0.5",
+ "fastapi-cli[standard] >=0.0.8",
+ # For the test client
+ "httpx >=0.23.0",
+ # For templates
+ "jinja2 >=3.1.5",
+ # For forms and file uploads
+ "python-multipart >=0.0.18",
+ # To validate email fields
+ "email-validator >=2.0.0",
+ # Uvicorn with uvloop
+ "uvicorn[standard] >=0.12.0",
+ # TODO: this should be part of some pydantic optional extra dependencies
+ # # Settings management
+ # "pydantic-settings >=2.0.0",
+ # # Extra Pydantic data types
+ # "pydantic-extra-types >=2.0.0",
+]
+
+standard-no-fastapi-cloud-cli = [
+ "fastapi-cli[standard-no-fastapi-cloud-cli] >=0.0.8",
# For the test client
"httpx >=0.23.0",
# For templates
@@ -77,7 +96,7 @@ standard = [
]
all = [
- "fastapi-cli[standard] >=0.0.5",
+ "fastapi-cli[standard] >=0.0.8",
# # For the test client
"httpx >=0.23.0",
# For templates
diff --git a/requirements-docs-tests.txt b/requirements-docs-tests.txt
index e7718e61d..e7684a2e3 100644
--- a/requirements-docs-tests.txt
+++ b/requirements-docs-tests.txt
@@ -1,4 +1,4 @@
# For mkdocstrings and tests
-httpx >=0.23.0,<0.28.0
+httpx >=0.23.0,<0.29.0
# For linting and generating docs versions
-ruff ==0.9.4
+ruff ==0.11.2
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 8812e27f9..5c5701f73 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -1,18 +1,18 @@
-e .
-r requirements-docs-tests.txt
-mkdocs-material==9.6.1
+mkdocs-material==9.6.15
mdx-include >=1.4.1,<2.0.0
mkdocs-redirects>=1.2.1,<1.3.0
-typer == 0.12.5
+typer == 0.16.0
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==11.1.0
+pillow==11.3.0
# For image processing by Material for MkDocs
cairosvg==2.7.1
mkdocstrings[python]==0.26.1
-griffe-typingdoc==0.2.7
+griffe-typingdoc==0.2.8
# For griffe, it formats with black
black==25.1.0
mkdocs-macros-plugin==1.3.7
diff --git a/requirements-github-actions.txt b/requirements-github-actions.txt
index 920aefea6..f807d06a8 100644
--- a/requirements-github-actions.txt
+++ b/requirements-github-actions.txt
@@ -1,6 +1,6 @@
PyGithub>=2.3.0,<3.0.0
pydantic>=2.5.3,<3.0.0
pydantic-settings>=2.1.0,<3.0.0
-httpx>=0.27.0,<0.28.0
+httpx>=0.27.0,<0.29.0
pyyaml >=5.3.1,<7.0.0
smokeshow
diff --git a/requirements-tests.txt b/requirements-tests.txt
index 6a870add6..b9f2b2b66 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -3,14 +3,14 @@
pytest >=7.1.3,<9.0.0
coverage[toml] >= 6.5.0,< 8.0
mypy ==1.8.0
-dirty-equals ==0.8.0
-sqlmodel==0.0.23
+dirty-equals ==0.9.0
+sqlmodel==0.0.24
flask >=1.1.2,<4.0.0
anyio[trio] >=3.2.1,<5.0.0
PyJWT==2.8.0
pyyaml >=5.3.1,<7.0.0
passlib[bcrypt] >=1.7.2,<2.0.0
-inline-snapshot==0.19.3
+inline-snapshot>=0.21.1
# types
types-ujson ==5.10.0.20240515
types-orjson ==3.6.2
diff --git a/requirements-translations.txt b/requirements-translations.txt
index a8f8a02d7..90f718032 100644
--- a/requirements-translations.txt
+++ b/requirements-translations.txt
@@ -1 +1,2 @@
-pydantic-ai==0.0.15
+pydantic-ai==0.0.30
+GitPython==3.1.45
diff --git a/scripts/label_approved.py b/scripts/label_approved.py
index 271444504..81de92efb 100644
--- a/scripts/label_approved.py
+++ b/scripts/label_approved.py
@@ -27,7 +27,7 @@ if settings.debug:
logging.basicConfig(level=logging.DEBUG)
else:
logging.basicConfig(level=logging.INFO)
-logging.debug(f"Using config: {settings.json()}")
+logging.debug(f"Using config: {settings.model_dump_json()}")
g = Github(settings.token.get_secret_value())
repo = g.get_repo(settings.github_repository)
for pr in repo.get_pulls(state="open"):
@@ -48,7 +48,7 @@ for pr in repo.get_pulls(state="open"):
]
config = settings.config or default_config
for approved_label, conf in config.items():
- logging.debug(f"Processing config: {conf.json()}")
+ logging.debug(f"Processing config: {conf.model_dump_json()}")
if conf.await_label is None or (conf.await_label in pr_label_by_name):
logging.debug(f"Processable PR: {pr.number}")
if len(approved_reviews) >= conf.number:
diff --git a/scripts/people.py b/scripts/people.py
index f61fd31c9..7418b4595 100644
--- a/scripts/people.py
+++ b/scripts/people.py
@@ -119,6 +119,7 @@ class Settings(BaseSettings):
github_token: SecretStr
github_repository: str
httpx_timeout: int = 30
+ sleep_interval: int = 5
def get_graphql_response(
@@ -184,7 +185,7 @@ def get_discussion_nodes(settings: Settings) -> list[DiscussionsNode]:
discussion_nodes.append(discussion_edge.node)
last_edge = discussion_edges[-1]
# Handle GitHub secondary rate limits, requests per minute
- time.sleep(5)
+ time.sleep(settings.sleep_interval)
discussion_edges = get_graphql_question_discussion_edges(
settings=settings, after=last_edge.cursor
)
diff --git a/scripts/translate.py b/scripts/translate.py
index 9a2136d1b..b78d7211b 100644
--- a/scripts/translate.py
+++ b/scripts/translate.py
@@ -2,9 +2,11 @@ from functools import lru_cache
from pathlib import Path
from typing import Iterable
+import git
import typer
import yaml
from pydantic_ai import Agent
+from rich import print
non_translated_sections = (
"reference/",
@@ -28,8 +30,38 @@ The content is written in markdown, write the translation in markdown as well. D
When there's an example of code, the console or a terminal, normally surrounded by triple backticks and a keyword like "console" or "bash" (e.g. ```console), do not translate the content, keep the original in English.
The original content will be surrounded by triple percentage signs (%) and you should translate it to the target language. Do not include the triple percentage signs in the translation.
+
+There are special blocks of notes, tips and others that look like:
+
+/// note
+
+To translate it, keep the same line and add the translation after a vertical bar.
+
+For example, if you were translating to Spanish, you would write:
+
+/// note | Nota
+
+Some examples in Spanish:
+
+Source:
+
+/// tip
+
+Result:
+
+/// tip | Consejo
+
+Source:
+
+/// details | Preview
+
+Result:
+
+/// details | Vista previa
"""
+app = typer.Typer()
+
@lru_cache
def get_langs() -> dict[str, str]:
@@ -46,6 +78,17 @@ def generate_lang_path(*, lang: str, path: Path) -> Path:
return out_path
+def generate_en_path(*, lang: str, path: Path) -> Path:
+ en_docs_path = Path("docs/en/docs")
+ assert not str(path).startswith(str(en_docs_path)), (
+ f"Path must not be inside {en_docs_path}"
+ )
+ lang_docs_path = Path(f"docs/{lang}/docs")
+ out_path = Path(str(path).replace(str(lang_docs_path), str(en_docs_path)))
+ return out_path
+
+
+@app.command()
def translate_page(*, lang: str, path: Path) -> None:
langs = get_langs()
language = langs[lang]
@@ -64,12 +107,14 @@ def translate_page(*, lang: str, path: Path) -> None:
original_content = path.read_text()
old_translation: str | None = None
if out_path.exists():
+ print(f"Found existing translation: {out_path}")
old_translation = out_path.read_text()
+ print(f"Translating {path} to {lang} ({language})")
agent = Agent("openai:gpt-4o")
prompt_segments = [
- lang_prompt_content,
general_prompt,
+ lang_prompt_content,
]
if old_translation:
prompt_segments.extend(
@@ -89,13 +134,14 @@ def translate_page(*, lang: str, path: Path) -> None:
]
)
prompt = "\n\n".join(prompt_segments)
-
+ print(f"Running agent for {out_path}")
result = agent.run_sync(prompt)
out_content = f"{result.data.strip()}\n"
+ print(f"Saving translation to {out_path}")
out_path.write_text(out_content)
-def iter_paths_to_translate() -> Iterable[Path]:
+def iter_all_en_paths() -> Iterable[Path]:
"""
Iterate on the markdown files to translate in order of priority.
"""
@@ -119,12 +165,16 @@ def iter_paths_to_translate() -> Iterable[Path]:
yield path
-def translate_all(lang: str) -> None:
- paths_to_process: list[Path] = []
- for path in iter_paths_to_translate():
+def iter_en_paths_to_translate() -> Iterable[Path]:
+ for path in iter_all_en_paths():
if str(path).replace("docs/en/docs/", "").startswith(non_translated_sections):
continue
- paths_to_process.append(path)
+ yield path
+
+
+@app.command()
+def translate_all(lang: str) -> None:
+ paths_to_process = list(iter_en_paths_to_translate())
print("Original paths:")
for p in paths_to_process:
print(f" - {p}")
@@ -151,12 +201,82 @@ def translate_all(lang: str) -> None:
print(f"Done translating: {p}")
-def main(*, lang: str, path: Path = None) -> None:
- if path:
+@app.command()
+def list_removable(lang: str) -> list[Path]:
+ removable_paths: list[Path] = []
+ lang_paths = Path(f"docs/{lang}").rglob("*.md")
+ for path in lang_paths:
+ en_path = generate_en_path(lang=lang, path=path)
+ if not en_path.exists():
+ removable_paths.append(path)
+ print(removable_paths)
+ return removable_paths
+
+
+@app.command()
+def list_all_removable() -> list[Path]:
+ all_removable_paths: list[Path] = []
+ langs = get_langs()
+ for lang in langs:
+ if lang == "en":
+ continue
+ removable_paths = list_removable(lang)
+ all_removable_paths.extend(removable_paths)
+ print(all_removable_paths)
+ return all_removable_paths
+
+
+@app.command()
+def remove_removable(lang: str) -> None:
+ removable_paths = list_removable(lang)
+ for path in removable_paths:
+ path.unlink()
+ print(f"Removed: {path}")
+ print("Done removing all removable paths")
+
+
+@app.command()
+def remove_all_removable() -> None:
+ all_removable = list_all_removable()
+ for removable_path in all_removable:
+ removable_path.unlink()
+ print(f"Removed: {removable_path}")
+ print("Done removing all removable paths")
+
+
+@app.command()
+def list_outdated(lang: str) -> list[Path]:
+ dir_path = Path(__file__).absolute().parent.parent
+ repo = git.Repo(dir_path)
+
+ outdated_paths: list[Path] = []
+ en_lang_paths = list(iter_en_paths_to_translate())
+ for path in en_lang_paths:
+ lang_path = generate_lang_path(lang=lang, path=path)
+ if not lang_path.exists():
+ outdated_paths.append(path)
+ continue
+ en_commit_datetime = list(repo.iter_commits(paths=path, max_count=1))[
+ 0
+ ].committed_datetime
+ lang_commit_datetime = list(repo.iter_commits(paths=lang_path, max_count=1))[
+ 0
+ ].committed_datetime
+ if lang_commit_datetime < en_commit_datetime:
+ outdated_paths.append(path)
+ print(outdated_paths)
+ return outdated_paths
+
+
+@app.command()
+def update_outdated(lang: str) -> None:
+ outdated_paths = list_outdated(lang)
+ for path in outdated_paths:
+ print(f"Updating lang: {lang} path: {path}")
translate_page(lang=lang, path=path)
- else:
- translate_all(lang=lang)
+ print(f"Done updating: {path}")
+ print("Done updating all outdated paths")
if __name__ == "__main__":
- typer.run(main)
+ app()
diff --git a/tests/test_application.py b/tests/test_application.py
index 5c62f5f6e..a7d50ea72 100644
--- a/tests/test_application.py
+++ b/tests/test_application.py
@@ -43,7 +43,7 @@ def test_redoc():
response = client.get("/redoc")
assert response.status_code == 200, response.text
assert response.headers["content-type"] == "text/html; charset=utf-8"
- assert "redoc@next" in response.text
+ assert "redoc@2" in response.text
def test_enum_status_code_response():
diff --git a/tests/test_openapi_model_description_trim_on_formfeed.py b/tests/test_openapi_model_description_trim_on_formfeed.py
new file mode 100644
index 000000000..e18d4f6b2
--- /dev/null
+++ b/tests/test_openapi_model_description_trim_on_formfeed.py
@@ -0,0 +1,31 @@
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class MyModel(BaseModel):
+ """
+ A model with a form feed character in the title.
+ \f
+ Text after form feed character.
+ """
+
+
+@app.get("/foo")
+def foo(v: MyModel): # pragma: no cover
+ pass
+
+
+client = TestClient(app)
+
+
+def test_openapi():
+ response = client.get("/openapi.json")
+ assert response.status_code == 200, response.text
+ openapi_schema = response.json()
+
+ assert openapi_schema["components"]["schemas"]["MyModel"]["description"] == (
+ "A model with a form feed character in the title.\n"
+ )
diff --git a/tests/test_tutorial/test_cookie_param_models/test_tutorial002.py b/tests/test_tutorial/test_cookie_param_models/test_tutorial002.py
index 30adadc8a..cef6f6630 100644
--- a/tests/test_tutorial/test_cookie_param_models/test_tutorial002.py
+++ b/tests/test_tutorial/test_cookie_param_models/test_tutorial002.py
@@ -5,7 +5,13 @@ 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
+from tests.utils import (
+ needs_py39,
+ needs_py310,
+ needs_pydanticv1,
+ needs_pydanticv2,
+ pydantic_snapshot,
+)
@pytest.fixture(
@@ -59,8 +65,8 @@ def test_cookie_param_model_defaults(client: TestClient):
def test_cookie_param_model_invalid(client: TestClient):
response = client.get("/items/")
assert response.status_code == 422
- assert response.json() == snapshot(
- IsDict(
+ assert response.json() == pydantic_snapshot(
+ v2=snapshot(
{
"detail": [
{
@@ -71,9 +77,8 @@ def test_cookie_param_model_invalid(client: TestClient):
}
]
}
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
+ ),
+ v1=snapshot(
{
"detail": [
{
@@ -83,7 +88,7 @@ def test_cookie_param_model_invalid(client: TestClient):
}
]
}
- )
+ ),
)
@@ -144,18 +149,23 @@ def test_openapi_schema(client: TestClient):
"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",
- }
+ "schema": pydantic_snapshot(
+ v2=snapshot(
+ {
+ "anyOf": [
+ {"type": "string"},
+ {"type": "null"},
+ ],
+ "title": "Fatebook Tracker",
+ }
+ ),
+ v1=snapshot(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "Fatebook Tracker",
+ }
+ ),
),
},
{
diff --git a/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py b/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
index aff070d74..cb8e8c224 100644
--- a/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
+++ b/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
@@ -33,7 +33,7 @@ def test_swagger_ui_oauth2_redirect_html(client: TestClient):
def test_redoc_html(client: TestClient):
response = client.get("/redoc")
assert response.status_code == 200, response.text
- assert "https://unpkg.com/redoc@next/bundles/redoc.standalone.js" in response.text
+ assert "https://unpkg.com/redoc@2/bundles/redoc.standalone.js" in response.text
def test_api(client: TestClient):
diff --git a/tests/test_tutorial/test_custom_request_and_route/test_tutorial002.py b/tests/test_tutorial/test_custom_request_and_route/test_tutorial002.py
index 6f7355aaa..647f1c5dd 100644
--- a/tests/test_tutorial/test_custom_request_and_route/test_tutorial002.py
+++ b/tests/test_tutorial/test_custom_request_and_route/test_tutorial002.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
from fastapi.testclient import TestClient
from docs_src.custom_request_and_route.tutorial002 import app
@@ -24,14 +24,16 @@ def test_exception_handler_body_access():
"input": {"numbers": [1, 2, 3]},
}
],
- "body": '{"numbers": [1, 2, 3]}',
+ # httpx 0.28.0 switches to compact JSON https://github.com/encode/httpx/issues/3363
+ "body": IsOneOf('{"numbers": [1, 2, 3]}', '{"numbers":[1,2,3]}'),
}
}
) | IsDict(
# TODO: remove when deprecating Pydantic v1
{
"detail": {
- "body": '{"numbers": [1, 2, 3]}',
+ # httpx 0.28.0 switches to compact JSON https://github.com/encode/httpx/issues/3363
+ "body": IsOneOf('{"numbers": [1, 2, 3]}', '{"numbers":[1,2,3]}'),
"errors": [
{
"loc": ["body"],
diff --git a/tests/test_tutorial/test_header_param_models/test_tutorial001.py b/tests/test_tutorial/test_header_param_models/test_tutorial001.py
index 06b2404cf..bc876897b 100644
--- a/tests/test_tutorial/test_header_param_models/test_tutorial001.py
+++ b/tests/test_tutorial/test_header_param_models/test_tutorial001.py
@@ -129,13 +129,13 @@ def test_openapi_schema(client: TestClient):
"schema": {"type": "string", "title": "Host"},
},
{
- "name": "save_data",
+ "name": "save-data",
"in": "header",
"required": True,
"schema": {"type": "boolean", "title": "Save Data"},
},
{
- "name": "if_modified_since",
+ "name": "if-modified-since",
"in": "header",
"required": False,
"schema": IsDict(
@@ -171,7 +171,7 @@ def test_openapi_schema(client: TestClient):
),
},
{
- "name": "x_tag",
+ "name": "x-tag",
"in": "header",
"required": False,
"schema": {
diff --git a/tests/test_tutorial/test_header_param_models/test_tutorial002.py b/tests/test_tutorial/test_header_param_models/test_tutorial002.py
index e07655a0c..0615521c4 100644
--- a/tests/test_tutorial/test_header_param_models/test_tutorial002.py
+++ b/tests/test_tutorial/test_header_param_models/test_tutorial002.py
@@ -140,13 +140,13 @@ def test_openapi_schema(client: TestClient):
"schema": {"type": "string", "title": "Host"},
},
{
- "name": "save_data",
+ "name": "save-data",
"in": "header",
"required": True,
"schema": {"type": "boolean", "title": "Save Data"},
},
{
- "name": "if_modified_since",
+ "name": "if-modified-since",
"in": "header",
"required": False,
"schema": IsDict(
@@ -182,7 +182,7 @@ def test_openapi_schema(client: TestClient):
),
},
{
- "name": "x_tag",
+ "name": "x-tag",
"in": "header",
"required": False,
"schema": {
diff --git a/tests/test_tutorial/test_header_param_models/test_tutorial003.py b/tests/test_tutorial/test_header_param_models/test_tutorial003.py
new file mode 100644
index 000000000..60940e1da
--- /dev/null
+++ b/tests/test_tutorial/test_header_param_models/test_tutorial003.py
@@ -0,0 +1,285 @@
+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=[
+ "tutorial003",
+ pytest.param("tutorial003_py39", marks=needs_py39),
+ pytest.param("tutorial003_py310", marks=needs_py310),
+ "tutorial003_an",
+ pytest.param("tutorial003_an_py39", marks=needs_py39),
+ pytest.param("tutorial003_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_no_underscore(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 == 422
+ assert response.json() == snapshot(
+ {
+ "detail": [
+ IsDict(
+ {
+ "type": "missing",
+ "loc": ["header", "save_data"],
+ "msg": "Field required",
+ "input": {
+ "host": "testserver",
+ "traceparent": "123",
+ "x_tag": [],
+ "accept": "*/*",
+ "accept-encoding": "gzip, deflate",
+ "connection": "keep-alive",
+ "user-agent": "testclient",
+ "save-data": "true",
+ "if-modified-since": "yesterday",
+ "x-tag": "two",
+ },
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "value_error.missing",
+ "loc": ["header", "save_data"],
+ "msg": "field required",
+ }
+ )
+ ]
+ }
+ )
+
+
+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_security/test_tutorial003.py b/tests/test_tutorial/test_security/test_tutorial003.py
index 37fc2618f..2bbb2e851 100644
--- a/tests/test_tutorial/test_security/test_tutorial003.py
+++ b/tests/test_tutorial/test_security/test_tutorial003.py
@@ -163,7 +163,11 @@ def test_openapi_schema(client: TestClient):
}
),
"username": {"title": "Username", "type": "string"},
- "password": {"title": "Password", "type": "string"},
+ "password": {
+ "title": "Password",
+ "type": "string",
+ "format": "password",
+ },
"scope": {"title": "Scope", "type": "string", "default": ""},
"client_id": IsDict(
{
@@ -179,11 +183,16 @@ def test_openapi_schema(client: TestClient):
{
"title": "Client Secret",
"anyOf": [{"type": "string"}, {"type": "null"}],
+ "format": "password",
}
)
| IsDict(
# TODO: remove when deprecating Pydantic v1
- {"title": "Client Secret", "type": "string"}
+ {
+ "title": "Client Secret",
+ "type": "string",
+ "format": "password",
+ }
),
},
},
diff --git a/tests/test_tutorial/test_security/test_tutorial005.py b/tests/test_tutorial/test_security/test_tutorial005.py
index 88c3d7815..ad644d61b 100644
--- a/tests/test_tutorial/test_security/test_tutorial005.py
+++ b/tests/test_tutorial/test_security/test_tutorial005.py
@@ -377,7 +377,11 @@ def test_openapi_schema(mod: ModuleType):
}
),
"username": {"title": "Username", "type": "string"},
- "password": {"title": "Password", "type": "string"},
+ "password": {
+ "title": "Password",
+ "type": "string",
+ "format": "password",
+ },
"scope": {"title": "Scope", "type": "string", "default": ""},
"client_id": IsDict(
{
@@ -393,11 +397,16 @@ def test_openapi_schema(mod: ModuleType):
{
"title": "Client Secret",
"anyOf": [{"type": "string"}, {"type": "null"}],
+ "format": "password",
}
)
| IsDict(
# TODO: remove when deprecating Pydantic v1
- {"title": "Client Secret", "type": "string"}
+ {
+ "title": "Client Secret",
+ "type": "string",
+ "format": "password",
+ }
),
},
},
diff --git a/tests/test_tutorial/test_settings/test_tutorial001.py b/tests/test_tutorial/test_settings/test_tutorial001.py
index eb30dbcee..92a5782d4 100644
--- a/tests/test_tutorial/test_settings/test_tutorial001.py
+++ b/tests/test_tutorial/test_settings/test_tutorial001.py
@@ -1,14 +1,26 @@
+import importlib
+
+import pytest
from fastapi.testclient import TestClient
from pytest import MonkeyPatch
-from ...utils import needs_pydanticv2
+from ...utils import needs_pydanticv1, needs_pydanticv2
-@needs_pydanticv2
-def test_settings(monkeypatch: MonkeyPatch):
+@pytest.fixture(
+ name="app",
+ params=[
+ pytest.param("tutorial001", marks=needs_pydanticv2),
+ pytest.param("tutorial001_pv1", marks=needs_pydanticv1),
+ ],
+)
+def get_app(request: pytest.FixtureRequest, monkeypatch: MonkeyPatch):
monkeypatch.setenv("ADMIN_EMAIL", "admin@example.com")
- from docs_src.settings.tutorial001 import app
+ mod = importlib.import_module(f"docs_src.settings.{request.param}")
+ return mod.app
+
+def test_settings(app):
client = TestClient(app)
response = client.get("/info")
assert response.status_code == 200, response.text
diff --git a/tests/test_tutorial/test_settings/test_tutorial001_pv1.py b/tests/test_tutorial/test_settings/test_tutorial001_pv1.py
deleted file mode 100644
index e4659de66..000000000
--- a/tests/test_tutorial/test_settings/test_tutorial001_pv1.py
+++ /dev/null
@@ -1,19 +0,0 @@
-from fastapi.testclient import TestClient
-from pytest import MonkeyPatch
-
-from ...utils import needs_pydanticv1
-
-
-@needs_pydanticv1
-def test_settings(monkeypatch: MonkeyPatch):
- monkeypatch.setenv("ADMIN_EMAIL", "admin@example.com")
- from docs_src.settings.tutorial001_pv1 import app
-
- client = TestClient(app)
- response = client.get("/info")
- assert response.status_code == 200, response.text
- assert response.json() == {
- "app_name": "Awesome API",
- "admin_email": "admin@example.com",
- "items_per_user": 50,
- }
diff --git a/tests/test_tutorial/test_sql_databases/test_tutorial002.py b/tests/test_tutorial/test_sql_databases/test_tutorial002.py
index 79e48c1c3..8a98f9a2d 100644
--- a/tests/test_tutorial/test_sql_databases/test_tutorial002.py
+++ b/tests/test_tutorial/test_sql_databases/test_tutorial002.py
@@ -4,7 +4,7 @@ import warnings
import pytest
from dirty_equals import IsDict, IsInt
from fastapi.testclient import TestClient
-from inline_snapshot import snapshot
+from inline_snapshot import Is, snapshot
from sqlalchemy import StaticPool
from sqlmodel import SQLModel, create_engine
from sqlmodel.main import default_registry
@@ -117,14 +117,14 @@ def test_crud_app(client: TestClient):
)
assert response.status_code == 200, response.text
assert response.json() == snapshot(
- {"name": "Dog Pond", "age": None, "id": hero_id}
+ {"name": "Dog Pond", "age": None, "id": Is(hero_id)}
)
# Get updated hero
response = client.get(f"/heroes/{hero_id}")
assert response.status_code == 200, response.text
assert response.json() == snapshot(
- {"name": "Dog Pond", "age": None, "id": hero_id}
+ {"name": "Dog Pond", "age": None, "id": Is(hero_id)}
)
# Delete a hero
diff --git a/tests/test_union_forms.py b/tests/test_union_forms.py
new file mode 100644
index 000000000..cbe98ea82
--- /dev/null
+++ b/tests/test_union_forms.py
@@ -0,0 +1,156 @@
+from typing import Union
+
+from fastapi import FastAPI, Form
+from fastapi.testclient import TestClient
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class UserForm(BaseModel):
+ name: str
+ email: str
+
+
+class CompanyForm(BaseModel):
+ company_name: str
+ industry: str
+
+
+@app.post("/form-union/")
+def post_union_form(data: Annotated[Union[UserForm, CompanyForm], Form()]):
+ return {"received": data}
+
+
+client = TestClient(app)
+
+
+def test_post_user_form():
+ response = client.post(
+ "/form-union/", data={"name": "John Doe", "email": "john@example.com"}
+ )
+ assert response.status_code == 200, response.text
+ assert response.json() == {
+ "received": {"name": "John Doe", "email": "john@example.com"}
+ }
+
+
+def test_post_company_form():
+ response = client.post(
+ "/form-union/", data={"company_name": "Tech Corp", "industry": "Technology"}
+ )
+ assert response.status_code == 200, response.text
+ assert response.json() == {
+ "received": {"company_name": "Tech Corp", "industry": "Technology"}
+ }
+
+
+def test_invalid_form_data():
+ response = client.post(
+ "/form-union/",
+ data={"name": "John", "company_name": "Tech Corp"},
+ )
+ assert response.status_code == 422, response.text
+
+
+def test_empty_form():
+ response = client.post("/form-union/")
+ assert response.status_code == 422, response.text
+
+
+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-union/": {
+ "post": {
+ "summary": "Post Union Form",
+ "operationId": "post_union_form_form_union__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {
+ "anyOf": [
+ {"$ref": "#/components/schemas/UserForm"},
+ {"$ref": "#/components/schemas/CompanyForm"},
+ ],
+ "title": "Data",
+ }
+ }
+ },
+ "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": {
+ "CompanyForm": {
+ "properties": {
+ "company_name": {"type": "string", "title": "Company Name"},
+ "industry": {"type": "string", "title": "Industry"},
+ },
+ "type": "object",
+ "required": ["company_name", "industry"],
+ "title": "CompanyForm",
+ },
+ "HTTPValidationError": {
+ "properties": {
+ "detail": {
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ "type": "array",
+ "title": "Detail",
+ }
+ },
+ "type": "object",
+ "title": "HTTPValidationError",
+ },
+ "UserForm": {
+ "properties": {
+ "name": {"type": "string", "title": "Name"},
+ "email": {"type": "string", "title": "Email"},
+ },
+ "type": "object",
+ "required": ["name", "email"],
+ "title": "UserForm",
+ },
+ "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_validate_response_recursive/app_pv1.py b/tests/test_validate_response_recursive/app.py
similarity index 79%
rename from tests/test_validate_response_recursive/app_pv1.py
rename to tests/test_validate_response_recursive/app.py
index 4cfc4b3ee..d23d27980 100644
--- a/tests/test_validate_response_recursive/app_pv1.py
+++ b/tests/test_validate_response_recursive/app.py
@@ -1,6 +1,7 @@
from typing import List
from fastapi import FastAPI
+from fastapi._compat import PYDANTIC_V2
from pydantic import BaseModel
app = FastAPI()
@@ -11,9 +12,6 @@ class RecursiveItem(BaseModel):
name: str
-RecursiveItem.update_forward_refs()
-
-
class RecursiveSubitemInSubmodel(BaseModel):
sub_items2: List["RecursiveItemViaSubmodel"] = []
name: str
@@ -24,7 +22,13 @@ class RecursiveItemViaSubmodel(BaseModel):
name: str
-RecursiveSubitemInSubmodel.update_forward_refs()
+if PYDANTIC_V2:
+ RecursiveItem.model_rebuild()
+ RecursiveSubitemInSubmodel.model_rebuild()
+ RecursiveItemViaSubmodel.model_rebuild()
+else:
+ RecursiveItem.update_forward_refs()
+ RecursiveSubitemInSubmodel.update_forward_refs()
@app.get("/items/recursive", response_model=RecursiveItem)
diff --git a/tests/test_validate_response_recursive/app_pv2.py b/tests/test_validate_response_recursive/app_pv2.py
deleted file mode 100644
index 8c93a8349..000000000
--- a/tests/test_validate_response_recursive/app_pv2.py
+++ /dev/null
@@ -1,51 +0,0 @@
-from typing import List
-
-from fastapi import FastAPI
-from pydantic import BaseModel
-
-app = FastAPI()
-
-
-class RecursiveItem(BaseModel):
- sub_items: List["RecursiveItem"] = []
- name: str
-
-
-RecursiveItem.model_rebuild()
-
-
-class RecursiveSubitemInSubmodel(BaseModel):
- sub_items2: List["RecursiveItemViaSubmodel"] = []
- name: str
-
-
-class RecursiveItemViaSubmodel(BaseModel):
- sub_items1: List[RecursiveSubitemInSubmodel] = []
- name: str
-
-
-RecursiveSubitemInSubmodel.model_rebuild()
-RecursiveItemViaSubmodel.model_rebuild()
-
-
-@app.get("/items/recursive", response_model=RecursiveItem)
-def get_recursive():
- return {"name": "item", "sub_items": [{"name": "subitem", "sub_items": []}]}
-
-
-@app.get("/items/recursive-submodel", response_model=RecursiveItemViaSubmodel)
-def get_recursive_submodel():
- return {
- "name": "item",
- "sub_items1": [
- {
- "name": "subitem",
- "sub_items2": [
- {
- "name": "subsubitem",
- "sub_items1": [{"name": "subsubsubitem", "sub_items2": []}],
- }
- ],
- }
- ],
- }
diff --git a/tests/test_validate_response_recursive/test_validate_response_recursive_pv2.py b/tests/test_validate_response_recursive/test_validate_response_recursive.py
similarity index 90%
rename from tests/test_validate_response_recursive/test_validate_response_recursive_pv2.py
rename to tests/test_validate_response_recursive/test_validate_response_recursive.py
index 7d45e7fe4..21a299ab8 100644
--- a/tests/test_validate_response_recursive/test_validate_response_recursive_pv2.py
+++ b/tests/test_validate_response_recursive/test_validate_response_recursive.py
@@ -1,12 +1,9 @@
from fastapi.testclient import TestClient
-from ..utils import needs_pydanticv2
+from .app import app
-@needs_pydanticv2
def test_recursive():
- from .app_pv2 import app
-
client = TestClient(app)
response = client.get("/items/recursive")
assert response.status_code == 200, response.text
diff --git a/tests/test_validate_response_recursive/test_validate_response_recursive_pv1.py b/tests/test_validate_response_recursive/test_validate_response_recursive_pv1.py
deleted file mode 100644
index de578ae03..000000000
--- a/tests/test_validate_response_recursive/test_validate_response_recursive_pv1.py
+++ /dev/null
@@ -1,33 +0,0 @@
-from fastapi.testclient import TestClient
-
-from ..utils import needs_pydanticv1
-
-
-@needs_pydanticv1
-def test_recursive():
- from .app_pv1 import app
-
- client = TestClient(app)
- response = client.get("/items/recursive")
- assert response.status_code == 200, response.text
- assert response.json() == {
- "sub_items": [{"name": "subitem", "sub_items": []}],
- "name": "item",
- }
-
- response = client.get("/items/recursive-submodel")
- assert response.status_code == 200, response.text
- assert response.json() == {
- "name": "item",
- "sub_items1": [
- {
- "name": "subitem",
- "sub_items2": [
- {
- "name": "subsubitem",
- "sub_items1": [{"name": "subsubsubitem", "sub_items2": []}],
- }
- ],
- }
- ],
- }
diff --git a/tests/utils.py b/tests/utils.py
index 460c028f7..ae9543e3b 100644
--- a/tests/utils.py
+++ b/tests/utils.py
@@ -2,6 +2,7 @@ import sys
import pytest
from fastapi._compat import PYDANTIC_V2
+from inline_snapshot import Snapshot
needs_py39 = pytest.mark.skipif(sys.version_info < (3, 9), reason="requires python3.9+")
needs_py310 = pytest.mark.skipif(
@@ -9,3 +10,25 @@ needs_py310 = pytest.mark.skipif(
)
needs_pydanticv2 = pytest.mark.skipif(not PYDANTIC_V2, reason="requires Pydantic v2")
needs_pydanticv1 = pytest.mark.skipif(PYDANTIC_V2, reason="requires Pydantic v1")
+
+
+def pydantic_snapshot(
+ *,
+ v2: Snapshot,
+ v1: Snapshot, # TODO: remove v1 argument when deprecating Pydantic v1
+):
+ """
+ This function should be used like this:
+
+ >>> assert value == pydantic_snapshot(v2=snapshot(),v1=snapshot())
+
+ inline-snapshot will create the snapshots when pytest is executed for each versions of pydantic.
+
+ It is also possible to use the function inside snapshots for version-specific values.
+
+ >>> assert value == snapshot({
+ "data": "some data",
+ "version_specific": pydantic_snapshot(v2=snapshot(),v1=snapshot()),
+ })
+ """
+ return v2 if PYDANTIC_V2 else v1
-
-
-
-
-
+
-
+
+
-
+
+
+
@@ -150,7 +149,7 @@ $ pip install "fastapi[standard]"
### Create it
-* Create a file `main.py` with:
+Create a file `main.py` with:
```Python
from typing import Union
@@ -472,15 +471,20 @@ Used by Starlette:
* 
+
Und natÃŧrlich wÃŧrden auf derselben Maschine neben Ihrer Anwendung wahrscheinlich auch **andere Prozesse** laufen.
diff --git a/docs/de/docs/deployment/https.md b/docs/de/docs/deployment/https.md
index 630582995..a216f44af 100644
--- a/docs/de/docs/deployment/https.md
+++ b/docs/de/docs/deployment/https.md
@@ -85,7 +85,7 @@ Zuerst wÃŧrde der Browser mithilfe der **DNS-Server** herausfinden, welches die
Die DNS-Server geben dem Browser eine bestimmte **IP-Adresse** zurÃŧck. Das wäre die von Ihrem Server verwendete Ãļffentliche IP-Adresse, die Sie in den DNS-Servern konfiguriert haben.
-
+
### TLS-Handshake-Start
@@ -93,7 +93,7 @@ Der Browser kommuniziert dann mit dieser IP-Adresse Ãŧber **Port 443** (den HTTP
Der erste Teil der Kommunikation besteht lediglich darin, die Verbindung zwischen dem Client und dem Server herzustellen und die zu verwendenden kryptografischen SchlÃŧssel usw. zu vereinbaren.
-
+
Diese Interaktion zwischen dem Client und dem Server zum Aufbau der TLS-Verbindung wird als **TLS-Handshake** bezeichnet.
@@ -111,7 +111,7 @@ Mithilfe der oben beschriebenen **SNI-Erweiterung** wÃŧrde der TLS-Terminierungs
In diesem Fall wÃŧrde er das Zertifikat fÃŧr `someapp.example.com` verwenden.
-
+
Der Client **vertraut** bereits der Entität, die das TLS-Zertifikat generiert hat (in diesem Fall Let's Encrypt, aber wir werden später mehr darÃŧber erfahren), sodass er **verifizieren** kann, dass das Zertifikat gÃŧltig ist.
@@ -133,19 +133,19 @@ Da Client und Server (sprich, der Browser und der TLS-Terminierungsproxy) nun Ãŧ
Der Client sendet also einen **HTTPS-Request**. Das ist einfach ein HTTP-Request Ãŧber eine verschlÃŧsselte TLS-Verbindung.
-
+
### Den Request entschlÃŧsseln
Der TLS-Terminierungsproxy wÃŧrde die vereinbarte VerschlÃŧsselung zum **EntschlÃŧsseln des Requests** verwenden und den **einfachen (entschlÃŧsselten) HTTP-Request** an den Prozess weiterleiten, der die Anwendung ausfÃŧhrt (z. B. einen Prozess, bei dem Uvicorn die FastAPI-Anwendung ausfÃŧhrt).
-
+
### HTTP-Response
Die Anwendung wÃŧrde den Request verarbeiten und eine **einfache (unverschlÃŧsselte) HTTP-Response** an den TLS-Terminierungsproxy senden.
-
+
### HTTPS-Response
@@ -153,7 +153,7 @@ Der TLS-Terminierungsproxy wÃŧrde dann die Response mithilfe der zuvor vereinbar
Als Nächstes ÃŧberprÃŧft der Browser, ob die Response gÃŧltig und mit dem richtigen kryptografischen SchlÃŧssel usw. verschlÃŧsselt ist. AnschlieÃend **entschlÃŧsselt er die Response** und verarbeitet sie.
-
+
Der Client (Browser) weiÃ, dass die Response vom richtigen Server kommt, da dieser die Kryptografie verwendet, die zuvor mit dem **HTTPS-Zertifikat** vereinbart wurde.
@@ -163,7 +163,7 @@ Auf demselben Server (oder denselben Servern) kÃļnnten sich **mehrere Anwendunge
Nur ein Prozess kann diese spezifische IP und den Port verarbeiten (in unserem Beispiel der TLS-Terminierungsproxy), aber die anderen Anwendungen/Prozesse kÃļnnen auch auf dem/den Server(n) ausgefÃŧhrt werden, solange sie nicht versuchen, dieselbe **Kombination aus Ãļffentlicher IP und Port** zu verwenden.
-
+
Auf diese Weise kÃļnnte der TLS-Terminierungsproxy HTTPS und Zertifikate fÃŧr **mehrere Domains**, fÃŧr mehrere Anwendungen, verarbeiten und die Requests dann jeweils an die richtige Anwendung weiterleiten.
@@ -173,7 +173,7 @@ Irgendwann in der Zukunft wÃŧrde jedes Zertifikat **ablaufen** (etwa 3 Monate na
Und dann gäbe es ein anderes Programm (in manchen Fällen ist es ein anderes Programm, in manchen Fällen ist es derselbe TLS-Terminierungsproxy), das mit Let's Encrypt kommuniziert und das/die Zertifikat(e) erneuert.
-
+
Die **TLS-Zertifikate** sind **einem Domainnamen zugeordnet**, nicht einer IP-Adresse.
diff --git a/docs/de/docs/how-to/custom-docs-ui-assets.md b/docs/de/docs/how-to/custom-docs-ui-assets.md
index ab8cd9f6b..f68902b99 100644
--- a/docs/de/docs/how-to/custom-docs-ui-assets.md
+++ b/docs/de/docs/how-to/custom-docs-ui-assets.md
@@ -98,7 +98,7 @@ Sie kÃļnnen wahrscheinlich mit der rechten Maustaste auf jeden Link klicken und
Und **ReDoc** verwendet diese Datei:
-* `redoc.standalone.js`
+* `redoc.standalone.js`
Danach kÃļnnte Ihre Dateistruktur wie folgt aussehen:
@@ -129,14 +129,8 @@ Sie sollten eine sehr lange JavaScript-Datei fÃŧr **ReDoc** sehen.
Sie kÃļnnte beginnen mit etwas wie:
```JavaScript
-/*!
- * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
- * -------------------------------------------------------------
- * Version: "2.0.0-rc.18"
- * Repo: https://github.com/Redocly/redoc
- */
-!function(e,t){"object"==typeof exports&&"object"==typeof m
-
+/*! For license information please see redoc.standalone.js.LICENSE.txt */
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t(require("null")):
...
```
diff --git a/docs/de/docs/tutorial/bigger-applications.md b/docs/de/docs/tutorial/bigger-applications.md
index 59e91bdcc..514e3fd3a 100644
--- a/docs/de/docs/tutorial/bigger-applications.md
+++ b/docs/de/docs/tutorial/bigger-applications.md
@@ -52,7 +52,7 @@ from app.routers import items
* Es gibt auch ein Unterverzeichnis `app/internal/` mit einer weiteren Datei `__init__.py`, es handelt sich also um ein weiteres âPython-Subpackageâ: `app.internal`.
* Und die Datei `app/internal/admin.py` ist ein weiteres Submodul: `app.internal.admin`.
-
+
Die gleiche Dateistruktur mit Kommentaren:
@@ -270,7 +270,7 @@ Aber diese Datei existiert nicht, unsere Abhängigkeiten befinden sich in einer
Erinnern Sie sich, wie unsere Anwendungs-/Dateistruktur aussieht:
-
-
- 
-
- 
-
- 
-
- 
+
+ 
+
+ 
+
+بؚد ŲŲبØĒ ØĒŲ Ų
ÛâØ´ŲØ ØŗŲØ§ØąØ´ دŲ ØĒا Ø¨ØąÚ¯Øą ØŽÛŲÛ Ø´ÛÚŠ Ø¨ØąØ§Û ØŽŲدØĒ Ų ؚشŲØĒ Ų
ÛâدÛ. đđ
+
+
+
+ØĩŲدŲŲØ¯Ø§Øą ÛŲ ÚÛØ˛Û Ø¨Ų ØĸØ´ŲžØ˛ ØĒŲÛ ØĸØ´ŲžØ˛ØŽŲŲŲ Ų
ÛâÚ¯Ų ØĒا بدŲŲŲ باÛد Ø¨ØąÚ¯ØąŲØ§Û ØĒŲ ØąŲ ØĸŲ
ادŲ ÚŠŲŲ (Ú¯ØąÚŲ اŲاŲ Ø¯Ø§ØąŲ Ø¨ØąÚ¯ØąŲØ§Û Ų
Ø´ØĒØąÛØ§Û ŲبŲÛ ØąŲ Ø¯ØąØŗØĒ Ų
ÛâÚŠŲŲ).
+
+
+
+ŲžŲŲ ØąŲ Ų
ÛâدÛ. đ¸
+
+ØĩŲدŲŲØ¯Ø§Øą Ø´Ų
Ø§ØąŲ ŲŲبØĒØĒ ØąŲ بŲØĒ Ų
ÛâدŲ.
+
+
+
+ŲŲØĒÛ Ų
ŲØĒØ¸ØąÛØ Ø¨Ø§ ؚشŲØĒ Ų
ÛâØąÛ ÛŲ Ų
ÛØ˛ اŲØĒ؎اب Ų
ÛâÚŠŲÛØ Ų
ÛâØ´ÛŲÛ Ų ÚŠŲÛ Ø¨Ø§ ؚشŲØĒ ØØąŲ Ų
ÛâØ˛ŲÛ (ÚŲŲ Ø¨ØąÚ¯ØąŲاØĒ ØŽÛŲÛ Ø´ÛÚŠŲ Ų ØĸŲ
ادŲ ÚŠØąØ¯ŲØ´ŲŲ ÛŲ ÚŠŲ
ØˇŲŲ Ų
ÛâÚŠØ´Ų).
+
+ŲŲØĒÛ ŲžØ´ØĒ Ų
ÛØ˛ با ؚشŲØĒ ŲØ´ØŗØĒÛØ Ø¯Øą ØاŲÛ ÚŠŲ Ų
ŲØĒØ¸Øą Ø¨ØąÚ¯ØąŲاÛÛØ Ų
ÛâØĒŲŲÛ Ø§ŲŲ Ø˛Ų
اŲ ØąŲ ØĩØąŲ ØĒØØŗÛŲ اÛŲ ÚŠŲÛ ÚŠŲ ؚشŲØĒ ÚŲØ¯Øą باØاŲØ ŲØ§Ø˛ Ų باŲŲØ´Ų â¨đâ¨.
+
+
+
+ŲŲØĒÛ Ų
ŲØĒØ¸ØąÛ Ų با ؚشŲØĒ ØØąŲ Ų
ÛâØ˛ŲÛØ ŲØą Ø§Ø˛ گاŲÛ Ø´Ų
Ø§ØąŲâØ§Û ÚŠŲ ØąŲ ŲžÛØ´ØŽŲŲ ŲØ´ŲŲ دادŲ Ų
ÛâØ´Ų ØąŲ ÚÚŠ Ų
ÛâÚŠŲÛ ÚŠŲ ببÛŲÛ ŲŲبØĒØĒ شدŲ Ûا ŲŲ.
+
+بؚد ÛŲ ØŦاÛÛ Ø¨Ø§ŲØ§ØŽØąŲ ŲŲبØĒØĒ Ų
ÛâØ´Ų. Ų
ÛâØąÛ ŲžÛØ´ØŽŲŲØ Ø¨ØąÚ¯ØąŲاØĒ ØąŲ Ų
ÛâÚ¯ÛØąÛ Ų Ø¨ØąŲ
ÛâÚ¯ØąØ¯Û ØŗØą Ų
ÛØ˛.
+
+
+
+ØĒŲ Ų ؚشŲØĒ Ø¨ØąÚ¯ØąŲا ØąŲ Ų
ÛâØŽŲØąÛŲ Ų ÛŲ ŲŲØĒ ØŽŲب باŲŲ
Ø¯Ø§ØąÛŲ. â¨
+
+
+
+/// info
+
+ØĒØĩاŲÛØą ŲØ´ŲÚ¯ Ø§Ø˛ ÚŠØĒØąÛŲا ØĒاŲ
ŲžØŗŲŲ. đ¨
+
+///
+
+---
+
+ØĒØĩŲØą ÚŠŲ ØĒŲ ØĒŲÛ Ø§ÛŲ داØŗØĒاŲ ڊاŲ
ŲžÛŲØĒØą / Ø¨ØąŲاŲ
Ų đ¤ ŲØŗØĒÛ.
+
+ŲŲØĒÛ ØĒŲÛ ØĩŲ ŲØŗØĒÛØ ŲŲØˇ بÛÚŠØ§ØąÛ đ´Ø Ų
ŲØĒØ¸Øą ŲŲبØĒØĒ ŲØŗØĒÛØ ÚŠØ§Øą ØŽÛŲÛ "Ų
ŲÛدÛ" ŲŲ
ÛâÚŠŲÛ. ŲŲÛ ØĩŲ ØŗØąÛØš ŲžÛØ´ Ų
ÛâØąŲ ÚŲŲ ØĩŲدŲŲØ¯Ø§Øą ŲŲØˇ ØŗŲØ§ØąØ´ Ų
ÛâÚ¯ÛØąŲ (ØĸŲ
ادشŲŲ ŲŲ
ÛâÚŠŲŲ)Ø ŲžØŗ اÛŲ ØŽŲبŲ.
+
+Ø¨ØšØ¯Ø ŲŲØĒÛ ŲŲبØĒØĒ Ų
ÛâØ´ŲØ ÚŠØ§Øą "Ų
ŲÛد" ŲاŲØšÛ Ų
ÛâÚŠŲÛØ Ų
ŲŲ ØąŲ ŲžØąØ¯Ø§Ø˛Ø´ Ų
ÛâÚŠŲÛØ ØĒØĩŲ
ÛŲ
Ų
ÛâÚ¯ÛØąÛ ÚÛ Ų
ÛâØŽŲاÛØ Ø§ŲØĒ؎اب ؚشŲØĒ ØąŲ Ų
ÛâÚ¯ÛØąÛØ ŲžŲŲ Ų
ÛâدÛØ ÚÚŠ Ų
ÛâÚŠŲÛ Ø§ØŗÚŠŲاØŗ Ûا ÚŠØ§ØąØĒ Ø¯ØąØŗØĒ ØąŲ دادÛØ ÚÚŠ Ų
ÛâÚŠŲÛ Ø¯ØąØŗØĒ ØØŗاب شدŲØ ÚÚŠ Ų
ÛâÚŠŲÛ ØŗŲØ§ØąØ´ ØĸÛØĒŲ
Ø§Û Ø¯ØąØŗØĒ ØąŲ Ø¯Ø§ØąŲ Ų ØēÛØąŲ.
+
+ŲŲÛ Ø¨ØšØ¯Ø Ú¯ØąÚŲ ŲŲŲØ˛ Ø¨ØąÚ¯ØąŲاØĒ ØąŲ ŲØ¯Ø§ØąÛØ ÚŠØ§ØąØĒ با ØĩŲدŲŲØ¯Ø§Øą "Ų
ŲŲØĒاŲ Ų
ØĒŲŲŲ" ⸠Ų
ÛâØ´ŲØ ÚŲŲ باÛد Ų
ŲØĒØ¸Øą بŲ
ŲŲÛ đ ØĒا Ø¨ØąÚ¯ØąŲاØĒ ØĸŲ
ادŲ بشŲ.
+
+ŲŲÛ ŲŲØĒÛ Ø§Ø˛ ŲžÛØ´ØŽŲŲ دŲØą Ų
ÛâØ´Û Ų با Ø´Ų
Ø§ØąŲ ŲŲبØĒØĒ ØŗØą Ų
ÛØ˛ Ų
ÛâØ´ÛŲÛØ Ų
ÛâØĒŲŲÛ ØĒŲØŦŲØĒ ØąŲ đ بŲ ؚشŲØĒ Ø¨Ø¯Û Ų "ÚŠØ§Øą" ⯠đ¤ ØąŲ اŲŲ بڊŲÛ. بؚدش دŲØ¨Ø§ØąŲ Ø¯Ø§ØąÛ ÛŲ ÚÛØ˛ ØŽÛŲÛ "Ų
ŲÛد" اŲØŦاŲ
Ų
ÛâدÛØ Ų
ØĢŲ ŲاØŗ Ø˛Ø¯Ų با ؚشŲØĒ đ.
+
+بؚد ØĩŲدŲŲØ¯Ø§Øą đ با گذاشØĒŲ Ø´Ų
Ø§ØąŲâاØĒ ØąŲ ŲŲ
اÛØ´Ú¯Øą ŲžÛØ´ØŽŲŲ Ų
ÛâÚ¯Ų "Ų
Ų با Ø¯ØąØŗØĒ ÚŠØąØ¯Ų Ø¨ØąÚ¯ØąŲا ØĒŲ
ŲŲ
ÚŠØąØ¯Ų
"Ø ŲŲÛ ØĒŲ Ų
ØĢŲ دÛŲŲŲŲâŲا ŲŲØĒÛ Ø´Ų
Ø§ØąŲâاØĒ ØąŲ ŲŲ
اÛØ´Ú¯Øą Ų
Ûاد ŲŲØąÛ ŲŲ
ÛâŲžØąÛ. Ų
ÛâدŲŲÛ ÚŠØŗÛ Ø¨ØąÚ¯ØąŲاØĒ ØąŲ ŲŲ
ÛâØ¯Ø˛Ø¯Ų ÚŲŲ Ø´Ų
Ø§ØąŲ ŲŲبØĒØĒ ØąŲ Ø¯Ø§ØąÛØ Ų اŲŲا ŲŲ
Ų
اŲ ØŽŲدشŲŲ ØąŲ Ø¯Ø§ØąŲ.
+
+ŲžØŗ Ų
ŲØĒØ¸Øą Ų
ÛâŲ
ŲŲÛ ØĒا ؚشŲØĒ داØŗØĒاŲØ´ ØąŲ ØĒŲ
ŲŲ
ÚŠŲŲ (ÚŠØ§Øą ŲØšŲÛ â¯ / ŲظÛŲŲâØ§Û ÚŠŲ Ø¯Ø§ØąŲ ŲžØąØ¯Ø§Ø˛Ø´ Ų
ÛâØ´Ų đ¤)Ø ØĸØąŲŲ
Ųب؎Ųد Ų
ÛâØ˛ŲÛ Ų Ų
ÛâÚ¯Û ÚŠŲ Ų
ÛâØąÛ Ø¨ØąÚ¯ØąŲا ØąŲ بÛØ§ØąÛ â¸.
+
+بؚد Ų
ÛâØąÛ ŲžÛØ´ØŽŲŲ đØ Ø¨Ų ÚŠØ§Øą اŲŲÛŲ ÚŠŲ ØاŲا ØĒŲ
ŲŲ
شدŲ â¯Ø Ø¨ØąÚ¯ØąŲا ØąŲ Ų
ÛâÚ¯ÛØąÛØ ØĒØ´ÚŠØą Ų
ÛâÚŠŲÛ Ų Ų
ÛâØ¨ØąØ´ŲŲ ØŗØą Ų
ÛØ˛. اÛŲ Ų
ØąØŲŲ / ŲظÛŲŲ ØĒؚاŲ
Ų با ŲžÛØ´ØŽŲŲ ØąŲ ØĒŲ
ŲŲ
Ų
ÛâÚŠŲŲ âš. اÛŲ بŲ ŲŲبŲ ØŽŲدش ÛŲ ŲظÛŲŲ ØŦدÛØ¯Ø "ØŽŲØąØ¯Ų Ø¨ØąÚ¯ØąŲا" đ â¯Ø Ų
ÛâØŗØ§Ø˛ŲØ ŲŲÛ Ø§ŲŲ ŲبŲÛ ÚŠŲ "Ú¯ØąŲØĒŲ Ø¨ØąÚ¯ØąŲا" بŲد ØĒŲ
ŲŲ
شدŲ âš.
+
+### Ø¨ØąÚ¯ØąŲØ§Û Ų
ŲØ§Ø˛Û
+
+ØاŲا ŲØąØļ ÚŠŲ اÛŲا "Ø¨ØąÚ¯ØąŲØ§Û ŲŲ
âØ˛Ų
اŲ" ŲÛØŗØĒŲØ Ø¨ŲÚŠŲ "Ø¨ØąÚ¯ØąŲØ§Û Ų
ŲØ§Ø˛Û" ŲØŗØĒŲ.
+
+با ؚشŲØĒ Ų
ÛâØąÛ ŲØŗØĒâŲŲد Ų
ŲØ§Ø˛Û Ø¨Ú¯ÛØąÛ.
+
+ØĒŲÛ ØĩŲ ŲاÛŲ
ÛØŗØĒÛ Ø¯Øą ØاŲÛ ÚŠŲ ÚŲد ØĒا (Ų
ØĢŲاŲ 8 ØĒا) ØĩŲدŲŲØ¯Ø§Øą ÚŠŲ ŲŲ
Ø˛Ų
اŲ ØĸØ´ŲžØ˛ ŲŲ
ŲØŗØĒŲ ØŗŲØ§ØąØ´ ØĸدŲ
Ø§Û ØŦŲŲÛ ØĒŲ ØąŲ Ų
ÛâÚ¯ÛØąŲ.
+
+ŲŲ
Ų ŲبŲ ØĒŲ Ų
ŲØĒØ¸ØąŲ Ø¨ØąÚ¯ØąŲاشŲŲ ØĸŲ
ادŲ بشŲ ŲبŲ Ø§Ø˛ اÛŲÚŠŲ ŲžÛØ´ØŽŲŲ ØąŲ ØĒØąÚŠ ÚŠŲŲØ ÚŲŲ ŲØą ڊدŲŲ
Ø§Ø˛ 8 ØĒا ØĩŲدŲŲØ¯Ø§Øą Ų
ÛâØąŲ Ų Ø¨ØąÚ¯Øą ØąŲ ŲŲ
ŲŲ Ų
ŲŲØš Ø¯ØąØŗØĒ Ų
ÛâÚŠŲŲ ŲبŲ Ø§Ø˛ اÛŲÚŠŲ ØŗŲØ§ØąØ´ Ø¨ØšØ¯Û ØąŲ بگÛØąŲ.
+
+
+
+باŲØ§ØŽØąŲ ŲŲبØĒ ØĒŲ Ų
ÛâØ´ŲØ ØŗŲØ§ØąØ´ دŲ ØĒا Ø¨ØąÚ¯Øą ØŽÛŲÛ Ø´ÛÚŠ Ø¨ØąØ§Û ØŽŲدØĒ Ų ؚشŲØĒ Ų
ÛâدÛ.
+
+ŲžŲŲ ØąŲ Ų
ÛâØ¯Û đ¸.
+
+
+
+ØĩŲدŲŲØ¯Ø§Øą Ų
ÛâØąŲ ØĸØ´ŲžØ˛ØŽŲŲŲ.
+
+Ų
ŲØĒØ¸Øą Ų
ÛâŲ
ŲŲÛØ ØŦŲŲÛ ŲžÛØ´ØŽŲŲ ŲاÛØŗØĒØ§Ø¯Û đØ ÚŠŲ ÚŠØŗÛ ŲبŲ Ø§Ø˛ ØĒŲ Ø¨ØąÚ¯ØąŲاØĒ ØąŲ ŲÚ¯ÛØąŲØ ÚŲŲ Ø´Ų
Ø§ØąŲ ŲŲبØĒ ŲÛØŗØĒ.
+
+
+
+ÚŲŲ ØĒŲ Ų ؚشŲØĒ Ų
Ø´ØēŲŲ اÛŲ ŲØŗØĒÛŲ ÚŠŲ ŲØ°Ø§ØąÛŲ ÚŠØŗÛ ØŦŲŲØĒŲŲ بÛاد Ų ŲØą ŲŲØĒ Ø¨ØąÚ¯ØąŲا ØąØŗÛدŲ اŲŲا ØąŲ بگÛØąŲØ ŲŲ
ÛâØĒŲŲÛ Ø¨Ų ؚشŲØĒ ØĒŲØŦŲ ÚŠŲÛ. đ
+
+اÛŲ ÚŠØ§Øą "ŲŲ
âØ˛Ų
اŲ" ŲØŗØĒØ ØĒŲ با ØĩŲدŲŲØ¯Ø§Øą/ØĸØ´ŲžØ˛ đ¨âđŗ "ŲŲ
âØ˛Ų
اŲ" ŲØŗØĒÛ. باÛد Ų
ŲØĒØ¸Øą بŲ
ŲŲÛ đ Ų Ø¯ØąØŗØĒ ŲŲ
ŲŲ ŲØظŲ ÚŠŲ ØĩŲدŲŲØ¯Ø§Øą/ØĸØ´ŲžØ˛ đ¨âđŗ Ø¨ØąÚ¯ØąŲا ØąŲ ØĒŲ
ŲŲ
Ų
ÛâÚŠŲŲ Ų بŲØĒ Ų
ÛâدŲ اŲŲØŦا باشÛØ ŲÚ¯ØąŲŲ Ų
Ų
ÚŠŲŲ ÛÚŠÛ Ø¯ÛÚ¯Ų اŲŲا ØąŲ بگÛØąŲ.
+
+
+
+بؚد ØĩŲدŲŲØ¯Ø§Øą/ØĸØ´ŲžØ˛ØĒ đ¨âđŗ باŲØ§ØŽØąŲ بؚد Ø§Ø˛ ÛŲ Ų
دØĒ ØˇŲŲاŲÛ Ø§ŲØĒØ¸Ø§Øą đ ØŦŲŲÛ ŲžÛØ´ØŽŲŲ با Ø¨ØąÚ¯ØąŲاØĒ Ø¨ØąŲ
ÛâÚ¯ØąØ¯Ų.
+
+
+
+Ø¨ØąÚ¯ØąŲاØĒ ØąŲ Ų
ÛâÚ¯ÛØąÛ Ų با ؚشŲØĒ Ų
ÛâØąÛ ØŗØą Ų
ÛØ˛.
+
+ŲŲØˇ Ų
ÛâØŽŲØąÛŲØ´ŲŲØ Ų ØĒŲ
ŲŲ
Ų. âš
+
+
+
+ØØąŲ Ø˛Ø¯Ų Ûا ŲاØŗ Ø˛Ø¯Ų Ø˛Ûاد ŲبŲد ÚŲŲ بÛØ´ØĒØą ŲŲØĒ ØĩØąŲ اŲØĒØ¸Ø§Øą đ ØŦŲŲÛ ŲžÛØ´ØŽŲŲ شد. đ
+
+/// info
+
+ØĒØĩاŲÛØą ŲØ´ŲÚ¯ Ø§Ø˛ ÚŠØĒØąÛŲا ØĒاŲ
ŲžØŗŲŲ. đ¨
+
+///
+
+---
+
+ØĒŲÛ Ø§ÛŲ ØŗŲØ§ØąÛŲÛ Ø¨ØąÚ¯ØąŲØ§Û Ų
ŲØ§Ø˛ÛØ ØĒŲ ÛŲ ڊاŲ
ŲžÛŲØĒØą / Ø¨ØąŲاŲ
Ų đ¤ با دŲ ØĒا ŲžØąØ¯Ø§Ø˛ŲدŲ (ØĒŲ Ų ؚشŲØĒ) ŲØŗØĒÛØ ŲØą دŲ Ų
ŲØĒØ¸Øą đ Ų ØĒŲØŦŲØ´ŲŲ â¯ ØąŲ Ø¨ØąØ§Û Ų
دØĒ ØˇŲŲاŲÛ "اŲØĒØ¸Ø§Øą ØŦŲŲÛ ŲžÛØ´ØŽŲŲ" đ گذاشØĒŲ.
+
+ŲØŗØĒâŲŲد 8 ØĒا ŲžØąØ¯Ø§Ø˛ŲدŲ (ØĩŲدŲŲØ¯Ø§Øą/ØĸØ´ŲžØ˛) Ø¯Ø§ØąŲ. Ø¯Øą ØاŲÛ ÚŠŲ ŲØŗØĒâŲŲد Ø¨ØąÚ¯ØąŲØ§Û ŲŲ
âØ˛Ų
اŲ شاÛد ŲŲØˇ 2 ØĒا داشØĒŲ (ÛŲ ØĩŲدŲŲØ¯Ø§Øą Ų ÛŲ ØĸØ´ŲžØ˛).
+
+ŲŲÛ Ø¨Ø§ اÛŲ ØاŲØ ØĒØŦØąØ¨Ų ŲŲاÛÛ Ø¨ŲØĒØąÛŲ ŲÛØŗØĒ. đ
+
+---
+
+اÛŲ Ų
ؚادŲ Ų
ŲØ§Ø˛Û Ø¯Ø§ØŗØĒاŲ Ø¨ØąÚ¯ØąŲا بŲد. đ
+
+Ø¨ØąØ§Û ÛŲ Ų
ØĢاŲ "ŲاŲØšÛâØĒØą" Ø§Ø˛ Ø˛ŲدگÛØ ÛŲ باŲÚŠ ØąŲ ØĒØĩŲØą ÚŠŲ.
+
+ØĒا ŲŲ
ÛŲ ÚŲد ŲŲØĒ ŲžÛØ´Ø Ø¨ÛØ´ØĒØą باŲÚŠâŲا ÚŲد ØĒا ØĩŲدŲŲØ¯Ø§Øą đ¨âđŧđ¨âđŧđ¨âđŧđ¨âđŧ داشØĒŲ Ų ÛŲ ØĩŲ Ø¨Ø˛ØąÚ¯ đđđđđđđđ.
+
+ŲŲ
Ų ØĩŲدŲŲØ¯Ø§ØąŲا ÚŠØ§Øą ØąŲ با ÛŲ Ų
Ø´ØĒØąÛ Ø¨ØšØ¯ Ø§Ø˛ اŲŲ ÛÚŠÛ đ¨âđŧ⯠اŲØŦاŲ
Ų
ÛâدادŲ.
+
+Ų باÛد ØĒŲÛ ØĩŲ đ Ų
دØĒ Ø˛ÛØ§Ø¯Û Ų
ŲØĒØ¸Øą بŲ
ŲŲÛ ŲÚ¯ØąŲŲ ŲŲبØĒØĒ ØąŲ Ø§Ø˛ دØŗØĒ Ų
ÛâدÛ.
+
+اØØĒŲ
اŲاŲ ŲŲ
ÛâØŽŲØ§Û ØšØ´ŲØĒ đ ØąŲ با ØŽŲدØĒ Ø¨Ø¨ØąÛ Ø¨Ø§ŲÚŠ đĻ Ø¨ØąØ§Û ÚŠØ§ØąØ§Û ØąŲØ˛Ų
ØąŲ.
+
+### ŲØĒÛØŦŲâÚ¯ÛØąÛ Ø¨ØąÚ¯ØąŲا
+
+ØĒŲÛ Ø§ÛŲ ØŗŲØ§ØąÛŲÛ "Ø¨ØąÚ¯ØąŲØ§Û ŲØŗØĒâŲŲد با ؚشŲØĒ"Ø ÚŲŲ ÚŠŲÛ Ø§ŲØĒØ¸Ø§Øą đ ŲØŗØĒØ ØŽÛŲÛ Ų
ŲØˇŲÛâØĒØąŲ ÚŠŲ ÛŲ ØŗÛØŗØĒŲ
ŲŲ
âØ˛Ų
اŲ â¸đ⯠داشØĒŲ باشÛ.
+
+اÛŲ Ø¨ØąØ§Û Ø¨ÛØ´ØĒØą Ø¨ØąŲاŲ
ŲâŲØ§Û Ųب ŲŲ
ØĩدŲ Ų
ÛâÚŠŲŲ.
+
+ØŽÛŲÛ ØŽÛŲÛ ÚŠØ§ØąØ¨ØąØ ŲŲÛ ØŗØąŲØąØĒ Ų
ŲØĒØ¸Øą đ اØĒØĩاŲ ŲŲâÚŲداŲ ØŽŲبشŲŲ ŲØŗØĒ ØĒا Ø¯ØąØŽŲاØŗØĒâŲاشŲŲ ØąŲ بŲØąØŗØĒŲ.
+
+Ų بؚد دŲØ¨Ø§ØąŲ Ų
ŲØĒØ¸Øą đ ÚŠŲ ØŦŲابâŲا Ø¨ØąÚ¯ØąØ¯Ų.
+
+اÛŲ "اŲØĒØ¸Ø§Øą" đ ØĒŲÛ Ų
ÛÚŠØąŲØĢاŲÛŲâŲا اŲØ¯Ø§Ø˛ŲâÚ¯ÛØąÛ Ų
ÛâØ´ŲØ ŲŲÛ Ø¨Ø§ اÛŲ ØاŲØ ØŦŲ
ؚش ÚŠŲ بڊŲÛ ØĸØŽØąØ´ ÚŠŲÛ Ø§ŲØĒØ¸Ø§Øą Ų
ÛâØ´Ų.
+
+Ø¨ØąØ§Û ŲŲ
ÛŲ اØŗØĒŲادŲ Ø§Ø˛ ڊد ŲاŲŲ
âØ˛Ų
اŲ â¸đâ¯ Ø¨ØąØ§Û APIŲØ§Û Ųب ØŽÛŲÛ Ų
ŲØˇŲÛŲ.
+
+اÛŲ ŲŲØš ŲاŲŲ
âØ˛Ų
اŲÛ ÚÛØ˛ÛŲ ÚŠŲ NodeJS ØąŲ Ų
ØبŲب ÚŠØąØ¯ (Ú¯ØąÚŲ NodeJS Ų
ŲØ§Ø˛Û ŲÛØŗØĒ) Ų ŲŲØˇŲ ŲŲØĒ Go بŲâØšŲŲاŲ ÛŲ Ø˛Ø¨ŲŲ Ø¨ØąŲاŲ
ŲâŲŲÛØŗÛŲ.
+
+Ų ŲŲ
ŲŲ ØŗØˇØ ØšŲ
ŲÚŠØąØ¯Û ŲØŗØĒ ÚŠŲ با **FastAPI** Ų
ÛâÚ¯ÛØąÛ.
+
+Ų ÚŲŲ Ų
ÛâØĒŲŲÛ ŲŲ
âØ˛Ų
اŲÛ Ų Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û ØąŲ ŲŲ
Ø˛Ų
اŲ داشØĒŲ باشÛØ ØšŲ
ŲÚŠØąØ¯ باŲاØĒØąÛ Ø§Ø˛ بÛØ´ØĒØą ŲØąÛŲ
âŲØąÚŠâŲØ§Û ØĒØŗØĒâشدŲ NodeJS Ų
ÛâÚ¯ÛØąÛ Ų ŲŲ
âØĒØąØ§Ø˛ با GoØ ÚŠŲ ÛŲ Ø˛Ø¨ŲŲ ڊاŲ
ŲžØ§ÛŲâشدŲ ŲØ˛Ø¯ÛÚŠ بŲ C ŲØŗØĒ (ŲŲ
Ų اÛŲا بŲ ŲØˇŲ Starlette).
+
+### ØĸÛا ŲŲ
âØ˛Ų
اŲÛ Ø§Ø˛ Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û Ø¨ŲØĒØąŲØ
+
+ŲŲ! اÛŲ ŲØĒÛØŦŲ داØŗØĒاŲ ŲÛØŗØĒ.
+
+ŲŲ
âØ˛Ų
اŲÛ Ø¨Ø§ Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û ŲØąŲ Ø¯Ø§ØąŲ. Ų ØĒŲÛ **ØŗŲØ§ØąÛŲŲØ§Û ØŽØ§Øĩ** ÚŠŲ ÚŠŲÛ Ø§ŲØĒØ¸Ø§Øą Ø¯Ø§ØąŲ بŲØĒØąŲ. بŲ ŲŲ
ÛŲ ØŽØ§ØˇØąØ Ų
ØšŲ
ŲŲاŲ Ø¨ØąØ§Û ØĒŲØŗØšŲ Ø¨ØąŲاŲ
ŲâŲØ§Û Ųب ØŽÛŲÛ Ø§Ø˛ Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û Ø¨ŲØĒØąŲ. ŲŲÛ ŲŲ Ø¨ØąØ§Û ŲŲ
ŲâÚÛØ˛.
+
+Ø¨ØąØ§Û Ø§ÛŲÚŠŲ ÛŲ ØĒؚادŲ Ø¨Ø°Ø§ØąÛŲ
Ø Ø§ÛŲ داØŗØĒاŲ ÚŠŲØĒاŲ ØąŲ ØĒØĩŲØą ÚŠŲ:
+
+> باÛد ÛŲ ØŽŲŲŲ Ø¨Ø˛ØąÚ¯ Ų ÚŠØĢÛŲ ØąŲ ØĒŲ
ÛØ˛ ÚŠŲÛ.
+
+*ØĸØąŲØ ÚŠŲ داØŗØĒاŲ ŲŲ
ÛŲŲ*.
+
+---
+
+ŲÛÚ Ø§ŲØĒØ¸Ø§ØąÛ đ اŲŲØŦا ŲÛØŗØĒØ ŲŲØˇ ÚŠŲÛ ÚŠØ§Øą Ø¨ØąØ§Û Ø§ŲØŦاŲ
دادŲ ØĒŲÛ ØŦاŲØ§Û Ų
ØŽØĒŲŲ ØŽŲŲŲ.
+
+Ų
ÛâØĒŲŲÛ Ų
ØĢŲ Ų
ØĢاŲ Ø¨ØąÚ¯ØąŲا ŲŲبØĒ Ø¨Ø°Ø§ØąÛØ Ø§ŲŲ ŲžØ°ÛØąØ§ÛÛØ Ø¨ØšØ¯ ØĸØ´ŲžØ˛ØŽŲŲŲØ ŲŲÛ ÚŲŲ Ų
ŲØĒØ¸Øą ÚÛØ˛Û ŲÛØŗØĒÛ đØ ŲŲØˇ Ø¯Ø§ØąÛ ØĒŲ
ÛØ˛ Ų
ÛâÚŠŲÛ Ų ØĒŲ
ÛØ˛ Ų
ÛâÚŠŲÛØ ŲŲبØĒâŲا ŲÛÚ ØĒØŖØĢÛØąÛ ŲØ¯Ø§ØąŲ.
+
+با ŲŲبØĒ Ûا بدŲŲ ŲŲبØĒ (ŲŲ
âØ˛Ų
اŲÛ) ŲŲ
ŲŲ ŲØ¯Øą ØˇŲŲ Ų
ÛâÚŠØ´Ų ØĒا ØĒŲ
ŲŲ
Ø´ ÚŠŲÛ Ų ŲŲ
ŲŲ Ų
ŲØ¯Ø§Øą ÚŠØ§Øą ØąŲ ÚŠØąØ¯Û.
+
+ŲŲÛ ØĒŲÛ Ø§ÛŲ Ų
ŲŲØšÛØĒØ Ø§Ú¯Ų بØĒŲŲÛ Ø§ŲŲ 8 ØĒا ØĩŲدŲŲØ¯Ø§Øą/ØĸØ´ŲžØ˛/ØاŲا-ØĒŲ
ÛØ˛ÚŠØ§Øą ØąŲ بÛØ§ØąÛØ Ų ŲØą ڊدŲŲ
Ø´ŲŲ (بŲâØšŲاŲŲ ØŽŲدØĒ) ÛŲ ŲØŗŲ
ØĒ Ø§Ø˛ ØŽŲŲŲ ØąŲ ØĒŲ
ÛØ˛ ÚŠŲŲØ Ų
ÛâØĒŲŲÛ ŲŲ
Ų ÚŠØ§Øą ØąŲ **Ų
ŲØ§Ø˛Û** اŲØŦاŲ
بدÛØ Ø¨Ø§ ÚŠŲ
ÚŠ اØļاŲÛØ Ų ØŽÛŲÛ Ø˛ŲدØĒØą ØĒŲ
ŲŲ
Ø´ ÚŠŲÛ.
+
+ØĒŲÛ Ø§ÛŲ ØŗŲØ§ØąÛŲØ ŲØą ڊدŲŲ
Ø§Ø˛ ØĒŲ
ÛØ˛ÚŠØ§ØąŲا (Ø§Ø˛ ØŦŲ
ŲŲ ØŽŲدØĒ) ÛŲ ŲžØąØ¯Ø§Ø˛ŲدŲâØŗØĒ ÚŠŲ ÚŠØ§Øą ØŽŲدش ØąŲ Ų
ÛâÚŠŲŲ.
+
+Ų ÚŲŲ بÛØ´ØĒØą Ø˛Ų
اŲ اØŦØąØ§ ØĩØąŲ ÚŠØ§Øą ŲاŲØšÛ Ų
ÛâØ´Ų (بŲ ØŦØ§Û Ø§ŲØĒØ¸Ø§Øą)Ø Ų ÚŠØ§Øą ØĒŲÛ ÚŠØ§Ų
ŲžÛŲØĒØą با CPU اŲØŦاŲ
Ų
ÛâØ´ŲØ Ø¨Ų اÛŲ Ų
Ø´ÚŠŲاØĒ Ų
ÛâÚ¯Ų "CPU bound".
+
+---
+
+Ų
ØĢاŲâŲØ§Û ØąØ§ÛØŦ ØšŲ
ŲÛاØĒ CPU bound ÚÛØ˛Ø§ÛÛ ŲØŗØĒŲ ÚŠŲ ŲÛØ§Ø˛ بŲ ŲžØąØ¯Ø§Ø˛Ø´ ØąÛاØļÛ ŲžÛÚÛدŲ Ø¯Ø§ØąŲ.
+
+Ų
ØĢŲاŲ:
+
+* ŲžØąØ¯Ø§Ø˛Ø´ **Øĩدا** Ûا **ØĒØĩŲÛØą**.
+* **بÛŲاÛÛ ÚŠØ§Ų
ŲžÛŲØĒØąÛ**: ÛŲ ØĒØĩŲÛØą Ø§Ø˛ Ų
ÛŲÛŲŲâŲا ŲžÛÚŠØŗŲ ØĒØ´ÚŠÛŲ شدŲØ ŲØą ŲžÛÚŠØŗŲ 3 ØĒا Ų
ŲØ¯Ø§Øą / ØąŲÚ¯ Ø¯Ø§ØąŲØ ŲžØąØ¯Ø§Ø˛Ø´Ø´ Ų
ØšŲ
ŲŲاŲ ŲÛØ§Ø˛ Ø¯Ø§ØąŲ ÚÛØ˛Û ØąŲ ØąŲ اŲŲ ŲžÛÚŠØŗŲâŲا ŲŲ
Ø˛Ų
اŲ ØØŗاب ÚŠŲÛ.
+* **ÛادگÛØąÛ Ų
اشÛŲ**: Ų
ØšŲ
ŲŲاŲ ÚŠŲÛ ØļØąØ¨ "Ų
اØĒØąÛØŗ" Ų "Ø¨ØąØ¯Ø§Øą" ŲØ§Ø˛Ų
Ø¯Ø§ØąŲ. ÛŲ ØŦدŲŲ Ø¨Ø˛ØąÚ¯ ŲžØą Ø§Ø˛ ؚدد ØąŲ ØĒØĩŲØą ÚŠŲ ÚŠŲ ŲŲ
ŲâØ´ŲŲ ØąŲ ŲŲ
Ø˛Ų
اŲ ØļØąØ¨ Ų
ÛâÚŠŲÛ.
+* **ÛادگÛØąÛ ØšŲ
ÛŲ**: اÛŲ ÛŲ Ø˛ÛØąØ´Ø§ØŽŲ Ø§Ø˛ ÛادگÛØąÛ Ų
اشÛŲŲØ ŲžØŗ ŲŲ
ŲŲ ŲØļÛŲ ØĩدŲ Ų
ÛâÚŠŲŲ. ŲŲØˇ اÛŲ ÚŠŲ ÛŲ ØŦدŲŲ ؚدد Ø¨ØąØ§Û ØļØąØ¨ ÚŠØąØ¯Ų ŲÛØŗØĒØ Ø¨ŲÚŠŲ ÛŲ Ų
ØŦŲ
ŲØšŲ Ø¨Ø˛ØąÚ¯ Ø§Ø˛ اŲŲا ŲØŗØĒØ Ų ØĒŲÛ ØŽÛŲÛ Ų
ŲØ§ØąØ¯ Ø§Ø˛ ÛŲ ŲžØąØ¯Ø§Ø˛ŲدŲ ؎اØĩ Ø¨ØąØ§Û Øŗا؎ØĒ Ų / Ûا اØŗØĒŲادŲ Ø§Ø˛ اÛŲ Ų
دŲâŲا اØŗØĒŲادŲ Ų
ÛâÚŠŲÛ.
+
+### ŲŲ
âØ˛Ų
اŲÛ + Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û: Ųب + ÛادگÛØąÛ Ų
اشÛŲ
+
+با **FastAPI** Ų
ÛâØĒŲŲÛ Ø§Ø˛ ŲŲ
âØ˛Ų
اŲÛ ÚŠŲ Ø¨ØąØ§Û ØĒŲØŗØšŲ Ųب ØŽÛŲÛ ØąØ§ÛØŦŲ (ŲŲ
ŲŲ ØŦذابÛØĒ اØĩŲÛ NodeJS) اØŗØĒŲادŲ ÚŠŲÛ.
+
+ŲŲÛ Ų
ÛâØĒŲŲÛ Ø§Ø˛ ŲŲاÛد Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û Ų ÚŲدŲžØąØ¯Ø§Ø˛Ø´Û (اØŦØąØ§Û ÚŲد ŲžØąŲØŗŲ بŲâØĩŲØąØĒ Ų
ŲØ§Ø˛Û) Ø¨ØąØ§Û ÚŠØ§ØąØ§Û **CPU bound** Ų
ØĢŲ ØŗÛØŗØĒŲ
âŲØ§Û ÛادگÛØąÛ Ų
اشÛŲ ŲŲ
بŲØąŲ Ø¨Ø¨ØąÛ.
+
+اÛŲØ Ø¨ŲâØšŲاŲŲ اÛŲ ŲاŲØšÛØĒ ØŗادŲ ÚŠŲ ŲžØ§ÛØĒŲŲ Ø˛Ø¨ŲŲ اØĩŲÛ Ø¨ØąØ§Û **ØšŲŲ
دادŲ**Ø ÛادگÛØąÛ Ų
اشÛŲ Ų بŲâØŽØĩŲØĩ ÛادگÛØąÛ ØšŲ
ÛŲŲØ Ø¨Ø§ØšØĢ Ų
ÛâØ´Ų FastAPI ÛŲ اŲØĒ؎اب ØŽÛŲÛ ØŽŲب Ø¨ØąØ§Û APIŲا Ų Ø¨ØąŲاŲ
ŲâŲØ§Û Ųب ØšŲŲ
دادŲ / ÛادگÛØąÛ Ų
اشÛŲ باشŲ (بÛŲ ØŽÛŲÛ ÚÛØ˛Ø§Û Ø¯ÛÚ¯Ų).
+
+Ø¨ØąØ§Û Ø¯ÛدŲ اÛŲÚŠŲ ÚØˇŲØą ØĒŲÛ Ų
ØÛØˇ ŲاŲØšÛ Ø¨Ų اÛŲ Ų
ŲØ§Ø˛ÛâØŗØ§Ø˛Û Ø¨ØąØŗÛØ Ø¨ØŽØ´ [اØŗØĒŲØąØ§Øą](deployment/index.md){.internal-link target=_blank} ØąŲ ببÛŲ.
+
+## `async` Ų `await`
+
+ŲØŗØŽŲâŲØ§Û Ų
Ø¯ØąŲ ŲžØ§ÛØĒŲŲ ÛŲ ØąØ§Ų ØŽÛŲÛ ØŗادŲ Ų ŲابŲâŲŲŲ
Ø¨ØąØ§Û ØĒØšØąÛŲ ڊد ŲاŲŲ
âØ˛Ų
اŲ Ø¯Ø§ØąŲ. اÛŲ باؚØĢ Ų
ÛâØ´Ų Ų
ØĢŲ ڊد "ØĒØąØĒÛبÛ" Ų
ØšŲ
ŲŲÛ Ø¨Ų ŲØ¸Øą بÛاد Ų ØĒŲÛ ŲØظŲâŲØ§Û Ø¯ØąØŗØĒ "اŲØĒØ¸Ø§Øą" ØąŲ Ø¨ØąØ§ØĒ اŲØŦاŲ
بدŲ.
+
+ŲŲØĒÛ ÛŲ ØšŲ
ŲÛاØĒÛ ŲØŗØĒ ÚŠŲ ŲبŲ Ø§Ø˛ دادŲ ŲØĒÛØŦŲâŲا ŲÛØ§Ø˛ بŲ اŲØĒØ¸Ø§Øą Ø¯Ø§ØąŲ Ų Ø§Ø˛ اÛŲ ŲابŲÛØĒâŲØ§Û ØŦدÛد ŲžØ§ÛØĒŲŲ ŲžØ´ØĒÛباŲÛ Ų
ÛâÚŠŲŲØ Ų
ÛâØĒŲŲÛ Ø§ÛŲØŦŲØąÛ ÚŠØ¯ŲŲÛØŗÛØ´ ÚŠŲÛ:
+
+```Python
+burgers = await get_burgers(2)
+```
+
+ŲÚŠØĒŲ ÚŠŲÛØ¯Û Ø§ÛŲØŦا `await` ŲØŗØĒ. بŲ ŲžØ§ÛØĒŲŲ Ų
ÛâÚ¯Ų ÚŠŲ باÛد ⸠Ų
ŲØĒØ¸Øą بŲ
ŲŲŲ ØĒا `get_burgers(2)` ÚŠØ§ØąØ´ đ ØĒŲ
ŲŲ
بشŲ ŲبŲ Ø§Ø˛ اÛŲÚŠŲ ŲØĒÛØŦŲâŲا ØąŲ ØĒŲÛ `burgers` Ø°ØŽÛØąŲ ÚŠŲŲ. با اÛŲØ ŲžØ§ÛØĒŲŲ Ų
ÛâدŲŲŲ ÚŠŲ Ų
ÛâØĒŲŲŲ Ø¨ØąŲ ÛŲ ÚŠØ§Øą دÛÚ¯Ų đ ⯠ØĒŲÛ Ø§ÛŲ Ų
دØĒ بڊŲŲ (Ų
ØĢŲ Ú¯ØąŲØĒŲ ÛŲ Ø¯ØąØŽŲاØŗØĒ دÛÚ¯Ų).
+
+Ø¨ØąØ§Û Ø§ÛŲÚŠŲ `await` ÚŠØ§Øą ÚŠŲŲØ Ø¨Ø§Ûد ØĒŲÛ ÛŲ ØĒابؚ باشŲ ÚŠŲ Ø§Ø˛ اÛŲ ŲاŲŲ
âØ˛Ų
اŲÛ ŲžØ´ØĒÛباŲÛ ÚŠŲŲ. Ø¨ØąØ§Û Ø§ÛŲ ÚŠØ§ØąØ ŲŲØˇ با `async def` ØĒØšØąÛŲØ´ Ų
ÛâÚŠŲÛ:
+
+```Python hl_lines="1"
+async def get_burgers(number: int):
+ # ÛŲ ØŗØąÛ ÚŠØ§Øą ŲاŲŲ
âØ˛Ų
اŲ Ø¨ØąØ§Û Øŗا؎ØĒŲ Ø¨ØąÚ¯ØąŲا اŲØŦاŲ
بدŲ
+ return burgers
+```
+
+...بŲ ØŦØ§Û `def`:
+
+```Python hl_lines="2"
+# اÛŲ ŲاŲŲ
âØ˛Ų
اŲ ŲÛØŗØĒ
+def get_sequential_burgers(number: int):
+ # ÛŲ ØŗØąÛ ÚŠØ§Øą ØĒØąØĒÛØ¨Û Ø¨ØąØ§Û Øŗا؎ØĒŲ Ø¨ØąÚ¯ØąŲا اŲØŦاŲ
بدŲ
+ return burgers
+```
+
+با `async def`Ø ŲžØ§ÛØĒŲŲ Ų
ÛâدŲŲŲ ÚŠŲ ØĒŲÛ Ø§ŲŲ ØĒابؚ باÛد ØŲاØŗØ´ بŲ ØšØ¨Ø§ØąØĒâŲØ§Û `await` باشŲØ Ų Ų
ÛâØĒŲŲŲ اØŦØąØ§Û Ø§ŲŲ ØĒابؚ ØąŲ "Ų
ŲŲØĒاŲ Ų
ØĒŲŲŲ" ⸠ڊŲŲ Ų Ø¨ØąŲ ÛŲ ÚŠØ§Øą دÛÚ¯Ų đ ŲبŲ Ø§Ø˛ Ø¨ØąÚ¯Ø´ØĒŲ بڊŲŲ.
+
+ŲŲØĒÛ Ų
ÛâØŽŲØ§Û ÛŲ ØĒابؚ `async def` ØąŲ Øĩدا ÚŠŲÛØ Ø¨Ø§Ûد "Ų
ŲØĒØ¸ØąØ´" بŲ
ŲŲÛ. ŲžØŗ اÛŲ ÚŠØ§Øą ŲŲ
ÛâÚŠŲŲ:
+
+```Python
+# اÛŲ ÚŠØ§Øą ŲŲ
ÛâÚŠŲŲØ ÚŲŲ get_burgers با async def ØĒØšØąÛŲ شدŲ
+burgers = get_burgers(2)
+```
+
+---
+
+ŲžØŗØ Ø§Ú¯Ų Ø§Ø˛ ÛŲ ÚŠØĒاب؎ŲŲŲ اØŗØĒŲادŲ Ų
ÛâÚŠŲÛ ÚŠŲ بŲØĒ Ų
ÛâÚ¯Ų Ų
ÛâØĒŲŲÛ Ø¨Ø§ `await` Øĩداش ÚŠŲÛØ Ø¨Ø§Ûد *ØĒŲابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØąØĒ* ÚŠŲ Ø§Ø˛Ø´ اØŗØĒŲادŲ Ų
ÛâÚŠŲŲ ØąŲ با `async def` بØŗØ§Ø˛ÛØ Ų
ØĢŲ:
+
+```Python hl_lines="2-3"
+@app.get('/burgers')
+async def read_burgers():
+ burgers = await get_burgers(2)
+ return burgers
+```
+
+### ØŦØ˛ØĻÛاØĒ ŲŲÛâØĒØą
+
+شاÛد Ų
ØĒŲØŦŲ شدŲ Ø¨Ø§Ø´Û ÚŠŲ `await` ŲŲØˇ ØĒŲÛ ØĒŲØ§Ø¨ØšÛ ÚŠŲ با `async def` ØĒØšØąÛŲ شدŲ Ų
ÛâØĒŲŲŲ اØŗØĒŲادŲ بشŲ.
+
+ŲŲÛ Ø¯Øą ØšÛŲ ØاŲØ ØĒŲØ§Ø¨ØšÛ ÚŠŲ با `async def` ØĒØšØąÛŲ شدŲ باÛد "Ų
ŲØĒØ¸Øą"Ø´ŲŲ بŲ
ŲŲÛ. ŲžØŗ ØĒŲابؚ با `async def` ŲŲØˇ ØĒŲÛ ØĒŲØ§Ø¨ØšÛ ÚŠŲ با `async def` ØĒØšØąÛŲ شدŲ Ų
ÛâØĒŲŲŲ Øĩدا Ø˛Ø¯Ų بشŲ.
+
+ØاŲØ§Ø ŲØļÛŲ Ų
ØąØē Ų ØĒØŽŲ
âŲ
ØąØē ÚÛŲØ ÚØˇŲØą اŲŲÛŲ ØĒابؚ `async` ØąŲ Øĩدا Ų
ÛâÚŠŲÛØ
+
+اگŲ با **FastAPI** ÚŠØ§Øą Ų
ÛâÚŠŲÛØ ŲØ§Ø˛Ų
ŲÛØŗØĒ ŲÚ¯ØąØ§Ų اÛŲ باشÛØ ÚŲŲ اŲŲ "اŲŲÛŲ" ØĒØ§Ø¨ØšØ *ØĒابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØąØĒ* ŲØŗØĒØ Ų FastAPI Ų
ÛâدŲŲŲ ÚØˇŲØą ÚŠØ§Øą Ø¯ØąØŗØĒ ØąŲ بڊŲŲ.
+
+ŲŲÛ Ø§Ú¯Ų ب؎ŲØ§Û Ø¨Ø¯ŲŲ FastAPI Ø§Ø˛ `async` / `await` اØŗØĒŲادŲ ÚŠŲÛØ Ø§ÛŲŲ
Ų
Ų
ÚŠŲŲ.
+
+### ڊد ŲاŲŲ
âØ˛Ų
اŲ ØŽŲدØĒ ØąŲ بŲŲÛØŗ
+
+Starlette (Ų **FastAPI**) Ø¨Øą ŲžØ§ÛŲ AnyIO ŲØŗØĒŲØ ÚŠŲ باؚØĢ Ų
ÛâØ´Ų با ÚŠØĒاب؎ŲŲŲ اØŗØĒاŲØ¯Ø§ØąØ¯ ŲžØ§ÛØĒŲŲ asyncio Ų Trio ØŗØ§Ø˛Ú¯Ø§Øą باشŲ.
+
+بŲâØŽØĩŲØĩØ Ų
ÛâØĒŲŲÛ Ų
ØŗØĒŲÛŲ
اŲ Ø§Ø˛ AnyIO Ø¨ØąØ§Û Ų
ŲØ§ØąØ¯ اØŗØĒŲادŲ ŲžÛØ´ØąŲØĒŲ ŲŲ
âØ˛Ų
اŲÛ ÚŠŲ ŲÛØ§Ø˛ بŲ اŲÚ¯ŲŲØ§Û ŲžÛÚÛدŲâØĒØą ØĒŲÛ ÚŠØ¯ ØŽŲدØĒ Ø¯Ø§ØąŲ اØŗØĒŲادŲ ÚŠŲÛ.
+
+Ų ØØĒÛ Ø§Ú¯Ų Ø§Ø˛ FastAPI اØŗØĒŲادŲ ŲÚŠŲÛØ Ų
ÛâØĒŲŲÛ Ø¨ØąŲاŲ
ŲâŲØ§Û ŲاŲŲ
âØ˛Ų
اŲ ØŽŲدØĒ ØąŲ با AnyIO بŲŲÛØŗÛ ØĒا ØŽÛŲÛ ØŗØ§Ø˛Ú¯Ø§Øą باشŲ Ų ŲŲاÛدش ØąŲ بگÛØąÛ (Ų
ØĢŲ *ŲŲ
âØ˛Ų
اŲÛ Øŗا؎ØĒØ§ØąÛاŲØĒŲ*).
+
+Ų
Ų ÛŲ ÚŠØĒاب؎ŲŲŲ دÛÚ¯Ų ØąŲÛ AnyIO Øŗا؎ØĒŲ
Ø ÛŲ ŲاÛŲ ŲØ§Ø˛ÚŠ ØąŲØ´Ø ØĒا ÛŲ ÚŠŲ
annotationŲØ§Û ŲŲØš ØąŲ بŲØĒØą ÚŠŲŲ
Ų **ØĒÚŠŲ
ÛŲ ØŽŲØ¯ÚŠØ§Øą** بŲØĒØąØ **ØŽØˇØ§ŲØ§Û Ø¯ØąŲŲâØŽØˇÛ** Ų ØēÛØąŲ بگÛØąŲ
. ÛŲ Ų
ŲدŲ
Ų Ų ØĸŲ
ŲØ˛Ø´ ØŗادŲ ŲŲ
Ø¯Ø§ØąŲ ÚŠŲ بŲØĒ ÚŠŲ
ÚŠ Ų
ÛâÚŠŲŲ **بŲŲŲ
Û** Ų **ڊد ŲاŲŲ
âØ˛Ų
اŲ ØŽŲدØĒ ØąŲ بŲŲÛØŗÛ**: Asyncer. اگŲ ب؎ŲØ§Û **ڊد ŲاŲŲ
âØ˛Ų
اŲ ØąŲ با ڊد Ų
ØšŲ
ŲŲÛ** (بŲاڊâÚŠŲŲدŲ/ŲŲ
âØ˛Ų
اŲ) ØĒØąÚŠÛب ÚŠŲÛ ØŽÛŲÛ Ø¨ŲâØ¯ØąØ¯ØĒ Ų
ÛâØŽŲØąŲ.
+
+### Ø´ÚŠŲâŲØ§Û Ø¯ÛÚ¯Ų ڊد ŲاŲŲ
âØ˛Ų
اŲ
+
+اÛŲ Øŗبڊ اØŗØĒŲادŲ Ø§Ø˛ `async` Ų `await` ØĒŲÛ Ø˛Ø¨ŲŲ ŲØŗبØĒاŲ ØŦدÛدŲ.
+
+ŲŲÛ ÚŠØ§Øą با ڊد ŲاŲŲ
âØ˛Ų
اŲ ØąŲ ØŽÛŲÛ ØŗادŲâØĒØą Ų
ÛâÚŠŲŲ.
+
+ŲŲ
ÛŲ ØŗÛŲØĒÚŠØŗ (Ûا ØĒŲØąÛباŲ ÛÚŠØŗاŲ) ا؎ÛØąØ§Ų ØĒŲÛ ŲØŗØŽŲâŲØ§Û Ų
Ø¯ØąŲ ØŦاŲااØŗÚŠØąÛŲžØĒ (ØĒŲÛ Ų
ØąŲØąÚ¯Øą Ų NodeJS) ŲŲ
اØļاŲŲ شدŲ.
+
+ŲŲÛ ŲبŲ Ø§Ø˛ اŲŲØ Ų
دÛØąÛØĒ ڊد ŲاŲŲ
âØ˛Ų
اŲ ØŽÛŲÛ ŲžÛÚÛدŲâØĒØą Ų ØŗØŽØĒâØĒØą بŲد.
+
+ØĒŲÛ ŲØŗØŽŲâŲØ§Û ŲبŲÛ ŲžØ§ÛØĒŲŲØ Ų
ÛâØĒŲŲØŗØĒÛ Ø§Ø˛ ŲØŽâŲا Ûا Gevent اØŗØĒŲادŲ ÚŠŲÛ. ŲŲÛ ÚŠØ¯ ØŽÛŲÛ ŲžÛÚÛدŲâØĒØą Ų
ÛâØ´Ų Ø¨ØąØ§Û ŲŲŲ
ÛدŲØ Ø¯Ûباگ ÚŠØąØ¯Ų Ų ŲÚŠØą ÚŠØąØ¯Ų بŲØ´.
+
+ØĒŲÛ ŲØŗØŽŲâŲØ§Û ŲبŲÛ NodeJS / ØŦاŲااØŗÚŠØąÛŲžØĒ Ų
ØąŲØąÚ¯ØąØ Ø§Ø˛ "ڊاŲâبڊâŲا" اØŗØĒŲادŲ Ų
ÛâÚŠØąØ¯Û. ÚŠŲ Ų
ÛâØąØŗÛد بŲ ØŦŲاŲ ڊاŲâبڊâŲا.
+
+## ÚŠØąŲØĒÛŲâŲا
+
+**ÚŠØąŲØĒÛŲ** ŲŲØˇ ÛŲ اØĩØˇŲØ§Ø ØŽÛŲÛ Ø´ÛÚŠ Ø¨ØąØ§Û ÚÛØ˛ÛŲ ÚŠŲ ÛŲ ØĒابؚ `async def` Ø¨ØąŲ
ÛâÚ¯ØąØ¯ŲŲŲ. ŲžØ§ÛØĒŲŲ Ų
ÛâدŲŲŲ ÚŠŲ اÛŲ ÛŲ ÚÛØ˛Û Ų
ØĢŲ ØĒابؚ ŲØŗØĒØ Ų
ÛâØĒŲŲŲ Ø´ØąŲØš بشŲ Ų ÛŲ ØŦاÛÛ ØĒŲ
ŲŲ
بشŲØ ŲŲÛ Ų
Ų
ÚŠŲŲ دا؎ŲØ´ ŲŲ
Ų
ŲŲŲ ⸠بشŲØ ŲØą ŲŲØĒ ÛŲ `await` ØĒŲØ´ باشŲ.
+
+ŲŲÛ ŲŲ
Ų اÛŲ ŲابŲÛØĒ اØŗØĒŲادŲ Ø§Ø˛ ڊد ŲاŲŲ
âØ˛Ų
اŲ با `async` Ų `await` ØŽÛŲÛ ŲŲØĒا ØŽŲاØĩŲ Ų
ÛâØ´Ų بŲ اØŗØĒŲادŲ Ø§Ø˛ "ÚŠØąŲØĒÛŲâŲا". اÛŲ ŲابŲ Ų
ŲاÛØŗŲ با ŲÛÚÚ¯Û Ø§ØĩŲÛ GoØ ÛØšŲÛ "GoroutineŲا" ŲØŗØĒ.
+
+## ŲØĒÛØŦŲâÚ¯ÛØąÛ
+
+بÛاÛد ŲŲ
ŲŲ ØŦŲ
ŲŲ Ø§Ø˛ باŲا ØąŲ ببÛŲÛŲ
:
+
+> ŲØŗØŽŲâŲØ§Û Ų
Ø¯ØąŲ ŲžØ§ÛØĒŲŲ Ø§Ø˛ **"ڊد ŲاŲŲ
âØ˛Ų
اŲ"** با ÚÛØ˛Û ÚŠŲ بŲØ´ **"ÚŠØąŲØĒÛŲ"** Ų
ÛâÚ¯Ų ŲžØ´ØĒÛباŲÛ Ų
ÛâÚŠŲŲØ Ø¨Ø§ ØŗÛŲØĒÚŠØŗ **`async` Ų `await`**.
+
+ØاŲا باÛد بÛØ´ØĒØą Ø¨ØąØ§ØĒ Ų
ØšŲÛ Ø¨Ø¯Ų. â¨
+
+ŲŲ
Ų اÛŲا ÚÛØ˛ÛŲ ÚŠŲ بŲ FastAPI (Ø§Ø˛ ØˇØąÛŲ Starlette) ŲØ¯ØąØĒ Ų
ÛâدŲ Ų باؚØĢ Ų
ÛâØ´Ų ØšŲ
ŲÚŠØąØ¯ ÚØ´Ų
Ú¯ÛØąÛ Ø¯Ø§Ø´ØĒŲ باشŲ.
+
+## ØŦØ˛ØĻÛاØĒ ØŽÛŲÛ ŲŲÛ
+
+/// warning
+
+اØØĒŲ
اŲاŲ Ų
ÛâØĒŲŲÛ Ø§ÛŲŲ ØąØ¯ ÚŠŲÛ.
+
+اÛŲا ØŦØ˛ØĻÛاØĒ ØŽÛŲÛ ŲŲÛ Ø§Ø˛ ŲØŲŲ ÚŠØ§Øą **FastAPI** Ø˛ÛØą ŲžŲØŗØĒŲâØŗØĒ.
+
+اگŲ ÛŲ ÚŠŲ
داŲØ´ ŲŲÛ (ÚŠØąŲØĒÛŲâŲØ§Ø ŲØŽâŲØ§Ø Ø¨Ųاڊ ÚŠØąØ¯Ų Ų ØēÛØąŲ) Ø¯Ø§ØąÛ Ų ÚŠŲØŦڊاŲÛ ÚŠŲ FastAPI ÚØˇŲØą `async def` ØąŲ Ø¯Øą Ų
ŲابŲ `def` Ų
ØšŲ
ŲŲÛ Ų
دÛØąÛØĒ Ų
ÛâÚŠŲŲØ Ø§Ø¯Ø§Ų
Ų بدŲ.
+
+///
+
+### ØĒŲابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØą
+
+ŲŲØĒÛ ÛŲ *ØĒابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØą* ØąŲ با `def` Ų
ØšŲ
ŲŲÛ Ø¨Ų ØŦØ§Û `async def` ØĒØšØąÛŲ Ų
ÛâÚŠŲÛØ ØĒŲÛ ÛŲ اØŗØĒØŽØą ŲØŽ ØŽØ§ØąØŦÛ Ø§ØŦØąØ§ Ų
ÛâØ´Ų ÚŠŲ بؚدش Ų
ŲØĒØ¸ØąØ´ Ų
ÛâŲ
ŲŲŲØ Ø¨Ų ØŦØ§Û Ø§ÛŲÚŠŲ Ų
ØŗØĒŲÛŲ
Øĩداش ÚŠŲŲ (ÚŲŲ ØŗØąŲØą ØąŲ بŲاڊ Ų
ÛâÚŠŲŲ).
+
+اگŲ Ø§Ø˛ ÛŲ ŲØąÛŲ
âŲØąÚŠ ŲاŲŲ
âØ˛Ų
اŲ دÛÚ¯Ų Ų
ÛØ§Û ÚŠŲ بŲ ØąŲØ´ باŲا ÚŠØ§Øą ŲŲ
ÛâÚŠŲŲ Ų ؚادØĒ Ø¯Ø§ØąÛ *ØĒŲابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØą* ØŗادŲ ŲŲØˇ Ų
ØاØŗباØĒÛ ØąŲ با `def` Ų
ØšŲ
ŲŲÛ Ø¨ØąØ§Û ÛŲ ØŗŲد ÚŠŲÚÛÚŠ ØšŲ
ŲÚŠØąØ¯ (ØدŲد 100 ŲاŲŲØĢاŲÛŲ) ØĒØšØąÛŲ ÚŠŲÛØ ØĒŲØŦŲ ÚŠŲ ÚŠŲ ØĒŲÛ **FastAPI** اØĢØąØ´ ڊاŲ
ŲاŲ Ø¨ØąØšÚŠØŗŲ. ØĒŲÛ Ø§ÛŲ Ų
ŲØ§ØąØ¯Ø Ø¨ŲØĒØąŲ Ø§Ø˛ `async def` اØŗØĒŲادŲ ÚŠŲÛ Ų
Ú¯Ų اÛŲÚŠŲ *ØĒŲابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØąØĒ* ÚŠØ¯Û Ø¯Ø§Ø´ØĒŲ باشŲ ÚŠŲ ØšŲ
ŲÛاØĒ I/O بŲاڊâÚŠŲŲدŲ اŲØŦاŲ
بدŲ.
+
+با اÛŲ ØاŲØ ØĒŲÛ ŲØą دŲ Ų
ŲŲØšÛØĒØ Ø§ØØĒŲ
اŲØ´ Ø˛ÛادŲ ÚŠŲ **FastAPI** ŲŲŲØ˛ [ØŗØąÛØšâØĒØą](index.md#performance){.internal-link target=_blank} Ø§Ø˛ ŲØąÛŲ
âŲØąÚŠ ŲبŲÛâاØĒ باشŲ (Ûا ØداŲŲ ŲابŲ Ų
ŲاÛØŗŲ باŲاش).
+
+### ŲابØŗØĒÚ¯ÛâŲا
+
+ŲŲ
ÛŲ Ø¨ØąØ§Û [ŲابØŗØĒÚ¯ÛâŲا](tutorial/dependencies/index.md){.internal-link target=_blank} ŲŲ
ØĩدŲ Ų
ÛâÚŠŲŲ. اگŲ ÛŲ ŲابØŗØĒÚ¯Û ÛŲ ØĒابؚ `def` Ų
ØšŲ
ŲŲÛ Ø¨Ų ØŦØ§Û `async def` باشŲØ ØĒŲÛ Ø§ØŗØĒØŽØą ŲØŽ ØŽØ§ØąØŦÛ Ø§ØŦØąØ§ Ų
ÛâØ´Ų.
+
+### Ø˛ÛØąŲابØŗØĒÚ¯ÛâŲا
+
+Ų
ÛâØĒŲŲÛ ÚŲد ØĒا ŲابØŗØĒÚ¯Û Ų [Ø˛ÛØąŲابØŗØĒÚ¯Û](tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} داشØĒŲ Ø¨Ø§Ø´Û ÚŠŲ ŲŲ
دÛÚ¯Ų ØąŲ ŲÛØ§Ø˛ Ø¯Ø§ØąŲ (بŲâØšŲŲاŲ ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û ØĒØšØąÛŲ ØĒابؚ)Ø Ø¨ØšØļÛâŲاشŲŲ Ų
Ų
ÚŠŲŲ با `async def` Øŗا؎ØĒŲ بشŲ Ų بؚØļÛâŲا با `def` Ų
ØšŲ
ŲŲÛ. Ø¨Ø§Ø˛Ų
ÚŠØ§Øą Ų
ÛâÚŠŲŲØ Ų اŲŲاÛÛ ÚŠŲ با `def` Ų
ØšŲ
ŲŲÛ Øŗا؎ØĒŲ شدŲ ØĒŲÛ ÛŲ ŲØŽ ØŽØ§ØąØŦÛ (Ø§Ø˛ اØŗØĒØŽØą ŲØŽ) Øĩدا Ø˛Ø¯Ų Ų
ÛâØ´Ų بŲ ØŦØ§Û Ø§ÛŲÚŠŲ "Ų
ŲØĒØ¸ØąØ´ŲŲ" بŲ
ŲŲŲ.
+
+### ØĒŲابؚ ÚŠØ§ØąØ¨ØąØ¯Û Ø¯ÛÚ¯Ų
+
+ŲØą ØĒابؚ ÚŠØ§ØąØ¨ØąØ¯Û Ø¯ÛÚ¯ŲâØ§Û ÚŠŲ Ų
ØŗØĒŲÛŲ
ØŽŲدØĒ Øĩداش Ų
ÛâÚŠŲÛ Ų
ÛâØĒŲŲŲ با `def` Ų
ØšŲ
ŲŲÛ Ûا `async def` Øŗا؎ØĒŲ بشŲ Ų FastAPI ØąŲ ŲØŲŲ ØĩØ¯Ø§Ø˛Ø¯ŲØ´ ØĒØŖØĢÛØą ŲŲ
ÛâØ°Ø§ØąŲ.
+
+اÛŲ Ø¨ØąØŽŲاŲ ØĒŲØ§Ø¨ØšÛ ŲØŗØĒ ÚŠŲ FastAPI Ø¨ØąØ§ØĒ ØĩداشŲŲ Ų
ÛâÚŠŲŲ: *ØĒŲابؚ ØšŲ
ŲÛاØĒ Ų
ØŗÛØą* Ų ŲابØŗØĒÚ¯ÛâŲا.
+
+اگŲ ØĒابؚ ÚŠØ§ØąØ¨ØąØ¯ÛØĒ ÛŲ ØĒابؚ Ų
ØšŲ
ŲŲÛ Ø¨Ø§ `def` باشŲØ Ų
ØŗØĒŲÛŲ
Øĩداش Ų
ÛâÚŠŲŲ (ŲŲ
ŲŲâØˇŲØą ÚŠŲ ØĒŲÛ ÚŠØ¯ØĒ ŲŲØ´ØĒÛ)Ø ŲŲ ØĒŲÛ Ø§ØŗØĒØŽØą ŲØŽØ Ø§Ú¯Ų ØĒابؚ با `async def` Øŗا؎ØĒŲ شدŲ باشŲØ Ø¨Ø§Ûد ŲŲØĒÛ ØĒŲÛ ÚŠØ¯ØĒ Øĩداش Ų
ÛâÚŠŲÛ `await`Ø´ ÚŠŲÛ.
+
+---
+
+دŲØ¨Ø§ØąŲØ Ø§ÛŲا ØŦØ˛ØĻÛاØĒ ØŽÛŲÛ ŲŲÛ ŲØŗØĒŲ ÚŠŲ اØØĒŲ
اŲاŲ اگŲ دŲباŲØ´ŲŲ اŲŲ
دŲ Ø¨Ø§Ø´Û Ø¨ØąØ§ØĒ Ų
ŲÛد باشŲ.
+
+ŲÚ¯ØąŲŲØ Ø¨Ø§ ØąØ§ŲŲŲ
اÛÛâŲØ§Û Ø¨ØŽØ´ باŲا باÛد ØŽŲب باشÛ: ØšØŦŲŲ Ø¯Ø§ØąÛØ.
diff --git a/docs/fa/docs/environment-variables.md b/docs/fa/docs/environment-variables.md
new file mode 100644
index 000000000..75309ce1f
--- /dev/null
+++ b/docs/fa/docs/environment-variables.md
@@ -0,0 +1,298 @@
+# Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ
+
+/// tip
+
+اگŲ Ø§Ø˛ ŲبŲ Ų
ÛâدŲŲÛ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ ÚÛ ŲØŗØĒŲ Ų ÚØˇŲØą Ø§Ø˛Ø´ŲŲ اØŗØĒŲادŲ Ų
ÛâØ´ŲØ Ų
ÛâØĒŲŲÛ Ø§ÛŲ ب؎ش ØąŲ ØąØ¯ ÚŠŲÛ.
+
+///
+
+ÛŲ Ų
ØĒØēÛØą Ų
ØÛØˇÛ (ÚŠŲ بŲØ´ "**env var**" ŲŲ
Ų
ÛâÚ¯Ų) ÛŲ Ų
ØĒØēÛØąÛŲ ÚŠŲ **ØŽØ§ØąØŦ** Ø§Ø˛ ڊد ŲžØ§ÛØĒŲŲØ ØĒŲÛ **ØŗÛØŗØĒŲ
âؚاŲ
Ų** Ø˛ŲØ¯Ú¯Û Ų
ÛâÚŠŲŲ Ų Ų
ÛâØĒŲŲŲ ØĒŲØŗØˇ ڊد ŲžØ§ÛØĒŲŲØĒ (Ûا Ø¨ØąŲاŲ
ŲâŲØ§Û Ø¯ÛÚ¯Ų) ØŽŲŲدŲ بشŲ.
+
+Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ Ų
ÛâØĒŲŲŲ Ø¨ØąØ§Û Ų
دÛØąÛØĒ **ØĒŲظÛŲ
اØĒ** Ø¨ØąŲاŲ
ŲØ Ø¨ŲâØšŲŲاŲ Ø¨ØŽØ´Û Ø§Ø˛ **ŲØĩب** ŲžØ§ÛØĒŲŲ Ų ØēÛØąŲ Ų
ŲÛد باشŲ.
+
+## Øŗا؎ØĒ Ų اØŗØĒŲادŲ Ø§Ø˛ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ
+
+Ų
ÛâØĒŲŲÛ Ų
ØĒØēÛØąŲØ§Û Ų
ØÛØˇÛ ØąŲ ØĒŲÛ **Ø´Ų (ØĒØąŲ
ÛŲاŲ)** **بØŗØ§Ø˛Û** Ų Ø§Ø˛Ø´ŲŲ اØŗØĒŲادŲ ÚŠŲÛØ Ø¨Ø¯ŲŲ اÛŲÚŠŲ بŲ ŲžØ§ÛØĒŲŲ ŲÛØ§Ø˛ داشØĒŲ باشÛ:
+
+//// tab | ŲÛŲŲÚŠØŗØ Ų
ÚŠâاŲاØŗØ ŲÛŲدŲØ˛ بش
+
+
+
+### ŲŲØš اØļاŲŲ ÚŠŲ
+
+بÛا ŲŲØˇ ÛŲ ØŽØˇ Ø§Ø˛ ŲØŗØŽŲ ŲبŲÛ ØąŲ ØĒØēÛÛØą بدÛŲ
.
+
+دŲÛŲاŲ اÛŲ Ø¨ØŽØ´Ø ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û ØĒابؚ ØąŲØ Ø§Ø˛:
+
+```Python
+ first_name, last_name
+```
+
+بŲ:
+
+```Python
+ first_name: str, last_name: str
+```
+
+ØšŲØļ Ų
ÛâÚŠŲÛŲ
.
+
+ŲŲ
ÛŲŲ.
+
+اÛŲا ŲŲ
ŲŲ "ŲŲØšâŲŲ
اŲا" ŲØŗØĒŲ:
+
+{* ../../docs_src/python_types/tutorial002.py hl[1] *}
+
+اÛŲ با ØĒØšØąÛŲ Ų
ŲØ¯Ø§Øą ŲžÛØ´âŲØąØļ ŲØąŲ Ø¯Ø§ØąŲØ Ų
ØĢŲ:
+
+```Python
+ first_name="john", last_name="doe"
+```
+
+ÛŲ ÚÛØ˛ Ų
ØĒŲاŲØĒŲ.
+
+Ų
ا Ø§Ø˛ دŲŲŲØˇŲ (`:`) اØŗØĒŲادŲ Ų
ÛâÚŠŲÛŲ
Ø ŲŲ ØšŲاŲ
ØĒ Ų
ØŗاŲÛ (`=`)â.
+
+Ų اØļاŲŲ ÚŠØąØ¯Ų ŲŲØšâŲŲ
اŲا Ų
ØšŲ
ŲŲاŲ ÚÛØ˛Û ÚŠŲ اØĒŲاŲ Ų
ÛâاŲØĒŲ ØąŲ Ø§Ø˛ ÚÛØ˛Û ÚŠŲ بدŲŲ اŲŲا Ų
ÛâاŲØĒاد ØĒØēÛÛØą ŲŲ
ÛâدŲ.
+
+ŲŲÛ ØاŲØ§Ø Ø¯ŲØ¨Ø§ØąŲ ØĒØĩŲØą ÚŠŲ ŲØŗØˇ Øŗا؎ØĒŲ اŲŲ ØĒابؚ ŲØŗØĒÛØ ŲŲÛ Ø§ÛŲ Ø¨Ø§Øą با ŲŲØšâŲŲ
اŲا.
+
+ØĒŲÛ ŲŲ
ŲŲ ŲŲØˇŲØ ØŗØšÛ Ų
ÛâÚŠŲÛ ØĒÚŠŲ
ÛŲ ØŽŲØ¯ÚŠØ§Øą ØąŲ با `Ctrl+Space` ŲؚاŲ ÚŠŲÛ Ų اÛŲŲ Ų
ÛâبÛŲÛ:
+
+
+
+با اÛŲØ Ų
ÛâØĒŲŲÛ Ø§ØŗÚŠØąŲŲ ÚŠŲÛØ Ú¯Ø˛ÛŲŲâŲا ØąŲ ببÛŲÛØ ØĒا ŲŲØĒÛ ÚŠŲ اŲŲ ÚÛØ˛Û ÚŠŲ "بŲ ŲØ¸ØąØĒ ØĸØ´Ųا Ų
Ûاد" ØąŲ ŲžÛدا ÚŠŲÛ:
+
+
+
+## اŲÚ¯ÛØ˛Ų بÛØ´ØĒØą
+
+اÛŲ ØĒابؚ ØąŲ ÚÚŠ ÚŠŲØ Ø§ŲاŲ ŲŲØšâŲŲ
ا Ø¯Ø§ØąŲ:
+
+{* ../../docs_src/python_types/tutorial003.py hl[1] *}
+
+ÚŲŲ ŲÛØąØ§ÛØ´Ú¯Øą ŲŲØš Ų
ØĒØēÛØąŲا ØąŲ Ų
ÛâدŲŲŲØ ŲŲØˇ ØĒÚŠŲ
ÛŲ ØŽŲØ¯ÚŠØ§Øą ŲŲ
ÛâÚ¯ÛØąÛØ Ø¨ŲÚŠŲ ÚÚŠ ØŽØˇØ§Ųا ŲŲ
Ø¯Ø§ØąÛ:
+
+
+
+ØاŲا Ų
ÛâدŲŲÛ ÚŠŲ باÛد Ø¯ØąØŗØĒØ´ ÚŠŲÛØ `age` ØąŲ با `str(age)` بŲ ÛŲ ØąØ´ØĒŲ ØĒبدÛŲ ÚŠŲÛ:
+
+{* ../../docs_src/python_types/tutorial004.py hl[2] *}
+
+## ØĒØšØąÛŲ ŲŲØšâŲا
+
+ØĒØ§Ø˛Ų اØĩŲÛâØĒØąÛŲ ØŦا Ø¨ØąØ§Û ØĒØšØąÛŲ ŲŲØšâŲŲ
اŲا ØąŲ دÛدÛ. بŲâØšŲŲاŲ ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û ØĒابؚ.
+
+اÛŲ ŲŲ
اØĩŲÛâØĒØąÛŲ ØŦاÛÛŲ ÚŠŲ با **FastAPI** Ø§Ø˛Ø´ŲŲ اØŗØĒŲادŲ Ų
ÛâÚŠŲÛ.
+
+### ŲŲØšâŲØ§Û ØŗادŲ
+
+Ų
ÛâØĒŲŲÛ ŲŲ
Ų ŲŲØšâŲØ§Û Ø§ØŗØĒاŲØ¯Ø§ØąØ¯ ŲžØ§ÛØĒŲŲ ØąŲ ØĒØšØąÛŲ ÚŠŲÛØ ŲŲ ŲŲØˇ `str`.
+
+Ų
ØĢŲاŲ Ų
ÛâØĒŲŲÛ Ø§Ø˛ اÛŲا اØŗØĒŲادŲ ÚŠŲÛ:
+
+* `int`
+* `float`
+* `bool`
+* `bytes`
+
+{* ../../docs_src/python_types/tutorial005.py hl[1] *}
+
+### ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û Ø¨Ø§ ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û ŲŲØš
+
+ÛŲ ØŗØąÛ Øŗا؎ØĒØ§Øą دادŲ ŲØŗØĒŲ ÚŠŲ Ų
ÛâØĒŲŲŲ Ų
ŲØ¯Ø§ØąŲØ§Û Ø¯ÛÚ¯Ų ØąŲ ŲÚ¯Ų Ø¯Ø§ØąŲØ Ų
ØĢŲ `dict`Ø `list`Ø `set` Ų `tuple`. Ų Ų
ŲØ¯Ø§ØąŲØ§Û Ø¯Ø§ØŽŲÛØ´ŲŲ ŲŲ
Ų
ÛâØĒŲŲŲ ŲŲØš ØŽŲدشŲŲ ØąŲ داشØĒŲ باشŲ.
+
+بŲ اÛŲ ŲŲØšâŲا ÚŠŲ ŲŲØšâŲØ§Û Ø¯Ø§ØŽŲÛ Ø¯Ø§ØąŲ Ų
ÛâÚ¯Ų "**ØšŲ
ŲŲ
Û**" Ûا "generic". Ų Ų
ÛâØ´Ų اŲŲا ØąŲ ØĒØšØąÛŲ ÚŠØąØ¯Ø ØØĒÛ Ø¨Ø§ ŲŲØšâŲØ§Û Ø¯Ø§ØŽŲÛØ´ŲŲ.
+
+Ø¨ØąØ§Û ØĒØšØąÛŲ اÛŲ ŲŲØšâŲا Ų ŲŲØšâŲØ§Û Ø¯Ø§ØŽŲÛØ´ŲŲØ Ų
ÛâØĒŲŲÛ Ø§Ø˛ Ų
اÚŲŲ اØŗØĒاŲØ¯Ø§ØąØ¯ ŲžØ§ÛØĒŲŲ `typing` اØŗØĒŲادŲ ÚŠŲÛ. اÛŲ Ų
اÚŲŲ Ų
ØŽØĩŲØĩ ŲžØ´ØĒÛباŲÛ Ø§Ø˛ ŲŲØšâŲŲ
اŲاØŗØĒ.
+
+#### ŲØŗØŽŲâŲØ§Û ØŦدÛدØĒØą ŲžØ§ÛØĒŲŲ
+
+ØŗÛŲØĒÚŠØŗ با اØŗØĒŲادŲ Ø§Ø˛ `typing` با ŲŲ
Ų ŲØŗØŽŲâŲØ§Ø Ø§Ø˛ ŲžØ§ÛØĒŲŲ 3.6 ØĒا ØŦدÛدØĒØąÛŲâŲØ§Ø Ø§Ø˛ ØŦŲ
ŲŲ ŲžØ§ÛØĒŲŲ 3.9Ø 3.10 Ų ØēÛØąŲ **ØŗØ§Ø˛Ú¯Ø§ØąŲ**.
+
+با ŲžÛØ´ØąŲØĒ ŲžØ§ÛØĒŲŲØ **ŲØŗØŽŲâŲØ§Û ØŦدÛدØĒØą** ŲžØ´ØĒÛباŲÛ Ø¨ŲØĒØąÛ Ø¨ØąØ§Û Ø§ÛŲ ŲŲØšâŲŲ
اŲا Ø¯Ø§ØąŲ Ų ØĒŲÛ ØŽÛŲÛ Ų
ŲØ§ØąØ¯ ØØĒÛ ŲØ§Ø˛Ų
ŲÛØŗØĒ Ų
اÚŲŲ `typing` ØąŲ ŲØ§ØąØ¯ ÚŠŲÛ Ų Ø§Ø˛Ø´ Ø¨ØąØ§Û ØĒØšØąÛŲ ŲŲØšâŲŲ
اŲا اØŗØĒŲادŲ ÚŠŲÛ.
+
+اگŲ بØĒŲŲÛ Ø¨ØąØ§Û ŲžØąŲÚŲâاØĒ Ø§Ø˛ ÛŲ ŲØŗØŽŲ ØŦدÛدØĒØą ŲžØ§ÛØĒŲŲ اØŗØĒŲادŲ ÚŠŲÛØ Ų
ÛâØĒŲŲÛ Ø§Ø˛ اÛŲ ØŗØ§Ø¯Ú¯Û Ø§ØļاŲŲ بŲØąŲ Ø¨Ø¨ØąÛ.
+
+ØĒŲÛ ŲŲ
Ų Ų
ØŗØĒŲداØĒØ Ų
ØĢاŲâŲاÛÛ ŲØŗØĒŲ ÚŠŲ با ŲØą ŲØŗØŽŲ ŲžØ§ÛØĒŲŲ ØŗØ§Ø˛Ú¯Ø§ØąŲ (ŲŲØĒÛ ØĒŲاŲØĒÛ ŲØŗØĒ).
+
+Ų
ØĢŲاŲ "**Python 3.6+**" ÛØšŲÛ Ø¨Ø§ ŲžØ§ÛØĒŲŲ 3.6 Ûا باŲاØĒØą (Ų
ØĢŲ 3.7Ø 3.8Ø 3.9Ø 3.10 Ų ØēÛØąŲ) ØŗØ§Ø˛Ú¯Ø§ØąŲ. Ų "**Python 3.9+**" ÛØšŲÛ Ø¨Ø§ ŲžØ§ÛØĒŲŲ 3.9 Ûا باŲاØĒØą (Ų
ØĢŲ 3.10 Ų ØēÛØąŲ) ØŗØ§Ø˛Ú¯Ø§ØąŲ.
+
+اگŲ بØĒŲŲÛ Ø§Ø˛ **ØŦدÛدØĒØąÛŲ ŲØŗØŽŲâŲØ§Û ŲžØ§ÛØĒŲŲ** اØŗØĒŲادŲ ÚŠŲÛØ Ø§Ø˛ Ų
ØĢاŲâŲØ§Û ŲØŗØŽŲ ØĸØŽØą اØŗØĒŲادŲ ÚŠŲØ ÚŲŲ اŲŲا **بŲØĒØąÛŲ Ų ØŗادŲâØĒØąÛŲ ØŗÛŲØĒÚŠØŗ** ØąŲ Ø¯Ø§ØąŲØ Ų
ØĢŲاŲ "**Python 3.10+**".
+
+#### ŲÛØŗØĒ
+
+Ų
ØĢŲاŲØ Ø¨ÛاÛŲ
ÛŲ Ų
ØĒØēÛØą ØĒØšØąÛŲ ÚŠŲÛŲ
ÚŠŲ ÛŲ `list` Ø§Ø˛ `str` باشŲ.
+
+//// tab | Python 3.9+
+
+Ų
ØĒØēÛØą ØąŲ با ŲŲ
ŲŲ ØŗÛŲØĒÚŠØŗ دŲŲŲØˇŲ (`:`) ØĒØšØąÛŲ ÚŠŲ.
+
+بŲâØšŲŲاŲ ŲŲØšØ `list` ØąŲ Ø¨Ø°Ø§Øą.
+
+ÚŲŲ ŲÛØŗØĒ ÛŲ ŲŲØšŲ ÚŠŲ ŲŲØšâŲØ§Û Ø¯Ø§ØŽŲÛ Ø¯Ø§ØąŲØ Ø§ŲŲا ØąŲ ØĒŲÛ ÚŠØąŲØ´ŲâŲا Ų
ÛâØ°Ø§ØąÛ:
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial006_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+Ø§Ø˛ `typing`Ø `List` ØąŲ (با `L` Ø¨Ø˛ØąÚ¯) ŲØ§ØąØ¯ ÚŠŲ:
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial006.py!}
+```
+
+Ų
ØĒØēÛØą ØąŲ با ŲŲ
ŲŲ ØŗÛŲØĒÚŠØŗ دŲŲŲØˇŲ (`:`) ØĒØšØąÛŲ ÚŠŲ.
+
+بŲâØšŲŲاŲ ŲŲØšØ `List` ØąŲ ÚŠŲ Ø§Ø˛ `typing` ŲØ§ØąØ¯ ÚŠØąØ¯Û Ø¨Ø°Ø§Øą.
+
+ÚŲŲ ŲÛØŗØĒ ÛŲ ŲŲØšŲ ÚŠŲ ŲŲØšâŲØ§Û Ø¯Ø§ØŽŲÛ Ø¯Ø§ØąŲØ Ø§ŲŲا ØąŲ ØĒŲÛ ÚŠØąŲØ´ŲâŲا Ų
ÛâØ°Ø§ØąÛ:
+
+```Python hl_lines="4"
+{!> ../../docs_src/python_types/tutorial006.py!}
+```
+
+////
+
+/// info
+
+اŲŲ ŲŲØšâŲØ§Û Ø¯Ø§ØŽŲÛ ØĒŲÛ ÚŠØąŲØ´ŲâŲا بŲØ´ŲŲ "ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û ŲŲØš" Ų
ÛâÚ¯Ų.
+
+ØĒŲÛ Ø§ÛŲ Ų
ŲØąØ¯Ø `str` ŲžØ§ØąØ§Ų
ØĒØą ŲŲØšÛŲ ÚŠŲ بŲ `List` (Ûا `list` ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.9 Ų باŲاØĒØą) ŲžØ§Øŗ دادŲ شدŲ.
+
+///
+
+ÛØšŲÛ: "Ų
ØĒØēÛØą `items` ÛŲ `list` ŲØŗØĒØ Ų ŲØą ڊدŲŲ
Ø§Ø˛ ØĸÛØĒŲ
âŲØ§Û Ø§ÛŲ ŲÛØŗØĒ ÛŲ `str` ŲØŗØĒŲ".
+
+/// tip
+
+اگŲ Ø§Ø˛ ŲžØ§ÛØĒŲŲ 3.9 Ûا باŲاØĒØą اØŗØĒŲادŲ Ų
ÛâÚŠŲÛØ ŲØ§Ø˛Ų
ŲÛØŗØĒ `List` ØąŲ Ø§Ø˛ `typing` ŲØ§ØąØ¯ ÚŠŲÛØ Ų
ÛâØĒŲŲÛ ŲŲ
ŲŲ ŲŲØš Ų
ØšŲ
ŲŲÛ `list` ØąŲ بŲ ØŦاش اØŗØĒŲادŲ ÚŠŲÛ.
+
+///
+
+با اÛŲ ÚŠØ§ØąØ ŲÛØąØ§ÛØ´Ú¯ØąØĒ ØØĒÛ ŲŲØĒÛ Ø¯Ø§ØąÛ ØĸÛØĒŲ
âŲØ§Û ŲÛØŗØĒ ØąŲ ŲžØąØ¯Ø§Ø˛Ø´ Ų
ÛâÚŠŲÛ Ø¨ŲØĒ ÚŠŲ
ÚŠ Ų
ÛâÚŠŲŲ:
+
+
+
+بدŲŲ ŲŲØšâŲØ§Ø ØąØŗÛدŲ بŲ اÛŲ ØĒŲØąÛباŲ ØēÛØąŲ
Ų
ÚŠŲŲ.
+
+ØĒŲØŦŲ ÚŠŲ ÚŠŲ Ų
ØĒØēÛØą `item` ÛÚŠÛ Ø§Ø˛ ØšŲاØĩØą ØĒŲÛ ŲÛØŗØĒ `items` ŲØŗØĒ.
+
+Ų با اÛŲ ØاŲØ ŲÛØąØ§ÛØ´Ú¯Øą Ų
ÛâدŲŲŲ ÚŠŲ ÛŲ `str` ŲØŗØĒ Ų Ø¨ØąØ§Ø´ ŲžØ´ØĒÛباŲÛ Ų
ÛâدŲ.
+
+#### ØĒاŲžŲ Ų ØŗØĒ
+
+Ø¨ØąØ§Û ØĒØšØąÛŲ `tuple`Ųا Ų `set`Ųا ŲŲ
ŲŲ
ÛŲ ÚŠØ§Øą ØąŲ Ų
ÛâÚŠŲÛ:
+
+//// 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!}
+```
+
+////
+
+ÛØšŲÛ:
+
+* Ų
ØĒØēÛØą `items_t` ÛŲ `tuple` با 3 ØĒا ØĸÛØĒŲ
ŲØ ÛŲ `int`Ø ÛŲ `int` دÛÚ¯ŲØ Ų ÛŲ `str`.
+* Ų
ØĒØēÛØą `items_s` ÛŲ `set` ŲØŗØĒØ Ų ŲØą ڊدŲŲ
Ø§Ø˛ ØĸÛØĒŲ
âŲاش Ø§Ø˛ ŲŲØš `bytes` ŲØŗØĒŲ.
+
+#### دÛÚŠØ´ŲØąÛ
+
+Ø¨ØąØ§Û ØĒØšØąÛŲ ÛŲ `dict`Ø 2 ØĒا ŲžØ§ØąØ§Ų
ØĒØą ŲŲØš Ų
ÛâدÛØ ÚŠŲ با ڊاŲ
ا Ø§Ø˛ ŲŲ
ØŦدا شدŲ.
+
+ŲžØ§ØąØ§Ų
ØĒØą ŲŲØš اŲŲ Ø¨ØąØ§Û ÚŠŲÛدŲØ§Û `dict` ŲØŗØĒ.
+
+ŲžØ§ØąØ§Ų
ØĒØą ŲŲØš دŲŲ
Ø¨ØąØ§Û Ų
ŲØ¯Ø§ØąŲØ§Û `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!}
+```
+
+////
+
+ÛØšŲÛ:
+
+* Ų
ØĒØēÛØą `prices` ÛŲ `dict` ŲØŗØĒ:
+ * ÚŠŲÛدŲØ§Û Ø§ÛŲ `dict` Ø§Ø˛ ŲŲØš `str` ŲØŗØĒŲ (Ų
ØĢŲاŲ اØŗŲ
ŲØą ØĸÛØĒŲ
).
+ * Ų
ŲØ¯Ø§ØąŲØ§Û Ø§ÛŲ `dict` Ø§Ø˛ ŲŲØš `float` ŲØŗØĒŲ (Ų
ØĢŲاŲ ŲÛŲ
ØĒ ŲØą ØĸÛØĒŲ
).
+
+#### اØĒØادÛŲ
+
+Ų
ÛâØĒŲŲÛ ØĒØšØąÛŲ ÚŠŲÛ ÚŠŲ ÛŲ Ų
ØĒØēÛØą Ų
ÛâØĒŲŲŲ ŲØą ڊدŲŲ
Ø§Ø˛ **ÚŲد ØĒا ŲŲØš** باشŲØ Ų
ØĢŲاŲ ÛŲ `int` Ûا ÛŲ `str`.
+
+ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.6 Ų باŲاØĒØą (Ø§Ø˛ ØŦŲ
ŲŲ ŲžØ§ÛØĒŲŲ 3.10) Ų
ÛâØĒŲŲÛ Ø§Ø˛ ŲŲØš `Union` ØĒŲÛ `typing` اØŗØĒŲادŲ ÚŠŲÛ Ų ŲŲØšâŲØ§Û Ų
Ų
ÚŠŲ ØąŲ ØĒŲÛ ÚŠØąŲØ´ŲâŲا Ø¨Ø°Ø§ØąÛ.
+
+ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.10 ÛŲ **ØŗÛŲØĒÚŠØŗ ØŦدÛد** ŲŲ
ŲØŗØĒ ÚŠŲ Ų
ÛâØĒŲŲÛ ŲŲØšâŲØ§Û Ų
Ų
ÚŠŲ ØąŲ با ÛŲ ØŽØˇ ØšŲ
ŲØ¯Û (`|`) ØŦدا ÚŠŲÛ.
+
+//// 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!}
+```
+
+////
+
+ØĒŲÛ ŲØą دŲ ØاŲØĒ ÛØšŲÛ `item` Ų
ÛâØĒŲŲŲ ÛŲ `int` Ûا ÛŲ `str` باشŲ.
+
+#### شاÛد `None`
+
+Ų
ÛâØĒŲŲÛ ØĒØšØąÛŲ ÚŠŲÛ ÚŠŲ ÛŲ Ų
ŲØ¯Ø§Øą Ų
ÛâØĒŲŲŲ ÛŲ ŲŲØš باشŲØ Ų
ØĢŲاŲ `str`Ø ŲŲÛ Ų
ÛâØĒŲŲŲ `None` ŲŲ
باشŲ.
+
+ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.6 Ų باŲاØĒØą (Ø§Ø˛ ØŦŲ
ŲŲ ŲžØ§ÛØĒŲŲ 3.10) Ų
ÛâØĒŲŲÛ Ø¨Ø§ ŲØ§ØąØ¯ ÚŠØąØ¯Ų Ų اØŗØĒŲادŲ Ø§Ø˛ `Optional` Ø§Ø˛ Ų
اÚŲŲ `typing` اÛŲŲ ØĒØšØąÛŲ ÚŠŲÛ.
+
+```Python hl_lines="1 4"
+{!../../docs_src/python_types/tutorial009.py!}
+```
+
+اØŗØĒŲادŲ Ø§Ø˛ `Optional[str]` بŲ ØŦØ§Û ŲŲØˇ `str` بŲ ŲÛØąØ§ÛØ´Ú¯Øą ÚŠŲ
ÚŠ Ų
ÛâÚŠŲŲ ØŽØˇØ§ŲاÛÛ ÚŠŲ Ų
Ų
ÚŠŲŲ ŲÚŠØą ÚŠŲÛ ÛŲ Ų
ŲØ¯Ø§Øą ŲŲ
ÛØ´Ų `str` ŲØŗØĒ ØąŲ ŲžÛدا ÚŠŲŲØ Ø¯Øą ØاŲÛ ÚŠŲ Ų
ÛâØĒŲŲŲ `None` ŲŲ
باشŲ.
+
+`Optional[Something]` Ø¯Øą ŲاŲØš Ų
ÛاŲâØ¨Øą Ø¨ØąØ§Û `Union[Something, None]` ŲØŗØĒØ Ø§ÛŲ دŲ ØĒا Ų
ؚادŲŲ.
+
+ÛØšŲÛ ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.10Ø Ų
ÛâØĒŲŲÛ Ø§Ø˛ `Something | None` اØŗØĒŲادŲ ÚŠŲÛ:
+
+//// 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+ ØŦاÛÚ¯Ø˛ÛŲ
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial009b.py!}
+```
+
+////
+
+#### اØŗØĒŲادŲ Ø§Ø˛ `Union` Ûا `Optional`
+
+اگŲ Ø§Ø˛ ŲØŗØŽŲ ŲžØ§ÛØĒŲŲ Ø˛ÛØą 3.10 اØŗØĒŲادŲ Ų
ÛâÚŠŲÛØ ÛŲ ŲÚŠØĒŲ Ø§Ø˛ دÛد ØŽÛŲÛ **Ø´ØŽØĩÛ** ØŽŲدŲ
:
+
+* đ¨ Ø§Ø˛ `Optional[SomeType]` اØŗØĒŲادŲ ŲÚŠŲ
+* بŲ ØŦاش ⨠**Ø§Ø˛ `Union[SomeType, None]` اØŗØĒŲادŲ ÚŠŲ** â¨.
+
+ŲØą دŲ Ų
ؚادŲŲ Ų Ø˛ÛØą ŲžŲØŗØĒŲ ÛÚŠÛâاŲØ ŲŲÛ Ų
Ų `Union` ØąŲ بŲ `Optional` ØĒØąØŦÛØ Ų
ÛâدŲ
ÚŲŲ ÚŠŲŲ
Ų "**ا؎ØĒÛØ§ØąÛ**" اŲÚ¯Ø§Øąæį¤ē Ų
ÛâÚŠŲŲ ÚŠŲ Ų
ŲØ¯Ø§Øą ا؎ØĒÛØ§ØąÛŲØ Ø¯Øą ØاŲÛ ÚŠŲ Ø¯Øą ŲاŲØš ÛØšŲÛ "Ų
ÛâØĒŲŲŲ `None` باشŲ"Ø ØØĒÛ Ø§Ú¯Ų ا؎ØĒÛØ§ØąÛ ŲباشŲ Ų ŲŲŲØ˛ ŲØ§Ø˛Ų
باشŲ.
+
+ŲÚŠØą Ų
ÛâÚŠŲŲ
`Union[SomeType, None]` ŲاØļØâØĒØą ŲØ´ŲŲ Ų
ÛâدŲ ÚÛ Ų
ØšŲÛ Ų
ÛâدŲ.
+
+ŲŲØˇ بØØĢ ÚŠŲŲ
اØĒ Ų اØŗŲ
âŲاØŗØĒ. ŲŲÛ Ø§ÛŲ ÚŠŲŲ
اØĒ Ų
ÛâØĒŲŲŲ ØąŲ ØˇØąØ˛ ŲÚŠØą ØĒŲ Ų ØĒÛŲ
ØĒ ŲØŗبØĒ بŲ ڊد ØĒØŖØĢÛØą Ø¨Ø°Ø§ØąŲ.
+
+بŲâØšŲŲاŲ Ų
ØĢاŲØ Ø§ÛŲ ØĒابؚ ØąŲ ببÛŲ:
+
+{* ../../docs_src/python_types/tutorial009c.py hl[1,4] *}
+
+ŲžØ§ØąØ§Ų
ØĒØą `name` بŲâØšŲŲاŲ `Optional[str]` ØĒØšØąÛŲ شدŲØ ŲŲÛ **ا؎ØĒÛØ§ØąÛ ŲÛØŗØĒ**Ø ŲŲ
ÛâØĒŲŲÛ ØĒابؚ ØąŲ بدŲŲ ŲžØ§ØąØ§Ų
ØĒØą Øĩدا ÚŠŲÛ:
+
+```Python
+say_hi() # اŲŲ ŲŲØ Ø§ÛŲ ØŽØˇØ§ Ų
ÛâدŲ! đą
+```
+
+ŲžØ§ØąØ§Ų
ØĒØą `name` **ŲŲŲØ˛ ŲØ§Ø˛Ų
Ų** (ŲŲ *ا؎ØĒÛØ§ØąÛ*) ÚŲŲ Ų
ŲØ¯Ø§Øą ŲžÛØ´âŲØąØļ ŲØ¯Ø§ØąŲ. با اÛŲ ØاŲØ `name` Ų
ŲØ¯Ø§Øą `None` ØąŲ ŲبŲŲ Ų
ÛâÚŠŲŲ:
+
+```Python
+say_hi(name=None) # اÛŲ ÚŠØ§Øą Ų
ÛâÚŠŲŲØ None Ų
ØšØĒØ¨ØąŲ đ
+```
+
+ØŽØ¨Øą ØŽŲب اÛŲŲ ÚŠŲ ŲŲØĒÛ ØąŲ ŲžØ§ÛØĒŲŲ 3.10 باشÛØ ŲØ§Ø˛Ų
ŲÛØŗØĒ ŲÚ¯ØąØ§Ų اÛŲ باشÛØ ÚŲŲ Ų
ÛâØĒŲŲÛ Ø¨ŲâØŗØ§Ø¯Ú¯Û Ø§Ø˛ `|` Ø¨ØąØ§Û ØĒØšØąÛŲ اØĒØادÛŲ ŲŲØšâŲا اØŗØĒŲادŲ ÚŠŲÛ:
+
+{* ../../docs_src/python_types/tutorial009c_py310.py hl[1,4] *}
+
+اŲŲ Ų
ŲŲØš دÛÚ¯Ų ŲØ§Ø˛Ų
ŲÛØŗØĒ ŲÚ¯ØąØ§Ų اØŗŲ
âŲاÛÛ Ų
ØĢŲ `Optional` Ų `Union` باشÛ. đ
+
+#### ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û
+
+اÛŲ ŲŲØšâŲاÛÛ ÚŠŲ ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û ŲŲØš ØąŲ ØĒŲÛ ÚŠØąŲØ´ŲâŲا Ų
ÛâÚ¯ÛØąŲ بŲØ´ŲŲ **ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û** Ûا **Generics** Ų
ÛâÚ¯ŲØ Ų
ØĢŲاŲ:
+
+//// tab | Python 3.10+
+
+Ų
ÛâØĒŲŲÛ Ø§Ø˛ ŲŲ
ŲŲ ŲŲØšâŲØ§Û Ø¯Ø§ØŽŲÛ Ø¨ŲâØšŲŲاŲ ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û Ø§ØŗØĒŲادŲ ÚŠŲÛ (با ÚŠØąŲØ´ŲâŲا Ų ŲŲØšâŲا دا؎ŲØ´ŲŲ):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+Ų ŲŲ
ŲŲâØˇŲØą ÚŠŲ ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.8 بŲØ¯Ø Ø§Ø˛ Ų
اÚŲŲ `typing`:
+
+* `Union`
+* `Optional` (ŲŲ
ŲŲâØˇŲØą ÚŠŲ ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.8 بŲد)
+* ...Ų بŲÛŲ.
+
+ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.10Ø Ø¨ŲâØšŲŲاŲ ØŦاÛÚ¯Ø˛ÛŲ Ø¨ØąØ§Û Ø§ØŗØĒŲادŲ Ø§Ø˛ ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û `Union` Ų `Optional`Ø Ų
ÛâØĒŲŲÛ Ø§Ø˛ ØŽØˇ ØšŲ
ŲØ¯Û (`|`) Ø¨ØąØ§Û ØĒØšØąÛŲ اØĒØادÛŲ ŲŲØšâŲا اØŗØĒŲادŲ ÚŠŲÛØ ÚŠŲ ØŽÛŲÛ Ø¨ŲØĒØą Ų ØŗادŲâØĒØąŲ.
+
+////
+
+//// tab | Python 3.9+
+
+Ų
ÛâØĒŲŲÛ Ø§Ø˛ ŲŲ
ŲŲ ŲŲØšâŲØ§Û Ø¯Ø§ØŽŲÛ Ø¨ŲâØšŲŲاŲ ŲŲØšâŲØ§Û ØšŲ
ŲŲ
Û Ø§ØŗØĒŲادŲ ÚŠŲÛ (با ÚŠØąŲØ´ŲâŲا Ų ŲŲØšâŲا دا؎ŲØ´ŲŲ):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+Ų ŲŲ
ŲŲâØˇŲØą ÚŠŲ ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.8 بŲØ¯Ø Ø§Ø˛ Ų
اÚŲŲ `typing`:
+
+* `Union`
+* `Optional`
+* ...Ų بŲÛŲ.
+
+////
+
+//// tab | Python 3.8+
+
+* `List`
+* `Tuple`
+* `Set`
+* `Dict`
+* `Union`
+* `Optional`
+* ...Ų بŲÛŲ.
+
+////
+
+### ÚŠŲاØŗâŲا بŲâØšŲŲاŲ ŲŲØš
+
+Ų
ÛâØĒŲŲÛ ÛŲ ÚŠŲاØŗ ØąŲ ŲŲ
بŲâØšŲŲاŲ ŲŲØš ÛŲ Ų
ØĒØēÛØą ØĒØšØąÛŲ ÚŠŲÛ.
+
+ŲØąØļ ÚŠŲ ÛŲ ÚŠŲاØŗ `Person` Ø¯Ø§ØąÛØ Ø¨Ø§ ÛŲ ŲاŲ
:
+
+{* ../../docs_src/python_types/tutorial010.py hl[1:3] *}
+
+بؚد Ų
ÛâØĒŲŲÛ ÛŲ Ų
ØĒØēÛØą ØąŲ Ø§Ø˛ ŲŲØš `Person` ØĒØšØąÛŲ ÚŠŲÛ:
+
+{* ../../docs_src/python_types/tutorial010.py hl[6] *}
+
+Ų Ø¨ØšØ¯Ø Ø¯ŲØ¨Ø§ØąŲØ ŲŲ
Ų ŲžØ´ØĒÛباŲÛ ŲÛØąØ§ÛØ´Ú¯Øą ØąŲ Ø¯Ø§ØąÛ:
+
+
+
+ØĒŲØŦŲ ÚŠŲ ÚŠŲ اÛŲ ÛØšŲÛ "`one_person` ÛŲ **ŲŲ
ŲŲŲ** Ø§Ø˛ ÚŠŲاØŗ `Person` ŲØŗØĒ".
+
+ÛØšŲÛ "`one_person` ØŽŲد **ÚŠŲاØŗ** بŲ اØŗŲ
`Person` ŲÛØŗØĒ".
+
+## Ų
دŲâŲØ§Û Pydantic
+
+Pydantic ÛŲ ÚŠØĒاب؎ŲŲŲ ŲžØ§ÛØĒŲŲŲ Ø¨ØąØ§Û Ø§ØšØĒØ¨Ø§ØąØŗŲØŦÛ Ø¯Ø§Ø¯ŲâŲا.
+
+"Ø´ÚŠŲ" دادŲâŲا ØąŲ بŲâØšŲŲاŲ ÚŠŲاØŗâŲاÛÛ Ø¨Ø§ ŲÛÚÚ¯ÛâŲا ØĒØšØąÛŲ Ų
ÛâÚŠŲÛ.
+
+Ų ŲØą ŲÛÚÚ¯Û ÛŲ ŲŲØš Ø¯Ø§ØąŲ.
+
+بؚد ÛŲ ŲŲ
ŲŲŲ Ø§Ø˛ اŲŲ ÚŠŲاØŗ ØąŲ با ÛŲ ØŗØąÛ Ų
ŲØ¯Ø§Øą Ų
ÛâØŗØ§Ø˛Û Ų اŲŲ Ų
ŲØ¯Ø§ØąŲا ØąŲ اؚØĒØ¨Ø§ØąØŗŲØŦÛ Ų
ÛâÚŠŲŲØ Ø¨Ų ŲŲØš Ų
ŲاØŗب ØĒبدÛŲØ´ŲŲ Ų
ÛâÚŠŲŲ (اگŲ ŲØ§Ø˛Ų
باشŲ) Ų ÛŲ Ø´ÛØĄ با ŲŲ
Ų دادŲâŲا بŲØĒ Ų
ÛâدŲ.
+
+Ų با اŲŲ Ø´ÛØĄ ŲŲاÛÛ ŲŲ
Ų ŲžØ´ØĒÛباŲÛ ŲÛØąØ§ÛØ´Ú¯Øą ØąŲ Ų
ÛâÚ¯ÛØąÛ.
+
+ÛŲ Ų
ØĢاŲ Ø§Ø˛ Ų
ØŗØĒŲداØĒ ØąØŗŲ
Û Pydantic:
+
+//// 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
+
+Ø¨ØąØ§Û Ø§ØˇŲاؚاØĒ بÛØ´ØĒØą Ø¯Øą Ų
ŲØąØ¯ PydanticØ Ų
ØŗØĒŲداØĒØ´ ØąŲ ÚÚŠ ÚŠŲ.
+
+///
+
+**FastAPI** ڊاŲ
ŲاŲ Ø¨Øą ŲžØ§ÛŲ Pydantic ŲØŗØĒ.
+
+ØĒŲÛ [ØĸŲ
ŲØ˛Ø´ - ØąØ§ŲŲŲ
Ø§Û ÚŠØ§ØąØ¨Øą](tutorial/index.md){.internal-link target=_blank} ØŽÛŲÛ Ø¨ÛØ´ØĒØą Ø§Ø˛ اÛŲا ØąŲ ØĒŲÛ ØšŲ
Ų Ų
ÛâبÛŲÛ.
+
+/// tip
+
+Pydantic ÛŲ ØąŲØĒØ§Øą ؎اØĩ Ø¯Ø§ØąŲ ŲŲØĒÛ Ø§Ø˛ `Optional` Ûا `Union[Something, None]` بدŲŲ Ų
ŲØ¯Ø§Øą ŲžÛØ´âŲØąØļ اØŗØĒŲادŲ Ų
ÛâÚŠŲÛØ Ų
ÛâØĒŲŲÛ ØĒŲÛ Ų
ØŗØĒŲداØĒ Pydantic Ø¯Øą Ų
ŲØąØ¯ ŲÛŲدŲØ§Û Ø§ØŽØĒÛØ§ØąÛ ŲØ§Ø˛Ų
بÛØ´ØĒØą ب؎ŲŲÛ.
+
+///
+
+## ŲŲØšâŲŲ
اŲا با AnnotationŲØ§Û Ų
ØĒادÛØĒا
+
+ŲžØ§ÛØĒŲŲ ÛŲ ŲابŲÛØĒ ŲŲ
Ø¯Ø§ØąŲ ÚŠŲ بŲØĒ اØŦØ§Ø˛Ų Ų
ÛâدŲ **Ų
ØĒادÛØĒا اØļاŲÛ** ØąŲ ØĒŲÛ Ø§ÛŲ ŲŲØšâŲŲ
اŲا Ø¨Ø°Ø§ØąÛ Ø¨Ø§ اØŗØĒŲادŲ Ø§Ø˛ `Annotated`.
+
+//// tab | Python 3.9+
+
+ØĒŲÛ ŲžØ§ÛØĒŲŲ 3.9Ø `Annotated` Ø¨ØŽØ´Û Ø§Ø˛ ÚŠØĒاب؎ŲŲŲ اØŗØĒاŲØ¯Ø§ØąØ¯ŲØ ŲžØŗ Ų
ÛâØĒŲŲÛ Ø§Ø˛ `typing` ŲØ§ØąØ¯Ø´ ÚŠŲÛ.
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial013_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+ØĒŲÛ ŲØŗØŽŲâŲØ§Û Ø˛ÛØą ŲžØ§ÛØĒŲŲ 3.9Ø `Annotated` ØąŲ Ø§Ø˛ `typing_extensions` ŲØ§ØąØ¯ Ų
ÛâÚŠŲÛ.
+
+با **FastAPI** Ø§Ø˛ ŲبŲ ŲØĩب شدŲ.
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial013.py!}
+```
+
+////
+
+ØŽŲد ŲžØ§ÛØĒŲŲ با اÛŲ `Annotated` ÚŠØ§ØąÛ ŲŲ
ÛâÚŠŲŲ. Ų Ø¨ØąØ§Û ŲÛØąØ§ÛØ´Ú¯ØąŲا Ų Ø§Ø¨Ø˛Ø§ØąŲØ§Û Ø¯ÛÚ¯ŲØ ŲŲØš ŲŲŲØ˛ `str` ŲØŗØĒ.
+
+ŲŲÛ Ų
ÛâØĒŲŲÛ Ø§Ø˛ اÛŲ ŲØļا ØĒŲÛ `Annotated` اØŗØĒŲادŲ ÚŠŲÛ ØĒا بŲ **FastAPI** Ų
ØĒادÛØĒØ§Û Ø§ØļاŲÛ Ø¯Øą Ų
ŲØąØ¯ اÛŲÚŠŲ ÚØˇŲØą Ų
ÛâØŽŲØ§Û Ø¨ØąŲاŲ
ŲâاØĒ ØąŲØĒØ§Øą ÚŠŲŲ بدÛ.
+
+ŲÚŠØĒŲ Ų
ŲŲ
اÛŲŲ ÚŠŲ **اŲŲÛŲ *ŲžØ§ØąØ§Ų
ØĒØą ŲŲØš*** ÚŠŲ بŲ `Annotated` Ų
ÛâدÛØ **ŲŲØš ŲاŲØšÛ** ŲØŗØĒ. بŲÛØ´ ŲŲØˇ Ų
ØĒادÛØĒا Ø¨ØąØ§Û Ø§Ø¨Ø˛Ø§ØąŲØ§Û Ø¯ÛÚ¯ŲâØŗØĒ.
+
+اŲاŲ ŲŲØˇ باÛد بدŲŲÛ ÚŠŲ `Annotated` ŲØŦŲد Ø¯Ø§ØąŲØ Ų اÛŲÚŠŲ ŲžØ§ÛØĒŲŲ اØŗØĒاŲØ¯Ø§ØąØ¯Ų. đ
+
+بؚداŲ Ų
ÛâبÛŲÛ ÚŠŲ ÚŲØ¯Øą **ŲŲÛ** Ų
ÛâØĒŲŲŲ باشŲ.
+
+/// tip
+
+اÛŲÚŠŲ اÛŲ **ŲžØ§ÛØĒŲŲ اØŗØĒاŲØ¯Ø§ØąØ¯Ų** ÛØšŲÛ ŲŲŲØ˛ **بŲØĒØąÛŲ ØĒØŦØąØ¨Ų ØĒŲØŗØšŲâدŲŲدŲ** ØąŲ ØĒŲÛ ŲÛØąØ§ÛØ´Ú¯ØąØĒØ Ø¨Ø§ Ø§Ø¨Ø˛Ø§ØąŲاÛÛ ÚŠŲ Ø¨ØąØ§Û ØĒØŲÛŲ Ų Ø¨Ø§Ø˛ØŗØ§Ø˛Û ÚŠØ¯ØĒ اØŗØĒŲادŲ Ų
ÛâÚŠŲÛ Ų ØēÛØąŲ Ų
ÛâÚ¯ÛØąÛ. â¨
+
+Ų ŲŲ
ÛŲâØˇŲØą ڊدØĒ با ØŽÛŲÛ Ø§Ø˛ Ø§Ø¨Ø˛Ø§ØąŲا Ų ÚŠØĒاب؎ŲŲŲâŲØ§Û Ø¯ÛÚ¯Ų ŲžØ§ÛØĒŲŲ ØŽÛŲÛ ØŗØ§Ø˛Ú¯Ø§Øą Ų
ÛâŲ
ŲŲŲ. đ
+
+///
+
+## ŲŲØšâŲŲ
اŲا ØĒŲÛ **FastAPI**
+
+**FastAPI** Ø§Ø˛ اÛŲ ŲŲØšâŲŲ
اŲا اØŗØĒŲادŲ Ų
ÛâÚŠŲŲ ØĒا ÚŲد ØĒا ÚŠØ§Øą بڊŲŲ.
+
+با **FastAPI** ŲžØ§ØąØ§Ų
ØĒØąŲا ØąŲ با ŲŲØšâŲŲ
اŲا ØĒØšØąÛŲ Ų
ÛâÚŠŲÛ Ų اÛŲا ØąŲ Ų
ÛâÚ¯ÛØąÛ:
+
+* **ŲžØ´ØĒÛباŲÛ ŲÛØąØ§ÛØ´Ú¯Øą**.
+* **ÚÚŠ ŲŲØšâŲا**.
+
+...Ų **FastAPI** Ø§Ø˛ ŲŲ
ŲŲ ØĒØšØąÛŲâŲا Ø¨ØąØ§Û Ø§ÛŲا اØŗØĒŲادŲ Ų
ÛâÚŠŲŲ:
+
+* **ØĒØšØąÛŲ ŲÛØ§Ø˛Ųا**: Ø§Ø˛ ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û Ų
ØŗÛØą Ø¯ØąØŽŲاØŗØĒØ ŲžØ§ØąØ§Ų
ØĒØąŲØ§Û ÚŠŲØĻØąÛØ ŲØ¯ØąŲØ§Ø Ø¨Ø¯ŲŲâŲØ§Ø ŲابØŗØĒÚ¯ÛâŲا Ų ØēÛØąŲ.
+* **ØĒبدÛŲ دادŲ**: Ø§Ø˛ Ø¯ØąØŽŲاØŗØĒ بŲ ŲŲØš Ų
ŲØąØ¯ ŲÛØ§Ø˛.
+* **اؚØĒØ¨Ø§ØąØŗŲØŦÛ Ø¯Ø§Ø¯Ų**: ÚŠŲ Ø§Ø˛ ŲØą Ø¯ØąØŽŲاØŗØĒ Ų
Ûاد:
+ * ØĒŲŲÛد **ØŽØˇØ§ŲØ§Û ØŽŲØ¯ÚŠØ§Øą** ÚŠŲ بŲ ÚŠŲاÛŲØĒ Ø¨ØąŲ
ÛâÚ¯ØąØ¯Ų ŲŲØĒÛ Ø¯Ø§Ø¯Ų ŲاŲ
ØšØĒØ¨ØąŲ.
+* **Ų
ØŗØĒŲدØŗØ§Ø˛Û** API با اØŗØĒŲادŲ Ø§Ø˛ OpenAPI:
+ * ÚŠŲ بؚدش ØĒŲØŗØˇ ØąØ§Ø¨ØˇâŲØ§Û ÚŠØ§ØąØ¨ØąÛ Ų
ØŗØĒŲداØĒ ØĒؚاŲ
ŲÛ ØŽŲØ¯ÚŠØ§Øą اØŗØĒŲادŲ Ų
ÛâØ´Ų.
+
+اÛŲا شاÛد ŲŲ
ŲâØ´ اŲØĒØ˛Ø§ØšÛ Ø¨Ų ŲØ¸Øą بÛاد. ŲÚ¯ØąØ§Ų Ųباش. ŲŲ
Ų اÛŲا ØąŲ ØĒŲÛ ØšŲ
Ų ØĒŲÛ [ØĸŲ
ŲØ˛Ø´ - ØąØ§ŲŲŲ
Ø§Û ÚŠØ§ØąØ¨Øą](tutorial/index.md){.internal-link target=_blank} Ų
ÛâبÛŲÛ.
+
+ŲÚŠØĒŲ Ų
ŲŲ
اÛŲŲ ÚŠŲ با اØŗØĒŲادŲ Ø§Ø˛ ŲŲØšâŲØ§Û Ø§ØŗØĒاŲØ¯Ø§ØąØ¯ ŲžØ§ÛØĒŲŲØ ØĒŲÛ ÛŲ ØŦا (بŲ ØŦØ§Û Ø§ØļاŲŲ ÚŠØąØ¯Ų ÚŠŲاØŗâŲØ§Û Ø¨ÛØ´ØĒØąØ Ø¯ÚŠŲØąØ§ØĒŲØąŲا Ų ØēÛØąŲ)Ø **FastAPI** ÚŠŲÛ Ø§Ø˛ ÚŠØ§Øą ØąŲ Ø¨ØąØ§ØĒ اŲØŦاŲ
Ų
ÛâدŲ.
+
+/// info
+
+اگŲ ŲŲ
Ų ØĸŲ
ŲØ˛Ø´ ØąŲ Ú¯Ø°ØąŲŲØ¯Û Ų Ø¨ØąÚ¯Ø´ØĒÛ ÚŠŲ بÛØ´ØĒØą Ø¯Øą Ų
ŲØąØ¯ ŲŲØšâŲا ببÛŲÛØ ÛŲ Ų
Ųبؚ ØŽŲب "ØĒŲŲبâŲاŲ
Ų" Ø§Ø˛ `mypy` ŲØŗØĒ.
+
+///
diff --git a/docs/ja/docs/deployment/concepts.md b/docs/ja/docs/deployment/concepts.md
index c6b21fd1b..a0d4fb35b 100644
--- a/docs/ja/docs/deployment/concepts.md
+++ b/docs/ja/docs/deployment/concepts.md
@@ -219,7 +219,7 @@ FastAPI ãĸããĒãąãŧãˇã§ãŗã§ã¯ãUvicorn ãŽãããĒãĩãŧããŧãã
ããããŽã¯ãŧãĢãŧãģãããģãšã¯ããĸããĒãąãŧãˇã§ãŗãåŽčĄããããŽã§ããã**ãĒã¯ã¨ãšã**ãåããĻ**ãŦãšããŗãš**ãčŋããããŽä¸ģčĻãĒč¨įŽãčĄããããĒããå¤æ°ãĢå
ĨããããŽã¯äŊã§ãRAMãĢããŧãããžãã
-
+
+ë¤ėėŧëĄ, http://127.0.0.1:8000/subapi/docsėė íė ėėŠíëĄęˇ¸ë¨ė ëŦ¸ėëĨŧ ėŦėėė¤.
+
+íė ę˛ŊëĄ ė ëėŦ `/subapi` ėëė ė ė¸ë *ę˛ŊëĄ ëė* ė íŦí¨íë, íė ėėŠíëĄęˇ¸ë¨ė ëí ėë API ëŦ¸ėëĨŧ íė¸í ė ėėĩëë¤:
+
+
+
+ë ėŦėŠė ė¸í°íė´ė¤ ė¤ ė´ë íëëĨŧ ėŦėŠí´ėŧíë ę˛Ŋė°, ë¸ëŧė°ė ë íšė ėėŠíëĄęˇ¸ë¨ ëë íė ėėŠíëĄęˇ¸ë¨ęŗŧ ę°ę° íĩė í ė ė기 ëëŦ¸ė ėŦë°ëĨ´ę˛ ëėí ę˛ė
ëë¤.
+
+### 기ė ė ė¸ëļėŦí: `root_path`
+
+ėė ė¤ëĒ
ë ę˛ęŗŧ ę°ė´ íė ėėŠíëĄęˇ¸ë¨ė ë§ė´í¸íë ę˛Ŋė°, FastAPIë `root_path`ëŧęŗ íë ASGI ëĒ
ė¸ė 매ėģ¤ëėĻė ėŦėŠíėŦ íė ėėŠíëĄęˇ¸ë¨ė ëí ë§ė´í¸ ę˛ŊëĄ íĩė ė ė˛ëĻŦíŠëë¤.
+
+ė´ëĨŧ íĩí´, íė ėėŠíëĄęˇ¸ë¨ė ëŦ¸ė UIëĨŧ ėí´ ę˛ŊëĄ ė ëėŦëĨŧ ėŦėŠí´ėŧ íë¤ë ėŦė¤ė ė¸ė§íŠëë¤.
+
+íė ėėŠíëĄęˇ¸ë¨ėë ėė ë¤ëĨ¸ íė ėėŠíëĄęˇ¸ë¨ė ë§ė´í¸íë ę˛ė´ ę°ëĨí늰 FastAPIę° ëĒ¨ë `root_path` ë¤ė ėëė ėŧëĄ ė˛ëĻŦí기 ëëŦ¸ė ëĒ¨ë ę˛ė ėŦë°ëĨ´ę˛ ëėí ę˛ė
ëë¤.
+
+`root_path`ė ė´ę˛ė ėŦėŠíë ë°Šë˛ė ëí´ėë [íëĄėė ëˇë¨](./behind-a-proxy.md){.internal-link target=_blank} ėšė
ėė ë°°ė¸ ė ėėĩëë¤.
diff --git a/docs/ko/docs/tutorial/extra-models.md b/docs/ko/docs/tutorial/extra-models.md
new file mode 100644
index 000000000..8e4559061
--- /dev/null
+++ b/docs/ko/docs/tutorial/extra-models.md
@@ -0,0 +1,223 @@
+# ėļę° ëĒ¨ë¸
+
+ė§ë ėė ė ė´ė´ė, ė°ę´ë ëĒ¨ë¸ė ėŦëŦę° ę°ë ę˛ė íí ėŧė
ëë¤.
+
+íší ėŦėŠė ëĒ¨ë¸ė ę˛Ŋė°ė ꡸ëŦíë°, ėëí늴:
+
+* **ė
ë Ĩ ëĒ¨ë¸** ė ëšë°ë˛í¸ëĨŧ ę°ė ¸ėŧ íŠëë¤.
+* **ėļë Ĩ ëĒ¨ë¸** ė ëšë°ë˛í¸ëĨŧ ę°ė§ëŠ´ ėëŠëë¤.
+* **ë°ė´í°ë˛ ė´ė¤ ëĒ¨ë¸** ė í´ėė˛ëĻŦë ëšë°ë˛í¸ëĨŧ ę°ė§ ę˛ė
ëë¤.
+
+/// danger | ėí
+
+ė ë ėŦėŠėė ëšë°ë˛í¸ëĨŧ íëŦ¸ėŧëĄ ė ėĨíė§ ë§ė¸ė. íė ė´íė ę˛ėĻ ę°ëĨí "ėė í í´ė(secure hash)"ëĄ ė ėĨíė¸ė.
+
+ë§ėŊ ė´ę˛ ëŦ´ėė¸ė§ ëĒ¨ëĨ´ę˛ ë¤ëŠ´, [security chapters](security/simple-oauth2.md#password-hashing){.internal-link target=_blank}.ėė ëšë°ë˛í¸ í´ėė ëí´ ë°°ė¸ ė ėėĩëë¤.
+
+///
+
+## ë¤ė¤ ëĒ¨ë¸
+
+ėëë ëšë°ë˛í¸ íëė í´ëš íëę° ėŦėŠëë ėėšëĨŧ íŦí¨íėŦ, ę° ëĒ¨ë¸ë¤ė´ ė´ë¤ ííëĨŧ ę°ė§ ė ėëė§ ė ë°ė ė¸ ėėė
ëë¤:
+
+{* ../../docs_src/extra_models/tutorial001_py310.py hl[7,9,14,20,22,27:28,31:33,38:39] *}
+
+
+/// info | ė ëŗ´
+
+Pydantic v1ėėë í´ëš ëŠėëę° `.dict()`ëĄ ëļë ¸ėŧ늰, Pydantic v2ėėë `.model_dump()`ëĄ ė´ëĻė´ ëŗę˛Ŋëėėĩëë¤. `.dict()`ë ėŦė í ė§ėëė§ë§ ë ė´ė ęļėĨëė§ ėėĩëë¤.
+
+ėŦ기ėė ėŦėŠíë ėė ë Pydantic v1ęŗŧė í¸íėąė ėí´ `.dict()`ëĨŧ ėŦėŠíė§ë§, Pydantic v2ëĨŧ ėŦėŠí ė ėë¤ëŠ´ `.model_dump()`ëĨŧ ėŦėŠíë ę˛ė´ ėĸėĩëë¤.
+
+///
+
+### `**user_in.dict()` ė ëíėŦ
+
+#### Pydanticė `.dict()`
+
+`user_in`ė Pydantic ëĒ¨ë¸ í´ëė¤ė¸ `UserIn`ė
ëë¤.
+
+Pydantic ëĒ¨ë¸ė ëĒ¨ë¸ ë°ė´í°ëĨŧ íŦí¨í `dict`ëĨŧ ë°ííë `.dict()` ëŠėëëĨŧ ė ęŗĩíŠëë¤.
+
+ë°ëŧė, ë¤ėęŗŧ ę°ė´ Pydantic ę°ė˛´ `user_in`ė ėėąí ė ėėĩëë¤:
+
+```Python
+user_in = UserIn(username="john", password="secret", email="john.doe@example.com")
+```
+
+꡸ ë¤ė, ë¤ėęŗŧ ę°ė´ í¸ėļíŠëë¤:
+
+```Python
+user_dict = user_in.dict()
+```
+
+ė´ė ëŗė `user_dict`ė ë°ė´í°ę° íŦí¨ë `dict`ëĨŧ ę°ė§ę˛ ëŠëë¤(ė´ë Pydantic ëĒ¨ë¸ ę°ė˛´ę° ėë `dict`ė
ëë¤).
+
+꡸ëĻŦęŗ ë¤ėęŗŧ ę°ė´ í¸ėļí늴:
+
+```Python
+print(user_dict)
+```
+
+Pythonė `dict`ę° ë¤ėęŗŧ ę°ė´ ėļë ĨëŠëë¤:
+
+```Python
+{
+ 'username': 'john',
+ 'password': 'secret',
+ 'email': 'john.doe@example.com',
+ 'full_name': None,
+}
+```
+
+#### `dict` ė¸í¨íš(Unpacking)
+
+`user_dict`ė ę°ė `dict`ëĨŧ í¨ė(ëë í´ëė¤)ė `**user_dict`ëĄ ė ëŦí늴, Pythonė ė´ëĨŧ "ė¸íŠ(unpack)"íŠëë¤. ė´ ęŗŧė ėė `user_dict`ė í¤ė ę°ė ę°ę° í¤-ę° ė¸ėëĄ ė§ė ė ëŦíŠëë¤.
+
+ë°ëŧė, ėėė ėėąí `user_dict`ëĨŧ ėŦėŠíėŦ ë¤ėęŗŧ ę°ė´ ėėąí늴:
+
+```Python
+UserInDB(**user_dict)
+```
+
+ë¤ėęŗŧ ę°ė 결ęŗŧëĨŧ ėėąíŠëë¤:
+
+```Python
+UserInDB(
+ username="john",
+ password="secret",
+ email="john.doe@example.com",
+ full_name=None,
+)
+```
+
+íšė ë ė íí ë§íė늴, `user_dict`ëĨŧ ė§ė ėŦėŠíë ę˛ė, ëė¤ė ė´ë¤ ę°ė´ ėļę°ëëëŧë ėëė ëėŧí í¨ęŗŧëĨŧ ë
ëë¤:
+
+```Python
+UserInDB(
+ username = user_dict["username"],
+ password = user_dict["password"],
+ email = user_dict["email"],
+ full_name = user_dict["full_name"],
+)
+```
+
+#### ë¤ëĨ¸ ëĒ¨ë¸ ë°ė´í°ëĄ ė Pydantic ëĒ¨ë¸ ėėą
+
+ėė ėė ėė `user_in.dict()`ëĄëļí° `user_dict`ëĨŧ ėėąí ę˛ė˛ëŧ, ėë ėŊëë:
+
+```Python
+user_dict = user_in.dict()
+UserInDB(**user_dict)
+```
+
+ë¤ėęŗŧ ëėŧíŠëë¤:
+
+```Python
+UserInDB(**user_in.dict())
+```
+
+...ėëí늴 `user_in.dict()`ë `dict`ė´ëŠ°, ė´ëĨŧ `**`ëĄ Pythonė´ "ė¸íŠ(unpack)"íëëĄ íėŦ `UserInDB`ė ė ëŦí기 ëëŦ¸ė
ëë¤.
+
+ë°ëŧė, ë¤ëĨ¸ Pydantic ëĒ¨ë¸ė ë°ė´í°ëĨŧ ėŦėŠíėŦ ėëĄė´ Pydantic ëĒ¨ë¸ė ėėąí ė ėėĩëë¤.
+
+#### `dict` ė¸í¨íš(Unpacking)ęŗŧ ėļę° í¤ėë
+
+꡸ëĻŦęŗ ë¤ėęŗŧ ę°ė´ ėļę° í¤ėë ė¸ė `hashed_password=hashed_password`ëĨŧ ėļę°í늴:
+
+```Python
+UserInDB(**user_in.dict(), hashed_password=hashed_password)
+```
+
+ë¤ėęŗŧ ę°ė 결ęŗŧëĨŧ ėėąíŠëë¤:
+
+```Python
+UserInDB(
+ username = user_dict["username"],
+ password = user_dict["password"],
+ email = user_dict["email"],
+ full_name = user_dict["full_name"],
+ hashed_password = hashed_password,
+)
+```
+
+/// warning | ę˛Ŋęŗ
+
+ėļę°ė ėŧëĄ ė ęŗĩë í¨ė `fake_password_hasher`ė `fake_save_user`ë ë°ė´í° íëĻė ėė°í기 ėí ėė ėŧ ëŋė´ëŠ°, ė¤ė ëŗ´ėė ė ęŗĩíė§ ėėĩëë¤.
+
+///
+
+## ė¤ëŗĩ ė¤ė´ę¸°
+
+ėŊë ė¤ëŗĩė ė¤ė´ë ę˛ė **FastAPI**ė íĩėŦ ėė´ëė´ ė¤ íëė
ëë¤.
+
+ėŊë ė¤ëŗĩė ë˛ęˇ¸, ëŗ´ė ëŦ¸ė , ėŊë ëšë기í ëŦ¸ė (í ęŗŗė ė
ë°ė´í¸ëėė§ë§ ë¤ëĨ¸ ęŗŗė ė
ë°ė´í¸ëė§ ėë ëŦ¸ė ) ëąė ę°ëĨėąė ėĻę°ėíĩëë¤.
+
+꡸ëĻŦęŗ ė´ ëĒ¨ë¸ë¤ė ë§ė ë°ė´í°ëĨŧ ęŗĩė í늴ė ėėą ė´ëĻęŗŧ íė
ė ė¤ëŗĩíęŗ ėėĩëë¤.
+
+ë ëė ë°Šë˛ė´ ėėĩëë¤.
+
+`UserBase` ëĒ¨ë¸ė ė ė¸íėŦ ë¤ëĨ¸ ëĒ¨ë¸ë¤ė 기ëŗ¸(base)ėŧëĄ ėŦėŠí ė ėėĩëë¤. ęˇ¸ë° ë¤ė ė´ ëĒ¨ë¸ė ėėë°ė ėėąęŗŧ íė
ė ė¸(ė í ė ė¸, ę˛ėĻ ëą)ė ėėíë ėë¸í´ëė¤ëĨŧ ë§ë¤ ė ėėĩëë¤.
+
+ëĒ¨ë ë°ė´í° ëŗí, ę˛ėĻ, ëŦ¸ėí ëąė ė ėė ėŧëĄ ėëí ę˛ė
ëë¤.
+
+ė´ë ę˛ í늴 ę° ëĒ¨ë¸ ę°ė ė°¨ė´ė ë§ ė ė¸í ė ėėĩëë¤(íëŦ¸ `password`ę° ėë ę˛Ŋė°, `hashed_password`ë§ ėë ę˛Ŋė°, íšė ëšë°ë˛í¸ę° ėë ę˛Ŋė°):
+
+{* ../../docs_src/extra_models/tutorial002_py310.py hl[7,13:14,17:18,21:22] *}
+
+## `Union` ëë `anyOf`
+
+ë ę°ė§ ė´ėė íė
ė íŦí¨íë `Union`ėŧëĄ ėëĩė ė ė¸í ė ėėĩëë¤. ė´ë ėëĩė´ ꡸ ė¤ íëė íė
ėŧ ė ėėė ė미íŠëë¤.
+
+OpenAPIėėë ė´ëĨŧ `anyOf`ëĄ ė ėíŠëë¤.
+
+ė´ëĨŧ ėí´ íė¤ Python íė
íí¸ė¸ `typing.Union`ė ėŦėŠí ė ėėĩëë¤:
+
+/// note | ė°¸ęŗ
+
+`Union`ė ė ėí ëë ë ęĩŦė˛´ė ė¸ íė
ė ë¨ŧė íŦí¨íęŗ , ë ęĩŦė˛´ė ė¸ íė
ė ꡸ ë¤ė ëė´í´ėŧíŠëë¤. ėë ėė ėėë `Union[PlaneItem, CarItem]` ëĨŧ ëŗ´ëŠ´, ë ęĩŦė˛´ė ė¸ `PlaneItem`ė´ `CarItem`ëŗ´ë¤ ėė ėėšíŠëë¤.
+
+///
+
+{* ../../docs_src/extra_models/tutorial003_py310.py hl[1,14:15,18:20,33] *}
+
+
+### Python 3.10ėė `Union`
+
+ėė ėė ėėë `response_model` ė¸ė ę°ėŧëĄ `Union[PlaneItem, CarItem]`ė ė ëŦíŠëë¤.
+
+ė´ ę˛Ŋė°, ė´ëĨŧ **íė
ė´ë
¸í
ė´ė
(type annotation)** ė´ ėë **ė¸ė ę°(argument value)** ėŧëĄ ė ëŦíęŗ ė기 ëëŦ¸ė Python 3.10ėėë `Union`ė ėŦėŠí´ėŧ íŠëë¤.
+
+ë§ėŊ íė
ė´ë
¸í
ė´ė
ė ėŦėŠíë¤ëŠ´, ë¤ėęŗŧ ę°ė´ ėė§ ë§ë(|)ëĨŧ ėŦėŠí ė ėėĩëë¤:
+
+```Python
+some_variable: PlaneItem | CarItem
+```
+
+íė§ë§ ė´ëĨŧ `response_model=PlaneItem | CarItem`ęŗŧ ę°ė´ í ëší늴 ėëŦę° ë°ėíŠëë¤. ė´ë Pythonė´ ė´ëĨŧ íė
ė´ë
¸í
ė´ė
ėŧëĄ í´ėíė§ ėęŗ , `PlaneItem`ęŗŧ `CarItem` ėŦė´ė **ėëĒģë ė°ė°(invalid operation)**ė ėëí기 ëëŦ¸ė
ëë¤
+
+## ëĒ¨ë¸ ëĻŦė¤í¸
+
+ë§ė°Ŧę°ė§ëĄ, ę°ė˛´ ëĻŦė¤í¸ ííė ėëĩė ė ė¸í ėë ėėĩëë¤.
+
+ė´ëĨŧ ėí´ íė¤ Pythonė `typing.List`ëĨŧ ėŦėŠíė¸ė(ëë Python 3.9 ė´ėėėë ë¨ėí `list`ëĨŧ ėŦėŠí ė ėėĩëë¤):
+
+{* ../../docs_src/extra_models/tutorial004_py39.py hl[18] *}
+
+
+## ėėė `dict` ėëĩ
+
+Pydantic ëĒ¨ë¸ė ėŦėŠíė§ ėęŗ , í¤ė ę°ė íė
ë§ ė ė¸íėŦ íë˛í ėėė `dict`ëĄ ėëĩė ė ė¸í ėë ėėĩëë¤.
+
+ė´ë Pydantic ëĒ¨ë¸ė íėí ė í¨í íë/ėėą ė´ëĻė ėŦė ė ė ė ėë ę˛Ŋė°ė ė ėŠíŠëë¤.
+
+ė´ ę˛Ŋė°, `typing.Dict`ëĨŧ ėŦėŠí ė ėėĩëë¤(ëë Python 3.9 ė´ėėėë ë¨ėí `dict`ëĨŧ ėŦėŠí ė ėėĩëë¤):
+
+{* ../../docs_src/extra_models/tutorial005_py39.py hl[6] *}
+
+
+## ėėŊ
+
+ėŦëŦ Pydantic ëĒ¨ë¸ė ėŦėŠíęŗ , ę° ę˛Ŋė°ė ë§ę˛ ėė ëĄę˛ ėėíė¸ė.
+
+ėí°í°ę° ėëĄ ë¤ëĨ¸ "ėí"ëĨŧ ę°ė ¸ėŧ íë ę˛Ŋė°, ėí°í°ëš ë¨ėŧ ë°ė´í° ëĒ¨ë¸ė ėŦėŠí íėë ėėĩëë¤. ėëĨŧ ë¤ė´, ėŦėŠė "ėí°í°"ę° `password`, `password_hash`, ëë ëšë°ë˛í¸ę° ėë ėíëĨŧ íŦí¨í ė ėë ę˛Ŋė°ė˛ëŧ ë§ė
ëë¤.
diff --git a/docs/ko/docs/virtual-environments.md b/docs/ko/docs/virtual-environments.md
new file mode 100644
index 000000000..0d10c3200
--- /dev/null
+++ b/docs/ko/docs/virtual-environments.md
@@ -0,0 +1,846 @@
+# ę°ė íę˛Ŋ
+
+Python íëĄė í¸ëĨŧ ėė
í ëë **ę°ė íę˛Ŋ** (ëë ė´ė ė ėŦí ëęĩŦ)ė ėŦėŠíë ę˛ė´ ėĸėĩëë¤. ę° íëĄė í¸ ë§ë¤ ė¤ėšíë í¨í¤ė§ëĨŧ ëļëĻŦíėŦ ę´ëĻŦí ė ėėĩëë¤.
+
+/// info | ė ëŗ´
+
+ė´ë¯¸ ę°ė íę˛Ŋė ëí´ ė ėęŗ ėë¤ëŠ´, ė´ ėšė
ė ęą´ë ë°ė´ë ę´ė°Žėĩëë¤. đ¤
+
+///
+
+/// tip | í
+
+**ę°ė íę˛Ŋ(Virtual Environment)** ė **íę˛Ŋ ëŗė(Environment Variable)** ė ë¤ëĻ
ëë¤.
+
+**íę˛Ŋ ëŗė**ë ėė¤í
ė ėĄ´ėŦí늰, íëĄęˇ¸ë¨ė´ ėŦėŠí ė ėë ëŗėė
ëë¤.
+
+**ę°ė íę˛Ŋ**ė ëĒëĒ íėŧëĄ ęĩŦėąë íëė ëë í°ëĻŦė
ëë¤.
+
+///
+
+/// info | ė ëŗ´
+
+ė´ íė´ė§ėėë **ę°ė íę˛Ŋ**ė ėŦėŠ ë°Šë˛ęŗŧ ėë ë°Šėė ė¤ëĒ
íŠëë¤.
+
+ë§ėŊ **ëĒ¨ë ę˛ė ę´ëĻŦí´ėŖŧë ëęĩŦ** (Python ė¤ėšęšė§ íŦí¨)ëĨŧ ėŦėŠíęŗ ėļë¤ëŠ´ uvëĨŧ ėŦėŠí´ëŗ´ė¸ė.
+
+///
+
+## íëĄė í¸ ėėą
+
+ë¨ŧė , íëĄė í¸ëĨŧ ėí ëë í°ëĻŦëĨŧ íë ėėąíŠëë¤.
+
+ëŗ´íĩ ėŦėŠė í ëë í°ëĻŦ ėė `code`ëŧë ëë í°ëĻŦëĨŧ ë§ë¤ęŗ , ꡸ ėė íëĄė í¸ë§ë¤ íëėŠ ëë í°ëĻŦëĨŧ ë§ë¤ė´ ę´ëĻŦíŠëë¤.
+
+
+
+
+
+
+## ĐĐ´ĐĩĐŊŅиŅŅĐēĐ°ŅĐžŅ ĐģŅŅĐĩĐŊСŅŅ
+
+Đ ĐŋĐžŅĐ°ŅĐēŅ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ OpenAPI 3.1.0 ŅĐ° FastAPI 0.99.0 Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ ĐŊĐ°ĐģĐ°ŅŅŅваŅи `license_info` Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `identifier` СаĐŧŅŅŅŅ `url`.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´:
+
+{* ../../docs_src/metadata/tutorial001_1.py hl[31] *}
+
+## ĐĐĩŅĐ°Đ´Đ°ĐŊŅ Đ´ĐģŅ ŅĐĩĐŗŅв
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ дОдаŅи дОдаŅĐēОвŅ ĐŧĐĩŅĐ°Đ´Đ°ĐŊŅ Đ´ĐģŅ ŅŅСĐŊиŅ
ŅĐĩĐŗŅв, ŅĐēŅ виĐēĐžŅиŅŅОвŅŅŅŅŅŅ Đ´ĐģŅ ĐŗŅŅĐŋŅваĐŊĐŊŅ ĐžĐŋĐĩŅĐ°ŅŅĐš ŅĐģŅŅ
Ņв, Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `openapi_tags`.
+
+ĐŅĐŊ ĐŋŅиКĐŧĐ°Ņ ŅĐŋиŅĐžĐē, ŅĐēиК ĐŧŅŅŅиŅŅ ОдиĐŊ ŅĐģОвĐŊиĐē Đ´ĐģŅ ĐēĐžĐļĐŊĐžĐŗĐž ŅĐĩĐŗĐ°.
+
+ĐĐžĐļĐĩĐŊ ŅĐģОвĐŊиĐē ĐŧĐžĐļĐĩ ĐŧŅŅŅиŅи:
+
+* `name` (**ОйОв'ŅСĐēОвО**): `str` С ŅŅŅŅ Đļ ĐŊаСвОŅ ŅĐĩĐŗŅ, ŅĐēŅ Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅ `tags` Ņ ĐĐ°ŅиŅ
*ĐžĐŋĐĩŅĐ°ŅŅŅŅ
ŅĐģŅŅ
Ņ* ŅĐ° `APIRouter`s.
+* `description`: `str` С ĐēĐžŅĐžŅĐēиĐŧ ĐžĐŋиŅĐžĐŧ ŅĐĩĐŗŅ. ĐĐžĐļĐĩ ĐŧŅŅŅиŅи Markdown Ņ ĐąŅĐ´Đĩ вŅдОйŅĐ°ĐļĐĩĐŊĐž в ŅĐŊŅĐĩŅŅĐĩĐšŅŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ.
+* `externalDocs`: `dict` ŅĐēиК ĐžĐŋиŅŅŅ СОвĐŊŅŅĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ С ŅĐ°ĐēиĐŧи ĐŋĐžĐģŅĐŧи:
+ * `description`: `str` С ĐēĐžŅĐžŅĐēиĐŧ ĐžĐŋиŅĐžĐŧ СОвĐŊŅŅĐŊŅĐžŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ.
+ * `url` (**ОйОв'ŅСĐēОвО**): `str`С URL-Đ°Đ´ŅĐĩŅĐžŅ СОвĐŊŅŅĐŊŅĐžŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ.
+
+### ĐĄŅвОŅĐĩĐŊĐŊŅ ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
Đ´ĐģŅ ŅĐĩĐŗŅв
+
+ĐĄĐŋŅОйŅĐšĐŧĐž ŅĐĩ ĐŊĐ° ĐŋŅиĐēĐģĐ°Đ´Ņ С ŅĐĩĐŗĐ°Đŧи Đ´ĐģŅ `users` ŅĐ° `items`.
+
+ĐĄŅвОŅŅŅŅ ĐŧĐĩŅĐ°Đ´Đ°ĐŊŅ Đ´ĐģŅ ŅвОŅŅ
ŅĐĩĐŗŅв Ņ ĐŋĐĩŅĐĩĐ´Đ°ĐšŅĐĩ ŅŅ
Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `openapi_tags`:
+
+{* ../../docs_src/metadata/tutorial004.py hl[3:16,18] *}
+
+ĐвĐĩŅĐŊŅŅŅ ŅваĐŗŅ, ŅĐž в ĐžĐŋиŅĐ°Ņ
ĐŧĐžĐļĐŊĐ° виĐēĐžŅиŅŅОвŅваŅи Markdown, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, "login" ĐąŅĐ´Đĩ ĐŋĐžĐēаСаĐŊĐž ĐļиŅĐŊиĐŧ ŅŅиŅŅĐžĐŧ (**login**), Đ° "fancy" ĐąŅĐ´Đĩ ĐŋĐžĐēаСаĐŊĐž ĐēŅŅŅивОĐŧ (_fancy_).
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐĐĩ ОйОв'ŅСĐēОвО дОдаваŅи ĐŧĐĩŅĐ°Đ´Đ°ĐŊŅ Đ´ĐģŅ вŅŅŅ
ŅĐĩĐŗŅв, ŅĐēŅ Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ.
+
+///
+
+### ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ŅĐĩĐŗŅв
+
+ĐиĐēĐžŅиŅŅОвŅĐšŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `tags` СŅ ŅвОŅĐŧи *ĐžĐŋĐĩŅĐ°ŅŅŅĐŧи ŅĐģŅŅ
Ņ* (Ņ `APIRouter`) Đ´ĐģŅ ĐŋŅиСĐŊĐ°ŅĐĩĐŊĐŊŅ ŅŅ
Đ´Đž ŅŅСĐŊиŅ
ŅĐĩĐŗŅв:
+
+{* ../../docs_src/metadata/tutorial004.py hl[21,26] *}
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐĐĩŅĐ°ĐģŅĐŊŅŅĐĩ ĐŋŅĐž ŅĐĩĐŗи ŅиŅĐ°ĐšŅĐĩ в ŅОСдŅĐģŅ [ĐĐžĐŊŅŅĐŗŅŅĐ°ŅŅŅ ŅĐģŅŅ
Ņв ĐžĐŋĐĩŅĐ°ŅŅĐš](path-operation-configuration.md#tags){.internal-link target=_blank}.
+
+///
+
+### ĐĐĩŅĐĩвŅŅĐēĐ° Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ
+
+Đ¯ĐēŅĐž Đи СаŅаС ĐŋĐĩŅĐĩвŅŅиŅĐĩ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, вОĐŊĐ° ĐŋĐžĐēĐ°ĐļĐĩ вŅŅ дОдаŅĐēОвŅ ĐŧĐĩŅĐ°Đ´Đ°ĐŊŅ:
+
+
+
+### ĐĐžŅŅĐ´ĐžĐē ŅĐĩĐŗŅв
+
+ĐĐžŅŅĐ´ĐžĐē ĐēĐžĐļĐŊĐžĐŗĐž ŅĐģОвĐŊиĐēĐ° ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
ŅĐĩĐŗŅ ŅĐ°ĐēĐžĐļ виСĐŊĐ°ŅĐ°Ņ ĐŋĐžŅŅĐ´ĐžĐē вŅдОйŅĐ°ĐļĐĩĐŊĐŊŅ в ŅĐŊŅĐĩŅŅĐĩĐšŅŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, Ņ
ĐžŅĐ° `users` Đŧав йи ĐšŅи ĐŋŅŅĐģŅ `items` в Đ°ĐģŅавŅŅĐŊĐžĐŧŅ ĐŋĐžŅŅĐ´ĐēŅ, вŅĐŊ вŅдОйŅĐ°ĐļĐ°ŅŅŅŅŅ ĐŋĐĩŅĐĩĐ´ ĐŊиĐŧи, ĐžŅĐēŅĐģŅĐēи Đŧи дОдаĐģи КОĐŗĐž ĐŧĐĩŅĐ°Đ´Đ°ĐŊŅ ŅĐē ĐŋĐĩŅŅиК ŅĐģОвĐŊиĐē Ņ ŅĐŋиŅĐēŅ.
+
+## URL Đ´ĐģŅ OpenAPI
+
+ĐĐ° СаĐŧОвŅŅваĐŊĐŊŅĐŧ ŅŅ
ĐĩĐŧĐ° OpenAPI ĐŊĐ°Đ´Đ°ŅŅŅŅŅ Са Đ°Đ´ŅĐĩŅĐžŅ `/openapi.json`.
+
+ĐĐģĐĩ Đи ĐŧĐžĐļĐĩŅĐĩ ĐŊĐ°ĐģĐ°ŅŅŅваŅи ŅĐĩ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `openapi_url`.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅОй ĐŊĐ°ĐģĐ°ŅŅŅваŅи КОĐŗĐž ĐŊĐ° `/api/v1/openapi.json`:
+
+{* ../../docs_src/metadata/tutorial002.py hl[3] *}
+
+Đ¯ĐēŅĐž Đи Ņ
ĐžŅĐĩŅĐĩ ĐŋОвĐŊŅŅŅŅ виĐŧĐēĐŊŅŅи ŅŅ
ĐĩĐŧŅ OpenAPI, Đи ĐŧĐžĐļĐĩŅĐĩ вŅŅĐ°ĐŊОвиŅи `openapi_url=None`, ŅĐĩ ŅĐ°ĐēĐžĐļ виĐŧĐēĐŊĐĩ ŅĐŊŅĐĩŅŅĐĩĐšŅи Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ŅĐēŅ ŅŅ виĐēĐžŅиŅŅОвŅŅŅŅ.
+
+## URL-Đ°Đ´ŅĐĩŅи Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐŊĐ°ĐģĐ°ŅŅŅваŅи два ŅĐŊŅĐĩŅŅĐĩĐšŅи ĐēĐžŅиŅŅŅваŅĐ° Đ´ĐģŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ŅĐēŅ вĐēĐģŅŅĐĩĐŊŅ:
+
+* **Swagger UI**: Đ´ĐžŅŅŅĐŋĐŊиК Са Đ°Đ´ŅĐĩŅĐžŅ `/docs`.
+ * Đи ĐŧĐžĐļĐĩŅĐĩ СĐŧŅĐŊиŅи КОĐŗĐž URL Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `docs_url`.
+ * Đи ĐŧĐžĐļĐĩŅĐĩ виĐŧĐēĐŊŅŅи КОĐŗĐž, вŅŅĐ°ĐŊОвивŅи `docs_url=None`.
+* **ReDoc**: Đ´ĐžŅŅŅĐŋĐŊиК Са Đ°Đ´ŅĐĩŅĐžŅ `/redoc`.
+ * Đи ĐŧĐžĐļĐĩŅĐĩ СĐŧŅĐŊиŅи КОĐŗĐž URL Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `redoc_url`.
+ * Đи ĐŧĐžĐļĐĩŅĐĩ виĐŧĐēĐŊŅŅи КОĐŗĐž, вŅŅĐ°ĐŊОвивŅи `redoc_url=None`.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅОй ĐŊĐ°ĐģĐ°ŅŅŅваŅи Swagger UI ĐŊĐ° `/documentation` Ņ виĐŧĐēĐŊŅŅи ReDoc:
+
+{* ../../docs_src/metadata/tutorial003.py hl[3] *}
diff --git a/docs/uk/docs/tutorial/middleware.md b/docs/uk/docs/tutorial/middleware.md
new file mode 100644
index 000000000..807be484a
--- /dev/null
+++ b/docs/uk/docs/tutorial/middleware.md
@@ -0,0 +1,75 @@
+# Middleware (ĐŅĐžĐŧŅĐļĐŊиК ŅĐ°Ņ)
+
+ĐŖ **FastAPI** ĐŧĐžĐļĐŊĐ° дОдаваŅи middleware (ĐŋŅĐžĐŧŅĐļĐŊиК ŅĐ°Ņ).
+
+"Middleware" â ŅĐĩ ŅŅĐŊĐēŅŅŅ, ŅĐēĐ° ĐŋŅĐ°ŅŅŅ С ĐēĐžĐļĐŊиĐŧ **СаĐŋиŅĐžĐŧ** ĐŋĐĩŅĐĩĐ´ КОĐŗĐž ОйŅОйĐēĐžŅ ĐąŅĐ´Ņ-ŅĐēĐžŅ ĐēĐžĐŊĐēŅĐĩŅĐŊĐžŅ *ĐžĐŋĐĩŅĐ°ŅŅŅŅ ŅĐģŅŅ
Ņ* (*path operation*), Đ° ŅĐ°ĐēĐžĐļ С ĐēĐžĐļĐŊĐžŅ **вŅĐ´ĐŋОвŅĐ´Đ´Ņ** ĐŋĐĩŅĐĩĐ´ ŅŅ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅĐŧ.
+
+* Middleware ĐžŅŅиĐŧŅŅ ĐēĐžĐļĐĩĐŊ **СаĐŋиŅ**, ŅĐž ĐŊĐ°Đ´Ņ
ОдиŅŅ Đ´Đž ĐĐ°ŅĐžĐŗĐž СаŅŅĐžŅŅĐŊĐēŅ.
+* ĐĐžĐļĐĩ виĐēĐžĐŊĐ°Ņи ĐŋĐĩвĐŊŅ Đ´ŅŅ ŅС ŅиĐŧ **СаĐŋиŅĐžĐŧ** айО СаĐŋŅŅŅиŅи ĐŊĐĩОйŅ
ŅĐ´ĐŊиК ĐēОд.
+* ĐĐ°ĐģŅ ĐŋĐĩŅĐĩĐ´Đ°Ņ **СаĐŋиŅ** Đ´ĐģŅ ОйŅОйĐēи ĐžŅĐŊОвĐŊиĐŧ СаŅŅĐžŅŅĐŊĐēĐžĐŧ (*ĐžĐŋĐĩŅĐ°ŅŅŅŅ ŅĐģŅŅ
Ņ*).
+* ĐŅŅиĐŧŅŅ **вŅĐ´ĐŋОвŅĐ´Ņ**, ŅŅĐžŅĐŧОваĐŊŅ СаŅŅĐžŅŅĐŊĐēĐžĐŧ (*ĐžĐŋĐĩŅĐ°ŅŅŅŅ ŅĐģŅŅ
Ņ*).
+* ĐĐžĐļĐĩ СĐŧŅĐŊиŅи ŅŅ **вŅĐ´ĐŋОвŅĐ´Ņ** айО виĐēĐžĐŊĐ°Ņи дОдаŅĐēОвиК ĐēОд.
+* ĐОвĐĩŅŅĐ°Ņ **вŅĐ´ĐŋОвŅĐ´Ņ** ĐēĐģŅŅĐŊŅŅ.
+
+/// note | ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+Đ¯ĐēŅĐž Ņ ĐĐ°Ņ Ņ СаĐģĐĩĐļĐŊĐžŅŅŅ С `yield`, ĐēОд виŅ
ОдŅ виĐēĐžĐŊĐ°ŅŅŅŅŅ *ĐŋŅŅĐģŅ* middleware.
+
+Đ¯ĐēŅĐž ĐąŅĐģи СаĐŋĐģĐ°ĐŊОваĐŊŅ ŅĐžĐŊОвŅ СадаŅŅ (background tasks - ŅОСĐŗĐģŅĐŊŅŅĐž Đ´Đ°ĐģŅ), вОĐŊи виĐēĐžĐŊĐ°ŅŅŅŅŅ *ĐŋŅŅĐģŅ* вŅŅŅ
middleware.
+
+///
+
+## ĐĄŅвОŅĐĩĐŊĐŊŅ middleware
+
+ЊОй ŅŅвОŅиŅи middleware, Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ Đ´ĐĩĐēĐžŅĐ°ŅĐžŅ `@app.middleware("http")` ĐŊĐ° ŅŅĐŊĐēŅŅŅ.
+
+ФŅĐŊĐēŅŅŅ middleware ĐžŅŅиĐŧŅŅ:
+
+* `ĐĐ°ĐŋиŅ`.
+* ФŅĐŊĐēŅŅŅ `call_next`, ŅĐēĐ° ĐŋŅиКĐŧĐ°Ņ `СаĐŋиŅ` ŅĐē ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ.
+ * ĐĻŅ ŅŅĐŊĐēŅŅŅ ĐŋĐĩŅĐĩĐ´Đ°Ņ `СаĐŋиŅ` вŅĐ´ĐŋОвŅĐ´ĐŊŅĐš *ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*.
+ * ĐĐžŅŅĐŧ вОĐŊĐ° ĐŋОвĐĩŅŅĐ°Ņ `вŅĐ´ĐŋОвŅĐ´Ņ`, СĐŗĐĩĐŊĐĩŅОваĐŊŅ ŅŅŅŅ *ĐžĐŋĐĩŅĐ°ŅŅŅŅ ŅĐģŅŅ
Ņ*.
+
+* Đи ĐŧĐžĐļĐĩŅĐĩ ŅĐĩ СĐŧŅĐŊиŅи `вŅĐ´ĐŋОвŅĐ´Ņ` ĐŋĐĩŅĐĩĐ´ ŅиĐŧ, ŅĐē ĐŋОвĐĩŅĐŊŅŅи ŅŅ.
+
+
+{* ../../docs_src/middleware/tutorial001.py hl[8:9,11,14] *}
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐĐĩ СайŅваКŅĐĩ, ŅĐž вĐģĐ°ŅĐŊŅ СаĐŗĐžĐģОвĐēи ĐŧĐžĐļĐŊĐ° дОдаваŅи, виĐēĐžŅиŅŅОвŅŅŅи ĐŋŅĐĩŅŅĐēŅ 'X-'.
+
+ĐĐģĐĩ ŅĐēŅĐž Ņ ĐĐ°Ņ Ņ вĐģĐ°ŅĐŊŅ СаĐŗĐžĐģОвĐēи, ŅĐēŅ Đи Ņ
ĐžŅĐĩŅĐĩ, ŅОй ĐąŅĐ°ŅСĐĩŅĐŊиК ĐēĐģŅŅĐŊŅ ĐŧŅĐŗ ĐŋОйаŅиŅи, ĐŋĐžŅŅŅĐąĐŊĐž дОдаŅи ŅŅ
Đ´Đž ĐĐ°ŅĐžŅ ĐēĐžĐŊŅŅĐŗŅŅĐ°ŅŅŅ CORS (див. [CORS (ĐĐąĐŧŅĐŊ ŅĐĩŅŅŅŅĐ°Đŧи ĐŧŅĐļ ŅŅСĐŊиĐŧи Đ´ĐļĐĩŅĐĩĐģĐ°Đŧи)](cors.md){.internal-link target=_blank} Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `expose_headers`, ĐžĐŋиŅĐ°ĐŊĐžĐŗĐž в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Starlette ĐŋĐž CORS.
+
+///
+
+/// note | ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи `from starlette.requests import Request`.
+
+**FastAPI** ĐŊĐ°Đ´Đ°Ņ ŅĐĩ Đ´ĐģŅ ĐĐ°ŅĐžŅ СŅŅŅĐŊĐžŅŅŅ ŅĐē ŅОСŅОйĐŊиĐēĐ°. ĐĐģĐĩ вŅĐŊ ĐŋĐžŅ
ОдиŅŅ ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž СŅ Starlette.
+
+///
+
+### ĐĐž Ņ ĐŋŅŅĐģŅ `response`(`вŅĐ´ĐŋОвŅĐ´Ņ`)
+
+Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи ĐēОд, ŅĐēиК ĐąŅĐ´Đĩ виĐēĐžĐŊŅваŅиŅŅ С `СаĐŋиŅĐžĐŧ` (`request`), Đ´Đž ŅĐžĐŗĐž, ŅĐē КОĐŗĐž ОйŅОйиŅŅ ĐąŅĐ´Ņ-ŅĐēĐ° *ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ* (*path operation*).
+
+ĐĸĐ°ĐēĐžĐļ Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи ĐēОд, ŅĐēиК ĐąŅĐ´Đĩ виĐēĐžĐŊŅваŅиŅŅ ĐŋŅŅĐģŅ ŅĐžĐŗĐž, ŅĐē `вŅĐ´ĐŋОвŅĐ´Ņ` (`response`) ĐąŅĐ´Đĩ СĐŗĐĩĐŊĐĩŅОваĐŊĐž, ĐŋĐĩŅĐĩĐ´ ŅиĐŧ ŅĐē КОĐŗĐž ĐŋОвĐĩŅĐŊŅŅи.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи вĐģĐ°ŅĐŊиК СаĐŗĐžĐģОвОĐē `X-Process-Time`, ŅĐēиК ĐŧŅŅŅиŅиĐŧĐĩ ŅĐ°Ņ Ņ ŅĐĩĐēŅĐŊĐ´Đ°Ņ
, ŅĐēиК виŅŅĐ°ŅивŅŅ ĐŊĐ° ОйŅОйĐēŅ СаĐŋиŅŅ ŅĐ° ĐŗĐĩĐŊĐĩŅĐ°ŅŅŅ вŅĐ´ĐŋОвŅĐ´Ņ:
+
+{* ../../docs_src/middleware/tutorial001.py hl[10,12:13] *}
+
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+ĐĸŅŅ Đŧи виĐēĐžŅиŅŅОвŅŅĐŧĐž `time.perf_counter()` СаĐŧŅŅŅŅ `time.time()` ĐžŅĐēŅĐģŅĐēи вŅĐŊ ĐŧĐžĐļĐĩ ĐąŅŅи ĐąŅĐģŅŅ ŅĐžŅĐŊиĐŧ Đ´ĐģŅ ŅĐ°ĐēиŅ
виĐŋĐ°Đ´ĐēŅв. đ¤
+
+///
+
+## ĐĐŊŅŅ middlewares
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋŅСĐŊŅŅĐĩ ĐŋŅĐžŅиŅĐ°Ņи ĐąŅĐģŅŅĐĩ ĐŋŅĐž ŅĐŊŅŅ middlewares в [Advanced User Guide: Advanced Middleware](../advanced/middleware.md){.internal-link target=_blank}.
+
+Đи Đ´ŅСĐŊĐ°ŅŅĐĩŅŅ, ŅĐē ОйŅОйĐģŅŅи CORS Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ middleware в ĐŊĐ°ŅŅŅĐŋĐŊĐžĐŧŅ ŅОСдŅĐģŅ.
diff --git a/docs/uk/docs/tutorial/path-params-numeric-validations.md b/docs/uk/docs/tutorial/path-params-numeric-validations.md
new file mode 100644
index 000000000..281ee183c
--- /dev/null
+++ b/docs/uk/docs/tutorial/path-params-numeric-validations.md
@@ -0,0 +1,165 @@
+# Path ĐĐ°ŅĐ°ĐŧĐĩŅŅи ŅĐ° ваĐģŅĐ´Đ°ŅŅŅ ŅиŅĐģОвиŅ
Đ´Đ°ĐŊиŅ
+
+ĐĸĐ°Đē ŅĐ°ĐŧĐž ŅĐē Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅŅваŅи дОдаŅĐēОвŅ ĐŋĐĩŅĐĩвŅŅĐēи ŅĐ° ĐŧĐĩŅĐ°Đ´Đ°ĐŊŅ Đ´ĐģŅ query ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `Query`, Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅŅваŅи ŅОК ŅĐ°ĐŧиК ŅиĐŋ ĐŋĐĩŅĐĩвŅŅĐžĐē Ņ ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
Đ´ĐģŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв ŅĐģŅŅ
Ņ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `Path`.
+
+## ĐĐŧĐŋĐžŅŅ Path
+
+ĐĄĐŋĐžŅĐ°ŅĐēŅ ŅĐŧĐŋĐžŅŅŅĐšŅĐĩ `Path` С `fastapi` Ņ ŅĐŧĐŋĐžŅŅŅĐšŅĐĩ `Annotated`:
+
+{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+FastAPI дОдав ĐŋŅĐ´ŅŅиĐŧĐēŅ `Annotated` (Ņ ĐŋĐžŅав ŅĐĩĐēĐžĐŧĐĩĐŊĐ´ŅваŅи КОĐŗĐž виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ) Ņ вĐĩŅŅŅŅ 0.95.0.
+
+Đ¯ĐēŅĐž Ņ ĐĐ°Ņ ŅŅĐ°ŅĐ° вĐĩŅŅŅŅ, ĐŋŅи ŅĐŋŅОйŅ виĐēĐžŅиŅŅĐ°Ņи `Annotated` ĐŧĐžĐļŅŅŅ виĐŊиĐēĐ°Ņи ĐŋĐžĐŧиĐģĐēи.
+
+ĐĐĩŅĐĩĐēĐžĐŊĐ°ĐšŅĐĩŅŅ, ŅĐž Đи [ĐžĐŊОвиĐģи вĐĩŅŅŅŅ FastAPI](../deployment/versions.md#upgrading-the-fastapi-versions){.internal-link target=_blank} ĐŋŅиĐŊĐ°ĐšĐŧĐŊŅ Đ´Đž вĐĩŅŅŅŅ 0.95.1 ĐŋĐĩŅĐĩĐ´ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅĐŧ `Annotated`.
+
+///
+
+## ĐĐŗĐžĐģĐžŅĐĩĐŊĐŊŅ ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅŅваŅи вŅŅ ŅŅ Đļ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи, ŅĐž Ņ Đ´ĐģŅ `Query`.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅОй ĐžĐŗĐžĐģĐžŅиŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
`title` Đ´ĐģŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° ŅĐģŅŅ
Ņ `item_id`, Đи ĐŧĐžĐļĐĩŅĐĩ ĐŊĐ°ĐŋиŅĐ°Ņи:
+
+{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[10] *}
+
+/// note | ĐŅиĐŧŅŅĐēĐ°
+
+ĐĐ°ŅĐ°ĐŧĐĩŅŅ ŅĐģŅŅ
Ņ СавĐļди Ņ ОйОвâŅСĐēОвиĐŧ, ĐžŅĐēŅĐģŅĐēи вŅĐŊ ĐŧĐ°Ņ ĐąŅŅи ŅĐ°ŅŅиĐŊĐžŅ ŅĐģŅŅ
Ņ. ĐавŅŅŅ ŅĐēŅĐž Đи ĐžĐŗĐžĐģĐžŅиŅĐĩ КОĐŗĐž СŅ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ `None` айО вŅŅĐ°ĐŊОвиŅĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ â вŅĐŊ вŅĐĩ ОдĐŊĐž СаĐģиŅĐ°ŅиĐŧĐĩŅŅŅŅ ОйОвâŅСĐēОвиĐŧ.
+
+///
+
+## ĐŖĐŋĐžŅŅĐ´ĐēОвŅĐšŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи, ŅĐē ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+ĐĻĐĩ, ĐŧĐ°ĐąŅŅŅ, ĐŊĐĩ ĐŊĐ°ŅŅŅĐģŅĐēи ваĐļĐģивО айО ĐŊĐĩОйŅ
ŅĐ´ĐŊĐž, ŅĐēŅĐž Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ `Annotated`.
+
+///
+
+ĐŅиĐŋŅŅŅиĐŧĐž, Đи Ņ
ĐžŅĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ `q` ŅĐē ОйОвâŅСĐēОвиК `str`.
+
+Đ ĐĐ°Đŧ ĐŊĐĩ ĐŋĐžŅŅŅĐąĐŊĐž ĐžĐŗĐžĐģĐžŅŅваŅи ĐŊŅŅĐžĐŗĐž ŅĐŊŅĐžĐŗĐž Đ´ĐģŅ ŅŅĐžĐŗĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°, ŅĐžĐŧŅ ĐŊĐĩĐŧĐ°Ņ ĐŋĐžŅŅĐĩйи виĐēĐžŅиŅŅОвŅваŅи `Query`.
+
+ĐĐģĐĩ ĐĐ°Đŧ вŅĐĩ ОдĐŊĐž ĐŋĐžŅŅŅĐąĐŊĐž виĐēĐžŅиŅŅОвŅваŅи `Path` Đ´ĐģŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° ŅĐģŅŅ
Ņ `item_id`. РС ĐŋĐĩвĐŊиŅ
ĐŋŅиŅиĐŊ Đи ĐŊĐĩ Ņ
ĐžŅĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи `Annotated`.
+
+Python видаŅŅŅ ĐŋĐžĐŧиĐģĐēŅ, ŅĐēŅĐž ŅОСĐŧŅŅŅиŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ С "default" ĐŋĐĩŅĐĩĐ´ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ, ŅĐēĐĩ ĐŊĐĩ ĐŧĐ°Ņ "default".
+
+ĐĐģĐĩ Đи ĐŧĐžĐļĐĩŅĐĩ СĐŧŅĐŊиŅи ĐŋĐžŅŅĐ´ĐžĐē Ņ ŅОСĐŧŅŅŅиŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐąĐĩС СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ (ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ `q`) ĐŋĐĩŅŅиĐŧ.
+
+
+ĐĐģŅ **FastAPI** ĐŋĐžŅŅĐ´ĐžĐē ĐŊĐĩ ĐŧĐ°Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ. ĐŅĐŊ виСĐŊĐ°ŅĐ°Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи Са ŅŅ
ŅĐŧĐĩĐŊĐ°Đŧи, ŅиĐŋĐ°Đŧи ŅĐ° СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ (`Query`, `Path` ŅĐžŅĐž) Ņ ĐŊĐĩ СвĐĩŅŅĐ°Ņ ŅваĐŗи ĐŊĐ° ĐŋĐžŅŅĐ´ĐžĐē.
+
+ĐĸĐžĐŧŅ Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ĐĐ°ŅŅ ŅŅĐŊĐēŅŅŅ ŅĐ°Đē:
+
+//// tab | Python 3.8 non-Annotated
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+ĐĐ° ĐŧĐžĐļĐģивОŅŅŅ вŅддаваКŅĐĩ ĐŋĐĩŅĐĩваĐŗŅ вĐĩŅŅŅŅ С виĐēĐžŅиŅŅĐ°ĐŊĐŊŅĐŧ `Annotated`.
+
+///
+
+{* ../../docs_src/path_params_numeric_validations/tutorial002.py hl[7] *}
+
+////
+
+ĐĐģĐĩ ĐŧĐ°ĐšŅĐĩ ĐŊĐ° ŅваСŅ, ŅĐž ŅĐēŅĐž Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ `Annotated`, ŅŅ ĐŋŅОйĐģĐĩĐŧĐ° ĐŊĐĩ виĐŊиĐēĐŊĐĩ, ĐžŅĐēŅĐģŅĐēи Đи ĐŊĐĩ виĐēĐžŅиŅŅОвŅŅŅĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ Đ´ĐģŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв `Query()` айО `Path()`.
+
+{* ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py *}
+
+## ĐŖĐŋĐžŅŅĐ´ĐēОвŅĐšŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи Са ĐŋĐžŅŅĐĩйОŅ, Ņ
иŅŅĐžŅŅ
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+ĐĻĐĩ, ĐŧĐ°ĐąŅŅŅ, ĐŊĐĩ ĐŊĐ°ŅŅŅĐģŅĐēи ваĐļĐģивО айО ĐŊĐĩОйŅ
ŅĐ´ĐŊĐž, ŅĐēŅĐž Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ `Annotated`.
+
+///
+
+ĐŅŅ **ĐŊĐĩвĐĩĐģиĐēĐ° Ņ
иŅŅŅŅŅŅ**, ŅĐēĐ° ĐŧĐžĐļĐĩ ŅŅĐ°Ņи в ĐŋŅиĐŗОдŅ, Ņ
ĐžŅĐ° вОĐŊĐ° ŅŅĐ´ĐēĐž СĐŊадОйиŅŅŅŅ.
+
+Đ¯ĐēŅĐž Đи Ņ
ĐžŅĐĩŅĐĩ:
+
+* ĐžĐŗĐžĐģĐžŅиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ `q` ĐąĐĩС виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ `Query` айО СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ
+* ĐžĐŗĐžĐģĐžŅиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ŅĐģŅŅ
Ņ `item_id`, виĐēĐžŅиŅŅОвŅŅŅи `Path`
+* ŅОСĐŧŅŅŅиŅи ŅŅ
Ņ ŅŅСĐŊĐžĐŧŅ ĐŋĐžŅŅĐ´ĐēŅ
+* ĐŊĐĩ виĐēĐžŅиŅŅОвŅваŅи `Annotated`
+
+...Ņ Python Ņ ŅĐŋĐĩŅŅĐ°ĐģŅĐŊиК ŅиĐŊŅĐ°ĐēŅиŅ Đ´ĐģŅ ŅŅĐžĐŗĐž.
+
+ĐĐĩŅĐĩĐ´Đ°ĐšŅĐĩ `*` ŅĐē ĐŋĐĩŅŅиК ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ŅŅĐŊĐēŅŅŅ.
+
+Python ĐŊŅŅĐžĐŗĐž ĐŊĐĩ СŅОйиŅŅ ŅС ŅŅŅŅ `*`, Đ°ĐģĐĩ ŅОСĐŋŅСĐŊĐ°Ņ, ŅĐž вŅŅ ĐŊĐ°ŅŅŅĐŋĐŊŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи ŅĐģŅĐ´ виĐēĐģиĐēĐ°Ņи ŅĐē Đ°ŅĐŗŅĐŧĐĩĐŊŅи Са ĐēĐģŅŅОвиĐŧ ŅĐģОвОĐŧ (ĐŋĐ°Ņи ĐēĐģŅŅ-СĐŊĐ°ŅĐĩĐŊĐŊŅ), ŅĐ°ĐēĐžĐļ вŅĐ´ĐžĐŧŅ ŅĐē 
+
+
+### ĐĄĐŋиŅĐžĐē ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв СаĐŋиŅŅ / ĐēŅĐģŅĐēĐ° СĐŊĐ°ŅĐĩĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виСĐŊĐ°ŅиŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ Đ´ĐģŅ `list`, ŅĐēŅĐž ĐļОдĐŊĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐŊĐĩ ĐąŅĐģĐž ĐŋĐĩŅĐĩĐ´Đ°ĐŊĐĩ:
+
+{* ../../docs_src/query_params_str_validations/tutorial012_an_py39.py hl[9] *}
+
+Đ¯ĐēŅĐž Đи ĐŋĐĩŅĐĩКдĐĩŅĐĩ Са ĐŋĐžŅиĐģĐ°ĐŊĐŊŅĐŧ:
+
+```
+http://localhost:8000/items/
+```
+
+ŅĐž СĐŊĐ°ŅĐĩĐŊĐŊŅ `q` Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ ĐąŅĐ´Đĩ: `["foo", "bar"]`, Ņ ĐĐ°ŅĐ° вŅĐ´ĐŋОвŅĐ´Ņ виĐŗĐģŅĐ´Đ°ŅиĐŧĐĩ ŅĐ°Đē:
+
+```JSON
+{
+ "q": [
+ "foo",
+ "bar"
+ ]
+}
+```
+
+#### ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ŅŅĐģŅĐēи `list`
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи `list` ĐąĐĩС ŅŅĐžŅĐŊĐĩĐŊĐŊŅ ŅиĐŋŅ, СаĐŧŅŅŅŅ `list[str]`:
+
+{* ../../docs_src/query_params_str_validations/tutorial013_an_py39.py hl[9] *}
+
+/// note | ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+ĐĐ°ĐšŅĐĩ ĐŊĐ° ŅваСŅ, ŅĐž в ŅŅĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ FastAPI ĐŊĐĩ ĐŋĐĩŅĐĩвŅŅŅŅиĐŧĐĩ вĐŧŅŅŅ ŅĐŋиŅĐēŅ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, `list[int]` ĐŋĐĩŅĐĩвŅŅŅŅиĐŧĐĩ (Ņ Đ´ĐžĐēŅĐŧĐĩĐŊŅŅваŅиĐŧĐĩ), ŅĐž вŅŅ ĐĩĐģĐĩĐŧĐĩĐŊŅи ŅĐŋиŅĐēŅ Ņ ŅŅĐģиĐŧи ŅиŅĐģĐ°Đŧи. ĐĐģĐĩ `list` ĐąĐĩС ŅŅĐžŅĐŊĐĩĐŊĐŊŅ ŅŅĐžĐŗĐž ĐŊĐĩ ŅОйиŅиĐŧĐĩ.
+
+///
+
+## ĐОдаваĐŊĐŊŅ дОдаŅĐēОвиŅ
ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи ĐąŅĐģŅŅĐĩ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ ĐŋŅĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ.
+
+ĐĻŅ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ ĐąŅĐ´Đĩ вĐēĐģŅŅĐĩĐŊĐ° Ņ СĐŗĐĩĐŊĐĩŅОваĐŊиК OpenAPI ŅĐ° виĐēĐžŅиŅŅĐ°ĐŊĐ° в ŅĐŊŅĐĩŅŅĐĩĐšŅĐ°Ņ
Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ŅĐ° СОвĐŊŅŅĐŊŅŅ
ŅĐŊŅŅŅŅĐŧĐĩĐŊŅĐ°Ņ
.
+
+/// note | ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+ĐĐ°ĐšŅĐĩ ĐŊĐ° ŅваСŅ, ŅĐž ŅŅСĐŊŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи ĐŧĐžĐļŅŅŅ ĐŧĐ°Ņи ŅŅСĐŊиК ŅŅвĐĩĐŊŅ ĐŋŅĐ´ŅŅиĐŧĐēи OpenAPI.
+
+ĐĐĩŅĐēŅ С ĐŊиŅ
ĐŧĐžĐļŅŅŅ ŅĐĩ ĐŊĐĩ вŅдОйŅĐ°ĐļĐ°Ņи вŅŅ дОдаŅĐēОвŅ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ, Ņ
ĐžŅĐ° в ĐąŅĐģŅŅĐžŅŅŅ виĐŋĐ°Đ´ĐēŅв ŅŅ ŅŅĐŊĐēŅŅŅ вĐļĐĩ СаĐŋĐģĐ°ĐŊОваĐŊĐ° Đ´ĐģŅ ŅОСŅОйĐēи.
+
+///
+
+Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи `title` :
+
+{* ../../docs_src/query_params_str_validations/tutorial007_an_py310.py hl[10] *}
+
+Đ ŅĐ°ĐēĐžĐļ `description`:
+
+{* ../../docs_src/query_params_str_validations/tutorial008_an_py310.py hl[14] *}
+
+## ĐĐģŅĐ°Ņи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв
+
+ĐŖŅвŅŅŅ, ŅĐž Đи Ņ
ĐžŅĐĩŅĐĩ, ŅОй ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ ĐŊаСивавŅŅ `item-query`.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´:
+
+```
+http://127.0.0.1:8000/items/?item-query=foobaritems
+```
+
+ĐĐģĐĩ `item-query` â ŅĐĩ ĐŊĐĩĐēĐžŅĐĩĐēŅĐŊĐ° ĐŊаСва СĐŧŅĐŊĐŊĐžŅ в Python.
+
+ĐаКйĐģиĐļŅиК Đ´ĐžĐŋŅŅŅиĐŧиК ваŅŅĐ°ĐŊŅ â `item_query`.
+
+ĐŅĐžŅĐĩ ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž, ŅОй ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐģиŅавŅŅ ŅĐ°ĐŧĐĩ `item-query`...
+
+ĐŖ ŅĐ°ĐēĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ ĐŧĐžĐļĐŊĐ° ĐžĐŗĐžĐģĐžŅиŅи `alias`, Ņ ŅĐ°ĐŧĐĩ вŅĐŊ ĐąŅĐ´Đĩ виĐēĐžŅиŅŅОвŅваŅиŅŅ Đ´ĐģŅ ĐžŅŅиĐŧĐ°ĐŊĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°:
+
+{* ../../docs_src/query_params_str_validations/tutorial009_an_py310.py hl[9] *}
+
+## ĐивĐĩĐ´ĐĩĐŊĐŊŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв ŅĐē СаŅŅĐ°ŅŅĐģиŅ
+
+ĐŅиĐŋŅŅŅиĐŧĐž, ŅĐž Đи ĐąŅĐģŅŅĐĩ ĐŊĐĩ Ņ
ĐžŅĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ŅĐĩĐš ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ.
+
+ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž СаĐģиŅиŅи КОĐŗĐž ĐŊĐ° Đ´ĐĩŅĐēиК ŅĐ°Ņ, ĐžŅĐēŅĐģŅĐēи ĐŊиĐŧ ĐēĐžŅиŅŅŅŅŅŅŅŅ ĐēĐģŅŅĐŊŅи, Đ°ĐģĐĩ Đи Ņ
ĐžŅĐĩŅĐĩ, ŅОй Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ŅŅŅĐēĐž ĐŋĐžĐēаСŅваĐģĐ°, ŅĐž вŅĐŊ Ņ СаŅŅĐ°ŅŅĐģиĐŧ.
+
+ĐĸОдŅ Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋĐĩŅĐĩĐ´Đ°Ņи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `deprecated=True` Đ´Đž `Query`:
+
+{* ../../docs_src/query_params_str_validations/tutorial010_an_py310.py hl[19] *}
+
+ĐĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ĐąŅĐ´Đĩ ĐŋĐžĐēаСŅваŅи ŅĐĩ ŅĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ:
+
+
+
+## ĐиĐŊŅŅĐžĐē ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв С OpenAPI
+
+ЊОй виĐēĐģŅŅиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ СŅ СĐŗĐĩĐŊĐĩŅОваĐŊĐžŅ ŅŅ
ĐĩĐŧи OpenAPI (Ņ, ŅĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, С авŅĐžĐŧĐ°ŅиŅĐŊиŅ
ŅиŅŅĐĩĐŧ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ), вŅŅĐ°ĐŊОвŅŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `include_in_schema` Đ´ĐģŅ `Query` в `False`:
+
+{* ../../docs_src/query_params_str_validations/tutorial014_an_py310.py hl[10] *}
+
+## ĐĐ°ŅŅĐžĐŧĐŊĐ° ваĐģŅĐ´Đ°ŅŅŅ
+
+ĐĐžĐļŅŅŅ ĐąŅŅи виĐŋĐ°Đ´Đēи, ĐēĐžĐģи ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž ĐŋŅОвĐĩŅŅи **ĐēĐ°ŅŅĐžĐŧĐŊŅ ваĐģŅĐ´Đ°ŅŅŅ**, ŅĐēŅ ĐŊĐĩ ĐŧĐžĐļĐŊĐ° ŅĐĩĐ°ĐģŅСŅваŅи Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв, ĐŋĐžĐēаСаĐŊиŅ
виŅĐĩ.
+
+ĐŖ ŅĐ°ĐēиŅ
виĐŋĐ°Đ´ĐēĐ°Ņ
ви ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи **ĐēĐ°ŅŅĐžĐŧĐŊŅ ŅŅĐŊĐēŅŅŅ ваĐģŅĐ´Đ°ŅŅŅ**, ŅĐēĐ° ĐąŅĐ´Đĩ СаŅŅĐžŅОваĐŊĐ° ĐŋŅŅĐģŅ СвиŅĐ°ĐšĐŊĐžŅ ваĐģŅĐ´Đ°ŅŅŅ (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, ĐŋŅŅĐģŅ ĐŋĐĩŅĐĩвŅŅĐēи, ŅĐž СĐŊĐ°ŅĐĩĐŊĐŊŅ Ņ ŅиĐŋĐžĐŧ `str`).
+
+ĐĻĐĩ ĐŧĐžĐļĐŊĐ° Đ´ĐžŅŅĐŗŅи Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ Pydantic's `AfterValidator` в ŅĐĩŅĐĩдиĐŊŅ `Annotated`.
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+Pydantic ŅĐ°ĐēĐžĐļ ĐŧĐ°Ņ `BeforeValidator` ŅĐ° ŅĐŊŅŅ. đ¤
+
+///
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐĩĐš ĐēĐ°ŅŅĐžĐŧĐŊиК ваĐģŅĐ´Đ°ŅĐžŅ ĐŋĐĩŅĐĩвŅŅŅŅ, Ņи ĐŋĐžŅиĐŊĐ°ŅŅŅŅŅ ID ĐĩĐģĐĩĐŧĐĩĐŊŅĐ° С `isbn-` Đ´ĐģŅ ĐŊĐžĐŧĐĩŅĐ° ĐēĐŊиĐŗи ISBN айО С `imdb-` Đ´ĐģŅ ID URL ŅŅĐģŅĐŧŅ ĐŊĐ° IMDB:
+
+{* ../../docs_src/query_params_str_validations/tutorial015_an_py310.py hl[5,16:19,24] *}
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐĻĐĩ Đ´ĐžŅŅŅĐŋĐŊĐž С вĐĩŅŅŅŅ Pydantic 2 айО виŅĐĩ. đ
+
+///
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+Đ¯ĐēŅĐž ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž виĐēĐžĐŊĐ°Ņи ĐąŅĐ´Ņ-ŅĐēŅ ваĐģŅĐ´Đ°ŅŅŅ, ŅĐēĐ° виĐŧĐ°ĐŗĐ°Ņ вСаŅĐŧОдŅŅ С ĐąŅĐ´Ņ-ŅĐēиĐŧ **СОвĐŊŅŅĐŊŅĐŧ ĐēĐžĐŧĐŋĐžĐŊĐĩĐŊŅĐžĐŧ**, ŅĐ°ĐēиĐŧ ŅĐē йаСа Đ´Đ°ĐŊиŅ
Ņи ŅĐŊŅиК API, ви ĐŋОвиĐŊĐŊŅ СаĐŧŅŅŅŅ ŅŅĐžĐŗĐž виĐēĐžŅиŅŅОвŅваŅи **FastAPI Dependencies**. Đи Đ´ŅСĐŊĐ°ŅŅĐĩŅŅ ĐŋŅĐž ĐŊиŅ
ĐŋŅСĐŊŅŅĐĩ.
+
+ĐĻŅ ĐēĐ°ŅŅĐžĐŧĐŊŅ ваĐģŅĐ´Đ°ŅĐžŅи виĐēĐžŅиŅŅОвŅŅŅŅŅŅ Đ´ĐģŅ ŅĐĩŅĐĩĐš, ŅĐēŅ ĐŧĐžĐļĐŊĐ° ĐŋĐĩŅĐĩвŅŅиŅи ĐģиŅĐĩ С **ŅиĐŧи Đ´Đ°ĐŊиĐŧи**, ŅĐž ĐŊĐ°Đ´Đ°ĐŊŅ в СаĐŋиŅŅ.
+
+///
+
+### ĐŅОСŅĐŧŅĐšŅĐĩ ŅĐĩĐš ĐēОд
+
+ĐĐžĐģОвĐŊиК ĐŧĐžĐŧĐĩĐŊŅ â ŅĐĩ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ **`AfterValidator` С ŅŅĐŊĐēŅŅŅŅ вŅĐĩŅĐĩдиĐŊŅ `Annotated`**. ĐĐžĐļĐĩŅĐĩ ĐŋŅĐžĐŋŅŅŅиŅи ŅŅ ŅĐ°ŅŅиĐŊŅ, ŅĐēŅĐž Ņ
ĐžŅĐĩŅĐĩ. đ¤¸
+
+---
+
+ĐĐģĐĩ ŅĐēŅĐž ĐĐ°Đŧ ŅŅĐēавО ŅОСŅĐąŅĐ°ŅиŅŅ в ŅŅĐžĐŧŅ ĐēĐžĐŊĐēŅĐĩŅĐŊĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ ĐēОдŅ Ņ ĐĐ°Đŧ ŅĐĩ ĐŊĐĩ ĐŊĐ°ĐąŅидĐģĐž, ĐžŅŅ ĐēŅĐģŅĐēĐ° дОдаŅĐēОвиŅ
Đ´ĐĩŅĐ°ĐģĐĩĐš.
+
+#### Đ ŅĐ´ĐžĐē ŅС `value.startswith()`
+
+ĐвĐĩŅĐŊŅĐģи ŅваĐŗŅ? Đ ŅĐ´ĐžĐē ŅС `value.startswith()` ĐŧĐžĐļĐĩ ĐŋŅиКĐŧĐ°Ņи ĐēĐžŅŅĐĩĐļ, Ņ ŅОдŅ вŅĐŊ ĐŋĐĩŅĐĩвŅŅŅŅиĐŧĐĩ ĐēĐžĐļĐŊĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ в ĐēĐžŅŅĐĩĐļŅ:
+
+{* ../../docs_src/query_params_str_validations/tutorial015_an_py310.py ln[16:19] hl[17] *}
+
+#### ĐиĐŋĐ°Đ´ĐēОвиК ĐĩĐģĐĩĐŧĐĩĐŊŅ
+
+ĐĐ° Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `data.items()` Đŧи ĐžŅŅиĐŧŅŅĐŧĐž ŅŅĐĩŅĐ°ĐąĐĩĐģŅĐŊиК Ой'ŅĐēŅ ŅС ĐēĐžŅŅĐĩĐļĐ°Đŧи, ŅĐž ĐŧŅŅŅŅŅŅ ĐēĐģŅŅ Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ Đ´ĐģŅ ĐēĐžĐļĐŊĐžĐŗĐž ĐĩĐģĐĩĐŧĐĩĐŊŅĐ° ŅĐģОвĐŊиĐēĐ°.
+
+Đи ĐŋĐĩŅĐĩŅвОŅŅŅĐŧĐž ŅĐĩĐš ŅŅĐĩŅĐ°ĐąĐĩĐģŅĐŊиК Ой'ŅĐēŅ Ņ СвиŅĐ°ĐšĐŊиК `list` Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `list(data.items())`.
+
+ĐĐžŅŅĐŧ, виĐēĐžŅиŅŅОвŅŅŅи `random.choice()`, Đŧи ĐŧĐžĐļĐĩĐŧĐž ĐžŅŅиĐŧĐ°Ņи виĐŋĐ°Đ´ĐēОвĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ СŅ ŅĐŋиŅĐēŅ, ŅОйŅĐž ĐžŅŅиĐŧŅŅĐŧĐž ĐēĐžŅŅĐĩĐļ ŅС `(id, name)`. ĐĻĐĩ ĐŧĐžĐļĐĩ ĐąŅŅи ŅĐžŅŅ ĐŊĐ° СŅаСОĐē `("imdb-tt0371724", "The Hitchhiker's Guide to the Galaxy")`.
+
+ĐĐ°ĐģŅ Đŧи **ĐŋŅиŅвОŅŅĐŧĐž ŅŅ два СĐŊĐ°ŅĐĩĐŊĐŊŅ** ĐēĐžŅŅĐĩĐļŅ СĐŧŅĐŊĐŊиĐŧ `id` Ņ `name`.
+
+ĐĸĐžĐļ, ŅĐēŅĐž ĐēĐžŅиŅŅŅваŅ ĐŊĐĩ вĐēаСав ID ĐĩĐģĐĩĐŧĐĩĐŊŅĐ°, вŅĐŊ вŅĐĩ ОдĐŊĐž ĐžŅŅиĐŧĐ°Ņ виĐŋĐ°Đ´ĐēОвŅ ŅĐĩĐēĐžĐŧĐĩĐŊĐ´Đ°ŅŅŅ.
+
+...Ņ вŅĐĩ ŅĐĩ ŅĐĩĐ°ĐģŅСОваĐŊĐž в **ОдĐŊĐžĐŧŅ ŅŅĐ´ĐēŅ ĐēОдŅ**. đ¤¯ ĐĨŅйа ĐŊĐĩ ĐŋŅĐĩĐēŅĐ°ŅĐŊиК Python? đ
+
+{* ../../docs_src/query_params_str_validations/tutorial015_an_py310.py ln[22:30] hl[29] *}
+
+## ĐŅĐ´ŅŅĐŧĐžĐē
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅŅваŅи дОдаŅĐēОвŅ ваĐģŅĐ´Đ°ŅŅŅ ŅĐ° ĐŧĐĩŅĐ°ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ Đ´ĐģŅ ŅвОŅŅ
ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв.
+
+ĐĐ°ĐŗĐ°ĐģŅĐŊŅ ваĐģŅĐ´Đ°ŅŅŅ ŅĐ° ĐŧĐĩŅĐ°ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ:
+
+* `alias`
+* `title`
+* `description`
+* `deprecated`
+
+ĐĐ°ĐģŅĐ´Đ°ŅŅŅ, ŅĐŋĐĩŅиŅŅŅĐŊŅ Đ´ĐģŅ ŅŅĐ´ĐēŅв:
+
+* `min_length`
+* `max_length`
+* `pattern`
+
+ĐĐ°ŅŅĐžĐŧĐŊŅ ваĐģŅĐ´Đ°ŅŅŅ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ `AfterValidator`.
+
+ĐŖ ŅиŅ
ĐŋŅиĐēĐģĐ°Đ´Đ°Ņ
Đи ĐŋОйаŅиĐģи, ŅĐē ĐžĐŗĐžĐģĐžŅŅваŅи ваĐģŅĐ´Đ°ŅŅŅ Đ´ĐģŅ СĐŊĐ°ŅĐĩĐŊŅ `str`.
+
+ĐивŅŅŅŅŅ ĐŊĐ°ŅŅŅĐŋĐŊŅ ŅОСдŅĐģи, ŅОй Đ´ŅСĐŊĐ°ŅиŅŅ, ŅĐē ĐžĐŗĐžĐģĐžŅŅваŅи ваĐģŅĐ´Đ°ŅŅŅ Đ´ĐģŅ ŅĐŊŅиŅ
ŅиĐŋŅв, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´ ŅиŅĐĩĐģ.
diff --git a/docs/uk/docs/tutorial/response-model.md b/docs/uk/docs/tutorial/response-model.md
new file mode 100644
index 000000000..def1f8a2d
--- /dev/null
+++ b/docs/uk/docs/tutorial/response-model.md
@@ -0,0 +1,358 @@
+# ĐОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ â ĐĸиĐŋ, ŅĐž ĐŋОвĐĩŅŅĐ°ŅŅŅŅŅ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ŅиĐŋ, ŅĐēиК виĐēĐžŅиŅŅОвŅваŅиĐŧĐĩŅŅŅŅ Ņ вŅĐ´ĐŋОвŅĐ´Ņ, Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ *Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ, ŅĐž ĐŋОвĐĩŅŅĐ°ŅŅŅŅŅ* *ŅŅĐŊĐēŅŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅŅ ŅĐģŅŅ
Ņ* (path operation)
+
+**ĐĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ** ĐŧĐžĐļĐŊĐ° вĐēаСаŅи ŅĐ°Đē ŅĐ°ĐŧĐž ŅĐē Ņ Đ´ĐģŅ вŅ
ŅĐ´ĐŊиŅ
**ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв** ŅŅĐŊĐēŅŅŅ: ŅĐĩ ĐŧĐžĐļŅŅŅ ĐąŅŅи ĐŧОдĐĩĐģŅ Pydantic, ŅĐŋиŅĐēи (lists), ŅĐģОвĐŊиĐēи (dictionaries), ŅĐēĐ°ĐģŅŅĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ, ŅĐē-ĐžŅ ŅŅĐģŅ ŅиŅĐģĐ° (integers), ĐąŅĐģĐĩвŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ (booleans) ŅĐžŅĐž.
+
+{* ../../docs_src/response_model/tutorial001_01_py310.py hl[16,21] *}
+
+FastAPI виĐēĐžŅиŅŅОвŅваŅиĐŧĐĩ ŅĐĩĐš ŅиĐŋ, ŅОй:
+
+* **ĐĐĩŅĐĩвŅŅиŅи ĐŋŅавиĐģŅĐŊŅŅŅŅ** ĐŋОвĐĩŅĐŊĐĩĐŊиŅ
Đ´Đ°ĐŊиŅ
.
+ * Đ¯ĐēŅĐž Đ´Đ°ĐŊŅ ĐŊĐĩ ваĐģŅĐ´ĐŊŅ (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, вŅĐ´ŅŅŅĐŊŅ ĐŋĐžĐģĐĩ), ŅĐĩ ОСĐŊĐ°ŅĐ°Ņ, ŅĐž ĐĐ°Ņ ĐēОд дОдаŅĐēŅ ĐŋŅĐ°ŅŅŅ ĐŊĐĩĐēĐžŅĐĩĐēŅĐŊĐž Ņ ĐŊĐĩ ĐŋОвĐĩŅŅĐ°Ņ ŅĐĩ, ŅĐž ĐŋОвиĐŊĐĩĐŊ. ĐŖ ŅĐ°ĐēĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ FastAPI ĐŋОвĐĩŅĐŊĐĩ ĐŋĐžĐŧиĐģĐēŅ ŅĐĩŅвĐĩŅĐ°, СаĐŧŅŅŅŅ ŅĐžĐŗĐž ŅОй вŅĐ´Đ´Đ°Ņи ĐŊĐĩĐ´ĐžĐŋŅŅŅиĐŧŅ Đ´Đ°ĐŊŅ. ĐĸĐ°Đē Đи ŅĐ° ĐĐ°ŅŅ ĐēĐģŅŅĐŊŅи ĐąŅĐ´ĐĩŅĐĩ вĐŋĐĩвĐŊĐĩĐŊŅ, ŅĐž ĐžŅŅиĐŧŅŅŅĐĩ ĐžŅŅĐēŅваĐŊŅ Đ´Đ°ĐŊŅ Ņ ĐŋŅавиĐģŅĐŊĐžĐŧŅ ŅĐžŅĐŧĐ°ŅŅ.
+
+* ĐОдаŅи **JSON Schema** вŅĐ´ĐŋОвŅĐ´Ņ Đ´Đž ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ OpenAPI в *ĐžĐŋĐĩŅĐ°ŅŅŅŅ
ŅĐģŅŅ
Ņ*.
+ * ĐĻĐĩ ĐąŅĐ´Đĩ виĐēĐžŅиŅŅĐ°ĐŊĐž в **авŅĐžĐŧĐ°ŅиŅĐŊŅĐš Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ**.
+ * Đ ŅĐ°ĐēĐžĐļ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅĐ°Đŧи, ŅĐēŅ авŅĐžĐŧĐ°ŅиŅĐŊĐž ĐŗĐĩĐŊĐĩŅŅŅŅŅ ĐēĐģŅŅĐŊŅŅŅĐēиК ĐēОд.
+
+ĐĐģĐĩ ĐŊĐ°ĐšĐŗĐžĐģОвĐŊŅŅĐĩ:
+
+* FastAPI **ОйĐŧĐĩĐļиŅŅ ŅĐ° вŅĐ´ŅŅĐģŅŅŅŅŅ** виŅ
ŅĐ´ĐŊŅ Đ´Đ°ĐŊŅ вŅĐ´ĐŋОвŅĐ´ĐŊĐž Đ´Đž ŅиĐŋŅ, вĐēаСаĐŊĐžĐŗĐž Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+ * ĐĻĐĩ ĐžŅОйĐģивО ваĐļĐģивО Đ´ĐģŅ **ĐąĐĩСĐŋĐĩĐēи**. ĐĐĩŅĐ°ĐģŅ ĐŊиĐļŅĐĩ.
+
+## ĐĐ°ŅĐ°ĐŧĐĩŅŅ `response_model`
+
+ĐĐŊОдŅ ĐĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž айО СŅŅŅĐŊĐž ĐŋОвĐĩŅŅĐ°Ņи ŅĐŊŅŅ ŅиĐŋи Đ´Đ°ĐŊиŅ
, ĐŊŅĐļ ŅŅ, ŅĐž СаСĐŊĐ°ŅĐĩĐŊŅ ŅĐē ŅиĐŋ вŅĐ´ĐŋОвŅĐ´Ņ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, Đи ĐŧĐžĐļĐĩŅĐĩ **ĐŋОвĐĩŅŅĐ°Ņи ŅĐģОвĐŊиĐē** айО ОйâŅĐēŅ йаСи Đ´Đ°ĐŊиŅ
, Đ°ĐģĐĩ **ĐžĐŗĐžĐģĐžŅиŅи ĐŧОдĐĩĐģŅ Pydantic** ŅĐē ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ. ĐĸОдŅ ĐŧОдĐĩĐģŅ Pydantic авŅĐžĐŧĐ°ŅиŅĐŊĐž ОйŅОйĐģŅŅиĐŧĐĩ ваĐģŅĐ´Đ°ŅŅŅ, Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ŅĐžŅĐž.
+
+Đ¯ĐēŅĐž Đи дОдаŅŅĐĩ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ Đ´ĐģŅ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ, ŅĐĩĐ´Đ°ĐēŅĐžŅ ĐēОдŅ айО mypy ĐŧĐžĐļŅŅŅ ĐŋĐžŅĐēĐ°ŅĐļиŅиŅŅ, ŅĐž ŅŅĐŊĐēŅŅŅ ĐŋОвĐĩŅŅĐ°Ņ ŅĐŊŅиК ŅиĐŋ (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, dict СаĐŧŅŅŅŅ Item).
+
+ĐŖ ŅĐ°ĐēиŅ
виĐŋĐ°Đ´ĐēĐ°Ņ
ĐŧĐžĐļĐŊĐ° ŅĐēĐžŅиŅŅĐ°ŅиŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐžĐŧ `response_model` в Đ´ĐĩĐēĐžŅĐ°ŅĐžŅŅ ĐŧĐ°ŅŅŅŅŅŅ (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, @app.get()).
+
+ĐĐ°ŅĐ°ĐŧĐĩŅŅ `response_model` ĐŋŅĐ°ŅŅŅ С ĐąŅĐ´Ņ-ŅĐēиĐŧ *ĐžĐŋĐĩŅĐ°ŅĐžŅĐžĐŧ ŅĐģŅŅ
Ņ*:
+
+* `@app.get()`
+* `@app.post()`
+* `@app.put()`
+* `@app.delete()`
+* ŅĐžŅĐž.
+
+{* ../../docs_src/response_model/tutorial001_py310.py hl[17,22,24:27] *}
+
+/// note | ĐŅиĐŧŅŅĐēĐ°
+
+ĐвĐĩŅĐŊŅŅŅ ŅваĐŗŅ, ŅĐž `response_model` Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐžĐŧ ĐŧĐĩŅОдŅ-Đ´ĐĩĐēĐžŅĐ°ŅĐžŅĐ° (`get`, `post`, ŅĐžŅĐž), Đ° ĐŊĐĩ *ŅŅĐŊĐēŅŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅŅ ŅĐģŅŅ
Ņ* (path operation function), ŅĐē ŅĐĩ ŅОйиŅŅŅŅ С ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°Đŧи айО ŅŅĐģĐžĐŧ СаĐŋиŅŅ.
+
+///
+
+`response_model` ĐŋŅиКĐŧĐ°Ņ ŅĐ°ĐēиК ŅĐ°ĐŧиК ŅиĐŋ, ŅĐēиК Đи Đą вĐēаСаĐģи Đ´ĐģŅ ĐŋĐžĐģŅ ĐŧОдĐĩĐģŅ Pydantic. ĐĸОйŅĐž ŅĐĩ ĐŧĐžĐļĐĩ ĐąŅŅи ŅĐē Pydantic-ĐŧОдĐĩĐģŅ, ŅĐ°Đē Ņ, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, `list` ŅС ĐŧОдĐĩĐģĐĩĐš Pydantic â `List[Item]`.
+
+FastAPI виĐēĐžŅиŅŅОвŅваŅиĐŧĐĩ `response_model` Đ´ĐģŅ ŅŅвОŅĐĩĐŊĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ваĐģŅĐ´Đ°ŅŅŅ Đ´Đ°ĐŊиŅ
ŅĐ° â ĐŊаКваĐļĐģивŅŅĐĩ â **ĐŋĐĩŅĐĩŅвОŅĐĩĐŊĐŊŅ ŅĐ° ŅŅĐģŅŅŅĐ°ŅŅŅ виŅ
ŅĐ´ĐŊиŅ
Đ´Đ°ĐŊиŅ
** СĐŗŅĐ´ĐŊĐž С ĐžĐŗĐžĐģĐžŅĐĩĐŊиĐŧ ŅиĐŋĐžĐŧ.
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+Đ¯ĐēŅĐž Ņ ĐĐ°Ņ ŅвŅĐŧĐēĐŊĐĩĐŊĐž ŅŅвОŅŅ ĐŋĐĩŅĐĩвŅŅĐēŅ ŅиĐŋŅв Ņ ŅĐĩĐ´Đ°ĐēŅĐžŅŅ, mypy ŅĐžŅĐž, Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ ŅŅĐŊĐēŅŅŅ ŅĐē `Any`.
+
+ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, Đи ĐŋОвŅĐ´ĐžĐŧĐģŅŅŅĐĩ ŅĐĩĐ´Đ°ĐēŅĐžŅŅ, ŅĐž ŅвŅĐ´ĐžĐŧĐž ĐŋОвĐĩŅŅĐ°ŅŅĐĩ ĐąŅĐ´Ņ-ŅĐž. ĐĐģĐĩ FastAPI ŅŅĐĩ ОдĐŊĐž виĐēĐžĐŊŅваŅиĐŧĐĩ ŅŅвОŅĐĩĐŊĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ваĐģŅĐ´Đ°ŅŅŅ, ŅŅĐģŅŅŅĐ°ŅŅŅ ŅĐžŅĐž Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `response_model`.
+
+///
+
+### ĐŅŅĐžŅиŅĐĩŅ `response_model`
+
+Đ¯ĐēŅĐž Đи вĐēаСŅŅŅĐĩ Ņ ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ, Ņ `response_model`, ŅĐž FastAPI виĐēĐžŅиŅŅОвŅваŅиĐŧĐĩ `response_model` С ĐŋŅŅĐžŅиŅĐĩŅĐžĐŧ.
+
+ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, Đи ĐŧĐžĐļĐĩŅĐĩ дОдаŅи ĐŋŅавиĐģŅĐŊŅ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅв Đ´Đž ваŅиŅ
ŅŅĐŊĐēŅŅĐš, ĐŊавŅŅŅ ŅĐēŅĐž вОĐŊи ĐŋОвĐĩŅŅĐ°ŅŅŅ ŅиĐŋ, вŅĐ´ĐŧŅĐŊĐŊиК вŅĐ´ `response_model`. ĐĻĐĩ ĐąŅĐ´Đĩ ĐēĐžŅиŅĐŊĐž Đ´ĐģŅ ŅĐĩĐ´Đ°ĐēŅĐžŅŅв ĐēОдŅ ŅĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв, ŅĐ°ĐēиŅ
ŅĐē mypy. Đ ĐŋŅи ŅŅĐžĐŧŅ FastAPI ĐŋŅОдОвĐļиŅŅ виĐēĐžĐŊŅваŅи ваĐģŅĐ´Đ°ŅŅŅ Đ´Đ°ĐŊиŅ
, ĐŗĐĩĐŊĐĩŅŅваŅи Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ŅĐžŅĐž ĐŊĐ° ĐžŅĐŊОвŅ `response_model`.
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи `response_model=None`, ŅОй виĐŧĐēĐŊŅŅи ŅŅвОŅĐĩĐŊĐŊŅ ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ Đ´ĐģŅ ŅŅŅŅ *ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*. ĐĻĐĩ ĐŧĐžĐļĐĩ СĐŊадОйиŅиŅŅ, ŅĐēŅĐž Đи дОдаŅŅĐĩ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅв Đ´Đž Ой'ŅĐēŅŅв, ŅĐēŅ ĐŊĐĩ Ņ Đ´ĐžĐŋŅŅŅиĐŧиĐŧи ĐŋĐžĐģŅĐŧи Pydantic â ĐŋŅиĐēĐģĐ°Đ´ ŅŅĐžĐŗĐž Đи ĐŋОйаŅиŅĐĩ в ОдĐŊĐžĐŧŅ С ĐŊĐ°ŅŅŅĐŋĐŊиŅ
ŅОСдŅĐģŅв.
+
+## ĐОвĐĩŅĐŊŅŅи ŅŅ ŅĐ°ĐŧŅ вŅ
ŅĐ´ĐŊŅ Đ´Đ°ĐŊŅ
+
+ĐĸŅŅ Đŧи ĐžĐŗĐžĐģĐžŅŅŅĐŧĐž ĐŧОдĐĩĐģŅ `UserIn`, ŅĐēĐ° ĐŧŅŅŅиŅŅ СвиŅĐ°ĐšĐŊиК ŅĐĩĐēŅŅОвиК ĐŋĐ°ŅĐžĐģŅ:
+
+{* ../../docs_src/response_model/tutorial002_py310.py hl[7,9] *}
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ЊОй виĐēĐžŅиŅŅОвŅваŅи `EmailStr`, ŅĐŋĐžŅĐ°ŅĐēŅ вŅŅĐ°ĐŊОвŅŅŅ `email-validator`.
+
+ĐĐĩŅĐĩĐēĐžĐŊĐ°ĐšŅĐĩŅŅ, ŅĐž Đи ŅŅвОŅиĐģи [вŅŅŅŅĐ°ĐģŅĐŊĐĩ ŅĐĩŅĐĩдОвиŅĐĩ](../virtual-environments.md){.internal-link target=_blank}, Đ°ĐēŅивŅваĐģи КОĐŗĐž, Đ° ĐŋĐžŅŅĐŧ вŅŅĐ°ĐŊОвиĐģи ĐŋĐ°ĐēĐĩŅ, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´:
+
+```console
+$ pip install email-validator
+```
+
+or with:
+
+```console
+$ pip install "pydantic[email]"
+```
+
+///
+
+Đ Đŧи виĐēĐžŅиŅŅОвŅŅĐŧĐž ŅŅ ĐŧОдĐĩĐģŅ, ŅОй ĐžĐŗĐžĐģĐžŅиŅи Ņ вŅ
ŅĐ´ĐŊŅ, Ņ виŅ
ŅĐ´ĐŊŅ Đ´Đ°ĐŊŅ:
+
+{* ../../docs_src/response_model/tutorial002_py310.py hl[16] *}
+
+ĐĸĐĩĐŋĐĩŅ, ĐēĐžĐģи ĐąŅĐ°ŅСĐĩŅ ŅŅвОŅŅŅ ĐēĐžŅиŅŅŅваŅĐ° С ĐŋĐ°ŅĐžĐģĐĩĐŧ, API ĐŋОвĐĩŅĐŊĐĩ ŅОК ŅĐ°ĐŧиК ĐŋĐ°ŅĐžĐģŅ Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+
+ĐŖ ŅŅĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ ŅĐĩ ĐŧĐžĐļĐĩ ĐŊĐĩ ĐąŅŅи ĐŋŅОйĐģĐĩĐŧĐžŅ, Đ°Đ´ĐļĐĩ ŅĐ°ĐŧĐĩ ĐēĐžŅиŅŅŅваŅ ĐŊĐ°Đ´ŅŅĐģав ĐŋĐ°ŅĐžĐģŅ.
+
+ĐĐģĐĩ ŅĐēŅĐž Đŧи виĐēĐžŅиŅŅĐ°ŅĐŧĐž ŅŅ Đļ ĐŧОдĐĩĐģŅ Đ´ĐģŅ ŅĐŊŅĐžŅ ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ, Đŧи ĐŧĐžĐļĐĩĐŧĐž виĐŋĐ°Đ´ĐēОвО ĐŊĐ°Đ´ŅŅĐģĐ°Ņи ĐŋĐ°ŅĐžĐģŅ ĐŊĐ°ŅиŅ
ĐēĐžŅиŅŅŅваŅŅв ĐēĐžĐļĐŊĐžĐŧŅ ĐēĐģŅŅĐŊŅŅ.
+
+/// danger | ĐĐąĐĩŅĐĩĐļĐŊĐž
+
+ĐŅĐēĐžĐģи ĐŊĐĩ СйĐĩŅŅĐŗĐ°ĐšŅĐĩ ĐŋĐ°ŅĐžĐģŅ ĐēĐžŅиŅŅŅваŅĐ° Ņ вŅĐ´ĐēŅиŅĐžĐŧŅ виĐŗĐģŅĐ´Ņ ŅĐ° ĐŊĐĩ ĐŊĐ°Đ´ŅиĐģĐ°ĐšŅĐĩ КОĐŗĐž Ņ вŅĐ´ĐŋОвŅĐ´Ņ, ŅĐēŅĐž ŅŅĐģŅĐēи Đи ĐŊĐĩ СĐŊĐ°ŅŅĐĩ вŅŅ ŅиСиĐēи Ņ ŅĐžŅĐŊĐž ŅОСŅĐŧŅŅŅĐĩ, ŅĐž ŅОйиŅĐĩ.
+
+///
+
+## ĐОдаКŅĐĩ ĐžĐēŅĐĩĐŧŅ виŅ
ŅĐ´ĐŊŅ ĐŧОдĐĩĐģŅ
+
+ĐĐ°ĐŧŅŅŅŅ ŅŅĐžĐŗĐž Đŧи ĐŧĐžĐļĐĩĐŧĐž ŅŅвОŅиŅи вŅ
ŅĐ´ĐŊŅ ĐŧОдĐĩĐģŅ С вŅĐ´ĐēŅиŅиĐŧ ĐŋĐ°ŅĐžĐģĐĩĐŧ Ņ виŅ
ŅĐ´ĐŊŅ ĐŧОдĐĩĐģŅ ĐąĐĩС ĐŊŅĐžĐŗĐž:
+
+{* ../../docs_src/response_model/tutorial003_py310.py hl[9,11,16] *}
+
+ĐĸŅŅ, ĐŊавŅŅŅ ŅĐēŅĐž *ŅŅĐŊĐēŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ* ĐŋОвĐĩŅŅĐ°Ņ Ой'ŅĐēŅ ĐēĐžŅиŅŅŅваŅĐ°, ŅĐēиК ĐŧŅŅŅиŅŅ ĐŋĐ°ŅĐžĐģŅ:
+
+{* ../../docs_src/response_model/tutorial003_py310.py hl[24] *}
+
+...Đŧи ĐžĐŗĐžĐģĐžŅиĐģи `response_model` ŅĐē ĐŊĐ°ŅŅ ĐŧОдĐĩĐģŅ `UserOut`, ŅĐēĐ° ĐŊĐĩ ĐŧŅŅŅиŅŅ ĐŋĐ°ŅĐžĐģŅ:
+
+{* ../../docs_src/response_model/tutorial003_py310.py hl[22] *}
+
+ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, **FastAPI** авŅĐžĐŧĐ°ŅиŅĐŊĐž вŅĐ´ŅŅĐģŅŅŅŅŅ вŅŅ Đ´Đ°ĐŊŅ, ŅĐēŅ ĐŊĐĩ вĐēаСаĐŊŅ Ņ виŅ
ŅĐ´ĐŊŅĐš ĐŧОдĐĩĐģŅ (Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ Pydantic).
+
+### `response_model` айО ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ
+
+ĐŖ ŅŅĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ, ĐžŅĐēŅĐģŅĐēи двŅ ĐŧОдĐĩĐģŅ ŅŅСĐŊŅ, ŅĐēŅĐž Đŧи Đ°ĐŊĐžŅŅŅĐŧĐž ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ ŅŅĐŊĐēŅŅŅ ŅĐē `UserOut`, ŅĐĩĐ´Đ°ĐēŅĐžŅ Ņ ŅĐ°ĐēŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи, ŅĐē mypy, видадŅŅŅ ĐŋĐžĐŧиĐģĐēŅ, йО ŅĐ°ĐēŅиŅĐŊĐž Đŧи ĐŋОвĐĩŅŅĐ°ŅĐŧĐž ŅĐŊŅиК ŅиĐŋ.
+
+ĐĸĐžĐŧŅ в ŅŅĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ Đŧи виĐēĐžŅиŅŅОвŅŅĐŧĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `response_model`, Đ° ĐŊĐĩ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ.
+
+...Đ°ĐģĐĩ ŅиŅĐ°ĐšŅĐĩ Đ´Đ°ĐģŅ, ŅОй Đ´ŅСĐŊĐ°ŅиŅŅ, ŅĐē ОйŅĐšŅи ŅĐĩ ОйĐŧĐĩĐļĐĩĐŊĐŊŅ.
+
+## ĐĸиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ Ņ ŅŅĐģŅŅŅĐ°ŅŅŅ Đ´Đ°ĐŊиŅ
+
+ĐŅОдОвĐļиĐŧĐž С ĐŋĐžĐŋĐĩŅĐĩĐ´ĐŊŅĐžĐŗĐž ĐŋŅиĐēĐģĐ°Đ´Ņ. Đи Ņ
ĐžŅŅĐģи **Đ°ĐŊĐžŅŅваŅи ŅŅĐŊĐēŅŅŅ ОдĐŊиĐŧ ŅиĐŋĐžĐŧ**, Đ°ĐģĐĩ ĐŋŅи ŅŅĐžĐŧŅ ĐŋОвĐĩŅŅĐ°Ņи С ĐŊĐĩŅ ĐąŅĐģŅŅĐĩ Đ´Đ°ĐŊиŅ
.
+
+Đи Ņ
ĐžŅĐĩĐŧĐž, ŅОй FastAPI ĐŋŅОдОвĐļŅвав **ŅŅĐģŅŅŅŅваŅи** ŅŅ Đ´Đ°ĐŊŅ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ response_model. ĐĸОйŅĐž ĐŊавŅŅŅ ŅĐēŅĐž ŅŅĐŊĐēŅŅŅ ĐŋОвĐĩŅŅĐ°Ņ ĐąŅĐģŅŅĐĩ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ, Ņ вŅĐ´ĐŋОвŅĐ´Ņ ĐąŅĐ´ŅŅŅ ĐģиŅĐĩ ŅŅ ĐŋĐžĐģŅ, ŅĐēŅ вĐēаСаĐŊŅ Ņ response_model.
+
+ĐŖ ĐŋĐžĐŋĐĩŅĐĩĐ´ĐŊŅĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ, ĐžŅĐēŅĐģŅĐēи ĐēĐģĐ°Ņи ĐąŅĐģи ŅŅСĐŊŅ, ĐŊĐ°Đŧ дОвĐĩĐģĐžŅŅ виĐēĐžŅиŅŅОвŅваŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `response_model`. ĐĐģĐĩ ŅĐĩ ОСĐŊĐ°ŅĐ°Ņ, ŅĐž Đŧи ĐŊĐĩ ĐžŅŅиĐŧŅŅĐŧĐž ĐŋŅĐ´ŅŅиĐŧĐēи С йОĐēŅ ŅĐĩĐ´Đ°ĐēŅĐžŅĐ° ĐēОдŅ ŅĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв ĐŋĐĩŅĐĩвŅŅĐēи ŅиĐŋŅв ŅОдО ŅиĐŋŅ, ŅĐēиК ĐŋОвĐĩŅŅĐ°Ņ ŅŅĐŊĐēŅŅŅ.
+
+ĐŅĐžŅĐĩ в ĐąŅĐģŅŅĐžŅŅŅ виĐŋĐ°Đ´ĐēŅв, ĐēĐžĐģи ĐŊĐ°Đŧ ĐŋĐžŅŅŅĐąĐŊĐž СŅОйиŅи ŅĐžŅŅ ĐŋОдŅĐąĐŊĐĩ, Đŧи ĐŋŅĐžŅŅĐž Ņ
ĐžŅĐĩĐŧĐž, ŅОй ĐŧОдĐĩĐģŅ **вŅĐ´ŅŅĐģŅŅŅŅваĐģĐ° айО ĐŋŅийŅĐ°ĐģĐ°** ŅĐ°ŅŅиĐŊŅ Đ´Đ°ĐŊиŅ
, ŅĐē Ņ ŅŅĐžĐŧŅ ĐŋŅиĐēĐģĐ°Đ´Ņ.
+
+ĐŖ ŅĐ°ĐēиŅ
виĐŋĐ°Đ´ĐēĐ°Ņ
Đŧи ĐŧĐžĐļĐĩĐŧĐž виĐēĐžŅиŅŅĐ°Ņи ĐēĐģĐ°Ņи ŅĐ° ŅĐŋĐ°Đ´ĐēŅваĐŊĐŊŅ, ŅОй ŅĐēĐžŅиŅŅĐ°ŅиŅŅ **Đ°ĐŊĐžŅĐ°ŅŅŅĐŧи ŅиĐŋŅв** ŅŅĐŊĐēŅŅĐš â ŅĐĩ Đ´Đ°Ņ ĐēŅĐ°ŅŅ ĐŋŅĐ´ŅŅиĐŧĐēŅ С йОĐēŅ ŅĐĩĐ´Đ°ĐēŅĐžŅĐ° ŅĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв ŅиĐŋŅ mypy, Ņ ĐŋŅи ŅŅĐžĐŧŅ FastAPI ĐŋŅОдОвĐļŅŅ виĐēĐžĐŊŅваŅи **ŅŅĐģŅŅŅĐ°ŅŅŅ Đ´Đ°ĐŊиŅ
** Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+
+{* ../../docs_src/response_model/tutorial003_01_py310.py hl[7:10,13:14,18] *}
+
+ĐавдŅĐēи ŅŅĐžĐŧŅ Đŧи ĐžŅŅиĐŧŅŅĐŧĐž ĐŋŅĐ´ŅŅиĐŧĐēŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв â вŅĐ´ ŅĐĩĐ´Đ°ĐēŅĐžŅŅв Ņ mypy, ĐžŅĐēŅĐģŅĐēи ŅĐĩĐš ĐēОд Ņ ĐēĐžŅĐĩĐēŅĐŊиĐŧ С ŅĐžŅĐēи СОŅŅ ŅиĐŋŅв, â Đ°ĐģĐĩ Đŧи ŅĐ°ĐēĐžĐļ ĐžŅŅиĐŧŅŅĐŧĐž ŅŅĐģŅŅŅĐ°ŅŅŅ Đ´Đ°ĐŊиŅ
вŅĐ´ FastAPI.
+
+Đ¯Đē ŅĐĩ ĐŋŅĐ°ŅŅŅ? ĐаваКŅĐĩ ŅОСйĐĩŅĐĩĐŧĐžŅŅ. đ¤
+
+### ĐĸиĐŋи ŅĐ° ĐŋŅĐ´ŅŅиĐŧĐēĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв
+
+ĐĄĐŋĐĩŅŅŅ ĐŋОдивиĐŧĐžŅŅ, ŅĐē ŅĐĩ йаŅĐ°ŅŅ ŅĐĩĐ´Đ°ĐēŅĐžŅи, mypy ŅĐ° ŅĐŊŅŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи.
+
+`BaseUser` ĐŧĐ°Ņ йаСОвŅ ĐŋĐžĐģŅ. ĐĐžŅŅĐŧ `UserIn` ŅŅĐŋĐ°Đ´ĐēОвŅŅ `BaseUser` Ņ дОдаŅ ĐŋĐžĐģĐĩ `password`, ĐžŅĐļĐĩ, вŅĐŊ ĐŧĐ°ŅиĐŧĐĩ вŅŅ ĐŋĐžĐģŅ С ОйОŅ
ĐŧОдĐĩĐģĐĩĐš.
+
+Đи СаСĐŊĐ°ŅĐ°ŅĐŧĐž ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ ŅŅĐŊĐēŅŅŅ ŅĐē `BaseUser`, Đ°ĐģĐĩ ŅĐ°ĐēŅиŅĐŊĐž ĐŋОвĐĩŅŅĐ°ŅĐŧĐž ĐĩĐēСĐĩĐŧĐŋĐģŅŅ `UserIn`.
+
+Đ ĐĩĐ´Đ°ĐēŅĐžŅ, mypy ŅĐ° ŅĐŊŅŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи ĐŊĐĩ ŅĐēĐ°ŅĐļиŅиĐŧŅŅŅŅŅ ĐŊĐ° ŅĐĩ, ŅĐžĐŧŅ ŅĐž С ŅĐžŅĐēи СОŅŅ ŅиĐŋŅСаŅŅŅ `UserIn` Ņ ĐŋŅĐ´ĐēĐģĐ°ŅĐžĐŧ `BaseUser`, Đ° ŅĐĩ ОСĐŊĐ°ŅĐ°Ņ, ŅĐž вŅĐŊ Ņ `ваĐģŅĐ´ĐŊиĐŧ` ŅиĐŋĐžĐŧ, ĐēĐžĐģи ĐžŅŅĐēŅŅŅŅŅŅ ĐąŅĐ´Ņ-ŅĐž, ŅĐž Ņ `BaseUser`.
+
+### ФŅĐģŅŅŅĐ°ŅŅŅ Đ´Đ°ĐŊиŅ
Ņ FastAPI
+
+ĐĸĐĩĐŋĐĩŅ Đ´ĐģŅ FastAPI вŅĐŊ йаŅиŅŅ ŅиĐŋ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ Ņ ĐŋĐĩŅĐĩĐēĐžĐŊŅŅŅŅŅŅ, ŅĐž ŅĐĩ, ŅĐž Đи ĐŋОвĐĩŅŅĐ°ŅŅĐĩ, ĐŧŅŅŅиŅŅ **ŅŅĐģŅĐēи** ĐŋĐžĐģŅ, ŅĐēŅ ĐžĐŗĐžĐģĐžŅĐĩĐŊŅ Ņ ŅŅĐžĐŧŅ ŅиĐŋŅ.
+
+FastAPI виĐēĐžĐŊŅŅ ĐēŅĐģŅĐēĐ° вĐŊŅŅŅŅŅĐŊŅŅ
ĐžĐŋĐĩŅĐ°ŅŅĐš С Pydantic, ŅОй ĐŗĐ°ŅĐ°ĐŊŅŅваŅи, ŅĐž ĐŋŅавиĐģĐ° ĐŊĐ°ŅĐģŅĐ´ŅваĐŊĐŊŅ ĐēĐģĐ°ŅŅв ĐŊĐĩ СаŅŅĐžŅОвŅŅŅŅŅŅ Đ´ĐģŅ ŅŅĐģŅŅŅĐ°ŅŅŅ ĐŋОвĐĩŅĐŊĐĩĐŊиŅ
Đ´Đ°ĐŊиŅ
, ŅĐŊĐ°ĐēŅĐĩ Đи ĐŧĐžĐŗĐģи Đą ĐŋОвĐĩŅĐŊŅŅи СĐŊĐ°ŅĐŊĐž ĐąŅĐģŅŅĐĩ Đ´Đ°ĐŊиŅ
, ĐŊŅĐļ ĐžŅŅĐēŅваĐģи.
+
+ĐĸĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, Đи ĐžŅŅиĐŧŅŅŅĐĩ ĐŊĐ°ĐšĐēŅĐ°ŅĐĩ С двОŅ
ŅвŅŅŅв: Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅв **С ĐŋŅĐ´ŅŅиĐŧĐēĐžŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв** Ņ **ŅŅĐģŅŅŅĐ°ŅŅŅ Đ´Đ°ĐŊиŅ
**.
+
+## ĐОдивиŅиŅŅ Ņ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ
+
+ĐĐžĐģи Đи дивиŅĐĩŅŅ авŅĐžĐŧĐ°ŅиŅĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, Đи ĐŧĐžĐļĐĩŅĐĩ ĐŋОйаŅиŅи, ŅĐž вŅ
ŅĐ´ĐŊĐ° ĐŧОдĐĩĐģŅ Ņ виŅ
ŅĐ´ĐŊĐ° ĐŧОдĐĩĐģŅ ĐŧĐ°ŅŅŅ вĐģĐ°ŅĐŊŅ JSON-ŅŅ
ĐĩĐŧŅ:
+
+
+
+РОйидвŅ ĐŧОдĐĩĐģŅ виĐēĐžŅиŅŅОвŅŅŅŅŅŅ Đ´ĐģŅ ŅĐŊŅĐĩŅĐ°ĐēŅивĐŊĐžŅ API-Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ:
+
+
+
+## ĐĐŊŅŅ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅв ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ
+
+ĐŅĐŊŅŅŅŅ виĐŋĐ°Đ´Đēи, ĐēĐžĐģи Đи ĐŋОвĐĩŅŅĐ°ŅŅĐĩ ŅĐžŅŅ, ŅĐž ĐŊĐĩ Ņ Đ´ĐžĐŋŅŅŅиĐŧиĐŧ ĐŋĐžĐģĐĩĐŧ Pydantic, Đ°ĐģĐĩ Đ°ĐŊĐžŅŅŅŅĐĩ ŅĐĩ Ņ ŅŅĐŊĐēŅŅŅ ĐģиŅĐĩ Đ´ĐģŅ ŅĐžĐŗĐž, ŅОй ĐžŅŅиĐŧĐ°Ņи ĐŋŅĐ´ŅŅиĐŧĐēŅ вŅĐ´ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв (ŅĐĩĐ´Đ°ĐēŅĐžŅĐ°, mypy ŅĐžŅĐž).
+
+### ĐОвĐĩŅĐŊĐĩĐŊĐŊŅ Response ĐŊĐ°ĐŋŅŅĐŧŅ
+
+ĐĐ°ĐšĐŋĐžŅиŅĐĩĐŊŅŅиĐŧ виĐŋĐ°Đ´ĐēĐžĐŧ ĐąŅĐ´Đĩ [ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ Response ĐŊĐ°ĐŋŅŅĐŧŅ, ŅĐē ĐŋĐžŅŅĐŊŅŅŅŅŅŅ ĐŋŅСĐŊŅŅĐĩ Ņ ŅОСŅиŅĐĩĐŊŅĐš Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ](../advanced/response-directly.md){.internal-link target=_blank}.
+
+{* ../../docs_src/response_model/tutorial003_02.py hl[8,10:11] *}
+
+ĐĻĐĩĐš ĐŋŅĐžŅŅиК виĐŋĐ°Đ´ĐžĐē авŅĐžĐŧĐ°ŅиŅĐŊĐž ОйŅОйĐģŅŅŅŅŅŅ FastAPI, ŅĐžĐŧŅ ŅĐž Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ â ŅĐĩ ĐēĐģĐ°Ņ (айО ĐŋŅĐ´ĐēĐģĐ°Ņ) `Response`.
+
+Đ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи ŅĐ°ĐēĐžĐļ ĐąŅĐ´ŅŅŅ СадОвОĐģĐĩĐŊŅ, йО Ņ `RedirectResponse`, Ņ `JSONResponse` Ņ ĐŋŅĐ´ĐēĐģĐ°ŅĐ°Đŧи `Response`, ĐžŅĐļĐĩ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ ĐēĐžŅĐĩĐēŅĐŊĐ°.
+
+### ĐĐŊĐžŅĐ°ŅŅŅ ĐŋŅĐ´ĐēĐģĐ°ŅŅ Response
+
+ĐĸĐ°ĐēĐžĐļ ĐŧĐžĐļĐŊĐ° виĐēĐžŅиŅŅОвŅваŅи ĐŋŅĐ´ĐēĐģĐ°Ņ `Response` Ņ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ:
+
+{* ../../docs_src/response_model/tutorial003_03.py hl[8:9] *}
+
+ĐĻĐĩ ŅĐĩĐļ ĐŋŅĐ°ŅŅваŅиĐŧĐĩ, йО `RedirectResponse` â ĐŋŅĐ´ĐēĐģĐ°Ņ `Response`, Ņ FastAPI авŅĐžĐŧĐ°ŅиŅĐŊĐž ОйŅОйиŅŅ ŅĐĩĐš ĐŋŅĐžŅŅиК виĐŋĐ°Đ´ĐžĐē.
+
+### ĐĐĩĐēĐžŅĐĩĐēŅĐŊŅ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ
+
+ĐĐģĐĩ ĐēĐžĐģи Đи ĐŋОвĐĩŅŅĐ°ŅŅĐĩ ŅĐēиКŅŅ ŅĐŊŅиК дОвŅĐģŅĐŊиК ОйâŅĐēŅ, ŅĐž ĐŊĐĩ Ņ ваĐģŅĐ´ĐŊиĐŧ ŅиĐŋĐžĐŧ Pydantic (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, ОйâŅĐēŅ йаСи Đ´Đ°ĐŊиŅ
), Ņ Đ°ĐŊĐžŅŅŅŅĐĩ КОĐŗĐž ŅĐ°Đē Ņ ŅŅĐŊĐēŅŅŅ, FastAPI ŅĐŋŅОйŅŅ ŅŅвОŅиŅи Pydantic ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ ĐŊĐ° ĐžŅĐŊОвŅ ŅŅŅŅ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ, Ņ ŅĐĩ СавĐĩŅŅиŅŅŅŅ ĐŋĐžĐŧиĐģĐēĐžŅ.
+
+ĐĸĐĩ ŅĐ°ĐŧĐĩ ŅŅĐ°ĐŊĐĩŅŅŅŅ, ŅĐēŅĐž Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ union ĐŧŅĐļ ŅŅСĐŊиĐŧи ŅиĐŋĐ°Đŧи, Đ´Đĩ ОдиĐŊ айО ĐąŅĐģŅŅĐĩ ĐŊĐĩ Ņ ваĐģŅĐ´ĐŊиĐŧи ŅиĐŋĐ°Đŧи Pydantic, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐĩ ŅĐŋŅиŅиĐŊиŅŅ ĐŋĐžĐŧиĐģĐēŅ đĨ:
+
+{* ../../docs_src/response_model/tutorial003_04_py310.py hl[8] *}
+
+...ŅĐĩ ĐŊĐĩ ĐŋŅĐ°ŅŅŅ, ŅĐžĐŧŅ ŅĐž ŅиĐŋ Đ°ĐŊĐžŅĐ°ŅŅŅ ĐŊĐĩ Ņ ŅиĐŋĐžĐŧ Pydantic Ņ ĐŊĐĩ Ņ ĐŋŅĐžŅŅĐž ĐēĐģĐ°ŅĐžĐŧ `Response` айО КОĐŗĐž ĐŋŅĐ´ĐēĐģĐ°ŅĐžĐŧ, Đ° Ņ ОйâŅĐ´ĐŊĐ°ĐŊĐŊŅĐŧ (union) â айО `Response`, айО `dict`.
+
+### ĐŅĐ´ĐēĐģŅŅĐĩĐŊĐŊŅ ĐОдĐĩĐģŅ ĐŅĐ´ĐŋОвŅĐ´Ņ
+
+ĐŅОдОвĐļŅŅŅи ĐŋŅиĐēĐģĐ°Đ´ виŅĐĩ, ĐŧĐžĐļĐģивО, Đи ĐŊĐĩ Ņ
ĐžŅĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ŅŅĐ°ĐŊĐ´Đ°ŅŅĐŊŅ ваĐģŅĐ´Đ°ŅŅŅ Đ´Đ°ĐŊиŅ
, авŅĐžĐŧĐ°ŅиŅĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ŅŅĐģŅŅŅĐ°ŅŅŅ ŅĐžŅĐž, ŅĐēŅ FastAPI виĐēĐžĐŊŅŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ.
+
+ĐĐģĐĩ ви вŅĐĩ ОдĐŊĐž ĐŧĐžĐļĐĩŅĐĩ СаĐģиŅиŅи Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅ Ņ ŅŅĐŊĐēŅŅŅ, ŅОй СйĐĩŅĐĩĐŗŅи ĐŋŅĐ´ŅŅиĐŧĐēŅ С йОĐēŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв, ŅĐ°ĐēиŅ
ŅĐē ŅĐĩĐ´Đ°ĐēŅĐžŅи ĐēОдŅ айО ŅŅĐ°ŅиŅĐŊŅ ĐŋĐĩŅĐĩвŅŅĐēи ŅиĐŋŅв (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, mypy).
+
+ĐŖ ŅĐ°ĐēĐžĐŧŅ виĐŋĐ°Đ´ĐēŅ ви ĐŧĐžĐļĐĩŅĐĩ виĐŧĐēĐŊŅŅи ĐŗĐĩĐŊĐĩŅĐ°ŅŅŅ ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ, вŅŅĐ°ĐŊОвивŅи `response_model=None`:
+
+{* ../../docs_src/response_model/tutorial003_05_py310.py hl[7] *}
+
+ĐĻĐĩ СĐŧŅŅиŅŅ FastAPI ĐŋŅĐžĐŋŅŅŅиŅи ĐŗĐĩĐŊĐĩŅĐ°ŅŅŅ ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ, Ņ ŅĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ Đи СĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ĐąŅĐ´Ņ-ŅĐēŅ Đ°ĐŊĐžŅĐ°ŅŅŅ ŅиĐŋŅв ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ ĐąĐĩС вĐŋĐģивŅ ĐŊĐ° ваŅŅ FastAPI Đ°ĐŋĐģŅĐēĐ°ŅŅŅ. đ¤
+
+## ĐĐ°ŅĐ°ĐŧĐĩŅŅи ĐēОдŅваĐŊĐŊŅ ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ
+
+ĐĐ°ŅĐ° ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ ĐŧĐžĐļĐĩ ĐŧĐ°Ņи СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´:
+
+{* ../../docs_src/response_model/tutorial004_py310.py hl[9,11:12] *}
+
+* `description: Union[str, None] = None` (айО `str | None = None` Ņ Python 3.10) ĐŧĐ°Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ `None`.
+* `tax: float = 10.5` ĐŧĐ°Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ `10.5`.
+* `tags: List[str] = []` ĐŧĐ°Ņ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ ĐŋĐžŅĐžĐļĐŊŅĐš ŅĐŋиŅĐžĐē: `[]`.
+
+ĐĐģĐĩ Đи ĐŧĐžĐļĐĩŅĐĩ СаŅ
ĐžŅŅŅи ĐŊĐĩ вĐēĐģŅŅĐ°Ņи ŅŅ
Ņ ŅĐĩСŅĐģŅŅĐ°Ņ, ŅĐēŅĐž вОĐŊи ŅĐ°ĐēŅиŅĐŊĐž ĐŊĐĩ ĐąŅĐģи СйĐĩŅĐĩĐļĐĩĐŊŅ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐēŅĐž Ņ ĐĐ°Ņ Ņ ĐŧОдĐĩĐģŅ С йаĐŗĐ°ŅŅĐŧĐ° ĐŊĐĩОйОвâŅСĐēОвиĐŧи Đ°ŅŅийŅŅĐ°Đŧи Ņ NoSQL йаСŅ Đ´Đ°ĐŊиŅ
, Đ°ĐģĐĩ Đи ĐŊĐĩ Ņ
ĐžŅĐĩŅĐĩ вŅĐ´ĐŋŅавĐģŅŅи Đ´ŅĐļĐĩ дОвĐŗŅ JSON-вŅĐ´ĐŋОвŅĐ´Ņ, ĐŋОвĐŊŅ СĐŊĐ°ŅĐĩĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ.
+
+### ĐиĐēĐžŅиŅŅОвŅĐšŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `response_model_exclude_unset`
+
+Đи ĐŧĐžĐļĐĩŅĐĩ вŅŅĐ°ĐŊОвиŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ Đ´ĐĩĐēĐžŅĐ°ŅĐžŅĐ° ŅĐģŅŅ
Ņ `response_model_exclude_unset=True`:
+
+{* ../../docs_src/response_model/tutorial004_py310.py hl[22] *}
+
+Ņ ŅŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ ĐŊĐĩ ĐąŅĐ´ŅŅŅ вĐēĐģŅŅĐĩĐŊŅ Ņ вŅĐ´ĐŋОвŅĐ´Ņ, ŅŅĐģŅĐēи ŅĐ°ĐēŅиŅĐŊĐž вŅŅĐ°ĐŊОвĐģĐĩĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ.
+
+ĐŅĐļĐĩ, ŅĐēŅĐž Đи ĐŊĐ°Đ´ŅŅĐģĐĩŅĐĩ СаĐŋиŅ Đ´Đž ŅŅĐžĐŗĐž ĐžĐŋĐĩŅĐ°ŅĐžŅĐ° ŅĐģŅŅ
Ņ Đ´ĐģŅ ĐĩĐģĐĩĐŧĐĩĐŊŅĐ° С item_id `foo`, вŅĐ´ĐŋОвŅĐ´Ņ (ĐąĐĩС вĐēĐģŅŅĐĩĐŊĐŊŅ СĐŊĐ°ŅĐĩĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ) ĐąŅĐ´Đĩ:
+
+```JSON
+{
+ "name": "Foo",
+ "price": 50.2
+}
+```
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐŖ Pydantic вĐĩŅŅŅŅ 1 ĐŧĐĩŅОд ĐŊаСивавŅŅ `.dict()`, вŅĐŊ ĐąŅв СаŅŅĐ°ŅŅĐģиК (Đ°ĐģĐĩ ŅĐĩ ĐŋŅĐ´ŅŅиĐŧŅŅŅŅŅŅ) Ņ Pydantic вĐĩŅŅŅŅ 2 Ņ ĐŋĐĩŅĐĩĐšĐŧĐĩĐŊОваĐŊиК Ņ `.model_dump()`.
+
+ĐŅиĐēĐģади ŅŅŅ виĐēĐžŅиŅŅОвŅŅŅŅ `.dict()` Đ´ĐģŅ ŅŅĐŧŅŅĐŊĐžŅŅŅ С Pydantic v1, Đ°ĐģĐĩ ĐĐ°Đŧ ŅĐģŅĐ´ виĐēĐžŅиŅŅОвŅваŅи `.model_dump()`, ŅĐēŅĐž Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи Pydantic v2.
+
+///
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+FastAPI виĐēĐžŅиŅŅОвŅŅ `.dict()` ĐŧОдĐĩĐģŅ Pydantic С ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐžĐŧ `exclude_unset`, ŅОй Đ´ĐžŅŅĐŗŅи ŅŅĐžĐŗĐž.
+
+///
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи:
+
+* `response_model_exclude_defaults=True`
+* `response_model_exclude_none=True`
+
+ŅĐē ĐžĐŋиŅĐ°ĐŊĐž в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Pydantic for `exclude_defaults` ŅĐ° `exclude_none`.
+
+///
+
+#### ĐĐ°ĐŊŅ СŅ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи Đ´ĐģŅ ĐŋĐžĐģŅв ŅС ŅиĐŋОвиĐŧи СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи
+
+ĐĐģĐĩ ŅĐēŅĐž ĐĐ°ŅŅ Đ´Đ°ĐŊŅ ĐŧĐ°ŅŅŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ Đ´ĐģŅ ĐŋĐžĐģŅв ĐŧОдĐĩĐģŅ С ŅиĐŋОвиĐŧи СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи, ŅĐē Ņ ĐĩĐģĐĩĐŧĐĩĐŊŅĐ° С item_id `bar`:
+
+```Python hl_lines="3 5"
+{
+ "name": "Bar",
+ "description": "The bartenders",
+ "price": 62,
+ "tax": 20.2
+}
+```
+вОĐŊи ĐąŅĐ´ŅŅŅ вĐēĐģŅŅĐĩĐŊŅ Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+
+#### ĐĐ°ĐŊŅ С ŅиĐŧи ŅĐ°ĐŧиĐŧи СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи, ŅĐž Đš ŅиĐŋОвŅ
+
+Đ¯ĐēŅĐž Đ´Đ°ĐŊŅ ĐŧĐ°ŅŅŅ ŅŅ ŅĐ°ĐŧŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ, ŅĐž Đš ŅиĐŋОвŅ, ŅĐē Ņ ĐĩĐģĐĩĐŧĐĩĐŊŅĐ° С item_id `baz`:
+
+```Python hl_lines="3 5-6"
+{
+ "name": "Baz",
+ "description": None,
+ "price": 50.2,
+ "tax": 10.5,
+ "tags": []
+}
+```
+
+FastAPI Đ´ĐžŅŅĐ°ŅĐŊŅĐž ŅОСŅĐŧĐŊиК (ĐŊĐ°ŅĐŋŅавдŅ, Pydantic Đ´ĐžŅŅĐ°ŅĐŊŅĐž ŅОСŅĐŧĐŊиК), ŅОй СŅОСŅĐŧŅŅи, ŅĐž, Ņ
ĐžŅĐ° `description`, `tax` Ņ `tags` ĐŧĐ°ŅŅŅ ŅŅ ŅĐ°ĐŧŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ, ŅĐž Đš ŅиĐŋОвŅ, вОĐŊи ĐąŅĐģи вŅŅĐ°ĐŊОвĐģĐĩĐŊŅ ŅвĐŊĐž (Đ° ĐŊĐĩ вСŅŅŅ ŅĐē СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ).
+
+ĐŅĐļĐĩ, вОĐŊи ĐąŅĐ´ŅŅŅ вĐēĐģŅŅĐĩĐŊŅ Ņ JSON-вŅĐ´ĐŋОвŅĐ´Ņ.
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐвĐĩŅĐŊŅŅŅ ŅваĐŗŅ, ŅĐž ŅиĐŋОвŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ ĐŧĐžĐļŅŅŅ ĐąŅŅи ĐąŅĐ´Ņ-ŅĐēиĐŧи, ĐŊĐĩ ĐģиŅĐĩ `None`.
+
+ĐĻĐĩ ĐŧĐžĐļĐĩ ĐąŅŅи list (`[]`), `float` 10.5 ŅĐžŅĐž.
+
+///
+
+### `response_model_include` ŅĐ° `response_model_exclude`
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи *Đ´ĐĩĐēĐžŅĐ°ŅĐžŅĐ° ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ* `response_model_include` ŅĐ° `response_model_exclude`.
+
+ĐĐžĐŊи ĐŋŅиКĐŧĐ°ŅŅŅ `set` (ĐŧĐŊĐžĐļиĐŊŅ) ŅŅĐ´ĐēŅв (`str`) С ŅĐŧĐĩĐŊĐ°Đŧи Đ°ŅŅийŅŅŅв, ŅĐēŅ ĐŋĐžŅŅŅĐąĐŊĐž вĐēĐģŅŅиŅи (ĐŋŅĐžĐŋŅŅĐēĐ°ŅŅи ŅĐŊŅŅ) айО виĐēĐģŅŅиŅи (вĐēĐģŅŅĐ°ŅŅи ŅĐŊŅŅ).
+
+ĐĻĐĩ ĐŧĐžĐļĐŊĐ° виĐēĐžŅиŅŅОвŅваŅи ŅĐē ŅвидĐēиК ŅĐŋĐžŅŅĐą, ŅĐēŅĐž Ņ ĐĐ°Ņ Ņ ĐģиŅĐĩ ОдĐŊĐ° ĐŧОдĐĩĐģŅ Pydantic Ņ Đи Ņ
ĐžŅĐĩŅĐĩ видаĐģиŅи Đ´ĐĩŅĐēŅ Đ´Đ°ĐŊŅ С вивОдŅ.
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐĐģĐĩ вŅĐĩ Đļ ŅĐĩĐēĐžĐŧĐĩĐŊĐ´ŅŅŅŅŅŅ виĐēĐžŅиŅŅОвŅваŅи ĐžĐŋиŅĐ°ĐŊŅ виŅĐĩ ĐŋŅĐ´Ņ
Оди, ŅС СаŅŅĐžŅŅваĐŊĐŊŅĐŧ ĐēŅĐģŅĐēĐžŅ
ĐēĐģĐ°ŅŅв, СаĐŧŅŅŅŅ ŅиŅ
ĐŋĐ°ŅĐ°ĐŧĐĩŅŅŅв.
+
+
+ĐĻĐĩ ŅĐžĐŧŅ, ŅĐž JSON Schema, ŅĐēиК ĐŗĐĩĐŊĐĩŅŅŅŅŅŅŅ Ņ ваŅĐžĐŧŅ OpenAPI дОдаŅĐēŅ (Ņ в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ), вŅĐĩ ОдĐŊĐž ĐąŅĐ´Đĩ вŅĐ´ĐŋОвŅĐ´Đ°Ņи ĐŋОвĐŊŅĐš ĐŧОдĐĩĐģŅ, ĐŊавŅŅŅ ŅĐēŅĐž Đи виĐēĐžŅиŅŅОвŅŅŅĐĩ `response_model_include` айО `response_model_exclude` Đ´ĐģŅ виĐēĐģŅŅĐĩĐŊĐŊŅ Đ´ĐĩŅĐēиŅ
Đ°ŅŅийŅŅŅв.
+
+ĐĻĐĩ ŅĐ°ĐēĐžĐļ ŅŅĐžŅŅŅŅŅŅŅ `response_model_by_alias`, ŅĐēиК ĐŋŅĐ°ŅŅŅ ĐŋОдŅĐąĐŊиĐŧ ŅиĐŊĐžĐŧ.
+
+///
+
+{* ../../docs_src/response_model/tutorial005_py310.py hl[29,35] *}
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ХиĐŊŅĐ°ĐēŅиŅ `{"name", "description"}` ŅŅвОŅŅŅ `set` С ŅиĐŧи двОĐŧĐ° СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧи.
+
+ĐŅĐŊ ĐĩĐēвŅваĐģĐĩĐŊŅĐŊиК `set(["name", "description"])`.
+
+///
+
+#### ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ `list` СаĐŧŅŅŅŅ `set`
+
+Đ¯ĐēŅĐž Đи СайŅĐ´ĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи `set` Ņ ĐŊĐ°ŅĐžĐŧŅŅŅŅ СаŅŅĐžŅŅŅŅĐĩ `list` айО `tuple`, FastAPI вŅĐĩ ОдĐŊĐž ĐŋĐĩŅĐĩŅвОŅиŅŅ ŅĐĩ ĐŊĐ° `set`, Ņ вŅĐĩ ĐŋŅĐ°ŅŅваŅиĐŧĐĩ ĐŋŅавиĐģŅĐŊĐž:
+
+{* ../../docs_src/response_model/tutorial006_py310.py hl[29,35] *}
+
+## ĐŅĐ´ŅŅĐŧĐžĐē
+
+ĐиĐēĐžŅиŅŅОвŅĐšŅĐĩ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `response_model` *Đ´ĐĩĐēĐžŅĐ°ŅĐžŅĐ° ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*, ŅОй виСĐŊĐ°ŅĐ°Ņи ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ, ĐžŅОйĐģивО ŅОй ĐŗĐ°ŅĐ°ĐŊŅŅваŅи ŅŅĐģŅŅŅĐ°ŅŅŅ ĐŋŅиваŅĐŊиŅ
Đ´Đ°ĐŊиŅ
.
+
+ĐиĐēĐžŅиŅŅОвŅĐšŅĐĩ `response_model_exclude_unset`, ŅОй ĐŋОвĐĩŅŅĐ°Ņи ĐģиŅĐĩ ŅвĐŊĐž вŅŅĐ°ĐŊОвĐģĐĩĐŊŅ СĐŊĐ°ŅĐĩĐŊĐŊŅ.
diff --git a/docs/uk/docs/tutorial/response-status-code.md b/docs/uk/docs/tutorial/response-status-code.md
new file mode 100644
index 000000000..1ed69d6f2
--- /dev/null
+++ b/docs/uk/docs/tutorial/response-status-code.md
@@ -0,0 +1,100 @@
+# ĐĄŅĐ°ŅŅŅ ĐēОди ĐŅĐ´ĐŋОвŅĐ´ĐĩĐš
+
+ĐĸĐ°Đē ŅĐ°ĐŧĐž ŅĐē Đи ĐŧĐžĐļĐĩŅĐĩ вĐēаСаŅи ĐŧОдĐĩĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ, Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи HTTP ĐēОд ŅŅĐ°ŅŅŅŅ Đ´ĐģŅ вŅĐ´ĐŋОвŅĐ´Ņ Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `status_code` в ĐąŅĐ´Ņ-ŅĐēŅĐš С *ĐžĐŋĐĩŅĐ°ŅŅĐš ŅĐģŅŅ
Ņ*:
+
+* `@app.get()`
+* `@app.post()`
+* `@app.put()`
+* `@app.delete()`
+* ŅĐžŅĐž.
+
+{* ../../docs_src/response_status_code/tutorial001.py hl[6] *}
+
+/// note | ĐĐžŅĐ°ŅĐēĐ°
+
+ĐвĐĩŅĐŊŅŅŅ ŅваĐŗŅ, ŅĐž `status_code` Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐžĐŧ ĐŧĐĩŅОдŅ "Đ´ĐĩĐēĐžŅĐ°ŅĐžŅĐ°" (`get`, `post` Ņ Ņ.Đ´.), Đ° ĐŊĐĩ ĐĐ°ŅĐžŅ *ŅŅĐŊĐēŅŅŅ ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*, ŅĐē ŅŅŅ ŅĐŊŅŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи ŅĐ° ŅŅĐģĐž СаĐŋиŅŅ.
+
+///
+
+ĐĐ°ŅĐ°ĐŧĐĩŅŅ `status_code` ĐŋŅиКĐŧĐ°Ņ ŅиŅĐģĐž, ŅĐēĐĩ вŅĐ´ĐŋОвŅĐ´Đ°Ņ HTTP ĐēОдŅ ŅŅĐ°ŅŅŅŅ.
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+`status_code` ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩ ĐžŅŅиĐŧŅваŅи СĐŊĐ°ŅĐĩĐŊĐŊŅ С `IntEnum`, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, С Python `http.HTTPStatus`.
+
+///
+
+ĐŅĐŊ ĐąŅĐ´Đĩ:
+
+* ĐОвĐĩŅŅĐ°Ņи вĐēаСаĐŊиК ĐēОд ŅŅĐ°ŅŅŅŅ Ņ вŅĐ´ĐŋОвŅĐ´Ņ.
+* ĐĐžĐēŅĐŧĐĩĐŊŅŅваŅи КОĐŗĐž ŅĐē ŅĐ°ĐēиК Ņ ŅŅ
ĐĩĐŧŅ OpenAPI (Ņ, ŅĐ°ĐēиĐŧ ŅиĐŊĐžĐŧ, в ŅĐŊŅĐĩŅŅĐĩĐšŅŅ ĐēĐžŅиŅŅŅваŅĐ°):
+
+
+
+/// note | ĐĐžŅĐ°ŅĐēĐ°
+
+ĐĐĩŅĐēŅ ĐēОди вŅĐ´ĐŋОвŅĐ´Ņ (див. ĐŊĐ°ŅŅŅĐŋĐŊиК ŅОСдŅĐģ) вĐēаСŅŅŅŅ, ŅĐž вŅĐ´ĐŋОвŅĐ´Ņ ĐŊĐĩ ĐŧĐ°Ņ ŅŅĐģĐ°.
+
+FastAPI СĐŊĐ°Ņ ĐŋŅĐž ŅĐĩ Ņ ŅŅвОŅиŅŅ OpenAPI Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ŅĐēĐ° вĐēаСŅŅ, ŅĐž ŅŅĐģĐ° вŅĐ´ĐŋОвŅĐ´Ņ ĐŊĐĩĐŧĐ°Ņ.
+
+///
+
+## ĐŅĐž HTTP ŅŅĐ°ŅŅŅ ĐēОди
+
+/// note | ĐĐžŅĐ°ŅĐēĐ°
+
+Đ¯ĐēŅĐž Đи вĐļĐĩ СĐŊĐ°ŅŅĐĩ, ŅĐž ŅĐ°ĐēĐĩ HTTP ĐēОди ŅŅĐ°ŅŅŅŅ, ĐŋĐĩŅĐĩŅ
ОдŅŅĐĩ Đ´Đž ĐŊĐ°ŅŅŅĐŋĐŊĐžĐŗĐž ŅОСдŅĐģŅ.
+
+///
+
+Đ HTTP Đи ĐŊĐ°Đ´ŅиĐģĐ°ŅŅĐĩ ŅиŅĐģОвиК ĐēОд ŅŅĐ°ŅŅŅŅ С 3 ŅиŅŅ ŅĐē ŅĐ°ŅŅиĐŊŅ вŅĐ´ĐŋОвŅĐ´Ņ.
+
+ĐĻŅ ĐēОди ŅŅĐ°ŅŅŅŅ ĐŧĐ°ŅŅŅ ĐŋОвâŅСаĐŊŅ ĐŊаСвŅ Đ´ĐģŅ ŅŅ
ŅОСĐŋŅСĐŊаваĐŊĐŊŅ, Đ°ĐģĐĩ ĐŊаКваĐļĐģивŅŅĐžŅ ŅĐ°ŅŅиĐŊĐžŅ Ņ ŅĐ°ĐŧĐĩ ŅиŅĐģĐž.
+
+ĐĐžŅĐžŅĐēĐž:
+
+* **`100 - 199`** "ĐĐŊŅĐžŅĐŧĐ°ŅŅĐšĐŊŅ" вŅĐ´ĐŋОвŅĐ´Ņ. Đи ŅŅĐ´ĐēĐž виĐēĐžŅиŅŅОвŅŅŅĐĩ ŅŅ
ĐŊĐ°ĐŋŅŅĐŧŅ. ĐŅĐ´ĐŋОвŅĐ´Ņ С ŅĐ°ĐēиĐŧи ĐēОдаĐŧи ĐŊĐĩ ĐŧĐžĐļŅŅŅ ĐŧĐ°Ņи ŅŅĐģĐ°.
+* **`200 - 299`** "ĐŖŅĐŋŅŅĐŊŅ" вŅĐ´ĐŋОвŅĐ´Ņ. ĐĻĐĩ ŅŅ, ŅĐēŅ Đи виĐēĐžŅиŅŅОвŅваŅиĐŧĐĩŅĐĩ ĐŊĐ°ĐšŅĐ°ŅŅŅŅĐĩ.
+ * `200` - ĐēОд Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ, ŅĐēиК ОСĐŊĐ°ŅĐ°Ņ, ŅĐž вŅĐĩ ĐŋŅОКŅĐģĐž "OK".
+ * ĐĐŊŅиК ĐŋŅиĐēĐģĐ°Đ´ â `201`, "Created" (ŅŅвОŅĐĩĐŊĐž). ĐĐžĐŗĐž СаСвиŅĐ°Đš виĐēĐžŅиŅŅОвŅŅŅŅ ĐŋŅŅĐģŅ ŅŅвОŅĐĩĐŊĐŊŅ ĐŊОвОĐŗĐž СаĐŋиŅŅ в йаСŅ Đ´Đ°ĐŊиŅ
.
+ * ĐŅОйĐģивиК виĐŋĐ°Đ´ĐžĐē â `204`, "No Content" (ĐŊĐĩĐŧĐ°Ņ вĐŧŅŅŅŅ). ĐĻŅ вŅĐ´ĐŋОвŅĐ´Ņ виĐēĐžŅиŅŅОвŅŅŅŅŅŅ, ĐēĐžĐģи ĐŊĐĩĐŧĐ°Ņ Đ´Đ°ĐŊиŅ
Đ´ĐģŅ ĐŋОвĐĩŅĐŊĐĩĐŊĐŊŅ ĐēĐģŅŅĐŊŅŅ, ŅĐžĐŧŅ вŅĐ´ĐŋОвŅĐ´Ņ ĐŊĐĩ ĐŋОвиĐŊĐŊĐ° ĐŧĐ°Ņи ŅŅĐģĐ°.
+* **`300 - 399`** "ĐĐĩŅĐĩĐŊĐ°ĐŋŅавĐģĐĩĐŊĐŊŅ". ĐŅĐ´ĐŋОвŅĐ´Ņ С ŅиĐŧи ĐēОдаĐŧи ĐŧĐžĐļŅŅŅ ĐŧĐ°Ņи айО ĐŊĐĩ ĐŧĐ°Ņи ŅŅĐģĐ°, Са виĐŊŅŅĐēĐžĐŧ `304`, "Not Modified" (ĐŊĐĩ СĐŧŅĐŊĐĩĐŊĐž), ŅĐēĐ° ĐŊĐĩ ĐŋОвиĐŊĐŊĐ° ĐŧĐ°Ņи ŅŅĐģĐ°.
+* **`400 - 499`** "ĐĐžĐŧиĐģĐēĐ° ĐēĐģŅŅĐŊŅĐ°". ĐĻĐĩ Đ´ŅŅĐŗиК ŅиĐŋ, ŅĐēиК Đи, ĐšĐŧОвŅŅĐŊĐž, ĐąŅĐ´ĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи ĐŊĐ°ĐšŅĐ°ŅŅŅŅĐĩ.
+ * ĐŅиĐēĐģĐ°Đ´ `404`, "Not Found" (ĐŊĐĩ СĐŊаКдĐĩĐŊĐž).
+ * ĐĐģŅ СаĐŗĐ°ĐģŅĐŊиŅ
ĐŋĐžĐŧиĐģĐžĐē ĐēĐģŅŅĐŊŅĐ° ĐŧĐžĐļĐŊĐ° виĐēĐžŅиŅŅОвŅваŅи `400`.
+* `500 - 599` "ĐĐžĐŧиĐģĐēи ŅĐĩŅвĐĩŅĐ°". Đи ĐŧĐ°ĐšĐļĐĩ ĐŊŅĐēĐžĐģи ĐŊĐĩ виĐēĐžŅиŅŅОвŅŅŅĐĩ ŅŅ
ĐŊĐ°ĐŋŅŅĐŧŅ. Đ¯ĐēŅĐž в ĐēОдŅ ĐĐ°ŅĐžĐŗĐž СаŅŅĐžŅŅĐŊĐēŅ айО ĐŊĐ° ŅĐĩŅвĐĩŅŅ ŅĐžŅŅ ĐŋŅŅĐģĐž ĐŊĐĩ ŅĐ°Đē, авŅĐžĐŧĐ°ŅиŅĐŊĐž ĐąŅĐ´Đĩ ĐŋОвĐĩŅĐŊĐĩĐŊĐž ОдиĐŊ ŅС ŅиŅ
ĐēОдŅв ŅŅĐ°ŅŅŅŅ.
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ЊОй Đ´ŅСĐŊĐ°ŅиŅŅ ĐąŅĐģŅŅĐĩ ĐŋŅĐž ĐēĐžĐļĐĩĐŊ ĐēОд ŅŅĐ°ŅŅŅŅ Ņ ĐŋŅиСĐŊĐ°ŅĐĩĐŊĐŊŅ ĐēĐžĐļĐŊĐžĐŗĐž С ĐŊиŅ
, ĐŋĐĩŅĐĩĐŗĐģŅĐŊŅŅĐĩ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ MDN ĐŋŅĐž HTTP ĐēОди ŅŅĐ°ŅŅŅŅ.
+
+///
+
+## ĐĐĩĐŗĐēиК ŅĐŋĐžŅŅĐą СаĐŋĐ°Đŧ'ŅŅĐ°Ņи ĐŊаСви
+
+РОСĐŗĐģŅĐŊĐĩĐŧĐž ŅĐĩ ŅаС ĐŋĐžĐŋĐĩŅĐĩĐ´ĐŊŅĐš ĐŋŅиĐēĐģĐ°Đ´:
+
+{* ../../docs_src/response_status_code/tutorial001.py hl[6] *}
+
+`201` - ŅĐĩ ĐēОд ŅŅĐ°ŅŅŅŅ Đ´ĐģŅ "Created" (ŅŅвОŅĐĩĐŊĐž).
+
+ĐĐģĐĩ ĐĐ°Đŧ ĐŊĐĩ ĐŋĐžŅŅŅĐąĐŊĐž СаĐŋĐ°Đŧ'ŅŅОвŅваŅи, ŅĐž ОСĐŊĐ°ŅĐ°Ņ ĐēĐžĐļĐĩĐŊ ŅС ŅиŅ
ĐēОдŅв.
+
+Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи СŅŅŅĐŊŅ СĐŧŅĐŊĐŊŅ С `fastapi.status`
+
+{* ../../docs_src/response_status_code/tutorial002.py hl[1,6] *}
+
+ĐĻŅ СĐŧŅĐŊĐŊŅ ĐŋŅĐžŅŅĐž Đ´ĐģŅ СŅŅŅĐŊĐžŅŅŅ. ĐĐžĐŊи ĐŧŅŅŅŅŅŅ ŅŅ Đļ ŅĐ°ĐŧŅ ŅиŅĐģĐ°, Đ°ĐģĐĩ Đи ĐŧĐžĐļĐĩŅĐĩ ŅĐēĐžŅиŅŅĐ°ŅиŅŅ авŅОСаĐŋОвĐŊĐĩĐŊĐŊŅĐŧ в ŅĐĩĐ´Đ°ĐēŅĐžŅŅ:
+
+
+
+/// note | ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи `from starlette import status`.
+
+**FastAPI** ĐŊĐ°Đ´Đ°Ņ ŅŅ Đļ ŅĐ°ĐŧŅ СĐŧŅĐŊĐŊŅ `starlette.status` ŅĐē `fastapi.status`, ĐŋŅĐžŅŅĐž Đ´ĐģŅ СŅŅŅĐŊĐžŅŅŅ ŅОСŅОйĐŊиĐēĐ°. ĐĐ´ĐŊĐ°Đē вОĐŊи ĐŋĐžŅ
ОдŅŅŅ ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž СŅ Starlette.
+
+///
+
+## ĐĐŧŅĐŊĐ° СĐŊĐ°ŅĐĩĐŊĐŊŅ Са СаĐŧОвŅŅваĐŊĐŊŅĐŧ
+
+ĐĐ°ĐģŅ, Ņ ĐĐžŅŅĐąĐŊиĐēŅ Đ´ĐģŅ Đ´ĐžŅвŅĐ´ŅĐĩĐŊиŅ
ĐēĐžŅиŅŅŅваŅŅв{.internal-link target=_blank}, Đи Đ´ŅСĐŊĐ°ŅŅĐĩŅŅ, ŅĐē ĐŋОвĐĩŅĐŊŅŅи ŅĐŊŅиК ĐēОд ŅŅĐ°ŅŅŅŅ, ĐŊŅĐļ ŅОК, ŅĐēиК Đи ĐžĐŗĐžĐģĐžŅиĐģи ŅŅŅ.
diff --git a/docs/uk/docs/tutorial/schema-extra-example.md b/docs/uk/docs/tutorial/schema-extra-example.md
new file mode 100644
index 000000000..853fd5e65
--- /dev/null
+++ b/docs/uk/docs/tutorial/schema-extra-example.md
@@ -0,0 +1,222 @@
+# ĐĐĩĐēĐģĐ°ŅŅваĐŊĐŊŅ ĐŋŅиĐēĐģĐ°Đ´Ņв вŅ
ŅĐ´ĐŊиŅ
Đ´Đ°ĐŊиŅ
+
+Đи ĐŧĐžĐļĐĩŅĐĩ СадаŅи ĐŋŅиĐēĐģади Đ´Đ°ĐŊиŅ
, ŅĐēŅ ĐĐ°Ņ СаŅŅĐžŅŅĐŊĐžĐē ĐŧĐžĐļĐĩ ĐžŅŅиĐŧŅваŅи.
+
+ĐŅŅ ĐēŅĐģŅĐēĐ° ŅĐŋĐžŅОйŅв, ŅĐē ŅĐĩ СŅОйиŅи.
+
+## ĐОдаŅĐēОвŅ Đ´Đ°ĐŊŅ JSON-ŅŅ
ĐĩĐŧи в ĐŧОдĐĩĐģŅŅ
Pydantic
+
+Đи ĐŧĐžĐļĐĩŅĐĩ СадаŅи `examples` Đ´ĐģŅ ĐŧОдĐĩĐģŅ Pydantic, ŅĐēŅ ĐąŅĐ´Đĩ дОдаĐŊĐž Đ´Đž СĐŗĐĩĐŊĐĩŅОваĐŊĐžŅ JSON-ŅŅ
ĐĩĐŧи.
+
+//// tab | Pydantic v2
+
+{* ../../docs_src/schema_extra_example/tutorial001_py310.py hl[13:24] *}
+
+////
+
+//// tab | Pydantic v1
+
+{* ../../docs_src/schema_extra_example/tutorial001_pv1_py310.py hl[13:23] *}
+
+////
+
+ĐĻŅ дОдаŅĐēОва ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ ĐąŅĐ´Đĩ дОдаĐŊĐ° ŅĐē Ņ Đ´Đž **JSON-ŅŅ
ĐĩĐŧи**, Ņ вОĐŊĐ° ĐąŅĐ´Đĩ виĐēĐžŅиŅŅОвŅваŅиŅŅ в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Đ´Đž API.
+
+//// tab | Pydantic v2
+
+ĐŖ вĐĩŅŅŅŅ Pydantic 2 виĐēĐžŅиŅŅОвŅŅŅŅŅŅ Đ°ŅŅийŅŅ `model_config`, ŅĐēиК ĐŋŅиКĐŧĐ°Ņ `dict`, ŅĐē ĐžĐŋиŅĐ°ĐŊĐž в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Pydantic: ĐĐžĐŊŅŅĐŗŅŅĐ°ŅŅŅ.
+
+Đи ĐŧĐžĐļĐĩŅĐĩ вŅŅĐ°ĐŊОвиŅи `"json_schema_extra"` ŅĐē `dict`, ŅĐž ĐŧŅŅŅиŅŅ ĐąŅĐ´Ņ-ŅĐēŅ дОдаŅĐēОвŅ Đ´Đ°ĐŊŅ, ŅĐēŅ Đи Ņ
ĐžŅĐĩŅĐĩ вŅдОйŅаСиŅи Ņ СĐŗĐĩĐŊĐĩŅОваĐŊŅĐš JSON-ŅŅ
ĐĩĐŧŅ, вĐēĐģŅŅĐ°ŅŅи `examples`.
+
+////
+
+//// tab | Pydantic v1
+
+ĐŖ вĐĩŅŅŅŅ Pydantic 1 виĐēĐžŅиŅŅОвŅŅŅŅŅŅ вĐŊŅŅŅŅŅĐŊŅĐš ĐēĐģĐ°Ņ `Config` Ņ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `schema_extra`, ŅĐē ĐžĐŋиŅĐ°ĐŊĐž в Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Pydantic: ĐĐ°ĐģĐ°ŅŅŅваĐŊĐŊŅ ŅŅ
ĐĩĐŧи.
+
+Đи ĐŧĐžĐļĐĩŅĐĩ СадаŅи `schema_extra` ŅĐē `dict`, ŅĐž ĐŧŅŅŅиŅŅ ĐąŅĐ´Ņ-ŅĐēŅ дОдаŅĐēОвŅ Đ´Đ°ĐŊŅ, ŅĐēŅ Đи Ņ
ĐžŅĐĩŅĐĩ йаŅиŅи Ņ СĐŗĐĩĐŊĐĩŅОваĐŊŅĐš JSON-ŅŅ
ĐĩĐŧŅ, вĐēĐģŅŅĐ°ŅŅи `examples`.
+
+////
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи ŅŅ Đļ ŅĐĩŅ
ĐŊŅĐēŅ, ŅОй ŅОСŅиŅиŅи JSON-ŅŅ
ĐĩĐŧŅ Ņ дОдаŅи вĐģĐ°ŅĐŊŅ дОдаŅĐēОвŅ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅĐ°Ņи ŅŅ Đ´ĐģŅ дОдаваĐŊĐŊŅ ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
Đ´ĐģŅ ŅĐŊŅĐĩŅŅĐĩĐšŅŅ ĐēĐžŅиŅŅŅваŅĐ° ĐŊĐ° ŅŅĐžĐŊŅĐĩĐŊĐ´Ņ ŅĐžŅĐž.
+
+///
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+OpenAPI 3.1.0 (ŅĐēиК виĐēĐžŅиŅŅОвŅŅŅŅŅŅ ĐŋĐžŅиĐŊĐ°ŅŅи С FastAPI 0.99.0) дОдав ĐŋŅĐ´ŅŅиĐŧĐēŅ `examples`, ŅĐž Ņ ŅĐ°ŅŅиĐŊĐžŅ ŅŅĐ°ĐŊĐ´Đ°ŅŅŅ **JSON-ŅŅ
ĐĩĐŧи**.
+
+ĐĐž ŅŅĐžĐŗĐž ĐŋŅĐ´ŅŅиĐŧŅвавŅŅ ĐģиŅĐĩ ĐēĐģŅŅ `example` С ОдĐŊиĐŧ ĐŋŅиĐēĐģĐ°Đ´ĐžĐŧ. ĐŅĐŊ вŅĐĩ ŅĐĩ ĐŋŅĐ´ŅŅиĐŧŅŅŅŅŅŅ в OpenAPI 3.1.0, Đ°ĐģĐĩ Ņ СаŅŅĐ°ŅŅĐģиĐŧ Ņ ĐŊĐĩ вŅ
ОдиŅŅ Đ´Đž ŅŅĐ°ĐŊĐ´Đ°ŅŅŅ JSON Schema. ĐĸĐžĐŧŅ ŅĐĩĐēĐžĐŧĐĩĐŊĐ´ŅŅŅŅŅŅ ĐŋĐĩŅĐĩĐšŅи С `example` ĐŊĐ° `examples`. đ¤
+
+ĐŅĐģŅŅĐĩ ĐŋŅĐž ŅĐĩ ĐŧĐžĐļĐŊĐ° ĐŋŅĐžŅиŅĐ°Ņи в ĐēŅĐŊŅŅ ŅŅŅŅ ŅŅĐžŅŅĐŊĐēи.
+
+///
+
+## ĐОдаŅĐēОвŅ Đ°ŅĐŗŅĐŧĐĩĐŊŅи `Field`
+
+ĐĐžĐģи ви виĐēĐžŅиŅŅОвŅŅŅĐĩ `Field()` Ņ ĐŧОдĐĩĐģŅŅ
Pydantic, Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ вĐēаСаŅи дОдаŅĐēОвŅ `examples`:
+
+{* ../../docs_src/schema_extra_example/tutorial002_py310.py hl[2,8:11] *}
+
+## `examples` Ņ JSON-ŅŅ
ĐĩĐŧŅ â OpenAPI
+
+ĐŅи виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ĐąŅĐ´Ņ-ĐēĐžĐŗĐž С ĐŊĐ°ŅŅŅĐŋĐŊĐžĐŗĐž:
+
+* `Path()`
+* `Query()`
+* `Header()`
+* `Cookie()`
+* `Body()`
+* `Form()`
+* `File()`
+
+Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ СадаŅи ĐŊĐ°ĐąŅŅ `examples` С дОдаŅĐēОвОŅ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅŅ, ŅĐēĐ° ĐąŅĐ´Đĩ дОдаĐŊĐ° Đ´Đž ŅŅ
ĐŊŅŅ
**JSON-ŅŅ
ĐĩĐŧ** Ņ **OpenAPI**.
+
+### `Body` С `examples`
+
+ĐĸŅŅ Đŧи ĐŋĐĩŅĐĩĐ´Đ°ŅĐŧĐž `examples`, ŅĐēŅ ĐŧŅŅŅŅŅŅ ОдиĐŊ ĐŋŅиĐēĐģĐ°Đ´ ĐžŅŅĐēŅваĐŊиŅ
Đ´Đ°ĐŊиŅ
Ņ `Body()`:
+
+{* ../../docs_src/schema_extra_example/tutorial003_an_py310.py hl[22:29] *}
+
+### ĐŅиĐēĐģĐ°Đ´ Ņ UI Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ
+
+ĐĐ° Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐąŅĐ´Ņ-ŅĐēĐžĐŗĐž С ĐŊавĐĩĐ´ĐĩĐŊиŅ
виŅĐĩ ĐŧĐĩŅОдŅв ŅĐĩ виĐŗĐģŅĐ´Đ°ŅиĐŧĐĩ ŅĐ°Đē Ņ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ Са `/docs`:
+
+
+
+### `Body` С ĐēŅĐģŅĐēĐžĐŧĐ° `examples`
+
+ĐвиŅĐ°ĐšĐŊĐž, Đи ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐĩŅĐĩ ĐŋĐĩŅĐĩĐ´Đ°Ņи ĐēŅĐģŅĐēĐ° `examples`:
+
+{* ../../docs_src/schema_extra_example/tutorial004_an_py310.py hl[23:38] *}
+
+ĐĐžĐģи Đи ŅĐĩ ŅОйиŅĐĩ, ĐŋŅиĐēĐģади ĐąŅĐ´ŅŅŅ ŅĐ°ŅŅиĐŊĐžŅ вĐŊŅŅŅŅŅĐŊŅĐžŅ **JSON-ŅŅ
ĐĩĐŧи** Đ´ĐģŅ ŅиŅ
Đ´Đ°ĐŊиŅ
.
+
+ĐŅŅĐŧ, ĐŊĐ° ĐŧĐžĐŧĐĩĐŊŅ ĐŊĐ°ĐŋиŅĐ°ĐŊĐŊŅ ŅŅĐžĐŗĐž (26 ŅĐĩŅĐŋĐŊŅ 2023), Swagger UI â ŅĐŊŅŅŅŅĐŧĐĩĐŊŅ, ŅĐēиК вŅĐ´ĐŋОвŅĐ´Đ°Ņ Са вŅдОйŅĐ°ĐļĐĩĐŊĐŊŅ UI Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ â ĐŊĐĩ ĐŋŅĐ´ŅŅиĐŧŅŅ ĐŋĐžĐēаС ĐēŅĐģŅĐēĐžŅ
ĐŋŅиĐēĐģĐ°Đ´Ņв Ņ **JSON-ŅŅ
ĐĩĐŧи**. ĐĐģĐĩ ĐŊиĐļŅĐĩ ĐŧĐžĐļĐŊĐ° ĐŋŅĐžŅиŅĐ°Ņи ĐŋŅĐž ОйŅ
ŅĐ´ĐŊиК ŅĐģŅŅ
.
+
+### ĐĄĐŋĐĩŅиŅŅŅĐŊŅ Đ´ĐģŅ OpenAPI `examples`
+
+ĐŠĐĩ Đ´Đž ŅĐžĐŗĐž, ŅĐē **JSON-ŅŅ
ĐĩĐŧĐ°** ĐŋĐžŅĐ°ĐģĐ° ĐŋŅĐ´ŅŅиĐŧŅваŅи `examples`, OpenAPI вĐļĐĩ ĐŧĐ°ĐģĐ° ĐŋŅĐ´ŅŅиĐŧĐēŅ ĐŋĐžĐģŅ С ŅĐ°ĐēĐžŅ Đļ ĐŊаСвОŅ â `examples`.
+
+ĐĻĐĩ **ŅĐŋĐĩŅиŅŅŅĐŊĐĩ Đ´ĐģŅ OpenAPI** ĐŋĐžĐģĐĩ `examples` ŅОСĐŧŅŅŅŅŅŅŅŅ в ŅĐŊŅŅĐš ŅĐ°ŅŅиĐŊŅ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ OpenAPI â Ņ **Đ´ĐĩŅĐ°ĐģŅŅ
ĐēĐžĐļĐŊĐžŅ *ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ***, Đ° ĐŊĐĩ вŅĐĩŅĐĩдиĐŊŅ ŅĐ°ĐŧĐžŅ JSON-ŅŅ
ĐĩĐŧи.
+
+Swagger UI вĐļĐĩ давĐŊĐž ĐŋŅĐ´ŅŅиĐŧŅŅ ŅĐĩ ĐŋĐžĐģĐĩ `examples`. ĐĸĐžĐŧŅ Đи ĐŧĐžĐļĐĩŅĐĩ виĐēĐžŅиŅŅОвŅваŅи КОĐŗĐž, ŅОй **вŅдОйŅĐ°ĐļĐ°Ņи** ĐēŅĐģŅĐēĐ° **ĐŋŅиĐēĐģĐ°Đ´Ņв Ņ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ**.
+
+ĐĻĐĩ ĐŋĐžĐģĐĩ `examples` Ņ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ OpenAPI â ŅĐĩ `dict` (ŅĐģОвĐŊиĐē) С **ĐēŅĐģŅĐēĐžĐŧĐ° ĐŋŅиĐēĐģĐ°Đ´Đ°Đŧи** (Đ° ĐŊĐĩ ŅĐŋиŅĐžĐē `list`), ĐēĐžĐļĐĩĐŊ ŅС ŅĐēиŅ
ĐŧĐžĐļĐĩ ĐŧŅŅŅиŅи дОдаŅĐēОвŅ ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ, ŅĐž ĐąŅĐ´Đĩ дОдаĐŊĐ° Đ´Đž **OpenAPI**.
+
+ĐĐžĐŊĐž ĐŊĐĩ вĐēĐģŅŅĐ°ŅŅŅŅŅ Đ´Đž JSON Schema ĐēĐžĐļĐŊĐžĐŗĐž ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ°, Đ° ŅОСĐŧŅŅŅŅŅŅŅŅ СОвĐŊŅ, ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž в *ĐžĐŋĐĩŅĐ°ŅŅŅ ŅĐģŅŅ
Ņ*.
+
+### ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `openapi_examples`
+
+Đи ĐŧĐžĐļĐĩŅĐĩ ĐžĐŗĐžĐģĐžŅиŅи ŅĐŋĐĩŅиŅŅŅĐŊŅ Đ´ĐģŅ OpenAPI `examples` Ņ FastAPI Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐ° `openapi_examples` Đ´ĐģŅ:
+
+* `Path()`
+* `Query()`
+* `Header()`
+* `Cookie()`
+* `Body()`
+* `Form()`
+* `File()`
+
+ĐĐģŅŅŅ ŅĐģОвĐŊиĐēĐ° (`dict`) ŅĐ´ĐĩĐŊŅиŅŅĐēŅŅŅŅ ĐēĐžĐļĐĩĐŊ ĐŋŅиĐēĐģĐ°Đ´, Đ° ĐēĐžĐļĐŊĐĩ СĐŊĐ°ŅĐĩĐŊĐŊŅ `dict` â ĐēĐžĐļĐĩĐŊ ŅĐŋĐĩŅиŅŅŅĐŊиК ŅĐģОвĐŊиĐē `dict` в `examples` ĐŧĐžĐļĐĩ ĐŧŅŅŅиŅи:
+
+* `summary`: ĐēĐžŅĐžŅĐēиК ĐžĐŋиŅ ĐŋŅиĐēĐģĐ°Đ´Ņ.
+* `description`: ŅОСĐŗĐžŅĐŊŅŅиК ĐžĐŋиŅ (ĐŧĐžĐļĐĩ ĐŧŅŅŅиŅи Markdown).
+* `value`: ŅĐ°Đŧ ĐŋŅиĐēĐģĐ°Đ´, ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, ŅĐģОвĐŊиĐē (`dict`).
+* `externalValue`: Đ°ĐģŅŅĐĩŅĐŊĐ°Ņива `value`, URL-Đ°Đ´ŅĐĩŅĐ°, ŅĐž вĐēаСŅŅ ĐŊĐ° ĐŋŅиĐēĐģĐ°Đ´. ĐŅĐžŅĐĩ ŅŅ ĐžĐŋŅŅŅ ĐŧĐžĐļĐĩ ĐŊĐĩ ĐŋŅĐ´ŅŅиĐŧŅваŅиŅŅ ĐąŅĐģŅŅŅŅŅŅ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв, ĐŊĐ° вŅĐ´ĐŧŅĐŊŅ вŅĐ´ `value`.
+
+ĐиĐēĐžŅиŅŅĐ°ĐŊĐŊŅ виĐŗĐģŅĐ´Đ°Ņ ŅĐ°Đē:
+
+{* ../../docs_src/schema_extra_example/tutorial005_an_py310.py hl[23:49] *}
+
+### ĐŅиĐēĐģади OpenAPI Ņ UI Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ
+
+Đ ĐŋĐ°ŅĐ°ĐŧĐĩŅŅĐžĐŧ `openapi_examples`, дОдаĐŊиĐŧ Đ´Đž `Body()`, Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ `/docs` виĐŗĐģŅĐ´Đ°ŅиĐŧĐĩ ŅĐ°Đē:
+
+
+
+## ĐĸĐĩŅ
ĐŊŅŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ
+
+/// tip | ĐŅĐ´ĐēаСĐēĐ°
+
+Đ¯ĐēŅĐž Đи вĐļĐĩ виĐēĐžŅиŅŅОвŅŅŅĐĩ **FastAPI** вĐĩŅŅŅŅ **0.99.0 айО виŅĐĩ**, Đи ĐŧĐžĐļĐĩŅĐĩ **ĐŋŅĐžĐŋŅŅŅиŅи** ŅĐĩĐš ŅОСдŅĐģ.
+
+ĐŅĐŊ ĐąŅĐģŅŅ Đ°ĐēŅŅĐ°ĐģŅĐŊиК Đ´ĐģŅ ŅŅĐ°ŅиŅ
вĐĩŅŅŅĐš, Đ´Đž ĐŋĐžŅви OpenAPI 3.1.0.
+
+ĐĐžĐļĐŊĐ° вваĐļĐ°Ņи ŅĐĩ ĐēĐžŅĐžŅĐēиĐŧ **ŅŅŅĐžŅиŅĐŊиĐŧ ĐĩĐēŅĐēŅŅŅĐžĐŧ** Ņ OpenAPI ŅĐ° JSON Schema. đ¤
+
+///
+
+/// warning | ĐĐžĐŋĐĩŅĐĩĐ´ĐļĐĩĐŊĐŊŅ
+
+ĐĻĐĩ Đ´ŅĐļĐĩ ŅĐĩŅ
ĐŊŅŅĐŊĐ° ŅĐŊŅĐžŅĐŧĐ°ŅŅŅ ĐŋŅĐž ŅŅĐ°ĐŊĐ´Đ°ŅŅи **JSON Schema** Ņ **OpenAPI**.
+
+Đ¯ĐēŅĐž виŅĐĩСĐŗĐ°Đ´Đ°ĐŊŅ ŅĐ´ĐĩŅ вĐļĐĩ ĐŋŅĐ°ŅŅŅŅŅ Ņ ĐĐ°Ņ â ĐŧĐžĐļĐĩŅĐĩ ĐŊĐĩ СаĐŗĐģийĐģŅваŅиŅŅ в ŅŅ Đ´ĐĩŅĐ°ĐģŅ.
+
+///
+
+ĐĐž OpenAPI 3.1.0 ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ виĐēĐžŅиŅŅОвŅваĐģĐ° ŅŅĐ°ŅŅ ŅĐ° ĐŧОдиŅŅĐēОваĐŊŅ вĐĩŅŅŅŅ **JSON Schema**.
+
+ĐŅĐēŅĐģŅĐēи JSON Schema ŅĐ°ĐŊŅŅĐĩ ĐŊĐĩ ĐŋŅĐ´ŅŅиĐŧŅваĐģĐ° `examples`, OpenAPI дОдаĐģĐ° вĐģĐ°ŅĐŊĐĩ ĐŋĐžĐģĐĩ `examples`.
+
+OpenAPI ŅĐ°ĐēĐžĐļ дОдаĐģĐ° `example` Ņ `examples` Đ´Đž ŅĐŊŅиŅ
ŅĐ°ŅŅиĐŊ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ:
+
+* `Parameter Object` (в ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ) виĐēĐžŅиŅŅОвŅŅŅŅŅŅ FastAPI Đ´ĐģŅ:
+ * `Path()`
+ * `Query()`
+ * `Header()`
+ * `Cookie()`
+* `Request Body Object`, в ĐŋĐžĐģŅ `content`, в `Media Type Object` (в ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ) виĐēĐžŅиŅŅОвŅŅŅŅŅŅ FastAPI Đ´ĐģŅ:
+ * `Body()`
+ * `File()`
+ * `Form()`
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐĻĐĩĐš ŅŅĐ°ŅиК ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `examples`, ŅĐŋĐĩŅиŅŅŅĐŊиК Đ´ĐģŅ OpenAPI, ŅĐĩĐŋĐĩŅ ĐŊаСиваŅŅŅŅŅ `openapi_examples`, ĐŋĐžŅиĐŊĐ°ŅŅи С FastAPI вĐĩŅŅŅŅ `0.103.0`.
+
+///
+
+### ĐĐžĐģĐĩ `examples` Ņ JSON Schema
+
+ĐŅСĐŊŅŅĐĩ JSON Schema дОдаĐģĐ° ĐŋĐžĐģĐĩ `examples` Ņ ĐŊОвŅ вĐĩŅŅŅŅ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ.
+
+РвĐļĐĩ OpenAPI 3.1.0 йаСŅŅŅŅŅŅ ĐŊĐ° ŅŅĐš ĐŊОвŅĐš вĐĩŅŅŅŅ (JSON Schema 2020-12), ŅĐēĐ° вĐēĐģŅŅĐ°Ņ ĐŋĐžĐģĐĩ `examples`.
+
+ĐĸĐĩĐŋĐĩŅ ŅĐĩ ĐŋĐžĐģĐĩ `examples` Ņ ĐŋŅŅĐžŅиŅĐĩŅĐŊиĐŧ Ņ СаĐŧŅĐŊŅŅ ŅŅĐ°ŅĐĩ (Ņ ĐēĐ°ŅŅĐžĐŧĐŊĐĩ) ĐŋĐžĐģĐĩ `example`, ŅĐēĐĩ ŅŅĐ°ĐģĐž СаŅŅĐ°ŅŅĐģиĐŧ.
+
+ĐОвĐĩ ĐŋĐžĐģĐĩ `examples` Ņ JSON Schema â ŅĐĩ **ĐŋŅĐžŅŅĐž ŅĐŋиŅĐžĐē (`list`)** ĐŋŅиĐēĐģĐ°Đ´Ņв, ĐąĐĩС дОдаŅĐēОвиŅ
ĐŧĐĩŅĐ°Đ´Đ°ĐŊиŅ
(ĐŊĐ° вŅĐ´ĐŧŅĐŊŅ вŅĐ´ OpenAPI).
+
+/// info | ĐĐŊŅĐžŅĐŧĐ°ŅŅŅ
+
+ĐавŅŅŅ ĐŋŅŅĐģŅ ŅĐžĐŗĐž, ŅĐē С'ŅвивŅŅ OpenAPI 3.1.0, ŅĐēиК ĐŋŅĐ´ŅŅиĐŧŅвав examples Ņ JSON Schema, ŅĐŊŅŅŅŅĐŧĐĩĐŊŅ Swagger UI ŅĐĩ Đ´ĐĩŅĐēиК ŅĐ°Ņ ĐŊĐĩ ĐŋŅĐ´ŅŅиĐŧŅвав ŅŅ вĐĩŅŅŅŅ (ĐŋŅĐ´ŅŅиĐŧĐēĐ° СâŅвиĐģĐ°ŅŅ С вĐĩŅŅŅŅ 5.0.0 đ).
+
+ЧĐĩŅĐĩС ŅĐĩ вĐĩŅŅŅŅ FastAPI Đ´Đž 0.99.0 вŅĐĩ ŅĐĩ виĐēĐžŅиŅŅОвŅваĐģи вĐĩŅŅŅŅ OpenAPI ĐŊиĐļŅŅ Са 3.1.0.
+
+///
+
+### `Examples` в Pydantic Ņ FastAPI
+
+ĐĐžĐģи Đи дОдаŅŅĐĩ `examples` Ņ ĐŧОдĐĩĐģŅ Pydantic ŅĐĩŅĐĩС `schema_extra` айО `Field(examples=["something"])`, ŅŅ ĐŋŅиĐēĐģади дОдаŅŅŅŅŅ Đ´Đž **JSON Schema** ŅŅŅŅ ĐŧОдĐĩĐģŅ.
+
+Đ ŅŅ **JSON Schema** Pydantic-ĐŧОдĐĩĐģŅ вĐēĐģŅŅĐ°ŅŅŅŅŅ Đ´Đž **OpenAPI** ĐĐ°ŅĐžĐŗĐž API, Đ° ĐŋĐžŅŅĐŧ виĐēĐžŅиŅŅОвŅŅŅŅŅŅ в UI Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ (docs UI).
+
+ĐŖ вĐĩŅŅŅŅŅ
FastAPI Đ´Đž 0.99.0 (ĐŋĐžŅиĐŊĐ°ŅŅи С 0.99.0 виĐēĐžŅиŅŅОвŅŅŅŅŅŅ ĐŊОвŅŅиК OpenAPI 3.1.0), ĐēĐžĐģи Đи виĐēĐžŅиŅŅОвŅваĐģи `example` айО `examples` С ŅĐŊŅиĐŧи ŅŅиĐģŅŅĐ°Đŧи (`Query()`, `Body()` ŅĐžŅĐž), ŅŅ ĐŋŅиĐēĐģади ĐŊĐĩ дОдаваĐģиŅŅ Đ´Đž JSON Schema, ŅĐēиК ĐžĐŋиŅŅŅ ŅŅ Đ´Đ°ĐŊŅ (ĐŊавŅŅŅ ĐŊĐĩ Đ´Đž вĐģĐ°ŅĐŊĐžŅ вĐĩŅŅŅŅ JSON Schema Ņ OpenAPI). ĐĐ°ŅĐžĐŧŅŅŅŅ вОĐŊи дОдаваĐģиŅŅ ĐąĐĩСĐŋĐžŅĐĩŅĐĩĐ´ĐŊŅĐž Đ´Đž ĐžĐŋиŅŅ *ОйŅОйĐŊиĐēĐ° ŅĐģŅŅ
Ņ* *(path operation)* в OpenAPI (ŅОйŅĐž ĐŋОСа ĐŧĐĩĐļĐ°Đŧи ŅĐ°ŅŅиĐŊ, ŅĐēŅ виĐēĐžŅиŅŅОвŅŅŅŅ JSON Schema).
+
+ĐĐģĐĩ ŅĐĩĐŋĐĩŅ, ĐēĐžĐģи FastAPI 0.99.0 Ņ виŅĐĩ виĐēĐžŅиŅŅОвŅŅŅŅ OpenAPI 3.1.0, Đ° ŅОК â JSON Schema 2020-12, ŅаСОĐŧ ŅС Swagger UI 5.0.0 Ņ виŅĐĩ â вŅĐĩ ŅŅĐ°ĐģĐž ĐąŅĐģŅŅ ŅСĐŗОдĐļĐĩĐŊиĐŧ, Ņ examples ŅĐĩĐŋĐĩŅ вĐēĐģŅŅĐ°ŅŅŅŅŅ Đ´Đž JSON Schema.
+
+### Swagger UI ŅĐ° ŅĐŋĐĩŅиŅŅŅĐŊŅ Đ´ĐģŅ OpenAPI `examples`
+
+Đ Đ°ĐŊŅŅĐĩ (ŅŅĐ°ĐŊĐžĐŧ ĐŊĐ° 26 ŅĐĩŅĐŋĐŊŅ 2023 ŅĐžĐēŅ) Swagger UI ĐŊĐĩ ĐŋŅĐ´ŅŅиĐŧŅвав ĐēŅĐģŅĐēĐ° ĐŋŅиĐēĐģĐ°Đ´Ņв Ņ JSON Schema, ŅĐžĐŧŅ ĐēĐžŅиŅŅŅваŅŅ ĐŊĐĩ ĐŧĐ°Đģи ĐŧĐžĐļĐģивОŅŅŅ ĐŋĐžĐēаСаŅи Đ´ĐĩĐēŅĐģŅĐēĐ° ĐŋŅиĐēĐģĐ°Đ´Ņв Ņ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ.
+
+ЊОй виŅŅŅиŅи ŅĐĩ, FastAPI ĐŋĐžŅиĐŊĐ°ŅŅи С вĐĩŅŅŅŅ 0.103.0 **дОдав ĐŋŅĐ´ŅŅиĐŧĐēŅ** ŅŅĐ°ŅĐžĐŗĐž **OpenAPI-ŅĐŋĐĩŅиŅŅŅĐŊĐžĐŗĐž** ĐŋĐžĐģŅ `examples` ŅĐĩŅĐĩС ĐŊОвиК ĐŋĐ°ŅĐ°ĐŧĐĩŅŅ `openapi_examples`. đ¤
+
+### ĐŅĐ´ŅŅĐŧĐžĐē
+
+Đ Đ°ĐŊŅŅĐĩ Ņ ĐēаСав, ŅĐž ĐŊĐĩ ĐģŅĐąĐģŅ ŅŅŅĐžŅŅŅ... Đ° ŅĐĩĐŋĐĩŅ ĐžŅŅ Ņ â ŅОСĐŋОвŅĐ´Đ°Ņ "ŅĐĩŅ
ĐŊŅŅĐŊŅ ŅŅŅĐžŅиŅĐŊŅ" ĐģĐĩĐēŅŅŅ. đ
+
+ĐĐžŅĐžŅĐēĐž: **ĐžĐŊОвŅŅŅŅŅ Đ´Đž FastAPI 0.99.0 айО виŅĐĩ** â Ņ вŅĐĩ ŅŅĐ°ĐŊĐĩ СĐŊĐ°ŅĐŊĐž **ĐŋŅĐžŅŅŅŅиĐŧ, ŅСĐŗОдĐļĐĩĐŊиĐŧ ŅĐ° ŅĐŊŅŅŅŅивĐŊĐž СŅОСŅĐŧŅĐģиĐŧ**, Ņ ĐĐ°Đŧ ĐŊĐĩ дОвĐĩĐ´ĐĩŅŅŅŅ СĐŊĐ°Ņи вŅŅ ŅŅ ŅŅŅĐžŅиŅĐŊŅ Đ´ĐĩŅĐ°ĐģŅ. đ
diff --git a/docs/uk/docs/tutorial/security/index.md b/docs/uk/docs/tutorial/security/index.md
new file mode 100644
index 000000000..c3d94be8d
--- /dev/null
+++ b/docs/uk/docs/tutorial/security/index.md
@@ -0,0 +1,104 @@
+# ĐĐĩСĐŋĐĩĐēĐ°
+
+ĐŅĐŊŅŅ йаĐŗĐ°ŅĐž ŅĐŋĐžŅОйŅв ŅĐĩĐ°ĐģŅСŅваŅи ĐąĐĩСĐŋĐĩĐēŅ, авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ ŅĐ° авŅĐžŅиСаŅŅŅ.
+
+ĐĻĐĩ СаСвиŅĐ°Đš ŅĐēĐģĐ°Đ´ĐŊĐ° Ņ "ĐŊĐĩĐŋŅĐžŅŅĐ°" ŅĐĩĐŧĐ°.
+
+ĐŖ йаĐŗĐ°ŅŅĐžŅ
ŅŅĐĩĐšĐŧвОŅĐēĐ°Ņ
Ņ ŅиŅŅĐĩĐŧĐ°Ņ
СайĐĩСĐŋĐĩŅĐĩĐŊĐŊŅ ĐąĐĩСĐŋĐĩĐēи ŅĐ° авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ СаКĐŧĐ°Ņ вĐĩĐģиŅĐĩСĐŊŅ ŅĐ°ŅŅиĐŊŅ СŅŅиĐģŅ Ņ ĐēОдŅ (ŅĐŊОдŅ â ĐŋĐžĐŊĐ°Đ´ 50% вŅŅĐžĐŗĐž ĐŊĐ°ĐŋиŅĐ°ĐŊĐžĐŗĐž ĐēОдŅ).
+
+**FastAPI** ĐŊĐ°Đ´Đ°Ņ ĐēŅĐģŅĐēĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв, ŅĐēŅ Đ´ĐžĐŋĐžĐŧĐžĐļŅŅŅ ĐĐ°Đŧ вĐŋĐžŅĐ°ŅиŅŅ С **ĐąĐĩСĐŋĐĩĐēĐžŅ** ĐģĐĩĐŗĐēĐž, ŅвидĐēĐž, ŅŅĐ°ĐŊĐ´Đ°ŅŅĐŊиĐŧ ŅĐŋĐžŅОйОĐŧ, ĐąĐĩС ĐŊĐĩОйŅ
ŅĐ´ĐŊĐžŅŅŅ вивŅĐ°Ņи вŅŅ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ ĐąĐĩСĐŋĐĩĐēи.
+
+ĐĐģĐĩ ŅĐŋĐžŅĐ°ŅĐēŅ â ĐēŅĐģŅĐēĐ° ĐēĐžŅĐžŅĐēиŅ
ĐŋĐžĐŊŅŅŅ.
+
+## ĐĐžŅĐŋŅŅĐ°ŅŅĐĩ?
+
+Đ¯ĐēŅĐž ĐĐ°Đŧ ĐŊĐĩ ŅŅĐēавŅ вŅŅ ŅŅ ŅĐĩŅĐŧŅĐŊи Đš ĐŋŅĐžŅŅĐž ĐŋĐžŅŅŅĐąĐŊĐž *ŅвидĐēĐž* дОдаŅи авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ Са ĐģĐžĐŗŅĐŊĐžĐŧ Ņ ĐŋĐ°ŅĐžĐģĐĩĐŧ â ĐŋĐĩŅĐĩŅ
ОдŅŅĐĩ Đ´Đž ĐŊĐ°ŅŅŅĐŋĐŊиŅ
ŅОСдŅĐģŅв.
+
+## OAuth2
+
+OAuth2 â ŅĐĩ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ, ŅĐž ĐžĐŋиŅŅŅ ĐēŅĐģŅĐēĐ° ŅĐŋĐžŅОйŅв ОйŅОйĐēи авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ ŅĐ° авŅĐžŅиСаŅŅŅ.
+
+ĐĻĐĩ Đ´ĐžŅиŅŅ Ой'ŅĐŧĐŊĐ° ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ, ŅĐēĐ° ĐžŅ
ĐžĐŋĐģŅŅ ŅĐēĐģĐ°Đ´ĐŊŅ виĐŋĐ°Đ´Đēи виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ.
+
+ĐĐžĐŊĐ° вĐēĐģŅŅĐ°Ņ ŅĐŋĐžŅОйи авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ ŅĐĩŅĐĩС "ŅŅĐĩŅŅ ŅŅĐžŅĐžĐŊŅ".
+
+ĐĄĐ°ĐŧĐĩ ŅĐĩ ĐģĐĩĐļиŅŅ в ĐžŅĐŊОвŅ "вŅ
ОдŅ ŅĐĩŅĐĩС Google, Facebook, X (Twitter), GitHub" ŅĐžŅĐž.
+
+### OAuth 1
+
+Đ Đ°ĐŊŅŅĐĩ ŅŅĐŊŅвав OAuth 1, ŅĐēиК СĐŊĐ°ŅĐŊĐž вŅĐ´ŅŅСĐŊŅŅŅŅŅŅ вŅĐ´ OAuth2 Ņ Ņ ŅĐēĐģĐ°Đ´ĐŊŅŅиĐŧ, ĐžŅĐēŅĐģŅĐēи ĐŧŅŅŅив ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ Đ´ĐģŅ ŅиŅŅŅваĐŊĐŊŅ ĐēĐžĐŧŅĐŊŅĐēĐ°ŅŅĐš.
+
+ĐĐ°ŅаС ĐŧĐ°ĐšĐļĐĩ ĐŊĐĩ виĐēĐžŅиŅŅОвŅŅŅŅŅŅ.
+
+OAuth2 ĐŊĐĩ вĐēаСŅŅ, ŅĐē ŅĐ°ĐŧĐĩ ŅиŅŅŅваŅи С'ŅĐ´ĐŊĐ°ĐŊĐŊŅ â вОĐŊĐž ĐžŅŅĐēŅŅ, ŅĐž ваŅ СаŅŅĐžŅŅĐŊĐžĐē ĐŋŅĐ°ŅŅŅ ŅĐĩŅĐĩС HTTPS.
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐŖ ŅОСдŅĐģŅ ĐŋŅĐž **Đ´ĐĩĐŋĐģОК** Đи ĐŋОйаŅиŅĐĩ, ŅĐē ĐŊĐ°ĐģĐ°ŅŅŅваŅи HTTPS ĐąĐĩСĐēĐžŅŅОвĐŊĐž С Traefik ŅĐ° Let's Encrypt.
+
+///
+
+## OpenID Connect
+
+OpenID Connect â ŅĐĩ ОдĐŊĐ° ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ, ĐŋОйŅдОваĐŊĐ° ĐŊĐ° ĐžŅĐŊОвŅ **OAuth2**.
+
+ĐĐžĐŊĐ° ŅОСŅиŅŅŅ OAuth2, ŅŅĐžŅĐŊŅŅŅи Đ´ĐĩŅĐēŅ ĐŊĐĩОдĐŊОСĐŊĐ°ŅĐŊĐžŅŅŅ Đ´ĐģŅ Đ´ĐžŅŅĐŗĐŊĐĩĐŊĐŊŅ ĐēŅĐ°ŅĐžŅ ŅŅĐŧŅŅĐŊĐžŅŅŅ.
+
+ĐĐ°ĐŋŅиĐēĐģĐ°Đ´, вŅ
ŅĐ´ ŅĐĩŅĐĩС Google виĐēĐžŅиŅŅОвŅŅ OpenID Connect (ŅĐēиК йаСŅŅŅŅŅŅ ĐŊĐ° OAuth2).
+
+ĐĐģĐĩ вŅ
ŅĐ´ ŅĐĩŅĐĩС Facebook â ĐŊŅ. ĐŅĐŊ ĐŧĐ°Ņ вĐģĐ°ŅĐŊŅ ŅĐĩĐ°ĐģŅСаŅŅŅ ĐŊĐ° йаСŅ OAuth2.
+
+### OpenID (ĐŊĐĩ "OpenID Connect")
+
+ĐŅĐŊŅваĐģĐ° ŅĐ°ĐēĐžĐļ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ "OpenID", ŅĐēĐ° ĐŊĐ°ĐŧĐ°ĐŗĐ°ĐģĐ°ŅŅ ŅОСвĘŧŅСаŅи ŅŅ ŅĐ°ĐŧŅ СадаŅŅ, ŅĐž Đš **OpenID Connect**, Đ°ĐģĐĩ ĐŊĐĩ йаСŅваĐģĐ°ŅŅ ĐŊĐ° OAuth2.
+
+ĐĻĐĩ ĐąŅĐģĐ° СОвŅŅĐŧ ŅĐŊŅĐ° ŅиŅŅĐĩĐŧĐ°, Ņ ŅŅĐžĐŗОдĐŊŅ вОĐŊĐ° ĐŧĐ°ĐšĐļĐĩ ĐŊĐĩ виĐēĐžŅиŅŅОвŅŅŅŅŅŅ.
+
+## OpenAPI
+
+OpenAPI (ŅĐ°ĐŊŅŅĐĩ Swagger) â ŅĐĩ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ Đ´ĐģŅ ĐŋОйŅдОви API (ŅĐĩĐŋĐĩŅ ĐŋŅĐ´ ĐĩĐŗŅĐ´ĐžŅ Linux Foundation).
+
+**FastAPI** йаСŅŅŅŅŅŅ ĐŊĐ° **OpenAPI**.
+
+ĐавдŅĐēи ŅŅĐžĐŧŅ Đи ĐžŅŅиĐŧŅŅŅĐĩ авŅĐžĐŧĐ°ŅиŅĐŊŅ ŅĐŊŅĐĩŅĐ°ĐēŅивĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ, ĐŗĐĩĐŊĐĩŅĐ°ŅŅŅ ĐēОдŅ ŅĐ° йаĐŗĐ°ŅĐž ŅĐŊŅĐžĐŗĐž.
+
+OpenAPI дОСвОĐģŅŅ ĐžĐŋиŅŅваŅи ŅŅСĐŊŅ "ŅŅ
ĐĩĐŧи" ĐąĐĩСĐŋĐĩĐēи.
+
+ĐиĐēĐžŅиŅŅОвŅŅŅи ŅŅ
, Đи ĐŧĐžĐļĐĩŅĐĩ ŅĐēĐžŅиŅŅĐ°ŅиŅŅ вŅŅĐŧĐ° ŅиĐŧи ŅĐŊŅŅŅŅĐŧĐĩĐŊŅĐ°Đŧи, ŅĐž йаСŅŅŅŅŅŅ ĐŊĐ° ŅŅĐ°ĐŊĐ´Đ°ŅŅĐ°Ņ
, СОĐēŅĐĩĐŧĐ° ŅĐŊŅĐĩŅĐ°ĐēŅивĐŊиĐŧи ŅиŅŅĐĩĐŧĐ°Đŧи Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ.
+
+OpenAPI виСĐŊĐ°ŅĐ°Ņ ŅĐ°ĐēŅ ŅŅ
ĐĩĐŧи ĐąĐĩСĐŋĐĩĐēи:
+
+* `apiKey`: ŅĐŋĐĩŅиŅŅŅĐŊиК Đ´ĐģŅ СаŅŅĐžŅŅĐŊĐēŅ ĐēĐģŅŅ, ŅĐēиК ĐŧĐžĐļĐĩ ĐŋĐĩŅĐĩдаваŅиŅŅ ŅĐĩŅĐĩС:
+ * ĐĐ°ŅĐ°ĐŧĐĩŅŅ СаĐŋиŅŅ.
+ * ĐĐ°ĐŗĐžĐģОвОĐē.
+ * Cookie.
+* `http`: ŅŅĐ°ĐŊĐ´Đ°ŅŅĐŊŅ ĐŧĐĩŅОди HTTP-авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ, вĐēĐģŅŅĐ°ŅŅи:
+ * `bearer`: СаĐŗĐžĐģОвОĐē `Authorization` СŅ СĐŊĐ°ŅĐĩĐŊĐŊŅĐŧ `Bearer` ŅĐ° ŅĐžĐēĐĩĐŊĐžĐŧ. ĐĻĐĩ ŅŅĐŋĐ°Đ´ĐēОваĐŊĐž С OAuth2.
+ * HTTP Basic авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ
+ * HTTP Digest, ŅĐžŅĐž.
+* `oauth2`: ŅŅŅ ŅĐŋĐžŅОйи ОйŅОйĐēи ĐąĐĩСĐŋĐĩĐēи Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ OAuth2 (ŅĐ°Đē СваĐŊŅ ÂĢĐŋĐžŅĐžĐēиÂģ).
+ * ĐĐĩŅĐēŅ С ŅиŅ
ĐŋĐžŅĐžĐēŅв ĐŋŅĐ´Ņ
ОдŅŅŅ Đ´ĐģŅ ŅŅвОŅĐĩĐŊĐŊŅ вĐģĐ°ŅĐŊĐžĐŗĐž ĐŋŅОваКдĐĩŅĐ° авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ OAuth 2.0 (ĐŊĐ°ĐŋŅиĐēĐģĐ°Đ´, Google, Facebook, X (Twitter), GitHub ŅĐžŅĐž):
+ * `implicit`â ĐŊĐĩŅвĐŊиК
+ * `clientCredentials`â ОйĐģŅĐēОвŅ Đ´Đ°ĐŊŅ ĐēĐģŅŅĐŊŅĐ°
+ * `authorizationCode` â ĐēОд авŅĐžŅиСаŅŅŅ
+ * ĐĐģĐĩ Ņ ОдиĐŊ ĐžĐēŅĐĩĐŧиК ÂĢĐŋĐžŅŅĐēÂģ, ŅĐēиК ŅĐ´ĐĩĐ°ĐģŅĐŊĐž ĐŋŅĐ´Ņ
ОдиŅŅ Đ´ĐģŅ ŅĐĩĐ°ĐģŅСаŅŅŅ авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ вŅĐĩŅĐĩдиĐŊŅ ОдĐŊĐžĐŗĐž дОдаŅĐēŅ:
+ * `password`: Ņ ĐŊĐ°ŅŅŅĐŋĐŊиŅ
ŅОСдŅĐģĐ°Ņ
ĐąŅĐ´Đĩ ĐŋŅиĐēĐģĐ°Đ´ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ŅŅĐžĐŗĐž ĐŋĐžŅĐžĐēŅ.
+* `openIdConnect`: дОСвОĐģŅŅ авŅĐžĐŧĐ°ŅиŅĐŊĐž виŅвĐģŅŅи ĐŋĐ°ŅĐ°ĐŧĐĩŅŅи авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ OAuth2.
+ * ĐĻĐĩ авŅĐžĐŧĐ°ŅиŅĐŊĐĩ виŅвĐģĐĩĐŊĐŊŅ виСĐŊĐ°ŅĐ°ŅŅŅŅŅ Ņ ŅĐŋĐĩŅиŅŅĐēĐ°ŅŅŅ OpenID Connect.
+
+
+/// tip | ĐĐžŅĐ°Đ´Đ°
+
+ĐĐŊŅĐĩĐŗŅĐ°ŅŅŅ ŅĐŊŅиŅ
ĐŋŅОваКдĐĩŅŅв авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ/авŅĐžŅиСаŅŅŅ, ŅĐ°ĐēиŅ
ŅĐē Google, Facebook, X (Twitter), GitHub ŅĐžŅĐž â ŅĐ°ĐēĐžĐļ ĐŧĐžĐļĐģива Ņ вŅĐ´ĐŊĐžŅĐŊĐž ĐŋŅĐžŅŅĐ°.
+
+ĐĐ°ĐšŅĐēĐģĐ°Đ´ĐŊŅŅĐĩ â ŅĐĩ ŅŅвОŅиŅи вĐģĐ°ŅĐŊĐžĐŗĐž ĐŋŅОваКдĐĩŅĐ° авŅĐĩĐŊŅиŅŅĐēĐ°ŅŅŅ/авŅĐžŅиСаŅŅŅ, ŅĐē Google Ņи Facebook. ĐĐģĐĩ **FastAPI** ĐŊĐ°Đ´Đ°Ņ ĐĐ°Đŧ ŅĐŊŅŅŅŅĐŧĐĩĐŊŅи, ŅОй СŅОйиŅи ŅĐĩ ĐģĐĩĐŗĐēĐž, ĐąĐĩŅŅŅи ĐŊĐ° ŅĐĩĐąĐĩ ваĐļĐēŅ ŅĐ°ŅŅиĐŊŅ ŅОйОŅи.
+
+///
+
+## ĐĐŊŅŅŅŅĐŧĐĩĐŊŅи **FastAPI**
+
+FastAPI ĐŊĐ°Đ´Đ°Ņ ĐēŅĐģŅĐēĐ° ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв Đ´ĐģŅ ĐēĐžĐļĐŊĐžŅ С ĐžĐŋиŅĐ°ĐŊиŅ
ŅŅ
ĐĩĐŧ ĐąĐĩСĐŋĐĩĐēи в ĐŧОдŅĐģŅ `fastapi.security`, ŅĐēŅ ŅĐŋŅĐžŅŅŅŅŅ виĐēĐžŅиŅŅĐ°ĐŊĐŊŅ ŅиŅ
ĐŧĐĩŅ
Đ°ĐŊŅСĐŧŅв СаŅ
иŅŅŅ.
+
+ĐŖ ĐŊĐ°ŅŅŅĐŋĐŊиŅ
ŅОСдŅĐģĐ°Ņ
Đи ĐŋОйаŅиŅĐĩ, ŅĐē дОдаŅи ĐąĐĩСĐŋĐĩĐēŅ Đ´Đž ŅвОĐŗĐž API Са Đ´ĐžĐŋĐžĐŧĐžĐŗĐžŅ ŅиŅ
ŅĐŊŅŅŅŅĐŧĐĩĐŊŅŅв **FastAPI**.
+
+Đ ŅĐ°ĐēĐžĐļ ĐŋОйаŅиŅĐĩ, ŅĐē вОĐŊĐ° авŅĐžĐŧĐ°ŅиŅĐŊĐž ŅĐŊŅĐĩĐŗŅŅŅŅŅŅŅ в ŅĐŊŅĐĩŅĐ°ĐēŅивĐŊŅ Đ´ĐžĐēŅĐŧĐĩĐŊŅĐ°ŅŅŅ ваŅĐžĐŗĐž API.
diff --git a/docs/zh/docs/deployment/concepts.md b/docs/zh/docs/deployment/concepts.md
index 7a0b6c3d2..f7208da7c 100644
--- a/docs/zh/docs/deployment/concepts.md
+++ b/docs/zh/docs/deployment/concepts.md
@@ -220,7 +220,7 @@
čŋäēåˇĨäŊčŋį¨å°æ¯čŋčĄæ¨įåēį¨į¨åēįčŋį¨īŧåŽäģŦå°æ§čĄä¸ģčĻ莥įŽäģĨæĨæļ **č¯ˇæą** åšļčŋå **ååē**īŧåšļä¸åŽäģŦå°å čŊŊæ¨æžå
Ĩ RAM ä¸įåéä¸įäģģäŊå
厚ã
-
+
å¸Ļææŗ¨éįåä¸æäģļįģæīŧ
@@ -244,7 +244,7 @@ from .dependencies import get_token_header
č¯ˇčŽ°äŊæäģŦįį¨åē/æäģļįģææ¯ææ ˇįīŧ
-