Início rápido: Clonar um repositório de código Python no Visual Studio

Neste quickstart, segue passos guiados para clonar um repositório GitHub de código Python e criar um projeto. O Visual Studio facilita o trabalho com projetos Python usando comandos Git para aceder a conteúdos sob controlo de versão. Também podes clonar repositórios de código Python a partir da linha de comandos e depois trabalhar com os projetos no Visual Studio.

Pré-requisitos

• Visual Studio 2022 instalado com suporte para cargas de trabalho em Python. O Visual Studio 2022 proporciona integração perfeita com o GitHub, com suporte para comandos Git. Para obter mais informações, consulte Instalar suporte a Python no Visual Studio.

O Visual Studio para Mac não é suportado. Para mais informações, veja O que está a acontecer ao Visual Studio para Mac? O Visual Studio Code no Windows, Mac e Linux funciona bem com Python através das extensões disponíveis.

Clonar ficheiros de repositório existentes

Utilize os seguintes passos para clonar um repositório existente com os comandos de controlo de versão do Visual Studio Git :

1. No Visual Studio, selecione Git>Clone:

   

2. No diálogo Clonar um repositório , especifique o repositório do GitHub para clonar:

   

   1. Para a localização do Repositório, introduza a URL do repositório a clonar. Para este exercício, introduza https://github.com/gregmalcolm/python_koans.

   2. Para o Caminho, entra na pasta do teu sistema onde queres que o Visual Studio armazene os ficheiros clonados.

      A pasta que especificas deve ser exatamente a que queres que o Visual Studio use. Ao contrário do git clone comando, quando crias um clone no Team Explorer, o Visual Studio não cria automaticamente uma nova subpasta com o nome do repositório.

   3. Quando estiveres pronto, seleciona Clonar.

   Após a conclusão da clonagem, o Visual Studio abre o painel de Alterações Git do repositório. Também podes ver a pasta com os ficheiros do repositório clonado no Explorador de Soluções.

3. SelecioneRepositórios Locais> e confirme que o repositório clonado está agora na lista:

   

Importante

Neste quickstart, crias um clone direto do repositório python_koans no GitHub. Tal repositório é protegido pelo seu autor contra alterações diretas, pelo que tentar efetuar alterações no repositório falhará. Na prática, os programadores fazem um fork desse repositório para a sua própria conta no GitHub, fazem alterações lá e depois criam pull requests para submeter essas alterações ao repositório original. Quando tiver o seu próprio fork, use o endereço URL dele em vez do endereço URL original do repositório usado anteriormente.

Criar projeto a partir de ficheiros clonados

Depois de clonares o repositório, podes criar um novo projeto a partir dos ficheiros clonados.

Siga estas etapas para criar um projeto a partir de arquivos existentes.

Importante

O processo a seguir não move nem copia nenhum arquivo de origem original. Se você quiser trabalhar com uma cópia de seus arquivos, primeiro duplique a pasta e, em seguida, crie o projeto.

1. Inicie o Visual Studio e selecione Arquivo>Novo>Projeto.

2. Na caixa de diálogo Criar um novo projeto, procure por python, selecione o modelo De código Python existente e selecione Avançar.

3. Na caixa de diálogo Configurar seu novo projeto , insira um Nome e Local do projeto, escolha a solução para conter o projeto e selecione Criar.

4. No assistente Criar Novo Projeto a partir de Código Python Existente , defina o caminho da Pasta para o código existente, defina um Filtro para tipos de arquivo e especifique quaisquer caminhos de Pesquisa que seu projeto exija e selecione Avançar. Se não souber os caminhos de pesquisa, deixe o campo em branco.

   

5. Na página seguinte, selecione o arquivo de inicialização para seu projeto. O Visual Studio seleciona o interpretador e a versão padrão do Python global. Você pode alterar o ambiente usando a lista desdobrável. Quando estiver pronto, selecione Avançar.

   Observação

   A caixa de diálogo mostra apenas arquivos na pasta raiz. Se o arquivo desejado estiver em uma subpasta, deixe o arquivo de inicialização em branco. Você pode definir o arquivo de inicialização no Gerenciador de Soluções, conforme descrito em uma etapa posterior.

   

6. Selecione o local para armazenar o arquivo de projeto (um arquivo .pyproj no disco). Se aplicável, você também pode incluir a deteção automática de ambientes virtuais e personalizar o projeto para diferentes estruturas da Web. Se você não tiver certeza dessas opções, deixe os campos definidos como padrão.

   

7. Selecione Concluir.

   O Visual Studio cria o projeto e o abre no Gerenciador de Soluções. Se você quiser mover o arquivo .pyproj para um local diferente, selecione o arquivo no Gerenciador de Soluções e, em seguida, selecione Arquivo>Salvar como na barra de ferramentas. Esta ação atualiza as referências de arquivo no projeto, mas não move nenhum arquivo de código.

8. Para definir um arquivo de inicialização diferente, localize o arquivo no Gerenciador de Soluções, clique com o botão direito do mouse no arquivo e selecione Definir como Arquivo de Inicialização.

Configurar propriedades do projeto

Para executar o projeto, precisa de identificar o diretório de trabalho do projeto e informar o Visual Studio qual o ficheiro a usar como ficheiro de Arranque.

Siga estes passos para configurar as propriedades do seu projeto:

1. No Explorador de Soluções, expanda o nó do projeto, clique com o botão direito no ficheiro contemplate_koans.py e selecione Definir como Ficheiro de Arranque. Esta ação permite ao Visual Studio saber que ficheiro usar para executar o projeto.

2. Na barra de ferramentas principal do Visual Studio, selecione Propriedades do Projeto> para abrir as propriedades do projeto.

3. No separador Geral , observe o valor do Diretório de Trabalho para o projeto.

   Por defeito, o Visual Studio define o Diretório de Trabalho para a raiz do projeto (.). Note que o Ficheiro de Arranque não tem uma localização específica na pasta.

   

   O código do programa clonado procura um ficheiro chamado koans.txt no diretório de trabalho. O código espera que o diretório seja a localização da pasta onde instruiu o Visual Studio a armazenar os ficheiros do repositório clonados. Se deixar o Diretório de Trabalho definido na raiz do projeto (.), o programa gera erros em tempo de execução.

4. Defina o valor do Diretório de Trabalho para a localização da pasta do repositório clonado, como C:\Users\contoso\source\repos\Python-Koans.

   Sugestão

   Uma forma rápida de confirmar a localização da pasta dos ficheiros clonados é verificar as propriedades do ficheiro clonado no Explorador de Soluções. Clique com o botão direito no ficheirokoans.txt e selecione Propriedades para abrir o painel de detalhes no Explorador de Soluções. No painel de detalhes, repare que a localização da pasta do ficheiro está listada na propriedade Caminho Completo . Pode colar este valor no campo Diretório de Trabalho na página de Propriedades do projeto.

   

5. Guarda as tuas alterações e fecha o painel de Propriedades do projeto.

Executar o programa Python

Agora está pronto para tentar executar a aplicação para o novo projeto:

1. Selecione Debug>Iniciar sem Depuração (ou utilize o atalho Ctrl+F5) para executar o programa.

   Se vir um erro de execução FileNotFoundError para o ficheiro koans.txt, confirme que o Diretório de Trabalho está corretamente configurado, conforme descrito na secção anterior.

2. Quando o programa corre com sucesso, apresenta um erro de asserção na linha 17 do ficheiro do projeto /koans/about_asserts.py:

   

   O erro de afirmação é intencional. O programa foi concebido para ensinar Python, fazendo-te corrigir todos os erros intencionais. Pode encontrar mais informações sobre o programa em Ruby Koans, que inspirou os Python Koans.

3. Sai do programa.

4. No Explorador de Soluções, clique duas vezes no ficheiro /koans/about_asserts.py para abrir o ficheiro no editor:

   

   Por padrão, os números das linhas não aparecem no editor. Para ver os números das linhas, selecione Ferramentas>Opções, expanda a secção Todas as Definições>Linguagem>Python>Geral e selecione a opção Números de Linha:

   

5. Corrija o erro no ficheiro /koans/about_asserts.py mudando o False argumento da linha 17 para True. Eis como deve ser o código atualizado:

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

6. Execute o programa novamente.

   Se o Visual Studio avisar sobre erros, responda com Sim para continuar a executar o código. Desta vez, o programa passa pela primeira verificação e para no próximo koan. Pode continuar a corrigir mais erros e executar o programa para ver os ajustes.

Conteúdo relacionado

• Clonar um repositório Git no Visual Studio
• Criar um repositório Git a partir do Visual Studio
• Tutorial: Trabalhar com Python no Visual Studio