El 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.
- Leer un traceback: un script de profundidad que falla, leído de abajo hacia arriba; una lectura mala en los datos, un nombre mal escrito, una clave de diccionario faltante y una entrada serie inválida atrapada con
except ValueErrormientrastraceback.print_exc()conserva la pista. - Print o logging: una lámpara de contacto de sonar que nunca se enciende, encontrada con un solo print bien puesto (un contador que se reinicia dentro de su bucle), y luego los prints convertidos en
loggingcon niveles, un nombre de logger y números de línea. - Asserts: un tanque de lastre que baja por debajo de vacío sin decir nada, un assert que lo detiene en el primer valor equivocado, la corrección, y asserts convertidos en pruebas pequeñas que atrapan el error de desbordamiento de un compañero.
- Bisecar un error: un sonar que pone el fondo del mar a 21,579 m, encontrado revisando el punto medio del proceso (un error de precedencia de operadores), y luego el mismo método de mitades para encontrar un ping malo entre 1,000 en diez pruebas y la primera versión mala de firmware en cuatro, como lo hace
git bisect. - Errores de uno: un índice uno más allá del final, un bucle que se salta la primera lectura, un límite de zona oceánica del lado equivocado (iluminado en los semáforos) y el problema del poste de cerca, todos encontrados con una lista de verificación: primero, último, cuántos.
- Errores de estado: un interruptor que falla porque asignar vuelve local un nombre, una lista por defecto compartida por cada inmersión, un respaldo que se vacía solo y un registro que se filtra de una inmersión a la siguiente.
- Jefe: tres scripts rotos: el final.
El gran final
Una hora antes de una inmersión, tres scripts fallan. Un balizo de superficie queda encendido en vez de parpadear (un error de copiar y pegar, encontrado leyendo el bucle como la lámpara), un resumen del registro de inmersión falla en su primera línea (el encabezado del CSV, encontrado desde el traceback) y el botón de modo muere en su tercera pulsación (un contador que nunca se reinicia, encontrado con la lista de verificación de errores de uno). Cada corrección se demuestra en el circuito, y el curso termina con un reporte de error escrito para cada uno: síntoma, causa, corrección y prueba.
Qué hace distinto el motor de la Pi
La Pi ejecuta MicroPython 1.29, y la depuración es donde sus mensajes importan. Las lecciones citan exactamente lo que imprime:
- Un traceback lista el archivo, la línea y la función de cada frame, pero no la línea de código ni los acentos circunflejos de CPython, así que abres la línea tú mismo.
- Algunos mensajes están redactados distinto:
unsupported types for __sub__: 'str', 'int',name 'x' isn't defined,invalid syntax for integer with base 10, y unKeyErrorimprime su clave sin comillas. - Asignar a una variable global sin
globallanzaNameError: local variable referenced before assignment, no elUnboundLocalErrorde CPython, y no nombra la variable. logginges el de CPython: los mismos niveles, formatos (incluido%(lineno)d) y las mismas trampas, como quebasicConfigno hace nada después del primer mensaje a menos que pasesforce=True.- No se puede instalar pytest, así que las pruebas son funciones simples de asserts, que es todo lo que es una prueba unitaria.