Chapter 1 - FastAPI 시작: 설치와 개발 환경 준비

현대의 웹 개발 환경에서는 단지 코드 한 줄을 작성하는 것을 넘어, 효율적이고 체계적인 개발 환경 구축이 필수적입니다. FastAPI로 웹 애플리케이션을 개발하기 위해 가장 먼저 해야 할 일은 최소한의 준비와 올바른 개발 환경을 세팅하는 것입니다.

Python 최신 버전 설치

FastAPI는 Python의 최신 기능을 십분 활용하는 프레임워크입니다. 공식적으로 Python 3.7 이상이면 실행이 가능하지만, 각종 라이브러리 호환성과 보안성, 프로젝트의 장기적 유지를 위해서는 Python 3.10 이상의 설치를 권장합니다. Python 공식 홈페이지에 접속하여 운영체제에 맞는 설치 파일을 내려받고, 설치 후에는 터미널 또는 명령 프롬프트에서 python --version 명령으로 정상 설치 여부를 확인합니다.

가상환경 구성의 중요성

여러 프로젝트를 동시에 진행하다 보면 각각의 프로젝트에서 요구하는 라이브러리 버전이 충돌할 수 있습니다. 이를 방지하기 위해 Python의 venv 또는 pyenv와 같은 도구로 프로젝트별 가상 환경을 만들면, 라이브러리 의존성을 안전하게 분리할 수 있습니다. 예시로, 프로젝트 폴더에서 다음과 같이 환경을 만듭니다:

python -m venv venv
source venv/bin/activate  # macOS/Linux
venv\Scripts\activate    # Windows

가상환경을 활성화한 후에는 패키지 설치가 모두 이 환경 내에서 이루어집니다.

FastAPI와 핵심 라이브러리 설치

가상환경이 준비되었다면 웹 프레임워크인 FastAPI와 ASGI 서버인 Uvicorn을 설치해야 합니다. Uvicorn은 FastAPI 애플리케이션을 실제로 실행하는 데 필수적인 서버입니다. 아래 명령어로 두 라이브러리를 간단하게 설치할 수 있습니다.

pip install fastapi uvicorn

필요에 따라 코드 스타일 점검을 위한 ruff나 pre-commit 훅 등 추가 도구들도 설치할 수 있지만, 본격적인 개발에 앞서 먼저 FastAPI의 기본 동작을 익히는 것이 우선입니다.

첫 번째 FastAPI 애플리케이션 작성

설치가 끝나면 바로 FastAPI의 효율성을 경험해 볼 차례입니다. main.py라는 파일을 만들어 아래와 같이 작성해 보세요.

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "FastAPI에 오신 것을 환영합니다!"}

이제 터미널에서 다음 명령어로 서버를 실행합니다:

uvicorn main:app --reload

--reload 옵션을 사용하면 코드가 변경될 때마다 서버가 자동으로 재시작되어 개발이 아주 편리해집니다.

브라우저를 통한 테스트와 자동 문서화

이제 http://localhost:8000으로 접속하면 방금 만든 간단한 API의 응답을 바로 확인할 수 있습니다. 또한 FastAPI는 Swagger 기반의 자동 문서도 함께 제공합니다. http://localhost:8000/docs로 접속하면 시각적으로 API를 테스트하고 구조를 파악할 수 있습니다.

마치며

FastAPI로 마스터의 길을 걷기 위해 첫걸음은 올바른 환경 구성에서 시작합니다. 깔끔한 환경을 갖추는 것만으로도 이후 개발 및 배포 단계에서 겪을 수 있는 수많은 문제를 미연에 방지할 수 있습니다. 개발의 기본기를 튼튼하게 닦고, FastAPI의 강력한 기능들을 기초부터 차근차근 마스터해봅시다.