The traceback Python displays when an error occurs contains a lot of information, but it can be overwhelming, especially when there are many frames on the stack.
The most useful parts are usually:
- What kind of error it was, and
- Where it occurred.
Syntax errors are usually easy to find, but there are a few gotchas. Whitespace errors can be tricky because spaces and tabs are invisible and we are used to ignoring them.
>>> x = 5>>> y = 6 File "<stdin>", line 1 y = 6 ˆSyntaxError: invalid syntax
In this example, the problem is that the second line is indented by one space. But the error message points to y, which is misleading. In general, error messages indicate where the problem was discovered, but the actual error might be earlier in the code, sometimes on a previous line.
The same is true of runtime errors. Suppose you are trying to compute a signal-tonoise ratio in decibels. The formula is SNRdb =10log10(Psignal/Pnoise). In Python, you might write something like this:
import mathsignal_power = 9noise_power = 10ratio = signal_power / noise_powerdecibels = 10 * math.log10(ratio)print decibels
But when you run it, you get an error message 1:
Traceback (most recent call last): File "snr.py", line 5, in ? decibels = 10 * math.log10(ratio)OverflowError: math range error
The error message indicates line 5, but there is nothing wrong with that line. To find the real error, it might be useful to print the value of ratio, which turns out to be 0. The problem is in line 4, because dividing two integers does floor division. The solution is to represent signal power and noise power with floatingpoint values.
In general, error messages tell you where the problem was discovered, but that is often not where it was caused.