Browse Source

✏️ Fix minor typos in `docs/ko/docs/` (#11126)

pull/11130/head
Kani Kim 1 year ago
committed by GitHub
parent
commit
c0df023557
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. 12
      docs/ko/docs/tutorial/background-tasks.md
  2. 2
      docs/ko/docs/tutorial/body-fields.md
  3. 6
      docs/ko/docs/tutorial/body-multiple-params.md
  4. 4
      docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md
  5. 2
      docs/ko/docs/tutorial/dependencies/index.md
  6. 2
      docs/ko/docs/tutorial/first-steps.md
  7. 2
      docs/ko/docs/tutorial/path-operation-configuration.md
  8. 2
      docs/ko/docs/tutorial/query-params-str-validations.md
  9. 2
      docs/ko/docs/tutorial/request-files.md
  10. 2
      docs/ko/docs/tutorial/request-forms-and-files.md
  11. 18
      docs/ko/docs/tutorial/response-model.md
  12. 2
      docs/ko/docs/tutorial/security/get-current-user.md

12
docs/ko/docs/tutorial/background-tasks.md

@ -13,7 +13,7 @@ FastAPI에서는 응답을 반환한 후에 실행할 백그라운드 작업을
## `백그라운드 작업` 사용
먼저 아래와 같이 `BackgroundTasks`를 임포트하고, `BackgroundTasks`_경로 작 함수_ 에서 매개변수로 가져오고 정의합니다.
먼저 아래와 같이 `BackgroundTasks`를 임포트하고, `BackgroundTasks`_경로 작 함수_ 에서 매개변수로 가져오고 정의합니다.
```Python hl_lines="1 13"
{!../../../docs_src/background_tasks/tutorial001.py!}
@ -39,7 +39,7 @@ FastAPI에서는 응답을 반환한 후에 실행할 백그라운드 작업을
## 백그라운드 작업 추가
_경로 작 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _백그라운드 작업_ 개체에 전달합니다.
_경로 작 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _백그라운드 작업_ 개체에 전달합니다.
```Python hl_lines="14"
{!../../../docs_src/background_tasks/tutorial001.py!}
@ -53,7 +53,7 @@ _경로 동작 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _
## 의존성 주입
`BackgroundTasks`를 의존성 주입 시스템과 함께 사용하면 _경로 작 함수_, 종속성, 하위 종속성 등 여러 수준에서 BackgroundTasks 유형의 매개변수를 선언할 수 있습니다.
`BackgroundTasks`를 의존성 주입 시스템과 함께 사용하면 _경로 작 함수_, 종속성, 하위 종속성 등 여러 수준에서 BackgroundTasks 유형의 매개변수를 선언할 수 있습니다.
**FastAPI**는 각 경우에 수행할 작업과 동일한 개체를 내부적으로 재사용하기에, 모든 백그라운드 작업이 함께 병합되고 나중에 백그라운드에서 실행됩니다.
@ -73,7 +73,7 @@ _경로 동작 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _
요청에 쿼리가 있는 경우 백그라운드 작업의 로그에 기록됩니다.
그리고 _경로 작 함수_ 에서 생성된 또 다른 백그라운드 작업은 경로 매개 변수를 활용하여 사용하여 메시지를 작성합니다.
그리고 _경로 작 함수_ 에서 생성된 또 다른 백그라운드 작업은 경로 매개 변수를 활용하여 사용하여 메시지를 작성합니다.
## 기술적 세부사항
@ -81,7 +81,7 @@ _경로 동작 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _
`BackgroundTasks` 클래스는 FastAPI에서 직접 임포트하거나 포함하기 때문에 실수로 `BackgroundTask` (끝에 `s`가 없음)을 임포트하더라도 starlette.background에서 `BackgroundTask`를 가져오는 것을 방지할 수 있습니다.
(`BackgroundTask`가 아닌) `BackgroundTasks`를 사용하면, _경로 작 함수_ 매개변수로 사용할 수 있게 되고 나머지는 **FastAPI**가 대신 처리하도록 할 수 있습니다. 이것은 `Request` 객체를 직접 사용하는 것과 같은 방식입니다.
(`BackgroundTask`가 아닌) `BackgroundTasks`를 사용하면, _경로 작 함수_ 매개변수로 사용할 수 있게 되고 나머지는 **FastAPI**가 대신 처리하도록 할 수 있습니다. 이것은 `Request` 객체를 직접 사용하는 것과 같은 방식입니다.
FastAPI에서 `BackgroundTask`를 단독으로 사용하는 것은 여전히 가능합니다. 하지만 객체를 코드에서 생성하고, 이 객체를 포함하는 Starlette `Response`를 반환해야 합니다.
@ -99,4 +99,4 @@ RabbitMQ 또는 Redis와 같은 메시지/작업 큐 시스템 보다 복잡한
## 요약
백그라운드 작업을 추가하기 위해 _경로 작 함수_ 에 매개변수로 `BackgroundTasks`를 가져오고 사용합니다.
백그라운드 작업을 추가하기 위해 _경로 작 함수_ 에 매개변수로 `BackgroundTasks`를 가져오고 사용합니다.

2
docs/ko/docs/tutorial/body-fields.md

@ -1,6 +1,6 @@
# 본문 - 필드
`Query`, `Path``Body`를 사용해 *경로 작 함수* 매개변수 내에서 추가적인 검증이나 메타데이터를 선언한 것처럼 Pydantic의 `Field`를 사용하여 모델 내에서 검증과 메타데이터를 선언할 수 있습니다.
`Query`, `Path``Body`를 사용해 *경로 작 함수* 매개변수 내에서 추가적인 검증이나 메타데이터를 선언한 것처럼 Pydantic의 `Field`를 사용하여 모델 내에서 검증과 메타데이터를 선언할 수 있습니다.
## `Field` 임포트

6
docs/ko/docs/tutorial/body-multiple-params.md

@ -19,7 +19,7 @@
## 다중 본문 매개변수
이전 예제에서 보듯이, *경로 작*은 아래와 같이 `Item` 속성을 가진 JSON 본문을 예상합니다:
이전 예제에서 보듯이, *경로 작*은 아래와 같이 `Item` 속성을 가진 JSON 본문을 예상합니다:
```JSON
{
@ -161,9 +161,9 @@ item: Item = Body(..., embed=True)
## 정리
요청이 단 한개의 본문을 가지고 있더라도, *경로 작 함수*로 다중 본문 매개변수를 추가할 수 있습니다.
요청이 단 한개의 본문을 가지고 있더라도, *경로 작 함수*로 다중 본문 매개변수를 추가할 수 있습니다.
하지만, **FastAPI**는 이를 처리하고, 함수에 올바른 데이터를 제공하며, *경로*으로 올바른 스키마를 검증하고 문서화 합니다.
하지만, **FastAPI**는 이를 처리하고, 함수에 올바른 데이터를 제공하며, *경로 동*으로 올바른 스키마를 검증하고 문서화 합니다.
또한, 단일 값을 본문의 일부로 받도록 선언할 수 있습니다.

4
docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md

@ -71,9 +71,9 @@ fluffy = Cat(name="Mr Fluffy")
FastAPI가 실질적으로 확인하는 것은 "호출 가능성"(함수, 클래스 또는 다른 모든 것)과 정의된 매개변수들입니다.
"호출 가능"한 것을 의존성으로서 **FastAPI**에 전달하면, 그 "호출 가능"한 것의 매개변수들을 분석한 후 이를 *경로 작 함수*를 위한 매개변수와 동일한 방식으로 처리합니다. 하위-의존성 또한 같은 방식으로 처리합니다.
"호출 가능"한 것을 의존성으로서 **FastAPI**에 전달하면, 그 "호출 가능"한 것의 매개변수들을 분석한 후 이를 *경로 작 함수*를 위한 매개변수와 동일한 방식으로 처리합니다. 하위-의존성 또한 같은 방식으로 처리합니다.
매개변수가 없는 "호출 가능"한 것 역시 매개변수가 없는 *경로 작 함수*와 동일한 방식으로 적용됩니다.
매개변수가 없는 "호출 가능"한 것 역시 매개변수가 없는 *경로 작 함수*와 동일한 방식으로 적용됩니다.
그래서, 우리는 위 예제에서의 `common_paramenters` 의존성을 클래스 `CommonQueryParams`로 바꿀 수 있습니다.

2
docs/ko/docs/tutorial/dependencies/index.md

@ -6,7 +6,7 @@
## "의존성 주입"은 무엇입니까?
**"의존성 주입"**은 프로그래밍에서 여러분의 코드(이 경우, 경로 작 함수)가 작동하고 사용하는 데 필요로 하는 것, 즉 "의존성"을 선언할 수 있는 방법을 의미합니다.
**"의존성 주입"**은 프로그래밍에서 여러분의 코드(이 경우, 경로 작 함수)가 작동하고 사용하는 데 필요로 하는 것, 즉 "의존성"을 선언할 수 있는 방법을 의미합니다.
그 후에, 시스템(이 경우 FastAPI)은 여러분의 코드가 요구하는 의존성을 제공하기 위해 필요한 모든 작업을 처리합니다.(의존성을 "주입"합니다)

2
docs/ko/docs/tutorial/first-steps.md

@ -309,7 +309,7 @@ URL "`/`"에 대한 `GET` 작동을 사용하는 요청을 받을 때마다 **Fa
{!../../../docs_src/first_steps/tutorial003.py!}
```
!!! note 참고
!!! note "참고"
차이점을 모르겠다면 [Async: *"In a hurry?"*](../async.md#in-a-hurry){.internal-link target=_blank}을 확인하세요.
### 5 단계: 콘텐츠 반환

2
docs/ko/docs/tutorial/path-operation-configuration.md

@ -1,4 +1,4 @@
# 경로 작 설정
# 경로 작 설정
*경로 작동 데코레이터*를 설정하기 위해서 전달할수 있는 몇 가지 매개변수가 있습니다.

2
docs/ko/docs/tutorial/query-params-str-validations.md

@ -74,7 +74,7 @@ q: Optional[str] = None
q: str = Query(None, max_length=50)
```
이는 데이터를 검증할 것이고, 데이터가 유효하지 않다면 명백한 오류를 보여주며, OpenAPI 스키마 *경로 작*에 매개변수를 문서화 합니다.
이는 데이터를 검증할 것이고, 데이터가 유효하지 않다면 명백한 오류를 보여주며, OpenAPI 스키마 *경로 작*에 매개변수를 문서화 합니다.
## 검증 추가

2
docs/ko/docs/tutorial/request-files.md

@ -108,7 +108,7 @@ HTML의 폼들(`<form></form>`)이 서버에 데이터를 전송하는 방식은
인코딩과 폼 필드에 대해 더 알고싶다면, <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank"><code>POST</code>에 관한<abbr title="Mozilla Developer Network">MDN</abbr>웹 문서</a> 를 참고하기 바랍니다,.
!!! warning "주의"
!!! warning "경고"
다수의 `File``Form` 매개변수를 한 *경로 작동*에 선언하는 것이 가능하지만, 요청의 본문이 `application/json` 가 아닌 `multipart/form-data` 로 인코딩 되기 때문에 JSON으로 받아야하는 `Body` 필드를 함께 선언할 수는 없습니다.
이는 **FastAPI**의 한계가 아니라, HTTP 프로토콜에 의한 것입니다.

2
docs/ko/docs/tutorial/request-forms-and-files.md

@ -25,7 +25,7 @@
어떤 파일들은 `bytes`로, 또 어떤 파일들은 `UploadFile`로 선언할 수 있습니다.
!!! warning "주의"
!!! warning "경고"
다수의 `File``Form` 매개변수를 한 *경로 작동*에 선언하는 것이 가능하지만, 요청의 본문이 `application/json`가 아닌 `multipart/form-data`로 인코딩 되기 때문에 JSON으로 받아야하는 `Body` 필드를 함께 선언할 수는 없습니다.
이는 **FastAPI**의 한계가 아니라, HTTP 프로토콜에 의한 것입니다.

18
docs/ko/docs/tutorial/response-model.md

@ -1,6 +1,6 @@
# 응답 모델
어떤 *경로 작*이든 매개변수 `response_model`를 사용하여 응답을 위한 모델을 선언할 수 있습니다:
어떤 *경로 작*이든 매개변수 `response_model`를 사용하여 응답을 위한 모델을 선언할 수 있습니다:
* `@app.get()`
* `@app.post()`
@ -13,7 +13,7 @@
```
!!! note "참고"
`response_model`은 "데코레이터" 메소드(`get`, `post`, 등)의 매개변수입니다. 모든 매개변수들과 본문(body)처럼 *경로 작 함수*가 아닙니다.
`response_model`은 "데코레이터" 메소드(`get`, `post`, 등)의 매개변수입니다. 모든 매개변수들과 본문(body)처럼 *경로 작 함수*가 아닙니다.
Pydantic 모델 어트리뷰트를 선언한 것과 동일한 타입을 수신하므로 Pydantic 모델이 될 수 있지만, `List[Item]`과 같이 Pydantic 모델들의 `list`일 수도 있습니다.
@ -21,7 +21,7 @@ FastAPI는 이 `response_model`를 사용하여:
* 출력 데이터를 타입 선언으로 변환.
* 데이터 검증.
* OpenAPI *경로 작*의 응답에 JSON 스키마 추가.
* OpenAPI *경로 작*의 응답에 JSON 스키마 추가.
* 자동 생성 문서 시스템에 사용.
하지만 가장 중요한 것은:
@ -49,7 +49,7 @@ FastAPI는 이 `response_model`를 사용하여:
이 경우, 사용자가 스스로 비밀번호를 발신했기 때문에 문제가 되지 않을 수 있습니다.
그러나 동일한 모델을 다른 *경로 작*에서 사용할 경우, 모든 클라이언트에게 사용자의 비밀번호를 발신할 수 있습니다.
그러나 동일한 모델을 다른 *경로 작*에서 사용할 경우, 모든 클라이언트에게 사용자의 비밀번호를 발신할 수 있습니다.
!!! danger "위험"
절대로 사용자의 평문 비밀번호를 저장하거나 응답으로 발신하지 마십시오.
@ -62,7 +62,7 @@ FastAPI는 이 `response_model`를 사용하여:
{!../../../docs_src/response_model/tutorial003.py!}
```
여기서 *경로 작 함수*가 비밀번호를 포함하는 동일한 입력 사용자를 반환할지라도:
여기서 *경로 작 함수*가 비밀번호를 포함하는 동일한 입력 사용자를 반환할지라도:
```Python hl_lines="24"
{!../../../docs_src/response_model/tutorial003.py!}
@ -104,7 +104,7 @@ FastAPI는 이 `response_model`를 사용하여:
### `response_model_exclude_unset` 매개변수 사용
*경로 작 데코레이터* 매개변수를 `response_model_exclude_unset=True`로 설정 할 수 있습니다:
*경로 작 데코레이터* 매개변수를 `response_model_exclude_unset=True`로 설정 할 수 있습니다:
```Python hl_lines="24"
{!../../../docs_src/response_model/tutorial004.py!}
@ -112,7 +112,7 @@ FastAPI는 이 `response_model`를 사용하여:
이러한 기본값은 응답에 포함되지 않고 실제로 설정된 값만 포함됩니다.
따라서 해당 *경로 작*에 ID가 `foo`인 항목(items)을 요청으로 보내면 (기본값을 제외한) 응답은 다음과 같습니다:
따라서 해당 *경로 작*에 ID가 `foo`인 항목(items)을 요청으로 보내면 (기본값을 제외한) 응답은 다음과 같습니다:
```JSON
{
@ -173,7 +173,7 @@ ID가 `baz`인 항목(items)처럼 기본값과 동일한 값을 갖는다면:
### `response_model_include``response_model_exclude`
*경로 작 데코레이터* 매개변수 `response_model_include``response_model_exclude`를 사용할 수 있습니다.
*경로 작 데코레이터* 매개변수 `response_model_include``response_model_exclude`를 사용할 수 있습니다.
이들은 포함(나머지 생략)하거나 제외(나머지 포함) 할 어트리뷰트의 이름과 `str``set`을 받습니다.
@ -205,6 +205,6 @@ Pydantic 모델이 하나만 있고 출력에서 ​​일부 데이터를 제
## 요약
응답 모델을 정의하고 개인정보가 필터되는 것을 보장하기 위해 *경로 작 데코레이터*의 매개변수 `response_model`을 사용하세요.
응답 모델을 정의하고 개인정보가 필터되는 것을 보장하기 위해 *경로 작 데코레이터*의 매개변수 `response_model`을 사용하세요.
명시적으로 설정된 값만 반환하려면 `response_model_exclude_unset`을 사용하세요.

2
docs/ko/docs/tutorial/security/get-current-user.md

@ -36,7 +36,7 @@ Pydantic을 사용하여 본문을 선언하는 것과 같은 방식으로 다
`get_current_user`는 이전에 생성한 것과 동일한 `oauth2_scheme`과 종속성을 갖게 됩니다.
이전에 *경로 작*에서 직접 수행했던 것과 동일하게 새 종속성 `get_current_user`는 하위 종속성 `oauth2_scheme`에서 `str``token`을 수신합니다.
이전에 *경로 작*에서 직접 수행했던 것과 동일하게 새 종속성 `get_current_user`는 하위 종속성 `oauth2_scheme`에서 `str``token`을 수신합니다.
=== "파이썬 3.7 이상"

Loading…
Cancel
Save