Terminal, editor e arquivo .py: quem faz o quê

Três peças, um fluxo

Nas últimas três aulas você conheceu várias telas: o terminal do Windows, o modo interativo com seus três sinais de maior, o VS Code com o botão de play. Para quem está começando, esses ambientes se misturam, e dessa mistura nascem os erros mais frequentes das primeiras semanas. Esta aula separa as peças de uma vez. São três, cada uma com um verbo: o editor escreve, o arquivo guarda, o terminal executa.

Siga a analogia por um momento. Escrever a receita no caderno não produz bolo nenhum; é só texto. O bolo aparece quando alguém leva a receita à cozinha e executa os passos. Com código é igual: digitar um print no VS Code não mostra nada na tela até que o arquivo seja executado, seja pelo botão de play, seja pelo comando python no terminal. Editor sem terminal é literatura; terminal sem arquivo não tem o que rodar. As peças só fazem sentido juntas.

Modo interativo ou script: quando usar cada um

Há ainda uma divisão dentro do próprio Python, que a aula 3 tocou de leve: os dois modos de execução. No modo interativo, você digita uma linha, o Python responde na hora e nada fica guardado; fechou a janela, acabou. No modo script, você escreve o programa inteiro num arquivo .py e o executa de uma vez, do topo ao fim; o arquivo permanece no disco, pronto para rodar de novo amanhã. Não é um modo melhor que o outro: são ferramentas para tarefas diferentes.

Um exemplo concreto da divisão de trabalho: você está escrevendo o programa da prática do módulo e bate a dúvida de quanto dá 7 dividido por 2 em Python. Abrir o REPL, digitar 7 / 2, ver 3.5, sair. Dez segundos, dúvida resolvida, e o seu script continua intacto no editor. Programadores experientes alternam entre os dois modos o dia inteiro, sem cerimônia. Deste módulo em diante, o curso segue o mesmo costume: os programas das aulas são scripts, e o REPL aparece como bancada de testes rápidos.

Os tropeços clássicos de quem confunde as peças

Todo iniciante comete pelo menos um destes erros, e não há vergonha nenhuma nisso: as telas realmente se parecem. O primeiro clássico é digitar código Python direto no prompt do Windows. Você escreve print("oi") no C:\Users\voce> e o Windows responde que print não é reconhecido, porque quem entende print é o Python, não o sistema. O segundo é o inverso: digitar um comando do sistema, como python ola.py, dentro do modo interativo. O Python responde com SyntaxError, porque dentro do >>> ele espera código, não comandos de terminal.

C:\Users\voce> print("oi")
'print' não é reconhecido como um comando interno
ou externo, um programa operável ou um arquivo em lotes.

>>> python ola.py
  File "<stdin>", line 1
    python ola.py
           ^^^
SyntaxError: invalid syntax

Os dois tropeços em ação: código Python no prompt do Windows e comando do Windows dentro do Python.

O antídoto é olhar o prompt antes de digitar. Se a linha começa com C:\ e termina em >, você está falando com o Windows: é lugar de comandos como python, py, cd e dir. Se a linha começa com três sinais de maior, você está dentro do Python: é lugar de código, como print e contas. Na dúvida, exit() sai do Python e devolve o Windows. Esse reflexo de conferir o prompt vira automático em poucos dias de prática.