FastAPI를 사용한 기본 웹 애플리케이션 생성
첫 번째 FastAPI 웹 애플리케이션 만들기
여기서는 FastAPI를 이용하여 간단한 웹 애플리케이션을 만들어 보겠습니다. 이 장에서는 FastAPI가 제공하는 기본적이고 강력한 기능들을 경험하며, 웹 애플리케이션 개발이 얼마나 쉽게 이루어질 수 있는지 배웁니다.
1단계: 환경 셋업하기
FastAPI를 사용하기 위해 필요한 것을 준비합니다. FastAPI는 Python 3.6 이상에서 실행되므로 최신 버전의 Python이 설치되어 있어야 합니다. 설치가 안 되어 있다면 Python 공식 웹사이트를 방문하여 다운로드 할 수 있습니다.
가상환경을 설정하여 종속성을 관리하면 편리합니다. 터미널에서 아래 명령어를 실행하여 가상환경을 생성하고 활성화합니다:
python -m venv myenv
source myenv/bin/activate # Windows에서는 myenv\Scripts\activate 사용가상환경이 활성화된 상태에서 FastAPI를 설치합니다:
pip install fastapi uvicorn여기서 fastapi는 FastAPI 프레임워크 본체이며, uvicorn은 FastAPI 애플리케이션을 실행하기 위한 ASGI 서버입니다.
2단계: 기본 FastAPI 앱 만들기
다음으로, 간단한 FastAPI 애플리케이션을 작성합니다. 프로젝트 폴더에 main.py 파일을 생성하고, 아래와 같이 코드를 작성합니다:
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
async def read_root():
return {"message": "안녕하세요! FastAPI로 동작 중입니다."}
@app.get("/items/{item_id}")
async def read_item(item_id: int, q: str = None):
return {"item_id": item_id, "q": q}이 예제는 다음과 같은 두 가지 엔드포인트를 정의합니다:
/: 기본 엔드포인트로, 간단한 환영 메시지를 반환합니다./items/{item_id}: 아이템 ID 및 질의문(q)을 받아들여 해당 데이터를 반환합니다.
코드 작성 후, 애플리케이션을 실행하려면 터미널에서 다음 명령어를 실행합니다:
uvicorn main:app --reload3단계: Swagger UI로 API 확인
애플리케이션이 실행되고 나면 브라우저에서 http://127.0.0.1:8000로 이동하여 실행 중인 API를 테스트할 수 있습니다. URL 뒤에 /docs를 추가하면 FastAPI가 제공하는 Swagger UI를 통해 API 문서를 확인하고 테스트할 수 있습니다. FastAPI는 자동으로 API 문서를 생성해주므로, API의 동작 확인 및 사용이 매우 편리합니다.
마무리
이제 FastAPI를 사용하여 첫 간단한 웹 애플리케이션을 만들어 보았습니다. FastAPI의 뛰어난 성능과 직관적인 문법을 통해 웹 개발이 얼마나 효율적으로 이루어질 수 있는지 확인했을 것입니다. 이후 장에서는 더 복잡하며 현실적인 애플리케이션을 개발하는 방법에 대해 다룹니다.
