이 빠른 시작에서는 단계별 단계에 따라 Python 코드의 GitHub 리포지토리를 복제하고 프로젝트를 만듭니다. Visual Studio를 사용하면 Git 명령을 사용하여 소스 제어에서 콘텐츠에 액세스하여 Python 프로젝트를 쉽게 사용할 수 있습니다. 명령줄에서 Python 코드 리포지토리를 복제한 다음 Visual Studio에서 프로젝트로 작업할 수도 있습니다.
필수 조건
- Python 워크로드를 지원하는 Visual Studio 2022가 설치되었습니다. Visual Studio 2022는 Git 명령을 지원하는 GitHub와 원활한 통합을 제공합니다. 자세한 내용은 Visual Studio에서 Python 지원 설치를 참조하세요.
Mac용 Visual Studio는 지원되지 않습니다. 자세한 내용은 Mac용 Visual Studio의 변경 내용을 참조하세요. Windows, Mac 및 Linux의 Visual Studio Code는 사용 가능한 확장을 통해 Python에서 잘 작동합니다.
기존 리포지토리 파일 복제
다음 단계를 사용하여 Visual Studio Git 소스 제어 명령을 사용하여 기존 리포지토리를 복제합니다.
Visual Studio에서 Git>복제를 선택합니다.
리포지토리 복제 대화 상자에서 복제할 GitHub 리포지토리를 지정합니다.
리포지토리 위치의 경우 복제할 리포지토리의 URL을 입력합니다. 이 작업에서
https://github.com/gregmalcolm/python_koans를 입력합니다.경로의 경우 Visual Studio에서 복제된 파일을 저장할 시스템의 폴더를 입력합니다.
지정한 폴더는 Visual Studio에서 사용할 정확한 폴더여야 합니다. 명령과
git clone달리 팀 탐색기에서 복제본을 만들 때 Visual Studio는 리포지토리 이름으로 새 하위 폴더를 자동으로 만들지 않습니다.준비가 되면 복제를 선택합니다.
복제가 완료되면 Visual Studio에서 리포지토리에 대한 Git 변경 내용 창을 엽니다. 솔루션 탐색기에서 복제된 리포지토리 파일이 있는 폴더를 볼 수도 있습니다.
Git>로컬 리포지토리를 선택하고 복제된 리포지토리가 목록에 있는지 확인합니다.
Visual Studio 팀 탐색기를 사용하여 기존 리포지토리를 복제하려면 다음 단계를 사용합니다.
Visual Studio에서팀 탐색기> 선택하여 팀 탐색기 창을 엽니다. 연결 페이지에서 GitHub 또는 Azure DevOps 리포지토리에 액세스하거나 리포지토리를 복제할 수 있습니다.
팀 탐색기가연결 페이지에서 열리지 않으면 Visual Studio 도구 모음에서 플러그 아이콘을 선택하여 페이지를 엽니다.
팀 탐색기 - 연결 페이지에서 로컬 Git 리포지토리 섹션을 확장하고 복제 옵션을 선택합니다.
리포지토리 위치의 경우 복제할 리포지토리의 URL을 입력합니다. 이 연습에서는
https://github.com/gregmalcolm/python_koans을 입력하세요.경로의 경우 Visual Studio에서 복제된 파일을 저장할 시스템의 폴더를 입력합니다.
지정한 폴더는 Visual Studio에서 사용할 정확한 폴더여야 합니다. 명령과
git clone달리 팀 탐색기에서 복제본을 만들 때 Visual Studio는 리포지토리 이름으로 새 하위 폴더를 자동으로 만들지 않습니다.재귀적으로 하위 모듈 복제 옵션을 선택합니다.
페이지 아래쪽에서 복제를 클릭합니다.
복제가 완료되면 리포지토리 이름이 로컬 Git 리포지토리 목록에 표시됩니다.
중요합니다
이 빠른 시작에서는 GitHub에서 python_koans 리포지토리의 직접 복제본을 만듭니다. 이러한 리포지토리는 직접 변경으로부터 작성자가 보호하므로 리포지토리에 변경 내용을 커밋하려고 시도하면 실패합니다. 실제로 개발자는 이러한 리포지토리를 자체 GitHub 계정에 포크하고 변경한 다음 끌어오기 요청을 만들어 원래 리포지토리에 해당 변경 내용을 제출합니다. 고유한 포크가 있는 경우 이전에 사용된 원래 리포지토리 URL 대신 해당 URL을 사용합니다.
복제된 파일에서 프로젝트 만들기
리포지토리를 복제한 후 복제된 파일에서 새 프로젝트를 만들 수 있습니다.
다음 단계에 따라 기존 파일에서 프로젝트를 만듭니다.
중요합니다
다음 프로세스에서는 원본 파일을 이동하거나 복사하지 않습니다. 파일 복사본으로 작업하려면 먼저 폴더를 복제한 다음 프로젝트를 만듭니다.
Visual Studio를 시작하고새>파일>프로젝트를 선택합니다.
새 프로젝트 만들기 대화 상자에서 python을 검색하고 기존 Python 코드 템플릿에서 선택한 다음을 선택합니다.
새 프로젝트 구성 대화 상자에서 프로젝트 이름 및 위치를 입력하고 프로젝트를 포함할 솔루션을 선택한 다음 만들기를 선택합니다.
기존 Python 코드에서 새 프로젝트 만들기 마법사에서폴더 경로를 기존 코드로 설정하고, 파일 형식에 대한 필터를 설정하고, 프로젝트에 필요한 검색 경로를 지정한 다음, 다음을 선택합니다. 검색 경로를 모르는 경우 필드를 비워 둡니다.
다음 페이지에서 프로젝트에 대한 시작 파일을 선택합니다. Visual Studio는 기본 전역 Python 인터프리터 및 버전을 선택합니다. 드롭다운 메뉴를 사용하여 환경을 변경할 수 있습니다. 준비가 되면 다음을 선택합니다.
비고
대화 상자에는 루트 폴더의 파일만 표시됩니다. 원하는 파일이 하위 폴더에 있는 경우 시작 파일을 비워 둡니다. 이후 단계에서 설명한 대로 솔루션 탐색기에서 시작 파일을 설정할 수 있습니다.
프로젝트 파일(디스크에 .pyproj 파일)을 저장할 위치를 선택합니다. 해당하는 경우 가상 환경의 자동 검색을 포함하고 다른 웹 프레임워크에 대한 프로젝트를 사용자 지정할 수도 있습니다. 이러한 옵션을 잘 모르는 경우 필드를 기본값으로 설정합니다.
완료를 선택합니다.
Visual Studio에서 프로젝트를 만들고 솔루션 탐색기에서 엽니다. .pyproj 파일을 다른 위치로 이동하려면 솔루션 탐색기에서 파일을 선택한 다음 도구 모음에서 다른 이름으로 파일>저장을 선택합니다. 이 작업은 프로젝트의 파일 참조를 업데이트하지만 코드 파일은 이동하지 않습니다.
다른 시작 파일을 설정하려면 솔루션 탐색기에서 파일을 찾고 파일을 마우스 오른쪽 단추로 클릭한 다음 시작 파일로 설정을 선택합니다.
로컬 Git 리포지토리 목록에서 리포지토리 이름을 두 번 클릭합니다. GitHub, 프로젝트 및 솔루션 옵션이 있는 팀 탐색기 - 홈페이지에서 리포지토리 대시보드가 열립니다.
솔루션 섹션 을 확장하고 새로 만들기를 선택하여 새 프로젝트를 만듭니다.
새 프로젝트 만들기 대화 상자에서 언어 필터를 Python으로 설정하거나 Python을 검색하고, 기존 Python 코드에서 템플릿을 선택하고, 다음을 선택합니다.
새 프로젝트 구성 대화 상자에서 프로젝트 이름을 입력하고 위치를 리포지토리 와 동일한 폴더로 설정하고 확인을 선택합니다. 기존 Python 코드에서 새 프로젝트 만들기 마법사가 열립니다.
마법사에서 마침을 선택합니다.
프로젝트 속성 구성
프로젝트를 실행하려면 프로젝트의 작업 디렉터리를 식별하고 Visual Studio에 시작 파일로 사용할 파일을 알려야 합니다.
프로젝트 속성을 구성하려면 다음 단계를 수행합니다.
솔루션 탐색기에서 프로젝트 노드를 확장하고 contemplate_koans.py 파일을 마우스 오른쪽 단추로 클릭한 다음 시작 파일로 설정을 선택합니다. 이 작업을 통해 Visual Studio는 프로젝트를 실행하는 데 사용할 파일을 알 수 있습니다.
기본 Visual Studio 도구 모음에서 프로젝트>속성을 선택하여 프로젝트에 대한 속성을 엽니다.
일반 탭에서 프로젝트의 작업 디렉터리 값을 확인합니다.
기본적으로 Visual Studio는 작업 디렉터리를 프로젝트 루트(
.)로 설정합니다. 시작 파일에는 특정한 폴더 위치가 없습니다.복제된 프로그램 코드는 작업 디렉터리에서 koans.txt 파일을 찾습니다. 코드는 디렉터리가 복제된 리포지토리 파일을 저장하도록 Visual Studio에 지시한 폴더 위치가 될 것으로 예상합니다. 작업 디렉터리를 프로젝트 루트()
.로 설정하면 프로그램에서 런타임 오류가 발생합니다.작업 디렉터리의 값을 복제된 리포지토리의 폴더 위치(예: .)로
C:\Users\contoso\source\repos\Python-Koans설정합니다.팁 (조언)
복제된 파일의 폴더 위치를 확인하는 빠른 방법은 솔루션 탐색기에서 복제된 파일의 속성을 확인하는 것입니다. koans.txt파일을 마우스 오른쪽 단추 로 클릭하고 속성을 선택하여 솔루션 탐색기에서 세부 정보 창을 엽니다. 세부 정보 창에서 파일의 폴더 위치가 전체 경로 속성에 나열되어 있는지 확인합니다. 프로젝트 속성 페이지의 작업 디렉터리 필드에 이 값을 붙여넣을 수 있습니다.
변경 내용을 저장하고 프로젝트 속성 창을 닫습니다.
Python 프로그램 실행
이제 새 프로젝트에 대한 애플리케이션 실행을 시도할 준비가 되었습니다.
디버깅하지 않고> 시작을 선택하거나 바로 가기 키 Ctrl+F5를 사용하여 프로그램을 실행합니다.
koans.txt 파일에 대한 FileNotFoundError 런타임 오류가 표시되면 이전 섹션에 설명된 대로 작업 디렉터리가 올바르게 설정되었는지 확인합니다.
프로그램이 성공적으로 실행되면 프로젝트 파일 /koans/about_asserts.py 17줄에 어설션 오류가 표시됩니다.
어설션 오류는 의도적인 것입니다. 이 프로그램은 모든 의도적인 오류를 수정하도록 하여 Python을 학습하도록 설계되었습니다. Python Koans에 영감을 주신 Ruby Koans에서 프로그램에 대한 자세한 정보를 찾을 수 있습니다.
프로그램을 종료합니다.
솔루션 탐색기에서 /koans/about_asserts.py 파일을 두 번 클릭하여 편집기에서 파일을 엽니다.
기본적으로 줄 번호는 편집기에서 표시되지 않습니다. 줄 번호를 보려면 도구>옵션을 선택하고 , 모든 설정>언어>Python>일반 섹션을 확장하고, 줄 번호 옵션을 선택합니다.
줄 17의
False인수를True로 변경하여 /koans/about_asserts.py 파일의 오류를 수정하십시오. 업데이트된 코드는 다음과 같습니다.self.assertTrue(True) # This value should be True프로그램을 다시 실행합니다.
Visual Studio에서 오류에 대해 경고하는 경우 Yes 로 응답하여 코드를 계속 실행합니다. 이번에는 프로그램이 첫 번째 검사를 통과하고 다음 코안에서 중지됩니다. 계속해서 추가 오류를 수정하고 프로그램을 실행하여 조정 내용을 확인할 수 있습니다.