fastapi 소개

FastAPI는 최근 몇 년간 빠르게 인기를 얻고 있는 Python 기반의 웹 프레임워크이다. 여기서 FastAPI의 주요 기능과 장점, 그리고 이를 사용하여 간단한 API를 만드는 방법을 살펴보자.

FastAPI란?

FastAPI는 Python 3.7+을 기반으로 한 현대적인 웹 프레임워크로, 고성능, 쉬운 사용성, 자동화된 문서화 기능을 제공한다. FastAPI는 Starlette과 Pydantic을 사용하여 높은 성능과 강력한 데이터 검증을 가능하게 한다. 이 프레임워크는 특히 비동기 프로그래밍을 쉽게 할 수 있게 해주며, API 개발을 더욱 효율적으로 만들어준다.

FastAPI의 주요 특징

고성능: FastAPI는 Uvicorn을 통해 ASGI 서버에서 실행되며, 동시성 처리를 위해 비동기 코드를 자연스럽게 사용할 수 있다. 이는 FastAPI가 업계 최고 수준의 성능을 자랑하는 이유 중 하나이다.
자동화된 문서화: FastAPI는 Swagger UI와 ReDoc를 통해 자동으로 API 문서를 생성해 준다. 개발자는 별도의 작업 없이 API 문서를 제공할 수 있어 매우 편리하다.
데이터 검증: Pydantic을 사용하여 입력 데이터의 타입을 엄격하게 관리하고 검증할 수 있다. 이는 API의 신뢰성과 안정성을 높이는 중요한 요소이다.
쉬운 사용성: FastAPI는 간결하고 직관적인 코드 작성이 가능하게 설계되었다. Python의 타입 힌트를 활용하여 자연스럽게 엔드포인트를 정의할 수 있다.

FastAPI 설치 및 기본 사용법

먼저 FastAPI를 설치해야 한다. pip를 사용하여 쉽게 설치할 수 있다:

pip install fastapi uvicorn

uvicorn은 ASGI 호환 서버로, FastAPI 애플리케이션을 실행하는 데 사용된다.

첫 번째 FastAPI 애플리케이션 만들기

이제 간단한 "Hello, World!" API를 만들어 보자.

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Hello, World!"}

위 코드에서 @app.get("/") 데코레이터는 GET 요청이 루트 경로로 들어올 때 실행되는 함수를 정의한다. 이 함수는 {"message": "Hello, World!"}라는 JSON 응답을 반환한다.

이 애플리케이션을 실행하려면 다음 명령어를 사용하자:

uvicorn main:app --reload

위 명령어는 main.py 파일에 있는 app 객체를 실행하며, 코드 변경 시 자동으로 재시작되도록 --reload 옵션을 추가했다.

API 문서 확인하기

서버가 실행 중이라면 웹 브라우저에서 http://127.0.0.1:8000/docs로 이동해 보자. FastAPI는 Swagger UI를 통해 자동으로 생성된 API 문서를 제공한다. 또한 http://127.0.0.1:8000/redoc에서 ReDoc을 사용할 수도 있다.

FastAPI의 장점

빠른 개발 속도: FastAPI는 개발자가 쉽게 학습하고 빠르게 작업을 시작할 수 있게 해준다. 이는 프로젝트의 초기 개발 속도를 크게 향상시킬 수 있다.
자동 데이터 검증: 데이터 검증이 자동으로 이루어지기 때문에 오류가 줄어들고, 코드의 가독성과 유지보수성이 높아진다.
강력한 커뮤니티 지원: FastAPI는 활발한 커뮤니티와 풍부한 문서화를 제공하여 개발자가 문제를 쉽게 해결할 수 있도록 돕는다.
비동기 지원: FastAPI는 비동기 처리를 기본적으로 지원하며, 이는 대규모 트래픽을 처리해야 하는 애플리케이션에서 매우 유용하다.