diff --git a/docs/ko/docs/advanced/generate-clients.md b/docs/ko/docs/advanced/generate-clients.md index bf29e52e9b..1c2e323778 100644 --- a/docs/ko/docs/advanced/generate-clients.md +++ b/docs/ko/docs/advanced/generate-clients.md @@ -30,7 +30,6 @@ FastAPI는 **OpenAPI 3.1** 사양을 자동으로 생성하므로, 사용하는 예를 들어 다음을 사용해 볼 수 있습니다: -* [Speakeasy](https://speakeasy.com/editor?utm_source=fastapi+repo&utm_medium=github+sponsorship) * [Stainless](https://www.stainless.com/?utm_source=fastapi&utm_medium=referral) * [liblab](https://developers.liblab.com/tutorials/sdk-for-fastapi?utm_source=fastapi) diff --git a/docs/ko/docs/index.md b/docs/ko/docs/index.md index 91d27fcee9..719fae8219 100644 --- a/docs/ko/docs/index.md +++ b/docs/ko/docs/index.md @@ -54,18 +54,27 @@ FastAPI는 현대적이고, 빠르며(고성능), 파이썬 표준 타입 힌트 ### 키스톤 스폰서 { #keystone-sponsor } +
{% for sponsor in sponsors.keystone -%} - +{{ sponsor.title }} {% endfor -%} +
-### 골드 및 실버 스폰서 { #gold-and-silver-sponsors } +### 골드 스폰서 { #gold-sponsors } +
{% for sponsor in sponsors.gold -%} - +{{ sponsor.title }} {% endfor -%} -{%- for sponsor in sponsors.silver -%} - +
+ +### 실버 스폰서 { #silver-sponsors } + +
+{% for sponsor in sponsors.silver -%} +{{ sponsor.title }} {% endfor %} +
@@ -73,55 +82,81 @@ FastAPI는 현대적이고, 빠르며(고성능), 파이썬 표준 타입 힌트 ## 의견들 { #opinions } + +
+
+ + + + +
+ +
+
"저는 요즘 FastAPI를 많이 사용하고 있습니다. 우리 팀의 모든 마이크로소프트 ML 서비스에 사용할 계획입니다. 그중 일부는 핵심 Windows 제품과 일부 Office 제품에 통합되고 있습니다."
+
— Kabir Khan, Microsoft (ref)
+
+ + + +
+ + +
+ "_[...] 저는 요즘 **FastAPI**를 많이 사용하고 있습니다. [...] 사실 우리 팀의 **마이크로소프트 ML 서비스** 전부를 바꿀 계획입니다. 그중 일부는 핵심 **Windows**와 몇몇의 **Office** 제품들이 통합되고 있습니다._" -
Kabir Khan - 마이크로소프트 (ref)
+
Kabir Khan - Microsoft (ref)
--- -"_**FastAPI** 라이브러리를 채택하여 **예측**을 얻기 위해 쿼리를 실행 할 수 있는 **REST** 서버를 생성했습니다. [Ludwig을 위해]_" +"_**FastAPI** 라이브러리를 채택하여 **예측**을 얻기 위해 쿼리를 실행할 수 있는 **REST** 서버를 생성했습니다. [Ludwig을 위해]_" -
Piero Molino, Yaroslav Dudin 그리고 Sai Sumanth Miryala - 우버 (ref)
+
Piero Molino, Yaroslav Dudin, and Sai Sumanth Miryala - Uber (ref)
--- "_**Netflix**는 우리의 오픈 소스 배포판인 **위기 관리** 오케스트레이션 프레임워크를 발표할 수 있어 기쁩니다: 바로 **Dispatch**입니다! [**FastAPI**로 빌드]_" -
Kevin Glisson, Marc Vilanova, Forest Monsen - 넷플릭스 (ref)
+
Kevin Glisson, Marc Vilanova, Forest Monsen - Netflix (ref)
--- -"_**FastAPI**가 너무 좋아서 구름 위를 걷는듯 합니다. 정말 즐겁습니다!_" - -
Brian Okken - [Python Bytes](https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855) podcast host (ref)
- ---- - -"_솔직히, 당신이 만든 것은 매우 견고하고 세련되어 보입니다. 여러 면에서 **Hug**가 이렇게 되었으면 합니다 - 그걸 만든 누군가를 보는 것은 많은 영감을 줍니다._" - -
Timothy Crosley - [Hug](https://github.com/hugapi/hug) 제작자 (ref)
- ---- - -"_REST API를 만들기 위해 **현대적인 프레임워크**를 찾고 있다면 **FastAPI**를 확인해 보십시오. [...] 빠르고, 쓰기 쉽고, 배우기도 쉽습니다 [...]_" - -"_우리 **API**를 **FastAPI**로 바꿨습니다 [...] 아마 여러분도 좋아하실 것입니다 [...]_" - -
Ines Montani - Matthew Honnibal - [Explosion AI](https://explosion.ai) 설립자 - [spaCy](https://spacy.io) 제작자 (ref) - (ref)
- ---- - -"_프로덕션 Python API를 만들고자 한다면, 저는 **FastAPI**를 강력히 추천합니다. **아름답게 설계**되었고, **사용이 간단**하며, **확장성이 매우 뛰어나**고, 우리의 API 우선 개발 전략에서 **핵심 구성 요소**가 되었으며 Virtual TAC Engineer 같은 많은 자동화와 서비스를 이끌고 있습니다._" +"_프로덕션 Python API를 만들고자 한다면, 저는 **FastAPI**를 강력히 추천합니다. **아름답게 설계**되었고, **사용이 간단**하며, **확장성이 매우 뛰어나** 우리의 API 우선 개발 전략에서 **핵심 구성 요소**가 되었습니다._"
Deon Pillsbury - Cisco (ref)
--- +
+ +## FastAPI Conf { #fastapi-conf } + +[**FastAPI Conf '26**](https://fastapiconf.com)은 **2026년 10월 28일**, **네덜란드 암스테르담**에서 열립니다. FastAPI에 관한 모든 것, 바로 출처에서. 🎤 + +FastAPI Conf '26 - October 28, 2026 - Amsterdam, NL + ## FastAPI 미니 다큐멘터리 { #fastapi-mini-documentary } 2025년 말에 공개된 [FastAPI 미니 다큐멘터리](https://www.youtube.com/watch?v=mpR8ngthqiE)가 있습니다. 온라인에서 시청할 수 있습니다: -FastAPI Mini Documentary +FastAPI Mini Documentary ## **Typer**, CLI를 위한 FastAPI { #typer-the-fastapi-of-clis } diff --git a/docs/ko/docs/virtual-environments.md b/docs/ko/docs/virtual-environments.md index 7c2a59f81c..d75ee80174 100644 --- a/docs/ko/docs/virtual-environments.md +++ b/docs/ko/docs/virtual-environments.md @@ -2,13 +2,13 @@ Python 프로젝트를 작업할 때는 **가상 환경**(또는 이와 유사한 메커니즘)을 사용해 각 프로젝트마다 설치하는 패키지를 분리하는 것이 좋습니다. -/// info +/// note | 참고 이미 가상 환경에 대해 알고 있고, 어떻게 생성하고 사용하는지도 알고 있다면, 이 섹션은 건너뛰어도 괜찮습니다. 🤓 /// -/// tip +/// tip | 팁 **가상 환경**은 **환경 변수**와 다릅니다. @@ -18,7 +18,7 @@ Python 프로젝트를 작업할 때는 **가상 환경**(또는 이와 유사 /// -/// info +/// note | 참고 이 페이지에서는 **가상 환경**을 사용하는 방법과 작동 방식을 알려드립니다. @@ -55,7 +55,7 @@ $ cd awesome-project Python 프로젝트를 **처음 시작할 때**, 가상 환경을 **프로젝트 내부**에 생성하세요. -/// tip +/// tip | 팁 이 작업은 **프로젝트당 한 번만** 하면 되며, 작업할 때마다 할 필요는 없습니다. @@ -96,7 +96,7 @@ $ uv venv -/// tip +/// tip | 팁 기본적으로 `uv`는 `.venv`라는 디렉터리에 가상 환경을 생성합니다. @@ -118,7 +118,7 @@ $ uv venv 이후 실행하는 Python 명령어와 설치하는 패키지가 새 가상 환경을 사용하도록, 새 가상 환경을 활성화하세요. -/// tip +/// tip | 팁 프로젝트 작업을 위해 **새 터미널 세션**을 시작할 때마다 **매번** 이 작업을 하세요. @@ -162,7 +162,7 @@ $ source .venv/Scripts/activate //// -/// tip +/// tip | 팁 해당 환경에 **새 패키지**를 설치할 때마다, 환경을 다시 **활성화**하세요. @@ -174,7 +174,7 @@ $ source .venv/Scripts/activate 가상 환경이 활성화되어 있는지(이전 명령어가 작동했는지) 확인합니다. -/// tip +/// tip | 팁 이 단계는 **선택 사항**이지만, 모든 것이 예상대로 작동하고 있는지, 그리고 의도한 가상 환경을 사용하고 있는지 **확인**하는 좋은 방법입니다. @@ -214,7 +214,7 @@ C:\Users\user\code\awesome-project\.venv\Scripts\python ## `pip` 업그레이드 { #upgrade-pip } -/// tip +/// tip | 팁 [`uv`](https://github.com/astral-sh/uv)를 사용한다면, `pip` 대신 `uv`로 설치하게 되므로 `pip`을 업그레이드할 필요가 없습니다. 😎 @@ -224,7 +224,7 @@ C:\Users\user\code\awesome-project\.venv\Scripts\python 패키지 설치 중 발생하는 다양한 특이한 오류는 먼저 `pip`를 업그레이드하는 것만으로 해결되는 경우가 많습니다. -/// tip +/// tip | 팁 보통 이 작업은 가상 환경을 만든 직후 **한 번만** 하면 됩니다. @@ -242,7 +242,7 @@ $ python -m pip install --upgrade pip -/// tip +/// tip | 팁 때로는 pip를 업그레이드하려고 할 때 **`No module named pip`** 오류가 발생할 수 있습니다. @@ -266,13 +266,13 @@ $ python -m ensurepip --upgrade **Git**을 사용하고 있다면(사용하는 것이 좋습니다), `.venv`의 모든 내용을 Git에서 제외하도록 `.gitignore` 파일을 추가하세요. -/// tip +/// tip | 팁 [`uv`](https://github.com/astral-sh/uv)로 가상 환경을 만들었다면, 이미 자동으로 처리되어 있으므로 이 단계는 건너뛰어도 됩니다. 😎 /// -/// tip +/// tip | 팁 가상 환경을 만든 직후 **한 번만** 하면 됩니다. @@ -306,7 +306,7 @@ $ echo "*" > .venv/.gitignore 환경을 활성화한 뒤, 그 안에 패키지를 설치할 수 있습니다. -/// tip +/// tip | 팁 프로젝트에 필요한 패키지를 설치하거나 업그레이드할 때는 **한 번**만 하면 됩니다. @@ -318,7 +318,7 @@ $ echo "*" > .venv/.gitignore 급하게 작업 중이고 프로젝트의 패키지 요구사항을 선언하는 파일을 사용하고 싶지 않다면, 패키지를 직접 설치할 수 있습니다. -/// tip +/// tip | 팁 프로그램에 필요한 패키지와 버전을 파일(예: `requirements.txt` 또는 `pyproject.toml`)에 적어두는 것은 (매우) 좋은 생각입니다. @@ -419,7 +419,7 @@ Hello World * [VS Code](https://code.visualstudio.com/docs/python/environments#_select-and-activate-an-environment) * [PyCharm](https://www.jetbrains.com/help/pycharm/creating-virtual-environment.html) -/// tip +/// tip | 팁 보통 이 설정은 가상 환경을 만들 때 **한 번만** 하면 됩니다. @@ -445,7 +445,7 @@ $ deactivate -/// tip +/// tip | 팁 위의 내용이 무엇인지 더 이해하고 싶으신가요? @@ -536,7 +536,7 @@ flowchart LR end ``` -/// tip +/// tip | 팁 Python 패키지에서는 **새 버전**에서 **호환성을 깨뜨리는 변경(breaking changes)**을 **피하려고** 최선을 다하는 것이 매우 일반적이지만, 안전을 위해 더 최신 버전은 의도적으로 설치하고, 테스트를 실행해 모든 것이 올바르게 작동하는지 확인할 수 있을 때 설치하는 것이 좋습니다. @@ -643,7 +643,7 @@ $ source .venv/Scripts/activate 그 변수 중 하나가 `PATH` 변수입니다. -/// tip +/// tip | 팁 `PATH` 환경 변수에 대해 더 알아보려면 [환경 변수](environment-variables.md#path-environment-variable) 섹션을 참고하세요. @@ -776,7 +776,7 @@ Linux와 macOS에서는 `which`, Windows PowerShell에서는 `Get-Command`를 따라서 올바른 가상 환경에 있는지 확인할 수 있습니다. -/// tip +/// tip | 팁 가상 환경을 하나 활성화해서 Python을 사용한 다음, **다른 프로젝트로 이동**하기 쉽습니다. @@ -819,7 +819,7 @@ Traceback (most recent call last): -하지만 가상 환경을 비활성화하고 `prisoner-of-askaban`에 대한 새 가상 환경을 활성화하면, `python`을 실행할 때 `prisoner-of-azkaban`의 가상 환경에 있는 Python을 사용하게 됩니다. +하지만 가상 환경을 비활성화하고 `prisoner-of-azkaban`에 대한 새 가상 환경을 활성화하면, `python`을 실행할 때 `prisoner-of-azkaban`의 가상 환경에 있는 Python을 사용하게 됩니다.