FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

🌐 Update translations for uk (update-outdated) (#14587) · fastapi/fastapi@6f97736 · GitHub

Repository navigation

Commit 6f97736

Browse files
authored
🌐 Update translations for uk (update-outdated) (#14587)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Yurii Motov <yurii.motov.monte@gmail.com>
1 parent 154ce03 commit 6f97736

39 files changed

Lines changed: 1799 additions & 1756 deletions

‎docs/en/mkdocs.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -321,6 +321,8 @@ extra:
321321
name: pt - português
322322
- link: /ru/
323323
name: ru - русский язык
324+
- link: /uk/
325+
name: uk - українська мова
324326
extra_css:
325327
- css/termynal.css
326328
- css/custom.css

‎docs/uk/docs/index.md‎

Lines changed: 237 additions & 135 deletions
Large diffs are not rendered by default.

‎docs/uk/docs/learn/index.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
# Навчання
1+
# Навчання { #learn }
22

3-
У цьому розділі надані вступні та навчальні матеріали для вивчення FastAPI.
3+
У цьому розділі надані вступні розділи та навчальні матеріали для вивчення **FastAPI**.
44

55
Це можна розглядати як **книгу**, **курс**, або **офіційний** та рекомендований спосіб освоїти FastAPI. 😎

‎docs/uk/docs/python-types.md‎

Lines changed: 171 additions & 196 deletions
Large diffs are not rendered by default.
Lines changed: 32 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,27 @@
1-
# Фонові задачі
1+
# Фонові задачі { #background-tasks }
22

33
Ви можете створювати фонові задачі, які будуть виконуватися *після* повернення відповіді.
44

55
Це корисно для операцій, які потрібно виконати після обробки запиту, але клієнту не обов’язково чекати завершення цієї операції перед отриманням відповіді.
66

7-
Приклади використання:
7+
Це включає, наприклад:
88

99
* Надсилання email-сповіщень після виконання певної дії:
10-
* Підключення до поштового сервера та надсилання листа може займати кілька секунд. Ви можете відразу повернути відповідь, а email відправити у фоні.
10+
* Підключення до поштового сервера та надсилання листа може займати кілька секунд. Ви можете відразу повернути відповідь, а email-сповіщення надіслати у фоні.
1111
* Обробка даних:
12-
* Наприклад, якщо отримано файл, який потрібно обробити довготривалим процесом, можна повернути відповідь "Accepted" ("Прийнято", HTTP 202) і виконати обробку файлу у фоні.
12+
* Наприклад, якщо ви отримали файл, який потрібно обробити довготривалим процесом, можна повернути відповідь «Accepted» (HTTP 202) і виконати обробку файлу у фоні.
1313

14-
## Використання `BackgroundTasks`
14+
## Використання `BackgroundTasks` { #using-backgroundtasks }
1515

16-
Спочатку імпортуйте `BackgroundTasks` і додайте його як параметр у Вашу *функцію операції шляху* (path operation function) до `BackgroundTasks`:
16+
Спочатку імпортуйте `BackgroundTasks` і оголосіть параметр у вашій *функції операції шляху* з анотацією типу `BackgroundTasks`:
1717

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

20-
**FastAPI** автоматично створить об'єкт `BackgroundTasks` і передасть його у цей параметр.
20+
**FastAPI** створить для вас об’єкт типу `BackgroundTasks` і передасть його як цей параметр.
2121

22+
## Створення функції задачі { #create-a-task-function }
2223

23-
## Створення функції задачі
24-
25-
Створіть функцію, яка буде виконувати фонову задачу.
24+
Створіть функцію, яка буде виконуватися як фонова задача.
2625

2726
Це звичайна функція, яка може отримувати параметри.
2827

@@ -32,54 +31,54 @@
3231

3332
І оскільки операція запису не використовує `async` та `await`, ми визначаємо функцію як звичайну `def`:
3433

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

37-
## Додавання фонової задачі
36+
## Додавання фонової задачі { #add-the-background-task }
3837

39-
Усередині Вашої *функції обробки шляху*, передайте функцію задачі в об'єкт *background tasks*, використовуючи метод `.add_task()`:
38+
Усередині вашої *функції операції шляху*, передайте функцію задачі в об'єкт *background tasks*, використовуючи метод `.add_task()`:
4039

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

4342
`.add_task()` приймає аргументи:
4443

45-
* Функція задача, яка буде виконуватися у фоновому режимі (`write_notification`). Зверніть увагу, що передається обʼєкт без дужок.
46-
* Будь-яка послідовність аргументів, які потрібно передати у функцію завдання у відповідному порядку (`email`).
47-
* Будь-які іменовані аргументи, які потрібно передати у функцію задачу (`message="some notification"`).
44+
* Функцію задачі, яка буде виконуватися у фоновому режимі (`write_notification`).
45+
* Будь-яку послідовність аргументів, які потрібно передати у функцію задачі у відповідному порядку (`email`).
46+
* Будь-які іменовані аргументи, які потрібно передати у функцію задачі (`message="some notification"`).
4847

49-
## Впровадження залежностей
48+
## Впровадження залежностей { #dependency-injection }
5049

51-
Використання `BackgroundTasks` також працює з системою впровадження залежностей. Ви можете оголосити параметр типу `BackgroundTasks` на різних рівнях: у *функції операції шляху*, у залежності (dependable), у під залежності тощо.
50+
Використання `BackgroundTasks` також працює з системою впровадження залежностей. Ви можете оголосити параметр типу `BackgroundTasks` на різних рівнях: у *функції операції шляху*, у залежності (dependable), у підзалежності тощо.
5251

53-
**FastAPI** знає, як діяти в кожному випадку і як повторно використовувати один і той самий об'єкт, щоб усі фонові задачі були об’єднані та виконувалися у фоновому режимі після завершення основного запиту.
52+
**FastAPI** знає, як діяти в кожному випадку і як повторно використовувати один і той самий об'єкт, щоб усі фонові задачі були об’єднані та виконувалися у фоновому режимі після завершення основного запиту:
5453

5554
{* ../../docs_src/background_tasks/tutorial002_an_py310.py hl[13,15,22,25] *}
5655

5756
У цьому прикладі повідомлення будуть записані у файл `log.txt` *після* того, як відповідь буде надіслана.
5857

59-
Якщо у запиті був переданий query-параметр, він буде записаний у лог у фоновій задачі.
58+
Якщо у запиті був переданий query, він буде записаний у лог у фоновій задачі.
6059

61-
А потім інша фонова задача, яка створюється у *функції операції шляху*, запише повідомлення з використанням path параметра `email`.
60+
А потім інша фонова задача, згенерована у *функції операції шляху*, запише повідомлення з використанням path параметра `email`.
6261

63-
## Технічні деталі
62+
## Технічні деталі { #technical-details }
6463

6564
Клас `BackgroundTasks` походить безпосередньо з <a href="https://www.starlette.dev/background/" class="external-link" target="_blank">`starlette.background`</a>.
6665

67-
Він імпортується безпосередньо у FastAPI, щоб Ви могли використовувати його з `fastapi` і випадково не імпортували `BackgroundTask` (без s в кінці) з `starlette.background`.
66+
Він імпортується/включається безпосередньо у FastAPI, щоб ви могли імпортувати його з `fastapi` і випадково не імпортували альтернативний `BackgroundTask` (без `s` в кінці) з `starlette.background`.
6867

6968
Якщо використовувати лише `BackgroundTasks` (а не `BackgroundTask`), то його можна передавати як параметр у *функції операції шляху*, і **FastAPI** подбає про все інше, так само як і про використання об'єкта `Request`.
7069

71-
Також можна використовувати `BackgroundTask` окремо в FastAPI, але для цього Вам доведеться створити об'єкт у коді та повернути Starlette `Response`, включаючи його.
70+
Також можна використовувати `BackgroundTask` окремо в FastAPI, але для цього вам доведеться створити об'єкт у коді та повернути Starlette `Response`, включаючи його.
7271

73-
Детальніше можна почитати в <a href="https://www.starlette.dev/background/" class="external-link" target="_blank">офіційній документації Starlette про фонові задачі </a>.
72+
Детальніше можна почитати в <a href="https://www.starlette.dev/background/" class="external-link" target="_blank">офіційній документації Starlette про Background Tasks</a>.
7473

75-
## Застереження
74+
## Застереження { #caveat }
7675

77-
Якщо Вам потрібно виконувати складні фонові обчислення, і при цьому нема потреби запускати їх у тому ж процесі (наприклад, не потрібно спільного доступу до пам’яті чи змінних), можливо, варто скористатися більш потужними інструментами, такими як <a href="https://docs.celeryq.dev" class="external-link" target="_blank">Celery</a>.
76+
Якщо вам потрібно виконувати складні фонові обчислення, і при цьому нема потреби запускати їх у тому ж процесі (наприклад, не потрібно спільного доступу до пам’яті чи змінних), можливо, варто скористатися більш потужними інструментами, такими як <a href="https://docs.celeryq.dev" class="external-link" target="_blank">Celery</a>.
7877

79-
Такі інструменти зазвичай потребують складнішої конфігурації та менеджера черги повідомлень/завдань, наприклад, RabbitMQ або Redis. Однак вони дозволяють виконувати фонові задачі в кількох процесах і навіть на кількох серверах.
78+
Такі інструменти зазвичай потребують складнішої конфігурації та менеджера черги повідомлень/завдань, наприклад, RabbitMQ або Redis. Однак вони дозволяють виконувати фонові задачі в кількох процесах і особливо — на кількох серверах.
8079

81-
Якщо ж Вам потрібно отримати доступ до змінних і об’єктів із тієї ж **FastAPI** - програми або виконувати невеликі фонові завдання (наприклад, надсилати сповіщення електронною поштою), достатньо просто використовувати `BackgroundTasks`.
80+
Якщо ж вам потрібно отримати доступ до змінних і об’єктів із тієї ж **FastAPI**-програми або виконувати невеликі фонові завдання (наприклад, надсилати email-сповіщення), достатньо просто використовувати `BackgroundTasks`.
8281

83-
## Підсумок
82+
## Підсумок { #recap }
8483

85-
Імпортуйте та використовуйте `BackgroundTasks` як параметр у *функціях операції шляху* та залежностях, щоб додавати фонові задачі.
84+
Імпортуйте та використовуйте `BackgroundTasks` як параметри у *функціях операції шляху* та залежностях, щоб додавати фонові задачі.

0 commit comments

Comments
 (0)

Back | FazBrowse Home | New Git URL