Lendo mensagens de erro e um pequeno projeto

Um traceback do Python se lê de baixo para cima: a última linha nomeia o erro, e a linha de código acima mostra onde ele aconteceu.

Uma mariposa colada num diário de bordo em 1947

Hoje a maioria dos bugs são erros no código, e o Python é bom em avisar dos que consegue detectar. Os iniciantes muitas vezes veem um erro em vermelho como um veredicto. Ele se parece mais com uma nota de entrega: o que deu errado, em que linha e em que trecho de código. O truque é saber onde olhar.

Leia um traceback de baixo para cima

total = 0
count = 0
print(total / count)

Traceback (most recent call last):
  File "main.py", line 3, in <module>
    print(total / count)
          ~~~~~~^~~~~~~
ZeroDivisionError: division by zero

Comece pela última linha. ZeroDivisionError: division by zero dá o tipo de erro e uma explicação curta. Depois suba até a linha File: o nome do arquivo (no seu computador aparece o caminho completo da pasta; aqui ele foi encurtado para main.py) e o número da linha, 3. A linha abaixo é o próprio código, e o Python 3.12 marca a operação exata que falhou com ^ sob o sinal /. Só depois de ler as três coisas você deve começar a mudar algo. Quando o erro acontece dentro de uma função, o traceback lista todas as chamadas no caminho, e a linha File mais de baixo costuma ser a primeira a olhar.

Um SyntaxError é diferente dos outros. O Python o encontra antes de executar qualquer coisa, então nem a linha 1 roda, e não há cabeçalho "Traceback". Todos os outros acontecem durante a execução do programa, depois que as linhas anteriores já fizeram seu trabalho. Quando você espera um erro específico, pode capturá-lo com try e except, que o tutorial trata no capítulo sobre erros: o Python tenta o bloco recuado e, se esse erro acontecer, executa o bloco except em vez de parar.

print("before")
n = int("abc")
print("after")

before
Traceback (most recent call last):
  File "main.py", line 2, in <module>
    n = int("abc")
        ^^^^^^^^^^
ValueError: invalid literal for int() with base 10: 'abc'

text = "abc"
try:
    n = int(text)
except ValueError:
    n = 0
print(n)

0

Os bugs mais difíceis não dão mensagem nenhuma. Um erro de lógica é um programa que roda e imprime a resposta errada, como o programa de notas da unidade sobre if que deu C a 85. O Python não tem como saber o que você quis dizer. Nesses casos, volte à tabela de rastreamento ou acrescente linhas print temporárias que mostrem as variáveis a cada passo e remova-as quando achar o bug.

Pequeno projeto: um caderno de mesada

O projeto usa algo de quase todas as unidades: um dicionário de gastos, uma função que devolve um total, um laço for, uma f-string e um if. Digite, execute e depois faça do seu jeito: mude os itens, acrescente uma categoria ou avise quando um item custar mais da metade da mesada.

def total(spent):
    t = 0
    for amount in spent.values():
        t += amount
    return t

allowance = 30000
spent = {"snacks": 4500, "bus card": 10000, "notebook": 2500}
used = total(spent)
left = allowance - used
for item, amount in spent.items():
    print(f"{item}: {amount} won")
print(f"Spent {used}, left {left}")
if left < 15000:
    print("Less than half left")

snacks: 4500 won
bus card: 10000 won
notebook: 2500 won
Spent 17000, left 13000
Less than half left

Antes de mudar, faça uma tabela de rastreamento de used e left e preveja o que acontece se você acrescentar um item de 6000 won. Depois depure de propósito: apague os dois-pontos depois da linha def, escreva spent errado uma vez e divida used por zero. Leia cada traceback de baixo para cima antes de corrigir. Saber quebrar um programa e consertá-lo de novo é a habilidade de verdade que este curso foi construindo.