Python O Editor do Guia

Em toda aula deste guia aparecem caixas Experimente: você escreve um programa em Python, clica em Rodar e vê, logo embaixo, o que o programa escreveu. Quem roda o seu código não é uma imitação: é o Python de verdade, o mesmo programa que você instala no computador, funcionando dentro do seu navegador. Não precisa instalar nada. Nesta página você conhece cada parte do editor, aprende a responder quando o programa pergunta alguma coisa, a parar um programa que não termina e vê o que muda quando você roda o mesmo programa no terminal.

A ideia: uma cozinha de teste dentro da página

Pense numa escola de culinária. O professor explica a receita no quadro, mas a aula só vale a pena quando cada aluno vai para a sua bancada e faz o bolo com as próprias mãos. Se o bolo desanda, tudo bem: a bancada é de treino, e no dia seguinte ela está limpa de novo.

O editor do guia é essa bancada. A receita é o seu programa, e quem "cozinha" é o Python. Cada vez que você clica em Rodar, o editor:

1. prepara uma pasta vazia, a /home/ana (a pasta pessoal da Ana, a usuária das aulas);
2. grava o seu código num arquivo, o main.py (e os outros arquivos da caixa, se houver);
3. roda o programa com o Python, como quem digita python3 main.py no terminal;
4. mostra tudo o que o programa escreveu, e no fim o código de saída (0 quer dizer "terminou bem").

Tudo isso acontece no seu computador, dentro do navegador. O seu código não é enviado para lugar nenhum.

As partes da caixa

Esta é uma caixa livre, sem missão. Clique em ▶ Rodar:

nome = "Ana"
print(f"Olá, {nome}!")
print("Bem-vinda ao Python.")

Na primeira vez, o editor avisa "Carregando o Python (~6 MB, só na primeira vez)…" e mostra uma barra de progresso: o navegador está baixando o Python. Isso leva alguns segundos e só acontece uma vez; depois, o navegador guarda o Python, e cada Rodar leva uma fração de segundo. Em seguida aparece o terminal da caixa, com a resposta. Repare nas partes:

Atalhos do teclado

Experimente agora na caixa de cima: troque "Ana" pelo seu nome e aperte Ctrl+Enter. Depois clique em Restaurar.

Cada Rodar começa do zero

O programa abaixo procura o arquivo diario.txt. Se ele já existe, avisa; senão, cria o arquivo e escreve uma linha nele. Por fim, mostra o que tem na pasta (os.listdir("."), "liste a pasta atual"). Rode duas ou três vezes:

import os

if os.path.exists("diario.txt"):
    print("O diário já existia!")
else:
    print("Diário novo.")

with open("diario.txt", "a", encoding="utf-8") as arquivo:
    arquivo.write("Hoje estudei Python.\n")

print(os.listdir("."))

Todas as vezes ele responde Diário novo. e a pasta tem só ['main.py', 'diario.txt']. Num computador de verdade, a segunda vez diria "O diário já existia!", porque o arquivo ficaria gravado no disco. No editor, cada Rodar ganha uma pasta nova e vazia: os arquivos que o programa criou e as variáveis da vez anterior somem. Não se preocupe com o open e o with agora; eles têm aula própria: Abrindo Arquivos.

Quando o programa pergunta: o input()

A função input() ("entrada") faz o programa parar e esperar você digitar uma resposta (aula input(): Lendo o Teclado). Rode a caixa abaixo: o terminal mostra a pergunta e, do lado, um campo piscando. Digite o seu nome e tecle Enter:

nome = input("Qual é o seu nome? ")
print(f"Prazer, {nome}!")

O que você digitou aparece em branco, depois da pergunta, como num terminal de verdade. No campo de digitação valem estas teclas:

Caixas com o campo Entrada

Em algumas caixas a resposta já vem pronta, num campo Entrada ao lado do botão Rodar: uma linha para cada input(). O programa lê dali sem parar, e o terminal mostra cada linha lida logo depois da pergunta. Mude as notas no campo Entrada e rode de novo:

nome = input("Aluna: ")
nota1 = float(input("Nota 1: "))
nota2 = float(input("Nota 2: "))
media = (nota1 + nota2) / 2
print(f"Média de {nome}: {media}")

Vários arquivos: as abas

Programas maiores se dividem em vários arquivos. Numa caixa com várias abas, clique no nome de cada uma para ver o arquivo. A primeira aba é a que roda (python3 main.py); as outras ficam na mesma pasta, prontas para o programa usar:

import saudacoes

with open("clientes.txt", encoding="utf-8") as arquivo:
    for linha in arquivo:
        print(saudacoes.bom_dia(linha.strip()))

def bom_dia(nome):
    return f"Bom dia, {nome}! O pão saiu agora."

Ana
Bia
Caio

O main.py usa uma função escrita no saudacoes.py (o import saudacoes traz esse arquivo para o programa; aula Criando seu Módulo) e lê os nomes do clientes.txt. Acrescente um nome na aba clientes.txt, ou mude a frase em saudacoes.py, e rode de novo. O botão Restaurar volta todas as abas ao original.

Quando dá errado

Errar faz parte. Quando o Python não consegue continuar, ele para e escreve um traceback (em inglês, "rastro"): o caminho até o erro, a linha culpada e, na última linha, o nome do erro com uma explicação. No editor ele aparece em vermelho, e o código de saída vira 1. A mensagem é a real do Python e vem em inglês; as aulas traduzem e explicam cada uma. A aula Lendo uma Mensagem de Erro ensina a ler um traceback do começo ao fim.

produtos = ["pão", "leite"]
print("Lista da padaria:")
print(produto)

$ python3 erro.py
Lista da padaria:
Traceback (most recent call last):
  File "/home/ana/erro.py", line 3, in <module>
    print(produto)
          ^^^^^^^
NameError: name 'produto' is not defined. Did you mean: 'produtos'?

print("Olá, Ana!"

$ python3 sintaxe.py
  File "/home/ana/sintaxe.py", line 1
    print("Olá, Ana!"
         ^
SyntaxError: '(' was never closed

contador = 0
print("Contando…")
while True:
    contador += 1

$ python3 laco.py
Contando…
^C
Traceback (most recent call last):
  File "/home/ana/laco.py", line 4, in <module>
    contador += 1
    ^^^^^^^^
KeyboardInterrupt
$ echo $?
130

O que o editor não faz

O editor roda o Python de verdade, mas ele vive dentro de uma página da internet, e o navegador, por segurança, não deixa uma página mexer no seu computador. Algumas coisas ficam de fora:

As missões

Muitas caixas têm uma Missão: uma tarefa escrita em cima do código. Embaixo da caixa fica uma linha de status que confere a sua resposta a cada Rodar:

• Missão em andamento… enquanto ainda não está certo, com uma pista entre parênteses (por exemplo, "a saída ainda não é a esperada" ou "o programa ainda termina com erro");
• ✔ Missão cumprida!, em verde, quando você acerta. Depois de cumprida, ela fica cumprida.

O guia não compara o seu código letra por letra com a resposta: ele roda o seu programa e confere o que ele escreveu. Por isso, quase sempre existe mais de um jeito certo. Às vezes a missão também pede um recurso (como "use um for"), ou um arquivo criado pelo programa, ou até um erro de propósito, para você aprender a reconhecê-lo. Faça a primeira:

paes = 3 * 1.50
leite = 2 * 9.50
total = paes + leites
print(f"Total: R$ {total:.2f}")

paes = 3 * 1.50
leite = 2 * 9.50
total = paes + leite
print(f"Total: R$ {total:.2f}")

Rodou antes de consertar? Então viu NameError: name 'leites' is not defined. Did you mean: 'leite'?: a variável se chama leite, sem o "s". As missões são feitas para você errar, ler a mensagem e consertar. Se travar de vez, use Ver solução; mas tente antes, e depois de ver a solução, digite-a você mesmo.

O mesmo programa no terminal

O editor é ótimo para aprender, mas no dia a dia o Python roda como um programa no seu computador: o python3, que você usa no terminal (a janela de texto onde se digitam comandos). A aula Instalar o Python mostra como instalá-lo, e Rodando um Programa (.py) ensina o caminho completo. Em resumo:

1. copie o código da caixa para um editor de texto e salve com um nome terminado em .py, na sua pasta pessoal: por exemplo, ola.py;
2. abra o terminal e digite python3, um espaço e o nome do arquivo;
3. o que o programa escreve aparece logo embaixo, como no terminal da caixa.

Nas aulas, o terminal aparece assim, com a usuária ana no computador notebook. O primeiro programa desta página, salvo como ola.py:

$ python3 --version
Python 3.14.4
$ python3 ola.py
Olá, Ana!
Bem-vinda ao Python.

E o programa do input(), salvo como nome.py: no terminal, você digita a resposta na mesma linha da pergunta e tecla Enter:

$ python3 nome.py
Qual é o seu nome? Ana
Prazer, Ana!

O Python é o mesmo nos dois lugares, então o que você aprende no editor vale no terminal. O que muda é o lugar onde ele roda:

Exercícios

conta = 120.00
pessoas = 4
print(f"Cada um paga R$ {conta / pessoas:.2f}")

conta = 120.00
pessoas = 0
print(f"Cada um paga R$ {conta / pessoas:.2f}")

Resumo

• As caixas Experimente rodam o Python 3.14 de verdade no seu navegador. Escreva e clique em ▶ Rodar (ou Ctrl+Enter). Na primeira vez, o editor baixa o Python (~6 MB).
• O terminal da caixa mostra o comando (python3 main.py), o que o programa escreveu e o código de saída (0 = terminou bem, 1 = erro).
• Cada Rodar começa do zero: pasta vazia, variáveis novas. Nada fica guardado.
• O input() espera você digitar no terminal da caixa; nas caixas com o campo Entrada, as respostas já vêm prontas, uma por linha.
• Caixas com várias abas têm vários arquivos na mesma pasta; a primeira aba é a que roda.
• Os erros aparecem em vermelho, com o traceback real do Python, em inglês. ■ Parar interrompe um programa; depois de 10 segundos, o editor para sozinho.
• O editor não tem internet, outros programas, threads, pip nem janelas: isso fica para o terminal, onde o mesmo programa roda com python3 arquivo.py.