🌐 Update translations for uk (update-all) (#14914)

* Update all

* 🎨 Auto format

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

diff --git a/docs/uk/docs/alternatives.md b/docs/uk/docs/alternatives.md
index d44ca794f82f09e443a152f2d5f5efc93685f7b0..5dbf8a96baf4c791bb26e2da09e477eae750ddef 100644 (file)
--- a/docs/uk/docs/alternatives.md
+++ b/docs/uk/docs/alternatives.md
@@ -58,9 +58,9 @@ Flask — це «мікрофреймворк», він не включає ін
 
 /// check | Надихнуло **FastAPI** на
 
-Ð\91Ñ\83Ñ\82и мÑ\96кÑ\80оÑ\84Ñ\80еймовоÑ\80ком. Ð\97Ñ\80обиÑ\82и легким комбÑ\96нÑ\83ваннÑ\8f Ñ\82а поÑ\94днаннÑ\8f необÑ\85Ñ\96дниÑ\85 Ñ\96нÑ\81Ñ\82Ñ\80Ñ\83менÑ\82Ñ\96в Ñ\82а Ñ\87аÑ\81Ñ\82ин.
+Бути мікрофреймворком. Зробити легким комбінування та поєднання необхідних інструментів та частин.
 
- Мати просту та легку у використанні систему маршрутизації.
+Мати просту та легку у використанні систему маршрутизації.
 
 ///
 
@@ -100,9 +100,9 @@ def read_url():
 
 /// check | Надихнуло **FastAPI** на
 
-* Майте простий та інтуїтивно зрозумілий API.
-* Ð\92икоÑ\80иÑ\81Ñ\82овÑ\83йÑ\82е імена (операції) методів HTTP безпосередньо, простим та інтуїтивно зрозумілим способом.
-* Ð озумні параметри за замовчуванням, але потужні налаштування.
+* Мати простий та інтуїтивно зрозумілий API.
+* Ð\92икоÑ\80иÑ\81Ñ\82овÑ\83ваÑ\82и імена (операції) методів HTTP безпосередньо, простим та інтуїтивно зрозумілим способом.
+* Ð\9cаÑ\82и Ñ\80озумні параметри за замовчуванням, але потужні налаштування.
 
 ///
 
@@ -122,12 +122,12 @@ def read_url():
 
 Прийняти і використовувати відкритий стандарт для специфікацій API замість спеціальної схеми.
 
- Інтегрувати інструменти інтерфейсу на основі стандартів:
+Інтегрувати інструменти інтерфейсу на основі стандартів:
 
 * <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Інтерфейс Swagger</a>
 * <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>
 
- Ці два було обрано через те, що вони досить популярні та стабільні, але, виконавши швидкий пошук, ви можете знайти десятки додаткових альтернативних інтерфейсів для OpenAPI (які можна використовувати з **FastAPI**).
+Ці два було обрано через те, що вони досить популярні та стабільні, але, виконавши швидкий пошук, ви можете знайти десятки додаткових альтернативних інтерфейсів для OpenAPI (які можна використовувати з **FastAPI**).
 
 ///
 
@@ -137,7 +137,7 @@ def read_url():
 
 ### <a href="https://marshmallow.readthedocs.io/en/stable/" class="external-link" target="_blank">Marshmallow</a> { #marshmallow }
 
-Однією з головних функцій, необхідних для систем API, є "<abbr title="також звана marshalling, conversion">серіалізація</abbr>", яка бере дані з коду (Python) і перетворює їх на щось, що можна надіслати через мережу. Наприклад, перетворення об’єкта, що містить дані з бази даних, на об’єкт JSON. Перетворення об’єктів `datetime` на строки тощо.
+Однією з головних функцій, необхідних для систем API, є "<dfn title="також відома як: marshalling, перетворення">серіалізація</dfn>", яка бере дані з коду (Python) і перетворює їх на щось, що можна надіслати через мережу. Наприклад, перетворення об’єкта, що містить дані з бази даних, на об’єкт JSON. Перетворення об’єктів `datetime` на строки тощо.
 
 Іншою важливою функцією, необхідною для API, є перевірка даних, яка забезпечує дійсність даних за певними параметрами. Наприклад, що деяке поле є `int`, а не деяка випадкова строка. Це особливо корисно для вхідних даних.
 
@@ -145,7 +145,7 @@ def read_url():
 
 Marshmallow створено для забезпечення цих функцій. Це чудова бібліотека, і я часто нею користувався раніше.
 
-Але він був створений до того, як існували підказки типу Python. Отже, щоб визначити кожну <abbr title="визначення того, як дані повинні бути сформовані">схему</abbr>, вам потрібно використовувати спеціальні утиліти та класи, надані Marshmallow.
+Але він був створений до того, як існували підказки типу Python. Отже, щоб визначити кожну <dfn title="визначення того, як дані повинні бути сформовані">схему</dfn>, вам потрібно використовувати спеціальні утиліти та класи, надані Marshmallow.
 
 /// check | Надихнуло **FastAPI** на
 
@@ -155,7 +155,7 @@ Marshmallow створено для забезпечення цих функці
 
 ### <a href="https://webargs.readthedocs.io/en/latest/" class="external-link" target="_blank">Webargs</a> { #webargs }
 
-Іншою важливою функцією, необхідною для API, є <abbr title="читання та перетворення даних Python">аналіз</abbr> даних із вхідних запитів.
+Іншою важливою функцією, необхідною для API, є <dfn title="читання та перетворення на дані Python">аналіз</dfn> даних із вхідних запитів.
 
 Webargs — це інструмент, створений, щоб забезпечити це поверх кількох фреймворків, включаючи Flask.
 
@@ -217,7 +217,7 @@ APISpec був створений тими ж розробниками Marshmall
 
 Ця комбінація Flask, Flask-apispec із Marshmallow і Webargs була моїм улюбленим бекенд-стеком до створення **FastAPI**.
 
-Ð\87Ñ\96 використання призвело до створення кількох генераторів повного стека Flask. Це основний стек, який я (та кілька зовнішніх команд) використовував досі:
+Ð\87Ñ\97 використання призвело до створення кількох генераторів повного стека Flask. Це основний стек, який я (та кілька зовнішніх команд) використовував досі:
 
 * <a href="https://github.com/tiangolo/full-stack" class="external-link" target="_blank">https://github.com/tiangolo/full-stack</a>
 * <a href="https://github.com/tiangolo/full-stack-flask-couchbase" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-flask-couchbase</a>
@@ -255,7 +255,7 @@ Flask-apispec був створений тими ж розробниками Mar
 
 Використовувати типи Python, щоб мати чудову підтримку редактора.
 
- Мати потужну систему впровадження залежностей. Знайдіть спосіб звести до мінімуму повторення коду.
+Мати потужну систему впровадження залежностей. Знайдіть спосіб звести до мінімуму повторення коду.
 
 ///
 
@@ -267,7 +267,7 @@ Flask-apispec був створений тими ж розробниками Mar
 
 Він використовував <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> замість стандартного циклу Python `asyncio`. Ось що зробило його таким швидким.
 
- Це явно надихнуло Uvicorn і Starlette, які зараз швидші за Sanic у відкритих тестах.
+Це явно надихнуло Uvicorn і Starlette, які зараз швидші за Sanic у відкритих тестах.
 
 ///
 
@@ -275,7 +275,7 @@ Flask-apispec був створений тими ж розробниками Mar
 
 Знайти спосіб отримати божевільну продуктивність.
 
- Ось чому **FastAPI** базується на Starlette, оскільки це найшвидша доступна структура (перевірена тестами сторонніх розробників).
+Ось чому **FastAPI** базується на Starlette, оскільки це найшвидша доступна структура (перевірена тестами сторонніх розробників).
 
 ///
 
@@ -291,9 +291,9 @@ Falcon — ще один високопродуктивний фреймворк
 
 Знайти способи отримати чудову продуктивність.
 
- Разом із Hug (оскільки Hug базується на Falcon) надихнув **FastAPI** оголосити параметр `response` у функціях.
+Разом із Hug (оскільки Hug базується на Falcon) надихнув **FastAPI** оголосити параметр `response` у функціях.
 
- Хоча у FastAPI це необов’язково, і використовується в основному для встановлення заголовків, файлів cookie та альтернативних кодів стану.
+Хоча у FastAPI це необов’язково, і використовується в основному для встановлення заголовків, файлів cookie та альтернативних кодів статусу.
 
 ///
 
@@ -317,7 +317,7 @@ Falcon — ще один високопродуктивний фреймворк
 
 Визначити додаткові перевірки для типів даних, використовуючи значення "за замовчуванням" атрибутів моделі. Це покращує підтримку редактора, а раніше вона була недоступна в Pydantic.
 
- Це фактично надихнуло оновити частини Pydantic, щоб підтримувати той самий стиль оголошення перевірки (всі ці функції вже доступні в Pydantic).
+Це фактично надихнуло оновити частини Pydantic, щоб підтримувати той самий стиль оголошення перевірки (всі ці функції вже доступні в Pydantic).
 
 ///
 
@@ -341,13 +341,13 @@ Hug створив Тімоті Крослі, той самий творець <
 
 ///
 
-/// check | Ð\9dадиÑ\85нÑ\83ло **FastAPI** на
+/// check | Ð\86деÑ\97, Ñ\89о надиÑ\85нÑ\83ли **FastAPI**
 
 Hug надихнув частину APIStar і був одним із найбільш перспективних інструментів, поряд із APIStar.
 
- Hug надихнув **FastAPI** на використання підказок типу Python для оголошення параметрів і автоматичного створення схеми, що визначає API.
+Hug надихнув **FastAPI** на використання підказок типу Python для оголошення параметрів і автоматичного створення схеми, що визначає API.
 
- Hug надихнув **FastAPI** оголосити параметр `response` у функціях для встановлення заголовків і файлів cookie.
+Hug надихнув **FastAPI** оголосити параметр `response` у функціях для встановлення заголовків і файлів cookie.
 
 ///
 
@@ -389,13 +389,13 @@ APIStar створив Том Крісті. Той самий хлопець, я
 
 Існувати.
 
- Ідею оголошення кількох речей (перевірки даних, серіалізації та документації) за допомогою тих самих типів Python, які в той же час забезпечували чудову підтримку редактора, я вважав геніальною ідеєю.
+Ідею оголошення кількох речей (перевірки даних, серіалізації та документації) за допомогою тих самих типів Python, які в той же час забезпечували чудову підтримку редактора, я вважав геніальною ідеєю.
 
- І після тривалого пошуку подібної структури та тестування багатьох різних альтернатив, APIStar став найкращим доступним варіантом.
+І після тривалого пошуку подібної структури та тестування багатьох різних альтернатив, APIStar став найкращим доступним варіантом.
 
- Потім APIStar перестав існувати як сервер, і було створено Starlette, який став новою кращою основою для такої системи. Це стало останнім джерелом натхнення для створення **FastAPI**.
+Потім APIStar перестав існувати як сервер, і було створено Starlette, який став новою кращою основою для такої системи. Це стало останнім джерелом натхнення для створення **FastAPI**.
 
- Я вважаю **FastAPI** «духовним спадкоємцем» APIStar, удосконалюючи та розширюючи функції, систему типізації та інші частини на основі досвіду, отриманого від усіх цих попередніх інструментів.
+Я вважаю **FastAPI** «духовним спадкоємцем» APIStar, удосконалюючи та розширюючи функції, систему типізації та інші частини на основі досвіду, отриманого від усіх цих попередніх інструментів.
 
 ///
 
@@ -403,7 +403,7 @@ APIStar створив Том Крісті. Той самий хлопець, я
 
 ### <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a> { #pydantic }
 
-Pydantic — це бібліотека для визначення перевірки даних, серіалізації та документації (за допомогою схеми JSON) на основі підказок типу Python.
+Pydantic — це бібліотека для визначення перевірки даних, серіалізації та документації (за допомогою Схеми JSON) на основі підказок типу Python.
 
 Це робить його надзвичайно інтуїтивним.
 
@@ -411,15 +411,15 @@ Pydantic — це бібліотека для визначення переві
 
 /// check | **FastAPI** використовує його для
 
-Ð\92иконаннÑ\8f пеÑ\80евÑ\96Ñ\80ки вÑ\81Ñ\96Ñ\85 даниÑ\85, Ñ\81еÑ\80Ñ\96алÑ\96заÑ\86Ñ\96Ñ\97 даниÑ\85 Ñ\96 авÑ\82омаÑ\82иÑ\87ноÑ\97 докÑ\83менÑ\82аÑ\86Ñ\96Ñ\8e моделÑ\96 (на оÑ\81новÑ\96 Ñ\81хеми JSON).
+Ð\92иконаннÑ\8f пеÑ\80евÑ\96Ñ\80ки вÑ\81Ñ\96Ñ\85 даниÑ\85, Ñ\81еÑ\80Ñ\96алÑ\96заÑ\86Ñ\96Ñ\97 даниÑ\85 Ñ\96 авÑ\82омаÑ\82иÑ\87ноÑ\97 докÑ\83менÑ\82аÑ\86Ñ\96Ñ\97 моделÑ\96 (на оÑ\81новÑ\96 Схеми JSON).
 
- Потім **FastAPI** бере ці дані схеми JSON і розміщує їх у OpenAPI, окремо від усіх інших речей, які він робить.
+Потім **FastAPI** бере ці дані Схеми JSON і розміщує їх у OpenAPI, окремо від усіх інших речей, які він робить.
 
 ///
 
 ### <a href="https://www.starlette.dev/" class="external-link" target="_blank">Starlette</a> { #starlette }
 
-Starlette — це легкий фреймворк/набір інструментів <abbr title="Новий стандарт для створення асинхронних Python вебзастосунків">ASGI</abbr>, який ідеально підходить для створення високопродуктивних asyncio сервісів.
+Starlette — це легкий фреймворк/набір інструментів <dfn title="Новий стандарт для створення асинхронних вебзастосунків на Python">ASGI</dfn>, який ідеально підходить для створення високопродуктивних asyncio сервісів.
 
 Він дуже простий та інтуїтивно зрозумілий. Його розроблено таким чином, щоб його можна було легко розширювати та мати модульні компоненти.
 
@@ -448,7 +448,7 @@ Starlette надає всі основні функції веб-мікрофр
 
 ASGI — це новий «стандарт», який розробляється членами основної команди Django. Це ще не «стандарт Python» (PEP), хоча вони в процесі цього.
 
- Тим не менш, він уже використовується як «стандарт» кількома інструментами. Це значно покращує сумісність, оскільки ви можете переключити Uvicorn на будь-який інший сервер ASGI (наприклад, Daphne або Hypercorn), або ви можете додати інструменти, сумісні з ASGI, як-от `python-socketio`.
+Тим не менш, він уже використовується як «стандарт» кількома інструментами. Це значно покращує сумісність, оскільки ви можете переключити Uvicorn на будь-який інший сервер ASGI (наприклад, Daphne або Hypercorn), або ви можете додати інструменти, сумісні з ASGI, як-от `python-socketio`.
 
 ///
 
@@ -456,9 +456,9 @@ ASGI — це новий «стандарт», який розробляєтьс
 
 Керування всіма основними веб-частинами. Додавання функцій зверху.
 
- Сам клас `FastAPI` безпосередньо успадковує клас `Starlette`.
+Сам клас `FastAPI` безпосередньо успадковує клас `Starlette`.
 
- Отже, усе, що ви можете робити зі Starlette, ви можете робити це безпосередньо за допомогою **FastAPI**, оскільки це, по суті, Starlette на стероїдах.
+Отже, усе, що ви можете робити зі Starlette, ви можете робити це безпосередньо за допомогою **FastAPI**, оскільки це, по суті, Starlette на стероїдах.
 
 ///
 
@@ -474,9 +474,9 @@ Uvicorn — це блискавичний сервер ASGI, побудован
 
 Основний веб-сервер для запуску програм **FastAPI**.
 
- Ви також можете використати параметр командного рядка `--workers`, щоб мати асинхронний багатопроцесний сервер.
+Ви також можете використати параметр командного рядка `--workers`, щоб мати асинхронний багатопроцесний сервер.
 
- Додаткову інформацію див. у розділі [Розгортання](deployment/index.md){.internal-link target=_blank}.
+Додаткову інформацію див. у розділі [Розгортання](deployment/index.md){.internal-link target=_blank}.
 
 ///
 

diff --git a/docs/uk/docs/features.md b/docs/uk/docs/features.md
index d8233115fde3583da1b79f0a2d51aad22dbe5b9f..db044bf9478631a01778c5d6f3725ec6c860964c 100644 (file)
--- a/docs/uk/docs/features.md
+++ b/docs/uk/docs/features.md
@@ -6,7 +6,7 @@
 
 ### На основі відкритих стандартів { #based-on-open-standards }
 
-* <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank"><strong>OpenAPI</strong></a> для створення API, включаючи оголошення <abbr title="також відомі як: endpoints, маршрути">шляхів</abbr>, <abbr title="також відомі як HTTP-методи, наприклад, POST, GET, PUT, DELETE">операцій</abbr>, параметрів, тіл запитів, безпеки тощо.
+* <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank"><strong>OpenAPI</strong></a> для створення API, включаючи оголошення <dfn title="також відомі як: кінцеві точки, маршрути">шляхів</dfn>, <dfn title="також відомі як методи HTTP, як-от POST, GET, PUT, DELETE">операцій</dfn>, параметрів, тіл запитів, безпеки тощо.
 * Автоматична документація моделей даних за допомогою <a href="https://json-schema.org/" class="external-link" target="_blank"><strong>JSON Schema</strong></a> (оскільки OpenAPI базується саме на JSON Schema).
 * Розроблено на основі цих стандартів після ретельного аналізу, а не як додатковий рівень поверх основної архітектури.
 * Це також дає змогу використовувати автоматичну **генерацію клієнтського коду** багатьма мовами.
@@ -136,7 +136,7 @@ FastAPI має розумні **налаштування за замовчува
 
 ### Впровадження залежностей { #dependency-injection }
 
-FastAPI містить надзвичайно просту у використанні, але надзвичайно потужну систему <abbr title='також відоме як: "components", "resources", "services", "providers"'><strong>Dependency Injection</strong></abbr>.
+FastAPI містить надзвичайно просту у використанні, але надзвичайно потужну систему <dfn title='також відоме як «components», «resources», «services», «providers»'><strong>Впровадження залежностей</strong></dfn>.
 
 * Навіть залежності можуть мати власні залежності, утворюючи ієрархію або **«граф» залежностей**.
 * Усе **автоматично обробляється** фреймворком.
@@ -153,8 +153,8 @@ FastAPI містить надзвичайно просту у використа
 
 ### Протестовано { #tested }
 
-* 100% <abbr title="Обсяг коду, що автоматично тестується">покриття тестами</abbr>.
-* 100% <abbr title="Анотації типів у Python, завдяки яким ваш редактор і зовнішні інструменти можуть надавати кращу підтримку">анотована типами</abbr> кодова база.
+* 100% <dfn title="Обсяг коду, що автоматично тестується">покриття тестами</dfn>.
+* 100% <dfn title="Анотації типів у Python, завдяки яким ваш редактор і зовнішні інструменти можуть надавати кращу підтримку">анотована типами</dfn> кодова база.
 * Використовується в production-застосунках.
 
 ## Можливості Starlette { #starlette-features }
@@ -190,7 +190,7 @@ FastAPI містить надзвичайно просту у використа
 * **Ніякої плутанини**:
     * Не потрібно вчити нову мікромову для визначення схем.
     * Якщо ви знаєте типи Python, ви знаєте, як використовувати Pydantic.
-* Легко працює з вашим **<abbr title="Integrated Development Environment - Інтегроване середовище розробки: схоже на код-редактор">IDE</abbr>/<abbr title="Програма, що перевіряє код на помилки">linter</abbr>/мозком**:
+* Легко працює з вашим **<abbr title="Integrated Development Environment - Інтегроване середовище розробки: схоже на код-редактор">IDE</abbr>/<dfn title="Програма, що перевіряє код на помилки">linter</dfn>/мозком**:
     * Оскільки структури даних pydantic є просто екземплярами класів, які ви визначаєте; автодоповнення, лінтинг, mypy і ваша інтуїція повинні добре працювати з вашими перевіреними даними.
 * Валідує **складні структури**:
     * Використання ієрархічних моделей Pydantic, Python `typing`’s `List` і `Dict` тощо.

diff --git a/docs/uk/docs/index.md b/docs/uk/docs/index.md
index 4f089c4e1a51e1d20bf29426d2b6a712e0d646e9..0a6788502a90b65bcad173c4d50974054e96fbb1 100644 (file)
--- a/docs/uk/docs/index.md
+++ b/docs/uk/docs/index.md
@@ -40,7 +40,7 @@ FastAPI - це сучасний, швидкий (високопродуктив
 * **Швидкий**: дуже висока продуктивність, на рівні з **NodeJS** та **Go** (завдяки Starlette та Pydantic). [Один із найшвидших Python-фреймворків](#performance).
 * **Швидке написання коду**: пришвидшує розробку функціоналу приблизно на 200%–300%. *
 * **Менше помилок**: зменшує приблизно на 40% кількість помилок, спричинених людиною (розробником). *
-* **Інтуїтивний**: чудова підтримка редакторами коду. <abbr title="також відоме як auto-complete, autocompletion, IntelliSense">Автодоповнення</abbr> всюди. Менше часу на налагодження.
+* **Інтуїтивний**: чудова підтримка редакторами коду. <dfn title="також відоме як: авто-доповнення, автозавершення, IntelliSense">Автодоповнення</dfn> всюди. Менше часу на налагодження.
 * **Простий**: спроєктований так, щоб бути простим у використанні та вивченні. Менше часу на читання документації.
 * **Короткий**: мінімізує дублювання коду. Кілька можливостей з кожного оголошення параметра. Менше помилок.
 * **Надійний**: ви отримуєте код, готовий до продакшину. З автоматичною інтерактивною документацією.
@@ -127,7 +127,7 @@ FastAPI - це сучасний, швидкий (високопродуктив
 
 <a href="https://typer.tiangolo.com" target="_blank"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style="width: 20%;"></a>
 
-Якщо ви створюєте застосунок <abbr title="Command Line Interface- Інтерфейс командного рядка">CLI</abbr> для використання в терміналі замість веб-API, зверніть увагу на <a href="https://typer.tiangolo.com/" class="external-link" target="_blank">**Typer**</a>.
+Якщо ви створюєте застосунок <abbr title="Command Line Interface - Інтерфейс командного рядка">CLI</abbr> для використання в терміналі замість веб-API, зверніть увагу на <a href="https://typer.tiangolo.com/" class="external-link" target="_blank">**Typer**</a>.
 
 **Typer** - молодший брат FastAPI. І його задумано як **FastAPI для CLI**. ⌨️ 🚀
 
@@ -368,7 +368,7 @@ item: Item
 * Валідацію даних:
     * Автоматичні та зрозумілі помилки, коли дані некоректні.
     * Валідацію навіть для глибоко вкладених JSON-обʼєктів.
-* <abbr title="також відоме як serialization, parsing, marshalling">Перетворення</abbr> вхідних даних: з мережі до даних і типів Python. Читання з:
+* <dfn title="також відоме як: серіалізація, парсинг, маршалінг">Перетворення</dfn> вхідних даних: з мережі до даних і типів Python. Читання з:
     * JSON.
     * Параметрів шляху.
     * Параметрів запиту.
@@ -376,7 +376,7 @@ item: Item
     * Headers.
     * Forms.
     * Files.
-* <abbr title="також відоме як serialization, parsing, marshalling">Перетворення</abbr> вихідних даних: перетворення з даних і типів Python у мережеві дані (як JSON):
+* <dfn title="також відоме як: серіалізація, парсинг, маршалінг">Перетворення</dfn> вихідних даних: перетворення з даних і типів Python у мережеві дані (як JSON):
     * Перетворення типів Python (`str`, `int`, `float`, `bool`, `list`, тощо).
     * Обʼєктів `datetime`.
     * Обʼєктів `UUID`.
@@ -439,7 +439,7 @@ item: Item
 
 * Оголошення **параметрів** з інших різних місць, як-от: **headers**, **cookies**, **form fields** та **files**.
 * Як встановлювати **обмеження валідації** як `maximum_length` або `regex`.
-* Дуже потужну і просту у використанні систему **<abbr title="also known as components, resources, providers, services, injectables">Dependency Injection</abbr>**.
+* Дуже потужну і просту у використанні систему **<dfn title="також відоме як: компоненти, ресурси, провайдери, сервіси, інжектовані залежності">Впровадження залежностей</dfn>**.
 * Безпеку та автентифікацію, включно з підтримкою **OAuth2** з **JWT tokens** та **HTTP Basic** auth.
 * Досконаліші (але однаково прості) техніки для оголошення **глибоко вкладених моделей JSON** (завдяки Pydantic).
 * Інтеграцію **GraphQL** з <a href="https://strawberry.rocks" class="external-link" target="_blank">Strawberry</a> та іншими бібліотеками.
@@ -524,7 +524,7 @@ FastAPI залежить від Pydantic і Starlette.
 
 * <a href="https://www.python-httpx.org" target="_blank"><code>httpx</code></a> - потрібно, якщо ви хочете використовувати `TestClient`.
 * <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - потрібно, якщо ви хочете використовувати конфігурацію шаблонів за замовчуванням.
-* <a href="https://github.com/Kludex/python-multipart" target="_blank"><code>python-multipart</code></a> - потрібно, якщо ви хочете підтримувати <abbr title="перетворення строки із HTTP-запиту, у Python типи">«parsing»</abbr> форм за допомогою `request.form()`.
+* <a href="https://github.com/Kludex/python-multipart" target="_blank"><code>python-multipart</code></a> - потрібно, якщо ви хочете підтримувати форми з <dfn title="перетворення строки, що надходить із HTTP-запиту, у дані Python">«парсингом»</dfn> через `request.form()`.
 
 Використовується FastAPI:
 

diff --git a/docs/uk/docs/learn/index.md b/docs/uk/docs/learn/index.md
index 6e28d414ad5e2dea705ea90de1a7f83e214cc0e8..ad468fea18c9ae6cdba8072c2aebfade0cd21118 100644 (file)
--- a/docs/uk/docs/learn/index.md
+++ b/docs/uk/docs/learn/index.md
@@ -1,5 +1,5 @@
 # Навчання { #learn }
 
-У Ñ\86Ñ\8cомÑ\83 Ñ\80оздÑ\96лÑ\96 наданÑ\96 вÑ\81Ñ\82Ñ\83пнÑ\96 Ñ\80оздÑ\96ли Ñ\82а навÑ\87алÑ\8cнÑ\96 маÑ\82еÑ\80Ñ\96али для вивчення **FastAPI**.
+У Ñ\86Ñ\8cомÑ\83 Ñ\80оздÑ\96лÑ\96 наданÑ\96 вÑ\81Ñ\82Ñ\83пнÑ\96 Ñ\80оздÑ\96ли Ñ\82а навÑ\87алÑ\8cнÑ\96 поÑ\81Ñ\96бники для вивчення **FastAPI**.
 
 Це можна розглядати як **книгу**, **курс**, або **офіційний** та рекомендований спосіб освоїти FastAPI. 😎

diff --git a/docs/uk/docs/python-types.md b/docs/uk/docs/python-types.md
index a82d13a2852d7225a0753c1caaf0e314b5aaf6cc..deeeb2f9c551c86368bfbaf3d14195b939b733aa 100644 (file)
--- a/docs/uk/docs/python-types.md
+++ b/docs/uk/docs/python-types.md
@@ -2,11 +2,11 @@
 
 Python підтримує додаткові «підказки типів» (також звані «анотаціями типів»).
 
-Ці **«підказки типів»** або анотації — це спеціальний синтаксис, що дозволяє оголошувати <abbr title="наприклад: str, int, float, bool">тип</abbr> змінної.
+Ці **«підказки типів»** або анотації — це спеціальний синтаксис, що дозволяє оголошувати <dfn title="наприклад: str, int, float, bool">тип</dfn> змінної.
 
 За допомогою оголошення типів для ваших змінних редактори та інструменти можуть надати вам кращу підтримку.
 
-Це лише **швидкий туторіал / нагадування** про підказки типів у Python. Він покриває лише мінімум, необхідний щоб використовувати їх з **FastAPI**... що насправді дуже мало.
+Це лише **швидкий навчальний посібник / нагадування** про підказки типів у Python. Він покриває лише мінімум, необхідний щоб використовувати їх з **FastAPI**... що насправді дуже мало.
 
 **FastAPI** повністю базується на цих підказках типів, вони дають йому багато переваг і користі.
 
@@ -22,7 +22,7 @@ Python підтримує додаткові «підказки типів» (т
 
 Давайте почнемо з простого прикладу:
 
-{* ../../docs_src/python_types/tutorial001_py39.py *}
+{* ../../docs_src/python_types/tutorial001_py310.py *}
 
 Виклик цієї програми виводить:
 
@@ -34,9 +34,9 @@ John Doe
 
 * Бере `first_name` та `last_name`.
 * Перетворює першу літеру кожного з них у верхній регістр за допомогою `title()`.
-* <abbr title="Об’єднує їх разом, як одне ціле. З вмістом один за одним.">Конкатенує</abbr> їх разом із пробілом по середині.
+* <dfn title="Об’єднує їх разом, як одне ціле. З вмістом одного після іншого.">Конкатенує</dfn> їх разом із пробілом по середині.
 
-{* ../../docs_src/python_types/tutorial001_py39.py hl[2] *}
+{* ../../docs_src/python_types/tutorial001_py310.py hl[2] *}
 
 ### Редагуйте це { #edit-it }
 
@@ -78,7 +78,7 @@ John Doe
 
 Це «підказки типів»:
 
-{* ../../docs_src/python_types/tutorial002_py39.py hl[1] *}
+{* ../../docs_src/python_types/tutorial002_py310.py hl[1] *}
 
 Це не те саме, що оголошення значень за замовчуванням, як це було б з:
 
@@ -106,15 +106,15 @@ John Doe
 
 Перевірте цю функцію, вона вже має підказки типів:
 
-{* ../../docs_src/python_types/tutorial003_py39.py hl[1] *}
+{* ../../docs_src/python_types/tutorial003_py310.py hl[1] *}
 
 Оскільки редактор знає типи змінних, ви не тільки отримаєте автозаповнення, ви також отримаєте перевірку помилок:
 
 <img src="/img/python-types/image04.png">
 
-ТепеÑ\80 ви знаÑ\94Ñ\82е, Ñ\89об випÑ\80авиÑ\82и Ñ\86е, вам поÑ\82Ñ\80Ñ\96бно пеÑ\80еÑ\82воÑ\80иÑ\82и `age` Ñ\83 Ñ\80Ñ\8fдок за допомогою `str(age)`:
+ТепеÑ\80 ви знаÑ\94Ñ\82е, Ñ\89об випÑ\80авиÑ\82и Ñ\86е, вам поÑ\82Ñ\80Ñ\96бно пеÑ\80еÑ\82воÑ\80иÑ\82и `age` Ñ\83 Ñ\81Ñ\82Ñ\80окÑ\83 за допомогою `str(age)`:
 
-{* ../../docs_src/python_types/tutorial004_py39.py hl[2] *}
+{* ../../docs_src/python_types/tutorial004_py310.py hl[2] *}
 
 ## Оголошення типів { #declaring-types }
 
@@ -133,29 +133,32 @@ John Doe
 * `bool`
 * `bytes`
 
-{* ../../docs_src/python_types/tutorial005_py39.py hl[1] *}
+{* ../../docs_src/python_types/tutorial005_py310.py hl[1] *}
 
-### Generic-типи з параметрами типів { #generic-types-with-type-parameters }
+### Модуль `typing` { #typing-module }
 
-Ð\86Ñ\81нÑ\83Ñ\8eÑ\82Ñ\8c деÑ\8fкÑ\96 Ñ\81Ñ\82Ñ\80Ñ\83кÑ\82Ñ\83Ñ\80и даниÑ\85, Ñ\8fкÑ\96 можÑ\83Ñ\82Ñ\8c мÑ\96Ñ\81Ñ\82иÑ\82и Ñ\96нÑ\88Ñ\96 знаÑ\87еннÑ\8f, напÑ\80иклад `dict`, `list`, `set` Ñ\82а `tuple`. Ð\86 внÑ\83Ñ\82Ñ\80Ñ\96Ñ\88нÑ\96 знаÑ\87еннÑ\8f Ñ\82акож можÑ\83Ñ\82Ñ\8c маÑ\82и Ñ\81вÑ\96й Ñ\82ип.
+Ð\94лÑ\8f деÑ\8fкиÑ\85 додаÑ\82ковиÑ\85 випадкÑ\96в викоÑ\80иÑ\81Ñ\82аннÑ\8f може знадобиÑ\82иÑ\81Ñ\8f Ñ\96мпоÑ\80Ñ\82Ñ\83ваÑ\82и елеменÑ\82и зÑ\96 Ñ\81Ñ\82андаÑ\80Ñ\82ноÑ\97 бÑ\96блÑ\96оÑ\82еки, модÑ\83лÑ\8f `typing`. Ð\9dапÑ\80иклад, коли ви Ñ\85оÑ\87еÑ\82е оголоÑ\81иÑ\82и, Ñ\89о Ñ\89оÑ\81Ñ\8c маÑ\94 «бÑ\83дÑ\8c-Ñ\8fкий Ñ\82ип», ви можеÑ\82е викоÑ\80иÑ\81Ñ\82аÑ\82и `Any` з `typing`:
 
-Ці типи, які мають внутрішні типи, називаються «**generic**» типами. І оголосити їх можна навіть із внутрішніми типами.
+```python
+from typing import Any
 
-Щоб оголосити ці типи та внутрішні типи, ви можете використовувати стандартний модуль Python `typing`. Він існує спеціально для підтримки цих підказок типів.
 
-#### Новіші версії Python { #newer-versions-of-python }
-
-Синтаксис із використанням `typing` **сумісний** з усіма версіями, від Python 3.6 до останніх, включаючи Python 3.9, Python 3.10 тощо.
+def some_function(data: Any):
+    print(data)
+```
 
-У міру розвитку Python **новіші версії** мають покращену підтримку цих анотацій типів і в багатьох випадках вам навіть не потрібно буде імпортувати та використовувати модуль `typing` для оголошення анотацій типів.
+### Generic типи { #generic-types }
 
-ЯкÑ\89о ви можеÑ\82е вибÑ\80аÑ\82и новÑ\96Ñ\88Ñ\83 веÑ\80Ñ\81Ñ\96Ñ\8e Python длÑ\8f Ñ\81вого пÑ\80оекÑ\82Ñ\83, ви зможеÑ\82е Ñ\81коÑ\80иÑ\81Ñ\82аÑ\82иÑ\81Ñ\8f Ñ\86Ñ\96Ñ\94Ñ\8e додаÑ\82ковоÑ\8e пÑ\80оÑ\81Ñ\82оÑ\82оÑ\8e.
+Ð\94еÑ\8fкÑ\96 Ñ\82ипи можÑ\83Ñ\82Ñ\8c пÑ\80иймаÑ\82и «паÑ\80амеÑ\82Ñ\80и Ñ\82ипÑ\96в» Ñ\83 квадÑ\80аÑ\82ниÑ\85 дÑ\83жкаÑ\85, Ñ\89об визнаÑ\87иÑ\82и Ñ\97Ñ\85 внÑ\83Ñ\82Ñ\80Ñ\96Ñ\88нÑ\96 Ñ\82ипи. Ð\9dапÑ\80иклад, «list Ñ\81Ñ\82Ñ\80ок» бÑ\83де оголоÑ\88ений Ñ\8fк `list[str]`.
 
-У вÑ\81Ñ\96й докÑ\83менÑ\82аÑ\86Ñ\96Ñ\97 Ñ\94 пÑ\80иклади, Ñ\81Ñ\83мÑ\96Ñ\81нÑ\96 з кожноÑ\8e веÑ\80Ñ\81Ñ\96Ñ\94Ñ\8e Python (коли Ñ\94 Ñ\80Ñ\96зниÑ\86Ñ\8f).
+ЦÑ\96 Ñ\82ипи, Ñ\8fкÑ\96 можÑ\83Ñ\82Ñ\8c пÑ\80иймаÑ\82и паÑ\80амеÑ\82Ñ\80и Ñ\82ипÑ\96в, називаÑ\8eÑ\82Ñ\8cÑ\81Ñ\8f **generic Ñ\82ипами** або **generics**.
 
-Ð\9dапÑ\80иклад, «**Python 3.6+**» ознаÑ\87аÑ\94, Ñ\89о Ñ\86е Ñ\81Ñ\83мÑ\96Ñ\81но з Python 3.6 або виÑ\89е (вклÑ\8eÑ\87но з 3.7, 3.8, 3.9, 3.10 Ñ\82оÑ\89о). Ð\90 «**Python 3.9+**» ознаÑ\87аÑ\94, Ñ\89о Ñ\86е Ñ\81Ñ\83мÑ\96Ñ\81но з Python 3.9 або виÑ\89е (вклÑ\8eÑ\87аÑ\8eÑ\87и 3.10 Ñ\82оÑ\89о).
+Ð\92и можеÑ\82е викоÑ\80иÑ\81Ñ\82овÑ\83ваÑ\82и Ñ\82Ñ\96 Ñ\81амÑ\96 вбÑ\83дованÑ\96 Ñ\82ипи Ñ\8fк generics (з квадÑ\80аÑ\82ними дÑ\83жками Ñ\82а Ñ\82ипами вÑ\81еÑ\80единÑ\96):
 
-Якщо ви можете використовувати **останні версії Python**, використовуйте приклади для останньої версії — вони матимуть **найкращий і найпростіший синтаксис**, наприклад, «**Python 3.10+**».
+* `list`
+* `tuple`
+* `set`
+* `dict`
 
 #### List { #list }
 
@@ -167,7 +170,7 @@ John Doe
 
 Оскільки список є типом, який містить деякі внутрішні типи, ви поміщаєте їх у квадратні дужки:
 
-{* ../../docs_src/python_types/tutorial006_py39.py hl[1] *}
+{* ../../docs_src/python_types/tutorial006_py310.py hl[1] *}
 
 /// info | Інформація
 
@@ -193,7 +196,7 @@ John Doe
 
 Ви повинні зробити те ж саме, щоб оголосити `tuple` і `set`:
 
-{* ../../docs_src/python_types/tutorial007_py39.py hl[1] *}
+{* ../../docs_src/python_types/tutorial007_py310.py hl[1] *}
 
 Це означає:
 
@@ -208,56 +211,32 @@ John Doe
 
 Другий параметр типу для значень у `dict`:
 
-{* ../../docs_src/python_types/tutorial008_py39.py hl[1] *}
+{* ../../docs_src/python_types/tutorial008_py310.py hl[1] *}
 
 Це означає:
 
 * Змінна `prices` — це `dict`:
-    * Ð\9aлÑ\8eÑ\87Ñ\96 Ñ\86Ñ\8cого `dict` маÑ\8eÑ\82Ñ\8c Ñ\82ип `str` (Ñ\81кажÑ\96мо, назва кожного елеменÑ\82Ñ\83).
-    * Ð\97наÑ\87еннÑ\8f Ñ\86Ñ\8cого `dict` маÑ\8eÑ\82Ñ\8c Ñ\82ип `float` (Ñ\81кажÑ\96мо, Ñ\86Ñ\96на кожного елеменÑ\82Ñ\83).
+    * Ð\9aлÑ\8eÑ\87Ñ\96 Ñ\86Ñ\8cого `dict` маÑ\8eÑ\82Ñ\8c Ñ\82ип `str` (Ñ\81кажÑ\96мо, назва кожного пÑ\80едмеÑ\82а).
+    * Ð\97наÑ\87еннÑ\8f Ñ\86Ñ\8cого `dict` маÑ\8eÑ\82Ñ\8c Ñ\82ип `float` (Ñ\81кажÑ\96мо, Ñ\86Ñ\96на кожного пÑ\80едмеÑ\82а).
 
 #### Union { #union }
 
 Ви можете оголосити, що змінна може бути будь-яким із **кількох типів**, наприклад `int` або `str`.
 
-У Python 3.6 і вище (включаючи Python 3.10) ви можете використовувати тип `Union` з `typing` і вставляти в квадратні дужки можливі типи, які можна прийняти.
-
-У Python 3.10 також є **новий синтаксис**, у якому ви можете розділити можливі типи за допомогою <abbr title='також називають «побітовим "або" оператором», але це значення тут не актуальне'>вертикальної смуги (`|`)</abbr>.
+Щоб визначити це, використовуйте <dfn title='також називають «побітовим оператором "або"», але це значення тут не актуальне'>вертикальну риску (`|`)</dfn>, щоб розділити обидва типи.
 
-//// tab | Python 3.10+
+Це називається «union», тому що змінна може бути чимось із об’єднання цих двох множин типів.
 
 ```Python hl_lines="1"
 {!> ../../docs_src/python_types/tutorial008b_py310.py!}
 ```
 
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="1  4"
-{!> ../../docs_src/python_types/tutorial008b_py39.py!}
-```
-
-////
-
-В обох випадках це означає, що `item` може бути `int` або `str`.
+Це означає, що `item` може бути `int` або `str`.
 
 #### Можливо `None` { #possibly-none }
 
 Ви можете оголосити, що значення може мати тип, наприклад `str`, але також може бути `None`.
 
-У Python 3.6 і вище (включаючи Python 3.10) ви можете оголосити його, імпортувавши та використовуючи `Optional` з модуля `typing`.
-
-```Python hl_lines="1  4"
-{!../../docs_src/python_types/tutorial009_py39.py!}
-```
-
-Використання `Optional[str]` замість просто `str` дозволить редактору допомогти вам виявити помилки, коли ви могли б вважати, що значенням завжди є `str`, хоча насправді воно також може бути `None`.
-
-`Optional[Something]` насправді є скороченням для `Union[Something, None]`, вони еквівалентні.
-
-Це також означає, що в Python 3.10 ви можете використовувати `Something | None`:
-
 //// tab | Python 3.10+
 
 ```Python hl_lines="1"
@@ -266,96 +245,7 @@ John Doe
 
 ////
 
-//// tab | Python 3.9+
-
-```Python hl_lines="1  4"
-{!> ../../docs_src/python_types/tutorial009_py39.py!}
-```
-
-////
-
-//// tab | Python 3.9+ alternative
-
-```Python hl_lines="1  4"
-{!> ../../docs_src/python_types/tutorial009b_py39.py!}
-```
-
-////
-
-#### Використання `Union` або `Optional` { #using-union-or-optional }
-
-Якщо ви використовуєте версію Python нижче 3.10, ось порада з моєї дуже **суб’єктивної** точки зору:
-
-* 🚨 Уникайте використання `Optional[SomeType]`
-* Натомість ✨ **використовуйте `Union[SomeType, None]`** ✨.
-
-Обидва варіанти еквівалентні й «під капотом» це одне й те саме, але я рекомендую `Union` замість `Optional`, тому що слово «**optional**» може створювати враження, ніби значення є необов’язковим, хоча насправді це означає «воно може бути `None`», навіть якщо воно не є необов’язковим і все одно є обов’язковим.
-
-Я вважаю, що `Union[SomeType, None]` більш явно показує, що саме мається на увазі.
-
-Це лише про слова й назви. Але ці слова можуть впливати на те, як ви та ваша команда думаєте про код.
-
-Як приклад, розгляньмо цю функцію:
-
-{* ../../docs_src/python_types/tutorial009c_py39.py hl[1,4] *}
-
-Параметр `name` визначено як `Optional[str]`, але він **не є необов’язковим**, ви не можете викликати функцію без параметра:
-
-```Python
-say_hi()  # Ой, ні, це викликає помилку! 😱
-```
-
-Параметр `name` **все ще є обов’язковим** (не *optional*), тому що він не має значення за замовчуванням. Водночас `name` приймає `None` як значення:
-
-```Python
-say_hi(name=None)  # Це працює, None є валідним 🎉
-```
-
-Добра новина: щойно ви перейдете на Python 3.10, вам не доведеться про це хвилюватися, адже ви зможете просто використовувати `|` для визначення об’єднань типів:
-
-{* ../../docs_src/python_types/tutorial009c_py310.py hl[1,4] *}
-
-І тоді вам не доведеться хвилюватися про назви на кшталт `Optional` і `Union`. 😎
-
-#### Generic типи { #generic-types }
-
-Ці типи, які приймають параметри типу у квадратних дужках, називаються **Generic types** or **Generics**, наприклад:
-
-//// tab | Python 3.10+
-
-Ви можете використовувати ті самі вбудовані типи як generic (з квадратними дужками та типами всередині):
-
-* `list`
-* `tuple`
-* `set`
-* `dict`
-
-І так само, як і в попередніх версіях Python, з модуля `typing`:
-
-* `Union`
-* `Optional`
-* ...та інші.
-
-У Python 3.10 як альтернативу використанню generic `Union` та `Optional` ви можете використовувати <abbr title='також називають «побітовим "або" оператором», але це значення тут не актуальне'>вертикальну смугу (`|`)</abbr> для оголошення об’єднань типів — це значно краще й простіше.
-
-////
-
-//// tab | Python 3.9+
-
-Ви можете використовувати ті самі вбудовані типи як generic (з квадратними дужками та типами всередині):
-
-* `list`
-* `tuple`
-* `set`
-* `dict`
-
-І generic з модуля `typing`:
-
-* `Union`
-* `Optional`
-* ...та інші.
-
-////
+Використання `str | None` замість просто `str` дозволить редактору допомогти вам виявити помилки, коли ви могли б вважати, що значенням завжди є `str`, хоча насправді воно також може бути `None`.
 
 ### Класи як типи { #classes-as-types }
 
@@ -363,11 +253,11 @@ say_hi(name=None)  # Це працює, None є валідним 🎉
 
 Скажімо, у вас є клас `Person` з імʼям:
 
-{* ../../docs_src/python_types/tutorial010_py39.py hl[1:3] *}
+{* ../../docs_src/python_types/tutorial010_py310.py hl[1:3] *}
 
 Потім ви можете оголосити змінну типу `Person`:
 
-{* ../../docs_src/python_types/tutorial010_py39.py hl[6] *}
+{* ../../docs_src/python_types/tutorial010_py310.py hl[6] *}
 
 І знову ж таки, ви отримуєте всю підтримку редактора:
 
@@ -401,21 +291,15 @@ say_hi(name=None)  # Це працює, None є валідним 🎉
 
 **FastAPI** повністю базується на Pydantic.
 
-Ви побачите набагато більше цього всього на практиці в [Tutorial - User Guide](tutorial/index.md){.internal-link target=_blank}.
-
-/// tip | Порада
-
-Pydantic має спеціальну поведінку, коли ви використовуєте `Optional` або `Union[Something, None]` без значення за замовчуванням; детальніше про це можна прочитати в документації Pydantic про <a href="https://docs.pydantic.dev/2.3/usage/models/#required-fields" class="external-link" target="_blank">Required Optional fields</a>.
-
-///
+Ви побачите набагато більше цього всього на практиці в [Навчальний посібник - Посібник користувача](tutorial/index.md){.internal-link target=_blank}.
 
 ## Підказки типів з анотаціями метаданих { #type-hints-with-metadata-annotations }
 
-У Python також є можливість додавати **додаткові <abbr title="Дані про дані, у цьому випадку — інформація про тип, наприклад опис.">метадані</abbr>** до цих підказок типів за допомогою `Annotated`.
+У Python також є можливість додавати **додаткові <dfn title="Дані про дані, у цьому випадку — інформація про тип, наприклад опис.">метадані</dfn>** до цих підказок типів за допомогою `Annotated`.
 
-Ð\9fоÑ\87инаÑ\8eÑ\87и з Python 3.9, `Annotated` Ñ\94 Ñ\87аÑ\81Ñ\82иноÑ\8e Ñ\81Ñ\82андаÑ\80Ñ\82ноÑ\97 бÑ\96блÑ\96оÑ\82еки, Ñ\82ож ви можеÑ\82е Ñ\96мпоÑ\80Ñ\82Ñ\83ваÑ\82и його з `typing`.
+Ð\92и можеÑ\82е Ñ\96мпоÑ\80Ñ\82Ñ\83ваÑ\82и `Annotated` з `typing`.
 
-{* ../../docs_src/python_types/tutorial013_py39.py hl[1,4] *}
+{* ../../docs_src/python_types/tutorial013_py310.py hl[1,4] *}
 
 Сам Python нічого не робить із цим `Annotated`. А для редакторів та інших інструментів тип усе ще є `str`.
 
@@ -435,7 +319,7 @@ Pydantic має спеціальну поведінку, коли ви вико
 
 ///
 
-## Ð\90ноÑ\82аÑ\86Ñ\96Ñ\97 типів у **FastAPI** { #type-hints-in-fastapi }
+## Ð\9fÑ\96дказки типів у **FastAPI** { #type-hints-in-fastapi }
 
 **FastAPI** використовує ці підказки типів для виконання кількох речей.
 
@@ -453,12 +337,12 @@ Pydantic має спеціальну поведінку, коли ви вико
 * **Документування** API за допомогою OpenAPI:
     * який потім використовується для автоматичної інтерактивної документації користувальницьких інтерфейсів.
 
-Все це може здатися абстрактним. Не хвилюйтеся. Ви побачите все це в дії в [Tutorial - User Guide](tutorial/index.md){.internal-link target=_blank}.
+Все це може здатися абстрактним. Не хвилюйтеся. Ви побачите все це в дії в [Навчальний посібник - Посібник користувача](tutorial/index.md){.internal-link target=_blank}.
 
 Важливо те, що за допомогою стандартних типів Python в одному місці (замість того, щоб додавати більше класів, декораторів тощо), **FastAPI** зробить багато роботи за вас.
 
 /// info | Інформація
 
-Якщо ви вже пройшли весь туторіал і повернулися, щоб дізнатися більше про типи, ось хороший ресурс: <a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">«шпаргалка» від `mypy`</a>.
+Якщо ви вже пройшли весь навчальний посібник і повернулися, щоб дізнатися більше про типи, ось хороший ресурс: <a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">«шпаргалка» від `mypy`</a>.
 
 ///

diff --git a/docs/uk/docs/tutorial/background-tasks.md b/docs/uk/docs/tutorial/background-tasks.md
index 6d7804195e26326313aeb7431dd69b45c07ce22f..71266a8b10c41e6b779eb23555111dd664b5724a 100644 (file)
--- a/docs/uk/docs/tutorial/background-tasks.md
+++ b/docs/uk/docs/tutorial/background-tasks.md
@@ -1,6 +1,6 @@
 # Фонові задачі { #background-tasks }
 
-Ви можете створювати фонові задачі, які будуть виконуватися *після* повернення відповіді.
+Ви можете створювати фонові задачі, які будуть виконуватися після повернення відповіді.
 
 Це корисно для операцій, які потрібно виконати після обробки запиту, але клієнту не обов’язково чекати завершення цієї операції перед отриманням відповіді.
 
@@ -13,9 +13,9 @@
 
 ## Використання `BackgroundTasks` { #using-backgroundtasks }
 
-Спочатку імпортуйте `BackgroundTasks` і оголосіть параметр у вашій *функції операції шляху* з анотацією типу `BackgroundTasks`:
+Спочатку імпортуйте `BackgroundTasks` і оголосіть параметр у вашій функції операції шляху з анотацією типу `BackgroundTasks`:
 
-{* ../../docs_src/background_tasks/tutorial001_py39.py hl[1,13] *}
+{* ../../docs_src/background_tasks/tutorial001_py310.py hl[1,13] *}
 
 **FastAPI** створить для вас об’єкт типу `BackgroundTasks` і передасть його як цей параметр.
 
@@ -31,13 +31,13 @@
 
 І оскільки операція запису не використовує `async` та `await`, ми визначаємо функцію як звичайну `def`:
 
-{* ../../docs_src/background_tasks/tutorial001_py39.py hl[6:9] *}
+{* ../../docs_src/background_tasks/tutorial001_py310.py hl[6:9] *}
 
 ## Додавання фонової задачі { #add-the-background-task }
 
-Усередині вашої *функції операції шляху*, передайте функцію задачі в об'єкт *background tasks*, використовуючи метод `.add_task()`:
+Усередині вашої функції операції шляху, передайте функцію задачі в об'єкт background tasks, використовуючи метод `.add_task()`:
 
-{* ../../docs_src/background_tasks/tutorial001_py39.py hl[14] *}
+{* ../../docs_src/background_tasks/tutorial001_py310.py hl[14] *}
 
 `.add_task()` приймає аргументи:
 
@@ -47,17 +47,17 @@
 
 ## Впровадження залежностей { #dependency-injection }
 
-Використання `BackgroundTasks` також працює з системою впровадження залежностей. Ви можете оголосити параметр типу `BackgroundTasks` на різних рівнях: у *функції операції шляху*, у залежності (dependable), у підзалежності тощо.
+Використання `BackgroundTasks` також працює з системою впровадження залежностей. Ви можете оголосити параметр типу `BackgroundTasks` на різних рівнях: у функції операції шляху, у залежності (залежний), у підзалежності тощо.
 
-**FastAPI**  знає, як діяти в кожному випадку і як повторно використовувати один і той самий об'єкт, щоб усі фонові задачі були об’єднані та виконувалися у фоновому режимі після завершення основного запиту:
+**FastAPI** знає, як діяти в кожному випадку і як повторно використовувати один і той самий об'єкт, щоб усі фонові задачі були об’єднані та виконувалися у фоновому режимі після завершення основного запиту:
 
 {* ../../docs_src/background_tasks/tutorial002_an_py310.py hl[13,15,22,25] *}
 
-У цьому прикладі повідомлення будуть записані у файл `log.txt` *після* того, як відповідь буде надіслана.
+У цьому прикладі повідомлення будуть записані у файл `log.txt` після того, як відповідь буде надіслана.
 
-Якщо у запиті був переданий query, він буде записаний у лог у фоновій задачі.
+Якщо у запиті був переданий параметр запиту, він буде записаний у лог у фоновій задачі.
 
-А потім інша фонова задача, згенерована у *функції операції шляху*, запише повідомлення з використанням path параметра `email`.
+А потім інша фонова задача, згенерована у функції операції шляху, запише повідомлення з використанням параметра шляху `email`.
 
 ## Технічні деталі { #technical-details }
 
@@ -65,7 +65,7 @@
 
 Він імпортується/включається безпосередньо у FastAPI, щоб ви могли імпортувати його з `fastapi` і випадково не імпортували альтернативний `BackgroundTask` (без `s` в кінці) з `starlette.background`.
 
-Якщо використовувати лише `BackgroundTasks` (а не `BackgroundTask`), то його можна передавати як параметр у *функції операції шляху*, і **FastAPI** подбає про все інше, так само як і про використання об'єкта `Request`.
+Якщо використовувати лише `BackgroundTasks` (а не `BackgroundTask`), то його можна передавати як параметр у функції операції шляху, і **FastAPI** подбає про все інше, так само як і про використання об'єкта `Request`.
 
 Також можна використовувати `BackgroundTask` окремо в FastAPI, але для цього вам доведеться створити об'єкт у коді та повернути Starlette `Response`, включаючи його.
 
@@ -81,4 +81,4 @@
 
 ## Підсумок { #recap }
 
-Імпортуйте та використовуйте `BackgroundTasks` як параметри у *функціях операції шляху* та залежностях, щоб додавати фонові задачі.
+Імпортуйте та використовуйте `BackgroundTasks` як параметри у функціях операції шляху та залежностях, щоб додавати фонові задачі.

diff --git a/docs/uk/docs/tutorial/body-multiple-params.md b/docs/uk/docs/tutorial/body-multiple-params.md
index f541beea76791f2b219cc48deb294cc89feff983..a0db2b1865463b4cd8ff1f2a4f9e76e7891c92c2 100644 (file)
--- a/docs/uk/docs/tutorial/body-multiple-params.md
+++ b/docs/uk/docs/tutorial/body-multiple-params.md
@@ -18,7 +18,7 @@
 
 ## Декілька параметрів тіла { #multiple-body-parameters }
 
-У попередньому прикладі *операції шляху* очікували б JSON-тіло з атрибутами `Item`, наприклад:
+У попередньому прикладi *операції шляху* очікували б JSON-тіло з атрибутами `Item`, наприклад:
 
 ```JSON
 {
@@ -106,13 +106,6 @@
 q: str | None = None
 ```
 
-Або в Python 3.9:
-
-```Python
-q: Union[str, None] = None
-```
-
-
 Наприклад:
 
 {* ../../docs_src/body_multiple_params/tutorial004_an_py310.py hl[28] *}

diff --git a/docs/uk/docs/tutorial/body-nested-models.md b/docs/uk/docs/tutorial/body-nested-models.md
index 6d0669358a3dccab4915d77e62403d66541d7fc0..a56ae484df31d9ade0a66a1011e6fc1065170930 100644 (file)
--- a/docs/uk/docs/tutorial/body-nested-models.md
+++ b/docs/uk/docs/tutorial/body-nested-models.md
@@ -164,7 +164,7 @@ images: list[Image]
 
 наприклад:
 
-{* ../../docs_src/body_nested_models/tutorial008_py39.py hl[13] *}
+{* ../../docs_src/body_nested_models/tutorial008_py310.py hl[13] *}
 
 ## Підтримка в редакторі всюди { #editor-support-everywhere }
 
@@ -194,7 +194,7 @@ images: list[Image]
 
 У цьому випадку ви можете приймати будь-який `dict`, якщо його ключі — це `int`, а значення — `float`:
 
-{* ../../docs_src/body_nested_models/tutorial009_py39.py hl[7] *}
+{* ../../docs_src/body_nested_models/tutorial009_py310.py hl[7] *}
 
 /// tip | Порада
 
@@ -216,6 +216,6 @@ images: list[Image]
 
 * Підтримка в редакторі (автодоповнення всюди!)
 * Конвертація даних (парсинг/сериалізація)
-* Ð\92алÑ\96даÑ\86Ñ\96Ñ\8e даних
+* Ð\92алÑ\96даÑ\86Ñ\96Ñ\8f даних
 * Документація схем
 * Автоматичне створення документації

diff --git a/docs/uk/docs/tutorial/body.md b/docs/uk/docs/tutorial/body.md
index ca1f308ab5495b932df0a0f9acdeb6a6b83398e5..615f0274cc7b4143c1d780853b151e28b4cdbe26 100644 (file)
--- a/docs/uk/docs/tutorial/body.md
+++ b/docs/uk/docs/tutorial/body.md
@@ -8,7 +8,7 @@
 
 Щоб оголосити тіло **запиту**, ви використовуєте <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a> моделі з усією їх потужністю та перевагами.
 
-/// info | Інформація
+/// info
 
 Щоб надіслати дані, ви повинні використовувати один із: `POST` (більш поширений), `PUT`, `DELETE` або `PATCH`.
 
@@ -73,8 +73,8 @@
     * Якщо дані недійсні, він поверне гарну та чітку помилку, вказуючи, де саме і які дані були неправильними.
 * Надавати отримані дані у параметрі `item`.
     * Оскільки ви оголосили його у функції як тип `Item`, ви також матимете всю підтримку редактора (автозаповнення, тощо) для всіх атрибутів та їх типів.
-* Генерувати <a href="https://json-schema.org" class="external-link" target="_blank">JSON Schema</a> визначення для вашої моделі, ви також можете використовувати їх де завгодно, якщо це має сенс для вашого проекту.
-* Ці схеми будуть частиною згенерованої схеми OpenAPI і використовуватимуться автоматичною документацією <abbr title="User Interfaces – Інтерфейси користувача">UIs</abbr>.
+* Генерувати визначення <a href="https://json-schema.org" class="external-link" target="_blank">Схеми JSON</a> для вашої моделі, ви також можете використовувати їх де завгодно, якщо це має сенс для вашого проекту.
+* Ці схеми будуть частиною згенерованої схеми OpenAPI і використовуватимуться автоматичною документацією <abbr title="User Interfaces - Інтерфейси користувача">UIs</abbr>.
 
 ## Автоматична документація { #automatic-docs }
 
@@ -108,7 +108,7 @@
 
 <img src="/img/tutorial/body/image05.png">
 
-/// tip | Порада
+/// tip
 
 Якщо ви використовуєте <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a> як ваш редактор, ви можете використати <a href="https://github.com/koxudaxi/pydantic-pycharm-plugin/" class="external-link" target="_blank">Pydantic PyCharm Plugin</a>.
 
@@ -151,11 +151,11 @@
 * Якщо параметр має **сингулярний тип** (наприклад, `int`, `float`, `str`, `bool` тощо), він буде інтерпретуватися як параметр **запиту**.
 * Якщо параметр оголошується як тип **Pydantic моделі**, він інтерпретується як **тіло** **запиту**.
 
-/// note | Примітка
+/// note
 
 FastAPI буде знати, що значення `q` не є обов'язковим через значення за замовчуванням `= None`.
 
-`str | None` (Python 3.10+) або `Union` у `Union[str, None]` (Python 3.9+) FastAPI не використовує, щоб визначити, що значення не є обов’язковим — він знатиме, що воно не є обов’язковим, тому що має значення за замовчуванням `= None`.
+`str | None` FastAPI не використовує, щоб визначити, що значення не є обов’язковим - він знатиме, що воно не є обов’язковим, тому що має значення за замовчуванням `= None`.
 
 Але додавання анотацій типів дозволить вашому редактору надати вам кращу підтримку та виявляти помилки.
 
@@ -163,4 +163,4 @@ FastAPI буде знати, що значення `q` не є обов'язко
 
 ## Без Pydantic { #without-pydantic }
 
-Якщо ви не хочете використовувати моделі Pydantic, ви також можете використовувати параметри **Body**. Перегляньте документацію для [Body - Multiple Parameters: Singular values in body](body-multiple-params.md#singular-values-in-body){.internal-link target=_blank}.
+Якщо ви не хочете використовувати моделі Pydantic, ви також можете використовувати параметри **Body**. Перегляньте документацію для [Тіло - Кілька параметрів: Окремі значення в тілі](body-multiple-params.md#singular-values-in-body){.internal-link target=_blank}.

diff --git a/docs/uk/docs/tutorial/cookie-param-models.md b/docs/uk/docs/tutorial/cookie-param-models.md
index 3c6407716ed198060ee43b2079f993633b3b0240..dab57c5365ad2a8ec2fbf762beac561db7eb959f 100644 (file)
--- a/docs/uk/docs/tutorial/cookie-param-models.md
+++ b/docs/uk/docs/tutorial/cookie-param-models.md
@@ -1,8 +1,8 @@
 # Моделі параметрів Cookie { #cookie-parameter-models }
 
-ЯкÑ\89о Ñ\83 Ð\92аÑ\81 Ñ\94 гÑ\80Ñ\83па **cookies**, Ñ\8fкÑ\96 пов'Ñ\8fзанÑ\96 мÑ\96ж Ñ\81обоÑ\8e, Ð\92и можете створити **Pydantic-модель**, щоб оголосити їх. 🍪
+ЯкÑ\89о Ñ\83 ваÑ\81 Ñ\94 гÑ\80Ñ\83па **cookies**, Ñ\8fкÑ\96 пов'Ñ\8fзанÑ\96 мÑ\96ж Ñ\81обоÑ\8e, ви можете створити **Pydantic-модель**, щоб оголосити їх. 🍪
 
-Це дозволиÑ\82Ñ\8c Ð\92ам повторно **використовувати модель** у **різних місцях**, а також оголосити валідацію та метадані для всіх параметрів одночасно. 😎
+Це дозволиÑ\82Ñ\8c вам повторно **використовувати модель** у **різних місцях**, а також оголосити валідацію та метадані для всіх параметрів одночасно. 😎
 
 /// note | Примітка
 
@@ -18,11 +18,11 @@
 
 ## Cookie з Pydantic-моделлю { #cookies-with-a-pydantic-model }
 
-Ð\9eголоÑ\81Ñ\96Ñ\82Ñ\8c **cookie**-паÑ\80амеÑ\82Ñ\80и, Ñ\8fкÑ\96 Ð\92ам потрібні, у **Pydantic-моделі**, а потім оголосіть параметр як `Cookie`:
+Ð\9eголоÑ\81Ñ\96Ñ\82Ñ\8c **cookie**-паÑ\80амеÑ\82Ñ\80и, Ñ\8fкÑ\96 вам потрібні, у **Pydantic-моделі**, а потім оголосіть параметр як `Cookie`:
 
 {* ../../docs_src/cookie_param_models/tutorial001_an_py310.py hl[9:12,16] *}
 
-**FastAPI** бÑ\83де **виÑ\82Ñ\8fгÑ\83ваÑ\82и** данÑ\96 длÑ\8f **кожного полÑ\8f** з **cookies**, оÑ\82Ñ\80иманиÑ\85 Ñ\83 запиÑ\82Ñ\96, Ñ\96 пеÑ\80едаваÑ\82и Ð\92ам Pydantic-моделÑ\8c, Ñ\8fкÑ\83 Ð\92и визначили.
+**FastAPI** бÑ\83де **виÑ\82Ñ\8fгÑ\83ваÑ\82и** данÑ\96 длÑ\8f **кожного полÑ\8f** з **cookies**, оÑ\82Ñ\80иманиÑ\85 Ñ\83 запиÑ\82Ñ\96, Ñ\96 пеÑ\80едаваÑ\82и вам Pydantic-моделÑ\8c, Ñ\8fкÑ\83 ви визначили.
 
 ## Перевірка у документації { #check-the-docs }
 
@@ -36,17 +36,17 @@
 
 Майте на увазі, що оскільки **браузери обробляють cookies** особливим чином і «за лаштунками», вони **не** дозволяють **JavaScript** легко з ними працювати.
 
-ЯкÑ\89о Ð\92и зайдеÑ\82е до **Ñ\96нÑ\82еÑ\80Ñ\84ейÑ\81Ñ\83 докÑ\83менÑ\82аÑ\86Ñ\96Ñ\97 API** за адÑ\80еÑ\81оÑ\8e `/docs`, Ð\92и зможеÑ\82е побаÑ\87иÑ\82и **докÑ\83менÑ\82аÑ\86Ñ\96Ñ\8e** длÑ\8f cookies Ñ\83 Ð\92аших *операціях шляху*.
+ЯкÑ\89о ви зайдеÑ\82е до **Ñ\96нÑ\82еÑ\80Ñ\84ейÑ\81Ñ\83 докÑ\83менÑ\82аÑ\86Ñ\96Ñ\97 API** за адÑ\80еÑ\81оÑ\8e `/docs`, ви зможеÑ\82е побаÑ\87иÑ\82и **докÑ\83менÑ\82аÑ\86Ñ\96Ñ\8e** длÑ\8f cookies Ñ\83 ваших *операціях шляху*.
 
-Ð\90ле навÑ\96Ñ\82Ñ\8c Ñ\8fкÑ\89о Ð\92и заповниÑ\82е данÑ\96 й наÑ\82иÑ\81неÑ\82е "Execute", оÑ\81кÑ\96лÑ\8cки Ñ\96нÑ\82еÑ\80Ñ\84ейÑ\81 докÑ\83менÑ\82аÑ\86Ñ\96Ñ\97 пÑ\80аÑ\86Ñ\8eÑ\94 з **JavaScript**, cookies не бÑ\83дÑ\83Ñ\82Ñ\8c вÑ\96дпÑ\80авленÑ\96, Ñ\96 Ð\92и побаÑ\87иÑ\82е **помилкÑ\83**, нÑ\96би Ð\92и не ввели жодних значень.
+Ð\90ле навÑ\96Ñ\82Ñ\8c Ñ\8fкÑ\89о ви заповниÑ\82е данÑ\96 й наÑ\82иÑ\81неÑ\82е "Execute", оÑ\81кÑ\96лÑ\8cки Ñ\96нÑ\82еÑ\80Ñ\84ейÑ\81 докÑ\83менÑ\82аÑ\86Ñ\96Ñ\97 пÑ\80аÑ\86Ñ\8eÑ\94 з **JavaScript**, cookies не бÑ\83дÑ\83Ñ\82Ñ\8c вÑ\96дпÑ\80авленÑ\96, Ñ\96 ви побаÑ\87иÑ\82е **помилкÑ\83**, нÑ\96би ви не ввели жодних значень.
 
 ///
 
 ## Заборона додаткових cookie { #forbid-extra-cookies }
 
-У деÑ\8fкиÑ\85 Ñ\81пеÑ\86Ñ\96алÑ\8cниÑ\85 випадкаÑ\85 (ймовÑ\96Ñ\80но, не дÑ\83же поÑ\88иÑ\80ениÑ\85) Ð\92и можете захотіти **обмежити** cookies, які хочете отримувати.
+У деÑ\8fкиÑ\85 Ñ\81пеÑ\86Ñ\96алÑ\8cниÑ\85 випадкаÑ\85 (ймовÑ\96Ñ\80но, не дÑ\83же поÑ\88иÑ\80ениÑ\85) ви можете захотіти **обмежити** cookies, які хочете отримувати.
 
-Ваша API тепер має можливість контролювати власну <abbr title="This is a joke, just in case. It has nothing to do with cookie consents, but it's funny that even the API can now reject the poor cookies. Have a cookie. 🍪">згоду на cookie</abbr>. 🤪🍪
+Ваш API тепер має можливість контролювати власну <dfn title="Це жарт, про всяк випадок. Це не має стосунку до згоди на cookies, просто кумедно, що навіть API тепер може відхиляти бідні cookies. Візьміть печиво. 🍪">згоду на cookies</dfn>. 🤪🍪
 
 Ви можете використовувати налаштування моделі Pydantic, щоб `forbid` будь-які `extra` поля:
 
@@ -54,9 +54,9 @@
 
 Якщо клієнт спробує надіслати якісь **додаткові cookies**, він отримає відповідь з **помилкою**.
 
-Ð\91Ñ\96днÑ\96 банеÑ\80и cookie, Ñ\8fкÑ\96 Ñ\82ак Ñ\81Ñ\82аÑ\80анно намагаÑ\8eÑ\82Ñ\8cÑ\81Ñ\8f оÑ\82Ñ\80имаÑ\82и Ð\92аÑ\88Ñ\83 згодÑ\83, Ñ\89об <abbr title="This is another joke. Don't pay attention to me. Have some coffee for your cookie. â\98\95">API Ñ\97Ñ\97 вÑ\96дÑ\85илила</abbr>. 🍪
+Ð\91Ñ\96днÑ\96 банеÑ\80и cookie, Ñ\8fкÑ\96 Ñ\82ак Ñ\81Ñ\82аÑ\80анно намагаÑ\8eÑ\82Ñ\8cÑ\81Ñ\8f оÑ\82Ñ\80имаÑ\82и ваÑ\88Ñ\83 згодÑ\83, Ñ\89об <dfn title="Це Ñ\89е один жаÑ\80Ñ\82. Ð\9dе звеÑ\80Ñ\82айÑ\82е на мене Ñ\83ваги. Ð\92ипийÑ\82е Ñ\82Ñ\80оÑ\85и кави до Ñ\81вого пеÑ\87ива. â\98\95">API Ñ\97Ñ\97 вÑ\96дÑ\85илила</dfn>. 🍪
 
-Наприклад, якщо клієнт спробує надіслати cookie `santa_tracker` зі значенням `good-list-please`, він отримає відповідь з помилкою, яка повідомить, що `santa_tracker` <abbr title="Santa disapproves the lack of cookies. 🎅 Okay, no more cookie jokes.">cookie не дозволено</abbr>:
+Наприклад, якщо клієнт спробує надіслати cookie `santa_tracker` зі значенням `good-list-please`, він отримає відповідь з помилкою, яка повідомить, що `santa_tracker` <dfn title="Санта не схвалює нестачу cookies. 🎅 Гаразд, досить жартів про cookies.">cookie не дозволено</dfn>:
 
 ```json
 {
@@ -73,4 +73,4 @@
 
 ## Підсумок { #summary }
 
-Ви можете використовувати **Pydantic-моделі** для оголошення <abbr title="Have a last cookie before you go. 🍪">**cookies**</abbr> у **FastAPI**. 😎
+Ви можете використовувати **Pydantic-моделі** для оголошення <dfn title="Візьміть останнє печиво перед тим, як підете. 🍪">**cookies**</dfn> у **FastAPI**. 😎

diff --git a/docs/uk/docs/tutorial/cookie-params.md b/docs/uk/docs/tutorial/cookie-params.md
index 8a5b44e8aab32ebaf33e7a1549052640fad1f52f..3a2e6fa24ea0bac36ca50f3130cbde01ffc58a78 100644 (file)
--- a/docs/uk/docs/tutorial/cookie-params.md
+++ b/docs/uk/docs/tutorial/cookie-params.md
@@ -1,6 +1,6 @@
-# Параметри Cookie { #cookie-parameters }
+# Параметри кукі { #cookie-parameters }
 
-Ви можете визначати параметри Cookie таким же чином, як визначаються параметри `Query` і `Path`.
+Ви можете визначати параметри кукі таким же чином, як визначаються параметри `Query` і `Path`.
 
 ## Імпорт `Cookie` { #import-cookie }
 
@@ -10,7 +10,7 @@
 
 ## Визначення параметрів `Cookie` { #declare-cookie-parameters }
 
-Потім визначте параметри cookie, використовуючи таку ж конструкцію як для `Path` і `Query`.
+Потім визначте параметри кукі, використовуючи таку ж конструкцію як для `Path` і `Query`.
 
 Ви можете визначити значення за замовчуванням, а також усі додаткові параметри валідації чи анотації:
 
@@ -26,20 +26,20 @@
 
 /// info
 
-Для визначення cookies ви маєте використовувати `Cookie`, тому що в іншому випадку параметри будуть інтерпритовані, як параметри запиту.
+Для визначення кукі ви маєте використовувати `Cookie`, тому що в іншому випадку параметри будуть інтерпретовані як параметри запиту.
 
 ///
 
 /// info
 
-Майте на увазі, що оскільки **браузери обробляють cookies** спеціальним чином і за лаштунками, вони **не** дозволяють **JavaScript** легко взаємодіяти з ними.
+Майте на увазі, що оскільки **браузери обробляють кукі** спеціальним чином і за лаштунками, вони **не** дозволяють **JavaScript** легко взаємодіяти з ними.
 
-Якщо ви перейдете до **інтерфейсу документації API** за адресою `/docs`, ви зможете побачити **документацію** для cookies для ваших *операцій шляху*.
+Якщо ви перейдете до **інтерфейсу документації API** за адресою `/docs`, ви зможете побачити **документацію** для кукі для ваших *операцій шляху*.
 
-Але навіть якщо ви **заповните дані** і натиснете "Execute", оскільки інтерфейс документації працює з **JavaScript**, cookies не буде надіслано, і ви побачите повідомлення про **помилку**, ніби ви не ввели жодних значень.
+Але навіть якщо ви **заповните дані** і натиснете "Execute", оскільки інтерфейс документації працює з **JavaScript**, кукі не буде надіслано, і ви побачите повідомлення про **помилку**, ніби ви не ввели жодних значень.
 
 ///
 
 ## Підсумки { #recap }
 
-Визначайте cookies за допомогою `Cookie`, використовуючи той же спільний шаблон, що і `Query` та `Path`.
+Визначайте кукі за допомогою `Cookie`, використовуючи той же спільний шаблон, що і `Query` та `Path`.

diff --git a/docs/uk/docs/tutorial/cors.md b/docs/uk/docs/tutorial/cors.md
index f3ed8a7d942c2b1dfd2bdfadf5bb0a1bd696a3cb..5c959cef18451acb74bb093c80281269270ef669 100644 (file)
--- a/docs/uk/docs/tutorial/cors.md
+++ b/docs/uk/docs/tutorial/cors.md
@@ -1,6 +1,6 @@
 # CORS (Обмін ресурсами між різними джерелами) { #cors-cross-origin-resource-sharing }
 
-<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" class="external-link" target="_blank">CORS або "Cross-Origin Resource Sharing"</a> є ситуація, коли фронтенд, що працює в браузері, містить JavaScript-код, який взаємодіє з бекендом, розташованим в іншому "джерелі" (origin).
+<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" class="external-link" target="_blank">CORS або «Cross-Origin Resource Sharing»</a> є ситуація, коли фронтенд, що працює в браузері, містить JavaScript-код, який взаємодіє з бекендом, розташованим в іншому «джерелі» (origin).
 
 ## Джерело (Origin) { #origin }
 
@@ -13,50 +13,49 @@
 * `https://localhost`
 * `http://localhost:8080`
 
-Навіть якщо вони всі містять `localhost`, вони мають різні протоколи або порти, що робить їх окремими "джерелами".
+Навіть якщо вони всі містять `localhost`, вони мають різні протоколи або порти, що робить їх окремими «джерелами».
 
 ## Кроки { #steps }
 
-Ð\9fÑ\80ипÑ\83Ñ\81Ñ\82имо, Ñ\89о Ð\92аÑ\88 Ñ\84Ñ\80онÑ\82енд пÑ\80аÑ\86Ñ\8eÑ\94 в бÑ\80аÑ\83зеÑ\80Ñ\96 на `http://localhost:8080`, а його JavaScript намагаÑ\94Ñ\82Ñ\8cÑ\81Ñ\8f вÑ\96дпÑ\80авиÑ\82и запиÑ\82 до бекендÑ\83, Ñ\8fкий пÑ\80аÑ\86Ñ\8eÑ\94 на `http://localhost`  (Оскільки ми не вказуємо порт, браузер за замовчуванням припускає порт `80`).
+Ð\9fÑ\80ипÑ\83Ñ\81Ñ\82имо, Ñ\89о ваÑ\88 Ñ\84Ñ\80онÑ\82енд пÑ\80аÑ\86Ñ\8eÑ\94 в бÑ\80аÑ\83зеÑ\80Ñ\96 на `http://localhost:8080`, а його JavaScript намагаÑ\94Ñ\82Ñ\8cÑ\81Ñ\8f вÑ\96дпÑ\80авиÑ\82и запиÑ\82 до бекендÑ\83, Ñ\8fкий пÑ\80аÑ\86Ñ\8eÑ\94 на `http://localhost` (Оскільки ми не вказуємо порт, браузер за замовчуванням припускає порт `80`).
 
 Потім браузер надішле HTTP-запит `OPTIONS` до бекенду на порту `:80`, і якщо бекенд надішле відповідні заголовки, що дозволяють комунікацію з цього іншого джерела (`http://localhost:8080`), тоді браузер на порту `:8080` дозволить JavaScript у фронтенді надіслати свій запит до бекенду на порту `:80`.
 
-Щоб досягти цього, бекенд на порту `:80` повинен мати список "дозволених джерел".
+Щоб досягти цього, бекенд на порту `:80` повинен мати список «дозволених джерел».
 
 У цьому випадку список має містити `http://localhost:8080`, щоб фронтенд на порту `:8080` працював коректно.
 
-## СимволÑ\8cне пÑ\96дÑ\81Ñ\82авлÑ\8fннÑ\8f { #wildcards }
+## Ð\94икÑ\96 каÑ\80Ñ\82и { #wildcards }
 
-Можна також оголосити список як `"*"` ("символьне підставляння"), що означає дозвіл для всіх джерел.
+Можна також оголосити список як `"*"` (дика карта), що означає дозвіл для всіх джерел.
 
-Ð\9eднак Ñ\86е дозволиÑ\82Ñ\8c лиÑ\88е певнÑ\96 Ñ\82ипи комÑ\83нÑ\96каÑ\86Ñ\96Ñ\97, виклÑ\8eÑ\87аÑ\8eÑ\87и вÑ\81е, Ñ\89о пов'Ñ\8fзане з облÑ\96ковими даними: Cookies, заголовки авÑ\82оÑ\80изаÑ\86Ñ\96Ñ\97, Ñ\82акÑ\96 Ñ\8fк Ñ\82Ñ\96, Ñ\89о викоÑ\80иÑ\81Ñ\82овÑ\83Ñ\8eÑ\82Ñ\8cÑ\81Ñ\8f з Bearer Tokens, тощо.
+Ð\9eднак Ñ\86е дозволиÑ\82Ñ\8c лиÑ\88е певнÑ\96 Ñ\82ипи комÑ\83нÑ\96каÑ\86Ñ\96Ñ\97, виклÑ\8eÑ\87аÑ\8eÑ\87и вÑ\81е, Ñ\89о пов'Ñ\8fзане з облÑ\96ковими даними: Cookies, заголовки авÑ\82оÑ\80изаÑ\86Ñ\96Ñ\97, Ñ\8fк-оÑ\82 Ñ\82Ñ\96, Ñ\89о викоÑ\80иÑ\81Ñ\82овÑ\83Ñ\8eÑ\82Ñ\8cÑ\81Ñ\8f з Ñ\82окенами ноÑ\81Ñ\96Ñ\8f, тощо.
 
 Тому для коректної роботи краще явно вказувати дозволені джерела.
 
 ## Використання `CORSMiddleware` { #use-corsmiddleware }
 
-Ð\92и можеÑ\82е налаÑ\88Ñ\82Ñ\83ваÑ\82и Ñ\86е Ñ\83 Ð\92ашому додатку **FastAPI** за допомогою `CORSMiddleware`.
+Ð\92и можеÑ\82е налаÑ\88Ñ\82Ñ\83ваÑ\82и Ñ\86е Ñ\83 вашому додатку **FastAPI** за допомогою `CORSMiddleware`.
 
 * Імпортуйте `CORSMiddleware`.
 * Створіть список дозволених джерел (у вигляді рядків).
-* Додайте його як "middleware" у Ваш додаток **FastAPI**.
+* Додайте його як «проміжне програмне забезпечення» у ваш додаток **FastAPI**.
 
-
-Також можна вказати, чи дозволяє Ваш бекенд:
+Також можна вказати, чи дозволяє ваш бекенд:
 
 * Облікові дані (заголовки авторизації, Cookies, тощо).
 * Конкретні HTTP-методи (`POST`, `PUT`) або всі за допомогою `"*"`
 * Конкретні HTTP-заголовки або всі за допомогою `"*"`.
 
 
-{* ../../docs_src/cors/tutorial001_py39.py hl[2,6:11,13:19] *}
+{* ../../docs_src/cors/tutorial001_py310.py hl[2,6:11,13:19] *}
 
 
-Ð\9fаÑ\80амеÑ\82Ñ\80и за замовÑ\87Ñ\83ваннÑ\8fм Ñ\83 Ñ\80еалÑ\96заÑ\86Ñ\96Ñ\97 `CORSMiddleware` Ñ\94 доÑ\81иÑ\82Ñ\8c обмеженими, Ñ\82омÑ\83 Ð\92ам потрібно явно увімкнути конкретні джерела, методи або заголовки, щоб браузерам було дозволено використовувати їх у міждоменному контексті.
+Ð\9fаÑ\80амеÑ\82Ñ\80и за замовÑ\87Ñ\83ваннÑ\8fм Ñ\83 Ñ\80еалÑ\96заÑ\86Ñ\96Ñ\97 `CORSMiddleware` Ñ\94 доÑ\81иÑ\82Ñ\8c обмеженими, Ñ\82омÑ\83 вам потрібно явно увімкнути конкретні джерела, методи або заголовки, щоб браузерам було дозволено використовувати їх у міждоменному контексті.
 
 Підтримуються такі аргументи:
 
-* `allow_origins` - Список джерел, яким дозволено здійснювати міждоменні запити.  Наприклад `['https://example.org', 'https://www.example.org']`. Ви можете використовувати `['*']`, щоб дозволити будь-яке джерело.
+* `allow_origins` - Список джерел, яким дозволено здійснювати міждоменні запити. Наприклад `['https://example.org', 'https://www.example.org']`. Ви можете використовувати `['*']`, щоб дозволити будь-яке джерело.
 * `allow_origin_regex` - Рядок регулярного виразу для відповідності джерелам, яким дозволено здійснювати міждоменні запити. Наприклад, `'https://.*\.example\.org'`.
 * `allow_methods` - Список HTTP-методів, дозволених для міждоменних запитів. За замовчуванням `['GET']`. Ви можете використовувати `['*']`, щоб дозволити всі стандартні методи.
 * `allow_headers` - Список HTTP-заголовків запиту, які підтримуються для міждоменних запитів. За замовчуванням `[]`. Ви можете використовувати `['*']`, щоб дозволити всі заголовки. Заголовки `Accept`, `Accept-Language`, `Content-Language` і `Content-Type` завжди дозволені для <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#simple_requests" class="external-link" rel="noopener" target="_blank">простих CORS-запитів</a>.
@@ -67,7 +66,7 @@
 * `expose_headers` - Вказує, які заголовки відповіді повинні бути доступні для браузера. За замовчуванням `[]`.
 * `max_age` - Встановлює максимальний час (у секундах) для кешування CORS-відповідей у браузерах. За замовчуванням `600`.
 
-Цей middleware обробляє два типи HTTP-запитів...
+Це проміжне програмне забезпечення обробляє два типи HTTP-запитів...
 
 ### Попередні CORS-запити { #cors-preflight-requests }
 
@@ -81,7 +80,7 @@
 
 ## Додаткова інформація { #more-info }
 
-Більше про <abbr title="Cross-Origin Resource Sharing">CORS</abbr> можна дізнатися в <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" class="external-link" target="_blank">документації Mozilla про CORS</a>.
+Більше про <abbr title="Cross-Origin Resource Sharing - Обмін ресурсами між різними джерелами">CORS</abbr> можна дізнатися в <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" class="external-link" target="_blank">документації Mozilla про CORS</a>.
 
 /// note | Технічні деталі
 

diff --git a/docs/uk/docs/tutorial/debugging.md b/docs/uk/docs/tutorial/debugging.md
index 0db418dcc9a9fa3a2e06a1bef01019c480952a50..679018cc2ff3fa4c00dce932eeaa4e8263e3690d 100644 (file)
--- a/docs/uk/docs/tutorial/debugging.md
+++ b/docs/uk/docs/tutorial/debugging.md
@@ -6,7 +6,7 @@
 
 У вашому FastAPI-додатку імпортуйте та запустіть `uvicorn` безпосередньо:
 
-{* ../../docs_src/debugging/tutorial001_py39.py hl[1,15] *}
+{* ../../docs_src/debugging/tutorial001_py310.py hl[1,15] *}
 
 ### Про `__name__ == "__main__"` { #about-name-main }
 

diff --git a/docs/uk/docs/tutorial/first-steps.md b/docs/uk/docs/tutorial/first-steps.md
index 5f3750010c37dd40376df0ea202aaf2e2d84ed60..f03a120a095d772443de73dcad9a9abf47545649 100644 (file)
--- a/docs/uk/docs/tutorial/first-steps.md
+++ b/docs/uk/docs/tutorial/first-steps.md
@@ -2,7 +2,7 @@
 
 Найпростіший файл FastAPI може виглядати так:
 
-{* ../../docs_src/first_steps/tutorial001_py39.py *}
+{* ../../docs_src/first_steps/tutorial001_py310.py *}
 
 Скопіюйте це до файлу `main.py`.
 
@@ -183,7 +183,7 @@ Deploying to FastAPI Cloud...
 
 ### Крок 1: імпортуємо `FastAPI` { #step-1-import-fastapi }
 
-{* ../../docs_src/first_steps/tutorial001_py39.py hl[1] *}
+{* ../../docs_src/first_steps/tutorial001_py310.py hl[1] *}
 
 `FastAPI` — це клас у Python, який надає всю функціональність для вашого API.
 
@@ -197,7 +197,7 @@ Deploying to FastAPI Cloud...
 
 ### Крок 2: створюємо «екземпляр» `FastAPI` { #step-2-create-a-fastapi-instance }
 
-{* ../../docs_src/first_steps/tutorial001_py39.py hl[3] *}
+{* ../../docs_src/first_steps/tutorial001_py310.py hl[3] *}
 
 Тут змінна `app` буде «екземпляром» класу `FastAPI`.
 
@@ -221,7 +221,7 @@ https://example.com/items/foo
 /items/foo
 ```
 
-/// info | Інформація
+/// info
 
 «Шлях» також зазвичай називають «ендпоінтом» або «маршрутом».
 
@@ -266,12 +266,12 @@ https://example.com/items/foo
 
 #### Визначте *декоратор операції шляху* { #define-a-path-operation-decorator }
 
-{* ../../docs_src/first_steps/tutorial001_py39.py hl[6] *}
+{* ../../docs_src/first_steps/tutorial001_py310.py hl[6] *}
 
 Декоратор `@app.get("/")` повідомляє **FastAPI**, що функція одразу нижче відповідає за обробку запитів, які надходять до:
 
 * шляху `/`
-* використовуючи <abbr title="an HTTP GET method"><code>get</code> операцію</abbr>
+* використовуючи <dfn title="HTTP метод GET"><code>get</code> операція</dfn>
 
 /// info | `@decorator` Інформація
 
@@ -300,7 +300,7 @@ https://example.com/items/foo
 * `@app.patch()`
 * `@app.trace()`
 
-/// tip | Порада
+/// tip
 
 Ви можете використовувати кожну операцію (HTTP-метод) як забажаєте.
 
@@ -320,7 +320,7 @@ https://example.com/items/foo
 * **операція**: це `get`.
 * **функція**: це функція нижче «декоратора» (нижче `@app.get("/")`).
 
-{* ../../docs_src/first_steps/tutorial001_py39.py hl[7] *}
+{* ../../docs_src/first_steps/tutorial001_py310.py hl[7] *}
 
 Це функція Python.
 
@@ -332,9 +332,9 @@ https://example.com/items/foo
 
 Ви також можете визначити її як звичайну функцію замість `async def`:
 
-{* ../../docs_src/first_steps/tutorial003_py39.py hl[7] *}
+{* ../../docs_src/first_steps/tutorial003_py310.py hl[7] *}
 
-/// note | Примітка
+/// note
 
 Якщо ви не знаєте різницю, подивіться [Асинхронність: *«Поспішаєте?»*](../async.md#in-a-hurry){.internal-link target=_blank}.
 
@@ -342,7 +342,7 @@ https://example.com/items/foo
 
 ### Крок 5: поверніть вміст { #step-5-return-the-content }
 
-{* ../../docs_src/first_steps/tutorial001_py39.py hl[8] *}
+{* ../../docs_src/first_steps/tutorial001_py310.py hl[8] *}
 
 Ви можете повернути `dict`, `list`, а також окремі значення `str`, `int` тощо.
 

diff --git a/docs/uk/docs/tutorial/handling-errors.md b/docs/uk/docs/tutorial/handling-errors.md
index 53b8b12f618c299ee1ad84b49d80dbb42b80255e..28a83127ffad1b311e6b3a04162f94e9f657f2fc 100644 (file)
--- a/docs/uk/docs/tutorial/handling-errors.md
+++ b/docs/uk/docs/tutorial/handling-errors.md
@@ -25,7 +25,7 @@
 
 ### Імпорт `HTTPException` { #import-httpexception }
 
-{* ../../docs_src/handling_errors/tutorial001_py39.py hl[1] *}
+{* ../../docs_src/handling_errors/tutorial001_py310.py hl[1] *}
 
 ### Згенеруйте `HTTPException` у своєму коді { #raise-an-httpexception-in-your-code }
 
@@ -39,7 +39,7 @@
 
 У цьому прикладі, коли клієнт запитує елемент за ID, якого не існує, згенеруйте виключення зі статус-кодом `404`:
 
-{* ../../docs_src/handling_errors/tutorial001_py39.py hl[11] *}
+{* ../../docs_src/handling_errors/tutorial001_py310.py hl[11] *}
 
 ### Отримана відповідь { #the-resulting-response }
 
@@ -77,7 +77,7 @@
 
 Але якщо вам знадобиться це для складного сценарію, ви можете додати власні заголовки:
 
-{* ../../docs_src/handling_errors/tutorial002_py39.py hl[14] *}
+{* ../../docs_src/handling_errors/tutorial002_py310.py hl[14] *}
 
 ## Встановлення власних обробників виключень { #install-custom-exception-handlers }
 
@@ -89,7 +89,7 @@
 
 Ви можете додати власний обробник виключень за допомогою `@app.exception_handler()`:
 
-{* ../../docs_src/handling_errors/tutorial003_py39.py hl[5:7,13:18,24] *}
+{* ../../docs_src/handling_errors/tutorial003_py310.py hl[5:7,13:18,24] *}
 
 Тут, якщо ви звернетеся до `/unicorns/yolo`, *операція шляху* згенерує (`raise`) `UnicornException`.
 
@@ -127,7 +127,7 @@
 
 Обробник виключень отримає `Request` і саме виключення.
 
-{* ../../docs_src/handling_errors/tutorial004_py39.py hl[2,14:19] *}
+{* ../../docs_src/handling_errors/tutorial004_py310.py hl[2,14:19] *}
 
 Тепер, якщо ви перейдете за посиланням `/items/foo`, замість того, щоб отримати стандартну JSON-помилку:
 
@@ -159,7 +159,7 @@ Field: ('path', 'item_id'), Error: Input should be a valid integer, unable to pa
 
 Наприклад, ви можете захотіти повернути відповідь у вигляді простого тексту замість JSON для цих помилок:
 
-{* ../../docs_src/handling_errors/tutorial004_py39.py hl[3:4,9:11,25] *}
+{* ../../docs_src/handling_errors/tutorial004_py310.py hl[3:4,9:11,25] *}
 
 /// note | Технічні деталі
 
@@ -183,7 +183,7 @@ Field: ('path', 'item_id'), Error: Input should be a valid integer, unable to pa
 
 Ви можете використовувати це під час розробки свого додатка, щоб логувати тіло запиту та налагоджувати його, повертати користувачеві тощо.
 
-{* ../../docs_src/handling_errors/tutorial005_py39.py hl[14] *}
+{* ../../docs_src/handling_errors/tutorial005_py310.py hl[14] *}
 
 Тепер спробуйте надіслати некоректний елемент, наприклад:
 
@@ -239,6 +239,6 @@ from starlette.exceptions import HTTPException as StarletteHTTPException
 
 Якщо ви хочете використовувати виключення разом із такими ж обробниками виключень за замовчуванням, як у **FastAPI**, ви можете імпортувати та повторно використати обробники виключень за замовчуванням із `fastapi.exception_handlers`:
 
-{* ../../docs_src/handling_errors/tutorial006_py39.py hl[2:5,15,21] *}
+{* ../../docs_src/handling_errors/tutorial006_py310.py hl[2:5,15,21] *}
 
 У цьому прикладі ви просто друкуєте помилку з дуже виразним повідомленням, але ви зрозуміли основну ідею. Ви можете використовувати виключення, а потім просто повторно використати обробники виключень за замовчуванням.

diff --git a/docs/uk/docs/tutorial/header-param-models.md b/docs/uk/docs/tutorial/header-param-models.md
index c080c19f063d2ba8eccd3f8ebd561619513aadbe..dd734eaee7bf5becce4f1947d6425c8cdca70973 100644 (file)
--- a/docs/uk/docs/tutorial/header-param-models.md
+++ b/docs/uk/docs/tutorial/header-param-models.md
@@ -1,8 +1,8 @@
 # Моделі параметрів заголовків { #header-parameter-models }
 
-ЯкÑ\89о Ñ\83 Ð\92аÑ\81 Ñ\94 гÑ\80Ñ\83па повâ\80\99Ñ\8fзаниÑ\85 **паÑ\80амеÑ\82Ñ\80Ñ\96в заголовкÑ\96в**, Ð\92и можете створити **Pydantic модель** для їх оголошення.
+ЯкÑ\89о Ñ\83 ваÑ\81 Ñ\94 гÑ\80Ñ\83па повâ\80\99Ñ\8fзаниÑ\85 **паÑ\80амеÑ\82Ñ\80Ñ\96в заголовкÑ\96в**, ви можете створити **Pydantic модель** для їх оголошення.
 
-Це дозволиÑ\82Ñ\8c Ð\92ам повторно **використовувати модель** в **різних місцях**, а також оголосити валідації та метадані для всіх параметрів одночасно. 😎
+Це дозволиÑ\82Ñ\8c вам повторно **використовувати модель** в **різних місцях**, а також оголосити валідації та метадані для всіх параметрів одночасно. 😎
 
 /// note | Примітка
 
@@ -16,7 +16,7 @@
 
 {* ../../docs_src/header_param_models/tutorial001_an_py310.py hl[9:14,18] *}
 
-**FastAPI** бÑ\83де **виÑ\82Ñ\8fгÑ\83ваÑ\82и** данÑ\96 длÑ\8f **кожного полÑ\8f** з **заголовкÑ\96в** Ñ\83 запиÑ\82Ñ\96 Ñ\82а пеÑ\80едаваÑ\82и Ñ\97Ñ\85 Ñ\83 Ñ\81Ñ\82воÑ\80енÑ\83 Ð\92ами Pydantic модель.
+**FastAPI** бÑ\83де **виÑ\82Ñ\8fгÑ\83ваÑ\82и** данÑ\96 длÑ\8f **кожного полÑ\8f** з **заголовкÑ\96в** Ñ\83 запиÑ\82Ñ\96 Ñ\82а пеÑ\80едаваÑ\82и Ñ\97Ñ\85 Ñ\83 Ñ\81Ñ\82воÑ\80енÑ\83 вами Pydantic модель.
 
 ## Перевірка в документації { #check-the-docs }
 
@@ -28,7 +28,7 @@
 
 ## Заборонити додаткові заголовки { #forbid-extra-headers }
 
-У деÑ\8fкиÑ\85 оÑ\81обливиÑ\85 випадкаÑ\85 (ймовÑ\96Ñ\80но, не дÑ\83же поÑ\88иÑ\80ениÑ\85) Ð\92и можете захотіти **обмежити** заголовки, які хочете отримати.
+У деÑ\8fкиÑ\85 оÑ\81обливиÑ\85 випадкаÑ\85 (ймовÑ\96Ñ\80но, не дÑ\83же поÑ\88иÑ\80ениÑ\85) ви можете захотіти **обмежити** заголовки, які хочете отримати.
 
 Ви можете використати конфігурацію моделі Pydantic, щоб `заборонити` будь-які `додаткові` поля:
 
@@ -55,9 +55,9 @@
 
 Так само, як і зі звичайними параметрами заголовків, коли у назвах параметрів є символи підкреслення, вони **автоматично перетворюються на дефіси**.
 
-Ð\9dапÑ\80иклад, Ñ\8fкÑ\89о Ñ\83 кодÑ\96 Ñ\83 Ð\92ас є параметр заголовка `save_data`, очікуваний HTTP-заголовок буде `save-data`, і він так само відображатиметься в документації.
+Ð\9dапÑ\80иклад, Ñ\8fкÑ\89о Ñ\83 кодÑ\96 Ñ\83 вас є параметр заголовка `save_data`, очікуваний HTTP-заголовок буде `save-data`, і він так само відображатиметься в документації.
 
-ЯкÑ\89о з Ñ\8fкоÑ\97Ñ\81Ñ\8c пÑ\80иÑ\87ини Ð\92ам поÑ\82Ñ\80Ñ\96бно вимкнÑ\83Ñ\82и Ñ\86е авÑ\82омаÑ\82иÑ\87не пеÑ\80еÑ\82воÑ\80еннÑ\8f, Ð\92и також можете зробити це для Pydantic моделей для параметрів заголовків.
+ЯкÑ\89о з Ñ\8fкоÑ\97Ñ\81Ñ\8c пÑ\80иÑ\87ини вам поÑ\82Ñ\80Ñ\96бно вимкнÑ\83Ñ\82и Ñ\86е авÑ\82омаÑ\82иÑ\87не пеÑ\80еÑ\82воÑ\80еннÑ\8f, ви також можете зробити це для Pydantic моделей для параметрів заголовків.
 
 {* ../../docs_src/header_param_models/tutorial003_an_py310.py hl[19] *}
 

diff --git a/docs/uk/docs/tutorial/header-params.md b/docs/uk/docs/tutorial/header-params.md
index f5a4ea18d187f5fbe57316397c91311b140f47af..9e564d27ab2cdf14e13aac509b128bce731ec3f6 100644 (file)
--- a/docs/uk/docs/tutorial/header-params.md
+++ b/docs/uk/docs/tutorial/header-params.md
@@ -50,7 +50,7 @@
 
 /// warning | Попередження
 
-Ð\9fеÑ\80ед Ñ\82им Ñ\8fк вÑ\81Ñ\82ановиÑ\82и `convert_underscores` в `False`, памâ\80\99Ñ\8fÑ\82айÑ\82е, Ñ\89о деÑ\8fкÑ\96 HTTP-пÑ\80окÑ\81Ñ\96 та сервери забороняють використання заголовків із підкресленнями.
+Ð\9fеÑ\80ед Ñ\82им Ñ\8fк вÑ\81Ñ\82ановиÑ\82и `convert_underscores` в `False`, памâ\80\99Ñ\8fÑ\82айÑ\82е, Ñ\89о деÑ\8fкÑ\96 HTTP-пÑ\80едÑ\81Ñ\82авники та сервери забороняють використання заголовків із підкресленнями.
 
 ///
 

diff --git a/docs/uk/docs/tutorial/index.md b/docs/uk/docs/tutorial/index.md
index 6848090ecce73cee1e64e6e7f0f7be49824b5bf7..ed53ac7728efa10dccfdb91f07ca27dbb8cb7d47 100644 (file)
--- a/docs/uk/docs/tutorial/index.md
+++ b/docs/uk/docs/tutorial/index.md
@@ -84,12 +84,12 @@ $ pip install "fastapi[standard]"
 
 ///
 
-## РозÑ\88иÑ\80ений посібник користувача { #advanced-user-guide }
+## Ð\9fÑ\80оÑ\81Ñ\83нÑ\83Ñ\82ий посібник користувача { #advanced-user-guide }
 
-Ð\86Ñ\81нÑ\83Ñ\94 Ñ\82акож **РозÑ\88иÑ\80ений посібник користувача**, який ви зможете прочитати пізніше після цього **Туторіал - Посібник користувача**.
+Ð\86Ñ\81нÑ\83Ñ\94 Ñ\82акож **Ð\9fÑ\80оÑ\81Ñ\83нÑ\83Ñ\82ий посібник користувача**, який ви зможете прочитати пізніше після цього **Туторіал - Посібник користувача**.
 
-**РозÑ\88иÑ\80ений посібник користувача** засновано на цьому, використовує ті самі концепції та навчає вас деяким додатковим функціям.
+**Ð\9fÑ\80оÑ\81Ñ\83нÑ\83Ñ\82ий посібник користувача** засновано на цьому, використовує ті самі концепції та навчає вас деяким додатковим функціям.
 
 Але вам слід спочатку прочитати **Туторіал - Посібник користувача** (те, що ви зараз читаєте).
 
-Ð\92Ñ\96н Ñ\80озÑ\80облений Ñ\82аким Ñ\87ином, Ñ\89о ви можеÑ\82е Ñ\81Ñ\82воÑ\80иÑ\82и повнÑ\83 пÑ\80огÑ\80амÑ\83 лиÑ\88е за допомогоÑ\8e **ТÑ\83Ñ\82оÑ\80Ñ\96ал - Ð\9fоÑ\81Ñ\96бник коÑ\80иÑ\81Ñ\82Ñ\83ваÑ\87а**, а поÑ\82Ñ\96м Ñ\80озÑ\88иÑ\80иÑ\82и Ñ\97Ñ\97 Ñ\80Ñ\96зними Ñ\81поÑ\81обами, залежно вÑ\96д ваÑ\88иÑ\85 поÑ\82Ñ\80еб, викоÑ\80иÑ\81Ñ\82овÑ\83Ñ\8eÑ\87и деÑ\8fкÑ\96 з додаÑ\82ковиÑ\85 Ñ\96дей з **РозÑ\88иÑ\80еного посібника користувача**.
+Ð\92Ñ\96н Ñ\80озÑ\80облений Ñ\82аким Ñ\87ином, Ñ\89о ви можеÑ\82е Ñ\81Ñ\82воÑ\80иÑ\82и повнÑ\83 пÑ\80огÑ\80амÑ\83 лиÑ\88е за допомогоÑ\8e **ТÑ\83Ñ\82оÑ\80Ñ\96ал - Ð\9fоÑ\81Ñ\96бник коÑ\80иÑ\81Ñ\82Ñ\83ваÑ\87а**, а поÑ\82Ñ\96м Ñ\80озÑ\88иÑ\80иÑ\82и Ñ\97Ñ\97 Ñ\80Ñ\96зними Ñ\81поÑ\81обами, залежно вÑ\96д ваÑ\88иÑ\85 поÑ\82Ñ\80еб, викоÑ\80иÑ\81Ñ\82овÑ\83Ñ\8eÑ\87и деÑ\8fкÑ\96 з додаÑ\82ковиÑ\85 Ñ\96дей з **Ð\9fÑ\80оÑ\81Ñ\83нÑ\83Ñ\82ого посібника користувача**.

diff --git a/docs/uk/docs/tutorial/metadata.md b/docs/uk/docs/tutorial/metadata.md
index cf1704562863baff06bf47d5a02c2070baef4fb9..ebe8dc40e158dafce8d84191a76cdc6294e439e9 100644 (file)
--- a/docs/uk/docs/tutorial/metadata.md
+++ b/docs/uk/docs/tutorial/metadata.md
@@ -18,7 +18,7 @@
 
 Ви можете налаштувати їх наступним чином:
 
-{* ../../docs_src/metadata/tutorial001_py39.py hl[3:16, 19:32] *}
+{* ../../docs_src/metadata/tutorial001_py310.py hl[3:16, 19:32] *}
 
 /// tip | Порада
 
@@ -36,7 +36,7 @@
 
 Наприклад:
 
-{* ../../docs_src/metadata/tutorial001_1_py39.py hl[31] *}
+{* ../../docs_src/metadata/tutorial001_1_py310.py hl[31] *}
 
 ## Метадані для тегів { #metadata-for-tags }
 
@@ -58,7 +58,7 @@
 
 Створіть метадані для своїх тегів і передайте їх у параметр `openapi_tags`:
 
-{* ../../docs_src/metadata/tutorial004_py39.py hl[3:16,18] *}
+{* ../../docs_src/metadata/tutorial004_py310.py hl[3:16,18] *}
 
 Зверніть увагу, що в описах можна використовувати Markdown, наприклад, "login" буде показано жирним шрифтом (**login**), а "fancy" буде показано курсивом (_fancy_).
 
@@ -72,7 +72,7 @@
 
 Використовуйте параметр `tags` зі своїми *операціями шляху* (і `APIRouter`s), щоб призначити їх до різних тегів:
 
-{* ../../docs_src/metadata/tutorial004_py39.py hl[21,26] *}
+{* ../../docs_src/metadata/tutorial004_py310.py hl[21,26] *}
 
 /// info | Інформація
 
@@ -100,7 +100,7 @@
 
 Наприклад, щоб налаштувати його на `/api/v1/openapi.json`:
 
-{* ../../docs_src/metadata/tutorial002_py39.py hl[3] *}
+{* ../../docs_src/metadata/tutorial002_py310.py hl[3] *}
 
 Якщо Ви хочете повністю вимкнути схему OpenAPI, Ви можете встановити `openapi_url=None`, це також вимкне інтерфейси документації, які її використовують.
 
@@ -117,4 +117,4 @@
 
 Наприклад, щоб налаштувати Swagger UI на `/documentation` і вимкнути ReDoc:
 
-{* ../../docs_src/metadata/tutorial003_py39.py hl[3] *}
+{* ../../docs_src/metadata/tutorial003_py310.py hl[3] *}

diff --git a/docs/uk/docs/tutorial/middleware.md b/docs/uk/docs/tutorial/middleware.md
index 2d1580e49e5df003e506256c2a4416b9b7aa6d42..961fb179e7a42a409175967e7c996f7cb0175b30 100644 (file)
--- a/docs/uk/docs/tutorial/middleware.md
+++ b/docs/uk/docs/tutorial/middleware.md
@@ -31,9 +31,9 @@
     * Потім вона поверне `response`, згенеровану відповідною *операцією шляху*.
 * Потім ви можете додатково змінити `response` перед тим, як повернути її.
 
-{* ../../docs_src/middleware/tutorial001_py39.py hl[8:9,11,14] *}
+{* ../../docs_src/middleware/tutorial001_py310.py hl[8:9,11,14] *}
 
-/// tip | Порада
+/// tip
 
 Пам’ятайте, що власні пропрієтарні заголовки можна додавати <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers" class="external-link" target="_blank">використовуючи префікс `X-`</a>.
 
@@ -57,9 +57,9 @@
 
 Наприклад, ви можете додати власний заголовок `X-Process-Time`, який міститиме час у секундах, який витратився на обробку запиту та генерацію відповіді:
 
-{* ../../docs_src/middleware/tutorial001_py39.py hl[10,12:13] *}
+{* ../../docs_src/middleware/tutorial001_py310.py hl[10,12:13] *}
 
-/// tip | Порада
+/// tip
 
 Тут ми використовуємо <a href="https://docs.python.org/3/library/time.html#time.perf_counter" class="external-link" target="_blank">`time.perf_counter()`</a> замість `time.time()` оскільки він може бути більш точним для таких випадків. 🤓
 
@@ -92,4 +92,4 @@ app.add_middleware(MiddlewareB)
 
 Ви можете пізніше прочитати більше про інші middlewares в [Advanced User Guide: Advanced Middleware](../advanced/middleware.md){.internal-link target=_blank}.
 
-Ви дізнаєтесь, як обробляти <abbr title="Cross-Origin Resource Sharing">CORS</abbr> за допомогою middleware в наступному розділі.
+Ви дізнаєтесь, як обробляти <abbr title="Cross-Origin Resource Sharing - Спільне використання ресурсів між джерелами">CORS</abbr> за допомогою middleware в наступному розділі.

diff --git a/docs/uk/docs/tutorial/path-params-numeric-validations.md b/docs/uk/docs/tutorial/path-params-numeric-validations.md
index f6aa9201930fd692cce1e50579a8105a91e63848..9458436fd314afcc7b68897ffad23d4d94276d4e 100644 (file)
--- a/docs/uk/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/uk/docs/tutorial/path-params-numeric-validations.md
@@ -54,11 +54,11 @@ Python видасть помилку, якщо розмістити значен
 
 Тому ви можете оголосити вашу функцію так:
 
-{* ../../docs_src/path_params_numeric_validations/tutorial002_py39.py hl[7] *}
+{* ../../docs_src/path_params_numeric_validations/tutorial002_py310.py hl[7] *}
 
 Але майте на увазі, що якщо ви використовуєте `Annotated`, цієї проблеми не буде, це не матиме значення, оскільки ви не використовуєте значення за замовчуванням параметрів функції для `Query()` або `Path()`.
 
-{* ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py *}
+{* ../../docs_src/path_params_numeric_validations/tutorial002_an_py310.py *}
 
 ## Упорядковуйте параметри, як вам потрібно: хитрощі { #order-the-parameters-as-you-need-tricks }
 
@@ -81,15 +81,15 @@ Python видасть помилку, якщо розмістити значен
 
 Передайте `*` як перший параметр функції.
 
-Python нічого не зробить із цією `*`, але розпізнає, що всі наступні параметри слід викликати як аргументи за ключовим словом (пари ключ-значення), також відомі як <abbr title="From: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>. Навіть якщо вони не мають значення за замовчуванням.
+Python нічого не зробить із цією `*`, але розпізнає, що всі наступні параметри слід викликати як аргументи за ключовим словом (пари ключ-значення), також відомі як <abbr title="Походить від: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>. Навіть якщо вони не мають значення за замовчуванням.
 
-{* ../../docs_src/path_params_numeric_validations/tutorial003_py39.py hl[7] *}
+{* ../../docs_src/path_params_numeric_validations/tutorial003_py310.py hl[7] *}
 
 ### Краще з `Annotated` { #better-with-annotated }
 
 Майте на увазі, що якщо ви використовуєте `Annotated`, оскільки ви не використовуєте значення за замовчуванням параметрів функції, цієї проблеми не буде, і, ймовірно, вам не потрібно буде використовувати `*`.
 
-{* ../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py hl[10] *}
+{* ../../docs_src/path_params_numeric_validations/tutorial003_an_py310.py hl[10] *}
 
 ## Валідація числових даних: більше або дорівнює { #number-validations-greater-than-or-equal }
 
@@ -97,7 +97,7 @@ Python нічого не зробить із цією `*`, але розпізн
 
 Тут, завдяки `ge=1`, `item_id` має бути цілим числом, яке "`g`reater than or `e`qual" (більше або дорівнює) `1`.
 
-{* ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py hl[10] *}
+{* ../../docs_src/path_params_numeric_validations/tutorial004_an_py310.py hl[10] *}
 
 ## Валідація числових даних: більше ніж і менше або дорівнює { #number-validations-greater-than-and-less-than-or-equal }
 
@@ -106,19 +106,19 @@ Python нічого не зробить із цією `*`, але розпізн
 * `gt`: `g`reater `t`han
 * `le`: `l`ess than or `e`qual
 
-{* ../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py hl[10] *}
+{* ../../docs_src/path_params_numeric_validations/tutorial005_an_py310.py hl[10] *}
 
 ## Валідація числових даних: float, більше ніж і менше ніж { #number-validations-floats-greater-than-and-less-than }
 
 Валідація чисел також працює для значень типу `float`.
 
-Ось де стає важливо мати можливість оголошувати <abbr title="greater than"><code>gt</code></abbr>, а не тільки <abbr title="greater than or equal"><code>ge</code></abbr>. Це дозволяє, наприклад, вимагати, щоб значення було більше `0`, навіть якщо воно менше `1`.
+Ось де стає важливо мати можливість оголошувати <abbr title="greater than - більше ніж"><code>gt</code></abbr>, а не тільки <abbr title="greater than or equal - більше або дорівнює"><code>ge</code></abbr>. Це дозволяє, наприклад, вимагати, щоб значення було більше `0`, навіть якщо воно менше `1`.
 
 Таким чином, значення `0.5` буде допустимим. Але `0.0` або `0` — ні.
 
-Те саме стосується <abbr title="less than"><code>lt</code></abbr>.
+Те саме стосується <abbr title="less than - менше ніж"><code>lt</code></abbr>.
 
-{* ../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py hl[13] *}
+{* ../../docs_src/path_params_numeric_validations/tutorial006_an_py310.py hl[13] *}
 
 ## Підсумок { #recap }
 

diff --git a/docs/uk/docs/tutorial/path-params.md b/docs/uk/docs/tutorial/path-params.md
index 05989054956191a673e93efb3738af8cb8c070f1..17b99cf39a9822354e88691f3beb13d161436835 100644 (file)
--- a/docs/uk/docs/tutorial/path-params.md
+++ b/docs/uk/docs/tutorial/path-params.md
@@ -2,7 +2,7 @@
 
 Ви можете оголосити «параметри» або «змінні» шляху, використовуючи той самий синтаксис, що й у форматованих рядках Python:
 
-{* ../../docs_src/path_params/tutorial001_py39.py hl[6:7] *}
+{* ../../docs_src/path_params/tutorial001_py310.py hl[6:7] *}
 
 Значення параметра шляху `item_id` буде передано у вашу функцію як аргумент `item_id`.
 
@@ -16,17 +16,17 @@
 
 Ви можете оголосити тип параметра шляху у функції, використовуючи стандартні анотації типів Python:
 
-{* ../../docs_src/path_params/tutorial002_py39.py hl[7] *}
+{* ../../docs_src/path_params/tutorial002_py310.py hl[7] *}
 
 У цьому випадку `item_id` оголошено як `int`.
 
-/// check | Примітка
+/// check | Перевірте
 
 Це дасть вам підтримку редактора всередині функції з перевірками помилок, автодоповненням тощо.
 
 ///
 
-## <abbr title="also known as: serialization, parsing, marshalling – також відомо як: серіалізація, парсинг, маршалізація">Перетворення</abbr> даних { #data-conversion }
+## <dfn title="також відомо як: серіалізація, парсинг, маршалізація">Перетворення</dfn> даних { #data-conversion }
 
 Якщо ви запустите цей приклад і відкриєте у браузері <a href="http://127.0.0.1:8000/items/3" class="external-link" target="_blank">http://127.0.0.1:8000/items/3</a>, то побачите відповідь:
 
@@ -34,11 +34,11 @@
 {"item_id":3}
 ```
 
-/// check | Примітка
+/// check | Перевірте
 
 Зверніть увагу, що значення, яке отримала (і повернула) ваша функція, — це `3`, як Python `int`, а не рядок `"3"`.
 
-Отже, з таким оголошенням типу **FastAPI** надає вам автоматичний <abbr title="converting the string that comes from an HTTP request into Python data – перетворення рядка, що надходить із HTTP-запиту, у дані Python">«parsing»</abbr> запиту.
+Отже, з таким оголошенням типу **FastAPI** надає вам автоматичний запит <dfn title="перетворення рядка, що надходить із HTTP-запиту, у дані Python">«парсинг»</dfn>.
 
 ///
 
@@ -66,7 +66,7 @@
 
 Та сама помилка з’явиться, якщо ви передасте `float` замість `int`, як у: <a href="http://127.0.0.1:8000/items/4.2" class="external-link" target="_blank">http://127.0.0.1:8000/items/4.2</a>
 
-/// check | Примітка
+/// check | Перевірте
 
 Отже, з тим самим оголошенням типу в Python **FastAPI** надає вам валідацію даних.
 
@@ -82,7 +82,7 @@
 
 <img src="/img/tutorial/path-params/image01.png">
 
-/// check | Примітка
+/// check | Перевірте
 
 Знову ж таки, лише з тим самим оголошенням типу в Python **FastAPI** надає вам автоматичну, інтерактивну документацію (з інтеграцією Swagger UI).
 
@@ -118,19 +118,19 @@
 
 Оскільки *операції шляху* оцінюються по черзі, вам потрібно переконатися, що шлях для `/users/me` оголошено перед шляхом для `/users/{user_id}`:
 
-{* ../../docs_src/path_params/tutorial003_py39.py hl[6,11] *}
+{* ../../docs_src/path_params/tutorial003_py310.py hl[6,11] *}
 
 Інакше шлях для `/users/{user_id}` також відповідатиме `/users/me`, «вважаючи», що отримує параметр `user_id` зі значенням `"me"`.
 
 Так само ви не можете перевизначити операцію шляху:
 
-{* ../../docs_src/path_params/tutorial003b_py39.py hl[6,11] *}
+{* ../../docs_src/path_params/tutorial003b_py310.py hl[6,11] *}
 
 Завжди використовуватиметься перша, оскільки шлях збігається першим.
 
 ## Попередньо визначені значення { #predefined-values }
 
-Якщо у вас є *операція шляху*, яка отримує *параметр шляху*, але ви хочете, щоб можливі коректні значення *параметра шляху* були попередньо визначені, ви можете використати стандартний Python <abbr title="Enumeration">`Enum`</abbr>.
+Якщо у вас є *операція шляху*, яка отримує *параметр шляху*, але ви хочете, щоб можливі коректні значення *параметра шляху* були попередньо визначені, ви можете використати стандартний Python <abbr title="Enumeration - Перелік">`Enum`</abbr>.
 
 ### Створіть клас `Enum` { #create-an-enum-class }
 
@@ -140,11 +140,11 @@
 
 Після цього створіть атрибути класу з фіксованими значеннями, які будуть доступними коректними значеннями:
 
-{* ../../docs_src/path_params/tutorial005_py39.py hl[1,6:9] *}
+{* ../../docs_src/path_params/tutorial005_py310.py hl[1,6:9] *}
 
 /// tip | Порада
 
-Якщо вам цікаво, «AlexNet», «ResNet» та «LeNet» — це просто назви Machine Learning <abbr title="Technically, Deep Learning model architectures – технічно, архітектури моделей Deep Learning">models</abbr>.
+Якщо вам цікаво, «AlexNet», «ResNet» та «LeNet» — це просто назви моделей машинного навчання <dfn title="Технічно, архітектури моделей глибокого навчання">моделі</dfn>.
 
 ///
 
@@ -152,7 +152,7 @@
 
 Потім створіть *параметр шляху* з анотацією типу, використовуючи створений вами клас enum (`ModelName`):
 
-{* ../../docs_src/path_params/tutorial005_py39.py hl[16] *}
+{* ../../docs_src/path_params/tutorial005_py310.py hl[16] *}
 
 ### Перевірте документацію { #check-the-docs }
 
@@ -168,13 +168,13 @@
 
 Ви можете порівнювати його з *елементом перелічування* у створеному вами enum `ModelName`:
 
-{* ../../docs_src/path_params/tutorial005_py39.py hl[17] *}
+{* ../../docs_src/path_params/tutorial005_py310.py hl[17] *}
 
 #### Отримайте *значення перелічування* { #get-the-enumeration-value }
 
 Ви можете отримати фактичне значення (у цьому випадку це `str`), використовуючи `model_name.value`, або загалом `your_enum_member.value`:
 
-{* ../../docs_src/path_params/tutorial005_py39.py hl[20] *}
+{* ../../docs_src/path_params/tutorial005_py310.py hl[20] *}
 
 /// tip | Порада
 
@@ -188,7 +188,7 @@
 
 Вони будуть перетворені на відповідні значення (у цьому випадку рядки) перед поверненням клієнту:
 
-{* ../../docs_src/path_params/tutorial005_py39.py hl[18,21,23] *}
+{* ../../docs_src/path_params/tutorial005_py310.py hl[18,21,23] *}
 
 На стороні клієнта ви отримаєте відповідь у форматі JSON, наприклад:
 
@@ -227,7 +227,7 @@ OpenAPI не підтримує спосіб оголошення *параме
 
 Отже, ви можете використати його так:
 
-{* ../../docs_src/path_params/tutorial004_py39.py hl[6] *}
+{* ../../docs_src/path_params/tutorial004_py310.py hl[6] *}
 
 /// tip | Порада
 
@@ -242,7 +242,7 @@ OpenAPI не підтримує спосіб оголошення *параме
 З **FastAPI**, використовуючи короткі, інтуїтивно зрозумілі та стандартні оголошення типів Python, ви отримуєте:
 
 * Підтримку редактора: перевірка помилок, автодоповнення тощо.
-* Перетворення даних «<abbr title="converting the string that comes from an HTTP request into Python data – перетворення рядка, що надходить з HTTP-запиту, у дані Python">parsing</abbr>»
+* Перетворення даних «<dfn title="перетворення рядка, що надходить з HTTP-запиту, у дані Python">парсинг</dfn>»
 * Валідацію даних
 * Анотацію API та автоматичну документацію
 

diff --git a/docs/uk/docs/tutorial/query-param-models.md b/docs/uk/docs/tutorial/query-param-models.md
index a28bf6c27c2199ed943011ad6f14534065b2854e..5affc8a6c26b342a59feb870085bc88191259e54 100644 (file)
--- a/docs/uk/docs/tutorial/query-param-models.md
+++ b/docs/uk/docs/tutorial/query-param-models.md
@@ -1,6 +1,6 @@
 # Моделі параметрів запиту { #query-parameter-models }
 
-Якщо у Вас є група **query параметрів**, які пов’язані між собою, Ви можете створити **Pydantic-модель** для їх оголошення.
+Якщо у Вас є група **параметрів запиту**, які пов’язані між собою, Ви можете створити **Pydantic-модель** для їх оголошення.
 
 Це дозволить Вам **повторно використовувати модель** у **різних місцях**, а також оголошувати перевірки та метадані для всіх параметрів одночасно. 😎
 
@@ -10,13 +10,13 @@
 
 ///
 
-## Query параметри з Pydantic-моделлю { #query-parameters-with-a-pydantic-model }
+## Параметри запиту з Pydantic-моделлю { #query-parameters-with-a-pydantic-model }
 
-Оголосіть **query параметри**, які Вам потрібні, у **Pydantic-моделі**, а потім оголосіть цей параметр як `Query`:
+Оголосіть **параметри запиту**, які Вам потрібні, у **Pydantic-моделі**, а потім оголосіть цей параметр як `Query`:
 
 {* ../../docs_src/query_param_models/tutorial001_an_py310.py hl[9:13,17] *}
 
-**FastAPI**  буде **витягувати** дані для **кожного поля** з **query параметрів** у запиті та передавати їх у визначену вами Pydantic-модель.
+**FastAPI**  буде **витягувати** дані для **кожного поля** з **параметрів запиту** у запиті та передавати їх у визначену вами Pydantic-модель.
 
 ## Перевірте документацію { #check-the-docs }
 
@@ -26,23 +26,23 @@
 <img src="/img/tutorial/query-param-models/image01.png">
 </div>
 
-## Заборона зайвих Query параметрів { #forbid-extra-query-parameters }
+## Заборона зайвих параметрів запиту { #forbid-extra-query-parameters }
 
-У деяких особливих випадках (ймовірно, не дуже поширених) Ви можете захотіти **обмежити** query параметри, які дозволено отримувати.
+У деяких особливих випадках (ймовірно, не дуже поширених) Ви можете захотіти **обмежити** параметри запиту, які дозволено отримувати.
 
 Ви можете використати конфігурацію моделі Pydantic, щоб заборонити (`forbid`) будь-які зайві (`extra`) поля:
 
 {* ../../docs_src/query_param_models/tutorial002_an_py310.py hl[10] *}
 
-Якщо клієнт спробує надіслати **зайві** дані у **query параметрах**, він отримає **помилку** відповідь.
+Якщо клієнт спробує надіслати **зайві** дані у **параметрах запиту**, він отримає **відповідь з помилкою**.
 
-Наприклад, якщо клієнт спробує надіслати query параметр `tool` зі значенням `plumbus`, як у цьому запиті:
+Наприклад, якщо клієнт спробує надіслати параметр запиту `tool` зі значенням `plumbus`, як у цьому запиті:
 
 ```http
 https://example.com/items/?limit=10&tool=plumbus
 ```
 
-Він отримає відповідь з **помилкою**, яка повідомить, що query параметр `tool ` не дозволено:
+Він отримає відповідь з **помилкою**, яка повідомить, що параметр запиту `tool` не дозволено:
 
 ```json
 {
@@ -59,10 +59,10 @@ https://example.com/items/?limit=10&tool=plumbus
 
 ## Підсумок { #summary }
 
-Ви можете використовувати **Pydantic-моделі** для оголошення **query параметрів** у **FastAPI**. 😎
+Ви можете використовувати **Pydantic-моделі** для оголошення **параметрів запиту** у **FastAPI**. 😎
 
 /// tip | Порада
 
-Спойлер: Ви також можете використовувати Pydantic-моделі для оголошення cookie та заголовків, але про це Ви дізнаєтеся пізніше в цьому посібнику. 🤫
+Спойлер: Ви також можете використовувати Pydantic-моделі для оголошення кукі та заголовків, але про це Ви дізнаєтеся пізніше в цьому посібнику. 🤫
 
 ///

diff --git a/docs/uk/docs/tutorial/query-params-str-validations.md b/docs/uk/docs/tutorial/query-params-str-validations.md
index 414987880bcd9896b8c86ad1bd0d5124ace742b8..706dc670aa4c864f4fbf4803d80fa50e568a8693 100644 (file)
--- a/docs/uk/docs/tutorial/query-params-str-validations.md
+++ b/docs/uk/docs/tutorial/query-params-str-validations.md
@@ -18,7 +18,7 @@ FastAPI знатиме, що значення `q` не є обов’язков
 
 ## Додаткова валідація { #additional-validation }
 
-Ми хочемо, щоб навіть якщо `q` є необов’язковим, коли його передають, **його довжина не перевищувала 50 символів**.
+Ми хочемо, щоб навіть якщо `q` є необов’язковим, коли його передають, його довжина не перевищувала 50 символів.
 
 ### Імпорт `Query` та `Annotated` { #import-query-and-annotated }
 
@@ -47,40 +47,16 @@ FastAPI додав підтримку `Annotated` (і почав рекомен
 
 Раніше ми мали таку анотацію типу:
 
-//// tab | Python 3.10+
-
 ```Python
 q: str | None = None
 ```
 
-////
-
-//// tab | Python 3.9+
-
-```Python
-q: Union[str, None] = None
-```
-
-////
-
 Тепер ми загорнемо її у `Annotated`, і отримаємо:
 
-//// tab | Python 3.10+
-
 ```Python
 q: Annotated[str | None] = None
 ```
 
-////
-
-//// tab | Python 3.9+
-
-```Python
-q: Annotated[Union[str, None]] = None
-```
-
-////
-
 Обидві ці версії означають одне й те саме: `q` — це параметр, який може бути `str` або `None`, і за замовчуванням має значення `None`.
 
 А тепер переходимо до цікавого! 🎉
@@ -93,23 +69,23 @@ q: Annotated[Union[str, None]] = None
 
 Зверніть увагу, що значення за замовчуванням усе ще `None`, тому параметр залишається необов'язковим.
 
-Але тепер, додавши `Query(max_length=50)` всередину `Annotated`, ми повідомляємо FastAPI, що хочемо **додаткову валідацію** для цього значення: ми хочемо, щоб воно мало максимум 50 символів. 😎
+Але тепер, додавши `Query(max_length=50)` всередину `Annotated`, ми повідомляємо FastAPI, що хочемо додаткову валідацію для цього значення: ми хочемо, щоб воно мало максимум 50 символів. 😎
 
 /// tip | Порада
 
-Тут ми використовуємо `Query()`, оскільки це **query параметр**. Далі ми розглянемо інші варіанти, як-от `Path()`, `Body()`, `Header()` та `Cookie()`, які приймають ті самі аргументи, що й `Query()`.
+Тут ми використовуємо `Query()`, оскільки це query параметр. Далі ми розглянемо інші варіанти, як-от `Path()`, `Body()`, `Header()` та `Cookie()`, які приймають ті самі аргументи, що й `Query()`.
 
 ///
 
 Тепер FastAPI:
 
-* **Перевірить** дані, щоб переконатися, що їхня максимальна довжина — 50 символів
-* Покажe **чітку помилку** клієнту, якщо дані недійсні
-* **Задокументує** параметр в OpenAPI-схемі *операції шляху* (що відобразиться в **автоматично згенерованій документації**)
+* Перевірить дані, щоб переконатися, що їхня максимальна довжина — 50 символів
+* Покажe чітку помилку клієнту, якщо дані недійсні
+* Задокументує параметр в OpenAPI-схемі операції шляху (що відобразиться в автоматично згенерованій документації)
 
 ## Альтернативний (застарілий) метод: `Query` як значення за замовчуванням { #alternative-old-query-as-the-default-value }
 
-У попередніх версіях FastAPI (до <abbr title="before 2023-03 – до 2023-03">0.95.0</abbr>) потрібно було використовувати `Query` як значення за замовчуванням параметра, замість того, щоб додавати його в `Annotated`. Є висока ймовірність, що ви зустрінете код із таким підходом, тож я поясню його.
+У попередніх версіях FastAPI (до <dfn title="до 2023-03">0.95.0</dfn>) потрібно було використовувати `Query` як значення за замовчуванням параметра, замість того, щоб додавати його в `Annotated`. Є висока ймовірність, що ви зустрінете код із таким підходом, тож я поясню його.
 
 /// tip | Порада
 
@@ -131,7 +107,6 @@ q: str | None = Query(default=None)
 
 ...робить параметр необов’язковим зі значенням за замовчуванням `None`, що еквівалентно:
 
-
 ```Python
 q: str | None = None
 ```
@@ -144,7 +119,7 @@ q: str | None = None
 q: str | None = Query(default=None, max_length=50)
 ```
 
-Це забезпечить валідацію даних, виведе зрозумілу помилку у разі недійсних даних і задокументує параметр у схемі OpenAPI *операції шляху*.
+Це забезпечить валідацію даних, виведе зрозумілу помилку у разі недійсних даних і задокументує параметр у схемі OpenAPI операції шляху.
 
 ### `Query` як значення за замовчуванням або всередині `Annotated` { #query-as-the-default-value-or-in-annotated }
 
@@ -174,13 +149,13 @@ q: str = Query(default="rick")
 
 ### Переваги використання `Annotated` { #advantages-of-annotated }
 
-**Використання `Annotated` є рекомендованим** замість задання значення за замовчуванням у параметрах функції, оскільки воно **краще** з кількох причин. 🤓
+Використання `Annotated` є рекомендованим замість задання значення за замовчуванням у параметрах функції, оскільки воно краще з кількох причин. 🤓
 
-Значення **за замовчуванням** параметра **функції** є **фактичним значенням за замовчуванням**, що є більш інтуїтивним у Python загалом. 😌
+Значення за замовчуванням параметра функції є фактичним значенням за замовчуванням, що є більш інтуїтивним у Python загалом. 😌
 
-Ви можете **викликати** ту саму функцію **в інших місцях** без FastAPI, і вона **працюватиме очікувано**. Якщо параметр є **обов’язковим** (без значення за замовчуванням), ваш **редактор** повідомить про помилку, а **Python** також видасть помилку, якщо ви виконаєте функцію без передавання цього параметра.
+Ви можете викликати ту саму функцію в інших місцях без FastAPI, і вона працюватиме очікувано. Якщо параметр є обов’язковим (без значення за замовчуванням), ваш редактор повідомить про помилку, а Python також видасть помилку, якщо ви виконаєте функцію без передавання цього параметра.
 
-Якщо ви не використовуєте `Annotated`, а використовуєте **(старий) стиль значень за замовчуванням**, то при виклику цієї функції без FastAPI **в інших місцях**, потрібно **пам’ятати** передати їй аргументи, щоб вона працювала коректно, інакше значення будуть відрізнятися від очікуваних (наприклад, ви отримаєте `QueryInfo` або щось подібне замість `str`). І ваш редактор не повідомить про помилку, і Python не скаржитиметься під час запуску цієї функції — лише коли операції всередині завершаться помилкою.
+Якщо ви не використовуєте `Annotated`, а використовуєте (старий) стиль значень за замовчуванням, то при виклику цієї функції без FastAPI в інших місцях потрібно пам’ятати передати їй аргументи, щоб вона працювала коректно, інакше значення будуть відрізнятися від очікуваних (наприклад, ви отримаєте `QueryInfo` або щось подібне замість `str`). І ваш редактор не повідомить про помилку, і Python не скаржитиметься під час запуску цієї функції — лише коли операції всередині завершаться помилкою.
 
 Оскільки `Annotated` може містити кілька анотацій метаданих, тепер ви навіть можете використовувати ту саму функцію з іншими інструментами, такими як <a href="https://typer.tiangolo.com/" class="external-link" target="_blank">Typer</a>. 🚀
 
@@ -192,7 +167,7 @@ q: str = Query(default="rick")
 
 ## Додавання регулярних виразів { #add-regular-expressions }
 
-Ви можете визначити <abbr title="A regular expression, regex or regexp is a sequence of characters that define a search pattern for strings. – Регулярний вираз (regex або regexp) — це послідовність символів, яка визначає шаблон для пошуку в рядках.">regular expression</abbr> `pattern`, якому має відповідати параметр:
+Ви можете визначити <dfn title="Регулярний вираз, regex або regexp — це послідовність символів, яка визначає шаблон для пошуку в рядках.">регулярний вираз</dfn> `pattern`, якому має відповідати параметр:
 
 {* ../../docs_src/query_params_str_validations/tutorial004_an_py310.py hl[11] *}
 
@@ -212,7 +187,7 @@ q: str = Query(default="rick")
 
 Припустімо, що ви хочете оголосити query параметр `q` з `min_length` `3` і значенням за замовчуванням `"fixedquery"`:
 
-{* ../../docs_src/query_params_str_validations/tutorial005_an_py39.py hl[9] *}
+{* ../../docs_src/query_params_str_validations/tutorial005_an_py310.py hl[9] *}
 
 /// note | Примітка
 
@@ -242,7 +217,7 @@ q: Annotated[str | None, Query(min_length=3)] = None
 
 Тому, якщо вам потрібно оголосити значення як обов’язкове під час використання `Query`, просто не вказуйте значення за замовчуванням:
 
-{* ../../docs_src/query_params_str_validations/tutorial006_an_py39.py hl[9] *}
+{* ../../docs_src/query_params_str_validations/tutorial006_an_py310.py hl[9] *}
 
 ### Обов’язковий, може бути `None` { #required-can-be-none }
 
@@ -266,7 +241,7 @@ q: Annotated[str | None, Query(min_length=3)] = None
 http://localhost:8000/items/?q=foo&q=bar
 ```
 
-ви отримаєте кілька значень `q` *query параметрів* (`foo` і `bar`) у вигляді Python `list` у вашій *функції операції шляху*, у *параметрі функції* `q`.
+ви отримаєте кілька значень `q` query параметрів (`foo` і `bar`) у вигляді Python `list` у вашій функції операції шляху, у параметрі функції `q`.
 
 Отже, відповідь на цей URL буде:
 
@@ -293,7 +268,7 @@ http://localhost:8000/items/?q=foo&q=bar
 
 Ви також можете визначити значення за замовчуванням `list`, якщо жодне значення не було передане:
 
-{* ../../docs_src/query_params_str_validations/tutorial012_an_py39.py hl[9] *}
+{* ../../docs_src/query_params_str_validations/tutorial012_an_py310.py hl[9] *}
 
 Якщо ви перейдете за посиланням:
 
@@ -316,7 +291,7 @@ http://localhost:8000/items/
 
 Ви також можете використовувати `list` напряму замість `list[str]`:
 
-{* ../../docs_src/query_params_str_validations/tutorial013_an_py39.py hl[9] *}
+{* ../../docs_src/query_params_str_validations/tutorial013_an_py310.py hl[9] *}
 
 /// note | Примітка
 
@@ -372,7 +347,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
 
 Припустімо, що вам більше не подобається цей параметр.
 
-Вам потрібно залишити його на деякий час, оскільки ним користуються клієнти, але ви хочете, щоб документація чітко показувала, що він є <abbr title="obsolete, recommended not to use it – застарілий, не рекомендується до використання">deprecated</abbr>.
+Вам потрібно залишити його на деякий час, оскільки ним користуються клієнти, але ви хочете, щоб документація чітко показувала, що він є <dfn title="застарілий, не рекомендується до використання">застарілий</dfn>.
 
 Тоді передайте параметр `deprecated=True` до `Query`:
 
@@ -390,9 +365,9 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
 
 ## Кастомна валідація { #custom-validation }
 
-Можуть бути випадки, коли вам потрібно провести **кастомну валідацію**, яку не можна реалізувати за допомогою параметрів, показаних вище.
+Можуть бути випадки, коли вам потрібно провести кастомну валідацію, яку не можна реалізувати за допомогою параметрів, показаних вище.
 
-У таких випадках ви можете використати **кастомну функцію-валідатор**, яка буде застосована після звичайної валідації (наприклад, після перевірки, що значення є типом `str`).
+У таких випадках ви можете використати кастомну функцію-валідатор, яка буде застосована після звичайної валідації (наприклад, після перевірки, що значення є типом `str`).
 
 Це можна досягти за допомогою <a href="https://docs.pydantic.dev/latest/concepts/validators/#field-after-validator" class="external-link" target="_blank">Pydantic's `AfterValidator`</a> в середині `Annotated`.
 
@@ -402,7 +377,7 @@ Pydantic також має <a href="https://docs.pydantic.dev/latest/concepts/va
 
 ///
 
-Наприклад, цей кастомний валідатор перевіряє, чи починається ID елемента з `isbn-` для номера книги <abbr title="ISBN means International Standard Book Number – ISBN означає Міжнародний стандартний номер книги">ISBN</abbr> або з `imdb-` для ID URL фільму на <abbr title="IMDB (Internet Movie Database) is a website with information about movies – IMDB (Internet Movie Database) це вебсайт з інформацією про фільми">IMDB</abbr>:
+Наприклад, цей кастомний валідатор перевіряє, чи починається ID елемента з `isbn-` для номера книги <abbr title="International Standard Book Number - Міжнародний стандартний номер книги">ISBN</abbr> або з `imdb-` для ID URL фільму на <abbr title="Internet Movie Database - Інтернетна база даних фільмів: вебсайт з інформацією про фільми">IMDB</abbr>:
 
 {* ../../docs_src/query_params_str_validations/tutorial015_an_py310.py hl[5,16:19,24] *}
 
@@ -414,15 +389,15 @@ Pydantic також має <a href="https://docs.pydantic.dev/latest/concepts/va
 
 /// tip | Порада
 
-Якщо вам потрібно виконати будь-яку валідацію, яка вимагає взаємодії з будь-яким **зовнішнім компонентом**, таким як база даних чи інший API, замість цього слід використовувати **FastAPI Dependencies** — ви дізнаєтесь про них пізніше.
+Якщо вам потрібно виконати будь-яку валідацію, яка вимагає взаємодії з будь-яким зовнішнім компонентом, таким як база даних чи інший API, замість цього слід використовувати FastAPI Dependencies — ви дізнаєтесь про них пізніше.
 
-Ці кастомні валідатори використовуються для речей, які можна перевірити лише з **тіими самими даними**, що надані в запиті.
+Ці кастомні валідатори використовуються для речей, які можна перевірити лише з тими самими даними, що надані в запиті.
 
 ///
 
 ### Зрозумійте цей код { #understand-that-code }
 
-Головний момент — це використання **`AfterValidator` з функцією всередині `Annotated`**. Можете пропустити цю частину, якщо хочете. 🤸
+Головний момент — це використання `AfterValidator` з функцією всередині `Annotated`. Можете пропустити цю частину, якщо хочете. 🤸
 
 ---
 
@@ -436,17 +411,17 @@ Pydantic також має <a href="https://docs.pydantic.dev/latest/concepts/va
 
 #### Випадковий елемент { #a-random-item }
 
-За допомогою `data.items()` ми отримуємо <abbr title="Something we can iterate on with a for loop, like a list, set, etc. – Об'єкт, який можна перебирати в циклі, як-от список чи множину.">iterable object</abbr> із кортежами, що містять ключ і значення для кожного елемента словника.
+За допомогою `data.items()` ми отримуємо <dfn title="Щось, що ми можемо ітерувати циклом for, як-от список, множина тощо.">ітерабельний об'єкт</dfn> із кортежами, що містять ключ і значення для кожного елемента словника.
 
-Ми перетворюємо цей iterable object у звичайний `list` за допомогою `list(data.items())`.
+Ми перетворюємо цей ітерабельний об'єкт у звичайний `list` за допомогою `list(data.items())`.
 
-Потім, використовуючи `random.choice()`, ми можемо отримати **випадкове значення** зі списку, тобто отримуємо кортеж із `(id, name)`. Це може бути щось на зразок `("imdb-tt0371724", "The Hitchhiker's Guide to the Galaxy")`.
+Потім, використовуючи `random.choice()`, ми можемо отримати випадкове значення зі списку, тобто отримуємо кортеж із `(id, name)`. Це може бути щось на зразок `("imdb-tt0371724", "The Hitchhiker's Guide to the Galaxy")`.
 
-Далі ми **присвоюємо ці два значення** кортежу змінним `id` і `name`.
+Далі ми присвоюємо ці два значення кортежу змінним `id` і `name`.
 
 Тож, якщо користувач не вказав ID елемента, він все одно отримає випадкову рекомендацію.
 
-...ми робимо все це в **одному простому рядку**. 🤯 Хіба ви не любите Python? 🐍
+...ми робимо все це в одному простому рядку. 🤯 Хіба ви не любите Python? 🐍
 
 {* ../../docs_src/query_params_str_validations/tutorial015_an_py310.py ln[22:30] hl[29] *}
 

diff --git a/docs/uk/docs/tutorial/query-params.md b/docs/uk/docs/tutorial/query-params.md
index a9068aa8f99ea94455ebfcb9cc7fc27d2d8d6232..4888f4c461e3127c763a27a1d92e0658c916ec2e 100644 (file)
--- a/docs/uk/docs/tutorial/query-params.md
+++ b/docs/uk/docs/tutorial/query-params.md
@@ -2,7 +2,7 @@
 
 Коли ви оголошуєте інші параметри функції, які не є частиною параметрів шляху, вони автоматично інтерпретуються як параметри «query».
 
-{* ../../docs_src/query_params/tutorial001_py39.py hl[9] *}
+{* ../../docs_src/query_params/tutorial001_py310.py hl[9] *}
 
 Query — це набір пар ключ-значення, що йдуть після символу `?` в URL, розділені символами `&`.
 
@@ -24,7 +24,7 @@ http://127.0.0.1:8000/items/?skip=0&limit=10
 Увесь той самий процес, який застосовується до параметрів шляху, також застосовується до параметрів query:
 
 * Підтримка в редакторі (очевидно)
-* <abbr title="converting the string that comes from an HTTP request into Python data – перетворення рядка, що надходить з HTTP-запиту, у дані Python">«parsing»</abbr> даних
+* <dfn title="перетворення рядка, що надходить з HTTP-запиту, у дані Python">«парсинг»</dfn> даних
 * Валідація даних
 * Автоматична документація
 
@@ -65,7 +65,7 @@ http://127.0.0.1:8000/items/?skip=20
 
 У цьому випадку параметр функції `q` буде необов’язковим і за замовчуванням матиме значення `None`.
 
-/// check | Примітка
+/// check | Перевірте
 
 Також зверніть увагу, що **FastAPI** достатньо розумний, щоб визначити, що параметр шляху `item_id` є параметром шляху, а `q` — ні, отже, це параметр query.
 
@@ -128,7 +128,7 @@ http://127.0.0.1:8000/items/foo?short=yes
 
 Але якщо ви хочете зробити параметр query обов’язковим, просто не вказуйте для нього значення за замовчуванням:
 
-{* ../../docs_src/query_params/tutorial005_py39.py hl[6:7] *}
+{* ../../docs_src/query_params/tutorial005_py310.py hl[6:7] *}
 
 Тут параметр query `needy` — обов’язковий параметр query типу `str`.
 
@@ -183,6 +183,6 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
 
 /// tip | Порада
 
-Ви також можете використовувати `Enum` так само, як і з [Path Parameters](path-params.md#predefined-values){.internal-link target=_blank}.
+Ви також можете використовувати `Enum` так само, як і з [Параметри шляху](path-params.md#predefined-values){.internal-link target=_blank}.
 
 ///

diff --git a/docs/uk/docs/tutorial/request-files.md b/docs/uk/docs/tutorial/request-files.md
index a6ff70dc097dc7a3c9d1876558c86912ccdaaa63..8e64b12c38b4ee97b1c0edd53974812ac5c59e8e 100644 (file)
--- a/docs/uk/docs/tutorial/request-files.md
+++ b/docs/uk/docs/tutorial/request-files.md
@@ -20,13 +20,13 @@ $ pip install python-multipart
 
 Імпортуйте `File` та `UploadFile` з `fastapi`:
 
-{* ../../docs_src/request_files/tutorial001_an_py39.py hl[3] *}
+{* ../../docs_src/request_files/tutorial001_an_py310.py hl[3] *}
 
 ## Визначення параметрів `File` { #define-file-parameters }
 
 Створіть параметри файлів так само як ви б створювали `Body` або `Form`:
 
-{* ../../docs_src/request_files/tutorial001_an_py39.py hl[9] *}
+{* ../../docs_src/request_files/tutorial001_an_py310.py hl[9] *}
 
 /// info | Інформація
 
@@ -54,7 +54,7 @@ $ pip install python-multipart
 
 Визначте параметр файлу з типом `UploadFile`:
 
-{* ../../docs_src/request_files/tutorial001_an_py39.py hl[14] *}
+{* ../../docs_src/request_files/tutorial001_an_py310.py hl[14] *}
 
 Використання `UploadFile` має кілька переваг перед `bytes`:
 
@@ -121,7 +121,7 @@ contents = myfile.file.read()
 
 Але якщо форма містить файли, вона кодується як `multipart/form-data`. Якщо ви використовуєте `File`, **FastAPI** знатиме, що потрібно отримати файли з правильної частини тіла.
 
-Якщо ви хочете дізнатися більше про ці типи кодування та формові поля, ознайомтеся з <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN</abbr> web docs для <code>POST</code></a>.
+Якщо ви хочете дізнатися більше про ці типи кодування та формові поля, ознайомтеся з <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank"><abbr title="Mozilla Developer Network - Мережа Розробників Mozilla">MDN</abbr> web docs для <code>POST</code></a>.
 
 ///
 
@@ -143,7 +143,7 @@ contents = myfile.file.read()
 
 Ви також можете використовувати `File()` разом із `UploadFile`, наприклад, щоб встановити додаткові метадані:
 
-{* ../../docs_src/request_files/tutorial001_03_an_py39.py hl[9,15] *}
+{* ../../docs_src/request_files/tutorial001_03_an_py310.py hl[9,15] *}
 
 ## Завантаження кількох файлів { #multiple-file-uploads }
 
@@ -153,7 +153,7 @@ contents = myfile.file.read()
 
 Щоб це реалізувати, потрібно оголосити список `bytes` або `UploadFile`:
 
-{* ../../docs_src/request_files/tutorial002_an_py39.py hl[10,15] *}
+{* ../../docs_src/request_files/tutorial002_an_py310.py hl[10,15] *}
 
 Ви отримаєте, як і було оголошено, `list` із `bytes` або `UploadFile`.
 
@@ -169,7 +169,7 @@ contents = myfile.file.read()
 
 Так само як і раніше, ви можете використовувати `File()`, щоб встановити додаткові параметри навіть для `UploadFile`:
 
-{* ../../docs_src/request_files/tutorial003_an_py39.py hl[11,18:20] *}
+{* ../../docs_src/request_files/tutorial003_an_py310.py hl[11,18:20] *}
 
 ## Підсумок { #recap }
 

diff --git a/docs/uk/docs/tutorial/request-form-models.md b/docs/uk/docs/tutorial/request-form-models.md
index 1bfd368d603d212fe30efdbc7c9b65e8bec60bce..86510be589524146251662818f5287405169c219 100644 (file)
--- a/docs/uk/docs/tutorial/request-form-models.md
+++ b/docs/uk/docs/tutorial/request-form-models.md
@@ -24,7 +24,7 @@ $ pip install python-multipart
 
 Вам просто потрібно оголосити **Pydantic-модель** з полями, які ви хочете отримати як **поля форми**, а потім оголосити параметр як `Form`:
 
-{* ../../docs_src/request_form_models/tutorial001_an_py39.py hl[9:11,15] *}
+{* ../../docs_src/request_form_models/tutorial001_an_py310.py hl[9:11,15] *}
 
 **FastAPI**  **витягне** дані для **кожного поля** з **формових даних** у запиті та надасть вам Pydantic-модель, яку ви визначили.
 
@@ -48,7 +48,7 @@ $ pip install python-multipart
 
 Ви можете використати конфігурацію Pydantic-моделі, щоб заборонити `forbid` будь-які додаткові `extra` поля:
 
-{* ../../docs_src/request_form_models/tutorial002_an_py39.py hl[12] *}
+{* ../../docs_src/request_form_models/tutorial002_an_py310.py hl[12] *}
 
 Якщо клієнт спробує надіслати додаткові дані, він отримає **відповідь з помилкою**.
 

diff --git a/docs/uk/docs/tutorial/request-forms-and-files.md b/docs/uk/docs/tutorial/request-forms-and-files.md
index e809bee2257035cef4efaf04da8bc44bf52171c0..817769b714e525efd90b40b9f66eba680bdedfce 100644 (file)
--- a/docs/uk/docs/tutorial/request-forms-and-files.md
+++ b/docs/uk/docs/tutorial/request-forms-and-files.md
@@ -6,7 +6,7 @@
 
 Щоб отримувати завантажені файли та/або дані форми, спочатку встановіть <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
 
-Ð\9fеÑ\80еконайÑ\82еÑ\81Ñ\8f, Ñ\89о Ð\92и створили [віртуальне середовище](../virtual-environments.md){.internal-link target=_blank}, активували його, а потім встановили бібліотеку, наприклад:
+Ð\9fеÑ\80еконайÑ\82еÑ\81Ñ\8f, Ñ\89о ви створили [віртуальне середовище](../virtual-environments.md){.internal-link target=_blank}, активували його, а потім встановили бібліотеку, наприклад:
 
 ```console
 $ pip install python-multipart
@@ -16,15 +16,15 @@ $ pip install python-multipart
 
 ## Імпорт `File` та `Form` { #import-file-and-form }
 
-{* ../../docs_src/request_forms_and_files/tutorial001_an_py39.py hl[3] *}
+{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[3] *}
 
 ## Оголошення параметрів `File` та `Form` { #define-file-and-form-parameters }
 
 Створіть параметри файлів та форми так само як і для `Body` або `Query`:
 
-{* ../../docs_src/request_forms_and_files/tutorial001_an_py39.py hl[10:12] *}
+{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[10:12] *}
 
-Файли Ñ\82а полÑ\8f Ñ\84оÑ\80ми бÑ\83дÑ\83Ñ\82Ñ\8c заванÑ\82аженÑ\96 Ñ\8fк Ñ\84оÑ\80мовÑ\96 данÑ\96, Ñ\96 Ð\92и отримаєте файли та поля форми.
+Файли Ñ\82а полÑ\8f Ñ\84оÑ\80ми бÑ\83дÑ\83Ñ\82Ñ\8c заванÑ\82аженÑ\96 Ñ\8fк Ñ\84оÑ\80мовÑ\96 данÑ\96, Ñ\96 ви отримаєте файли та поля форми.
 
 Ви також можете оголосити деякі файли як `bytes`, а деякі як `UploadFile`.
 

diff --git a/docs/uk/docs/tutorial/request-forms.md b/docs/uk/docs/tutorial/request-forms.md
index 2a22ad922a0562b0933f334e6ae5adff123aea79..7f0c6e9bb33a79cd1fee05637c8d5458e6063630 100644 (file)
--- a/docs/uk/docs/tutorial/request-forms.md
+++ b/docs/uk/docs/tutorial/request-forms.md
@@ -1,6 +1,6 @@
 # Дані форми { #form-data }
 
-ЯкÑ\89о вам потрібно отримувати поля форми замість JSON, ви можете використовувати `Form`.
+Ð\9aоли вам потрібно отримувати поля форми замість JSON, ви можете використовувати `Form`.
 
 /// info | Інформація
 
@@ -18,17 +18,17 @@ $ pip install python-multipart
 
 Імпортуйте `Form` з `fastapi`:
 
-{* ../../docs_src/request_forms/tutorial001_an_py39.py hl[3] *}
+{* ../../docs_src/request_forms/tutorial001_an_py310.py hl[3] *}
 
 ## Оголошення параметрів `Form` { #define-form-parameters }
 
 Створюйте параметри форми так само як ви б створювали `Body` або `Query`:
 
-{* ../../docs_src/request_forms/tutorial001_an_py39.py hl[9] *}
+{* ../../docs_src/request_forms/tutorial001_an_py310.py hl[9] *}
 
-Наприклад, один зі способів використання специфікації OAuth2 (так званий "password flow") вимагає надсилати `username` та `password` як поля форми.
+Наприклад, один зі способів використання специфікації OAuth2 (так званий «password flow») вимагає надсилати `username` та `password` як поля форми.
 
-<abbr title="specification">spec</abbr> вимагає, щоб ці поля мали точні назви `username` і `password` та надсилалися у вигляді полів форми, а не JSON.
+<dfn title="специфікація">специфікація</dfn> вимагає, щоб ці поля мали точні назви `username` і `password` та надсилалися у вигляді полів форми, а не JSON.
 
 З `Form` ви можете оголошувати ті ж конфігурації, що і з `Body` (та `Query`, `Path`, `Cookie`), включаючи валідацію, приклади, псевдоніми (наприклад, `user-name` замість `username`) тощо.
 
@@ -44,19 +44,19 @@ $ pip install python-multipart
 
 ///
 
-## Про "поля форми" { #about-form-fields }
+## Про «поля форми» { #about-form-fields }
 
-HTML-форми (`<form></form>`) надсилають дані на сервер у "спеціальному" кодуванні, яке відрізняється від JSON.
+HTML-форми (`<form></form>`) надсилають дані на сервер у «спеціальному» кодуванні, яке відрізняється від JSON.
 
 **FastAPI** подбає про те, щоб зчитати ці дані з правильного місця, а не з JSON.
 
 /// note | Технічні деталі
 
-Дані з форм зазвичай кодуються за допомогою "типу медіа" `application/x-www-form-urlencoded`.
+Дані з форм зазвичай кодуються за допомогою «типу медіа» `application/x-www-form-urlencoded`.
 
 Але якщо форма містить файли, вона кодується як `multipart/form-data`. Ви дізнаєтеся про обробку файлів у наступному розділі.
 
-Якщо ви хочете дізнатися більше про ці кодування та поля форм, зверніться до <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN</abbr> вебдокументації для <code>POST</code></a>.
+Якщо ви хочете дізнатися більше про ці кодування та поля форм, зверніться до <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank"><abbr title="Mozilla Developer Network - Мережа Розробників Mozilla">MDN</abbr> вебдокументації для <code>POST</code></a>.
 
 ///
 

diff --git a/docs/uk/docs/tutorial/response-model.md b/docs/uk/docs/tutorial/response-model.md
index 2fcad943879aadf1700d2f5e950c14beda04daf8..fcf765c9da77b63ae1e1b09e9624ef46d0cd7ab6 100644 (file)
--- a/docs/uk/docs/tutorial/response-model.md
+++ b/docs/uk/docs/tutorial/response-model.md
@@ -81,7 +81,7 @@ FastAPI використовуватиме цей `response_model` для вик
 $ pip install email-validator
 ```
 
-or with:
+або так:
 
 ```console
 $ pip install "pydantic[email]"
@@ -183,7 +183,7 @@ FastAPI виконує кілька внутрішніх операцій з Pyd
 
 Найпоширенішим випадком буде [повернення Response напряму, як пояснюється пізніше у розширеній документації](../advanced/response-directly.md){.internal-link target=_blank}.
 
-{* ../../docs_src/response_model/tutorial003_02_py39.py hl[8,10:11] *}
+{* ../../docs_src/response_model/tutorial003_02_py310.py hl[8,10:11] *}
 
 Цей простий випадок автоматично обробляється FastAPI, тому що анотація типу повернення — це клас (або підклас) `Response`.
 
@@ -193,7 +193,7 @@ FastAPI виконує кілька внутрішніх операцій з Pyd
 
 Ви також можете використати підклас `Response` в анотації типу:
 
-{* ../../docs_src/response_model/tutorial003_03_py39.py hl[8:9] *}
+{* ../../docs_src/response_model/tutorial003_03_py310.py hl[8:9] *}
 
 Це теж працюватиме, бо `RedirectResponse` — підклас `Response`, і FastAPI автоматично обробить цей простий випадок.
 
@@ -201,7 +201,7 @@ FastAPI виконує кілька внутрішніх операцій з Pyd
 
 Але коли ви повертаєте якийсь інший довільний об’єкт, що не є валідним типом Pydantic (наприклад, об’єкт бази даних), і анотуєте його так у функції, FastAPI спробує створити модель відповіді Pydantic на основі цієї анотації типу і це завершиться помилкою.
 
-Те саме станеться, якщо ви використаєте <abbr title='Об’єднання (union) між кількома типами означає «будь-який із цих типів».'>union</abbr> між різними типами, де один або більше не є валідними типами Pydantic, наприклад, це завершиться помилкою 💥:
+Те саме станеться, якщо у вас буде <dfn title="об'єднання між кількома типами означає «будь-який із цих типів»">об'єднання</dfn> між різними типами, де один або більше не є валідними типами Pydantic, наприклад, це завершиться помилкою 💥:
 
 {* ../../docs_src/response_model/tutorial003_04_py310.py hl[8] *}
 

diff --git a/docs/uk/docs/tutorial/response-status-code.md b/docs/uk/docs/tutorial/response-status-code.md
index 5a08ee46b544e3771cdd82498ccb8c3d6fb199ef..c9ceb8f5089c2978ce6f3d96649b0c6783f02f19 100644 (file)
--- a/docs/uk/docs/tutorial/response-status-code.md
+++ b/docs/uk/docs/tutorial/response-status-code.md
@@ -8,7 +8,7 @@
 * `@app.delete()`
 * тощо.
 
-{* ../../docs_src/response_status_code/tutorial001_py39.py hl[6] *}
+{* ../../docs_src/response_status_code/tutorial001_py310.py hl[6] *}
 
 /// note | Примітка
 
@@ -66,7 +66,7 @@ FastAPI знає про це і створить документацію OpenAP
 
 /// tip | Порада
 
-Щоб дізнатися більше про кожен код статусу і для чого призначений кожен із них, перегляньте документацію <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN</abbr> про HTTP коди статусу</a>.
+Щоб дізнатися більше про кожен код статусу і для чого призначений кожен із них, перегляньте документацію <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network - Мережа Розробників Mozilla">MDN</abbr> про HTTP коди статусу</a>.
 
 ///
 
@@ -74,7 +74,7 @@ FastAPI знає про це і створить документацію OpenAP
 
 Розглянемо попередній приклад ще раз:
 
-{* ../../docs_src/response_status_code/tutorial001_py39.py hl[6] *}
+{* ../../docs_src/response_status_code/tutorial001_py310.py hl[6] *}
 
 `201` — це код статусу для «Created».
 
@@ -82,7 +82,7 @@ FastAPI знає про це і створить документацію OpenAP
 
 Ви можете використовувати зручні змінні з `fastapi.status`.
 
-{* ../../docs_src/response_status_code/tutorial002_py39.py hl[1,6] *}
+{* ../../docs_src/response_status_code/tutorial002_py310.py hl[1,6] *}
 
 Вони — просто для зручності, містять те саме число, але так ви можете скористатися автозаповненням редактора, щоб знайти їх:
 

diff --git a/docs/uk/docs/tutorial/schema-extra-example.md b/docs/uk/docs/tutorial/schema-extra-example.md
index 54608c2ab168aeb151785a369cc4f5f3910e2e73..38ce0eb3038550901a8e64a2f4c210265655d9e5 100644 (file)
--- a/docs/uk/docs/tutorial/schema-extra-example.md
+++ b/docs/uk/docs/tutorial/schema-extra-example.md
@@ -40,7 +40,7 @@ OpenAPI 3.1.0 (який використовується починаючи з F
 
 {* ../../docs_src/schema_extra_example/tutorial002_py310.py hl[2,8:11] *}
 
-## `examples` у JSON-схемі — OpenAPI { #examples-in-json-schema-openapi }
+## `examples` у JSON-схемі - OpenAPI { #examples-in-json-schema-openapi }
 
 При використанні будь-кого з наступного:
 
@@ -74,7 +74,7 @@ OpenAPI 3.1.0 (який використовується починаючи з F
 
 Коли Ви це робите, приклади будуть частиною внутрішньої **JSON-схеми** для цих даних тіла.
 
-Втім, на момент написання цього (<abbr title="2023-08-26">час написання цього</abbr>), Swagger UI — інструмент, який відповідає за відображення UI документації — не підтримує показ кількох прикладів для даних у **JSON-схемі**. Але нижче можна прочитати про обхідний шлях.
+Втім, на <dfn title="2023-08-26">час написання цього</dfn>, Swagger UI — інструмент, який відповідає за відображення UI документації — не підтримує показ кількох прикладів для даних у **JSON-схемі**. Але нижче можна прочитати про обхідний шлях.
 
 ### Специфічні для OpenAPI `examples` { #openapi-specific-examples }
 

diff --git a/docs/uk/docs/tutorial/security/index.md b/docs/uk/docs/tutorial/security/index.md
index f1fb25178db3503a25cfdc8ee84b8cbbf211efff..de09c728bcdd95b99ed377db18bfc36b13b59cbd 100644 (file)
--- a/docs/uk/docs/tutorial/security/index.md
+++ b/docs/uk/docs/tutorial/security/index.md
@@ -73,11 +73,11 @@ OpenAPI визначає такі схеми безпеки:
 * `apiKey`: специфічний для застосунку ключ, який може передаватися через:
     * Параметр запиту.
     * Заголовок.
-    * Cookie.
+    * Кукі.
 * `http`: стандартні системи HTTP-автентифікації, включаючи:
     * `bearer`: заголовок `Authorization` зі значенням `Bearer ` та токеном. Це успадковано з OAuth2.
-    * HTTP Basic автентифікацію.
-    * HTTP Digest тощо.
+    * базову автентифікацію HTTP.
+    * HTTP дайджест тощо.
 * `oauth2`: усі способи обробки безпеки за допомогою OAuth2 (так звані «потоки»).
     * Декілька з цих потоків підходять для створення провайдера автентифікації OAuth 2.0 (наприклад, Google, Facebook, X (Twitter), GitHub тощо):
         * `implicit`

diff --git a/docs/uk/docs/tutorial/static-files.md b/docs/uk/docs/tutorial/static-files.md
index 32ca1311d264eec880a3d7aa638dcf41abee177b..7f45973df39a99fb1523cabedb00b659e8e1e8a8 100644 (file)
--- a/docs/uk/docs/tutorial/static-files.md
+++ b/docs/uk/docs/tutorial/static-files.md
@@ -7,7 +7,7 @@
 * Імпортуйте `StaticFiles`.
 * «Під'єднати» екземпляр `StaticFiles()` з вказанням необхідного шляху.
 
-{* ../../docs_src/static_files/tutorial001_py39.py hl[2,6] *}
+{* ../../docs_src/static_files/tutorial001_py310.py hl[2,6] *}
 
 /// note | Технічні деталі
 

diff --git a/docs/uk/docs/tutorial/testing.md b/docs/uk/docs/tutorial/testing.md
index 462592829f24654e6bf74a2bdd08f468e6764637..ff32e9fb66411cdd728765ca6611b210fbdf8515 100644 (file)
--- a/docs/uk/docs/tutorial/testing.md
+++ b/docs/uk/docs/tutorial/testing.md
@@ -30,7 +30,7 @@ $ pip install httpx
 
 Записуйте прості `assert`-вирази зі стандартними виразами Python, які потрібно перевірити (це також стандарт для `pytest`).
 
-{* ../../docs_src/app_testing/tutorial001_py39.py hl[2,12,15:18] *}
+{* ../../docs_src/app_testing/tutorial001_py310.py hl[2,12,15:18] *}
 
 /// tip | Порада
 
@@ -76,7 +76,7 @@ $ pip install httpx
 У файлі `main.py` знаходиться ваш застосунок **FastAPI**:
 
 
-{* ../../docs_src/app_testing/app_a_py39/main.py *}
+{* ../../docs_src/app_testing/app_a_py310/main.py *}
 
 ### Файл тестування { #testing-file }
 
@@ -90,9 +90,9 @@ $ pip install httpx
 │   └── test_main.py
 ```
 
-Оскільки цей файл знаходиться в тому ж пакеті, ви можете використовувати відносний імпорт, щоб імпортувати об'єкт `app`  із модуля `main` (`main.py`):
+Оскільки цей файл знаходиться в тому ж пакеті, ви можете використовувати відносний імпорт, щоб імпортувати об'єкт `app` із модуля `main` (`main.py`):
 
-{* ../../docs_src/app_testing/app_a_py39/test_main.py hl[3] *}
+{* ../../docs_src/app_testing/app_a_py310/test_main.py hl[3] *}
 
 
 ...і написати код для тестів так само як і раніше.