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 interativo) 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 seta para cima/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 Para a direita/para a esquerda para mover para o código da instrução de loop for. 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 padrão Copiar.

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