committed by
GitHub
1 changed files with 197 additions and 90 deletions
@ -1,162 +1,269 @@ |
|||
* # FastAPI ์ง์ - ๋์๋ง ๋ฐ๊ธฐ |
|||
# FastAPI ์ง์ - ๋์ ๋ฐ๊ธฐ |
|||
|
|||
**FastAPI** ๊ฐ ๋ง์์ ๋์๋์? |
|||
**FastAPI** ๊ฐ ๋ง์์ ๋์๋์? |
|||
|
|||
FastAPI, ๋ค๋ฅธ ์ฌ์ฉ์, ๊ฐ๋ฐ์๋ฅผ ์์ํ๊ณ ์ถ์ผ์ ๊ฐ์? |
|||
FastAPI, ๋ค๋ฅธ ์ฌ์ฉ์, ๊ฐ๋ฐ์๋ฅผ ์์ํ๊ณ ์ถ์ผ์ ๊ฐ์? |
|||
|
|||
ํน์ **FastAPI** ์ ๋ํด ๋์์ด ํ์ํ์ ๊ฐ์? |
|||
ํน์ **FastAPI** ์ ๋ํด ๋์์ด ํ์ํ์ ๊ฐ์? |
|||
|
|||
์์ฃผ ๊ฐ๋จํ๊ฒ ์์ํ ์ ์์ต๋๋ค (๋ช ๋ฒ์ ํด๋ฆญ๋ง์ผ๋ก). |
|||
์์ฃผ ๊ฐ๋จํ๊ฒ ์์ํ ์ ์์ต๋๋ค (๋ช ๋ฒ์ ํด๋ฆญ๋ง์ผ๋ก). |
|||
|
|||
๋ํ ๋์์ ๋ฐ์ ์ ์๋ ๋ฐฉ๋ฒ๋ ๋ช ๊ฐ์ง ์์ต๋๋ค. |
|||
๋ํ ๋์์ ๋ฐ์ ์ ์๋ ๋ฐฉ๋ฒ๋ ๋ช ๊ฐ์ง ์์ต๋๋ค. |
|||
|
|||
## ๋ด์ค๋ ํฐ ๊ตฌ๋
|
|||
## ๋ด์ค๋ ํฐ ๊ตฌ๋
|
|||
|
|||
[**FastAPI์ ์น๊ตฌ** ๋ด์ค๋ ํฐ](https://github.com/fastapi/fastapi/blob/master/newsletter)๋ฅผ ๊ตฌ๋
ํ์ฌ ์ต์ ์ ๋ณด๋ฅผ ์ ์งํ ์ ์์ต๋๋ค{.internal-link target=_blank}: |
|||
[**FastAPI and friends** ๋ด์ค๋ ํฐ](newsletter.md){.internal-link target=\_blank}๋ฅผ ๊ตฌ๋
ํ์ฌ ์ต์ ์ ๋ณด๋ฅผ ์ ์งํ ์ ์์ต๋๋ค: |
|||
|
|||
- FastAPI ์ ๊ทธ ์น๊ตฌ๋ค์ ๋ํ ๋ด์ค ๐ |
|||
- ๊ฐ์ด๋ ๐ |
|||
- ํน์ง โจ |
|||
- ํ๊ธฐ์ ์ธ ๋ณํ ๐จ |
|||
- ํ๊ณผ ์๋ น โ
|
|||
* FastAPI and friends์ ๋ํ ๋ด์ค ๐ |
|||
* ๊ฐ์ด๋ ๐ |
|||
* ๊ธฐ๋ฅ โจ |
|||
* ํ๊ธฐ์ ์ธ ๋ณํ ๐จ |
|||
* ํ๊ณผ ์๋ น โ
|
|||
|
|||
## ํธ์ํฐ์์ FastAPI ํ๋ก์ฐํ๊ธฐ |
|||
## ํธ์ํฐ์์ FastAPI ํ๋ก์ฐํ๊ธฐ |
|||
|
|||
[Follow @fastapi on **Twitter**](https://twitter.com/fastapi) ๋ฅผ ํ๋ก์ฐํ์ฌ **FastAPI** ์ ๋ํ ์ต์ ๋ด์ค๋ฅผ ์ป์ ์ ์์ต๋๋ค. ๐ฆ |
|||
<a href="https://twitter.com/fastapi" class="external-link" target="_blank">**Twitter**์ @fastapi๋ฅผ ํ๋ก์ฐ</a>ํ์ฌ **FastAPI** ์ ๋ํ ์ต์ ๋ด์ค๋ฅผ ์ป์ ์ ์์ต๋๋ค. ๐ฆ |
|||
|
|||
## Star **FastAPI** in GitHub |
|||
## Star **FastAPI** in GitHub |
|||
|
|||
GitHub์์ FastAPI์ "star"๋ฅผ ๋ถ์ผ ์ ์์ต๋๋ค(์ค๋ฅธ์ชฝ ์๋จ์ star ๋ฒํผ์ ํด๋ฆญ): https://github.com/fastapi/fastapi. โญ๏ธ |
|||
GitHub์์ FastAPI์ "star"๋ฅผ ๋ถ์ผ ์ ์์ต๋๋ค (์ค๋ฅธ์ชฝ ์๋จ์ star ๋ฒํผ์ ํด๋ฆญ): <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">https://github.com/fastapi/fastapi</a>. โญ๏ธ |
|||
|
|||
์คํ๋ฅผ ๋๋ฆผ์ผ๋ก์จ, ๋ค๋ฅธ ์ฌ์ฉ์๋ค์ด ์ข ๋ ์ฝ๊ฒ ์ฐพ์ ์ ์๊ณ , ๋ง์ ์ฌ๋๋ค์๊ฒ ์ ์ฉํ ๊ฒ์์ ๋ํ๋ผ ์ ์์ต๋๋ค. |
|||
์คํ๋ฅผ ๋๋ฆผ์ผ๋ก์จ, ๋ค๋ฅธ ์ฌ์ฉ์๋ค์ด ์ข ๋ ์ฝ๊ฒ ์ฐพ์ ์ ์๊ณ , ๋ง์ ์ฌ๋๋ค์๊ฒ ์ ์ฉํ ๊ฒ์์ ๋ํ๋ผ ์ ์์ต๋๋ค. |
|||
|
|||
## GitHub ์ ์ฅ์์์ ๋ฆด๋ฆฌ์ฆ ํ์ธ |
|||
## GitHub ์ ์ฅ์์์ ๋ฆด๋ฆฌ์ฆ ํ์ธ |
|||
|
|||
GitHub์์ FastAPI๋ฅผ "watch"ํ ์ ์์ต๋๋ค (์ค๋ฅธ์ชฝ ์๋จ watch ๋ฒํผ์ ํด๋ฆญ): https://github.com/fastapi/fastapi. ๐ |
|||
GitHub์์ FastAPI๋ฅผ "watch"ํ ์ ์์ต๋๋ค (์ค๋ฅธ์ชฝ ์๋จ watch ๋ฒํผ์ ํด๋ฆญ): <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">https://github.com/fastapi/fastapi</a>. ๐ |
|||
|
|||
์ฌ๊ธฐ์ "Releases only"์ ์ ํํ ์ ์์ต๋๋ค. |
|||
์ฌ๊ธฐ์ "Releases only"์ ์ ํํ ์ ์์ต๋๋ค. |
|||
|
|||
์ด๋ ๊ฒํ๋ฉด, **FastAPI** ์ ๋ฒ๊ทธ ์์ ๋ฐ ์๋ก์ด ๊ธฐ๋ฅ์ ๊ตฌํ ๋ฑ์ ์๋ก์ด ์๋ฃ (์ต์ ๋ฒ์ )์ด ์์ ๋๋ง๋ค (์ด๋ฉ์ผ) ํต์ง๋ฅผ ๋ฐ์ ์ ์์ต๋๋ค. |
|||
์ด๋ ๊ฒํ๋ฉด, **FastAPI** ์ ๋ฒ๊ทธ ์์ ๋ฐ ์๋ก์ด ๊ธฐ๋ฅ์ ๊ตฌํ ๋ฑ์ ์๋ก์ด ์๋ฃ (์ต์ ๋ฒ์ )์ด ์์ ๋๋ง๋ค (์ด๋ฉ์ผ) ํต์ง๋ฅผ ๋ฐ์ ์ ์์ต๋๋ค. |
|||
|
|||
## ๊ฐ๋ฐ์์์ ์ฐ๊ฒฐ |
|||
## ๊ฐ๋ฐ์์์ ์ฐ๊ฒฐ |
|||
|
|||
๊ฐ๋ฐ์์ธ [me (Sebastiรกn Ramรญrez / `tiangolo`)](https://tiangolo.com/) ์ ์ฐ๋ฝ์ ์ทจํ ์ ์์ต๋๋ค. |
|||
<a href="https://tiangolo.com" class="external-link" target="_blank">๊ฐ๋ฐ์(Sebastiรกn Ramรญrez / `tiangolo`)</a>์ ์ฐ๋ฝ์ ์ทจํ ์ ์์ต๋๋ค. |
|||
|
|||
์ฌ๋ฌ๋ถ์ ํ ์ ์์ต๋๋ค: |
|||
์ฌ๋ฌ๋ถ์ ํ ์ ์์ต๋๋ค: |
|||
|
|||
- [**GitHub**์์ ํ๋ก์ฐํ๊ธฐ](https://github.com/tiangolo). |
|||
- ๋น์ ์๊ฒ ๋์์ด ๋ ์ ์ ๋ค๋ฅธ ์คํ์์ค ํ๋ก์ ํธ๋ฅผ ํ์ธํ์ญ์์ค. |
|||
- ์๋ก์ด ์คํ์์ค ํ๋ก์ ํธ๋ฅผ ๋ง๋ค์์ ๋ ํ์ธํ๋ ค๋ฉด ํ๋ก์ฐ ํ์ญ์์ค. |
|||
* <a href="https://github.com/tiangolo" class="external-link" target="_blank">**GitHub**์์ ํ๋ก์ฐํ๊ธฐ.</a>. |
|||
* ๋น์ ์๊ฒ ๋์์ด ๋ ์ ์ ๋ค๋ฅธ ์คํ์์ค ํ๋ก์ ํธ๋ฅผ ํ์ธํ์ญ์์ค. |
|||
* ์๋ก์ด ์คํ์์ค ํ๋ก์ ํธ๋ฅผ ๋ง๋ค์์ ๋ ํ์ธํ๋ ค๋ฉด ํ๋ก์ฐ ํ์ญ์์ค. |
|||
* <a href="https://twitter.com/tiangolo" class="external-link" target="_blank">**Twitter**</a> ๋๋ <a href="https://fosstodon.org/@tiangolo" class="external-link" target="_blank">Mastodon</a>์์ ํ๋ก์ฐํ๊ธฐ. |
|||
* FastAPI์ ์ฌ์ฉ ์ฉ๋๋ฅผ ์๋ ค์ฃผ์ธ์ (๊ทธ๊ฒ์ ๋ฃ๋ ๊ฒ์ ์ข์ํฉ๋๋ค). |
|||
* ๋ฐํ๋ ์๋ก์ด ํด ์ถ์ ์์์ ๋ฐ์๋ณด์ญ์์ค. |
|||
* <a href="https://twitter.com/fastapi" class="external-link" target="_blank">**Twitter**์ @fastapi๋ฅผ ํ๋ก์ฐ</a> (๋ณ๋ ๊ณ์ ์์) ํ ์ ์์ต๋๋ค. |
|||
* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">**LinkedIn**์์ ํ๋ก์ฐํ๊ธฐ.</a>. |
|||
* ์๋ก์ด ํด์ ๋ฐํ๋ ์ถ์ ์์์ ๋ฐ์๋ณด์ญ์์ค. (๋จ, Twitter๋ฅผ ๋ ์์ฃผ ์ฌ์ฉํฉ๋๋ค ๐คทโโ). |
|||
* <a href="https://dev.to/tiangolo" class="external-link" target="_blank">**Dev.to**</a> ๋๋ <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a>์์ ์ ๊ฐ ์์ฑํ ๋ด์ฉ์ ์ฝ์ด ๋ณด์ญ์์ค (๋๋ ํ๋ก์ฐ). |
|||
* ๋ค๋ฅธ ๊ธฐ์ฌ๋ ์์ด๋์ด๋ค์ ์ฝ๊ณ , ์ ๊ฐ ๋ง๋ค์ด์๋ ํด์ ๋ํด์๋ ์ฝ์ผ์ญ์์ค. |
|||
* ์๋ก์ด ๊ธฐ์ฌ๋ฅผ ์ฝ๊ธฐ ์ํด ํ๋ก์ฐ ํ์ญ์์ค. |
|||
|
|||
- [**Twitter**์์ ํ๋ก์ฐํ๊ธฐ](https://twitter.com/tiangolo). |
|||
- FastAPI์ ์ฌ์ฉ ์ฉ๋๋ฅผ ์๋ ค์ฃผ์ธ์ (๊ทธ๊ฒ์ ๋ฃ๋ ๊ฒ์ ์ข์ํฉ๋๋ค). |
|||
- ๋ฐํ ๋๋ ์๋ก์ด ํด ์ถ์ํ ๋ ๋ค์ผ์ญ์์ค. |
|||
- [follow @fastapi on Twitter](https://twitter.com/fastapi) (๋ณ๋ ๊ณ์ ์์) ํ ์ ์์ต๋๋ค. |
|||
## **FastAPI**์ ๋ํ ํธ์ |
|||
|
|||
- [**Linkedin**์์์ ์ฐ๊ฒฐ](https://www.linkedin.com/in/tiangolo/). |
|||
- ์๋ก์ด ํด์ ๋ฐํ๋ ๋ฆด๋ฆฌ์ค๋ฅผ ๋ค์ ์ ์์ต๋๋ค (๋จ, Twitter๋ฅผ ๋ ์์ฃผ ์ฌ์ฉํฉ๋๋ค ๐คทโโ). |
|||
<a href="https://twitter.com/compose/tweet?text=I'm loving @fastapi because... https://github.com/fastapi/fastapi" class="external-link" target="_blank">**FastAPI**์ ๋ํด ํธ์</a> ํ๊ณ FastAPI๊ฐ ๋ง์์ ๋๋ ์ด์ ๋ฅผ ์๋ ค์ฃผ์ธ์. ๐ |
|||
|
|||
- [**Dev.to**](https://dev.to/tiangolo) ๋๋ [**Medium**](https://medium.com/@tiangolo)์์ ์ ๊ฐ ์์ฑํ ๋ด์ฉ์ ์ฝ์ด ๋ณด์ญ์์ค(๋๋ ํ๋ก์ฐ). |
|||
- ๋ค๋ฅธ ๊ธฐ์ฌ๋ ์์ด๋์ด๋ค์ ์ฝ๊ณ , ์ ๊ฐ ๋ง๋ค์ด์๋ ํด์ ๋ํด์๋ ์ฝ์ผ์ญ์์ค. |
|||
- ์๋ก์ด ๊ธฐ์ฌ๋ฅผ ์ฝ๊ธฐ ์ํด ํ๋ก์ฐ ํ์ญ์์ค. |
|||
**FastAPI**๊ฐ ์ด๋ป๊ฒ ์ฌ์ฉ๋๊ณ ์๋์ง, ์ด๋ค ์ ์ด ๋ง์์ ๋ค์๋์ง, ์ด๋ค ํ๋ก์ ํธ/ํ์ฌ์์ ์ฌ์ฉํ๊ณ ์๋์ง ๋ฑ์ ๋ํด ๋ฃ๊ณ ์ถ์ต๋๋ค. |
|||
|
|||
## **FastAPI**์ ๋ํ ํธ์ |
|||
## FastAPI์ ํฌํํ๊ธฐ |
|||
|
|||
[**FastAPI**์ ๋ํด ํธ์](https://twitter.com/compose/tweet?text=I'm loving @fastapi because... https://github.com/fastapi/fastapi) ํ๊ณ FastAPI๊ฐ ๋ง์์ ๋๋ ์ด์ ๋ฅผ ์๋ ค์ฃผ์ธ์. ๐ |
|||
* <a href="https://www.slant.co/options/34241/~fastapi-review" class="external-link" target="_blank">Slant์์ **FastAPI** ์ ๋ํด ํฌํํ์ญ์์ค</a>. |
|||
* <a href="https://alternativeto.net/software/fastapi/about/" class="external-link" target="_blank">AlternativeTo์์ **FastAPI** ์ ๋ํด ํฌํํ์ญ์์ค</a>. |
|||
* <a href="https://stackshare.io/pypi-fastapi" class="external-link" target="_blank">StackShare์์ **FastAPI** ์ ๋ํด ํฌํํ์ญ์์ค</a>. |
|||
|
|||
**FastAPI**๊ฐ ์ด๋ป๊ฒ ์ฌ์ฉ๋๊ณ ์๋์ง, ์ด๋ค ์ ์ด ๋ง์์ ๋ค์๋์ง, ์ด๋ค ํ๋ก์ ํธ/ํ์ฌ์์ ์ฌ์ฉํ๊ณ ์๋์ง ๋ฑ์ ๋ํด ๋ฃ๊ณ ์ถ์ต๋๋ค. |
|||
## GitHub์ ์ด์๋ก ๋ค๋ฅธ์ฌ๋ ๋๊ธฐ |
|||
|
|||
## FastAPI์ ํฌํํ๊ธฐ |
|||
๋ค๋ฅธ ์ฌ๋๋ค์ ์ง๋ฌธ์ ๋์์ ์ค ์ ์์ต๋๋ค: |
|||
|
|||
- [Slant์์ **FastAPI** ์ ๋ํด ํฌํํ์ญ์์ค](https://www.slant.co/options/34241/~fastapi-review). |
|||
- [AlternativeTo**FastAPI** ์ ๋ํด ํฌํํ์ญ์์ค](https://alternativeto.net/software/fastapi/). |
|||
* <a href="https://github.com/fastapi/fastapi/discussions/categories/questions?discussions_q=category%3AQuestions+is%3Aunanswered" class="external-link" target="_blank">GitHub ๋์ค์ปค์
</a> |
|||
* <a href="https://github.com/fastapi/fastapi/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Aquestion+-label%3Aanswered+" class="external-link" target="_blank">GitHub ์ด์</a> |
|||
|
|||
## GitHub์ ์ด์๋ก ๋ค๋ฅธ์ฌ๋ ๋๊ธฐ |
|||
๋ง์ ๊ฒฝ์ฐ, ์ฌ๋ฌ๋ถ์ ์ด๋ฏธ ๊ทธ ์ง๋ฌธ์ ๋ํ ๋ต์ ์๊ณ ์์ ์๋ ์์ต๋๋ค. ๐ค |
|||
|
|||
[์กด์ฌํ๋ ์ด์](https://github.com/fastapi/fastapi/issues)๋ฅผ ํ์ธํ๊ณ ๊ทธ๊ฒ์ ์๋ํ๊ณ ๋์์ค ์ ์์ต๋๋ค. ๋๋ถ๋ถ์ ๊ฒฝ์ฐ ์ด๋ฏธ ๋ต์ ์๊ณ ์๋ ์ง๋ฌธ์
๋๋ค. ๐ค |
|||
๋ง์ฝ ๋ง์ ์ฌ๋๋ค์ ๋ฌธ์ ๋ฅผ ๋์์ค๋ค๋ฉด, ๊ณต์์ ์ธ [FastAPI ์ ๋ฌธ๊ฐ](fastapi-people.md#fastapi-experts){.internal-link target=\_blank} ๊ฐ ๋ ๊ฒ์
๋๋ค. ๐ |
|||
|
|||
๋ง์ ์ฌ๋๋ค์ ๋ฌธ์ ๋ฅผ ๋์์ค๋ค๋ฉด, ๊ณต์์ ์ธ [FastAPI ์ ๋ฌธ๊ฐ](https://github.com/fastapi/fastapi/blob/master/docs/en/docs/fastapi-people.md#experts) ๊ฐ ๋ ์ ์์ต๋๋ค{.internal-link target=_blank}. ๐ |
|||
๊ฐ์ฅ ์ค์ํ ์ ์: ์น์ ํ๋ ค๊ณ ๋
ธ๋ ฅํ๋ ๊ฒ์
๋๋ค. ์ฌ๋๋ค์ ์ข์ ๊ฐ์ ์๊ณ ์ค๋ฉฐ, ๋ง์ ๊ฒฝ์ฐ ์ต์ ์ ๋ฐฉ์์ผ๋ก ์ง๋ฌธํ์ง ์์ ์๋ ์์ต๋๋ค. ํ์ง๋ง ์ต๋ํ ์น์ ํ๊ฒ ๋ํ๋ ค๊ณ ๋
ธ๋ ฅํ์ธ์. ๐ค |
|||
|
|||
## GitHub ์ ์ฅ์ ๋ณด๊ธฐ |
|||
**FastAPI** ์ปค๋ฎค๋ํฐ์ ๋ชฉํ๋ ์น์ ํ๊ณ ํ์ํ๋ ๊ฒ์
๋๋ค. ๋์์, ๊ดด๋กญํ์ด๋ ๋ฌด๋กํ ํ๋์ ๋ฐ์๋ค์ด์ง ๋ง์ธ์. ์ฐ๋ฆฌ๋ ์๋ก๋ฅผ ๋๋ด์ผ ํฉ๋๋ค. |
|||
|
|||
GitHub์์ FastAPI๋ฅผ "watch"ํ ์ ์์ต๋๋ค (์ค๋ฅธ์ชฝ ์๋จ watch ๋ฒํผ์ ํด๋ฆญ): https://github.com/fastapi/fastapi. ๐ |
|||
--- |
|||
|
|||
"Releases only" ๋์ "Watching"์ ์ ํํ๋ฉด ๋ค๋ฅธ ์ฌ์ฉ์๊ฐ ์๋ก์ด issue๋ฅผ ์์ฑํ ๋ ์๋ฆผ์ด ์์ ๋ฉ๋๋ค. |
|||
๋ค๋ฅธ ์ฌ๋๋ค์ ์ง๋ฌธ (๋์ค์ปค์
๋๋ ์ด์์์) ํด๊ฒฐ์ ๋์ธ ์ ์๋ ๋ฐฉ๋ฒ์ ๋ค์๊ณผ ๊ฐ์ต๋๋ค. |
|||
|
|||
๊ทธ๋ฐ ๋ค์ ์ด๋ฐ issues๋ฅผ ํด๊ฒฐ ํ ์ ์๋๋ก ๋์์ ์ค ์ ์์ต๋๋ค. |
|||
### ์ง๋ฌธ ์ดํดํ๊ธฐ |
|||
|
|||
## ์ด์ ์์ฑํ๊ธฐ |
|||
* ์ง๋ฌธํ๋ ์ฌ๋์ด ๊ฐ์ง **๋ชฉ์ **๊ณผ ์ฌ์ฉ ์ฌ๋ก๋ฅผ ์ดํดํ ์ ์๋์ง ํ์ธํ์ธ์. |
|||
|
|||
GitHub ์ ์ฅ์์ [์๋ก์ด ์ด์ ์์ฑ](https://github.com/fastapi/fastapi/issues/new/choose) ์ ํ ์ ์์ต๋๋ค, ์๋ฅผ๋ค๋ฉด ๋ค์๊ณผ ๊ฐ์ต๋๋ค: |
|||
* ์ง๋ฌธ (๋๋ถ๋ถ์ ์ง๋ฌธ์
๋๋ค)์ด **๋ช
ํ**ํ์ง ํ์ธํ์ธ์. |
|||
|
|||
- **์ง๋ฌธ**์ ํ๊ฑฐ๋ **๋ฌธ์ **์ ๋ํด ์ง๋ฌธํฉ๋๋ค. |
|||
- ์๋ก์ด **๊ธฐ๋ฅ**์ ์ ์ ํฉ๋๋ค. |
|||
* ๋ง์ ๊ฒฝ์ฐ, ์ฌ์ฉ์๊ฐ ๊ฐ์ ํ ํด๊ฒฐ์ฑ
์ ๋ํ ์ง๋ฌธ์ ํ์ง๋ง, ๋ **์ข์** ํด๊ฒฐ์ฑ
์ด ์์ ์ ์์ต๋๋ค. ๋ฌธ์ ์ ์ฌ์ฉ ์ฌ๋ก๋ฅผ ๋ ์ ์ดํดํ๋ฉด ๋ ๋์ **๋์์ ์ธ ํด๊ฒฐ์ฑ
**์ ์ ์ํ ์ ์์ต๋๋ค. |
|||
|
|||
**์ฐธ๊ณ **: ๋ง์ฝ ์ด์๋ฅผ ์์ฑํ๋ค๋ฉด, ์ ๋ ์ฌ๋ฌ๋ถ์๊ฒ ๋ค๋ฅธ ์ฌ๋๋ค์ ๋์๋ฌ๋ผ๊ณ ๋ถํํ ๊ฒ์
๋๋ค. ๐ |
|||
* ์ง๋ฌธ์ ์ดํดํ ์ ์๋ค๋ฉด, ๋ **์์ธํ ์ ๋ณด**๋ฅผ ์์ฒญํ์ธ์. |
|||
|
|||
## Pull Request๋ฅผ ๋ง๋์ญ์์ค |
|||
### ๋ฌธ์ ์ฌํํ๊ธฐ |
|||
|
|||
Pull Requests๋ฅผ ์ด์ฉํ์ฌ ์์ค์ฝ๋์ [์ปจํธ๋ฆฌ๋ทฐํธ](https://github.com/fastapi/fastapi/blob/master/docs/en/docs/contributing.md){.internal-link target=_blank} ํ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค๋ฉด ๋ค์๊ณผ ๊ฐ์ต๋๋ค: |
|||
๋๋ถ๋ถ์ ๊ฒฝ์ฐ, ์ง๋ฌธ์ ์ง๋ฌธ์์ **์๋ณธ ์ฝ๋**์ ๊ด๋ จ์ด ์์ต๋๋ค. |
|||
|
|||
- ๋ฌธ์์์ ์ฐพ์ ์คํ๋ฅผ ์์ ํ ๋. |
|||
๋ง์ ๊ฒฝ์ฐ, ์ฝ๋์ ์ผ๋ถ๋ง ๋ณต์ฌํด์ ์ฌ๋ฆฌ์ง๋ง, ๊ทธ๊ฒ๋ง์ผ๋ก๋ **๋ฌธ์ ๋ฅผ ์ฌํ**ํ๊ธฐ์ ์ถฉ๋ถํ์ง ์์ต๋๋ค. |
|||
|
|||
- FastAPI๋ฅผ [ํธ์งํ์ฌ](https://github.com/fastapi/fastapi/edit/master/docs/en/data/external_links.yml) ์์ฑํ๊ฑฐ๋ ์ฐพ์ ๋ฌธ์, ๋น๋์ค ๋๋ ํ์บ์คํธ๋ฅผ ๊ณต์ ํ ๋. |
|||
* ์ง๋ฌธ์์๊ฒ <a href="https://stackoverflow.com/help/minimal-reproducible-example" class="external-link" target="_blank">์ต์ํ์ ์ฌํ ๊ฐ๋ฅํ ์์ </a>๋ฅผ ์ ๊ณตํด๋ฌ๋ผ๊ณ ์์ฒญํ์ธ์. ์ด๋ ๊ฒ ํ๋ฉด ์ฝ๋๋ฅผ **๋ณต์ฌ-๋ถ์ฌ๋ฃ๊ธฐ**ํ์ฌ ์ง์ ์คํํ๊ณ , ๋์ผํ ์ค๋ฅ๋ ๋์์ ํ์ธํ๊ฑฐ๋ ์ฌ์ฉ ์ฌ๋ก๋ฅผ ๋ ์ ์ดํดํ ์ ์์ต๋๋ค. |
|||
|
|||
- ํด๋น ์น์
์ ์์ ๋ถ๋ถ์ ๋งํฌ๋ฅผ ์ถ๊ฐํ๋์ง ํ์ธํ์ญ์์ค. |
|||
* ๋๊ทธ๋ฌ์ด ๋ง์์ด ๋ ๋ค๋ฉด, ๋ฌธ์ ์ค๋ช
๋ง์ ๊ธฐ๋ฐ์ผ๋ก ์ง์ **์์ ๋ฅผ ๋ง๋ค์ด**๋ณผ ์๋ ์์ต๋๋ค. ํ์ง๋ง, ์ด๋ ์๊ฐ์ด ๋ง์ด ๊ฑธ๋ฆด ์ ์์ผ๋ฏ๋ก, ๋จผ์ ์ง๋ฌธ์ ๋ช
ํํ ํด๋ฌ๋ผ๊ณ ์์ฒญํ๋ ๊ฒ์ด ์ข์ต๋๋ค. |
|||
|
|||
- ๋น์ ์ ์ธ์ด๋ก [๋ฌธ์ ๋ฒ์ญํ๋๋ฐ](https://github.com/fastapi/fastapi/blob/master/docs/en/docs/contributing.md#translations){.internal-link target=_blank} ๊ธฐ์ฌํ ๋. |
|||
### ํด๊ฒฐ์ฑ
์ ์ํ๊ธฐ |
|||
|
|||
- ๋ํ ๋ค๋ฅธ ์ฌ์ฉ์๊ฐ ๋ง๋ ๋ฒ์ญ์ ๊ฒํ ํ๋๋ฐ ๋์์ ์ค ์๋ ์์ต๋๋ค. |
|||
* ์ง๋ฌธ์ ์ถฉ๋ถํ ์ดํดํ ํ์๋ ๊ฐ๋ฅํ **๋ต๋ณ**์ ์ ๊ณตํ ์ ์์ต๋๋ค. |
|||
|
|||
- ์๋ก์ด ๋ฌธ์์ ์น์
์ ์ ์ํ ๋. |
|||
* ๋ง์ ๊ฒฝ์ฐ, ์ง๋ฌธ์์ **๊ทผ๋ณธ์ ์ธ ๋ฌธ์ ๋ ์ฌ์ฉ ์ฌ๋ก**๋ฅผ ์ดํดํ๋ ๊ฒ์ด ์ค์ํฉ๋๋ค. ๊ทธ๋ค์ด ์๋ํ๋ ๋ฐฉ๋ฒ๋ณด๋ค ๋ ๋์ ํด๊ฒฐ์ฑ
์ด ์์ ์ ์๊ธฐ ๋๋ฌธ์
๋๋ค. |
|||
|
|||
- ๊ธฐ์กด ๋ฌธ์ /๋ฒ๊ทธ๋ฅผ ์์ ํ ๋. |
|||
### ํด๊ฒฐ ์์ฒญํ๊ธฐ |
|||
|
|||
- ์๋ก์ด feature๋ฅผ ์ถ๊ฐํ ๋. |
|||
์ง๋ฌธ์๊ฐ ๋ต๋ณ์ ํ์ธํ๊ณ ๋๋ฉด, ๋น์ ์ด ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ์ ๊ฐ๋ฅ์ฑ์ด ๋์ต๋๋ค. ์ถํํฉ๋๋ค, **๋น์ ์ ์์
์
๋๋ค**! ๐ฆธ |
|||
|
|||
## ์ฑํ
์ ์ฐธ์ฌํ์ญ์์ค |
|||
* ์ด์ ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๋ค๋ฉด, ์ง๋ฌธ์์๊ฒ ๋ค์์ ์์ฒญํ ์ ์์ต๋๋ค. |
|||
|
|||
๐ฅ [๋์ค์ฝ๋ ์ฑํ
์๋ฒ](https://discord.gg/VQjSZaeJmf) ๐ฅ ์ ๊ฐ์
ํ๊ณ FastAPI ์ปค๋ฎค๋ํฐ์์ ๋ค๋ฅธ ์ฌ๋๋ค๊ณผ ์ด์ธ๋ฆฌ์ธ์. |
|||
* GitHub ๋์ค์ปค์
์์: ๋๊ธ์ **๋ต๋ณ**์ผ๋ก ํ์ํ๋๋ก ์์ฒญํ์ธ์. |
|||
* GitHub ์ด์์์: ์ด์๋ฅผ **๋ซ์๋ฌ๋ผ๊ณ ** ์์ฒญํ์ธ์. |
|||
|
|||
/// tip |
|||
## GitHub ์ ์ฅ์ ๋ณด๊ธฐ |
|||
|
|||
์ง๋ฌธ์ด ์๋ ๊ฒฝ์ฐ, [GitHub ์ด์ ](https://github.com/fastapi/fastapi/issues/new/choose) ์์ ์ง๋ฌธํ์ญ์์ค, [FastAPI ์ ๋ฌธ๊ฐ](https://github.com/fastapi/fastapi/blob/master/docs/en/docs/fastapi-people.md#experts) ์ ๋์์ ๋ฐ์ ๊ฐ๋ฅ์ฑ์ด ๋์ต๋๋ค{.internal-link target=_blank} . |
|||
GitHub์์ FastAPI๋ฅผ "watch"ํ ์ ์์ต๋๋ค (์ค๋ฅธ์ชฝ ์๋จ watch ๋ฒํผ์ ํด๋ฆญ): <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">https://github.com/fastapi/fastapi</a>. ๐ |
|||
|
|||
/// |
|||
"Releases only" ๋์ "Watching"์ ์ ํํ๋ฉด, ์๋ก์ด ์ด์๋ ์ง๋ฌธ์ด ์์ฑ๋ ๋ ์๋ฆผ์ ๋ฐ์ ์ ์์ต๋๋ค. ๋ํ, ํน์ ํ๊ฒ ์๋ก์ด ์ด์, ๋์ค์ปค์
, PR ๋ฑ๋ง ์๋ฆผ ๋ฐ๋๋ก ์ค์ ํ ์๋ ์์ต๋๋ค. |
|||
|
|||
``` |
|||
๋ค๋ฅธ ์ผ๋ฐ์ ์ธ ๋ํ์์๋ง ์ฑํ
์ ์ฌ์ฉํ์ญ์์ค. |
|||
``` |
|||
๊ทธ๋ฐ ๋ค์ ์ด๋ฐ ์ด์๋ค์ ํด๊ฒฐ ํ ์ ์๋๋ก ๋์์ ์ค ์ ์์ต๋๋ค. |
|||
|
|||
๊ธฐ์กด [์งํฐ ์ฑํ
](https://gitter.im/fastapi/fastapi) ์ด ์์ง๋ง ์ฑ๋๊ณผ ๊ณ ๊ธ๊ธฐ๋ฅ์ด ์์ด์ ๋ํ๋ฅผ ํ๊ธฐ๊ฐ ์กฐ๊ธ ์ด๋ ต๊ธฐ ๋๋ฌธ์ ์ง๊ธ์ ๋์ค์ฝ๋๊ฐ ๊ถ์ฅ๋๋ ์์คํ
์
๋๋ค. |
|||
## ์ด์ ์์ฑํ๊ธฐ |
|||
|
|||
### ์ง๋ฌธ์ ์ํด ์ฑํ
์ ์ฌ์ฉํ์ง ๋ง์ญ์์ค |
|||
GitHub ์ ์ฅ์์ <a href="https://github.com/fastapi/fastapi/discussions/new?category=questions" class="external-link" target="_blank">์๋ก์ด ์ด์ ์์ฑ</a>์ ํ ์ ์์ต๋๋ค, ์๋ฅผ๋ค๋ฉด ๋ค์๊ณผ ๊ฐ์ต๋๋ค: |
|||
|
|||
์ฑํ
์ ๋ ๋ง์ "์์ ๋ก์ด ๋ํ"๋ฅผ ํ์ฉํ๊ธฐ ๋๋ฌธ์, ๋๋ฌด ์ผ๋ฐ์ ์ธ ์ง๋ฌธ์ด๋ ๋๋ตํ๊ธฐ ์ด๋ ค์ด ์ง๋ฌธ์ ์ฝ๊ฒ ์ง๋ฌธ์ ํ ์ ์์ผ๋ฏ๋ก, ๋ต๋ณ์ ๋ฐ์ง ๋ชปํ ์ ์์ต๋๋ค. |
|||
* **์ง๋ฌธ**์ ํ๊ฑฐ๋ **๋ฌธ์ **์ ๋ํด ์ง๋ฌธํฉ๋๋ค. |
|||
* ์๋ก์ด **๊ธฐ๋ฅ**์ ์ ์ ํฉ๋๋ค. |
|||
|
|||
GitHub ์ด์์์์ ํ
ํ๋ฆฟ์ ์ฌ๋ฐ๋ฅธ ์ง๋ฌธ์ ์์ฑํ๋๋ก ์๋ดํ์ฌ ๋ ์ฝ๊ฒ ์ข์ ๋ต๋ณ์ ์ป๊ฑฐ๋ ์ง๋ฌธํ๊ธฐ ์ ์ ์ค์ค๋ก ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ ์๋ ์์ต๋๋ค. ๊ทธ๋ฆฌ๊ณ GitHub์์๋ ์๊ฐ์ด ์กฐ๊ธ ๊ฑธ๋ฆฌ๋๋ผ๋ ํญ์ ๋ชจ๋ ๊ฒ์ ๋ตํ ์ ์์ต๋๋ค. ์ฑํ
์์คํ
์์๋ ๊ฐ์ธ์ ์ผ๋ก ๊ทธ๋ ๊ฒ ํ ์ ์์ต๋๋ค. ๐
|
|||
**์ฐธ๊ณ **: ๋ง์ฝ ์ด์๋ฅผ ์์ฑํ๋ค๋ฉด, ์ ๋ ์ฌ๋ฌ๋ถ์๊ฒ ๋ค๋ฅธ ์ฌ๋๋ค์ ๋์๋ฌ๋ผ๊ณ ๋ถํํ ๊ฒ์
๋๋ค. ๐ |
|||
|
|||
์ฑํ
์์คํ
์์์ ๋ํ ๋ํ GitHub์์ ์ฒ๋ผ ์ฝ๊ฒ ๊ฒ์ํ ์ ์๊ธฐ ๋๋ฌธ์ ๋ํ ์ค์ ์ง๋ฌธ๊ณผ ๋ต๋ณ์ด ์์ค๋ ์ ์์ต๋๋ค. ๊ทธ๋ฆฌ๊ณ GitHub ์ด์์ ์๋ ๊ฒ๋ง [FastAPI ์ ๋ฌธ๊ฐ](https://github.com/fastapi/fastapi/blob/master/docs/en/docs/fastapi-people.md#experts)๊ฐ ๋๋ ๊ฒ์ผ๋ก ๊ฐ์ฃผ๋๋ฏ๋ก{.internal-link target=_blank} , GitHub ์ด์์์ ๋ ๋ง์ ๊ด์ฌ์ ๋ฐ์ ๊ฒ์
๋๋ค. |
|||
## Pull Requests ๋ฆฌ๋ทฐํ๊ธฐ |
|||
|
|||
๋ฐ๋ฉด, ์ฑํ
์์คํ
์๋ ์์ฒ ๋ช
์ ์ฌ์ฉ์๊ฐ ์๊ธฐ ๋๋ฌธ์, ๊ฑฐ์ ํญ์ ๋ํ ์๋๋ฅผ ์ฐพ์ ๊ฐ๋ฅ์ฑ์ด ๋์ต๋๋ค. ๐ |
|||
๋ค๋ฅธ ์ฌ๋๋ค์ pull request๋ฅผ ๋ฆฌ๋ทฐํ๋ ๋ฐ ๋์์ ์ค ์ ์์ต๋๋ค. |
|||
|
|||
## ๊ฐ๋ฐ์ ์คํฐ์๊ฐ ๋์ญ์์ค |
|||
๋ค์ ํ๋ฒ ๋งํ์ง๋ง, ์ต๋ํ ์น์ ํ๊ฒ ๋ฆฌ๋ทฐํด ์ฃผ์ธ์. ๐ค |
|||
|
|||
[GitHub ์คํฐ์](https://github.com/sponsors/tiangolo) ๋ฅผ ํตํด ๊ฐ๋ฐ์๋ฅผ ๊ฒฝ์ ์ ์ผ๋ก ์ง์ํ ์ ์์ต๋๋ค. |
|||
--- |
|||
|
|||
๊ฐ์ฌํ๋ค๋ ๋ง๋ก ์ปคํผ๋ฅผ โ๏ธ ํ์ ์ฌ์ค ์ ์์ต๋๋ค. ๐ |
|||
Pull Rrquest๋ฅผ ๋ฆฌ๋ทฐํ ๋ ๊ณ ๋ คํด์ผ ํ ์ฌํญ๊ณผ ๋ฐฉ๋ฒ์ ๋ค์๊ณผ ๊ฐ์ต๋๋ค: |
|||
|
|||
๋ํ FastAPI์ ์ค๋ฒ ๋๋ ๊ณจ๋ ์คํฐ์๊ฐ ๋ ์ ์์ต๋๋ค. ๐
๐ |
|||
### ๋ฌธ์ ์ดํดํ๊ธฐ |
|||
|
|||
## FastAPI๋ฅผ ๊ฐํํ๋ ๋๊ตฌ์ ์คํฐ์๊ฐ ๋์ญ์์ค |
|||
* ๋จผ์ , ํด๋น pull request๊ฐ ํด๊ฒฐํ๋ ค๋ **๋ฌธ์ ๋ฅผ ์ดํดํ๋์ง** ํ์ธํ์ธ์. GitHub ๋์ค์ปค์
๋๋ ์ด์์์ ๋ ๊ธด ๋
ผ์๊ฐ ์์์ ์๋ ์์ต๋๋ค. |
|||
|
|||
๋ฌธ์์์ ๋ณด์๋ฏ์ด, FastAPI๋ Starlette๊ณผ Pydantic ๋ผ๋ ๊ฑฐ์ธ์ ์ด๊นจ์ ํ๊ณ ์์ต๋๋ค. |
|||
* Pull request๊ฐ ํ์ํ์ง ์์ ๊ฐ๋ฅ์ฑ๋ ์์ต๋๋ค. **๋ค๋ฅธ ๋ฐฉ์**์ผ๋ก ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ ์ ์๋ค๋ฉด, ๊ทธ ๋ฐฉ๋ฒ์ ์ ์ํ๊ฑฐ๋ ์ง๋ฌธํ ์ ์์ต๋๋ค. |
|||
|
|||
๋ค์์ ์คํฐ์๊ฐ ๋ ์ ์์ต๋๋ค |
|||
### ์คํ์ผ์ ๋๋ฌด ์ ๊ฒฝ ์ฐ์ง ์๊ธฐ |
|||
|
|||
- [Samuel Colvin (Pydantic)](https://github.com/sponsors/samuelcolvin) |
|||
- [Encode (Starlette, Uvicorn)](https://github.com/sponsors/encode) |
|||
* ์ปค๋ฐ ๋ฉ์์ง ์คํ์ผ ๊ฐ์ ๊ฒ์ ๋๋ฌด ์ ๊ฒฝ ์ฐ์ง ์์๋ ๋ฉ๋๋ค. ์ ๋ ์ง์ ์ปค๋ฐ์ ์์ ํ์ฌ squash and merge๋ฅผ ์ํํ ๊ฒ์
๋๋ค. |
|||
|
|||
------ |
|||
* ์ฝ๋ ์คํ์ผ ๊ท์น๋ ๊ฑฑ์ ํ ํ์ ์์ต๋๋ค. ์ด๋ฏธ ์๋ํ๋ ๋๊ตฌ๋ค์ด ์ด๋ฅผ ๊ฒ์ฌํ๊ณ ์์ต๋๋ค. |
|||
|
|||
๊ฐ์ฌํฉ๋๋ค! ๐ |
|||
์คํ์ผ์ด๋ ์ผ๊ด์ฑ ๊ด๋ จ ์์ฒญ์ด ํ์ํ ๊ฒฝ์ฐ, ์ ๊ฐ ์ง์ ์์ฒญํ๊ฑฐ๋ ํ์ํ ๋ณ๊ฒฝ ์ฌํญ์ ์ถ๊ฐ ์ปค๋ฐ์ผ๋ก ์์ ํ ๊ฒ์
๋๋ค. |
|||
|
|||
### ์ฝ๋ ํ์ธํ๊ธฐ |
|||
|
|||
* ์ฝ๋๋ฅผ ์ฝ๊ณ , **๋
ผ๋ฆฌ์ ์ผ๋ก ํ๋น**ํ์ง ํ์ธํ ํ ๋ก์ปฌ์์ ์คํํ์ฌ ๋ฌธ์ ๊ฐ ํด๊ฒฐ๋๋์ง ํ์ธํ์ธ์. |
|||
|
|||
* ๊ทธ๋ฐ ๋ค์, ํ์ธํ๋ค๊ณ **๋๊ธ**์ ๋จ๊ฒจ ์ฃผ์ธ์. ๊ทธ๋์ผ ์ ๊ฐ ๊ฒํ ํ์์ ์ ์ ์์ต๋๋ค. |
|||
|
|||
/// info |
|||
|
|||
๋ถํํ๋, ์ ๊ฐ ๋จ์ํ ์ฌ๋ฌ ๊ฐ์ ์น์ธ๋ง์ผ๋ก PR์ ์ ๋ขฐํ ์๋ ์์ต๋๋ค. |
|||
|
|||
3๊ฐ, 5๊ฐ ์ด์์ ์น์ธ์ด ๋ฌ๋ฆฐ PR์ด ์ค์ ๋ก๋ ๊นจ์ ธ ์๊ฑฐ๋, ๋ฒ๊ทธ๊ฐ ์๊ฑฐ๋, ์ฃผ์ฅํ๋ ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ์ง ๋ชปํ๋ ๊ฒฝ์ฐ๊ฐ ์ฌ๋ฌ ๋ฒ ์์์ต๋๋ค. ๐
|
|||
|
|||
๋ฐ๋ผ์, ์ ๋ง๋ก ์ฝ๋๋ฅผ ์ฝ๊ณ ์คํํ ๋ค, ๋๊ธ๋ก ํ์ธ ๋ด์ฉ์ ๋จ๊ฒจ ์ฃผ๋ ๊ฒ์ด ๋งค์ฐ ์ค์ํฉ๋๋ค. ๐ค |
|||
|
|||
/// |
|||
|
|||
* PR์ ๋ ๋จ์ํ๊ฒ ๋ง๋ค ์ ์๋ค๋ฉด ๊ทธ๋ ๊ฒ ์์ฒญํ ์ ์์ง๋ง, ๋๋ฌด ๊น๋ค๋ก์ธ ํ์๋ ์์ต๋๋ค. ์ฃผ๊ด์ ์ธ ๊ฒฌํด๊ฐ ๋ง์ด ์์ ์ ์๊ธฐ ๋๋ฌธ์
๋๋ค (๊ทธ๋ฆฌ๊ณ ์ ๋ ์ ๊ฒฌํด๊ฐ ์์ ๊ฑฐ์์ ๐). ๋ฐ๋ผ์ ํต์ฌ์ ์ธ ๋ถ๋ถ์ ์ง์คํ๋ ๊ฒ์ด ์ข์ต๋๋ค. |
|||
|
|||
### ํ
์คํธ |
|||
|
|||
* PR์ **ํ
์คํธ**๊ฐ ํฌํจ๋์ด ์๋์ง ํ์ธํ๋ ๋ฐ ๋์์ ์ฃผ์ธ์. |
|||
|
|||
* PR์ ์ ์ฉํ๊ธฐ ์ ์ ํ
์คํธ๊ฐ **์คํจ**ํ๋์ง ํ์ธํ์ธ์. ๐จ |
|||
|
|||
* PR์ ์ ์ฉํ ํ ํ
์คํธ๊ฐ **ํต๊ณผ**ํ๋์ง ํ์ธํ์ธ์. โ
|
|||
|
|||
* ๋ง์ PR์๋ ํ
์คํธ๊ฐ ์์ต๋๋ค. ํ
์คํธ๋ฅผ ์ถ๊ฐํ๋๋ก **์๊ธฐ**์์ผ์ค ์๋ ์๊ณ , ์ง์ ํ
์คํธ๋ฅผ **์ ์**ํ ์๋ ์์ต๋๋ค. ์ด๋ ์๊ฐ์ด ๋ง์ด ์์๋๋ ๋ถ๋ถ ์ค ํ๋์ด๋ฉฐ, ๊ทธ ๋ถ๋ถ์ ๋ง์ด ๋์์ค ์ ์์ต๋๋ค. |
|||
|
|||
* ๊ทธ๋ฆฌ๊ณ ์๋ํ ๋ด์ฉ์ ๋๊ธ๋ก ๋จ๊ฒจ์ฃผ์ธ์. ๊ทธ๋ฌ๋ฉด ์ ๊ฐ ํ์ธํ๋ค๋ ๊ฑธ ์ ์ ์์ต๋๋ค. ๐ค |
|||
|
|||
## Pull Request๋ฅผ ๋ง๋์ญ์์ค |
|||
|
|||
Pull Requests๋ฅผ ์ด์ฉํ์ฌ ์์ค์ฝ๋์ [์ปจํธ๋ฆฌ๋ทฐํธ](contributing.md){.internal-link target=\_blank} ํ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค๋ฉด ๋ค์๊ณผ ๊ฐ์ต๋๋ค: |
|||
|
|||
* ๋ฌธ์์์ ๋ฐ๊ฒฌํ ์คํ๋ฅผ ์์ ํ ๋. |
|||
* FastAPI ๊ด๋ จ ๋ฌธ์, ๋น๋์ค ๋๋ ํ์บ์คํธ๋ฅผ ์์ฑํ๊ฑฐ๋ ๋ฐ๊ฒฌํ์ฌ <a href="https://github.com/fastapi/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">์ด ํ์ผ์ ํธ์งํ์ฌ</a> ๊ณต์ ํ ๋. |
|||
* ํด๋น ์น์
์ ์์ ๋ถ๋ถ์ ๋งํฌ๋ฅผ ์ถ๊ฐํด์ผ ํฉ๋๋ค. |
|||
* ๋น์ ์ ์ธ์ด๋ก [๋ฌธ์ ๋ฒ์ญํ๋๋ฐ](contributing.md#translations){.internal-link target=\_blank} ๊ธฐ์ฌํ ๋. |
|||
* ๋ค๋ฅธ ์ฌ๋์ด ์์ฑํ ๋ฒ์ญ์ ๊ฒํ ํ๋ ๊ฒ๋ ๋์ธ ์ ์์ต๋๋ค. |
|||
* ์๋ก์ด ๋ฌธ์์ ์น์
์ ์ ์ํ ๋. |
|||
* ๊ธฐ์กด ๋ฌธ์ /๋ฒ๊ทธ๋ฅผ ์์ ํ ๋. |
|||
* ํ
์คํธ๋ฅผ ๋ฐ๋์ ์ถ๊ฐํด์ผ ํฉ๋๋ค. |
|||
* ์๋ก์ด feature๋ฅผ ์ถ๊ฐํ ๋. |
|||
* ํ
์คํธ๋ฅผ ๋ฐ๋์ ์ถ๊ฐํด์ผ ํฉ๋๋ค. |
|||
* ๊ด๋ จ ๋ฌธ์๊ฐ ํ์ํ๋ค๋ฉด ๋ฐ๋์ ์ถ๊ฐํด์ผ ํฉ๋๋ค. |
|||
|
|||
## FastAPI ์ ์ง ๊ด๋ฆฌ์ ๋์ ์ฃผ๊ธฐ |
|||
|
|||
**FastAPI**์ ์ ์ง ๊ด๋ฆฌ๋ฅผ ๋์์ฃผ์ธ์! ๐ค |
|||
|
|||
ํ ์ผ์ด ๋ง๊ณ , ๊ทธ ์ค ๋๋ถ๋ถ์ **์ฌ๋ฌ๋ถ**์ด ํ ์ ์์ต๋๋ค. |
|||
|
|||
์ง๊ธ ํ ์ ์๋ ์ฃผ์ ์์
์: |
|||
|
|||
* [GitHub์์ ๋ค๋ฅธ ์ฌ๋๋ค์ ์ง๋ฌธ์ ๋์ ์ฃผ๊ธฐ](#github_1){.internal-link target=_blank} (์์ ์น์
์ ์ฐธ์กฐํ์ธ์). |
|||
* [Pull Request ๋ฆฌ๋ทฐํ๊ธฐ](#pull-requests){.internal-link target=_blank} (์์ ์น์
์ ์ฐธ์กฐํ์ธ์). |
|||
|
|||
์ด ๋ ์์
์ด **๊ฐ์ฅ ๋ง์ ์๊ฐ์ ์๋ชจ**ํ๋ ์ผ์
๋๋ค. ๊ทธ๊ฒ์ด FastAPI ์ ์ง ๊ด๋ฆฌ์ ์ฃผ์ ์์
์
๋๋ค. |
|||
|
|||
์ด ์์
์ ๋์์ฃผ์ ๋ค๋ฉด, **FastAPI ์ ์ง ๊ด๋ฆฌ์ ๋์์ ์ฃผ๋ ๊ฒ**์ด๋ฉฐ ๊ทธ๊ฒ์ด **๋ ๋น ๋ฅด๊ณ ๋ ์ ๋ฐ์ ํ๋ ๊ฒ**์ ๋ณด์ฅํ๋ ๊ฒ์
๋๋ค. ๐ |
|||
|
|||
## ์ฑํ
์ ์ฐธ์ฌํ์ญ์์ค |
|||
|
|||
๐ฅ <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">๋์ค์ฝ๋ ์ฑํ
์๋ฒ</a> ๐ฅ ์ ๊ฐ์
ํ๊ณ FastAPI ์ปค๋ฎค๋ํฐ์์ ๋ค๋ฅธ ์ฌ๋๋ค๊ณผ ์ด์ธ๋ฆฌ์ธ์. |
|||
|
|||
/// tip |
|||
|
|||
์ง๋ฌธ์ด ์๋ ๊ฒฝ์ฐ, <a href="https://github.com/fastapi/fastapi/discussions/new?category=questions" class="external-link" target="_blank">GitHub ๋์ค์ปค์
</a> ์์ ์ง๋ฌธํ์ญ์์ค, [FastAPI Experts](fastapi-people.md#fastapi-experts){.internal-link target=_blank} ์ ๋์์ ๋ฐ์ ๊ฐ๋ฅ์ฑ์ด ๋์ต๋๋ค. |
|||
|
|||
๋ค๋ฅธ ์ผ๋ฐ์ ์ธ ๋ํ์์๋ง ์ฑํ
์ ์ฌ์ฉํ์ญ์์ค. |
|||
|
|||
/// |
|||
|
|||
### ์ง๋ฌธ์ ์ํด ์ฑํ
์ ์ฌ์ฉํ์ง ๋ง์ญ์์ค |
|||
|
|||
์ฑํ
์ ๋ ๋ง์ "์์ ๋ก์ด ๋ํ"๋ฅผ ํ์ฉํ๊ธฐ ๋๋ฌธ์, ๋๋ฌด ์ผ๋ฐ์ ์ธ ์ง๋ฌธ์ด๋ ๋๋ตํ๊ธฐ ์ด๋ ค์ด ์ง๋ฌธ์ ์ฝ๊ฒ ์ง๋ฌธ์ ํ ์ ์์ผ๋ฏ๋ก, ๋ต๋ณ์ ๋ฐ์ง ๋ชปํ ์ ์์ต๋๋ค. |
|||
|
|||
GitHub ์ด์์์์ ํ
ํ๋ฆฟ์ ์ฌ๋ฐ๋ฅธ ์ง๋ฌธ์ ์์ฑํ๋๋ก ์๋ดํ์ฌ ๋ ์ฝ๊ฒ ์ข์ ๋ต๋ณ์ ์ป๊ฑฐ๋ ์ง๋ฌธํ๊ธฐ ์ ์ ์ค์ค๋ก ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ ์๋ ์์ต๋๋ค. ๊ทธ๋ฆฌ๊ณ GitHub์์๋ ์๊ฐ์ด ์กฐ๊ธ ๊ฑธ๋ฆฌ๋๋ผ๋ ํญ์ ๋ชจ๋ ๊ฒ์ ๋ตํ ์ ์์ต๋๋ค. ์ฑํ
์์คํ
์์๋ ๊ฐ์ธ์ ์ผ๋ก ๊ทธ๋ ๊ฒ ํ ์ ์์ต๋๋ค. ๐
|
|||
|
|||
์ฑํ
์์คํ
์์์ ๋ํ ๋ํ GitHub์์ ์ฒ๋ผ ์ฝ๊ฒ ๊ฒ์ํ ์ ์๊ธฐ ๋๋ฌธ์ ๋ํ ์ค์ ์ง๋ฌธ๊ณผ ๋ต๋ณ์ด ์์ค๋ ์ ์์ต๋๋ค. ๊ทธ๋ฆฌ๊ณ GitHub ์ด์์ ์๋ ๊ฒ๋ง [FastAPI Expert](fastapi-people.md#fastapi-experts){.internal-link target=_blank}๊ฐ ๋๋ ๊ฒ์ผ๋ก ๊ฐ์ฃผ๋๋ฏ๋ก, GitHub ์ด์์์ ๋ ๋ง์ ๊ด์ฌ์ ๋ฐ์ ๊ฒ์
๋๋ค. |
|||
|
|||
๋ฐ๋ฉด, ์ฑํ
์์คํ
์๋ ์์ฒ ๋ช
์ ์ฌ์ฉ์๊ฐ ์๊ธฐ ๋๋ฌธ์, ๊ฑฐ์ ํญ์ ๋ํ ์๋๋ฅผ ์ฐพ์ ๊ฐ๋ฅ์ฑ์ด ๋์ต๋๋ค. ๐ |
|||
|
|||
## ๊ฐ๋ฐ์ ์คํฐ์๊ฐ ๋์ญ์์ค |
|||
|
|||
<a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub ์คํฐ์</a> ๋ฅผ ํตํด ๊ฐ๋ฐ์๋ฅผ ๊ฒฝ์ ์ ์ผ๋ก ์ง์ํ ์ ์์ต๋๋ค. |
|||
|
|||
๊ฐ์ฌํ๋ค๋ ๋ง๋ก ์ปคํผ๋ฅผ โ๏ธ ํ์ ์ฌ์ค ์ ์์ต๋๋ค. ๐ |
|||
|
|||
๋ํ FastAPI์ ์ค๋ฒ ๋๋ ๊ณจ๋ ์คํฐ์๊ฐ ๋ ์ ์์ต๋๋ค. ๐
๐ |
|||
|
|||
## FastAPI๋ฅผ ๊ฐํํ๋ ๋๊ตฌ์ ์คํฐ์๊ฐ ๋์ญ์์ค |
|||
|
|||
๋ฌธ์์์ ๋ณด์๋ฏ์ด, FastAPI๋ Starlette๊ณผ Pydantic ๋ผ๋ ๊ฑฐ์ธ์ ์ด๊นจ์ ํ๊ณ ์์ต๋๋ค. |
|||
|
|||
๋ค์์ ์คํฐ์๊ฐ ๋ ์ ์์ต๋๋ค |
|||
|
|||
* <a href="https://github.com/sponsors/samuelcolvin" class="external-link" target="_blank">Samuel Colvin (Pydantic)</a> |
|||
* <a href="https://github.com/sponsors/encode" class="external-link" target="_blank">Encode (Starlette, Uvicorn)</a> |
|||
|
|||
--- |
|||
|
|||
๊ฐ์ฌํฉ๋๋ค! ๐ |
|||
|
Loadingโฆ
Reference in new issue