]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Korean translation for `docs/ko/docs/history-design-future.md` (#12646)
authorSaeye Lee <62229734+saeye@users.noreply.github.com>
Thu, 7 Nov 2024 20:46:14 +0000 (05:46 +0900)
committerGitHub <noreply@github.com>
Thu, 7 Nov 2024 20:46:14 +0000 (20:46 +0000)
docs/ko/docs/history-design-future.md [new file with mode: 0644]

diff --git a/docs/ko/docs/history-design-future.md b/docs/ko/docs/history-design-future.md
new file mode 100644 (file)
index 0000000..6680a46
--- /dev/null
@@ -0,0 +1,81 @@
+# μ—­μ‚¬, λ””μžμΈ κ·Έλ¦¬κ³  λ―Έλž˜
+
+μ–΄λŠ λ‚ , [ν•œ FastAPI μ‚¬μš©μž](https://github.com/fastapi/fastapi/issues/3#issuecomment-454956920)κ°€ μ΄λ ‡κ²Œ λ¬Όμ—ˆμŠ΅λ‹ˆλ‹€:
+
+> μ΄ ν”„λ‘œμ νŠΈμ˜ μ—­μ‚¬λ₯Ό μ•Œλ € μ£Όμ‹€ μˆ˜ μžˆλ‚˜μš”? λͺ‡ μ£Ό λ§Œμ— λ©‹μ§„ κ²°κ³Όλ₯Ό λ‚Έ κ²ƒ κ°™μ•„μš”. [...]
+
+μ—¬κΈ°μ„œ κ·Έ μ—­μ‚¬μ— λŒ€ν•΄ κ°„λ‹¨νžˆ μ„€λͺ…ν•˜κ² μŠ΅λ‹ˆλ‹€.
+
+---
+
+## λŒ€μ•ˆ
+
+μ €λŠ” μ—¬λŸ¬ ν•΄ λ™μ•ˆ λ¨Έμ‹ λŸ¬λ‹, λΆ„μ‚° μ‹œμŠ€ν…œ, λΉ„동기 μž‘μ—…, NoSQL λ°μ΄ν„°λ² μ΄μŠ€ κ°™μ€ λ³΅μž‘ν•œ μš”ꡬ사항을 κ°€μ§„ APIλ₯Ό κ°œλ°œν•˜λ©° μ—¬λŸ¬ νŒ€μ„ μ΄λŒμ–΄ μ™”μŠ΅λ‹ˆλ‹€.
+
+이 κ³Όμ •μ—μ„œ λ§Žμ€ λŒ€μ•ˆμ„ μ‘°μ‚¬ν•˜κ³ , ν…ŒμŠ€νŠΈν•˜λ©°, μ‚¬μš©ν•΄μ•Ό ν–ˆμŠ΅λ‹ˆλ‹€. **FastAPI**의 μ—­μ‚¬λŠ” κ·Έ μ΄μ „에 λ‚˜μ™”λ˜ μ—¬λŸ¬ λ„κ΅¬μ˜ μ—­μ‚¬μ™€ λ°€μ ‘ν•˜κ²Œ μ—°κ΄€λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€.
+
+[λŒ€μ•ˆ](alternatives.md){.internal-link target=_blank} μ„Ήμ…˜μ—μ„œ μ–ΈκΈ‰λœ κ²ƒμ²˜λŸΌ:
+
+> **FastAPI**λŠ” μ΄μ „에 λ‚˜μ™”λ˜ λ§Žμ€ λ„κ΅¬λ“€μ˜ λ…Έλ ₯ μ—†μ΄λŠ” μ‘΄μž¬ν•˜μ§€ μ•Šμ•˜μ„ κ²ƒμž…λ‹ˆλ‹€.
+>
+> μ΄μ „에 κ°œλ°œλœ μ—¬λŸ¬ λ„ꡬ듀이 μ΄ ν”„λ‘œμ νŠΈμ— μ˜κ°μ„ μ£Όμ—ˆμŠ΅λ‹ˆλ‹€.
+>
+> μ €λŠ” μ˜€λž«λ™μ•ˆ μƒˆλ‘œμš΄ ν”„λ ˆμž„μ›Œν¬λ₯Ό λ§Œλ“œλŠ” κ²ƒμ„ ν”Όν•˜κ³ μž ν–ˆμŠ΅λ‹ˆλ‹€. μ²˜μŒμ—λŠ” **FastAPI**κ°€ μ œκ³΅ν•˜λŠ” κΈ°λŠ₯듀을 λ‹€μ–‘ν•œ ν”„λ ˆμž„μ›Œν¬μ™€ ν”ŒλŸ¬κ·ΈμΈ, λ„ꡬ듀을 μ‘°ν•©ν•΄ ν•΄κ²°ν•˜λ € ν–ˆμŠ΅λ‹ˆλ‹€.
+>
+> ν•˜μ§€λ§Œ κ²°κ΅­μ—λŠ” μ΄ λͺ¨λ“  κΈ°λŠ₯을 ν†΅ν•©ν•˜λŠ” λ„ꡬ가 ν•„μš”ν•΄μ‘ŒμŠ΅λ‹ˆλ‹€. μ΄μ „ λ„κ΅¬λ“€λ‘œλΆ€ν„° μ΅œκ³ μ˜ μ•„이디어듀을 λͺ¨μœΌκ³ , μ΄λ₯Ό μ΅œμ μ˜ λ°©μ‹μœΌλ‘œ μ‘°ν•©ν•΄μ•Όλ§Œ ν–ˆμŠ΅λ‹ˆλ‹€. μ΄λŠ” :term:Python 3.6+ νƒ€μž… νžŒνŠΈ <type hints>와 κ°™μ€, μ΄μ „μ—λŠ” μ‚¬μš©ν•  μˆ˜ μ—†μ—ˆλ˜ μ–Έμ–΄ κΈ°λŠ₯이 κ°€λŠ₯ν–ˆκΈ° λ•Œλ¬Έμž…λ‹ˆλ‹€.
+
+---
+
+## μ‘°μ‚¬
+
+μ—¬λŸ¬ λŒ€μ•ˆμ„ μ‚¬μš©ν•΄ λ³΄λ©° λ‹€μ–‘ν•œ λ„κ΅¬μ—μ„œ λ°°μš΄ μ λ“€μ„ λͺ¨μ•„ μ €μ™€ κ°œλ°œνŒ€μ—κ²Œ κ°€μž₯ μ ν•©ν•œ λ°©μ‹μ„ μ°Ύμ•˜μŠ΅λ‹ˆλ‹€.
+
+예λ₯Ό λ“€μ–΄, ν‘œμ€€ :term:Python νƒ€μž… νžŒνŠΈ <type hints>에 κΈ°λ°˜ν•˜λŠ” κ²ƒμ΄ μ΄μƒμ μ΄λΌλŠ” μ μ΄ λͺ…ν™•ν–ˆμŠ΅λ‹ˆλ‹€.
+
+λ˜ν•œ, μ΄λ―Έ μ‘΄μž¬ν•˜λŠ” ν‘œμ€€μ„ ν™œμš©ν•˜λŠ” κ²ƒμ΄ κ°€μž₯ μ’‹μ€ μ ‘근법이라 νŒλ‹¨ν–ˆμŠ΅λ‹ˆλ‹€.
+
+κ·Έλž˜μ„œ **FastAPI**의 μ½”λ“œλ₯Ό μž‘μ„±ν•˜κΈ° μ „에 λͺ‡ λ‹¬ λ™μ•ˆ OpenAPI, JSON Schema, OAuth2 λͺ…μ„Έλ₯Ό μ—°κ΅¬ν•˜λ©° μ΄λ“€μ˜ κ΄€κ³„와 κ²ΉμΉ˜λŠ” λΆ€λΆ„, μ°¨μ΄μ μ„ μ΄ν•΄ν–ˆμŠ΅λ‹ˆλ‹€.
+
+---
+
+## λ””μžμΈ
+
+κ·Έ ν›„, **FastAPI** μ‚¬μš©μžκ°€ λ  κ°œλ°œμžλ‘œμ„œ μ‚¬μš©ν•˜κ³  μ‹Άμ€ κ°œλ°œμž "API"λ₯Ό λ””μžμΈν–ˆμŠ΅λ‹ˆλ‹€.
+
+[Python Developer Survey](https://www.jetbrains.com/research/python-developers-survey-2018/#development-tools)에 λ”°λ₯΄λ©΄ μ•½ 80%의 Python κ°œλ°œμžκ°€ PyCharm, VS Code, Jedi κΈ°λ°˜ νŽΈμ§‘κΈ° λ“±μ—μ„œ κ°œλ°œν•©λ‹ˆλ‹€. μ΄ κ³Όμ •μ—μ„œ μ—¬λŸ¬ μ•„이디어λ₯Ό ν…ŒμŠ€νŠΈν–ˆμŠ΅λ‹ˆλ‹€.
+
+λŒ€λΆ€λΆ„μ˜ λ‹€λ₯Έ νŽΈμ§‘κΈ°λ„ μœ μ‚¬ν•˜κ²Œ λ™μž‘ν•˜κΈ° λ•Œλ¬Έμ—, **FastAPI**의 μ΄μ μ€ κ±°μ˜ λͺ¨λ“  νŽΈμ§‘κΈ°μ—μ„œ λˆ„릴 μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+이 κ³Όμ •을 ν†΅ν•΄ μ½”λ“œ μ€‘볡을 μ΅œμ†Œν™”ν•˜κ³ , λͺ¨λ“  κ³³μ—μ„œ μžλ™ μ™„μ„±, νƒ€μž… κ²€μ‚¬, μ—λŸ¬ ν™•인 κΈ°λŠ₯이 μ œκ³΅λ˜λŠ” μ΅œμ μ˜ λ°©μ‹μ„ μ°Ύμ•„λƒˆμŠ΅λ‹ˆλ‹€.
+
+이 λͺ¨λ“  κ²ƒμ€ κ°œλ°œμžλ“€μ—κ²Œ μ΅œκ³ μ˜ κ°œλ°œ κ²½ν—˜μ„ μ œκ³΅ν•˜κΈ° μœ„ν•΄ μ„€κ³„λ˜μ—ˆμŠ΅λ‹ˆλ‹€.
+
+---
+
+## ν•„μš”μ‘°κ±΄
+
+μ—¬λŸ¬ λŒ€μ•ˆμ„ ν…ŒμŠ€νŠΈν•œ ν›„, [Pydantic](https://docs.pydantic.dev/)을 μ‚¬μš©ν•˜κΈ°λ‘œ κ²°μ •ν–ˆμŠ΅λ‹ˆλ‹€.
+
+이후 μ €λŠ” **Pydantic**이 JSON Schema와 μ™„λ²½νžˆ ν˜Έν™˜λ˜λ„둝 κ°œμ„ ν•˜κ³ , λ‹€μ–‘ν•œ μ œμ•½ μ‘°κ±΄ μ„ μ–Έμ„ μ§€μ›ν•˜λ©°, μ—¬λŸ¬ νŽΈμ§‘κΈ°μ—μ„œμ˜ μžλ™ μ™„μ„±κ³Ό νƒ€μž… κ²€μ‚¬ κΈ°λŠ₯을 ν–₯μƒν•˜κΈ° μœ„ν•΄ κΈ°μ—¬ν–ˆμŠ΅λ‹ˆλ‹€.
+
+λ˜ν•œ, λ˜ λ‹€λ₯Έ μ£Όμš” ν•„μš”μ‘°κ±΄μ΄μ—ˆλ˜ [Starlette](https://www.starlette.io/)에도 κΈ°μ—¬ν–ˆμŠ΅λ‹ˆλ‹€.
+
+---
+
+## κ°œλ°œ
+
+**FastAPI**λ₯Ό κ°œλ°œν•˜κΈ° μ‹œμž‘ν•  μ¦ˆμŒμ—λŠ” λŒ€λΆ€λΆ„μ˜ μ€€λΉ„κ°€ μ΄λ―Έ μ™„λ£Œλœ μƒνƒœμ˜€μŠ΅λ‹ˆλ‹€. μ„€κ³„κ°€ μ •μ˜λ˜μ—ˆκ³ , ν•„μš”μ‘°κ±΄κ³Ό λ„ꡬ가 μ€€λΉ„λ˜μ—ˆμœΌλ©°, ν‘œμ€€κ³Ό λͺ…세에 λŒ€ν•œ μ§€μ‹λ„ μΆ©λΆ„ν–ˆμŠ΅λ‹ˆλ‹€.
+
+---
+
+## λ―Έλž˜
+
+ν˜„μ‹œμ μ—μ„œ **FastAPI**κ°€ λ§Žμ€ μ‚¬λžŒλ“€μ—κ²Œ μœ μš©ν•˜λ‹€λŠ” κ²ƒμ΄ λͺ…λ°±ν•΄μ‘ŒμŠ΅λ‹ˆλ‹€.
+
+μ—¬λŸ¬ μš©λ„에 λ” μ ν•©ν•œ λ„κ΅¬λ‘œμ„œ κΈ°μ‘΄ λŒ€μ•ˆλ³΄λ‹€ μ„ ν˜Έλ˜κ³  μžˆμŠ΅λ‹ˆλ‹€.
+이미 λ§Žμ€ κ°œλ°œμžμ™€ νŒ€λ“€μ΄ **FastAPI**에 μ˜μ‘΄ν•΄ ν”„λ‘œμ νŠΈλ₯Ό μ§„ν–‰ μ€‘μž…λ‹ˆλ‹€ (저와 μ œ νŒ€λ„ λ§ˆμ°¬κ°€μ§€μž…λ‹ˆλ‹€).
+
+ν•˜μ§€λ§Œ μ—¬μ „νžˆ κ°œμ„ ν•΄μ•Ό ν•  μ κ³Ό μΆ”κ°€ν•  κΈ°λŠ₯듀이 λ§Žμ΄ λ‚¨μ•„ μžˆμŠ΅λ‹ˆλ‹€.
+
+**FastAPI**λŠ” λ°μ€ λ―Έλž˜λ‘œ λ‚˜μ•„κ°€κ³  μžˆμŠ΅λ‹ˆλ‹€.
+그리고 [μ—¬λŸ¬λΆ„μ˜ λ„움](help-fastapi.md){.internal-link target=_blank}은 ν° νž˜μ΄ λ©λ‹ˆλ‹€.