]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Korean translation for `docs/ko/docs/advanced/advanced-dependencies.md` (#12675)
authorkim-sangah <kimsangah_@naver.com>
Thu, 7 Nov 2024 20:43:46 +0000 (05:43 +0900)
committerGitHub <noreply@github.com>
Thu, 7 Nov 2024 20:43:46 +0000 (20:43 +0000)
docs/ko/docs/advanced/advanced-dependencies.md [new file with mode: 0644]

diff --git a/docs/ko/docs/advanced/advanced-dependencies.md b/docs/ko/docs/advanced/advanced-dependencies.md
new file mode 100644 (file)
index 0000000..aa5a332
--- /dev/null
@@ -0,0 +1,179 @@
+# κ³ κΈ‰ μ˜μ‘΄μ„±
+
+## λ§€κ°œλ³€μˆ˜ν™”λœ μ˜μ‘΄μ„±
+
+μ§€κΈˆκΉŒμ§€ λ³Έ λͺ¨λ“  μ˜μ‘΄μ„±μ€ κ³ μ •λœ ν•¨μˆ˜ λ˜λŠ” ν΄λž˜μŠ€μž…λ‹ˆλ‹€.
+
+ν•˜μ§€λ§Œ μ—¬λŸ¬ κ°œμ˜ ν•¨μˆ˜λ‚˜ ν΄λž˜μŠ€λ₯Ό μ„ μ–Έν•˜μ§€ μ•Šκ³ λ„ μ˜μ‘΄μ„±μ— λ§€κ°œλ³€μˆ˜λ₯Ό μ„€μ •ν•΄μ•Ό ν•˜λŠ” κ²½μš°κ°€ μžˆμ„ μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+예λ₯Ό λ“€μ–΄, `q` μΏΌλ¦¬ λ§€κ°œλ³€μˆ˜κ°€ νŠΉμ • κ³ μ •λœ λ‚΄μš©μ„ ν¬ν•¨ν•˜κ³  μžˆλŠ”μ§€ ν™•μΈν•˜λŠ” μ˜μ‘΄μ„±μ„ μ›ν•œλ‹€κ³  κ°€μ •ν•΄ λ΄…μ‹œλ‹€.
+
+μ΄λ•Œ ν•΄λ‹Ή κ³ μ •λœ λ‚΄μš©μ„ λ§€κ°œλ³€μˆ˜ν™”ν•  μˆ˜ μžˆκΈΈ λ°”λžλ‹ˆλ‹€.
+
+## "호좜 κ°€λŠ₯ν•œ" μΈμŠ€ν„΄μŠ€
+
+Pythonμ—λŠ” ν΄λž˜μŠ€μ˜ μΈμŠ€ν„΄μŠ€λ₯Ό "호좜 κ°€λŠ₯"ν•˜κ²Œ λ§Œλ“œλŠ” λ°©λ²•이 μžˆμŠ΅λ‹ˆλ‹€.
+
+클래슀 μžμ²΄(이미 ν˜ΈμΆœ κ°€λŠ₯함)κ°€ μ•„λ‹ˆλΌ ν•΄λ‹Ή ν΄λž˜μŠ€μ˜ μΈμŠ€ν„΄μŠ€μ— λŒ€ν•΄ ν˜ΈμΆœ κ°€λŠ₯ν•˜κ²Œ ν•˜λŠ” κ²ƒμž…λ‹ˆλ‹€.
+
+이λ₯Ό μœ„ν•΄ `__call__` λ©”μ„œλ“œλ₯Ό μ„ μ–Έν•©λ‹ˆλ‹€:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="12"
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | μ°Έκ³ 
+
+κ°€λŠ₯ν•˜λ‹€λ©΄ `Annotated` λ²„전을 μ‚¬μš©ν•˜λŠ” κ²ƒμ΄ μ’‹μŠ΅λ‹ˆλ‹€.
+
+///
+
+```Python hl_lines="10"
+{!> ../../docs_src/dependencies/tutorial011.py!}
+```
+
+////
+
+이 κ²½μš°, **FastAPI**λŠ” μΆ”κ°€ λ§€κ°œλ³€μˆ˜μ™€ ν•˜μœ„ μ˜μ‘΄μ„±μ„ ν™•μΈν•˜κΈ° μœ„ν•΄ `__call__`을 μ‚¬μš©ν•˜κ²Œ λ˜λ©°,
+λ‚˜μ€‘μ— *경둜 μ—°μ‚° ν•¨μˆ˜*μ—μ„œ λ§€κ°œλ³€μˆ˜μ— κ°’을 μ „달할 λ•Œ μ΄λ₯Ό ν˜ΈμΆœν•˜κ²Œ λ©λ‹ˆλ‹€.
+
+## μΈμŠ€ν„΄μŠ€ λ§€κ°œλ³€μˆ˜ν™”ν•˜κΈ°
+
+이제 `__init__`을 μ‚¬μš©ν•˜μ—¬ μ˜μ‘΄μ„±μ„ "λ§€κ°œλ³€μˆ˜ν™”"ν•  μˆ˜ μžˆλŠ” μΈμŠ€ν„΄μŠ€μ˜ λ§€κ°œλ³€μˆ˜λ₯Ό μ„ μ–Έν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9"
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="8"
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | μ°Έκ³ 
+
+κ°€λŠ₯ν•˜λ‹€λ©΄ `Annotated` λ²„전을 μ‚¬μš©ν•˜λŠ” κ²ƒμ΄ μ’‹μŠ΅λ‹ˆλ‹€.
+
+///
+
+```Python hl_lines="7"
+{!> ../../docs_src/dependencies/tutorial011.py!}
+```
+
+////
+
+이 κ²½μš°, **FastAPI**λŠ” `__init__`에 μ „ν˜€ κ΄€μ—¬ν•˜μ§€ μ•ŠμœΌλ©°, μš°λ¦¬λŠ” μ΄ λ©”μ„œλ“œλ₯Ό μ½”λ“œμ—μ„œ μ§μ ‘ μ‚¬μš©ν•˜κ²Œ λ©λ‹ˆλ‹€.
+
+## μΈμŠ€ν„΄μŠ€ μƒμ„±ν•˜κΈ°
+
+λ‹€μŒκ³Ό κ°™μ΄ μ΄ ν΄λž˜μŠ€μ˜ μΈμŠ€ν„΄μŠ€λ₯Ό μƒμ„±ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="18"
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="17"
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | μ°Έκ³ 
+
+κ°€λŠ₯ν•˜λ‹€λ©΄ `Annotated` λ²„전을 μ‚¬μš©ν•˜λŠ” κ²ƒμ΄ μ’‹μŠ΅λ‹ˆλ‹€.
+
+///
+
+```Python hl_lines="16"
+{!> ../../docs_src/dependencies/tutorial011.py!}
+```
+
+////
+
+μ΄λ ‡κ²Œ ν•˜λ©΄ `checker.fixed_content` μ†μ„±μ— `"bar"`λΌλŠ” κ°’을 λ‹΄μ•„ μ˜μ‘΄μ„±μ„ "λ§€κ°œλ³€μˆ˜ν™”"ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+## μΈμŠ€ν„΄μŠ€λ₯Ό μ˜μ‘΄μ„±μœΌλ‘œ μ‚¬μš©ν•˜κΈ°
+
+그런 λ‹€μŒ, `Depends(FixedContentQueryChecker)` λŒ€μ‹  `Depends(checker)`μ—μ„œ μ΄ `checker` μΈμŠ€ν„΄μŠ€λ₯Ό μ‚¬μš©ν•  μˆ˜ μžˆμœΌλ©°,
+클래슀 μžμ²΄κ°€ μ•„λ‹Œ μΈμŠ€ν„΄μŠ€ `checker`κ°€ μ˜μ‘΄μ„±μ΄ λ©λ‹ˆλ‹€.
+
+μ˜μ‘΄μ„±μ„ ν•΄κ²°ν•  λ•Œ **FastAPI**λŠ” μ΄ `checker`λ₯Ό λ‹€μŒκ³Ό κ°™μ΄ ν˜ΈμΆœν•©λ‹ˆλ‹€:
+
+```Python
+checker(q="somequery")
+```
+
+...그리고 μ΄λ•Œ λ°˜ν™˜λ˜λŠ” κ°’을 *경둜 μ—°μ‚° ν•¨μˆ˜*의 `fixed_content_included` λ§€κ°œλ³€μˆ˜λ‘œ μ „λ‹¬ν•©λ‹ˆλ‹€:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="22"
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="21"
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | μ°Έκ³ 
+
+κ°€λŠ₯ν•˜λ‹€λ©΄ `Annotated` λ²„전을 μ‚¬μš©ν•˜λŠ” κ²ƒμ΄ μ’‹μŠ΅λ‹ˆλ‹€.
+
+///
+
+```Python hl_lines="20"
+{!> ../../docs_src/dependencies/tutorial011.py!}
+```
+
+////
+
+/// tip | μ°Έκ³ 
+
+이 λͺ¨λ“  κ³Όμ •이 λ³΅μž‘ν•˜κ²Œ λŠκ»΄μ§ˆ μˆ˜ μžˆμŠ΅λ‹ˆλ‹€. κ·Έλ¦¬κ³  μ§€κΈˆμ€ μ΄ λ°©λ²•이 μ–Όλ§ˆλ‚˜ μœ μš©ν•œμ§€ λͺ…ν™•ν•˜μ§€ μ•Šμ„ μˆ˜λ„ μžˆμŠ΅λ‹ˆλ‹€.
+
+이 μ˜ˆμ‹œλŠ” μ˜λ„μ μœΌλ‘œ κ°„λ‹¨ν•˜κ²Œ λ§Œλ“€μ—ˆμ§€λ§Œ, μ „체 κ΅¬μ‘°κ°€ μ–΄λ–»κ²Œ μž‘λ™ν•˜λŠ”μ§€ λ³΄μ—¬μ€λ‹ˆλ‹€.
+
+λ³΄μ•ˆ κ΄€λ ¨ μž₯μ—μ„œλŠ” μ΄μ™€ κ°™μ€ λ°©μ‹μœΌλ‘œ κ΅¬ν˜„λœ νŽΈμ˜ ν•¨μˆ˜λ“€μ΄ μžˆμŠ΅λ‹ˆλ‹€.
+
+이 λͺ¨λ“  κ³Όμ •을 μ΄ν•΄ν–ˆλ‹€λ©΄, μ΄λŸ¬ν•œ λ³΄μ•ˆ λ„ꡬ듀이 λ‚΄λΆ€μ μœΌλ‘œ μ–΄λ–»κ²Œ μž‘λ™ν•˜λŠ”μ§€ μ΄λ―Έ νŒŒμ•…ν•œ κ²ƒμž…λ‹ˆλ‹€.
+
+///