Sanic 헬로 월드 튜토리얼

Sanic에 들어가기 전에 시스템에 Python 3.7 이상 및 pip(Python의 패키지 설치 관리자)가 설치되어 있는지 확인하십시오. Sanic은 비동기 기능을 위해 최신 Python 기능에 크게 의존합니다.

터미널에서 다음 명령을 실행하여 Python 버전을 확인할 수 있습니다:

python3 --version

Python 3.x.x와 같은 출력이 표시되어야 합니다. Python을 설치하거나 업데이트해야 하는 경우 최신 버전에 대해 python.org를 방문하십시오.

가상 환경을 사용하는 것은 프로젝트 종속성을 효과적으로 관리하는 데 중요합니다. Sanic 프로젝트의 패키지가 다른 Python 프로젝트 또는 시스템 전체 설치와 충돌하지 않도록 보장합니다.

먼저 Sanic 프로젝트에 대한 새 디렉터리를 만들고 해당 디렉터리로 이동합니다:

mkdir sanic-hello-world
cd sanic-hello-world

다음으로 프로젝트 디렉터리 내에 가상 환경을 만듭니다:

python3 -m venv .venv

마지막으로 가상 환경을 활성화합니다:

# macOS/Linux에서
source .venv/bin/activate

# Windows(명령 프롬프트 사용)에서
.venv\Scripts\activate

이제 터미널 프롬프트에 (.venv)가 표시되어 가상 환경이 활성화되었음을 나타냅니다.

가상 환경이 활성화되면 이제 pip를 사용하여 Sanic 및 해당 종속성을 설치할 수 있습니다.

pip install sanic

이 명령은 시스템에서 사용 가능한 경우 uvloop 및 httptools를 포함하여 Sanic 및 모든 필수 구성 요소를 설치합니다.

이제 첫 번째 Sanic "Hello World" 애플리케이션을 만들어 보겠습니다. 프로젝트 디렉터리(sanic-hello-world)에서 main.py라는 새 파일을 만듭니다.

main.py를 즐겨 사용하는 코드 편집기에서 열고 다음 Python 코드를 추가합니다:

from sanic import Sanic, response

# Sanic 애플리케이션 인스턴스 생성
app = Sanic("HelloWorldSanicApp")

# 루트 URL("/")에 대한 라우트 정의
# 이 라우트는 GET 요청을 처리합니다.
@app.get("/")
async def hello_world(request):
    """
    루트 URL에 대한 GET 요청을 처리하고 "Hello, Sanic!" 메시지를 반환합니다.
    """
    return response.text("Hello, Sanic!")

# 애플리케이션 실행을 위한 진입점
if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8000, dev=True)

Sanic 애플리케이션이 어떻게 작동하는지 이해하기 위해 main.py 파일을 한 줄씩 살펴보겠습니다:

• from sanic import Sanic, response

  이 줄은 Sanic 라이브러리에서 필요한 구성 요소인 Sanic(애플리케이션 인스턴스를 생성하기 위한)과 response(HTTP 응답을 생성하기 위한)를 가져옵니다.

• app = Sanic("HelloWorldSanicApp")

  여기서 Sanic 애플리케이션 인스턴스를 생성합니다. 문자열 "HelloWorldSanicApp"은 애플리케이션의 이름으로, 디버깅 또는 로깅에 유용할 수 있습니다.

• @app.get("/")

  이것은 Sanic에게 바로 아래 함수를 HTTP GET 요청에 대한 루트 URL 경로("/")와 연결하도록 지시하는 데코레이터입니다. Sanic은 다른 HTTP 메서드에 대해 @app.post(), @app.put(), @app.delete() 등도 제공합니다.

• async def hello_world(request):

  이것은 hello_world라는 비동기 함수를 정의합니다. async 키워드는 Sanic에 중요하며, 차단 없이 요청을 동시에 처리할 수 있도록 합니다. 함수는 들어오는 HTTP 요청에 대한 세부 정보가 포함된 request 객체를 인수로 받습니다.

• return response.text("Hello, Sanic!")

  라우트 핸들러 내에서 response.text()를 사용하여 text/plain 콘텐츠 유형과 "Hello, Sanic!" 문자열을 본문으로 하는 HTTP 응답을 생성합니다. Sanic은 JSON 응답에 대한 response.json(), HTML에 대한 response.html() 등도 제공합니다.

• if __name__ == "__main__":

  이 표준 Python 구성은 스크립트가 직접 실행될 때(모듈로 가져올 때가 아님) 이 블록 안의 코드가 실행되도록 합니다.

• app.run(host="0.0.0.0", port=8000, dev=True)

  이 줄은 Sanic 웹 서버를 시작합니다.

  • host="0.0.0.0"은 서버를 모든 네트워크 인터페이스에서 액세스할 수 있도록 하여 Docker 또는 외부 액세스에 유용합니다. 로컬 개발의 경우 `127.0.0.1` 또는 `localhost`도 사용할 수 있습니다.
  • port=8000은 서버가 포트 8000에서 수신 대기함을 지정합니다.
  • dev=True는 개발 모드를 활성화하여 코드 변경 시 서버 자동 다시 로드 및 자세한 오류 메시지와 같은 기능을 포함합니다.

main.py 파일이 준비되었으므로 Sanic 서버를 시작할 수 있습니다. sanic-hello-world 디렉터리에 있고 가상 환경이 활성화되어 있는지 확인하십시오.

Sanic CLI를 사용하여 애플리케이션을 실행합니다:

python main.py

더 고급 구성을 위해 더 관용적인 `sanic` 명령줄 도구를 사용할 수도 있습니다. `if __name__ == "__main__": app.run(...)`을 포함했기 때문에 이 간단한 예제에서는 `python main.py` 명령으로 충분합니다. `sanic main.app --dev`로 실행하는 경우 애플리케이션 인스턴스는 자동으로 검색되도록 `app`으로 이름이 지정되어야 합니다. 이 가이드의 경우 `python main.py`가 더 간단하고 직접 작동합니다.

[INFO] Goin' Fast @ http://0.0.0.0:8000
[INFO] 중지하려면: CTRL+C
                            

Sanic 애플리케이션이 실행 중이므로 올바르게 응답하는지 테스트할 차례입니다. 웹 브라우저를 열고 다음으로 이동합니다:

http://127.0.0.1:8000/

브라우저에 "Hello, Sanic!" 텍스트가 표시되어야 합니다. 또는 curl과 같은 명령줄 도구를 사용할 수 있습니다:

curl http://127.0.0.1:8000/

터미널의 출력은 다음과 같아야 합니다:

Hello, Sanic!

축하합니다! Sanic으로 첫 번째 "Hello World" 애플리케이션을 성공적으로 만들고 실행했습니다.

Sanic 애플리케이션은 수동으로 중지할 때까지 터미널에서 계속 실행됩니다. 서버를 중지하려면 Sanic이 실행 중인 터미널로 돌아가서 다음을 누르십시오:

CTRL + C

이것은 서버 프로세스에 인터럽트 신호를 보내 정상적으로 종료되도록 합니다.

Sanic으로 첫 번째 "Hello World" 애플리케이션을 성공적으로 완료했습니다! 이 기초 지식은 Python으로 고성능 비동기 웹 서비스를 구축할 수 있는 무한한 가능성을 열어줍니다.

Sanic으로 다음 단계를 위한 몇 가지 아이디어가 있습니다:

• 동적 라우트: 경로 매개변수(예: /users/<user_id>)로 라우트를 만드는 방법을 배워 더 유연한 API를 구축하십시오.
• JSON 응답: response.json({"message": "Hello from Sanic!"})을 사용하여 구조화된 데이터를 반환합니다.
• 요청 데이터: 쿼리 매개변수(request.args), 폼 데이터(request.form) 및 JSON 본문(request.json)에 액세스합니다.
• 미들웨어: 각 요청 전후에 실행되는 함수를 구현하여 인증, 로깅 또는 데이터 수정을 처리합니다.
• 블루프린트: 대규모 프로젝트를 위해 애플리케이션을 모듈식 구성 요소로 구성합니다.
• 데이터베이스: Sanic을 비동기 데이터베이스 드라이버(PostgreSQL의 경우 asyncpg 또는 MySQL의 경우 aiomysql)와 통합하여 데이터베이스 작업을 수행합니다.
• 웹소켓: 실시간 WebSocket 통신에 대한 Sanic의 내장 지원을 탐색합니다.
• 배포: Docker, Uvicorn 워커가 있는 Gunicorn 또는 Sanic의 네이티브 서버를 사용하여 Sanic 애플리케이션을 프로덕션 환경에 배포하는 방법을 배웁니다.

Sanic의 공식 문서는 이러한 모든 기능 및 그 이상에 대한 자세한 내용을 살펴볼 수 있는 훌륭한 자료입니다.