빠른 시작: Visual Studio에서 Python 코드의 리포지토리 복제

이 빠른 시작에서는 지침별 단계에 따라 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 소스 제어 명령을 사용하여 기존 리포지토리를 복제합니다.

1. Visual Studio에서 Git>복제를 선택합니다.

   

2. 리포지토리 복제 대화 상자에서 복제할 GitHub 리포지토리를 지정합니다.

   

   1. 리포지토리 위치의 경우 복제할 리포지토리의 URL을 입력합니다. 이 연습에서는 https://github.com/gregmalcolm/python_koans를 입력합니다.

   2. 경로의 경우 Visual Studio에서 복제된 파일을 저장할 시스템의 폴더를 입력합니다.

      지정한 폴더는 Visual Studio에서 사용할 정확한 폴더여야 합니다. git clone 명령과 달리 팀 탐색기에서 복제본을 만들 때 Visual Studio는 리포지토리 이름을 사용하여 새 하위 폴더를 자동으로 만들지 않습니다.

   3. 준비가 되면 복제를 선택합니다.

   복제가 완료되면 Visual Studio에서 리포지토리에 대한 Git 변경 내용 창을 엽니다. 솔루션 탐색기에 복제된 리포지토리 파일이 있는 폴더를 볼 수도 있습니다.

3. Git>로컬 리포지토리를 선택하고 복제된 리포지토리가 목록에 있는지 확인합니다.

   

Important

이 빠른 시작에서는 GitHub에서 python_koans 리포지토리의 복제본을 직접 만듭니다. 이러한 리포지토리는 직접 변경된 내용에서 해당 작성자에 의해 보호되므로 리포지토리에 대한 변경 내용을 커밋하려는 시도는 실패합니다. 실제로 개발자는 대신 고유한 GitHub 계정에 이러한 리포지토리를 포크하고, 거기에서 변경한 다음, 끌어오기 요청을 만들어 해당 변경 내용을 원래 리포지토리에 제출합니다. 고유한 포크가 있는 경우 이전에 사용된 원래 리포지토리 URL 대신 해당 URL을 사용합니다.

복제된 파일에서 프로젝트 만들기

리포지토리를 복제한 후 복제된 파일에서 새 프로젝트를 만들 수 있습니다.

다음 단계에 따라 기존 파일에서 프로젝트를 만듭니다.

Important

다음 프로세스에서는 원본 파일을 이동하거나 복사하지 않습니다. 파일 복사본으로 작업하려면 먼저 폴더를 복제한 다음 프로젝트를 만듭니다.

1. Visual Studio를 실행하고 파일>새로 만들기>프로젝트를 선택합니다.

2. 새 프로젝트 만들기 대화 상자에서 python을 검색하고 기존 Python 코드 템플릿에서 템플릿을 선택한 후 다음을 선택합니다.

3. 새 프로젝트 구성 대화 상자에서 프로젝트 이름과 위치를 입력하고, 프로젝트를 포함할 솔루션을 선택한 후 만들기를 선택합니다.

4. 기존 Python 코드에서 새 프로젝트 만들기 마법사에서 폴더 경로를 기존 코드로 설정하고, 파일 형식에 대한 필터를 설정하고, 프로젝트에 필요한 검색 경로를 지정한 다음, 다음을 선택합니다. 검색 경로를 모르는 경우 필드를 비워 둡니다.

   

5. 다음 페이지에서 프로젝트의 시작 파일을 선택합니다. Visual Studio는 기본 전역 Python 인터프리터 및 버전을 선택합니다. 드롭다운 메뉴를 사용하여 환경을 변경할 수 있습니다. 준비가 되면 다음을 선택합니다.

   참고 항목

   대화 상자에는 루트 폴더의 파일만 표시됩니다. 원하는 파일이 하위 폴더에 있는 경우 시작 파일을 비워 둡니다. 이후 단계에서 설명한 대로 솔루션 탐색기에서 시작 파일을 설정할 수 있습니다.

   

6. 프로젝트 파일을 저장할 위치를 선택합니다(디스크의 .pyproj 파일). 해당하는 경우 이 대화 상자에서 가상 환경의 자동 검색을 포함하고 다양한 웹 프레임워크에 대한 프로젝트를 사용자 지정할 수도 있습니다. 이러한 옵션을 잘 모를 경우 필드에 기본값 설정을 유지합니다.

   

7. 마침을 선택합니다.

   Visual Studio가 프로젝트를 만들어 솔루션 탐색기에서 엽니다. .pyproj 파일을 다른 위치로 이동하려면 솔루션 탐색기의 파일을 선택한 다음 도구 모음에서 파일>다른 이름으로 저장을 선택합니다. 이 작업은 프로젝트에서 파일 참조를 업데이트하지만 코드 파일은 이동하지 않습니다.

8. 다른 시작 파일을 설정하려면 솔루션 탐색기에서 파일을 찾아 마우스 오른쪽 단추로 클릭하고 시작 파일로 설정을 선택합니다.

프로젝트 속성 구성하기

프로젝트를 실행하려면 프로젝트의 작업 디렉터리를 식별하고 Visual Studio에 시작 파일로 사용할 파일을 알려야 합니다.

프로젝트 속성을 구성하려면 다음 단계를 수행합니다.

1. 솔루션 탐색기에서 프로젝트 노드를 확장하고 contemplate_koans.py 파일을 마우스 오른쪽 단추로 클릭한 다음 시작 파일로 설정을 선택합니다. 이 작업을 통해 Visual Studio는 프로젝트를 실행하는 데 사용할 파일을 알 수 있습니다.

2. 기본 Visual Studio 도구 모음에서 프로젝트>속성을 선택하여 프로젝트의 속성을 엽니다.

3. 일반 탭에서 프로젝트의 작업 디렉터리 값을 확인합니다.

   기본적으로 Visual Studio는 작업 디렉터리를 프로젝트 루트(.)로 설정합니다. 시작 파일에는 특정 폴더 위치가 없습니다.

   

   복제된 프로그램 코드는 작업 디렉터리에서 koans.txt 파일을 찾습니다. 코드는 디렉터리가 복제된 리포지토리 파일을 저장하도록 Visual Studio에 지시한 폴더 위치가 될 것으로 예상합니다. 작업 디렉터리를 프로젝트 루트(.)로 설정하면 프로그램에서 런타임 오류가 발생합니다.

4. 작업 디렉터리의 값을 복제된 리포지토리의 폴더 위치(예: C:\Users\contoso\source\repos\Python-Koans)로 설정합니다.

   팁

   복제된 파일의 폴더 위치를 확인하는 빠른 방법은 솔루션 탐색기에서 복제된 파일의 속성을 검사하는 것입니다. koans.txt 파일을 마우스 오른쪽 단추로 클릭하고 속성을 선택하여 솔루션 탐색기 아래의 세부 정보 창을 엽니다. 세부 정보 창에서 파일의 폴더 위치가 전체 경로 속성에 나열되어 있는지 확인합니다. 프로젝트 속성 페이지의 작업 디렉터리 필드에 이 값을 붙여넣을 수 있습니다.

   

5. 변경 사항을 저장하고 프로젝트 속성 창을 닫습니다.

Python 프로그램 실행

이제 새 프로젝트에 대한 애플리케이션 실행을 시도할 준비가 되었습니다.

1. 프로그램을 실행하려면 디버그>디버깅하지 않고 시작을 선택합니다(또는 키보드 바로 가기 단축키 Ctrl+F5를 사용합니다).

   koans.txt 파일에 대한 FileNotFoundError 런타임 오류가 표시되면 이전 섹션에 설명된 대로 작업 디렉터리가 올바르게 설정되었는지 확인합니다.

2. 프로그램이 성공적으로 실행되면 프로젝트 파일 /koans/about_asserts.py:의 줄 17에 어설션 오류를 표시합니다.

   

   어설션 오류는 의도적인 것입니다. 프로그램은 모든 의도적인 오류를 수정하여 Python을 가르치도록 설계되었습니다. Python Koans에 영감을 준 Ruby Koans에서 프로그램에 대한 자세한 정보를 찾을 수 있습니다.

3. 프로그램을 종료합니다.

4. 솔루션 탐색기에서 /koans/about_asserts.py 파일을 두 번 클릭하여 편집기에서 파일을 엽니다.

   

   기본적으로 편집기에서 줄 번호는 표시되지 않습니다. 줄 번호를 보려면 도구>옵션을 선택하고, 텍스트 편집기>Python>일반 섹션을 확장하고, 줄 번호 옵션을 선택합니다.

   

5. True에 대한 줄 17에서 False 인수를 변경하여 /koans/about_asserts.py 파일의 오류를 수정합니다. 업데이트된 코드는 다음과 같습니다.

   self.assertTrue(True) # This value should be True
   

6. 프로그램을 다시 실행합니다.

   Visual Studio가 오류에 대해 경고하는 경우 예를 사용하여 응답하고 코드를 계속 실행합니다. 이번에는 프로그램이 첫 번째 검사를 통과하고 다음 koan에서 중지됩니다. 계속해서 추가 오류를 수정하고 프로그램을 실행하여 조정 내용을 확인할 수 있습니다.

관련 콘텐츠

• Visual Studio에서 Git 리포지토리 복제
• Visual Studio에서 Git 리포지토리 만들기
• 자습서: Visual Studio에서 Python 작업