Python FastAPI

SeHun.J·2024년 7월 8일

Feature

ASGI를 사용한다. (Uvicorn)
빠르다, 코드가 간단하다, 버그가 적다.
자동으로 API를 문서화한다.
ORM 라이브러리를 지원한다. (ex. SQLAlchemy)
비동기 코드를 작성할 수 있다.
Type Hint를 적극 활용한다.

Install

필요한 라이브러리를 먼저 설치합니다.

pip install fastapi uvicorn
or
pip install "fastapi[all]"

Code

서버 만들기

# main.py
from fastapi import FastAPI

app = FastAPI()

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)

서버 실행을 위한 가장 최소한의 코드입니다.
ASGI인 uvicorn을 통해 앱을 실행하면 됩니다. 코드 수정을 감지해서 바로 서버에 갱신되게 하고 싶다면, reload=True 옵션을 넣어주시면 됩니다.

API 만들기

우선, 폴더구조를 아래와 같이 진행했습니다.

fastapi
├ api
│　└ endpoint.py
├ main.py
└ requirements.txt

# api/endpoint.py
from fastapi import APIRouter

# router를 통해, app에 등록하는 방식
router = APIRouter()


@router.get("/unixtime")
def get_unixtime():
    from datetime import datetime, timezone, timedelta

    # 한국 시간 (KST) 타임존 설정
    kst = timezone(timedelta(hours=9))
    unix_time = int(datetime.now(kst).timestamp())

    return {
        "unixtime": unix_time
    }

간단하게 한국 시간대를 기준으로 unixtime을 반환하는 API 코드입니다.

# main.py
from fastapi import FastAPI
from api.unixtime import router as unix_router

app = FastAPI()
# router를 import하고 app에 등록함.
app.include_router(unix_router)

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)