From 7c4d1fe13d37059f05796556c6d0a0c80ddbeee3 Mon Sep 17 00:00:00 2001
From: Valentyn <valentin.druzhinin@gmail.com>
Date: Fri, 28 Feb 2025 09:24:45 -0500
Subject: [PATCH] =?UTF-8?q?=F0=9F=8C=90=20Add=20Ukrainian=20translation=20?=
 =?UTF-8?q?for=20`docs/uk/docs/tutorial/debugging.md`=20(#13370)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Valentyn Druzhynin <v.druzhynin@zakaz.global>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Rostyslav <rostik1410@users.noreply.github.com>
---
 docs/uk/docs/tutorial/debugging.md | 112 +++++++++++++++++++++++++++++
 1 file changed, 112 insertions(+)
 create mode 100644 docs/uk/docs/tutorial/debugging.md

diff --git a/docs/uk/docs/tutorial/debugging.md b/docs/uk/docs/tutorial/debugging.md
new file mode 100644
index 000000000..b0e5344f8
--- /dev/null
+++ b/docs/uk/docs/tutorial/debugging.md
@@ -0,0 +1,112 @@
+# Налагодження (Debugging)
+
+Ви можете під'єднати дебагер у Вашому редакторі коду, наприклад, у Visual Studio Code або PyCharm.
+
+## Виклик `uvicorn`
+
+У Вашому FastAPI-додатку імпортуйте та запустіть `uvicorn` безпосередньо:
+
+{* ../../docs_src/debugging/tutorial001.py hl[1,15] *}
+
+### Про `__name__ == "__main__"`
+
+Головна мета використання `__name__ == "__main__"` — це забезпечення виконання певного коду тільки тоді, коли файл запускається безпосередньо:
+
+<div class="termy">
+
+```console
+$ python myapp.py
+```
+
+</div>
+
+але не виконується при його імпорті в інший файл, наприклад:
+
+```Python
+from myapp import app
+```
+
+#### Детальніше
+
+Припустимо, Ваш файл називається `myapp.py`.
+
+Якщо Ви запустите його так:
+
+<div class="termy">
+
+```console
+$ python myapp.py
+```
+
+</div>
+
+тоді внутрішня змінна `__name__`, яка створюється автоматично Python, матиме значення `"__main__"`.
+
+Отже, цей блок коду:
+
+```Python
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+буде виконаний.
+
+---
+
+Це не станеться, якщо Ви імпортуєте цей модуль (файл).
+
+Якщо у Вас є інший файл, наприклад `importer.py`, з наступним кодом:
+
+```Python
+from myapp import app
+
+# Додатковий код
+```
+
+У цьому випадку автоматично створена змінна у файлі `myapp.py` не матиме значення змінної `__name__` як `"__main__"`.
+
+Отже, рядок:
+
+```Python
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+не буде виконано.
+
+/// info | Інформація
+
+Більш детальну інформацію можна знайти в <a href="https://docs.python.org/3/library/__main__.html" class="external-link" target="_blank">офіційній документації Python</a>.
+
+///
+
+## Запуск коду з вашим дебагером
+
+Оскільки Ви запускаєте сервер Uvicorn безпосередньо з Вашого коду, Ви можете запустити вашу Python програму (ваш FastAPI додаток) безпосередньо з дебагера.
+
+---
+
+Наприклад, у Visual Studio Code Ви можете:
+
+* Перейдіть на вкладку "Debug".
+* Натисніть "Add configuration...".
+* Виберіть "Python"
+* Запустіть дебагер з опцією "`Python: Current File (Integrated Terminal)`".
+
+Це запустить сервер з Вашим **FastAPI** кодом, зупиниться на точках зупину тощо.
+
+Ось як це може виглядати:
+
+<img src="/img/tutorial/debugging/image01.png">
+
+---
+Якщо Ви використовуєте PyCharm, ви можете:
+
+* Відкрити меню "Run".
+* Вибрати опцію "Debug...".
+* Потім з'явиться контекстне меню.
+* Вибрати файл для налагодження (у цьому випадку, `main.py`).
+
+Це запустить сервер з Вашим **FastAPI** кодом, зупиниться на точках зупину тощо.
+
+Ось як це може виглядати:
+
+<img src="/img/tutorial/debugging/image02.png">