Feb 14, 2026 · Feb 13, 2026 · Feb 14, 2026
diff --git a/docs/ko/docs/_llm-test.md b/docs/ko/docs/_llm-test.md

 //// tab | 테스트

 어제 제 친구가 이렇게 썼습니다: "If you spell incorrectly correctly, you have spelled it incorrectly". 이에 저는 이렇게 답했습니다: "Correct, but 'incorrectly' is incorrectly not '"incorrectly"'"".
 어제 제 친구가 이렇게 썼습니다: "If you spell incorrectly correctly, you have spelled it incorrectly". 이에 저는 이렇게 답했습니다: "Correct, but 'incorrectly' is incorrectly not '"incorrectly"'".

 /// note | 참고


 //// tab | 테스트

 *당신
 *당신의
 *여러분
 *여러분의

 * 예: (e.g.)
 * 등 (etc.)

 * `int`로서의 `foo`
 * `str`로서의 `bar`
 * `list`로서의 `baz`
 * `foo`로서의 `int`
 * `bar`로서의 `str`
 * `baz`로서의 `list`

 * 튜토리얼 - 사용자 가이드
 * 고급 사용자 가이드
diff --git a/docs/ko/docs/advanced/additional-responses.md b/docs/ko/docs/advanced/additional-responses.md

 예를 들어, 상태 코드 `404`와 Pydantic 모델 `Message`를 사용하는 다른 응답을 선언하려면 다음과 같이 작성할 수 있습니다:

 {* ../../docs_src/additional_responses/tutorial001_py39.py hl[18,22] *}
 {* ../../docs_src/additional_responses/tutorial001_py310.py hl[18,22] *}

 /// note | 참고


 또한 `response_model`을 사용하는 상태 코드 `200` 응답을 선언하되, 커스텀 `example`을 포함할 수도 있습니다:

 {* ../../docs_src/additional_responses/tutorial003_py39.py hl[20:31] *}
 {* ../../docs_src/additional_responses/tutorial003_py310.py hl[20:31] *}

 이 모든 내용은 OpenAPI에 결합되어 포함되고, API 문서에 표시됩니다:

diff --git a/docs/ko/docs/advanced/additional-status-codes.md b/docs/ko/docs/advanced/additional-status-codes.md
 # 추가 상태 코드 { #additional-status-codes }

 기본적으로 **FastAPI**는 응답을 `JSONResponse`를 사용하여 반환하며, *경로작업(path operation)*에서 반환한 내용을 해당 `JSONResponse` 안에 넣어 반환합니다.
 기본적으로 **FastAPI**는 응답을 `JSONResponse`를 사용하여 반환하며, *경로처리*에서 반환한 내용을 해당 `JSONResponse` 안에 넣어 반환합니다.

 기본 상태 코드 또는 *경로작업*에서 설정한 상태 코드를 사용합니다.
 기본 상태 코드 또는 *경로처리*에서 설정한 상태 코드를 사용합니다.

 ## 추가 상태 코드 { #additional-status-codes_1 }

 기본 상태 코드와 별도로 추가 상태 코드를 반환하려면 `JSONResponse`와 같이 `Response`를 직접 반환하고 추가 상태 코드를 직접 설정할 수 있습니다.

 예를 들어 항목을 업데이트할 수 있는 *경로작업*이 있고 성공 시 200 “OK”의 HTTP 상태 코드를 반환한다고 가정해 보겠습니다.
 예를 들어 항목을 업데이트할 수 있는 *경로처리*가 있고 성공 시 200 “OK”의 HTTP 상태 코드를 반환한다고 가정해 보겠습니다.

 하지만 새로운 항목을 허용하기를 원할 것입니다. 그리고 항목이 이전에 존재하지 않았다면 이를 생성하고 HTTP 상태 코드 201 "Created"를 반환합니다.

 이를 위해서는 `JSONResponse`를 가져와서 원하는 `status_code`를 설정하여 콘텐츠를 직접 반환합니다:

 {* ../../docs_src/additional_status_codes/tutorial001_an_py310.py hl[4,25] *}

 /// warning | 경고
 /// warning

 위의 예제처럼 `Response`를 직접 반환하면 바로 반환됩니다.

diff --git a/docs/ko/docs/advanced/advanced-dependencies.md b/docs/ko/docs/advanced/advanced-dependencies.md

 이를 위해 `__call__` 메서드를 선언합니다:

 {* ../../docs_src/dependencies/tutorial011_an_py39.py hl[12] *}
 {* ../../docs_src/dependencies/tutorial011_an_py310.py hl[12] *}

 이 경우, **FastAPI**는 추가 매개변수와 하위 의존성을 확인하기 위해 `__call__`을 사용하게 되며,
 나중에 *경로 처리 함수*에서 매개변수에 값을 전달할 때 이를 호출하게 됩니다.

 이제 `__init__`을 사용하여 의존성을 "매개변수화"할 수 있는 인스턴스의 매개변수를 선언할 수 있습니다:

 {* ../../docs_src/dependencies/tutorial011_an_py39.py hl[9] *}
 {* ../../docs_src/dependencies/tutorial011_an_py310.py hl[9] *}

 이 경우, **FastAPI**는 `__init__`에 전혀 관여하지 않으며, 우리는 이 메서드를 코드에서 직접 사용하게 됩니다.

 ## 인스턴스 생성하기 { #create-an-instance }

 다음과 같이 이 클래스의 인스턴스를 생성할 수 있습니다:

 {* ../../docs_src/dependencies/tutorial011_an_py39.py hl[18] *}
 {* ../../docs_src/dependencies/tutorial011_an_py310.py hl[18] *}

 이렇게 하면 `checker.fixed_content` 속성에 `"bar"`라는 값을 담아 의존성을 "매개변수화"할 수 있습니다.


 ...그리고 이때 반환되는 값을 *경로 처리 함수*의 의존성 값으로, `fixed_content_included` 매개변수에 전달합니다:

 {* ../../docs_src/dependencies/tutorial011_an_py39.py hl[22] *}
 {* ../../docs_src/dependencies/tutorial011_an_py310.py hl[22] *}

 /// tip | 팁

diff --git a/docs/ko/docs/advanced/advanced-python-types.md b/docs/ko/docs/advanced/advanced-python-types.md
 # 고급 Python 타입 { #advanced-python-types }

 Python 타입을 다룰 때 유용할 수 있는 몇 가지 추가 아이디어를 소개합니다.

 ## `Union` 또는 `Optional` 사용 { #using-union-or-optional }

 어떤 이유로 코드에서 `|`를 사용할 수 없다면, 예를 들어 타입 어노테이션이 아니라 `response_model=` 같은 곳이라면, 파이프 문자(`|`) 대신 `typing`의 `Union`을 사용할 수 있습니다.

 예를 들어, 어떤 값이 `str` 또는 `None`이 될 수 있다고 선언할 수 있습니다:

 ```python
 from typing import Union


 def say_hi(name: Union[str, None]):
        print(f"Hi {name}!")
 ```

 `typing`에는 `None`이 될 수 있음을 선언하는 축약형으로 `Optional`도 있습니다.

 아주 개인적인 관점에서의 팁입니다:

 - 🚨 `Optional[SomeType]` 사용은 피하세요
 - 대신 ✨ **`Union[SomeType, None]`를 사용하세요** ✨.

 둘은 동등하며 내부적으로도 같습니다. 하지만 단어 "optional"은 값이 선택 사항이라는 인상을 주는 반면, 실제 의미는 "값이 `None`이 될 수 있다"는 뜻입니다. 값이 선택 사항이 아니라 여전히 필수인 경우에도 그렇습니다.

 `Union[SomeType, None]`가 의미를 더 명확하게 드러낸다고 생각합니다.

 이는 단지 단어와 명칭의 문제입니다. 하지만 이런 단어가 여러분과 팀원이 코드를 어떻게 생각하는지에 영향을 줄 수 있습니다.

 예를 들어, 다음 함수를 보세요:

 ```python
 from typing import Optional


 def say_hi(name: Optional[str]):
    print(f"Hey {name}!")
 ```

 매개변수 `name`은 `Optional[str]`로 정의되어 있지만, 사실 선택적이지 않습니다. 이 매개변수 없이 함수를 호출할 수 없습니다:

 ```Python
 say_hi()  # 이런, 에러가 발생합니다! 😱
 ```

 `name` 매개변수는 기본값이 없기 때문에 여전히 필수입니다(선택적이 아님). 대신, `name`에는 `None`을 전달할 수 있습니다:

 ```Python
 say_hi(name=None)  # 작동합니다. None은 유효합니다 🎉
 ```

 좋은 소식은, 대부분의 경우 타입의 합집합을 정의할 때 그냥 `|`를 사용할 수 있다는 점입니다:

 ```python
 def say_hi(name: str | None):
    print(f"Hey {name}!")
 ```

 그래서 보통은 `Optional`과 `Union` 같은 이름에 대해 걱정하지 않으셔도 됩니다. 😎
diff --git a/docs/ko/docs/advanced/async-tests.md b/docs/ko/docs/advanced/async-tests.md

 `main.py` 파일은 다음과 같습니다:

 {* ../../docs_src/async_tests/app_a_py39/main.py *}
 {* ../../docs_src/async_tests/app_a_py310/main.py *}

 `test_main.py` 파일에는 `main.py`에 대한 테스트가 있으며, 이제 다음과 같이 보일 수 있습니다:

 {* ../../docs_src/async_tests/app_a_py39/test_main.py *}
 {* ../../docs_src/async_tests/app_a_py310/test_main.py *}

 ## 실행하기 { #run-it }


 `@pytest.mark.anyio` 마커는 pytest에게 이 테스트 함수가 비동기로 호출되어야 한다고 알려줍니다:

 {* ../../docs_src/async_tests/app_a_py39/test_main.py hl[7] *}
 {* ../../docs_src/async_tests/app_a_py310/test_main.py hl[7] *}

 /// tip | 팁


 그 다음 앱으로 `AsyncClient`를 만들고, `await`를 사용해 비동기 요청을 보낼 수 있습니다.

 {* ../../docs_src/async_tests/app_a_py39/test_main.py hl[9:12] *}
 {* ../../docs_src/async_tests/app_a_py310/test_main.py hl[9:12] *}

 이는 다음과 동등합니다:

diff --git a/docs/ko/docs/advanced/behind-a-proxy.md b/docs/ko/docs/advanced/behind-a-proxy.md

 예를 들어, *경로 처리* `/items/`를 정의했다고 해봅시다:

 {* ../../docs_src/behind_a_proxy/tutorial001_01_py39.py hl[6] *}
 {* ../../docs_src/behind_a_proxy/tutorial001_01_py310.py hl[6] *}

 클라이언트가 `/items`로 접근하면, 기본적으로 `/items/`로 리디렉션됩니다.


 코드는 모두 `/app`만 있다고 가정하고 작성되어 있는데도 말입니다.

 {* ../../docs_src/behind_a_proxy/tutorial001_py39.py hl[6] *}
 {* ../../docs_src/behind_a_proxy/tutorial001_py310.py hl[6] *}

 그리고 프록시는 요청을 앱 서버(아마 FastAPI CLI를 통해 실행되는 Uvicorn)로 전달하기 전에, 동적으로 **경로 접두사**를 **"제거"**합니다. 그래서 애플리케이션은 여전히 `/app`에서 서비스된다고 믿게 되고, 코드 전체를 `/api/v1` 접두사를 포함하도록 수정할 필요가 없어집니다.


 여기서는 데모 목적을 위해 메시지에 포함하고 있습니다.

 {* ../../docs_src/behind_a_proxy/tutorial001_py39.py hl[8] *}
 {* ../../docs_src/behind_a_proxy/tutorial001_py310.py hl[8] *}

 그 다음 Uvicorn을 다음과 같이 시작하면:


 또는 `--root-path` 같은 커맨드 라인 옵션(또는 동등한 방법)을 제공할 수 없는 경우, FastAPI 앱을 생성할 때 `root_path` 파라미터를 설정할 수 있습니다:

 {* ../../docs_src/behind_a_proxy/tutorial002_py39.py hl[3] *}
 {* ../../docs_src/behind_a_proxy/tutorial002_py310.py hl[3] *}

 `FastAPI`에 `root_path`를 전달하는 것은 Uvicorn이나 Hypercorn에 커맨드 라인 옵션 `--root-path`를 전달하는 것과 동일합니다.


 예:

 {* ../../docs_src/behind_a_proxy/tutorial003_py39.py hl[4:7] *}
 {* ../../docs_src/behind_a_proxy/tutorial003_py310.py hl[4:7] *}

 다음과 같은 OpenAPI 스키마를 생성합니다:


 **FastAPI**가 `root_path`를 사용한 자동 server를 포함하지 않게 하려면, `root_path_in_servers=False` 파라미터를 사용할 수 있습니다:

 {* ../../docs_src/behind_a_proxy/tutorial004_py39.py hl[9] *}
 {* ../../docs_src/behind_a_proxy/tutorial004_py310.py hl[9] *}

 그러면 OpenAPI 스키마에 포함되지 않습니다.

diff --git a/docs/ko/docs/advanced/custom-response.md b/docs/ko/docs/advanced/custom-response.md

 하지만 반환하는 내용이 **JSON으로 직렬화 가능**하다고 확신하는 경우, 해당 내용을 응답 클래스에 직접 전달할 수 있으며, FastAPI가 반환 내용을 `jsonable_encoder`를 통해 처리한 뒤 응답 클래스에 전달하는 오버헤드를 피할 수 있습니다.

 {* ../../docs_src/custom_response/tutorial001b_py39.py hl[2,7] *}
 {* ../../docs_src/custom_response/tutorial001b_py310.py hl[2,7] *}

 /// info | 정보

 * `HTMLResponse`를 임포트 합니다.
 * *경로 처리 데코레이터*의 `response_class` 매개변수로 `HTMLResponse`를 전달합니다.

 {* ../../docs_src/custom_response/tutorial002_py39.py hl[2,7] *}
 {* ../../docs_src/custom_response/tutorial002_py310.py hl[2,7] *}

 /// info | 정보


 위의 예제와 동일하게 `HTMLResponse`를 반환하는 코드는 다음과 같을 수 있습니다:

 {* ../../docs_src/custom_response/tutorial003_py39.py hl[2,7,19] *}
 {* ../../docs_src/custom_response/tutorial003_py310.py hl[2,7,19] *}

 /// warning | 경고


 예를 들어, 다음과 같이 작성할 수 있습니다:

 {* ../../docs_src/custom_response/tutorial004_py39.py hl[7,21,23] *}
 {* ../../docs_src/custom_response/tutorial004_py310.py hl[7,21,23] *}

 이 예제에서, `generate_html_response()` 함수는 HTML을 `str`로 반환하는 대신 이미 `Response`를 생성하고 반환합니다.


 FastAPI (실제로는 Starlette)가 자동으로 Content-Length 헤더를 포함시킵니다. 또한 `media_type`에 기반하여 Content-Type 헤더를 포함하며, 텍스트 타입의 경우 문자 집합을 추가 합니다.

 {* ../../docs_src/response_directly/tutorial002_py39.py hl[1,18] *}
 {* ../../docs_src/response_directly/tutorial002_py310.py hl[1,18] *}

 ### `HTMLResponse` { #htmlresponse }


 텍스트 또는 바이트를 받아 일반 텍스트 응답을 반환합니다.

 {* ../../docs_src/custom_response/tutorial005_py39.py hl[2,7,9] *}
 {* ../../docs_src/custom_response/tutorial005_py310.py hl[2,7,9] *}

 ### `JSONResponse` { #jsonresponse }


 ///

 {* ../../docs_src/custom_response/tutorial001_py39.py hl[2,7] *}
 {* ../../docs_src/custom_response/tutorial001_py310.py hl[2,7] *}

 /// tip | 팁


 `RedirectResponse`를 직접 반환할 수 있습니다.

 {* ../../docs_src/custom_response/tutorial006_py39.py hl[2,9] *}
 {* ../../docs_src/custom_response/tutorial006_py310.py hl[2,9] *}

 ---

 또는 `response_class` 매개변수에서 사용할 수도 있습니다:


 {* ../../docs_src/custom_response/tutorial006b_py39.py hl[2,7,9] *}
 {* ../../docs_src/custom_response/tutorial006b_py310.py hl[2,7,9] *}

 이 경우, *경로 처리* 함수에서 URL을 직접 반환할 수 있습니다.


 `status_code` 매개변수를 `response_class` 매개변수와 함께 사용할 수도 있습니다:

 {* ../../docs_src/custom_response/tutorial006c_py39.py hl[2,7,9] *}
 {* ../../docs_src/custom_response/tutorial006c_py310.py hl[2,7,9] *}

 ### `StreamingResponse` { #streamingresponse }

 비동기 제너레이터 또는 일반 제너레이터/이터레이터를 받아 응답 본문을 스트리밍 합니다.

 {* ../../docs_src/custom_response/tutorial007_py39.py hl[2,14] *}
 {* ../../docs_src/custom_response/tutorial007_py310.py hl[2,14] *}

 #### 파일과 같은 객체를 사용한 `StreamingResponse` { #using-streamingresponse-with-file-like-objects }


 이 방식은 클라우드 스토리지, 비디오 처리 등의 다양한 라이브러리와 함께 사용할 수 있습니다.

 {* ../../docs_src/custom_response/tutorial008_py39.py hl[2,10:12,14] *}
 {* ../../docs_src/custom_response/tutorial008_py310.py hl[2,10:12,14] *}

 1. 이것이 제너레이터 함수입니다. `yield` 문을 포함하고 있으므로 "제너레이터 함수"입니다.
 2. `with` 블록을 사용함으로써, 제너레이터 함수가 완료된 후 파일과 같은 객체가 닫히도록 합니다. 즉, 응답 전송이 끝난 후 닫힙니다.

 파일 응답에는 적절한 `Content-Length`, `Last-Modified`, 및 `ETag` 헤더가 포함됩니다.

 {* ../../docs_src/custom_response/tutorial009_py39.py hl[2,10] *}
 {* ../../docs_src/custom_response/tutorial009_py310.py hl[2,10] *}

 또한 `response_class` 매개변수를 사용할 수도 있습니다:

 {* ../../docs_src/custom_response/tutorial009b_py39.py hl[2,8,10] *}
 {* ../../docs_src/custom_response/tutorial009b_py310.py hl[2,8,10] *}

 이 경우, 경로 처리 함수에서 파일 경로를 직접 반환할 수 있습니다.


 `CustomORJSONResponse`를 생성할 수 있습니다. 여기서 핵심은 `Response.render(content)` 메서드를 생성하여 내용을 `bytes`로 반환하는 것입니다:

 {* ../../docs_src/custom_response/tutorial009c_py39.py hl[9:14,17] *}
 {* ../../docs_src/custom_response/tutorial009c_py310.py hl[9:14,17] *}

 이제 다음 대신:


 아래 예제에서 **FastAPI**는 모든 *경로 처리*에서 기본적으로 `JSONResponse` 대신 `ORJSONResponse`를 사용합니다.

 {* ../../docs_src/custom_response/tutorial010_py39.py hl[2,4] *}
 {* ../../docs_src/custom_response/tutorial010_py310.py hl[2,4] *}

 /// tip | 팁
Original file line number	Diff line number	Diff line change
Expand Up		@@ -35,7 +35,7 @@

		//// tab \| 테스트

		어제 제 친구가 이렇게 썼습니다: "If you spell incorrectly correctly, you have spelled it incorrectly". 이에 저는 이렇게 답했습니다: "Correct, but 'incorrectly' is incorrectly not '"incorrectly"'"".
		어제 제 친구가 이렇게 썼습니다: "If you spell incorrectly correctly, you have spelled it incorrectly". 이에 저는 이렇게 답했습니다: "Correct, but 'incorrectly' is incorrectly not '"incorrectly"'".

		/// note \| 참고

Expand DownExpand Up		@@ -256,15 +256,15 @@ works(foo="bar") # 이건 동작합니다 🎉

		//// tab \| 테스트

		*당신
		*당신의
		*여러분
		*여러분의

		* 예: (e.g.)
		* 등 (etc.)

		* `int`로서의 `foo`
		* `str`로서의 `bar`
		* `list`로서의 `baz`
		* `foo`로서의 `int`
		* `bar`로서의 `str`
		* `baz`로서의 `list`

		* 튜토리얼 - 사용자 가이드
		* 고급 사용자 가이드
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -26,7 +26,7 @@

		예를 들어, 상태 코드 `404`와 Pydantic 모델 `Message`를 사용하는 다른 응답을 선언하려면 다음과 같이 작성할 수 있습니다:

		{* ../../docs_src/additional_responses/tutorial001_py39.py hl[18,22] *}
		{* ../../docs_src/additional_responses/tutorial001_py310.py hl[18,22] *}

		/// note \| 참고

Expand DownExpand Up		@@ -203,7 +203,7 @@

		또한 `response_model`을 사용하는 상태 코드 `200` 응답을 선언하되, 커스텀 `example`을 포함할 수도 있습니다:

		{* ../../docs_src/additional_responses/tutorial003_py39.py hl[20:31] *}
		{* ../../docs_src/additional_responses/tutorial003_py310.py hl[20:31] *}

		이 모든 내용은 OpenAPI에 결합되어 포함되고, API 문서에 표시됩니다:

Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,22 +1,22 @@
		# 추가 상태 코드 { #additional-status-codes }

		기본적으로 FastAPI는 응답을 `JSONResponse`를 사용하여 반환하며, 경로작업(path operation)에서 반환한 내용을 해당 `JSONResponse` 안에 넣어 반환합니다.
		기본적으로 FastAPI는 응답을 `JSONResponse`를 사용하여 반환하며, 경로처리에서 반환한 내용을 해당 `JSONResponse` 안에 넣어 반환합니다.

		기본 상태 코드 또는 경로작업에서 설정한 상태 코드를 사용합니다.
		기본 상태 코드 또는 경로처리에서 설정한 상태 코드를 사용합니다.

		## 추가 상태 코드 { #additional-status-codes_1 }

		기본 상태 코드와 별도로 추가 상태 코드를 반환하려면 `JSONResponse`와 같이 `Response`를 직접 반환하고 추가 상태 코드를 직접 설정할 수 있습니다.

		예를 들어 항목을 업데이트할 수 있는 경로작업이 있고 성공 시 200 “OK”의 HTTP 상태 코드를 반환한다고 가정해 보겠습니다.
		예를 들어 항목을 업데이트할 수 있는 경로처리가 있고 성공 시 200 “OK”의 HTTP 상태 코드를 반환한다고 가정해 보겠습니다.

		하지만 새로운 항목을 허용하기를 원할 것입니다. 그리고 항목이 이전에 존재하지 않았다면 이를 생성하고 HTTP 상태 코드 201 "Created"를 반환합니다.

		이를 위해서는 `JSONResponse`를 가져와서 원하는 `status_code`를 설정하여 콘텐츠를 직접 반환합니다:

		{* ../../docs_src/additional_status_codes/tutorial001_an_py310.py hl[4,25] *}

		/// warning \| 경고
		/// warning

		위의 예제처럼 `Response`를 직접 반환하면 바로 반환됩니다.

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -18,7 +18,7 @@ Python에는 클래스의 인스턴스를 "호출 가능"하게 만드는 방법

		이를 위해 `__call__` 메서드를 선언합니다:

		{* ../../docs_src/dependencies/tutorial011_an_py39.py hl[12] *}
		{* ../../docs_src/dependencies/tutorial011_an_py310.py hl[12] *}

		이 경우, FastAPI는 추가 매개변수와 하위 의존성을 확인하기 위해 `__call__`을 사용하게 되며,
		나중에 경로 처리 함수에서 매개변수에 값을 전달할 때 이를 호출하게 됩니다.
Expand All		@@ -27,15 +27,15 @@ Python에는 클래스의 인스턴스를 "호출 가능"하게 만드는 방법

		이제 `__init__`을 사용하여 의존성을 "매개변수화"할 수 있는 인스턴스의 매개변수를 선언할 수 있습니다:

		{* ../../docs_src/dependencies/tutorial011_an_py39.py hl[9] *}
		{* ../../docs_src/dependencies/tutorial011_an_py310.py hl[9] *}

		이 경우, FastAPI는 `__init__`에 전혀 관여하지 않으며, 우리는 이 메서드를 코드에서 직접 사용하게 됩니다.

		## 인스턴스 생성하기 { #create-an-instance }

		다음과 같이 이 클래스의 인스턴스를 생성할 수 있습니다:

		{* ../../docs_src/dependencies/tutorial011_an_py39.py hl[18] *}
		{* ../../docs_src/dependencies/tutorial011_an_py310.py hl[18] *}

		이렇게 하면 `checker.fixed_content` 속성에 `"bar"`라는 값을 담아 의존성을 "매개변수화"할 수 있습니다.

Expand All		@@ -51,7 +51,7 @@ checker(q="somequery")

		...그리고 이때 반환되는 값을 경로 처리 함수의 의존성 값으로, `fixed_content_included` 매개변수에 전달합니다:

		{* ../../docs_src/dependencies/tutorial011_an_py39.py hl[22] *}
		{* ../../docs_src/dependencies/tutorial011_an_py310.py hl[22] *}

		/// tip \| 팁

Expand Down
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,61 @@
		# 고급 Python 타입 { #advanced-python-types }

		Python 타입을 다룰 때 유용할 수 있는 몇 가지 추가 아이디어를 소개합니다.

		## `Union` 또는 `Optional` 사용 { #using-union-or-optional }

		어떤 이유로 코드에서 `\|`를 사용할 수 없다면, 예를 들어 타입 어노테이션이 아니라 `response_model=` 같은 곳이라면, 파이프 문자(`\|`) 대신 `typing`의 `Union`을 사용할 수 있습니다.

		예를 들어, 어떤 값이 `str` 또는 `None`이 될 수 있다고 선언할 수 있습니다:

		```python
		from typing import Union


		def say_hi(name: Union[str, None]):
		print(f"Hi {name}!")
		```

		`typing`에는 `None`이 될 수 있음을 선언하는 축약형으로 `Optional`도 있습니다.

		아주 개인적인 관점에서의 팁입니다:

		- 🚨 `Optional[SomeType]` 사용은 피하세요
		- 대신 ✨ `Union[SomeType, None]`를 사용하세요 ✨.

		둘은 동등하며 내부적으로도 같습니다. 하지만 단어 "optional"은 값이 선택 사항이라는 인상을 주는 반면, 실제 의미는 "값이 `None`이 될 수 있다"는 뜻입니다. 값이 선택 사항이 아니라 여전히 필수인 경우에도 그렇습니다.

		`Union[SomeType, None]`가 의미를 더 명확하게 드러낸다고 생각합니다.

		이는 단지 단어와 명칭의 문제입니다. 하지만 이런 단어가 여러분과 팀원이 코드를 어떻게 생각하는지에 영향을 줄 수 있습니다.

		예를 들어, 다음 함수를 보세요:

		```python
		from typing import Optional


		def say_hi(name: Optional[str]):
		print(f"Hey {name}!")
		```

		매개변수 `name`은 `Optional[str]`로 정의되어 있지만, 사실 선택적이지 않습니다. 이 매개변수 없이 함수를 호출할 수 없습니다:

		```Python
		say_hi() # 이런, 에러가 발생합니다! 😱
		```

		`name` 매개변수는 기본값이 없기 때문에 여전히 필수입니다(선택적이 아님). 대신, `name`에는 `None`을 전달할 수 있습니다:

		```Python
		say_hi(name=None) # 작동합니다. None은 유효합니다 🎉
		```

		좋은 소식은, 대부분의 경우 타입의 합집합을 정의할 때 그냥 `\|`를 사용할 수 있다는 점입니다:

		```python
		def say_hi(name: str \| None):
		print(f"Hey {name}!")
		```

		그래서 보통은 `Optional`과 `Union` 같은 이름에 대해 걱정하지 않으셔도 됩니다. 😎
Original file line number	Diff line number	Diff line change
Expand Up		@@ -32,11 +32,11 @@

		`main.py` 파일은 다음과 같습니다:

		{* ../../docs_src/async_tests/app_a_py39/main.py *}
		{* ../../docs_src/async_tests/app_a_py310/main.py *}

		`test_main.py` 파일에는 `main.py`에 대한 테스트가 있으며, 이제 다음과 같이 보일 수 있습니다:

		{* ../../docs_src/async_tests/app_a_py39/test_main.py *}
		{* ../../docs_src/async_tests/app_a_py310/test_main.py *}

		## 실행하기 { #run-it }

Expand All		@@ -56,7 +56,7 @@ $ pytest

		`@pytest.mark.anyio` 마커는 pytest에게 이 테스트 함수가 비동기로 호출되어야 한다고 알려줍니다:

		{* ../../docs_src/async_tests/app_a_py39/test_main.py hl[7] *}
		{* ../../docs_src/async_tests/app_a_py310/test_main.py hl[7] *}

		/// tip \| 팁

Expand All		@@ -66,7 +66,7 @@ $ pytest

		그 다음 앱으로 `AsyncClient`를 만들고, `await`를 사용해 비동기 요청을 보낼 수 있습니다.

		{* ../../docs_src/async_tests/app_a_py39/test_main.py hl[9:12] *}
		{* ../../docs_src/async_tests/app_a_py310/test_main.py hl[9:12] *}

		이는 다음과 동등합니다:

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -44,7 +44,7 @@ $ fastapi run --forwarded-allow-ips="*"

		예를 들어, 경로 처리 `/items/`를 정의했다고 해봅시다:

		{* ../../docs_src/behind_a_proxy/tutorial001_01_py39.py hl[6] *}
		{* ../../docs_src/behind_a_proxy/tutorial001_01_py310.py hl[6] *}

		클라이언트가 `/items`로 접근하면, 기본적으로 `/items/`로 리디렉션됩니다.

Expand DownExpand Up		@@ -115,7 +115,7 @@ sequenceDiagram

		코드는 모두 `/app`만 있다고 가정하고 작성되어 있는데도 말입니다.

		{* ../../docs_src/behind_a_proxy/tutorial001_py39.py hl[6] *}
		{* ../../docs_src/behind_a_proxy/tutorial001_py310.py hl[6] *}

		그리고 프록시는 요청을 앱 서버(아마 FastAPI CLI를 통해 실행되는 Uvicorn)로 전달하기 전에, 동적으로 경로 접두사를 "제거"합니다. 그래서 애플리케이션은 여전히 `/app`에서 서비스된다고 믿게 되고, 코드 전체를 `/api/v1` 접두사를 포함하도록 수정할 필요가 없어집니다.

Expand DownExpand Up		@@ -193,7 +193,7 @@ ASGI 사양은 이 사용 사례를 위해 `root_path`를 정의합니다.

		여기서는 데모 목적을 위해 메시지에 포함하고 있습니다.

		{* ../../docs_src/behind_a_proxy/tutorial001_py39.py hl[8] *}
		{* ../../docs_src/behind_a_proxy/tutorial001_py310.py hl[8] *}

		그 다음 Uvicorn을 다음과 같이 시작하면:

Expand All		@@ -220,7 +220,7 @@ $ fastapi run main.py --forwarded-allow-ips="*" --root-path /api/v1

		또는 `--root-path` 같은 커맨드 라인 옵션(또는 동등한 방법)을 제공할 수 없는 경우, FastAPI 앱을 생성할 때 `root_path` 파라미터를 설정할 수 있습니다:

		{* ../../docs_src/behind_a_proxy/tutorial002_py39.py hl[3] *}
		{* ../../docs_src/behind_a_proxy/tutorial002_py310.py hl[3] *}

		`FastAPI`에 `root_path`를 전달하는 것은 Uvicorn이나 Hypercorn에 커맨드 라인 옵션 `--root-path`를 전달하는 것과 동일합니다.

Expand DownExpand Up		@@ -400,7 +400,7 @@ $ fastapi run main.py --forwarded-allow-ips="*" --root-path /api/v1

		예:

		{* ../../docs_src/behind_a_proxy/tutorial003_py39.py hl[4:7] *}
		{* ../../docs_src/behind_a_proxy/tutorial003_py310.py hl[4:7] *}

		다음과 같은 OpenAPI 스키마를 생성합니다:

Expand DownExpand Up		@@ -455,7 +455,7 @@ OpenAPI 사양에서 `servers` 속성은 선택 사항입니다.

		FastAPI가 `root_path`를 사용한 자동 server를 포함하지 않게 하려면, `root_path_in_servers=False` 파라미터를 사용할 수 있습니다:

		{* ../../docs_src/behind_a_proxy/tutorial004_py39.py hl[9] *}
		{* ../../docs_src/behind_a_proxy/tutorial004_py310.py hl[9] *}

		그러면 OpenAPI 스키마에 포함되지 않습니다.

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -30,7 +30,7 @@

		하지만 반환하는 내용이 JSON으로 직렬화 가능하다고 확신하는 경우, 해당 내용을 응답 클래스에 직접 전달할 수 있으며, FastAPI가 반환 내용을 `jsonable_encoder`를 통해 처리한 뒤 응답 클래스에 전달하는 오버헤드를 피할 수 있습니다.

		{* ../../docs_src/custom_response/tutorial001b_py39.py hl[2,7] *}
		{* ../../docs_src/custom_response/tutorial001b_py310.py hl[2,7] *}

		/// info \| 정보

Expand All		@@ -55,7 +55,7 @@
		* `HTMLResponse`를 임포트 합니다.
		* 경로 처리 데코레이터의 `response_class` 매개변수로 `HTMLResponse`를 전달합니다.

		{* ../../docs_src/custom_response/tutorial002_py39.py hl[2,7] *}
		{* ../../docs_src/custom_response/tutorial002_py310.py hl[2,7] *}

		/// info \| 정보

Expand All		@@ -73,7 +73,7 @@

		위의 예제와 동일하게 `HTMLResponse`를 반환하는 코드는 다음과 같을 수 있습니다:

		{* ../../docs_src/custom_response/tutorial003_py39.py hl[2,7,19] *}
		{* ../../docs_src/custom_response/tutorial003_py310.py hl[2,7,19] *}

		/// warning \| 경고

Expand All		@@ -97,7 +97,7 @@

		예를 들어, 다음과 같이 작성할 수 있습니다:

		{* ../../docs_src/custom_response/tutorial004_py39.py hl[7,21,23] *}
		{* ../../docs_src/custom_response/tutorial004_py310.py hl[7,21,23] *}

		이 예제에서, `generate_html_response()` 함수는 HTML을 `str`로 반환하는 대신 이미 `Response`를 생성하고 반환합니다.

Expand DownExpand Up		@@ -136,7 +136,7 @@

		FastAPI (실제로는 Starlette)가 자동으로 Content-Length 헤더를 포함시킵니다. 또한 `media_type`에 기반하여 Content-Type 헤더를 포함하며, 텍스트 타입의 경우 문자 집합을 추가 합니다.

		{* ../../docs_src/response_directly/tutorial002_py39.py hl[1,18] *}
		{* ../../docs_src/response_directly/tutorial002_py310.py hl[1,18] *}

		### `HTMLResponse` { #htmlresponse }

Expand All		@@ -146,7 +146,7 @@ FastAPI (실제로는 Starlette)가 자동으로 Content-Length 헤더를 포함

		텍스트 또는 바이트를 받아 일반 텍스트 응답을 반환합니다.

		{* ../../docs_src/custom_response/tutorial005_py39.py hl[2,7,9] *}
		{* ../../docs_src/custom_response/tutorial005_py310.py hl[2,7,9] *}

		### `JSONResponse` { #jsonresponse }

Expand DownExpand Up		@@ -180,7 +180,7 @@ FastAPI (실제로는 Starlette)가 자동으로 Content-Length 헤더를 포함

		///

		{* ../../docs_src/custom_response/tutorial001_py39.py hl[2,7] *}
		{* ../../docs_src/custom_response/tutorial001_py310.py hl[2,7] *}

		/// tip \| 팁

Expand All		@@ -194,14 +194,14 @@ HTTP 리디렉션 응답을 반환합니다. 기본적으로 상태 코드는 30

		`RedirectResponse`를 직접 반환할 수 있습니다.

		{* ../../docs_src/custom_response/tutorial006_py39.py hl[2,9] *}
		{* ../../docs_src/custom_response/tutorial006_py310.py hl[2,9] *}

		---

		또는 `response_class` 매개변수에서 사용할 수도 있습니다:


		{* ../../docs_src/custom_response/tutorial006b_py39.py hl[2,7,9] *}
		{* ../../docs_src/custom_response/tutorial006b_py310.py hl[2,7,9] *}

		이 경우, 경로 처리 함수에서 URL을 직접 반환할 수 있습니다.

Expand All		@@ -211,13 +211,13 @@ HTTP 리디렉션 응답을 반환합니다. 기본적으로 상태 코드는 30

		`status_code` 매개변수를 `response_class` 매개변수와 함께 사용할 수도 있습니다:

		{* ../../docs_src/custom_response/tutorial006c_py39.py hl[2,7,9] *}
		{* ../../docs_src/custom_response/tutorial006c_py310.py hl[2,7,9] *}

		### `StreamingResponse` { #streamingresponse }

		비동기 제너레이터 또는 일반 제너레이터/이터레이터를 받아 응답 본문을 스트리밍 합니다.

		{* ../../docs_src/custom_response/tutorial007_py39.py hl[2,14] *}
		{* ../../docs_src/custom_response/tutorial007_py310.py hl[2,14] *}

		#### 파일과 같은 객체를 사용한 `StreamingResponse` { #using-streamingresponse-with-file-like-objects }

Expand All		@@ -227,7 +227,7 @@ HTTP 리디렉션 응답을 반환합니다. 기본적으로 상태 코드는 30

		이 방식은 클라우드 스토리지, 비디오 처리 등의 다양한 라이브러리와 함께 사용할 수 있습니다.

		{* ../../docs_src/custom_response/tutorial008_py39.py hl[2,10:12,14] *}
		{* ../../docs_src/custom_response/tutorial008_py310.py hl[2,10:12,14] *}

		1. 이것이 제너레이터 함수입니다. `yield` 문을 포함하고 있으므로 "제너레이터 함수"입니다.
		2. `with` 블록을 사용함으로써, 제너레이터 함수가 완료된 후 파일과 같은 객체가 닫히도록 합니다. 즉, 응답 전송이 끝난 후 닫힙니다.
Expand DownExpand Up		@@ -256,11 +256,11 @@ HTTP 리디렉션 응답을 반환합니다. 기본적으로 상태 코드는 30

		파일 응답에는 적절한 `Content-Length`, `Last-Modified`, 및 `ETag` 헤더가 포함됩니다.

		{* ../../docs_src/custom_response/tutorial009_py39.py hl[2,10] *}
		{* ../../docs_src/custom_response/tutorial009_py310.py hl[2,10] *}

		또한 `response_class` 매개변수를 사용할 수도 있습니다:

		{* ../../docs_src/custom_response/tutorial009b_py39.py hl[2,8,10] *}
		{* ../../docs_src/custom_response/tutorial009b_py310.py hl[2,8,10] *}

		이 경우, 경로 처리 함수에서 파일 경로를 직접 반환할 수 있습니다.

Expand All		@@ -274,7 +274,7 @@ HTTP 리디렉션 응답을 반환합니다. 기본적으로 상태 코드는 30

		`CustomORJSONResponse`를 생성할 수 있습니다. 여기서 핵심은 `Response.render(content)` 메서드를 생성하여 내용을 `bytes`로 반환하는 것입니다:

		{* ../../docs_src/custom_response/tutorial009c_py39.py hl[9:14,17] *}
		{* ../../docs_src/custom_response/tutorial009c_py310.py hl[9:14,17] *}

		이제 다음 대신:

Expand All		@@ -300,7 +300,7 @@ HTTP 리디렉션 응답을 반환합니다. 기본적으로 상태 코드는 30

		아래 예제에서 FastAPI는 모든 경로 처리에서 기본적으로 `JSONResponse` 대신 `ORJSONResponse`를 사용합니다.

		{* ../../docs_src/custom_response/tutorial010_py39.py hl[2,4] *}
		{* ../../docs_src/custom_response/tutorial010_py310.py hl[2,4] *}

		/// tip \| 팁

Expand Down