빠른 시작: Visual Studio의 템플릿에서 Python 프로젝트 만들기

이 빠른 시작에서는 기본 제공 Python 프로젝트 템플릿을 사용하여 Flask 애플리케이션을 빠르게 만드는 안내 단계를 따릅니다. Visual Studio를 사용하면 Flask, Django 및 Bottle을 비롯한 여러 Python 프레임워크의 템플릿에서 상용구 코드 및 기능을 사용하여 Python 프로젝트를 쉽게 개발할 수 있습니다. 이 문서에 설명된 Python 프로젝트는 빠른 시작: Flask를 사용하여 웹 앱 만들기 문서를 통해 수동으로 만드는 프로젝트와 유사합니다.

필수 조건

  • Python 워크로드에 대한 지원과 함께 설치된 Visual Studio.

    Visual Studio 설치 관리자 웹 프로젝트 템플릿에 액세스하기 위해 Python 개발 워크로드 및 Python 웹 지원 옵션을 선택합니다. 자세한 내용은 Visual Studio에서 Python 지원 설치를 참조하세요.

    Python 개발 워크로드를 위해 Visual Studio 설치 관리자에서 Python 웹 지원을 선택하는 방법을 보여주는 스크린샷.

Mac용 Visual Studio는 지원되지 않습니다. 자세한 내용은 Mac용 Visual Studio 무슨 일이 일어나고 있는지?를 참조하세요. Windows, Mac 및 Linux의 Visual Studio Code는 사용 가능한 확장을 통해 Python에서 잘 작동합니다.

프로젝트 만들기

다음 절차에 따라 Visual Studio 솔루션 및 새 Flask 웹 프로젝트를 만듭니다.

  1. Visual Studio에서 파일>새로 만들기>프로젝트를 선택하고 "Flask"를 검색합니다. 빈 Flask 웹 프로젝트 템플릿을 선택하고 다음을 선택합니다.

    Visual Studio 2022에서 빈 Flask 웹 프로젝트 템플릿을 선택하는 방법을 보여 주는 스크린샷.

  2. Visual Studio에 프로젝트 구성 대화 상자가 표시됩니다. 프로젝트 이름을 입력하고 만들기를 선택합니다. 다른 필드는 기본값으로 그대로 둘 수 있습니다.

    Visual Studio 2022에서 새로운 빈 Flask 웹 프로젝트를 구성하는 방법을 보여주는 스크린샷.

  3. 잠시 후 Visual Studio는 패키지 종속성을 처리하는 방법에 대한 프롬프트를 표시합니다. 프롬프트는 패키지 종속성이 이미 설치되어 있는지 여부에 따라 다릅니다.

    이 프로젝트에는 외부 패키지가 필요합니다 대화 상자는 선택한 템플릿에 Flask 패키지에 대한 종속성을 지정하는 requirements.txt 파일이 포함되어 있음을 나타냅니다. Visual Studio에서는 패키지를 자동으로 설치할 수 있으므로 패키지를 가상 환경에 설치하는 옵션이 제공됩니다. 전역 환경에 설치하는 것보다 가상 환경을 사용하는 것이 좋습니다.

    이 대화 상자가 표시되면 가상 환경에 설치 옵션을 선택합니다.

    Visual Studio의 가상 환경에 필요한 패키지 종속성을 설치하라는 프롬프트의 스크린샷.

    또는 Visual Studio 창 상단에 Python 패키지 사양 파일 "requirements.txt"가 프로젝트 <프로젝트 이름>에서 감지되었습니다.라는 메시지가 표시될 수 있습니다. 이 프롬프트는 패키지 종속성을 구성에서 이미 사용할 수 있음을 나타냅니다. Visual Studio는 기존 구성에서 가상 환경을 만들 수 있습니다.

    이 프롬프트가 표시되면 가상 환경 만들기 옵션을 선택합니다.

    Visual Studio에서 프로젝트에 대한 요구 사항 파일이 검색되었음을 나타내는 프롬프트의 스크린샷.

  4. Visual Studio에서는 환경 추가 대화 상자를 표시합니다. 기본값을 수용하고, 만들기를 선택한 다음, 권한 상승 요청에 동의합니다.

    Visual Studio 2022에서 Flask 프로젝트에 대한 가상 환경을 추가하는 방법을 보여 주는 스크린샷.

  1. Visual Studio에서 파일>새로 만들기>프로젝트를 선택합니다.

  2. 새 프로젝트 대화 상자에서 "빈 Flask"를 검색합니다. 가운데 목록에서 빈 Flask 웹 프로젝트 템플릿을 선택하고 프로젝트 이름을 입력한 다음 확인을 선택합니다.

    빈 Flask 웹 프로젝트 템플릿을 선택하여 Visual Studio에서 새 Flask 앱을 만드는 방법을 보여 주는 스크린샷.

  3. 잠시 후 Visual Studio에 프롬프트가 표시됩니다.

    이 프로젝트에는 외부 패키지가 필요합니다 대화 상자는 선택한 템플릿에 Flask 패키지에 대한 종속성을 지정하는 requirements.txt 파일이 포함되어 있음을 나타냅니다. Visual Studio에서는 패키지를 자동으로 설치할 수 있으므로 패키지를 가상 환경에 설치하는 옵션이 제공됩니다. 전역 환경에 설치하는 것보다 가상 환경을 사용하는 것이 좋습니다.

    이 대화 상자가 표시되면 가상 환경에 설치 옵션을 선택합니다.

    Visual Studio의 가상 환경에 필요한 패키지 종속성을 설치하라는 프롬프트의 스크린샷.

    또는 Visual Studio 창 상단에 Python 패키지 사양 파일 "requirements.txt"가 프로젝트 <프로젝트 이름>에서 감지되었습니다.라는 메시지가 표시될 수 있습니다. 이 프롬프트는 패키지 종속성을 구성에서 이미 사용할 수 있음을 나타냅니다. Visual Studio는 기존 구성에서 가상 환경을 만들 수 있습니다.

    이 프롬프트가 표시되면 가상 환경 만들기 옵션을 선택합니다.

    Visual Studio에서 프로젝트에 대한 요구 사항 파일이 검색되었음을 나타내는 프롬프트의 스크린샷.

  4. Visual Studio에서는 환경 추가 대화 상자를 표시합니다. 기본값을 수용하고, 만들기를 선택한 다음, 권한 상승 요청에 동의합니다.

    Visual Studio에서 Flask 프로젝트에 대한 가상 환경을 추가하는 방법을 보여 주는 스크린샷.

프로젝트를 시작하는 경우 대부분의 Visual Studio 템플릿에서 요청한 대로 바로 가상 환경을 만드는 것이 좋습니다. 라이브러리를 추가하고 제거하면 가상 환경에서는 시간이 지남에 따라 프로젝트의 정확한 요구 사항을 유지 관리합니다. 소스 제어를 사용하는 경우와 같이, 프로덕션 서버에 프로젝트를 배포할 때 다른 개발 컴퓨터에 해당 종속성을 다시 설치하는 데 사용하는 requirements.txt 파일을 쉽게 생성할 수 있습니다. 가상 환경 및 해당 혜택에 대한 자세한 내용은 가상 환경 사용requirements.txt를 사용하여 필수 패키지 관리를 참조하세요.

상용구 코드 검사

이 섹션에서는 선택한 템플릿에 대해 Visual Studio에서 만드는 Flask 프로젝트 파일(.py)에서 상용구 코드를 검사합니다.

  1. 솔루션 탐색기를 열어 솔루션 및 Flask 프로젝트 파일을 봅니다. 초기 프로젝트에는 app.pyrequirements.txt 두 개의 파일만 포함됩니다.

    솔루션 탐색기의 초기 Flask 프로젝트 파일을 보여 주는 스크린샷.

    requirements.txt 파일은 Flask 패키지 종속성을 지정합니다. 이 파일은 처음으로 프로젝트를 만들 때 가상 환경을 만들도록 초대하는 데 필요합니다.

    단일 app.py 파일에는 빈 Flask 웹 프로젝트에 대한 상용구 코드가 포함되어 있습니다. 템플릿은 빠른 시작 - Flask 문서를 사용하여 웹앱 만들기의 설명과 유사한 코드를 제공하며 몇 가지 섹션이 추가되었습니다.

  2. 편집기 에서 app.py 파일을 열고 위쪽 섹션을 검사합니다.

    코드는 Flask 패키지에 대한 import 문으로 시작합니다. 이 문은 변수 app에 할당되는 Flask 클래스의 인스턴스를 만듭니다.

    from flask import Flask
    app = Flask(__name__)
    

    다음으로, 코드는 Flask 앱을 웹 호스트에 배포할 때 유용한 wsgi_app 변수를 할당합니다.

    # Make the WSGI interface available at the top level so wfastcgi can get it.
    wsgi_app = app.wsgi_app
    
  3. 중간 섹션에서는 URL 경로에 함수를 할당합니다. 즉, 함수는 URL로 식별된 리소스를 제공합니다. 이 경우 경로는 뷰를 정의합니다.

    @app.route('/')
    def hello():
        """Renders a sample page."""
        return "Hello World!"
    

    사이트 루트의 상대 URL인 인수와 함께 Flask의 @app.route 데코레이터를 사용하여 경로를 정의합니다. 코드에서 볼 수 있듯이 함수는 브라우저에서 렌더링할 수 있는 텍스트 문자열만 반환합니다.

  4. 아래쪽 섹션에는 Flask 개발 서버를 시작하는 선택적 코드가 포함되어 있습니다. 호스트와 포트를 하드 코딩하는 대신 환경 변수를 통해 설정할 수 있습니다. 이러한 코드를 사용하면 코드를 변경하지 않고 개발 및 프로덕션 컴퓨터 모두에서 구성을 쉽게 제어할 수 있습니다.

    if __name__ == '__main__':
        import os
        HOST = os.environ.get('SERVER_HOST', 'localhost')
        try:
            PORT = int(os.environ.get('SERVER_PORT', '5555'))
        except ValueError:
            PORT = 5555
        app.run(HOST, PORT)
    
  5. 디버그>디버깅하지 않고 시작을 선택하여 Flask 앱을 실행하고 브라우저에서 기본 호스트 및 포트 값 localhost:5555를 엽니다.

Visual Studio에서 Python 템플릿 살펴보기

Python 워크로드를 설치할 때 Visual Studio는 Flask, Bottle 및 Django 웹 프레임워크 및 Azure 클라우드 서비스에 대한 다양한 프로젝트 템플릿을 제공합니다. 또한 다양한 기계 학습 시나리오에 대한 템플릿과 Python 애플리케이션을 포함하는 기존 폴더 구조에서 프로젝트를 만드는 템플릿도 있습니다. 파일>새로 만들기>프로젝트 메뉴 옵션을 사용하여 템플릿에 액세스할 수 있습니다. Python 언어 노드 및 해당 자식 노드를 선택하여 사용 가능한 템플릿을 확인합니다.

또한 Visual Studio에서는 다양한 파일 또는 항목 템플릿을 제공하여 Python 클래스, Python 패키지, Python 단위 테스트, web.config 파일 등을 신속하게 만듭니다. Python 프로젝트가 열려 있는 경우 프로젝트>새 항목 추가 메뉴 옵션을 사용하여 항목 템플릿에 액세스합니다. 자세한 내용은 항목 템플릿 참조를 참조하세요.

프로젝트를 사용하면 프로젝트를 시작허가나 파일을 만들 때 시간을 대폭 절약할 수 있습니다. 다양한 앱 형식 및 코드 구조에 대해 알아볼 수 있는 좋은 방법이기도 합니다. 제공되는 기능에 익숙해지도록 다양한 템플릿으로 프로젝트 및 항목을 만드는 데 몇 분이 걸릴 수 있습니다.

Cookiecutter 템플릿 사용

Visual Studio는 Cookiecutter와 직접 통합되어 템플릿, 입력 템플릿 옵션을 검색하고 프로젝트 및 파일을 만드는 데 도움이 됩니다. 자세한 내용은 빠른 시작: Cookiecutter 템플릿 문서에서 프로젝트 만들기를 참조하세요.