O curso
Debugging Python is an intermediate Coding course in seven lessons, after Python from zero and Fix the bug. The scripts belong to Nereus, a deep sea probe, and every lesson starts with one of them broken: a real bug that crashes it or quietly gets a number wrong. You find it with the lesson's technique, fix it, and the check proves the fixed output. The circuits are gallery Pi builds: two lamps, a PIR standing in for the sonar, a button and a lamp, and the traffic light module.
- Lendo um traceback: um script de profundidade que cai, lido de baixo para cima; uma leitura ruim nos dados, um nome escrito errado, uma chave de dicionário ausente e uma entrada serial ruim capturada com
except ValueErrorenquantotraceback.print_exc()guarda a pista. - Print vs logging: uma lâmpada de contato do sonar que nunca acende, encontrada com um único print bem posicionado (um contador zerado dentro do próprio laço), depois os prints transformados em
loggingcom níveis, um nome de logger e números de linha. - Asserts: um tanque de lastro que fica abaixo de vazio sem dizer nada, um assert que o interrompe no primeiro valor errado, a correção, e asserts transformados em pequenos testes que pegam o bug de estouro de um colega.
- Bisseccionando um bug: um sonar que coloca o fundo do mar a 21.579 m, encontrado verificando o meio do pipeline (um bug de precedência de operadores), depois a mesma metade para achar um ping ruim em 1.000 em dez testes e a primeira versão ruim de firmware em quatro, do jeito que o
git bisectfaz. - Off by one: um índice um passo além do fim, um laço que pula a primeira leitura, um limite de zona do oceano do lado errado (aceso nos semáforos) e o problema do poste de cerca, todos encontrados com uma única lista de verificação: primeiro, último, quantos.
- Bugs de estado: um interruptor que cai porque a atribuição torna um nome local, uma lista padrão compartilhada por todos os mergulhos, um backup que se esvazia sozinho e um registro que vaza de um mergulho para o próximo.
- Chefe: três scripts quebrados: o grande final.
O gran final
Uma hora antes de um mergulho, três scripts falham. Um balizador de superfície fica aceso em vez de piscar (um bug de copiar e colar, encontrado lendo o laço como a lâmpada), um resumo do registro de mergulho cai na primeira linha (o cabeçalho CSV, encontrado pelo traceback) e o botão de modo morre no terceiro aperto (um contador que nunca reinicia, encontrado com a lista de verificação de off-by-one). Cada correção é provada no circuito, e o curso termina com um relatório de bug escrito para cada um: sintoma, causa, correção e prova.
O que o motor do Pi faz de diferente
O Pi roda MicroPython 1.29, e depurar é onde suas mensagens importam. As aulas citam exatamente o que ele imprime:
- Um traceback lista o arquivo, a linha e a função de cada quadro, mas não a linha do código nem os circunflexos do CPython, então você abre a linha por conta própria.
- Algumas mensagens têm redação diferente:
unsupported types for __sub__: 'str', 'int',name 'x' isn't defined,invalid syntax for integer with base 10, e umKeyErrorimprime sua chave sem aspas. - Atribuir a uma global sem
globallevantaNameError: local variable referenced before assignment, e não oUnboundLocalErrordo CPython, e não nomeia a variável. loggingé o do CPython: os mesmos níveis, formatos (%(lineno)dtambém) e as mesmas armadilhas, comobasicConfignão fazer nada depois da primeira mensagem, a menos que você passeforce=True.- pytest não pode ser instalado, então os testes são funções comuns de asserts, que é tudo o que um teste de unidade é.