-
-
Notifications
You must be signed in to change notification settings - Fork 6.1k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
π Add Korean translation for Tutorial - Path Parameters and Numeric Vβ¦
β¦alidations (#2432)
- Loading branch information
1 parent
8e41687
commit a5d697b
Showing
2 changed files
with
123 additions
and
0 deletions.
There are no files selected for viewing
122 changes: 122 additions & 0 deletions
122
docs/ko/docs/tutorial/path-params-numeric-validations.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,122 @@ | ||
# κ²½λ‘ λ§€κ°λ³μμ μ«μ κ²μ¦ | ||
|
||
`Query`λ₯Ό μ¬μ©νμ¬ μΏΌλ¦¬ 맀κ°λ³μμ λ λ§μ κ²μ¦κ³Ό λ©νλ°μ΄ν°λ₯Ό μ μΈνλ λ°©λ²κ³Ό λμΌνκ² `Path`λ₯Ό μ¬μ©νμ¬ κ²½λ‘ λ§€κ°λ³μμ κ²μ¦κ³Ό λ©νλ°μ΄ν°λ₯Ό κ°μ νμ μΌλ‘ μ μΈν μ μμ΅λλ€. | ||
|
||
## κ²½λ‘ μν¬νΈ | ||
|
||
λ¨Όμ `fastapi`μμ `Path`λ₯Ό μν¬νΈν©λλ€: | ||
|
||
```Python hl_lines="3" | ||
{!../../../docs_src/path_params_numeric_validations/tutorial001.py!} | ||
``` | ||
|
||
## λ©νλ°μ΄ν° μ μΈ | ||
|
||
`Query`μ λμΌν 맀κ°λ³μλ₯Ό μ μΈν μ μμ΅λλ€. | ||
|
||
μλ₯Ό λ€μ΄, `title` λ©νλ°μ΄ν° κ°μ κ²½λ‘ λ§€κ°λ³μ `item_id`μ μ μΈνλ €λ©΄ λ€μκ³Ό κ°μ΄ μ λ ₯ν μ μμ΅λλ€: | ||
|
||
```Python hl_lines="10" | ||
{!../../../docs_src/path_params_numeric_validations/tutorial001.py!} | ||
``` | ||
|
||
!!! note "μ°Έκ³ " | ||
κ²½λ‘ λ§€κ°λ³μλ κ²½λ‘μ μΌλΆμ¬μΌ νλ―λ‘ μΈμ λ νμμ μ λλ€. | ||
|
||
μ¦, `...`λ‘ μ μΈν΄μ νμμμ λνλ΄λκ² μ’μ΅λλ€. | ||
|
||
κ·ΈλΌμλ `None`μΌλ‘ μ μΈνκ±°λ κΈ°λ³Έκ°μ μ§μ ν μ§λΌλ μ무 μν₯μ λΌμΉμ§ μμΌλ©° μΈμ λ νμμ λλ€. | ||
|
||
## νμν κ²½μ° λ§€κ°λ³μ μ λ ¬νκΈ° | ||
|
||
`str` νμΈ μΏΌλ¦¬ 맀κ°λ³μ `q`λ₯Ό νμλ‘ μ μΈνκ³ μΆλ€κ³ ν΄λ΄ μλ€. | ||
|
||
ν΄λΉ 맀κ°λ³μμ λν΄ μλ¬΄λ° μ μΈμ ν νμκ° μμΌλ―λ‘ `Query`λ₯Ό μ λ§λ‘ μ¨μΌν νμλ μμ΅λλ€. | ||
|
||
νμ§λ§ `item_id` κ²½λ‘ λ§€κ°λ³μλ μ¬μ ν `Path`λ₯Ό μ¬μ©ν΄μΌ ν©λλ€. | ||
|
||
νμ΄μ¬μ "κΈ°λ³Έκ°"μ΄ μλ κ° μμ "κΈ°λ³Έκ°"μ΄ μλ κ°μ μ λ ₯νλ©΄ λΆνν©λλ€. | ||
|
||
κ·Έλ¬λ 맀κ°λ³μλ€μ μ¬μ λ ¬ν¨μΌλ‘μ¨ κΈ°λ³Έκ°(쿼리 맀κ°λ³μ `q`)μ΄ μλ κ°μ μ²μ λΆλΆμ μμΉ ν μ μμ΅λλ€. | ||
|
||
**FastAPI**μμλ μ€μνμ§ μμ΅λλ€. μ΄λ¦, νμ κ·Έλ¦¬κ³ μ μΈκ΅¬(`Query`, `Path` λ±)λ‘ λ§€κ°λ³μλ₯Ό κ°μ§νλ©° μμλ μ κ²½ μ°μ§ μμ΅λλ€. | ||
|
||
λ°λΌμ ν¨μλ₯Ό λ€μκ³Ό κ°μ΄ μ μΈ ν μ μμ΅λλ€: | ||
|
||
```Python hl_lines="8" | ||
{!../../../docs_src/path_params_numeric_validations/tutorial002.py!} | ||
``` | ||
|
||
## νμν κ²½μ° λ§€κ°λ³μ μ λ ¬νκΈ°, νΈλ¦ | ||
|
||
`Query`λ μλ¬΄λ° κΈ°λ³Έκ°μΌλ‘λ `q` κ²½λ‘ λ§€κ°λ³μλ₯Ό μ μΈνκ³ μΆμ§ μμ§λ§ `Path`λ₯Ό μ¬μ©νμ¬ κ²½λ‘ λ§€κ°λ³μλ₯Ό `item_id` λ€λ₯Έ μμλ‘ μ μΈνκ³ μΆλ€λ©΄, νμ΄μ¬μ μ΄λ₯Ό μν μκ³ νΉλ³ν λ¬Έλ²μ΄ μμ΅λλ€. | ||
|
||
`*`λ₯Ό ν¨μμ 첫 λ²μ§Έ 맀κ°λ³μλ‘ μ λ¬νμΈμ. | ||
|
||
νμ΄μ¬μ `*`μΌλ‘ μλ¬΄λ° νλλ νμ§ μμ§λ§, λ°λ₯΄λ 맀κ°λ³μλ€μ <abbr title="μ λ: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>λ‘λ μλ €μ§ ν€μλ μΈμ(ν€-κ° μ)μ¬μΌ ν¨μ μΈμ§ν©λλ€. κΈ°λ³Έκ°μ κ°μ§κ³ μμ§ μλλΌλ κ·Έλ μ΅λλ€. | ||
|
||
```Python hl_lines="8" | ||
{!../../../docs_src/path_params_numeric_validations/tutorial003.py!} | ||
``` | ||
|
||
## μ«μ κ²μ¦: ν¬κ±°λ κ°μ | ||
|
||
`Query`μ `Path`(λμ€μ λ³Ό λ€λ₯Έ κ²λ€λ)λ₯Ό μ¬μ©νμ¬ λ¬Έμμ΄ λΏλ§ μλλΌ μ«μμ μ μ½μ μ μΈν μ μμ΅λλ€. | ||
|
||
μ¬κΈ°μ `ge=1`μΈ κ²½μ°, `item_id`λ `1`λ³΄λ€ "ν¬κ±°λ(`g`reater) κ°μ(`e`qual)" μ μν μ«μμ¬μΌ ν©λλ€. | ||
|
||
```Python hl_lines="8" | ||
{!../../../docs_src/path_params_numeric_validations/tutorial004.py!} | ||
``` | ||
|
||
## μ«μ κ²μ¦: ν¬κ±°λ κ°μ λ° μκ±°λ κ°μ | ||
|
||
λμΌνκ² μ μ©λ©λλ€: | ||
|
||
* `gt`: ν¬κ±°λ(`g`reater `t`han) | ||
* `le`: μκ±°λ κ°μ(`l`ess than or `e`qual) | ||
|
||
```Python hl_lines="9" | ||
{!../../../docs_src/path_params_numeric_validations/tutorial005.py!} | ||
``` | ||
|
||
## μ«μ κ²μ¦: λΆλμμ, ν¬κ±°λ λ° μκ±°λ | ||
|
||
μ«μ κ²μ¦μ `float` κ°μλ λμν©λλ€. | ||
|
||
μ¬κΈ°μμ <abbr title="greater than or equal"><code>ge</code></abbr>λΏλ§ μλλΌ <abbr title="greater than"><code>gt</code></abbr>λ₯Ό μ μΈ ν μμλ κ²μ΄ μ€μν΄μ§λλ€. μλ₯Ό λ€μ΄ νμν κ²½μ°, κ°μ΄ `1`λ³΄λ€ μλλΌλ λ°λμ `0`λ³΄λ€ μ»€μΌν©λλ€. | ||
|
||
μ¦, `0.5`λ μ ν¨ν κ°μ λλ€. κ·Έλ¬λ `0.0` λλ `0`μ κ·Έλ μ§ μμ΅λλ€. | ||
|
||
<abbr title="less than"><code>lt</code></abbr> μμ λ§μ°¬κ°μ§μ λλ€. | ||
|
||
```Python hl_lines="11" | ||
{!../../../docs_src/path_params_numeric_validations/tutorial006.py!} | ||
``` | ||
|
||
## μμ½ | ||
|
||
`Query`, `Path`(μμ§ λ³΄μ§ λͺ»ν λ€λ₯Έ κ²λ€λ)λ₯Ό μ¬μ©νλ©΄ [쿼리 맀κ°λ³μμ λ¬Έμμ΄ κ²μ¦](query-params-str-validations.md){.internal-link target=_blank}μμμ λ§μ°¬κ°μ§λ‘ λ©νλ°μ΄ν°μ λ¬Έμμ΄ κ²μ¦μ μ μΈν μ μμ΅λλ€. | ||
|
||
κ·Έλ¦¬κ³ μ«μ κ²μ¦ λν μ μΈν μ μμ΅λλ€: | ||
|
||
* `gt`: ν¬κ±°λ(`g`reater `t`han) | ||
* `ge`: ν¬κ±°λ κ°μ(`g`reater than or `e`qual) | ||
* `lt`: μκ±°λ(`l`ess `t`han) | ||
* `le`: μκ±°λ κ°μ(`l`ess than or `e`qual) | ||
|
||
!!! info "μ 보" | ||
`Query`, `Path`, κ·Έλ¦¬κ³ λμ€μκ² λ³΄κ²λ κ²λ€μ (μ¬λ¬λΆμ΄ μ¬μ©ν νμκ° μλ) κ³΅ν΅ `Param` ν΄λμ€μ μλΈ ν΄λμ€μ λλ€. | ||
|
||
κ·Έλ¦¬κ³ μ΄λ€ λͺ¨λλ μ¬νκΉμ§ λ³Έ μΆκ° κ²μ¦κ³Ό λ©νλ°μ΄ν°μ λμΌν λͺ¨λ 맀κ°λ³μλ₯Ό 곡μ ν©λλ€. | ||
|
||
!!! note "κΈ°μ μΈλΆμ¬ν" | ||
`fastapi`μμ `Query`, `Path` λ±μ μν¬νΈ ν λ, μ΄κ²λ€μ μ€μ λ‘ ν¨μμ λλ€. | ||
|
||
νΈμΆλλ©΄ λμΌν μ΄λ¦μ ν΄λμ€μ μΈμ€ν΄μ€λ₯Ό λ°νν©λλ€. | ||
|
||
μ¦, ν¨μμΈ `Query`λ₯Ό μν¬νΈν κ²λλ€. κ·Έλ¦¬κ³ νΈμΆνλ©΄ `Query`λΌλ μ΄λ¦μ κ°μ§ ν΄λμ€μ μΈμ€ν΄μ€λ₯Ό λ°νν©λλ€. | ||
|
||
νΈμ§κΈ°μμ νμ μ λν μ€λ₯λ₯Ό νμνμ§ μλλ‘ νκΈ° μν΄ (ν΄λμ€λ₯Ό μ§μ μ¬μ©νλ λμ ) μ΄λ¬ν ν¨μλ€μ΄ μμ΅λλ€. | ||
|
||
μ΄λ κ² νλ©΄ μ€λ₯λ₯Ό 무μνκΈ° μν μ¬μ©μ μ€μ μ μΆκ°νμ§ μκ³ λ μΌλ° νΈμ§κΈ°μ μ½λ© λꡬλ₯Ό μ¬μ©ν μ μμ΅λλ€. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters