]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Korean translation for `docs/ko/docs/tutorial/debugging.md` (#5695)
authorJungWooGeon <jwk1734@naver.com>
Tue, 2 Apr 2024 04:18:08 +0000 (13:18 +0900)
committerGitHub <noreply@github.com>
Tue, 2 Apr 2024 04:18:08 +0000 (23:18 -0500)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: SebastiΓ‘n RamΓ­rez <tiangolo@gmail.com>
docs/ko/docs/tutorial/debugging.md [new file with mode: 0644]

diff --git a/docs/ko/docs/tutorial/debugging.md b/docs/ko/docs/tutorial/debugging.md
new file mode 100644 (file)
index 0000000..c3e5885
--- /dev/null
@@ -0,0 +1,112 @@
+# λ””버깅
+
+예λ₯Ό λ“€λ©΄ Visual Studio Code λ˜λŠ” PyCharm을 μ‚¬μš©ν•˜μ—¬ νŽΈμ§‘κΈ°μ—μ„œ λ””버거λ₯Ό μ—°κ²°ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+## `uvicorn` ν˜ΈμΆœ
+
+FastAPI μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ—μ„œ `uvicorn`을 μ§μ ‘ μž„ν¬νŠΈν•˜μ—¬ μ‹€ν–‰ν•©λ‹ˆλ‹€
+
+```Python hl_lines="1  15"
+{!../../../docs_src/debugging/tutorial001.py!}
+```
+
+### `__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>
+
+Python에 μ˜ν•΄ μžλ™μœΌλ‘œ μƒμ„±λœ νŒŒμΌμ˜ λ‚΄λΆ€ λ³€μˆ˜ `__name__`은 λ¬Έμžμ—΄ `"__main__"`을 κ°’μœΌλ‘œ κ°–κ²Œ λ©λ‹ˆλ‹€.
+
+λ”°λΌμ„œ μ„Ήμ…˜
+
+```Python
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+이 μ‹€ν–‰λ©λ‹ˆλ‹€.
+
+---
+
+ν•΄λ‹Ή λͺ¨λ“ˆ(파일)을 κ°€μ Έμ˜€λ©΄ μ΄λŸ° μΌμ΄ λ°œμƒν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€
+
+κ·Έλž˜μ„œ λ‹€μŒκ³Ό κ°™μ€ λ‹€λ₯Έ νŒŒμΌ `importer.py`κ°€ μžˆλŠ” κ²½μš°:
+
+```Python
+from myapp import app
+
+# Some more code
+```
+
+이 κ²½μš° `myapp.py` λ‚΄λΆ€μ˜ μžλ™ λ³€μˆ˜μ—λŠ” κ°’이 `"__main__"`인 λ³€μˆ˜ `__name__`이 μ—†μŠ΅λ‹ˆλ‹€.
+
+λ”°λΌμ„œ λ‹€μŒ ν–‰
+
+```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">