Tutorial: Usar a janela REPL interativa no Visual Studio

Este artigo apresenta a Etapa 3 da série de tutoriais Trabalhar com Python no Visual Studio.

O IDE (ambiente de desenvolvimento integrado) do Visual Studio fornece várias janelas que dão suporte a diferentes tarefas de desenvolvimento. etapa 1 e etapa 2 no tutorial descrevem como gerenciar arquivos no Gerenciador de Soluções e trabalhar com conteúdo de arquivo no editor de código. Na Etapa 3, você usará a Janela Interativa do Visual Studio para Python para oferecer uma experiência avançada de REPL (read-evaluate-print-loop), que reduz consideravelmente o ciclo comum de edit-build-debug.

Ao trabalhar na Janela Interativa do para Python, você obtém todos os recursos da experiência REPL da linha de comando do Python. Ele também facilita a troca de código com arquivos de origem no editor do Visual Studio, o que, de outra forma, é complicado com a linha de comando.

Na Etapa 3 do tutorial, você aprenderá a:

• Acessar a janela interativa para Python e definir o interpretador do Python
• Insira e execute o código na janela e role a lista do histórico de comandos
• Inserir código ou código existente de outras fontes
• Copiar código e saída do programa da Janela Interativa

Pré-requisitos

• Um projeto de aplicativo Python que tem um arquivo Python (.py) com código criado na etapa 2 do : gravar e executar o código python.

• Para dar melhor suporte à experiência de REPL, instale os pacotes ipython e ipykernel. Para obter mais informações, confira Guia de pacotes de ambientes do Python.

Abrir a janela interativa para Python

Siga estas etapas para abrir a Janela Interativa e começar a trabalhar com o código:

1. Use um dos seguintes métodos para abrir a Janela Interativa para Python:

   • No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Abrir Janela Interativa.
   • No Gerenciador de Soluções, no nó Ambientes do Python do projeto, clique com o botão direito do mouse no ambiente do Python para o projeto e selecione Abrir Janela Interativa. Um exemplo de um ambiente python é Python 3.11 (64 bits).
   • Na barra de ferramentas, selecione Exibir>Outros windows>windows interativos do Python ou use o atalho de teclado Alt+I.

   O Visual Studio abre a Janela Interativa para Python sob a janela do editor. A janela tem o prompt padrão de REPL do Python >>>:

   

2. Na Janela Interativa, você pode usar a lista suspensa Ambiente para selecionar um interpretador de Python específico para trabalhar com:

   

3. Você pode tornar o Janela Interativa maior movendo o separador entre a janela e o editor de código:

   

   Dica

   Você pode redimensionar qualquer janela no Visual Studio movendo os separadores entre a janela e as janelas ao redor. Você também pode mover janelas para fora do quadro do Visual Studio e reorganizar janelas dentro do quadro.

4. Na Janela Interativa, insira uma instrução como print("Hello, Visual Studio") e uma expressão de cálculo como 123/456. O Visual Studio exibe resultados imediatos para seu código:

   

5. Em seguida, insira uma instrução multilinha como a definição de função mostrada no exemplo a seguir.

   À medida que você insere o código, o da Janela Interativa mostra o prompt de continuação do Python (...). Ao contrário da experiência REPL de linha de comando, a Janela Interativa fornece recuo automático à medida que você insere o código:

   

   Para adicionar uma nova linha ao código, selecione Shift+Enter.

6. Role a lista de comandos que você inseriu até agora usando as teclas de seta para cima ou para baixo .

   A Janela Interativa fornece um histórico completo de tudo o que você insere e melhora a experiência REPL de linha de comando com itens de histórico de várias linhas. Você pode recuperar rapidamente toda a definição de uma função como uma única unidade e alterar o nome da função ou ajustar outras instruções. Essa abordagem é mais fácil do que recriar a função linha por linha.

Reutilizar e modificar o código existente

O Visual Studio fornece diferentes maneiras de usar o código Python existente na Janela Interativa , como copiar e colar, e acessar o código inserido anteriormente, como foi descrito anteriormente. Outro método é enviar várias linhas de código de uma janela do editor para a Janela Interativa . Essa funcionalidade permite que você mantenha o código em um arquivo fonte e envie facilmente os fragmentos escolhidos para a Janela Interativa . Em seguida, você pode trabalhar com os fragmentos de código no ambiente REPL rápido em vez de precisar executar todo o programa.

Experimente estes recursos concluindo as seguintes etapas:

1. Abra o arquivo de projeto do Python (.py) no editor. (A Etapa 2 do Tutorial explica como criar esse arquivo, em que o nome do arquivo padrão é PythonApplication1.py.)

2. Substitua a instrução de loop for no arquivo pelo seguinte código:

   # Create a string with spaces proportional to a cosine of x in degrees
   def make_dot_string(x):
       return ' ' * int(20 * cos(radians(x)) + 20) + 'o'
   

3. Clique com o botão direito do mouse na instrução import no arquivo e selecione Enviar para a Interativa (ou o atalho de teclado Ctrl+E). Repita esse processo para a instrução from.

   

   Quando você seleciona o comando Enviar para a Interativa, o fragmento de código selecionado é colado imediatamente na Janela Interativa e executado. Nesse caso, o Visual Studio importa as rotinas de cos e radians da biblioteca de math e também da biblioteca de sys.

4. Repita o processo novamente para a função make_dot_string. Envie ambas as linhas da função. Depois de enviar o código completo para a função, insira uma nova linha na Janela Interativa .

   Como esse código define uma função, você pode testá-la rapidamente chamando a função algumas vezes, conforme mostrado no exemplo a seguir:

   

   Dica

   Você pode usar o atalho de teclado Ctrl+Enter para executar a linha de código atual na Janela Interativa . Depois que o código for executado, o prompt de cursor passará para a próxima linha. Selecione Ctrl+Enter repetidamente para uma maneira conveniente de percorrer seu código, o que não é possível na experiência de linha de comando do Python. Você também pode usar essa abordagem para percorrer seu código sem executar o depurador e sem necessariamente iniciar seu programa desde o início.

5. Tente o processo novamente, mas desta vez copie e cole várias linhas de código na janela interativa de qualquer origem. Você pode usar o seguinte snippet de código:

   for i in range(360):
       s = make_dot_string(i)
       print(s)
   

   A ação de várias colagens é difícil de fazer na experiência REPL do Python de linha de comando. Depois de colar o código, o Janela Interativa executará o código como se você o tivesse inserido diretamente na janela:

   

   O código atual funciona, mas a saída não é inspiradora. Um valor de etapa diferente no loop for pode mostrar mais da onda cossenoidal. O código do loop for está disponível no histórico do REPL como uma única unidade. Você pode localizar o código e fazer as alterações desejadas e testar a função novamente.

6. Role pelo histórico de comandos usando a tecla de seta Para cima e pare no código do loop for.

7. Use as teclas de seta esquerda ou direita para mover no código da instrução for loop. Quando chegar ao início de uma linha, pressione a tecla de seta esquerda para ir até o final da linha anterior.

8. Na instrução de loop for, vá para a definição de range e altere a instrução para range(0, 360, 12).

9. Selecione Ctrl+Enter em qualquer lugar na instrução de loop for para executar a função novamente:

   

10. Repita o processo para experimentar configurações de etapas diferentes até encontrar um valor desejado. Você também pode fazer a onda repetir alongando o intervalo, por exemplo, range(0, 1800, 12).

Copie o código e a saída do programa

O Visual Studio permite que você copie qualquer código que escrever na Janela Interativa, bem como qualquer saída da execução do código.

Siga estas etapas para copiar o código da Janela Interativa para o editor:

1. Na Janela Interativa, selecione o código que você deseja copiar.

2. Clique com o botão direito do mouse no código selecionado e escolha Copiar Código ou use o atalho de teclado Ctrl+Shift+C.

   

3. Cole o código copiado no editor. Esse recurso especial do Visual Studio omite automaticamente qualquer saída, bem como os prompts >>> e ... na seleção.

   Ao colar no editor, você obtém apenas o código:

   for i in range(0, 1800, 12):
       s = make_dot_string(i)
       print(s)
   

4. Para copiar o conteúdo exato da Janela Interativa, incluindo prompts e qualquer saída de programa, use o comando Copiar padrão.

Nestas etapas, você usou o ambiente REPL rápido do Interactive Window para descobrir os detalhes de uma pequena parte do código Python e, convenientemente, adicionou o código ao arquivo de origem do projeto. Ao executar novamente o código com Ctrl+F5 (ou Depurar>Iniciar sem Depurar), você verá exatamente os resultados desejados.

Próxima etapa

Etapa 4: executar o código no depurador