Chapter 1-6 Flask 프로젝트 세팅

📌 Flask 프로젝트 세팅

Flask 프로젝트를 설정하는 과정은 간단하지만, 단계별로 잘 정리된 환경 구성이 필요합니다. 아래에서 Flask 프로젝트 세팅을 위한 단계들을 설명하겠습니다.

---

1. 프로젝트 폴더 생성

먼저, Flask 프로젝트를 위한 디렉토리를 생성합니다. 아래의 명령어로 폴더를 만들고 이동합니다.

> mkdir class-flask-backend # 폴더 생성
> cd class-flask-backend # 폴더 이동

• 또는, 바탕화면에서 폴더를 생성할 수도 있습니다.
• 위 명령어는 유닉스 기반 시스템(리눅스, macOS) 또는 윈도우의 PowerShell에서도 실행 가능합니다.

---

2. 가상 환경 (Virtual Environment)

가상 환경을 생성하여, 프로젝트의 의존성을 관리할 수 있습니다. 각 방법을 소개합니다.

Poetry (추천)

> poetry init
> poetry add flask

Conda

> conda create -n test_env python=3.10

venv (기본 내장 모듈)

python3.10 -m venv .venv
source .venv/bin/activate  # Linux / macOS
cd .\venv\Scripts\activate # Windows

• venv 모듈은 파이썬에 기본 내장된 모듈로, 가상 환경을 손쉽게 만들 수 있습니다.
• 가상 환경을 만들고 활성화한 후, 프로젝트의 의존성은 이 가상 환경 내에서만 설치됩니다.

python -m venv .venv
source .venv/Scripts/activate

• windows 용

VSC에서 Python Interpreter 선택 방법

• Mac: Command + Shift + P
• Windows: Control + Shift + P

그 후, python interpreter를 검색하여 ./venv/bin/python을 선택합니다.

---

3. requirements.txt 사용

**requirements.txt**는 프로젝트에 필요한 패키지들의 목록을 포함한 파일로, 다른 개발자가 동일한 패키지 버전을 쉽게 설치할 수 있도록 도와줍니다. 이 파일을 사용해 프로젝트를 공유하거나 배포할 때 유용합니다.

• 패키지 목록을 작성하려면 아래 명령어를 사용합니다:

pip freeze > requirements.txt

• 다른 환경에서 의존성을 설치하려면:

pip install -r requirements.txt

---

4. Flask 모듈 설치

Flask 프레임워크를 설치합니다. 설치 전에 반드시 가상 환경을 활성화하세요.

> pip install flask

• 설치 경로는 .venv 폴더 안에 있는 lib 폴더에서 확인할 수 있습니다.

---

5. app.py 생성

Flask 애플리케이션을 시작하는 첫 번째 파일인 app.py를 생성합니다. 이 파일은 Flask 서버를 실행하고 라우팅을 설정하는 역할을 합니다.

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello_world():
    return "Hello, World!"

• __name__: Python에서 __name__은 현재 모듈의 이름을 나타내는 특별한 변수입니다. Flask에서는 이 변수를 사용하여 애플리케이션을 초기화합니다.
• app.route('/')는 기본 URL(localhost:5000)에 접근했을 때 실행될 함수 hello_world()를 정의합니다.

---

6. Flask 실행

애플리케이션을 실행하는 방법은 여러 가지가 있습니다. 아래 명령어들을 통해 서버를 시작할 수 있습니다:

> python -m flask

 

또는

> flask run

 

혹은 Flask 앱 파일을 직접 지정하여 실행할 수도 있습니다:

> flask --app app.py --debug run

• 기본적으로 Flask는 127.0.0.1:5000에서 애플리케이션을 실행합니다.
• **127.0.0.1**은 로컬호스트 주소로, 실제로는 자신의 컴퓨터를 서버로 만드는 것입니다.

특정 포트와 호스트 설정하기

만약 Flask의 host와 port를 변경하고 싶다면, app.run() 메서드를 사용하여 설정할 수 있습니다.

from flask import Flask

app = Flask(__name__)

host = '127.0.0.1'
port = '8000'

if __name__ == "__main__":
    app.run(host=host, port=port)

이렇게 하면 localhost:8000에서 Flask 애플리케이션을 실행할 수 있습니다.

---

7. Flask 실행 방법 차이

Flask 애플리케이션을 실행하는 방법에 따라 차이가 있습니다:

1. 직접 실행: python your_app.py 명령어로 실행할 수 있습니다. 이는 간단한 경우에 사용됩니다.
2. flask run 명령어 사용: flask run 명령어는 개발 서버를 사용하여 애플리케이션을 실행합니다. 이 명령어는 코드 변경을 감지하여 서버를 자동으로 다시 시작하는 등의 개발 환경에서 유용한 기능을 제공합니다.

flask run

---

✅ 마무리

위 단계를 통해 Flask 프로젝트를 설정하고 실행하는 방법을 익혔습니다. 가상 환경을 설정하고 필요한 패키지를 설치한 뒤, 간단한 Flask 애플리케이션을 작성하고 실행할 수 있습니다. Flask는 그 자체로도 매우 유용한 프레임워크지만, 더 복잡한 기능을 구현하려면 다양한 플러그인과 미들웨어를 활용할 수 있습니다.