✅

240706_1306_[Python] FastAPI & Uvicorn

FastAPI

•

FastAPI는 현대적인 고성능 웹 프레임워크로, Python을 기반으로 한다.

•

FastAPI는 빠른 개발 속도와 높은 성능을 제공하며, 특히 비동기 처리를 지원하여 효율적인 애플리케이션 개발에 유리하다.

주요 특징

고성능

•

FastAPI는 ASGI(Asynchronous Server Gateway Interface) 표준을 따르며, Uvicorn 또는 Hypercorn과 같은 고성능 ASGI 서버와 함께 사용된다.

•

비동기 I/O를 활용하여 높은 처리량과 낮은 대기 시간을 제공한다.

자동화된 데이터 검증 및 문서화

•

FastAPI는 Pydantic을 사용하여 데이터 검증을 자동화한다.

•

OpenAPI와 JSON Schema를 자동으로 생성하여, API 문서를 쉽게 생성하고 유지할 수 있다.

빠른 개발 속도

•

간결하고 직관적인 코드를 작성할 수 있어 개발 속도가 빠르다.

•

타입 힌팅을 사용하여 IDE의 자동 완성 기능을 최대한 활용할 수 있다.

비동기 지원

•

Python의 비동기 기능(Async/Await)을 완벽히 지원하여, 비동기 처리가 필요한 애플리케이션에 적합하다.

보안

•

OAuth2, JWT 등의 인증 시스템을 쉽게 통합할 수 있다.

•

CORS, CSRF 등의 보안 기능도 쉽게 설정할 수 있다.

설치 및 기본 사용 예시

•

FastAPI를 설치하려면 pip를 사용한다.

pip install fastapi uvicorn
Shell
복사

•

FastAPI 애플리케이션을 작성하는 기본 예시는 다음과 같다

# main.py
from fastapi import FastAPI

app = FastAPI()

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

@app.get("/items/{item_id}")
def read_item(item_id: int, q: str = None):
    return {"item_id": item_id, "q": q}
Python
복사

•

이 애플리케이션을 Uvicorn을 사용하여 실행하려면 다음 명령어를 사용한다.

uvicorn main:app --reload
Shell
복사

•

위 명령어는 main.py 파일의 app 객체를 실행하고, 코드 변경 시 자동으로 서버를 재시작한다.

API 문서

•

FastAPI는 자동으로 API 문서를 생성한다.

•

서버를 실행한 후 브라우저에서 다음 URL로 접속할 수 있다:

◦

Swagger UI: http://127.0.0.1:8000/docs

◦

Redoc: http://127.0.0.1:8000/redoc

고급 기능

•

FastAPI는 다음과 같은 고급 기능도 제공한다.

◦

경로 작업(Path Operations): 다양한 HTTP 메서드(GET, POST, PUT, DELETE 등)를 지원하는 경로 작업을 정의할 수 있다.

◦

의존성 주입: 의존성 주입을 통해 코드의 재사용성과 테스트 용이성을 높일 수 있다.

◦

백그라운드 작업: 백그라운드에서 실행할 작업을 정의하고 관리할 수 있다.

◦

웹소켓: 실시간 통신을 위한 웹소켓을 쉽게 구현할 수 있다.

요약

•

FastAPI는 현대적인 웹 애플리케이션 개발을 위한 강력한 도구로, 높은 성능과 편리한 개발 경험을 제공한다.

•

 특히 비동기 처리와 자동화된 데이터 검증 및 문서화 기능이 뛰어나, 빠르고 효율적인 애플리케이션 개발이 가능하다.

Uvicorn

•

Uvicorn은 다음과 같은 특징을 가지고 있다.

ASGI 서버: Uvicorn은 ASGI(Asynchronous Server Gateway Interface)를 구현한 서버로, 비동기 Python 웹 프레임워크(예: FastAPI, Starlette)를 실행하는 데 사용된다. ASGI는 WSGI의 비동기 버전으로, 비동기 처리를 지원하여 더 높은 성능을 제공한다.

고성능: Uvicorn은 Cython과 함께 구현되어 매우 빠른 속도를 자랑한다. 이는 높은 처리량과 낮은 대기 시간을 요구하는 애플리케이션에 적합하다.

간편한 사용: 설정과 사용이 간편하며, 개발 및 배포 환경에서 모두 사용할 수 있다.

주요 특징

•

HTTP/2 및 WebSocket 지원: HTTP/2와 WebSocket을 지원하여 실시간 애플리케이션 개발에 유리하다.

•

자동 리로딩: 개발 중 코드 변경 시 서버를 자동으로 재시작하여 개발 편의성을 높인다.

•

고성능 비동기 처리: 비동기 I/O를 효율적으로 처리하여 고성능 애플리케이션을 구축할 수 있다.

•

유연성: 다양한 Python 웹 프레임워크와 함께 사용할 수 있으며, ASGI 표준을 따르기 때문에 호환성이 좋다.

설치 및 사용 예시

•

Uvicorn은 pip를 통해 설치할 수 있다.

pip install uvicorn
Shell
복사

•

Uvicorn을 사용하여 FastAPI 애플리케이션을 실행하는 예시는 다음과 같다.

# main.py
from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}
Python
복사

•

위와 같은 FastAPI 애플리케이션을 Uvicorn으로 실행하려면 다음 명령어를 사용한다:

uvicorn main:app --reload
Shell
복사

•

-reload 옵션은 코드 변경 시 서버를 자동으로 재시작하는 개발 모드 옵션이다.

요약

•

Uvicorn은 Python 비동기 웹 프레임워크를 위한 고성능 ASGI 서버로, 간편한 설정과 높은 성능을 제공한다.

•

FastAPI, Starlette 등과 함께 사용하여 현대적인 비동기 웹 애플리케이션을 개발하는 데 적합하다.

안녕하세요

•

한국전자기술연구원 김영광입니다.

•

관련 기술 문의와 R&D 공동 연구 사업 관련 문의는 “glory@keti.re.kr”로 연락 부탁드립니다.

Hello

•

I'm Yeonggwang Kim from the Korea Electronics Research Institute.

•

For technical and business inquiries, please contact me at “glory@keti.re.kr”

GloryKim - Overview

Kubeflow, Tensorflow, Front-End, IoTivity, Go, Microservice Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec Jan Mon Wed Fri Created 14 commits in 4 repositories Opened their first pull request on GitHub in a private repository First pull request Opened 1 other pull request in 1 repository Reviewed 1 pull request in 1 repository GloryKim/Go 1 pull request Opened their first issue on GitHub in a private repository First issue 246 contributions in private repositories Jan 1 - Jan 26 You can't perform that action at this time.