FastAPI - 01 (FastAPI란?)
출처: https://fastapi.tiangolo.com/
아래의 내용은 공식 사이트의 내용을 제 경험과 생각을 추가하여 다시 정리한 것 입니다.
FastAPI란?
공식 사이트
문서: https://fastapi.tiangolo.com/
소스코드: https://github.com/tiangolo/fastapi
FastAPI는 Python 3.6 이상을 지원하는 빠른 웹 프레임워크.
API 개발에 중점(RESTful API를 구축에 적합).
‘Starlette’의 비동기 프로그래밍 기능 이용.
‘Pydantic’: Python 코드에 최적화.
빠른 성능, 쉬운 사용, 그리고 뛰어난 오류 발견 기능을 제공.
주요 특징
빠름 - Starlette과 Pydantic으로 빠름
빠른 코드 작성
적은 버그 - 개발자에 의한 에러 감소
직관적
쉬움
짧음
견고함
표준 기반 - API에 대한 개방형 표준 기반
설치
FastAPI 패키지 설치
pip install "fastapi[all]”
# 또는
# pip3 install "fastapi[all]”
또는 패키지 각각 설치
pip install fastapi
pip install "uvicorn[standard]”
첫 번째 application
출처: https://fastapi.tiangolo.com/tutorial/first-steps/
Hello World
from fastapi import FastAPI
app = FastAPI() # FastAPI의 인스턴스 객체 app를 생성.
@app.get("/") # 경로 동작 데코레이터 (url 주소)
async def root(): # 경로 동작 함수
return {"message": "Hello World"} # json Type으로 return
FastAPI
임포트
app
인스턴스 생성
(@app.get("/")
) ’경로(url) 동작 데코레이터’ 작성
(def root(): ...
) ’경로 동작 함수’ 작성 (데코레이터 바로 밑에)
서버 실행
uvicorn main:app --reload
main
: 실행 되어야 할 python file(main.py
) 입니다.
app
: FastAPI()로 생성한 객체 명 (app = FastAPI()
) 입니다.
-reload
: 코드가 변경 되었을 때 변경 내용을 자동으로 반영합니다. 개발 시에만 사용 해야 합니다.
원격서버에서 위의 명령어를 실행하고 외부에서 원격서버에 접근하면 접근이 되지 않습니다. 아래와 같이 접근 가능한 호스트와 포트를 지정 할 수 있습니다.
uvicorn main:app --reload --host 0.0.0.0 --port=8503
--host 0.0.0.0
: 외부의 모든 ip에서 접근 가능 하게 합니다.
--port=8503
: 서비스의 포트를 변경합니다.
결과
http://127.0.0.1:8000
위의 url로 접속 하면 아래의 결과가 나옵니다.
{"message": "Hello World"}
원격 서버의 경우는 아래와 같은 형식으로 접속 합니다.
http://원격서버주소:지정한포트번호
원격 서버의 방화벽이 지정한 포트 번호를 허용 해야 합니다.
서버 종료
Ctrl + c
대화형 API 문서 자동 생성
대화형 API 문서를 자동으로 생성하고 제공합니다.
아래의 url로 접속 하시면 됩니다.
http://127.0.0.1:8000/docs
아래는 대화형 API 문서의 예시 입니다.
출처: https://fastapi.tiangolo.com/tutorial/first-steps/
해시태그: #fastapi #uvicorn #api doucument
댓글남기기