Sync fastapi docs from 50fa3f7c on 2026-01-11

2026-01-11 04:00:07 +00:00
parent a42b1ff04e
commit 95d1a394e6
1611 changed files with 12193 additions and 123004 deletions
@@ -15,7 +15,7 @@

 Тесты:

-## Фрагменты кода { #code-snippets}
+## Фрагменты кода { #code-snippets }

 //// tab | Тест

@@ -53,7 +53,7 @@ LLM, вероятно, переведёт это неправильно. Инт

 ////

-## Кавычки во фрагментах кода { #quotes-in-code-snippets}
+## Кавычки во фрагментах кода { #quotes-in-code-snippets }

 //// tab | Тест

@@ -26,7 +26,7 @@

 Например, чтобы объявить ещё один ответ со статус-кодом `404` и Pydantic-моделью `Message`, можно написать:

-{* ../../docs_src/additional_responses/tutorial001.py hl[18,22] *}
+{* ../../docs_src/additional_responses/tutorial001_py39.py hl[18,22] *}

 /// note | Примечание

@@ -175,7 +175,7 @@

 Например, вы можете добавить дополнительный тип содержимого `image/png`, объявив, что ваша операция пути может возвращать JSON‑объект (с типом содержимого `application/json`) или PNG‑изображение:

-{* ../../docs_src/additional_responses/tutorial002.py hl[19:24,28] *}
+{* ../../docs_src/additional_responses/tutorial002_py310.py hl[17:22,26] *}

 /// note | Примечание

@@ -203,7 +203,7 @@

 А также ответ со статус-кодом `200`, который использует ваш `response_model`, но включает пользовательский `example`:

-{* ../../docs_src/additional_responses/tutorial003.py hl[20:31] *}
+{* ../../docs_src/additional_responses/tutorial003_py39.py hl[20:31] *}

 Всё это будет объединено и включено в ваш OpenAPI и отображено в документации API:

@@ -237,7 +237,7 @@ new_dict = {**old_dict, "new key": "new value"}

 Например:

-{* ../../docs_src/additional_responses/tutorial004.py hl[13:17,26] *}
+{* ../../docs_src/additional_responses/tutorial004_py310.py hl[11:15,24] *}

 ## Дополнительная информация об ответах OpenAPI { #more-information-about-openapi-responses }

@@ -144,7 +144,7 @@ checker(q="somequery")

 ### Фоновые задачи и зависимости с `yield`, технические детали { #background-tasks-and-dependencies-with-yield-technical-details }

-До FastAPI 0.106.0 вызывать исключения после `yield` было невозможно: код после `yield` в зависимостях выполнялся уже после отправки ответа, поэтому [Обработчики исключений](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank} к тому моменту уже отработали.
+До FastAPI 0.106.0 вызывать исключения после `yield` было невозможно: код после `yield` в зависимостях выполнялся уже после отправки ответа, поэтому [Обработчики исключений](../tutorial/handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank} к тому моменту уже отработали.

 Так было сделано в основном для того, чтобы можно было использовать те же объекты, «отданные» зависимостями через `yield`, внутри фоновых задач, потому что код после `yield` выполнялся после завершения фоновых задач.

@@ -32,11 +32,11 @@

 Файл `main.py`:

-{* ../../docs_src/async_tests/main.py *}
+{* ../../docs_src/async_tests/app_a_py39/main.py *}

 Файл `test_main.py` содержит тесты для `main.py`, теперь он может выглядеть так:

-{* ../../docs_src/async_tests/test_main.py *}
+{* ../../docs_src/async_tests/app_a_py39/test_main.py *}

 ## Запуск тестов { #run-it }

@@ -56,7 +56,7 @@ $ pytest

 Маркер `@pytest.mark.anyio` говорит pytest, что тестовая функция должна быть вызвана асинхронно:

-{* ../../docs_src/async_tests/test_main.py hl[7] *}
+{* ../../docs_src/async_tests/app_a_py39/test_main.py hl[7] *}

 /// tip | Подсказка

@@ -66,7 +66,7 @@ $ pytest

 Затем мы можем создать `AsyncClient` со ссылкой на приложение и посылать асинхронные запросы, используя `await`.

-{* ../../docs_src/async_tests/test_main.py hl[9:12] *}
+{* ../../docs_src/async_tests/app_a_py39/test_main.py hl[9:12] *}

 Это эквивалентно следующему:

@@ -44,7 +44,7 @@ $ fastapi run --forwarded-allow-ips="*"

 Например, вы объявили операцию пути `/items/`:

-{* ../../docs_src/behind_a_proxy/tutorial001_01.py hl[6] *}
+{* ../../docs_src/behind_a_proxy/tutorial001_01_py39.py hl[6] *}

 Если клиент обратится к `/items`, по умолчанию произойдёт редирект на `/items/`.

@@ -64,7 +64,7 @@ https://mysuperapp.com/items/

 ///

-### Как работают пересылаемые заголовки прокси
+### Как работают пересылаемые заголовки прокси { #how-proxy-forwarded-headers-work }

 Ниже показано, как прокси добавляет пересылаемые заголовки между клиентом и сервером приложения:

@@ -115,7 +115,7 @@ sequenceDiagram

 Хотя весь ваш код написан с расчётом, что путь один — `/app`.

-{* ../../docs_src/behind_a_proxy/tutorial001.py hl[6] *}
+{* ../../docs_src/behind_a_proxy/tutorial001_py39.py hl[6] *}

 Прокси будет «обрезать» префикс пути на лету перед передачей запроса на сервер приложения (скорее всего Uvicorn, запущенный через FastAPI CLI), поддерживая у вашего приложения иллюзию, что его обслуживают по `/app`, чтобы вам не пришлось менять весь код и добавлять префикс `/api/v1`.

@@ -193,7 +193,7 @@ $ fastapi run main.py --forwarded-allow-ips="*" --root-path /api/v1

 Здесь мы добавляем его в сообщение лишь для демонстрации.

-{* ../../docs_src/behind_a_proxy/tutorial001.py hl[8] *}
+{* ../../docs_src/behind_a_proxy/tutorial001_py39.py hl[8] *}

 Затем, если вы запустите Uvicorn так:

@@ -220,7 +220,7 @@ $ fastapi run main.py --forwarded-allow-ips="*" --root-path /api/v1

 Если нет возможности передать опцию командной строки `--root-path` (или аналог), вы можете указать параметр `root_path` при создании приложения FastAPI:

-{* ../../docs_src/behind_a_proxy/tutorial002.py hl[3] *}
+{* ../../docs_src/behind_a_proxy/tutorial002_py39.py hl[3] *}

 Передача `root_path` в `FastAPI` эквивалентна опции командной строки `--root-path` для Uvicorn или Hypercorn.

@@ -400,7 +400,7 @@ $ fastapi run main.py --forwarded-allow-ips="*" --root-path /api/v1

 Например:

-{* ../../docs_src/behind_a_proxy/tutorial003.py hl[4:7] *}
+{* ../../docs_src/behind_a_proxy/tutorial003_py39.py hl[4:7] *}

 Будет сгенерирована схема OpenAPI примерно такая:

@@ -443,11 +443,19 @@ $ fastapi run main.py --forwarded-allow-ips="*" --root-path /api/v1

 ///

+/// note | Технические детали
+
+Свойство `servers` в спецификации OpenAPI является необязательным.
+
+Если вы не укажете параметр `servers`, а `root_path` равен `/`, то свойство `servers` в сгенерированной схеме OpenAPI по умолчанию будет опущено. Это эквивалентно серверу со значением `url` равным `/`.
+
+///
+
 ### Отключить автоматическое добавление сервера из `root_path` { #disable-automatic-server-from-root-path }

 Если вы не хотите, чтобы FastAPI добавлял автоматический сервер, используя `root_path`, укажите параметр `root_path_in_servers=False`:

-{* ../../docs_src/behind_a_proxy/tutorial004.py hl[9] *}
+{* ../../docs_src/behind_a_proxy/tutorial004_py39.py hl[9] *}

 и тогда этот сервер не будет добавлен в схему OpenAPI.

@@ -30,7 +30,7 @@

 Но если вы уверены, что содержимое, которое вы возвращаете, **сериализуемо в JSON**, вы можете передать его напрямую в класс ответа и избежать дополнительных накладных расходов, которые FastAPI понёс бы, пропуская возвращаемое содержимое через `jsonable_encoder` перед передачей в класс ответа.

-{* ../../docs_src/custom_response/tutorial001b.py hl[2,7] *}
+{* ../../docs_src/custom_response/tutorial001b_py39.py hl[2,7] *}

 /// info | Информация

@@ -55,7 +55,7 @@
 - Импортируйте `HTMLResponse`.
 - Передайте `HTMLResponse` в параметр `response_class` вашего декоратора операции пути.

-{* ../../docs_src/custom_response/tutorial002.py hl[2,7] *}
+{* ../../docs_src/custom_response/tutorial002_py39.py hl[2,7] *}

 /// info | Информация

@@ -73,7 +73,7 @@

 Тот же пример сверху, возвращающий `HTMLResponse`, может выглядеть так:

-{* ../../docs_src/custom_response/tutorial003.py hl[2,7,19] *}
+{* ../../docs_src/custom_response/tutorial003_py39.py hl[2,7,19] *}

 /// warning | Предупреждение

@@ -97,7 +97,7 @@

 Например, это может быть что-то вроде:

-{* ../../docs_src/custom_response/tutorial004.py hl[7,21,23] *}
+{* ../../docs_src/custom_response/tutorial004_py39.py hl[7,21,23] *}

 В этом примере функция `generate_html_response()` уже генерирует и возвращает `Response` вместо возврата HTML в `str`.

@@ -136,7 +136,7 @@

 FastAPI (фактически Starlette) автоматически добавит заголовок Content-Length. Также будет добавлен заголовок Content-Type, основанный на `media_type` и с добавлением charset для текстовых типов.

-{* ../../docs_src/response_directly/tutorial002.py hl[1,18] *}
+{* ../../docs_src/response_directly/tutorial002_py39.py hl[1,18] *}

 ### `HTMLResponse` { #htmlresponse }

@@ -146,7 +146,7 @@ FastAPI (фактически Starlette) автоматически добави

 Принимает текст или байты и возвращает ответ в виде простого текста.

-{* ../../docs_src/custom_response/tutorial005.py hl[2,7,9] *}
+{* ../../docs_src/custom_response/tutorial005_py39.py hl[2,7,9] *}

 ### `JSONResponse` { #jsonresponse }

@@ -180,7 +180,7 @@ FastAPI (фактически Starlette) автоматически добави

 ///

-{* ../../docs_src/custom_response/tutorial001.py hl[2,7] *}
+{* ../../docs_src/custom_response/tutorial001_py39.py hl[2,7] *}

 /// tip | Совет

@@ -194,13 +194,13 @@ FastAPI (фактически Starlette) автоматически добави

 Вы можете вернуть `RedirectResponse` напрямую:

-{* ../../docs_src/custom_response/tutorial006.py hl[2,9] *}
+{* ../../docs_src/custom_response/tutorial006_py39.py hl[2,9] *}

 ---

 Или можно использовать его в параметре `response_class`:

-{* ../../docs_src/custom_response/tutorial006b.py hl[2,7,9] *}
+{* ../../docs_src/custom_response/tutorial006b_py39.py hl[2,7,9] *}

 Если вы сделаете так, то сможете возвращать URL напрямую из своей функции-обработчика пути.

@@ -210,13 +210,13 @@ FastAPI (фактически Starlette) автоматически добави

 Также вы можете использовать параметр `status_code` в сочетании с параметром `response_class`:

-{* ../../docs_src/custom_response/tutorial006c.py hl[2,7,9] *}
+{* ../../docs_src/custom_response/tutorial006c_py39.py hl[2,7,9] *}

 ### `StreamingResponse` { #streamingresponse }

 Принимает асинхронный генератор или обычный генератор/итератор и отправляет тело ответа потоково.

-{* ../../docs_src/custom_response/tutorial007.py hl[2,14] *}
+{* ../../docs_src/custom_response/tutorial007_py39.py hl[2,14] *}

 #### Использование `StreamingResponse` с файлоподобными объектами { #using-streamingresponse-with-file-like-objects }

@@ -226,7 +226,7 @@ FastAPI (фактически Starlette) автоматически добави

 Это включает многие библиотеки для работы с облачным хранилищем, обработки видео и т.д.

-{* ../../docs_src/custom_response/tutorial008.py hl[2,10:12,14] *}
+{* ../../docs_src/custom_response/tutorial008_py39.py hl[2,10:12,14] *}

 1. Это функция-генератор. Она является «функцией-генератором», потому что содержит оператор(ы) `yield` внутри.
 2. Используя блок `with`, мы гарантируем, что файлоподобный объект будет закрыт после завершения работы функции-генератора. То есть после того, как она закончит отправку ответа.
@@ -255,11 +255,11 @@ FastAPI (фактически Starlette) автоматически добави

 Файловые ответы будут содержать соответствующие заголовки `Content-Length`, `Last-Modified` и `ETag`.

-{* ../../docs_src/custom_response/tutorial009.py hl[2,10] *}
+{* ../../docs_src/custom_response/tutorial009_py39.py hl[2,10] *}

 Вы также можете использовать параметр `response_class`:

-{* ../../docs_src/custom_response/tutorial009b.py hl[2,8,10] *}
+{* ../../docs_src/custom_response/tutorial009b_py39.py hl[2,8,10] *}

 В этом случае вы можете возвращать путь к файлу напрямую из своей функции-обработчика пути.

@@ -273,7 +273,7 @@ FastAPI (фактически Starlette) автоматически добави

 Вы могли бы создать `CustomORJSONResponse`. Главное, что вам нужно сделать — реализовать метод `Response.render(content)`, который возвращает содержимое как `bytes`:

-{* ../../docs_src/custom_response/tutorial009c.py hl[9:14,17] *}
+{* ../../docs_src/custom_response/tutorial009c_py39.py hl[9:14,17] *}

 Теперь вместо того, чтобы возвращать:

@@ -299,7 +299,7 @@ FastAPI (фактически Starlette) автоматически добави

 В примере ниже **FastAPI** будет использовать `ORJSONResponse` по умолчанию во всех операциях пути вместо `JSONResponse`.

-{* ../../docs_src/custom_response/tutorial010.py hl[2,4] *}
+{* ../../docs_src/custom_response/tutorial010_py39.py hl[2,4] *}

 /// tip | Совет

@@ -4,7 +4,7 @@ FastAPI построен поверх **Pydantic**, и я показывал в

 Но FastAPI также поддерживает использование <a href="https://docs.python.org/3/library/dataclasses.html" class="external-link" target="_blank">`dataclasses`</a> тем же способом:

-{* ../../docs_src/dataclasses/tutorial001.py hl[1,7:12,19:20] *}
+{* ../../docs_src/dataclasses_/tutorial001_py310.py hl[1,6:11,18:19] *}

 Это по-прежнему поддерживается благодаря **Pydantic**, так как в нём есть <a href="https://docs.pydantic.dev/latest/concepts/dataclasses/#use-of-stdlib-dataclasses-with-basemodel" class="external-link" target="_blank">встроенная поддержка `dataclasses`</a>.

@@ -32,7 +32,7 @@ FastAPI построен поверх **Pydantic**, и я показывал в

 Вы также можете использовать `dataclasses` в параметре `response_model`:

-{* ../../docs_src/dataclasses/tutorial002.py hl[1,7:13,19] *}
+{* ../../docs_src/dataclasses_/tutorial002_py310.py hl[1,6:12,18] *}

 Этот dataclass будет автоматически преобразован в Pydantic dataclass.

@@ -48,7 +48,7 @@ FastAPI построен поверх **Pydantic**, и я показывал в

 В таком случае вы можете просто заменить стандартные `dataclasses` на `pydantic.dataclasses`, которая является полностью совместимой заменой (drop-in replacement):

-{* ../../docs_src/dataclasses/tutorial003.py hl[1,5,8:11,14:17,23:25,28] *}
+{* ../../docs_src/dataclasses_/tutorial003_py310.py hl[1,4,7:10,13:16,22:24,27] *}

 1. Мы по-прежнему импортируем `field` из стандартных `dataclasses`.

@@ -30,7 +30,7 @@

 Мы создаём асинхронную функцию `lifespan()` с `yield` примерно так:

-{* ../../docs_src/events/tutorial003.py hl[16,19] *}
+{* ../../docs_src/events/tutorial003_py39.py hl[16,19] *}

 Здесь мы симулируем дорогую операцию startup по загрузке модели, помещая (фиктивную) функцию модели в словарь с моделями Машинного обучения до `yield`. Этот код будет выполнен до того, как приложение начнет принимать запросы, во время startup.

@@ -48,7 +48,7 @@

 Первое, на что стоит обратить внимание, — мы определяем асинхронную функцию с `yield`. Это очень похоже на Зависимости с `yield`.

-{* ../../docs_src/events/tutorial003.py hl[14:19] *}
+{* ../../docs_src/events/tutorial003_py39.py hl[14:19] *}

 Первая часть функции, до `yield`, будет выполнена до запуска приложения.

@@ -60,7 +60,7 @@

 Это превращает функцию в «асинхронный менеджер контекста».

-{* ../../docs_src/events/tutorial003.py hl[1,13] *}
+{* ../../docs_src/events/tutorial003_py39.py hl[1,13] *}

 Менеджер контекста в Python — это то, что можно использовать в операторе `with`. Например, `open()` можно использовать как менеджер контекста:

@@ -82,7 +82,7 @@ async with lifespan(app):

 Параметр `lifespan` приложения `FastAPI` принимает асинхронный менеджер контекста, поэтому мы можем передать ему наш новый асинхронный менеджер контекста `lifespan`.

-{* ../../docs_src/events/tutorial003.py hl[22] *}
+{* ../../docs_src/events/tutorial003_py39.py hl[22] *}

 ## Альтернативные события (устаревшие) { #alternative-events-deprecated }

@@ -104,7 +104,7 @@ async with lifespan(app):

 Чтобы добавить функцию, которую нужно запустить до старта приложения, объявите её как обработчик события `"startup"`:

-{* ../../docs_src/events/tutorial001.py hl[8] *}
+{* ../../docs_src/events/tutorial001_py39.py hl[8] *}

 В этом случае функция-обработчик события `startup` инициализирует «базу данных» items (это просто `dict`) некоторыми значениями.

@@ -116,7 +116,7 @@ async with lifespan(app):

 Чтобы добавить функцию, которую нужно запустить при завершении работы приложения, объявите её как обработчик события `"shutdown"`:

-{* ../../docs_src/events/tutorial002.py hl[6] *}
+{* ../../docs_src/events/tutorial002_py39.py hl[6] *}

 Здесь функция-обработчик события `shutdown` запишет строку текста `"Application shutdown"` в файл `log.txt`.

@@ -167,7 +167,7 @@ FastAPI использует **уникальный ID** для каждой *о

 Мы можем скачать OpenAPI JSON в файл `openapi.json`, а затем **убрать этот префикс‑тег** таким скриптом:

-{* ../../docs_src/generate_clients/tutorial004.py *}
+{* ../../docs_src/generate_clients/tutorial004_py39.py *}

 //// tab | Node.js

@@ -57,13 +57,13 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")

 Любой входящий запрос по `http` или `ws` будет перенаправлен на безопасную схему.

-{* ../../docs_src/advanced_middleware/tutorial001.py hl[2,6] *}
+{* ../../docs_src/advanced_middleware/tutorial001_py39.py hl[2,6] *}

 ## `TrustedHostMiddleware` { #trustedhostmiddleware }

 Гарантирует, что во всех входящих запросах корректно установлен `Host`‑заголовок, чтобы защититься от атак на HTTP‑заголовок Host.

-{* ../../docs_src/advanced_middleware/tutorial002.py hl[2,6:8] *}
+{* ../../docs_src/advanced_middleware/tutorial002_py39.py hl[2,6:8] *}

 Поддерживаются следующие аргументы:

@@ -78,7 +78,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")

 Это middleware обрабатывает как обычные, так и потоковые ответы.

-{* ../../docs_src/advanced_middleware/tutorial003.py hl[2,6] *}
+{* ../../docs_src/advanced_middleware/tutorial003_py39.py hl[2,6] *}

 Поддерживаются следующие аргументы:

@@ -31,7 +31,7 @@

 Эта часть вполне обычна, большая часть кода вам уже знакома:

-{* ../../docs_src/openapi_callbacks/tutorial001.py hl[9:13,36:53] *}
+{* ../../docs_src/openapi_callbacks/tutorial001_py310.py hl[7:11,34:51] *}

 /// tip | Совет

@@ -90,7 +90,7 @@ httpx.post(callback_url, json={"description": "Invoice paid", "paid": True})

 Сначала создайте новый `APIRouter`, который будет содержать один или несколько обратных вызовов.

-{* ../../docs_src/openapi_callbacks/tutorial001.py hl[3,25] *}
+{* ../../docs_src/openapi_callbacks/tutorial001_py310.py hl[1,23] *}

 ### Создайте *операцию пути* для обратного вызова { #create-the-callback-path-operation }

@@ -101,7 +101,7 @@ httpx.post(callback_url, json={"description": "Invoice paid", "paid": True})
 * Вероятно, в ней должно быть объявление тела запроса, например `body: InvoiceEvent`.
 * А также может быть объявление модели ответа, например `response_model=InvoiceEventReceived`.

-{* ../../docs_src/openapi_callbacks/tutorial001.py hl[16:18,21:22,28:32] *}
+{* ../../docs_src/openapi_callbacks/tutorial001_py310.py hl[14:16,19:20,26:30] *}

 Есть 2 основных отличия от обычной *операции пути*:

@@ -169,7 +169,7 @@ https://www.external.org/events/invoices/2expen51ve

 Теперь используйте параметр `callbacks` в *декораторе операции пути вашего API*, чтобы передать атрибут `.routes` (это, по сути, просто `list` маршрутов/*операций пути*) из этого маршрутизатора обратных вызовов:

-{* ../../docs_src/openapi_callbacks/tutorial001.py hl[35] *}
+{* ../../docs_src/openapi_callbacks/tutorial001_py310.py hl[33] *}

 /// tip | Совет

@@ -32,7 +32,7 @@

 При создании приложения на **FastAPI** есть атрибут `webhooks`, с помощью которого можно объявлять вебхуки так же, как вы объявляете операции пути (обработчики пути), например с `@app.webhooks.post()`.

-{* ../../docs_src/openapi_webhooks/tutorial001.py hl[9:13,36:53] *}
+{* ../../docs_src/openapi_webhooks/tutorial001_py39.py hl[9:13,36:53] *}

 Определенные вами вебхуки попадут в схему **OpenAPI** и в автоматический **интерфейс документации**.

@@ -12,7 +12,7 @@

 Нужно убедиться, что он уникален для каждой операции.

-{* ../../docs_src/path_operation_advanced_configuration/tutorial001.py hl[6] *}
+{* ../../docs_src/path_operation_advanced_configuration/tutorial001_py39.py hl[6] *}

 ### Использование имени функции-обработчика пути как operationId { #using-the-path-operation-function-name-as-the-operationid }

@@ -20,7 +20,7 @@

 Делать это следует после добавления всех *операций пути*.

-{* ../../docs_src/path_operation_advanced_configuration/tutorial002.py hl[2, 12:21, 24] *}
+{* ../../docs_src/path_operation_advanced_configuration/tutorial002_py39.py hl[2, 12:21, 24] *}

 /// tip | Совет

@@ -40,7 +40,7 @@

 Чтобы исключить *операцию пути* из генерируемой схемы OpenAPI (а значит, и из автоматической документации), используйте параметр `include_in_schema` и установите его в `False`:

-{* ../../docs_src/path_operation_advanced_configuration/tutorial003.py hl[6] *}
+{* ../../docs_src/path_operation_advanced_configuration/tutorial003_py39.py hl[6] *}

 ## Расширенное описание из docstring { #advanced-description-from-docstring }

@@ -50,7 +50,7 @@

 Эта часть не попадёт в документацию, но другие инструменты (например, Sphinx) смогут использовать остальное.

-{* ../../docs_src/path_operation_advanced_configuration/tutorial004.py hl[19:29] *}
+{* ../../docs_src/path_operation_advanced_configuration/tutorial004_py310.py hl[17:27] *}

 ## Дополнительные ответы { #additional-responses }

@@ -92,7 +92,7 @@

 `openapi_extra` может пригодиться, например, чтобы объявить [Расширения OpenAPI](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specificationExtensions):

-{* ../../docs_src/path_operation_advanced_configuration/tutorial005.py hl[6] *}
+{* ../../docs_src/path_operation_advanced_configuration/tutorial005_py39.py hl[6] *}

 Если вы откроете автоматическую документацию API, ваше расширение появится внизу страницы конкретной *операции пути*.

@@ -139,7 +139,7 @@

 Это можно сделать с помощью `openapi_extra`:

-{* ../../docs_src/path_operation_advanced_configuration/tutorial006.py hl[19:36, 39:40] *}
+{* ../../docs_src/path_operation_advanced_configuration/tutorial006_py39.py hl[19:36, 39:40] *}

 В этом примере мы не объявляли никакую Pydantic-модель. Фактически тело запроса даже не <abbr title="преобразовано из простого формата, например байтов, в объекты Python">распарсено</abbr> как JSON, оно читается напрямую как `bytes`, а функция `magic_data_reader()` будет отвечать за его парсинг каким-то способом.

@@ -155,13 +155,13 @@

 //// tab | Pydantic v2

-{* ../../docs_src/path_operation_advanced_configuration/tutorial007.py hl[17:22, 24] *}
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007_py39.py hl[15:20, 22] *}

 ////

 //// tab | Pydantic v1

-{* ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py hl[17:22, 24] *}
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1_py39.py hl[15:20, 22] *}

 ////

@@ -179,13 +179,13 @@

 //// tab | Pydantic v2

-{* ../../docs_src/path_operation_advanced_configuration/tutorial007.py hl[26:33] *}
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007_py39.py hl[24:31] *}

 ////

 //// tab | Pydantic v1

-{* ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py hl[26:33] *}
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1_py39.py hl[24:31] *}

 ////

@@ -20,7 +20,7 @@

 И затем вы можете установить `status_code` в этом *временном* объекте ответа.

-{* ../../docs_src/response_change_status_code/tutorial001.py hl[1,9,12] *}
+{* ../../docs_src/response_change_status_code/tutorial001_py39.py hl[1,9,12] *}

 После этого вы можете вернуть любой объект, который вам нужен, как обычно (`dict`, модель базы данных и т.д.).

@@ -6,7 +6,7 @@

 Затем установить cookies в этом временном объекте ответа.

-{* ../../docs_src/response_cookies/tutorial002.py hl[1, 8:9] *}
+{* ../../docs_src/response_cookies/tutorial002_py39.py hl[1, 8:9] *}

 После этого можно вернуть любой объект, как и раньше (например, `dict`, объект модели базы данных и так далее).

@@ -24,7 +24,7 @@

 Затем установите cookies и верните этот объект:

-{* ../../docs_src/response_cookies/tutorial001.py hl[10:12] *}
+{* ../../docs_src/response_cookies/tutorial001_py39.py hl[10:12] *}

 /// tip | Совет

@@ -34,7 +34,7 @@

 В таких случаях вы можете использовать `jsonable_encoder` для преобразования данных перед передачей их в ответ:

-{* ../../docs_src/response_directly/tutorial001.py hl[6:7,21:22] *}
+{* ../../docs_src/response_directly/tutorial001_py310.py hl[5:6,20:21] *}

 /// note | Технические детали

@@ -54,7 +54,7 @@

 Вы можете поместить ваш XML-контент в строку, поместить её в `Response` и вернуть:

-{* ../../docs_src/response_directly/tutorial002.py hl[1,18] *}
+{* ../../docs_src/response_directly/tutorial002_py39.py hl[1,18] *}

 ## Примечания { #notes }

@@ -6,7 +6,7 @@

 А затем вы можете устанавливать HTTP-заголовки в этом *временном* объекте ответа.

-{* ../../docs_src/response_headers/tutorial002.py hl[1, 7:8] *}
+{* ../../docs_src/response_headers/tutorial002_py39.py hl[1, 7:8] *}

 После этого вы можете вернуть любой нужный объект, как обычно (например, `dict`, модель из базы данных и т.д.).

@@ -22,7 +22,7 @@

 Создайте ответ, как описано в [Вернуть Response напрямую](response-directly.md){.internal-link target=_blank}, и передайте заголовки как дополнительный параметр:

-{* ../../docs_src/response_headers/tutorial001.py hl[10:12] *}
+{* ../../docs_src/response_headers/tutorial001_py39.py hl[10:12] *}

 /// note | Технические детали

@@ -62,7 +62,7 @@ $ pip install "fastapi[all]"

 //// tab | Pydantic v2

-{* ../../docs_src/settings/tutorial001.py hl[2,5:8,11] *}
+{* ../../docs_src/settings/tutorial001_py39.py hl[2,5:8,11] *}

 ////

@@ -74,7 +74,7 @@ $ pip install "fastapi[all]"

 ///

-{* ../../docs_src/settings/tutorial001_pv1.py hl[2,5:8,11] *}
+{* ../../docs_src/settings/tutorial001_pv1_py39.py hl[2,5:8,11] *}

 ////

@@ -92,7 +92,7 @@ $ pip install "fastapi[all]"

 Затем вы можете использовать новый объект `settings` в вашем приложении:

-{* ../../docs_src/settings/tutorial001.py hl[18:20] *}
+{* ../../docs_src/settings/tutorial001_py39.py hl[18:20] *}

 ### Запуск сервера { #run-the-server }

@@ -126,11 +126,11 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" fastapi run main.p

 Например, у вас может быть файл `config.py` со следующим содержимым:

-{* ../../docs_src/settings/app01/config.py *}
+{* ../../docs_src/settings/app01_py39/config.py *}

 А затем использовать его в файле `main.py`:

-{* ../../docs_src/settings/app01/main.py hl[3,11:13] *}
+{* ../../docs_src/settings/app01_py39/main.py hl[3,11:13] *}

 /// tip | Совет

@@ -148,7 +148,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" fastapi run main.p

 Продолжая предыдущий пример, ваш файл `config.py` может выглядеть так:

-{* ../../docs_src/settings/app02/config.py hl[10] *}
+{* ../../docs_src/settings/app02_an_py39/config.py hl[10] *}

 Обратите внимание, что теперь мы не создаем экземпляр по умолчанию `settings = Settings()`.

@@ -174,7 +174,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" fastapi run main.p

 Далее будет очень просто предоставить другой объект настроек во время тестирования, создав переопределение зависимости для `get_settings`:

-{* ../../docs_src/settings/app02/test_main.py hl[9:10,13,21] *}
+{* ../../docs_src/settings/app02_an_py39/test_main.py hl[9:10,13,21] *}

 В переопределении зависимости мы задаем новое значение `admin_email` при создании нового объекта `Settings`, а затем возвращаем этот новый объект.

@@ -217,7 +217,7 @@ APP_NAME="ChimichangApp"

 //// tab | Pydantic v2

-{* ../../docs_src/settings/app03_an/config.py hl[9] *}
+{* ../../docs_src/settings/app03_an_py39/config.py hl[9] *}

 /// tip | Совет

@@ -229,7 +229,7 @@ APP_NAME="ChimichangApp"

 //// tab | Pydantic v1

-{* ../../docs_src/settings/app03_an/config_pv1.py hl[9:10] *}
+{* ../../docs_src/settings/app03_an_py39/config_pv1.py hl[9:10] *}

 /// tip | Совет

@@ -10,7 +10,7 @@

 Сначала создайте основное, верхнего уровня, приложение **FastAPI** и его *операции пути*:

-{* ../../docs_src/sub_applications/tutorial001.py hl[3, 6:8] *}
+{* ../../docs_src/sub_applications/tutorial001_py39.py hl[3, 6:8] *}

 ### Подприложение { #sub-application }

@@ -18,7 +18,7 @@

 Это подприложение — обычное стандартное приложение FastAPI, но именно оно будет «смонтировано»:

-{* ../../docs_src/sub_applications/tutorial001.py hl[11, 14:16] *}
+{* ../../docs_src/sub_applications/tutorial001_py39.py hl[11, 14:16] *}

 ### Смонтируйте подприложение { #mount-the-sub-application }

@@ -26,7 +26,7 @@

 В этом случае оно будет смонтировано по пути `/subapi`:

-{* ../../docs_src/sub_applications/tutorial001.py hl[11, 19] *}
+{* ../../docs_src/sub_applications/tutorial001_py39.py hl[11, 19] *}

 ### Проверьте автоматическую документацию API { #check-the-automatic-api-docs }

@@ -27,7 +27,7 @@ $ pip install jinja2
 - Объявите параметр `Request` в *операции пути*, которая будет возвращать шаблон.
 - Используйте созданный `templates`, чтобы отрендерить и вернуть `TemplateResponse`; передайте имя шаблона, объект `request` и словарь «context» с парами ключ-значение для использования внутри шаблона Jinja2.

-{* ../../docs_src/templates/tutorial001.py hl[4,11,15:18] *}
+{* ../../docs_src/templates/tutorial001_py39.py hl[4,11,15:18] *}

 /// note | Примечание

@@ -2,11 +2,11 @@

 Если вам нужно, чтобы `lifespan` выполнялся в ваших тестах, вы можете использовать `TestClient` вместе с оператором `with`:

-{* ../../docs_src/app_testing/tutorial004.py hl[9:15,18,27:28,30:32,41:43] *}
+{* ../../docs_src/app_testing/tutorial004_py39.py hl[9:15,18,27:28,30:32,41:43] *}


 Вы можете узнать больше подробностей в статье [Запуск lifespan в тестах на официальном сайте документации Starlette.](https://www.starlette.dev/lifespan/#running-lifespan-in-tests)

 Для устаревших событий `startup` и `shutdown` вы можете использовать `TestClient` следующим образом:

-{* ../../docs_src/app_testing/tutorial003.py hl[9:12,20:24] *}
+{* ../../docs_src/app_testing/tutorial003_py39.py hl[9:12,20:24] *}
@@ -4,7 +4,7 @@

 Для этого используйте `TestClient` с менеджером контекста `with`, подключаясь к WebSocket:

-{* ../../docs_src/app_testing/tutorial002.py hl[27:31] *}
+{* ../../docs_src/app_testing/tutorial002_py39.py hl[27:31] *}

 /// note | Примечание

@@ -29,7 +29,7 @@

 Для этого нужно обратиться к запросу напрямую.

-{* ../../docs_src/using_request_directly/tutorial001.py hl[1,7:8] *}
+{* ../../docs_src/using_request_directly/tutorial001_py39.py hl[1,7:8] *}

 Если объявить параметр *функции-обработчика пути* с типом `Request`, **FastAPI** поймёт, что нужно передать объект `Request` в этот параметр.

@@ -38,13 +38,13 @@ $ pip install websockets

 Для примера нам нужен наиболее простой способ, который позволит сосредоточиться на серверной части веб‑сокетов и получить рабочий код:

-{* ../../docs_src/websockets/tutorial001.py hl[2,6:38,41:43] *}
+{* ../../docs_src/websockets/tutorial001_py39.py hl[2,6:38,41:43] *}

 ## Создание `websocket` { #create-a-websocket }

 Создайте `websocket` в своем **FastAPI** приложении:

-{* ../../docs_src/websockets/tutorial001.py hl[1,46:47] *}
+{* ../../docs_src/websockets/tutorial001_py39.py hl[1,46:47] *}

 /// note | Технические детали

@@ -58,7 +58,7 @@ $ pip install websockets

 Через эндпоинт веб-сокета вы можете получать и отправлять сообщения.

-{* ../../docs_src/websockets/tutorial001.py hl[48:52] *}
+{* ../../docs_src/websockets/tutorial001_py39.py hl[48:52] *}

 Вы можете получать и отправлять двоичные, текстовые и JSON данные.

@@ -12,7 +12,7 @@

 После этого смонтируйте его на путь.

-{* ../../docs_src/wsgi/tutorial001.py hl[2:3,3] *}
+{* ../../docs_src/wsgi/tutorial001_py39.py hl[2:3,3] *}

 ## Проверьте { #check-it }

@@ -4,11 +4,19 @@

 В большинстве случаев у основных облачных провайдеров есть руководства по развертыванию FastAPI на их платформе.

+## FastAPI Cloud { #fastapi-cloud }
+
+**<a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a>** создан тем же автором и командой, стоящими за **FastAPI**.
+
+Он упрощает процесс **создания образа**, **развертывания** и **доступа** к API с минимальными усилиями.
+
+Он переносит тот же **опыт разработчика** создания приложений с FastAPI на их **развертывание** в облаке. 🎉
+
+FastAPI Cloud — основной спонсор и источник финансирования для open source проектов *FastAPI and friends*. ✨
+
 ## Облачные провайдеры — спонсоры { #cloud-providers-sponsors }

-Некоторые облачные провайдеры ✨ [**спонсируют FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨ — это обеспечивает непрерывное и здоровое развитие FastAPI и его экосистемы.
-
-И это показывает их искреннюю приверженность FastAPI и его сообществу (вам): они не только хотят предоставить вам хороший сервис, но и стремятся гарантировать, что у вас будет хороший и стабильный фреймворк — FastAPI. 🙇
+Некоторые другие облачные провайдеры ✨ [**спонсируют FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨ тоже. 🙇

 Возможно, вы захотите попробовать их сервисы и воспользоваться их руководствами:

@@ -0,0 +1,65 @@
+# FastAPI Cloud { #fastapi-cloud }
+
+Вы можете развернуть своё приложение FastAPI в <a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a> одной командой, присоединяйтесь к списку ожидания, если ещё не сделали этого. 🚀
+
+## Вход { #login }
+
+Убедитесь, что у вас уже есть аккаунт **FastAPI Cloud** (мы пригласили вас из списка ожидания 😉).
+
+Затем выполните вход:
+
+<div class="termy">
+
+```console
+$ fastapi login
+
+You are logged in to FastAPI Cloud 🚀
+```
+
+</div>
+
+## Деплой { #deploy }
+
+Теперь разверните приложение одной командой:
+
+<div class="termy">
+
+```console
+$ fastapi deploy
+
+Deploying to FastAPI Cloud...
+
+✅ Deployment successful!
+
+🐔 Ready the chicken! Your app is ready at https://myapp.fastapicloud.dev
+```
+
+</div>
+
+Вот и всё! Теперь вы можете открыть своё приложение по этому URL. ✨
+
+## О FastAPI Cloud { #about-fastapi-cloud }
+
+**<a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a>** создан тем же автором и командой, что и **FastAPI**.
+
+Он упрощает процесс **создания образа**, **развертывания** и **доступа** к API с минимальными усилиями.
+
+Он переносит тот же **опыт разработчика**, что вы получаете при создании приложений на FastAPI, на их **развертывание** в облаке. 🎉
+
+Он также возьмёт на себя большинство вещей, которые требуются при развертывании приложения, например:
+
+* HTTPS
+* Репликация с автоматическим масштабированием на основе запросов
+* и т.д.
+
+FastAPI Cloud — основной спонсор и источник финансирования open source‑проектов «FastAPI и друзья». ✨
+
+## Развертывание у других облачных провайдеров { #deploy-to-other-cloud-providers }
+
+FastAPI — проект с открытым исходным кодом и основан на стандартах. Вы можете развернуть приложения FastAPI у любого облачного провайдера на ваш выбор.
+
+Следуйте руководствам вашего облачного провайдера, чтобы развернуть приложения FastAPI у них. 🤓
+
+## Развертывание на собственном сервере { #deploy-your-own-server }
+
+Позже в этом руководстве по **развертыванию** я также расскажу все детали — чтобы вы понимали, что происходит, что нужно сделать и как развернуть приложения FastAPI самостоятельно, в том числе на собственных серверах. 🤓
@@ -12,10 +12,12 @@

 ## Стратегии развёртывания { #deployment-strategies }

-В зависимости от вашего конкретного случая, есть несколько способов сделать это.
+Есть несколько способов сделать это, в зависимости от вашего конкретного случая и используемых вами инструментов.

 Вы можете **развернуть сервер** самостоятельно, используя различные инструменты. Например, можно использовать **облачный сервис**, который выполнит часть работы за вас. Также возможны и другие варианты.

+Например, мы, команда, стоящая за FastAPI, создали <a href="https://fastapicloud.com" class="external-link" target="_blank">**FastAPI Cloud**</a>, чтобы сделать развёртывание приложений FastAPI в облаке как можно более простым и прямолинейным, с тем же удобством для разработчика, что и при работе с FastAPI.
+
 В этом блоке я покажу вам некоторые из основных концепций, которые вы, вероятно, должны иметь в виду при развертывании приложения **FastAPI** (хотя большинство из них применимо к любому другому типу веб-приложений).

 В последующих разделах вы узнаете больше деталей и методов, необходимых для этого. ✨
@@ -0,0 +1,17 @@
+# Использование старых статус-кодов ошибок аутентификации 403 { #use-old-403-authentication-error-status-codes }
+
+До версии FastAPI `0.122.0`, когда встроенные утилиты безопасности возвращали ошибку клиенту после неудачной аутентификации, они использовали HTTP статус-код `403 Forbidden`.
+
+Начиная с версии FastAPI `0.122.0`, используется более подходящий HTTP статус-код `401 Unauthorized`, и в ответе возвращается имеющий смысл HTTP-заголовок `WWW-Authenticate` в соответствии со спецификациями HTTP, <a href="https://datatracker.ietf.org/doc/html/rfc7235#section-3.1" class="external-link" target="_blank">RFC 7235</a>, <a href="https://datatracker.ietf.org/doc/html/rfc9110#name-401-unauthorized" class="external-link" target="_blank">RFC 9110</a>.
+
+Но если по какой-то причине ваши клиенты зависят от старого поведения, вы можете вернуть его, переопределив метод `make_not_authenticated_error` в ваших Security-классах.
+
+Например, вы можете создать подкласс `HTTPBearer`, который будет возвращать ошибку `403 Forbidden` вместо стандартной `401 Unauthorized`:
+
+{* ../../docs_src/authentication_error_status_code/tutorial001_an_py39.py hl[9:13] *}
+
+/// tip | Совет
+
+Обратите внимание, что функция возвращает экземпляр исключения, не вызывает его. Выброс выполняется остальным внутренним кодом.
+
+///
@@ -29,7 +29,7 @@

 Например:

-{* ../../docs_src/conditional_openapi/tutorial001.py hl[6,11] *}
+{* ../../docs_src/conditional_openapi/tutorial001_py39.py hl[6,11] *}

 Здесь мы объявляем настройку `openapi_url` с тем же значением по умолчанию — `"/openapi.json"`.

@@ -18,7 +18,7 @@ FastAPI преобразует эти настройки в **JSON**, чтобы

 Но вы можете отключить её, установив `syntaxHighlight` в `False`:

-{* ../../docs_src/configure_swagger_ui/tutorial001.py hl[3] *}
+{* ../../docs_src/configure_swagger_ui/tutorial001_py39.py hl[3] *}

 …и после этого Swagger UI больше не будет показывать подсветку синтаксиса:

@@ -28,7 +28,7 @@ FastAPI преобразует эти настройки в **JSON**, чтобы

 Аналогично вы можете задать тему подсветки синтаксиса с ключом "syntaxHighlight.theme" (обратите внимание, что посередине стоит точка):

-{* ../../docs_src/configure_swagger_ui/tutorial002.py hl[3] *}
+{* ../../docs_src/configure_swagger_ui/tutorial002_py39.py hl[3] *}

 Эта настройка изменит цветовую тему подсветки синтаксиса:

@@ -40,13 +40,13 @@ FastAPI включает некоторые параметры конфигур

 Это включает следующие настройки по умолчанию:

-{* ../../fastapi/openapi/docs.py ln[8:23] hl[17:23] *}
+{* ../../fastapi/openapi/docs.py ln[9:24] hl[18:24] *}

 Вы можете переопределить любую из них, указав другое значение в аргументе `swagger_ui_parameters`.

 Например, чтобы отключить `deepLinking`, можно передать такие настройки в `swagger_ui_parameters`:

-{* ../../docs_src/configure_swagger_ui/tutorial003.py hl[3] *}
+{* ../../docs_src/configure_swagger_ui/tutorial003_py39.py hl[3] *}

 ## Другие параметры Swagger UI { #other-swagger-ui-parameters }

@@ -18,7 +18,7 @@

 Чтобы отключить её, установите их URL в значение `None` при создании вашего приложения `FastAPI`:

-{* ../../docs_src/custom_docs_ui/tutorial001.py hl[8] *}
+{* ../../docs_src/custom_docs_ui/tutorial001_py39.py hl[8] *}

 ### Подключить пользовательскую документацию { #include-the-custom-docs }

@@ -34,7 +34,7 @@

 Аналогично и для ReDoc...

-{* ../../docs_src/custom_docs_ui/tutorial001.py hl[2:6,11:19,22:24,27:33] *}
+{* ../../docs_src/custom_docs_ui/tutorial001_py39.py hl[2:6,11:19,22:24,27:33] *}

 /// tip | Совет

@@ -50,7 +50,7 @@ Swagger UI сделает это за вас «за кулисами», но д

 Чтобы убедиться, что всё работает, создайте *операцию пути*:

-{* ../../docs_src/custom_docs_ui/tutorial001.py hl[36:38] *}
+{* ../../docs_src/custom_docs_ui/tutorial001_py39.py hl[36:38] *}

 ### Тестирование { #test-it }

@@ -118,7 +118,7 @@ Swagger UI сделает это за вас «за кулисами», но д
 * Импортируйте `StaticFiles`.
 * Смонтируйте экземпляр `StaticFiles()` в определённый путь.

-{* ../../docs_src/custom_docs_ui/tutorial002.py hl[7,11] *}
+{* ../../docs_src/custom_docs_ui/tutorial002_py39.py hl[7,11] *}

 ### Протестируйте статические файлы { #test-the-static-files }

@@ -144,7 +144,7 @@ Swagger UI сделает это за вас «за кулисами», но д

 Чтобы отключить её, установите их URL в значение `None` при создании вашего приложения `FastAPI`:

-{* ../../docs_src/custom_docs_ui/tutorial002.py hl[9] *}
+{* ../../docs_src/custom_docs_ui/tutorial002_py39.py hl[9] *}

 ### Подключить пользовательскую документацию со статическими файлами { #include-the-custom-docs-for-static-files }

@@ -160,7 +160,7 @@ Swagger UI сделает это за вас «за кулисами», но д

 Аналогично и для ReDoc...

-{* ../../docs_src/custom_docs_ui/tutorial002.py hl[2:6,14:22,25:27,30:36] *}
+{* ../../docs_src/custom_docs_ui/tutorial002_py39.py hl[2:6,14:22,25:27,30:36] *}

 /// tip | Совет

@@ -176,7 +176,7 @@ Swagger UI сделает это за вас «за кулисами», но д

 Чтобы убедиться, что всё работает, создайте *операцию пути*:

-{* ../../docs_src/custom_docs_ui/tutorial002.py hl[39:41] *}
+{* ../../docs_src/custom_docs_ui/tutorial002_py39.py hl[39:41] *}

 ### Тестирование UI со статическими файлами { #test-static-files-ui }

@@ -42,7 +42,7 @@

 Таким образом, один и тот же класс маршрута сможет обрабатывать как gzip-сжатые, так и несжатые запросы.

-{* ../../docs_src/custom_request_and_route/tutorial001.py hl[8:15] *}
+{* ../../docs_src/custom_request_and_route/tutorial001_an_py310.py hl[9:16] *}

 ### Создать пользовательский класс `GzipRoute` { #create-a-custom-gziproute-class }

@@ -54,7 +54,7 @@

 Здесь мы используем её, чтобы создать `GzipRequest` из исходного HTTP-запроса.

-{* ../../docs_src/custom_request_and_route/tutorial001.py hl[18:26] *}
+{* ../../docs_src/custom_request_and_route/tutorial001_an_py310.py hl[19:27] *}

 /// note | Технические детали

@@ -92,18 +92,18 @@

 Нужно лишь обработать запрос внутри блока `try`/`except`:

-{* ../../docs_src/custom_request_and_route/tutorial002.py hl[13,15] *}
+{* ../../docs_src/custom_request_and_route/tutorial002_an_py310.py hl[14,16] *}

 Если произойдёт исключение, экземпляр `Request` всё ещё будет в области видимости, поэтому мы сможем прочитать тело запроса и использовать его при обработке ошибки:

-{* ../../docs_src/custom_request_and_route/tutorial002.py hl[16:18] *}
+{* ../../docs_src/custom_request_and_route/tutorial002_an_py310.py hl[17:19] *}

 ## Пользовательский класс `APIRoute` в роутере { #custom-apiroute-class-in-a-router }

 Вы также можете задать параметр `route_class` у `APIRouter`:

-{* ../../docs_src/custom_request_and_route/tutorial003.py hl[26] *}
+{* ../../docs_src/custom_request_and_route/tutorial003_py310.py hl[26] *}

 В этом примере *операции пути*, объявленные в `router`, будут использовать пользовательский класс `TimedRoute` и получат дополнительный HTTP-заголовок `X-Response-Time` в ответе с временем, затраченным на формирование ответа:

-{* ../../docs_src/custom_request_and_route/tutorial003.py hl[13:20] *}
+{* ../../docs_src/custom_request_and_route/tutorial003_py310.py hl[13:20] *}
@@ -43,19 +43,19 @@

 Сначала напишите приложение **FastAPI** как обычно:

-{* ../../docs_src/extending_openapi/tutorial001.py hl[1,4,7:9] *}
+{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[1,4,7:9] *}

 ### Сгенерируйте схему OpenAPI { #generate-the-openapi-schema }

 Затем используйте ту же вспомогательную функцию для генерации схемы OpenAPI внутри функции `custom_openapi()`:

-{* ../../docs_src/extending_openapi/tutorial001.py hl[2,15:21] *}
+{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[2,15:21] *}

 ### Измените схему OpenAPI { #modify-the-openapi-schema }

 Теперь можно добавить расширение ReDoc, добавив кастомный `x-logo` в «объект» `info` в схеме OpenAPI:

-{* ../../docs_src/extending_openapi/tutorial001.py hl[22:24] *}
+{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[22:24] *}

 ### Кэшируйте схему OpenAPI { #cache-the-openapi-schema }

@@ -65,13 +65,13 @@

 Она будет создана один раз, а затем тот же кэшированный вариант будет использоваться для последующих запросов.

-{* ../../docs_src/extending_openapi/tutorial001.py hl[13:14,25:26] *}
+{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[13:14,25:26] *}

 ### Переопределите метод { #override-the-method }

 Теперь вы можете заменить метод `.openapi()` на вашу новую функцию.

-{* ../../docs_src/extending_openapi/tutorial001.py hl[29] *}
+{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[29] *}

 ### Проверьте { #check-it }

@@ -35,7 +35,7 @@

 Вот небольшой пример того, как можно интегрировать Strawberry с FastAPI:

-{* ../../docs_src/graphql/tutorial001.py hl[3,22,25] *}
+{* ../../docs_src/graphql_/tutorial001_py39.py hl[3,22,25] *}

 Подробнее о Strawberry можно узнать в <a href="https://strawberry.rocks/" class="external-link" target="_blank">документации Strawberry</a>.

@@ -52,14 +52,20 @@ FastAPI — это современный, быстрый (высокопрои

 <!-- sponsors -->

-{% if sponsors %}
+### Ключевой-спонсор { #keystone-sponsor }
+
+{% for sponsor in sponsors.keystone -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor -%}
+
+### Золотые и серебряные спонсоры { #gold-and-silver-sponsors }
+
 {% for sponsor in sponsors.gold -%}
 <a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
 {% endfor -%}
 {%- for sponsor in sponsors.silver -%}
 <a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
 {% endfor %}
-{% endif %}

 <!-- /sponsors -->

@@ -444,6 +450,58 @@ item: Item
    * **сессии с использованием cookie**
    * ...и многое другое.

+### Разверните приложение (опционально) { #deploy-your-app-optional }
+
+При желании вы можете развернуть своё приложение FastAPI в <a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a>, присоединяйтесь к списку ожидания, если ещё не сделали этого. 🚀
+
+Если у вас уже есть аккаунт **FastAPI Cloud** (мы пригласили вас из списка ожидания 😉), вы можете развернуть ваше приложение одной командой.
+
+Перед развертыванием убедитесь, что вы вошли в систему:
+
+<div class="termy">
+
+```console
+$ fastapi login
+
+You are logged in to FastAPI Cloud 🚀
+```
+
+</div>
+
+Затем разверните приложение:
+
+<div class="termy">
+
+```console
+$ fastapi deploy
+
+Deploying to FastAPI Cloud...
+
+✅ Deployment successful!
+
+🐔 Ready the chicken! Your app is ready at https://myapp.fastapicloud.dev
+```
+
+</div>
+
+Вот и всё! Теперь вы можете открыть ваше приложение по этой ссылке. ✨
+
+#### О FastAPI Cloud { #about-fastapi-cloud }
+
+**<a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a>** создан тем же автором и командой, что и **FastAPI**.
+
+Он упрощает процесс **создания образа**, **развертывания** и **доступа** к API при минимальных усилиях.
+
+Он переносит тот же **опыт разработчика**, что и при создании приложений на FastAPI, на их **развертывание** в облаке. 🎉
+
+FastAPI Cloud — основной спонсор и источник финансирования для проектов с открытым исходным кодом из экосистемы *FastAPI and friends*. ✨
+
+#### Развертывание у других облачных провайдеров { #deploy-to-other-cloud-providers }
+
+FastAPI — это open source и стандартизированный фреймворк. Вы можете развернуть приложения FastAPI у любого облачного провайдера на ваш выбор.
+
+Следуйте руководствам вашего облачного провайдера по развертыванию приложений FastAPI. 🤓
+
 ## Производительность { #performance }

 Независимые бенчмарки TechEmpower показывают приложения **FastAPI**, работающие под управлением Uvicorn, как <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank">один из самых быстрых доступных фреймворков Python</a>, уступающий только самим Starlette и Uvicorn (используются внутри FastAPI). (*)
@@ -13,8 +13,8 @@
    - 🔍 [Pydantic](https://docs.pydantic.dev), используется FastAPI, для валидации данных и управления настройками.
    - 💾 [PostgreSQL](https://www.postgresql.org) в качестве SQL‑базы данных.
 - 🚀 [React](https://react.dev) для фронтенда.
-    - 💃 Используются TypeScript, хуки, [Vite](https://vitejs.dev) и другие части современного фронтенд‑стека.
-    - 🎨 [Chakra UI](https://chakra-ui.com) для компонентов фронтенда.
+    - 💃 Используются TypeScript, хуки, Vite и другие части современного фронтенд‑стека.
+    - 🎨 [Tailwind CSS](https://tailwindcss.com) и [shadcn/ui](https://ui.shadcn.com) для компонентов фронтенда.
    - 🤖 Автоматически сгенерированный фронтенд‑клиент.
    - 🧪 [Playwright](https://playwright.dev) для End‑to‑End тестирования.
    - 🦇 Поддержка тёмной темы.
@@ -22,7 +22,7 @@ Python поддерживает необязательные «подсказк

 Давайте начнем с простого примера:

-{* ../../docs_src/python_types/tutorial001.py *}
+{* ../../docs_src/python_types/tutorial001_py39.py *}

 Вызов этой программы выводит:

@@ -36,7 +36,7 @@ John Doe
 * Преобразует первую букву каждого значения в верхний регистр с помощью `title()`.
 * <abbr title="Объединяет в одно целое. Содержимое одного — сразу после другого.">Соединяет</abbr> их пробелом посередине.

-{* ../../docs_src/python_types/tutorial001.py hl[2] *}
+{* ../../docs_src/python_types/tutorial001_py39.py hl[2] *}

 ### Отредактируем пример { #edit-it }

@@ -78,7 +78,7 @@ John Doe

 Это и есть «подсказки типов»:

-{* ../../docs_src/python_types/tutorial002.py hl[1] *}
+{* ../../docs_src/python_types/tutorial002_py39.py hl[1] *}

 Это не то же самое, что объявление значений по умолчанию, как, например:

@@ -106,7 +106,7 @@ John Doe

 Посмотрите на эту функцию — у неё уже есть подсказки типов:

-{* ../../docs_src/python_types/tutorial003.py hl[1] *}
+{* ../../docs_src/python_types/tutorial003_py39.py hl[1] *}

 Так как редактор кода знает типы переменных, вы получаете не только автозавершение, но и проверки ошибок:

@@ -114,7 +114,7 @@ John Doe

 Теперь вы знаете, что нужно исправить — преобразовать `age` в строку с помощью `str(age)`:

-{* ../../docs_src/python_types/tutorial004.py hl[2] *}
+{* ../../docs_src/python_types/tutorial004_py39.py hl[2] *}

 ## Объявление типов { #declaring-types }

@@ -133,7 +133,7 @@ John Doe
 * `bool`
 * `bytes`

-{* ../../docs_src/python_types/tutorial005.py hl[1] *}
+{* ../../docs_src/python_types/tutorial005_py39.py hl[1] *}

 ### Generic-типы с параметрами типов { #generic-types-with-type-parameters }

@@ -161,56 +161,24 @@ John Doe

 Например, давайте определим переменную как `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!}
-```
-
-////
+{* ../../docs_src/python_types/tutorial006_py39.py hl[1] *}

 /// info | Информация

 Эти внутренние типы в квадратных скобках называются «параметрами типов».

-В данном случае `str` — это параметр типа, передаваемый в `List` (или `list` в Python 3.9 и выше).
+В данном случае `str` — это параметр типа, передаваемый в `list`.

 ///

 Это означает: «переменная `items` — это `list`, и каждый элемент этого списка — `str`».

-/// tip | Совет
-
-Если вы используете Python 3.9 или выше, вам не нужно импортировать `List` из `typing`, можно использовать обычный встроенный тип `list`.
-
-///
-
 Таким образом, ваш редактор кода сможет помогать даже при обработке элементов списка:

 <img src="/img/python-types/image05.png">
@@ -225,21 +193,7 @@ John Doe

 Аналогично вы бы объявили `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!}
-```
-
-////
+{* ../../docs_src/python_types/tutorial007_py39.py hl[1] *}

 Это означает:

@@ -254,21 +208,7 @@ John Doe

 Второй параметр типа — для значений `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!}
-```
-
-////
+{* ../../docs_src/python_types/tutorial008_py39.py hl[1] *}

 Это означает:

@@ -292,10 +232,10 @@ John Doe

 ////

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python hl_lines="1  4"
-{!> ../../docs_src/python_types/tutorial008b.py!}
+{!> ../../docs_src/python_types/tutorial008b_py39.py!}
 ```

 ////
@@ -309,7 +249,7 @@ John Doe
 В Python 3.6 и выше (включая Python 3.10) это можно объявить, импортировав и используя `Optional` из модуля `typing`.

 ```Python hl_lines="1  4"
-{!../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009_py39.py!}
 ```

 Использование `Optional[str]` вместо просто `str` позволит редактору кода помочь вам обнаружить ошибки, когда вы предполагаете, что значение всегда `str`, хотя на самом деле оно может быть и `None`.
@@ -326,18 +266,18 @@ John Doe

 ////

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python hl_lines="1  4"
-{!> ../../docs_src/python_types/tutorial009.py!}
+{!> ../../docs_src/python_types/tutorial009_py39.py!}
 ```

 ////

-//// tab | Python 3.8+ альтернативный вариант
+//// tab | Python 3.9+ альтернативный вариант

 ```Python hl_lines="1  4"
-{!> ../../docs_src/python_types/tutorial009b.py!}
+{!> ../../docs_src/python_types/tutorial009b_py39.py!}
 ```

 ////
@@ -357,7 +297,7 @@ John Doe

 В качестве примера возьмём эту функцию:

-{* ../../docs_src/python_types/tutorial009c.py hl[1,4] *}
+{* ../../docs_src/python_types/tutorial009c_py39.py hl[1,4] *}

 Параметр `name` определён как `Optional[str]`, но он **не необязательный** — вы не можете вызвать функцию без этого параметра:

@@ -390,10 +330,10 @@ say_hi(name=None)  # Это работает, None допустим 🎉
 * `set`
 * `dict`

-И, как и в Python 3.8, из модуля `typing`:
+И, как и в предыдущих версиях Python, из модуля `typing`:

 * `Union`
-* `Optional` (так же, как в Python 3.8)
+* `Optional`
 * ...и другие.

 В Python 3.10, как альтернативу generics `Union` и `Optional`, можно использовать <abbr title='также называется «побитовый оператор OR», но это значение здесь нерелевантно'>вертикальную черту (`|`)</abbr> для объявления объединений типов — это гораздо лучше и проще.
@@ -409,7 +349,7 @@ say_hi(name=None)  # Это работает, None допустим 🎉
 * `set`
 * `dict`

-И, как и в Python 3.8, из модуля `typing`:
+И generics из модуля `typing`:

 * `Union`
 * `Optional`
@@ -417,29 +357,17 @@ say_hi(name=None)  # Это работает, None допустим 🎉

 ////

-//// tab | Python 3.8+
-
-* `List`
-* `Tuple`
-* `Set`
-* `Dict`
-* `Union`
-* `Optional`
-* ...и другие.
-
-////
-
 ### Классы как типы { #classes-as-types }

 Вы также можете объявлять класс как тип переменной.

 Допустим, у вас есть класс `Person` с именем:

-{* ../../docs_src/python_types/tutorial010.py hl[1:3] *}
+{* ../../docs_src/python_types/tutorial010_py39.py hl[1:3] *}

 Тогда вы можете объявить переменную типа `Person`:

-{* ../../docs_src/python_types/tutorial010.py hl[6] *}
+{* ../../docs_src/python_types/tutorial010_py39.py hl[6] *}

 И снова вы получите полную поддержку редактора кода:

@@ -463,29 +391,7 @@ say_hi(name=None)  # Это работает, None допустим 🎉

 Пример из официальной документации 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!}
-```
-
-////
+{* ../../docs_src/python_types/tutorial011_py310.py *}

 /// info | Информация

@@ -507,27 +413,9 @@ say_hi(name=None)  # Это работает, None допустим 🎉

 В Python также есть возможность добавлять **дополнительные <abbr title="Данные о данных, в данном случае — информация о типе, например описание.">метаданные</abbr>** к подсказкам типов с помощью `Annotated`.

-//// tab | Python 3.9+
+Начиная с Python 3.9, `Annotated` входит в стандартную библиотеку, поэтому вы можете импортировать его из `typing`.

-В Python 3.9 `Annotated` входит в стандартную библиотеку, поэтому вы можете импортировать его из `typing`.
-
-```Python hl_lines="1  4"
-{!> ../../docs_src/python_types/tutorial013_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-В версиях ниже Python 3.9 импортируйте `Annotated` из `typing_extensions`.
-
-Он уже будет установлен вместе с **FastAPI**.
-
-```Python hl_lines="1  4"
-{!> ../../docs_src/python_types/tutorial013.py!}
-```
-
-////
+{* ../../docs_src/python_types/tutorial013_py39.py hl[1,4] *}

 Сам Python ничего не делает с `Annotated`. А для редакторов кода и других инструментов тип по-прежнему `str`.

@@ -558,7 +446,7 @@ say_hi(name=None)  # Это работает, None допустим 🎉

 ...и **FastAPI** использует эти же объявления для:

-* **Определения требований**: из path-параметров, query-параметров, HTTP-заголовков, тел запросов, зависимостей и т.д.
+* **Определения требований**: из path-параметров пути запроса, query-параметров, HTTP-заголовков, тел запросов, зависимостей и т.д.
 * **Преобразования данных**: из HTTP-запроса к требуемому типу.
 * **Валидации данных**: приходящих с каждого HTTP-запроса:
    * Генерации **автоматических ошибок**, возвращаемых клиенту, когда данные некорректны.
@@ -1,3 +1,3 @@
 # Ресурсы { #resources }

-Дополнительные ресурсы, внешние ссылки, статьи и многое другое. ✈️
+Дополнительные ресурсы, внешние ссылки и многое другое. ✈️
@@ -15,7 +15,7 @@

 Сначала импортируйте `BackgroundTasks` и объявите параметр в вашей функции‑обработчике пути с типом `BackgroundTasks`:

-{* ../../docs_src/background_tasks/tutorial001.py hl[1,13] *}
+{* ../../docs_src/background_tasks/tutorial001_py39.py hl[1,13] *}

 **FastAPI** создаст объект типа `BackgroundTasks` для вас и передаст его через этот параметр.

@@ -31,13 +31,13 @@

 Так как операция записи не использует `async` и `await`, мы определим функцию как обычную `def`:

-{* ../../docs_src/background_tasks/tutorial001.py hl[6:9] *}
+{* ../../docs_src/background_tasks/tutorial001_py39.py hl[6:9] *}

 ## Добавление фоновой задачи { #add-the-background-task }

 Внутри вашей функции‑обработчика пути передайте функцию задачи объекту фоновых задач методом `.add_task()`:

-{* ../../docs_src/background_tasks/tutorial001.py hl[14] *}
+{* ../../docs_src/background_tasks/tutorial001_py39.py hl[14] *}

 `.add_task()` принимает следующие аргументы:

@@ -85,17 +85,13 @@ from app.routers import items

 Точно также, как и в случае с классом `FastAPI`, вам нужно импортировать и создать объект класса `APIRouter`.

-```Python hl_lines="1  3" title="app/routers/users.py"
-{!../../docs_src/bigger_applications/app/routers/users.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/routers/users.py hl[1,3] title["app/routers/users.py"] *}

 ### Создание *эндпоинтов* с помощью `APIRouter` { #path-operations-with-apirouter }

 В дальнейшем используйте `APIRouter` для объявления *эндпоинтов*, точно также, как вы используете класс `FastAPI`:

-```Python hl_lines="6  11  16" title="app/routers/users.py"
-{!../../docs_src/bigger_applications/app/routers/users.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/routers/users.py hl[6,11,16] title["app/routers/users.py"] *}

 Вы можете думать об `APIRouter` как об "уменьшенной версии" класса FastAPI`.

@@ -119,35 +115,7 @@ from app.routers import items

 Теперь мы воспользуемся простой зависимостью, чтобы прочитать кастомизированный `X-Token` из заголовка:

-//// tab | Python 3.9+
-
-```Python hl_lines="3  6-8" title="app/dependencies.py"
-{!> ../../docs_src/bigger_applications/app_an_py39/dependencies.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="1  5-7" title="app/dependencies.py"
-{!> ../../docs_src/bigger_applications/app_an/dependencies.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip | Подсказка
-
-Мы рекомендуем использовать версию `Annotated`, когда это возможно.
-
-///
-
-```Python hl_lines="1  4-6" title="app/dependencies.py"
-{!> ../../docs_src/bigger_applications/app/dependencies.py!}
-```
-
-////
+{* ../../docs_src/bigger_applications/app_an_py39/dependencies.py hl[3,6:8] title["app/dependencies.py"] *}

 /// tip | Подсказка

@@ -180,9 +148,7 @@ from app.routers import items
 Таким образом, вместо того чтобы добавлять все эти свойства в функцию каждого отдельного *эндпоинта*,
 мы добавим их в `APIRouter`.

-```Python hl_lines="5-10  16  21" title="app/routers/items.py"
-{!../../docs_src/bigger_applications/app/routers/items.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/routers/items.py hl[5:10,16,21] title["app/routers/items.py"] *}

 Так как каждый *эндпоинт* начинается с символа `/`:

@@ -241,9 +207,7 @@ async def read_item(item_id: str):

 Мы используем операцию относительного импорта `..` для импорта зависимости:

-```Python hl_lines="3" title="app/routers/items.py"
-{!../../docs_src/bigger_applications/app/routers/items.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/routers/items.py hl[3] title["app/routers/items.py"] *}

 #### Как работает относительный импорт? { #how-relative-imports-work }

@@ -313,9 +277,7 @@ from ...dependencies import get_token_header

 Но помимо этого мы можем добавить новые теги для каждого отдельного *эндпоинта*, а также некоторые дополнительные ответы (`responses`), характерные для данного *эндпоинта*:

-```Python hl_lines="30-31" title="app/routers/items.py"
-{!../../docs_src/bigger_applications/app/routers/items.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/routers/items.py hl[30:31] title["app/routers/items.py"] *}

 /// tip | Подсказка

@@ -341,17 +303,13 @@ from ...dependencies import get_token_header

 Мы даже можем объявить [глобальные зависимости](dependencies/global-dependencies.md){.internal-link target=_blank}, которые будут объединены с зависимостями для каждого отдельного маршрутизатора:

-```Python hl_lines="1  3  7" title="app/main.py"
-{!../../docs_src/bigger_applications/app/main.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/main.py hl[1,3,7] title["app/main.py"] *}

 ### Импорт `APIRouter` { #import-the-apirouter }

 Теперь мы импортируем другие суб-модули, содержащие `APIRouter`:

-```Python hl_lines="4-5" title="app/main.py"
-{!../../docs_src/bigger_applications/app/main.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/main.py hl[4:5] title["app/main.py"] *}

 Так как файлы `app/routers/users.py` и `app/routers/items.py` являются суб-модулями одного и того же Python-пакета `app`, то мы сможем их импортировать, воспользовавшись операцией относительного импорта `.`.

@@ -414,17 +372,13 @@ from .routers.users import router

 Поэтому, для того чтобы использовать обе эти переменные в одном файле, мы импортировали соответствующие суб-модули:

-```Python hl_lines="5" title="app/main.py"
-{!../../docs_src/bigger_applications/app/main.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/main.py hl[5] title["app/main.py"] *}

 ### Подключение маршрутизаторов (`APIRouter`) для `users` и для `items` { #include-the-apirouters-for-users-and-items }

 Давайте подключим маршрутизаторы (`router`) из суб-модулей `users` и `items`:

-```Python hl_lines="10-11" title="app/main.py"
-{!../../docs_src/bigger_applications/app/main.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/main.py hl[10:11] title["app/main.py"] *}

 /// info | Примечание

@@ -465,17 +419,13 @@ from .routers.users import router
 В данном примере это сделать очень просто. Но давайте предположим, что поскольку файл используется для нескольких проектов,
 то мы не можем модифицировать его, добавляя префиксы (`prefix`), зависимости (`dependencies`), теги (`tags`), и т.д. непосредственно в `APIRouter`:

-```Python hl_lines="3" title="app/internal/admin.py"
-{!../../docs_src/bigger_applications/app/internal/admin.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/internal/admin.py hl[3] title["app/internal/admin.py"] *}

 Но, несмотря на это, мы хотим использовать кастомный префикс (`prefix`) для подключенного маршрутизатора (`APIRouter`), в результате чего, каждая *операция пути* будет начинаться с `/admin`. Также мы хотим защитить наш маршрутизатор с помощью зависимостей, созданных для нашего проекта. И ещё мы хотим включить теги (`tags`) и ответы (`responses`).

 Мы можем применить все вышеперечисленные настройки, не изменяя начальный `APIRouter`. Нам всего лишь нужно передать нужные параметры в `app.include_router()`.

-```Python hl_lines="14-17" title="app/main.py"
-{!../../docs_src/bigger_applications/app/main.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/main.py hl[14:17] title["app/main.py"] *}

 Таким образом, оригинальный `APIRouter` не будет модифицирован, и мы сможем использовать файл `app/internal/admin.py` сразу в нескольких проектах организации.

@@ -496,9 +446,7 @@ from .routers.users import router

 Здесь мы это делаем ... просто, чтобы показать, что это возможно 🤷:

-```Python hl_lines="21-23" title="app/main.py"
-{!../../docs_src/bigger_applications/app/main.py!}
-```
+{* ../../docs_src/bigger_applications/app_an_py39/main.py hl[21:23] title["app/main.py"] *}

 и это будет работать корректно вместе с другими *эндпоинтами*, добавленными с помощью `app.include_router()`.

@@ -14,35 +14,14 @@

 В Python есть специальный способ объявлять списки с внутренними типами, или «параметрами типа»:

-### Импортируйте `List` из модуля typing { #import-typings-list }
-
-В Python 3.9 и выше вы можете использовать стандартный тип `list` для объявления аннотаций типов, как мы увидим ниже. 💡
-
-Но в версиях Python до 3.9 (начиная с 3.6) сначала вам необходимо импортировать `List` из стандартного модуля `typing`:
-
-{* ../../docs_src/body_nested_models/tutorial002.py hl[1] *}
-
 ### Объявите `list` с параметром типа { #declare-a-list-with-a-type-parameter }

-Для объявления типов, у которых есть параметры типа (внутренние типы), таких как `list`, `dict`, `tuple`:
-
-* Если у вас Python версии ниже 3.9, импортируйте их аналоги из модуля `typing`
-* Передайте внутренний(ие) тип(ы) как «параметры типа», используя квадратные скобки: `[` и `]`
-
-В Python 3.9 это будет:
+Для объявления типов, у которых есть параметры типа (внутренние типы), таких как `list`, `dict`, `tuple`, передайте внутренний(ие) тип(ы) как «параметры типа», используя квадратные скобки: `[` и `]`

 ```Python
 my_list: list[str]
 ```

-В версиях Python до 3.9 это будет:
-
-```Python
-from typing import List
-
-my_list: List[str]
-```
-
 Это всё стандартный синтаксис Python для объявления типов.

 Используйте этот же стандартный синтаксис для атрибутов модели с внутренними типами.
@@ -107,7 +86,7 @@ my_list: List[str]

 Ещё раз: сделав такое объявление, с помощью **FastAPI** вы получите:

-* Поддержку редактора кода (автозавершение и т. д.), даже для вложенных моделей
+* Поддержку редактора кода (автозавершение и т.д.), даже для вложенных моделей
 * Преобразование данных
 * Валидацию данных
 * Автоматическую документацию
@@ -178,12 +157,6 @@ my_list: List[str]

 Если верхний уровень значения тела JSON-объекта представляет собой JSON `array` (в Python — `list`), вы можете объявить тип в параметре функции, так же как в моделях Pydantic:

-```Python
-images: List[Image]
-```
-
-или в Python 3.9 и выше:
-
 ```Python
 images: list[Image]
 ```
@@ -161,7 +161,7 @@ JSON Schema ваших моделей будет частью сгенериро

 FastAPI понимает, что значение `q` не является обязательным из-за значения по умолчанию `= None`.

-Аннотации типов `str | None` (Python 3.10+) или `Union[str, None]` (Python 3.8+) не используются FastAPI для определения обязательности; он узнает, что параметр не обязателен, потому что у него есть значение по умолчанию `= None`.
+Аннотации типов `str | None` (Python 3.10+) или `Union[str, None]` (Python 3.9+) не используются FastAPI для определения обязательности; он узнает, что параметр не обязателен, потому что у него есть значение по умолчанию `= None`.

 Но добавление аннотаций типов позволит вашему редактору кода лучше вас поддерживать и обнаруживать ошибки.

@@ -50,7 +50,7 @@

 Вы можете сконфигурировать Pydantic-модель так, чтобы запретить (`forbid`) любые дополнительные (`extra`) поля:

-{* ../../docs_src/cookie_param_models/tutorial002_an_py39.py hl[10] *}
+{* ../../docs_src/cookie_param_models/tutorial002_an_py310.py hl[10] *}

 Если клиент попробует отправить **дополнительные cookies**, то в ответ он получит **ошибку**.

@@ -46,7 +46,7 @@
 * Отдельных HTTP-методов (`POST`, `PUT`) или всех вместе, используя `"*"`.
 * Отдельных HTTP-заголовков или всех вместе, используя `"*"`.

-{* ../../docs_src/cors/tutorial001.py hl[2,6:11,13:19] *}
+{* ../../docs_src/cors/tutorial001_py39.py hl[2,6:11,13:19] *}

 `CORSMiddleware` использует "запрещающие" значения по умолчанию, поэтому вам нужно явным образом разрешить использование отдельных источников, методов или заголовков, чтобы браузеры могли использовать их в кросс-доменном контексте.

@@ -6,7 +6,7 @@

 В вашем FastAPI приложении, импортируйте и вызовите `uvicorn` напрямую:

-{* ../../docs_src/debugging/tutorial001.py hl[1,15] *}
+{* ../../docs_src/debugging/tutorial001_py39.py hl[1,15] *}

 ### Описание `__name__ == "__main__"` { #about-name-main }

@@ -101,7 +101,7 @@ fluffy = Cat(name="Mr Fluffy")

 Обратите внимание, что в приведенном выше коде мы два раза пишем `CommonQueryParams`:

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python
 commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
@@ -109,7 +109,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]

 ////

-//// tab | Python 3.8+ non-Annotated
+//// tab | Python 3.9+ non-Annotated

 /// tip | Подсказка

@@ -137,7 +137,7 @@ commons: CommonQueryParams = Depends(CommonQueryParams)

 В этом случае первый `CommonQueryParams`, в:

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python
 commons: Annotated[CommonQueryParams, ...
@@ -145,7 +145,7 @@ commons: Annotated[CommonQueryParams, ...

 ////

-//// tab | Python 3.8+ non-Annotated
+//// tab | Python 3.9+ non-Annotated

 /// tip | Подсказка

@@ -163,7 +163,7 @@ commons: CommonQueryParams ...

 На самом деле можно написать просто:

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python
 commons: Annotated[Any, Depends(CommonQueryParams)]
@@ -171,7 +171,7 @@ commons: Annotated[Any, Depends(CommonQueryParams)]

 ////

-//// tab | Python 3.8+ non-Annotated
+//// tab | Python 3.9+ non-Annotated

 /// tip | Подсказка

@@ -197,7 +197,7 @@ commons = Depends(CommonQueryParams)

 Но вы видите, что здесь мы имеем некоторое повторение кода, дважды написав `CommonQueryParams`:

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python
 commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
@@ -205,7 +205,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]

 ////

-//// tab | Python 3.8+ non-Annotated
+//// tab | Python 3.9+ non-Annotated

 /// tip | Подсказка

@@ -225,7 +225,7 @@ commons: CommonQueryParams = Depends(CommonQueryParams)

 Вместо того чтобы писать:

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python
 commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
@@ -233,7 +233,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]

 ////

-//// tab | Python 3.8+ non-Annotated
+//// tab | Python 3.9+ non-Annotated

 /// tip | Подсказка

@@ -249,7 +249,7 @@ commons: CommonQueryParams = Depends(CommonQueryParams)

 ...следует написать:

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python
 commons: Annotated[CommonQueryParams, Depends()]
@@ -257,7 +257,7 @@ commons: Annotated[CommonQueryParams, Depends()]

 ////

-//// tab | Python 3.8 non-Annotated
+//// tab | Python 3.9+ non-Annotated

 /// tip | Подсказка

@@ -29,15 +29,15 @@ FastAPI поддерживает зависимости, которые выпо

 Перед созданием ответа будет выполнен только код до и включая оператор `yield`:

-{* ../../docs_src/dependencies/tutorial007.py hl[2:4] *}
+{* ../../docs_src/dependencies/tutorial007_py39.py hl[2:4] *}

 Значение, полученное из `yield`, внедряется в *операции пути* и другие зависимости:

-{* ../../docs_src/dependencies/tutorial007.py hl[4] *}
+{* ../../docs_src/dependencies/tutorial007_py39.py hl[4] *}

 Код, следующий за оператором `yield`, выполняется после ответа:

-{* ../../docs_src/dependencies/tutorial007.py hl[5:6] *}
+{* ../../docs_src/dependencies/tutorial007_py39.py hl[5:6] *}

 /// tip | Подсказка

@@ -57,7 +57,7 @@ FastAPI поддерживает зависимости, которые выпо

 Точно так же можно использовать `finally`, чтобы убедиться, что обязательные шаги при выходе выполнены независимо от того, было ли исключение или нет.

-{* ../../docs_src/dependencies/tutorial007.py hl[3,5] *}
+{* ../../docs_src/dependencies/tutorial007_py39.py hl[3,5] *}

 ## Подзависимости с `yield` { #sub-dependencies-with-yield }

@@ -269,7 +269,7 @@ with open("./somefile.txt") as f:
 Их также можно использовать внутри зависимостей **FastAPI** с `yield`, применяя операторы
 `with` или `async with` внутри функции зависимости:

-{* ../../docs_src/dependencies/tutorial010.py hl[1:9,13] *}
+{* ../../docs_src/dependencies/tutorial010_py39.py hl[1:9,13] *}

 /// tip | Подсказка

@@ -6,7 +6,7 @@

 В этом случае они будут применяться ко всем *операциям пути* в приложении:

-{* ../../docs_src/dependencies/tutorial012_an_py39.py hl[16] *}
+{* ../../docs_src/dependencies/tutorial012_an_py39.py hl[17] *}

 Все способы [добавления `dependencies` (зависимостей) в *декораторах операций пути*](dependencies-in-path-operation-decorators.md){.internal-link target=_blank} по-прежнему применимы, но в данном случае зависимости применяются ко всем *операциям пути* приложения.

@@ -62,7 +62,7 @@ query_extractor --> query_or_cookie_extractor --> read_query

 В расширенном сценарии, когда вы знаете, что вам нужно, чтобы зависимость вызывалась на каждом шаге (возможно, несколько раз) в одном и том же запросе, вместо использования "кэшированного" значения, вы можете установить параметр `use_cache=False` при использовании `Depends`:

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python hl_lines="1"
 async def needy_dependency(fresh_value: Annotated[str, Depends(get_value, use_cache=False)]):
@@ -71,7 +71,7 @@ async def needy_dependency(fresh_value: Annotated[str, Depends(get_value, use_ca

 ////

-//// tab | Python 3.8+ без Annotated
+//// tab | Python 3.9+ без Annotated

 /// tip | Подсказка

@@ -2,7 +2,7 @@

 Самый простой файл FastAPI может выглядеть так:

-{* ../../docs_src/first_steps/tutorial001.py *}
+{* ../../docs_src/first_steps/tutorial001_py39.py *}

 Скопируйте это в файл `main.py`.

@@ -143,11 +143,47 @@ OpenAPI определяет схему API для вашего API. И эта

 Вы также можете использовать её для автоматической генерации кода для клиентов, которые взаимодействуют с вашим API. Например, для фронтенд-, мобильных или IoT-приложений.

+### Разверните приложение (необязательно) { #deploy-your-app-optional }
+
+При желании вы можете развернуть своё приложение FastAPI в <a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a>, перейдите и присоединитесь к списку ожидания, если ещё не сделали этого. 🚀
+
+Если у вас уже есть аккаунт **FastAPI Cloud** (мы пригласили вас из списка ожидания 😉), вы можете развернуть приложение одной командой.
+
+Перед развертыванием убедитесь, что вы вошли в систему:
+
+<div class="termy">
+
+```console
+$ fastapi login
+
+You are logged in to FastAPI Cloud 🚀
+```
+
+</div>
+
+Затем разверните приложение:
+
+<div class="termy">
+
+```console
+$ fastapi deploy
+
+Deploying to FastAPI Cloud...
+
+✅ Deployment successful!
+
+🐔 Ready the chicken! Your app is ready at https://myapp.fastapicloud.dev
+```
+
+</div>
+
+Готово! Теперь вы можете открыть своё приложение по этому URL. ✨
+
 ## Рассмотрим поэтапно { #recap-step-by-step }

 ### Шаг 1: импортируйте `FastAPI` { #step-1-import-fastapi }

-{* ../../docs_src/first_steps/tutorial001.py hl[1] *}
+{* ../../docs_src/first_steps/tutorial001_py39.py hl[1] *}

 `FastAPI` — это класс на Python, который предоставляет всю функциональность для вашего API.

@@ -161,7 +197,7 @@ OpenAPI определяет схему API для вашего API. И эта

 ### Шаг 2: создайте экземпляр `FastAPI` { #step-2-create-a-fastapi-instance }

-{* ../../docs_src/first_steps/tutorial001.py hl[3] *}
+{* ../../docs_src/first_steps/tutorial001_py39.py hl[3] *}

 Здесь переменная `app` будет экземпляром класса `FastAPI`.

@@ -230,7 +266,7 @@ https://example.com/items/foo

 #### Определите *декоратор операции пути (path operation decorator)* { #define-a-path-operation-decorator }

-{* ../../docs_src/first_steps/tutorial001.py hl[6] *}
+{* ../../docs_src/first_steps/tutorial001_py39.py hl[6] *}

 `@app.get("/")` сообщает **FastAPI**, что функция прямо под ним отвечает за обработку запросов, поступающих:

@@ -284,7 +320,7 @@ https://example.com/items/foo
 * **операция**: `get`.
 * **функция**: функция ниже «декоратора» (ниже `@app.get("/")`).

-{* ../../docs_src/first_steps/tutorial001.py hl[7] *}
+{* ../../docs_src/first_steps/tutorial001_py39.py hl[7] *}

 Это функция на Python.

@@ -296,7 +332,7 @@ https://example.com/items/foo

 Вы также можете определить её как обычную функцию вместо `async def`:

-{* ../../docs_src/first_steps/tutorial003.py hl[7] *}
+{* ../../docs_src/first_steps/tutorial003_py39.py hl[7] *}

 /// note | Примечание

@@ -306,7 +342,7 @@ https://example.com/items/foo

 ### Шаг 5: верните содержимое { #step-5-return-the-content }

-{* ../../docs_src/first_steps/tutorial001.py hl[8] *}
+{* ../../docs_src/first_steps/tutorial001_py39.py hl[8] *}

 Вы можете вернуть `dict`, `list`, отдельные значения `str`, `int` и т.д.

@@ -314,6 +350,26 @@ https://example.com/items/foo

 Многие другие объекты и модели будут автоматически преобразованы в JSON (включая ORM и т. п.). Попробуйте использовать те, что вам привычнее, с высокой вероятностью они уже поддерживаются.

+### Шаг 6: разверните приложение { #step-6-deploy-it }
+
+Разверните приложение в **<a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a>** одной командой: `fastapi deploy`. 🎉
+
+#### О FastAPI Cloud { #about-fastapi-cloud }
+
+**<a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a>** создан тем же автором и командой, что и **FastAPI**.
+
+Он упрощает процесс **создания образа**, **развертывания** и **доступа** к API с минимальными усилиями.
+
+Он переносит тот же **опыт разработчика** при создании приложений с FastAPI на их **развертывание** в облаке. 🎉
+
+FastAPI Cloud — основной спонсор и источник финансирования для open-source проектов «FastAPI и друзья». ✨
+
+#### Развертывание у других облачных провайдеров { #deploy-to-other-cloud-providers }
+
+FastAPI — open-source и основан на стандартах. Вы можете развернуть приложения FastAPI у любого облачного провайдера по вашему выбору.
+
+Следуйте руководствам вашего облачного провайдера, чтобы развернуть приложения FastAPI у них. 🤓
+
 ## Резюме { #recap }

 * Импортируйте `FastAPI`.
@@ -321,3 +377,4 @@ https://example.com/items/foo
 * Напишите **декоратор операции пути**, например `@app.get("/")`.
 * Определите **функцию операции пути**; например, `def root(): ...`.
 * Запустите сервер разработки командой `fastapi dev`.
+* При желании разверните приложение командой `fastapi deploy`.
@@ -25,7 +25,7 @@

 ### Импортируйте `HTTPException` { #import-httpexception }

-{* ../../docs_src/handling_errors/tutorial001.py hl[1] *}
+{* ../../docs_src/handling_errors/tutorial001_py39.py hl[1] *}

 ### Вызовите `HTTPException` в своем коде { #raise-an-httpexception-in-your-code }

@@ -39,7 +39,7 @@

 В данном примере, когда клиент запрашивает элемент по несуществующему ID, возникает исключение со статус-кодом `404`:

-{* ../../docs_src/handling_errors/tutorial001.py hl[11] *}
+{* ../../docs_src/handling_errors/tutorial001_py39.py hl[11] *}

 ### Возвращаемый ответ { #the-resulting-response }

@@ -77,11 +77,11 @@

 Но в случае, если это необходимо для продвинутого сценария, можно добавить пользовательские заголовки:

-{* ../../docs_src/handling_errors/tutorial002.py hl[14] *}
+{* ../../docs_src/handling_errors/tutorial002_py39.py hl[14] *}

 ## Установка пользовательских обработчиков исключений { #install-custom-exception-handlers }

-Вы можете добавить пользовательские обработчики исключений с помощью <a href="https://www.starlette.dev/exceptions/" class="external-link" target="_blank">то же самое исключение - утилиты от Starlette</a>.
+Вы можете добавить пользовательские обработчики исключений с помощью <a href="https://www.starlette.dev/exceptions/" class="external-link" target="_blank">тех же утилит обработки исключений из Starlette</a>.

 Допустим, у вас есть пользовательское исключение `UnicornException`, которое вы (или используемая вами библиотека) можете `вызвать`.

@@ -89,7 +89,7 @@

 Можно добавить собственный обработчик исключений с помощью `@app.exception_handler()`:

-{* ../../docs_src/handling_errors/tutorial003.py hl[5:7,13:18,24] *}
+{* ../../docs_src/handling_errors/tutorial003_py39.py hl[5:7,13:18,24] *}

 Здесь, если запросить `/unicorns/yolo`, то *операция пути* вызовет `UnicornException`.

@@ -117,7 +117,7 @@

 Вы можете переопределить эти обработчики исключений на свои собственные.

-### Переопределение исключений проверки запроса { #override-request-validation-exceptions }
+### Переопределение обработчика исключений проверки запроса { #override-request-validation-exceptions }

 Когда запрос содержит недопустимые данные, **FastAPI** внутренне вызывает ошибку `RequestValidationError`.

@@ -127,7 +127,7 @@

 Обработчик исключения получит объект `Request` и исключение.

-{* ../../docs_src/handling_errors/tutorial004.py hl[2,14:16] *}
+{* ../../docs_src/handling_errors/tutorial004_py39.py hl[2,14:19] *}

 Теперь, если перейти к `/items/foo`, то вместо стандартной JSON-ошибки с:

@@ -149,36 +149,17 @@
 вы получите текстовую версию:

 ```
-1 validation error
-path -> item_id
-  value is not a valid integer (type=type_error.integer)
+Validation errors:
+Field: ('path', 'item_id'), Error: Input should be a valid integer, unable to parse string as an integer
 ```

-#### `RequestValidationError` или `ValidationError` { #requestvalidationerror-vs-validationerror }
-
-/// warning | Внимание
-
-Это технические детали, которые можно пропустить, если они не важны для вас сейчас.
-
-///
-
-`RequestValidationError` является подклассом Pydantic <a href="https://docs.pydantic.dev/latest/concepts/models/#error-handling" class="external-link" target="_blank">`ValidationError`</a>.
-
-**FastAPI** использует его для того, чтобы, если вы используете Pydantic-модель в `response_model`, и ваши данные содержат ошибку, вы увидели ошибку в журнале.
-
-Но клиент/пользователь этого не увидит. Вместо этого клиент получит сообщение "Internal Server Error" с кодом состояния HTTP `500`.
-
-Так и должно быть, потому что если в вашем *ответе* или где-либо в вашем коде (не в *запросе* клиента) возникает Pydantic `ValidationError`, то это действительно ошибка в вашем коде.
-
-И пока вы не устраните ошибку, ваши клиенты/пользователи не должны иметь доступа к внутренней информации о ней, так как это может привести к уязвимости в системе безопасности.
-
 ### Переопределите обработчик ошибок `HTTPException` { #override-the-httpexception-error-handler }

 Аналогичным образом можно переопределить обработчик `HTTPException`.

 Например, для этих ошибок можно вернуть обычный текстовый ответ вместо JSON:

-{* ../../docs_src/handling_errors/tutorial004.py hl[3:4,9:11,22] *}
+{* ../../docs_src/handling_errors/tutorial004_py39.py hl[3:4,9:11,25] *}

 /// note | Технические детали

@@ -188,13 +169,21 @@ path -> item_id

 ///

+/// warning | Внимание
+
+Имейте в виду, что `RequestValidationError` содержит информацию об имени файла и строке, где произошла ошибка валидации, чтобы вы могли при желании отобразить её в логах с релевантными данными.
+
+Но это означает, что если вы просто преобразуете её в строку и вернёте эту информацию напрямую, вы можете допустить небольшую утечку информации о своей системе, поэтому здесь код извлекает и показывает каждую ошибку отдельно.
+
+///
+
 ### Используйте тело `RequestValidationError` { #use-the-requestvalidationerror-body }

 Ошибка `RequestValidationError` содержит полученное `тело` с недопустимыми данными.

 Вы можете использовать его при разработке приложения для регистрации тела и его отладки, возврата пользователю и т.д.

-{* ../../docs_src/handling_errors/tutorial005.py hl[14] *}
+{* ../../docs_src/handling_errors/tutorial005_py39.py hl[14] *}

 Теперь попробуйте отправить недействительный элемент, например:

@@ -250,6 +239,6 @@ from starlette.exceptions import HTTPException as StarletteHTTPException

 Если вы хотите использовать исключение вместе с теми же обработчиками исключений по умолчанию из **FastAPI**, вы можете импортировать и повторно использовать обработчики исключений по умолчанию из `fastapi.exception_handlers`:

-{* ../../docs_src/handling_errors/tutorial006.py hl[2:5,15,21] *}
+{* ../../docs_src/handling_errors/tutorial006_py39.py hl[2:5,15,21] *}

 В этом примере вы просто `выводите в терминал` ошибку с очень выразительным сообщением, но идея вам понятна. Вы можете использовать исключение, а затем просто повторно использовать стандартные обработчики исключений.
@@ -18,7 +18,7 @@

 Вы можете задать их следующим образом:

-{* ../../docs_src/metadata/tutorial001.py hl[3:16, 19:32] *}
+{* ../../docs_src/metadata/tutorial001_py39.py hl[3:16, 19:32] *}

 /// tip | Подсказка

@@ -36,7 +36,7 @@

 К примеру:

-{* ../../docs_src/metadata/tutorial001_1.py hl[31] *}
+{* ../../docs_src/metadata/tutorial001_1_py39.py hl[31] *}

 ## Метаданные для тегов { #metadata-for-tags }

@@ -58,7 +58,7 @@

 Создайте метаданные для ваших тегов и передайте их в параметре `openapi_tags`:

-{* ../../docs_src/metadata/tutorial004.py hl[3:16,18] *}
+{* ../../docs_src/metadata/tutorial004_py39.py hl[3:16,18] *}

 Помните, что вы можете использовать Markdown внутри описания, к примеру "login" будет отображен жирным шрифтом (**login**) и "fancy" будет отображаться курсивом (_fancy_).

@@ -72,7 +72,7 @@

 Используйте параметр `tags` с вашими *операциями пути* (и `APIRouter`ами), чтобы присвоить им различные теги:

-{* ../../docs_src/metadata/tutorial004.py hl[21,26] *}
+{* ../../docs_src/metadata/tutorial004_py39.py hl[21,26] *}

 /// info | Дополнительная информация

@@ -100,7 +100,7 @@

 К примеру, чтобы задать её отображение по адресу `/api/v1/openapi.json`:

-{* ../../docs_src/metadata/tutorial002.py hl[3] *}
+{* ../../docs_src/metadata/tutorial002_py39.py hl[3] *}

 Если вы хотите отключить схему OpenAPI полностью, вы можете задать `openapi_url=None`, это также отключит пользовательские интерфейсы документации, которые её используют.

@@ -117,4 +117,4 @@

 К примеру, чтобы задать отображение Swagger UI по адресу `/documentation` и отключить ReDoc:

-{* ../../docs_src/metadata/tutorial003.py hl[3] *}
+{* ../../docs_src/metadata/tutorial003_py39.py hl[3] *}
@@ -33,7 +33,7 @@
    * Затем она возвращает ответ `response`, сгенерированный *операцией пути*.
 * Также имеется возможность видоизменить `response`, перед тем как его вернуть.

-{* ../../docs_src/middleware/tutorial001.py hl[8:9,11,14] *}
+{* ../../docs_src/middleware/tutorial001_py39.py hl[8:9,11,14] *}

 /// tip | Примечание

@@ -59,7 +59,7 @@

 Например, вы можете добавить собственный заголовок `X-Process-Time`, содержащий время в секундах, необходимое для обработки запроса и генерации ответа:

-{* ../../docs_src/middleware/tutorial001.py hl[10,12:13] *}
+{* ../../docs_src/middleware/tutorial001_py39.py hl[10,12:13] *}

 /// tip | Примечание

@@ -46,7 +46,7 @@

 **FastAPI** поддерживает это так же, как и в случае с обычными строками:

-{* ../../docs_src/path_operation_configuration/tutorial002b.py hl[1,8:10,13,18] *}
+{* ../../docs_src/path_operation_configuration/tutorial002b_py39.py hl[1,8:10,13,18] *}

 ## Краткое и развёрнутое содержание { #summary-and-description }

@@ -92,7 +92,7 @@ OpenAPI указывает, что каждой *операции пути* не

 Если вам необходимо пометить *операцию пути* как <abbr title="устаревшее, не рекомендовано к использованию">устаревшую</abbr>, при этом не удаляя её, передайте параметр `deprecated`:

-{* ../../docs_src/path_operation_configuration/tutorial006.py hl[16] *}
+{* ../../docs_src/path_operation_configuration/tutorial006_py39.py hl[16] *}

 Он будет четко помечен как устаревший в интерактивной документации:

@@ -54,7 +54,7 @@ Path-параметр всегда является обязательным, п

 Поэтому вы можете определить функцию так:

-{* ../../docs_src/path_params_numeric_validations/tutorial002.py hl[7] *}
+{* ../../docs_src/path_params_numeric_validations/tutorial002_py39.py hl[7] *}

 Но имейте в виду, что если вы используете `Annotated`, вы не столкнётесь с этой проблемой, так как вы не используете значения по умолчанию параметров функции для `Query()` или `Path()`.

@@ -83,7 +83,7 @@ Path-параметр всегда является обязательным, п

 Python не будет ничего делать с `*`, но он будет знать, что все следующие параметры являются именованными аргументами (парами ключ-значение), также известными как <abbr title="От: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>, даже если у них нет значений по умолчанию.

-{* ../../docs_src/path_params_numeric_validations/tutorial003.py hl[7] *}
+{* ../../docs_src/path_params_numeric_validations/tutorial003_py39.py hl[7] *}

 ### Лучше с `Annotated` { #better-with-annotated }

@@ -2,7 +2,7 @@

 Вы можете определить "параметры" или "переменные" пути, используя синтаксис форматированных строк Python:

-{* ../../docs_src/path_params/tutorial001.py hl[6:7] *}
+{* ../../docs_src/path_params/tutorial001_py39.py hl[6:7] *}

 Значение параметра пути `item_id` будет передано в функцию в качестве аргумента `item_id`.

@@ -16,7 +16,7 @@

 Вы можете объявить тип параметра пути в функции, используя стандартные аннотации типов Python:

-{* ../../docs_src/path_params/tutorial002.py hl[7] *}
+{* ../../docs_src/path_params/tutorial002_py39.py hl[7] *}

 Здесь, `item_id` объявлен типом `int`.

@@ -118,13 +118,13 @@

 Поскольку *операции пути* выполняются в порядке их объявления, необходимо, чтобы путь для `/users/me` был объявлен раньше, чем путь для `/users/{user_id}`:

-{* ../../docs_src/path_params/tutorial003.py hl[6,11] *}
+{* ../../docs_src/path_params/tutorial003_py39.py hl[6,11] *}

 Иначе путь для `/users/{user_id}` также будет соответствовать `/users/me`, "подразумевая", что он получает параметр `user_id` со значением `"me"`.

 Аналогично, вы не можете переопределить операцию с путем:

-{* ../../docs_src/path_params/tutorial003b.py hl[6,11] *}
+{* ../../docs_src/path_params/tutorial003b_py39.py hl[6,11] *}

 Первый будет выполняться всегда, так как путь совпадает первым.

@@ -140,13 +140,7 @@

 Затем создайте атрибуты класса с фиксированными допустимыми значениями:

-{* ../../docs_src/path_params/tutorial005.py hl[1,6:9] *}
-
-/// info | Дополнительная информация
-
-<a href="https://docs.python.org/3/library/enum.html" class="external-link" target="_blank">Перечисления (enum) доступны в Python</a> начиная с версии 3.4.
-
-///
+{* ../../docs_src/path_params/tutorial005_py39.py hl[1,6:9] *}

 /// tip | Подсказка

@@ -158,7 +152,7 @@

 Определите *параметр пути*, используя в аннотации типа класс перечисления (`ModelName`), созданный ранее:

-{* ../../docs_src/path_params/tutorial005.py hl[16] *}
+{* ../../docs_src/path_params/tutorial005_py39.py hl[16] *}

 ### Проверьте документацию { #check-the-docs }

@@ -174,13 +168,13 @@

 Вы можете сравнить это значение с *элементом перечисления* класса `ModelName`:

-{* ../../docs_src/path_params/tutorial005.py hl[17] *}
+{* ../../docs_src/path_params/tutorial005_py39.py hl[17] *}

 #### Получение *значения перечисления* { #get-the-enumeration-value }

 Можно получить фактическое значение (в данном случае - `str`) с помощью `model_name.value` или в общем случае `your_enum_member.value`:

-{* ../../docs_src/path_params/tutorial005.py hl[20] *}
+{* ../../docs_src/path_params/tutorial005_py39.py hl[20] *}

 /// tip | Подсказка

@@ -194,7 +188,7 @@

 Они будут преобразованы в соответствующие значения (в данном случае - строки) перед их возвратом клиенту:

-{* ../../docs_src/path_params/tutorial005.py hl[18,21,23] *}
+{* ../../docs_src/path_params/tutorial005_py39.py hl[18,21,23] *}
 Вы отправите клиенту такой JSON-ответ:

 ```JSON
@@ -232,7 +226,7 @@ OpenAPI не поддерживает способов объявления *п

 Можете использовать так:

-{* ../../docs_src/path_params/tutorial004.py hl[6] *}
+{* ../../docs_src/path_params/tutorial004_py39.py hl[6] *}

 /// tip | Подсказка

@@ -55,7 +55,7 @@ q: str | None = None

 ////

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python
 q: Union[str, None] = None
@@ -73,7 +73,7 @@ q: Annotated[str | None] = None

 ////

-//// tab | Python 3.8+
+//// tab | Python 3.9+

 ```Python
 q: Annotated[Union[str, None]] = None
@@ -2,7 +2,7 @@

 Когда вы объявляете параметры функции, которые не являются параметрами пути, они автоматически интерпретируются как "query"-параметры.

-{* ../../docs_src/query_params/tutorial001.py hl[9] *}
+{* ../../docs_src/query_params/tutorial001_py39.py hl[9] *}

 Query-параметры представляют из себя набор пар ключ-значение, которые идут после знака `?` в URL-адресе, разделенные символами `&`.

@@ -127,7 +127,7 @@ http://127.0.0.1:8000/items/foo?short=yes

 Но если вы хотите сделать query-параметр обязательным, вы можете просто не указывать значение по умолчанию:

-{* ../../docs_src/query_params/tutorial005.py hl[6:7] *}
+{* ../../docs_src/query_params/tutorial005_py39.py hl[6:7] *}

 Здесь параметр запроса `needy` является обязательным параметром с типом данных  `str`.

@@ -183,7 +183,7 @@ FastAPI делает несколько вещей внутри вместе с

 Самый распространённый случай — [возвращать Response напрямую, как описано далее в разделах для продвинутых](../advanced/response-directly.md){.internal-link target=_blank}.

-{* ../../docs_src/response_model/tutorial003_02.py hl[8,10:11] *}
+{* ../../docs_src/response_model/tutorial003_02_py39.py hl[8,10:11] *}

 Этот простой случай обрабатывается FastAPI автоматически, потому что аннотация возвращаемого типа — это класс (или подкласс) `Response`.

@@ -193,7 +193,7 @@ FastAPI делает несколько вещей внутри вместе с

 Вы также можете использовать подкласс `Response` в аннотации типа:

-{* ../../docs_src/response_model/tutorial003_03.py hl[8:9] *}
+{* ../../docs_src/response_model/tutorial003_03_py39.py hl[8:9] *}

 Это тоже сработает, так как `RedirectResponse` — подкласс `Response`, и FastAPI автоматически обработает этот случай.

@@ -8,7 +8,7 @@
 * `@app.delete()`
 * и других.

-{* ../../docs_src/response_status_code/tutorial001.py hl[6] *}
+{* ../../docs_src/response_status_code/tutorial001_py39.py hl[6] *}

 /// note | Примечание

@@ -74,7 +74,7 @@ FastAPI знает об этом и создаст документацию Open

 Рассмотрим предыдущий пример еще раз:

-{* ../../docs_src/response_status_code/tutorial001.py hl[6] *}
+{* ../../docs_src/response_status_code/tutorial001_py39.py hl[6] *}

 `201` – это код статуса "Создано".

@@ -82,7 +82,7 @@ FastAPI знает об этом и создаст документацию Open

 Для удобства вы можете использовать переменные из `fastapi.status`.

-{* ../../docs_src/response_status_code/tutorial002.py hl[1,6] *}
+{* ../../docs_src/response_status_code/tutorial002_py39.py hl[1,6] *}

 Они содержат те же числовые значения, но позволяют использовать автозавершение редактора кода для выбора кода статуса:

@@ -1,4 +1,4 @@
-# Настройка авторизации
+# Настройка авторизации { #security }

 Существует множество способов обеспечения безопасности, аутентификации и авторизации.

@@ -10,11 +10,11 @@

 Но сначала давайте рассмотрим некоторые небольшие концепции.

-## Куда-то торопишься?
+## Куда-то торопишься? { #in-a-hurry }

 Если вам не нужна информация о каких-либо из следующих терминов и вам просто нужно добавить защиту с аутентификацией на основе логина и пароля *прямо сейчас*, переходите к следующим главам.

-## OAuth2
+## OAuth2 { #oauth2 }

 OAuth2 - это протокол, который определяет несколько способов обработки аутентификации и авторизации.

@@ -24,7 +24,7 @@ OAuth2 включает в себя способы аутентификации

 Это то, что используют под собой все кнопки "вход с помощью Facebook, Google, X (Twitter), GitHub" на страницах авторизации.

-### OAuth 1
+### OAuth 1 { #oauth-1 }

 Ранее использовался протокол OAuth 1, который сильно отличается от OAuth2 и является более сложным, поскольку он включал прямые описания того, как шифровать сообщение.

@@ -34,11 +34,11 @@ OAuth2 не указывает, как шифровать сообщение, о

 /// tip | Подсказка

-В разделе **Развертывание** вы увидите [как настроить протокол HTTPS бесплатно, используя Traefik и Let's Encrypt.](https://fastapi.tiangolo.com/ru/deployment/https/)
+В разделе **Развертывание** вы увидите как настроить протокол HTTPS бесплатно, используя Traefik и Let's Encrypt.

 ///

-## OpenID Connect
+## OpenID Connect { #openid-connect }

 OpenID Connect - это еще один протокол, основанный на **OAuth2**.

@@ -48,7 +48,7 @@ OpenID Connect - это еще один протокол, основанный

 Но вход в Facebook не поддерживает OpenID Connect. У него есть собственная вариация OAuth2.

-### OpenID (не "OpenID Connect")
+### OpenID (не "OpenID Connect") { #openid-not-openid-connect }

 Также ранее использовался стандарт "OpenID", который пытался решить ту же проблему, что и **OpenID Connect**, но не был основан на OAuth2.

@@ -56,7 +56,7 @@ OpenID Connect - это еще один протокол, основанный

 В настоящее время не очень популярен и не используется.

-## OpenAPI
+## OpenAPI { #openapi }

 OpenAPI (ранее известный как Swagger) - это открытая спецификация для создания API (в настоящее время является частью Linux Foundation).

@@ -97,7 +97,7 @@ OpenAPI может использовать следующие схемы авт

 ///

-## Преимущества **FastAPI**
+## Преимущества **FastAPI** { #fastapi-utilities }

 Fast API предоставляет несколько инструментов для каждой из этих схем безопасности в модуле `fastapi.security`, которые упрощают использование этих механизмов безопасности.

@@ -63,9 +63,9 @@ $ pip install sqlmodel

 * `table=True` сообщает SQLModel, что это *модель-таблица*, она должна представлять **таблицу** в SQL базе данных, это не просто *модель данных* (как обычный класс Pydantic).

-* `Field(primary_key=True)` сообщает SQLModel, что `id` — это **первичный ключ** в SQL базе данных (подробнее о первичных ключах можно узнать в документации SQLModel).
+* `Field(primary_key=True)` сообщает SQLModel, что `id` — это **первичный ключ** в SQL базе данных (подробнее о первичных ключах SQL можно узнать в документации SQLModel).

-    Благодаря типу `int | None`, SQLModel будет знать, что этот столбец должен быть `INTEGER` в SQL базе данных и должен допускать значение `NULL`.
+    **Примечание:** Мы используем `int | None` для поля первичного ключа, чтобы в Python-коде можно было *создать объект без `id`* (`id=None`), предполагая, что база данных *сгенерирует его при сохранении*. SQLModel понимает, что база данных предоставит `id`, и *определяет столбец как `INTEGER` (не `NULL`)* в схеме базы данных. См. <a href="https://sqlmodel.tiangolo.com/tutorial/create-db-and-table/#primary-key-id" class="external-link" target="_blank">документацию SQLModel о первичных ключах</a> для подробностей.

 * `Field(index=True)` сообщает SQLModel, что нужно создать **SQL индекс** для этого столбца, что позволит быстрее выполнять выборки при чтении данных, отфильтрованных по этому столбцу.

@@ -107,7 +107,7 @@ $ pip install sqlmodel

 Здесь мы создаём таблицы в обработчике события запуска приложения.

-Для продакшна вы, вероятно, будете использовать скрипт миграций, который выполняется до запуска приложения. 🤓
+Для продакшн вы, вероятно, будете использовать скрипт миграций, который выполняется до запуска приложения. 🤓

 /// tip | Подсказка

@@ -7,7 +7,7 @@
 * Импортируйте `StaticFiles`.
 * "Примонтируйте" экземпляр `StaticFiles()` к определённому пути.

-{* ../../docs_src/static_files/tutorial001.py hl[2,6] *}
+{* ../../docs_src/static_files/tutorial001_py39.py hl[2,6] *}

 /// note | Технические детали

@@ -30,7 +30,7 @@ $ pip install httpx

 Напишите простое утверждение с `assert` дабы проверить истинность Python-выражения (это тоже стандарт `pytest`).

-{* ../../docs_src/app_testing/tutorial001.py hl[2,12,15:18] *}
+{* ../../docs_src/app_testing/tutorial001_py39.py hl[2,12,15:18] *}

 /// tip | Подсказка

@@ -76,7 +76,7 @@ $ pip install httpx
 В файле `main.py` находится Ваше приложение **FastAPI**:


-{* ../../docs_src/app_testing/main.py *}
+{* ../../docs_src/app_testing/app_a_py39/main.py *}

 ### Файл тестов { #testing-file }

@@ -92,7 +92,7 @@ $ pip install httpx

 Так как оба файла находятся в одной директории, для импорта объекта приложения из файла `main` в файл `test_main` Вы можете использовать относительный импорт:

-{* ../../docs_src/app_testing/test_main.py hl[3] *}
+{* ../../docs_src/app_testing/app_a_py39/test_main.py hl[3] *}


 ...и писать дальше тесты, как и раньше.
@@ -121,63 +121,13 @@ $ pip install httpx

 Обе *операции пути* требуют наличия в запросе заголовка `X-Token`.

-//// tab | Python 3.10+
-
-```Python
-{!> ../../docs_src/app_testing/app_b_an_py310/main.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python
-{!> ../../docs_src/app_testing/app_b_an_py39/main.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python
-{!> ../../docs_src/app_testing/app_b_an/main.py!}
-```
-
-////
-
-//// tab | Python 3.10+ без Annotated
-
-/// tip | Подсказка
-
-По возможности используйте версию с `Annotated`.
-
-///
-
-```Python
-{!> ../../docs_src/app_testing/app_b_py310/main.py!}
-```
-
-////
-
-//// tab | Python 3.8+ без Annotated
-
-/// tip | Подсказка
-
-По возможности используйте версию с `Annotated`.
-
-///
-
-```Python
-{!> ../../docs_src/app_testing/app_b/main.py!}
-```
-
-////
+{* ../../docs_src/app_testing/app_b_an_py310/main.py *}

 ### Расширенный файл тестов { #extended-testing-file }

 Теперь обновим файл `test_main.py`, добавив в него тестов:

-{* ../../docs_src/app_testing/app_b/test_main.py *}
+{* ../../docs_src/app_testing/app_b_an_py310/test_main.py *}


 Если Вы не знаете, как передать информацию в запросе, можете воспользоваться поисковиком (погуглить) и задать вопрос: "Как передать информацию в запросе с помощью `httpx`", можно даже спросить: "Как передать информацию в запросе с помощью `requests`", поскольку дизайн HTTPX основан на дизайне Requests.
@@ -242,6 +242,26 @@ $ python -m pip install --upgrade pip

 </div>

+/// tip | Подсказка
+
+Иногда при попытке обновить pip вы можете получить ошибку **`No module named pip`**.
+
+Если это произошло, установите и обновите pip с помощью команды ниже:
+
+<div class="termy">
+
+```console
+$ python -m ensurepip --upgrade
+
+---> 100%
+```
+
+</div>
+
+Эта команда установит pip, если он ещё не установлен, а также гарантирует, что установленная версия pip будет не старее, чем версия, доступная в `ensurepip`.
+
+///
+
 ## Добавление `.gitignore` { #add-gitignore }

 Если вы используете **Git** (а вам стоит его использовать), добавьте файл `.gitignore`, чтобы исключить из Git всё, что находится в вашей `.venv`.
@@ -834,7 +854,7 @@ I solemnly swear 🐺
 * Управлять **виртуальным окружением** ваших проектов
 * Устанавливать **пакеты**
 * Управлять **зависимостями и версиями** пакетов вашего проекта
-* Обеспечивать наличие **точного** набора пакетов и версий к установке, включая их зависимости, чтобы вы были уверены, что сможете запускать проект в продакшне точно так же, как и на компьютере при разработке — это называется **locking**
+* Обеспечивать наличие **точного** набора пакетов и версий к установке, включая их зависимости, чтобы вы были уверены, что сможете запускать проект в продакшн точно так же, как и на компьютере при разработке — это называется **locking**
 * И многое другое

 ## Заключение { #conclusion }