The debugger prompts with a line like this:
At this prompt, you can type any of the
pdb commands discussed below. You can abbreviate any
command by omitting the characters in square brackets.
For example, the
where command can be
abbreviated as simply
Evaluate an expression
expr and print its value.
Execute a Python statement
!” may be omitted if the
statement does not resemble a
If you press Enter at the
prompt, the previous command is repeated. The
list command is an exception: an
empty line entered after a
command shows you the next 11 lines after the ones
Display the argument names and values to the currently executing function.
break command sets a breakpoint
at some location in your program. If execution
reaches a breakpoint, execution will be suspended
and you will get back to the
This form of the command sets a breakpoint at a
specific line in a source file. Specify the line
number within your source file as
if you are working with multiple source
files, or if your source file hasn't been loaded
You can also specify a conditional breakpoint, that
is, one that interrupts execution only if a given
evaluates as true. For example, the command
break 92,i>5 would break at line
92 only when
i is greater than 5.
When you set a breakpoint,
prints a “breakpoint number.” You will
need to know this number to clear the breakpoint.
This form of the
break command sets
a breakpoint on the first executable statement of
Resume execution until the next breakpoint (if any).
If used without an argument, clears all
breakpoints. To clear one breakpoint, give its
breakpoint number (see
Without an argument, prints a list of valid
commands. Use the
argument to get help on
Displays your Python source code. With no
arguments, it shows 11 lines centered around the
current point of execution. The line about to be
executed is marked with an arrow (
->), and the letter
appears at the beginning of lines with breakpoints
To look at a given range of source lines, use the
argument to list 11 lines around that line number,
or provide the ending line number as an
For example, the command
would list lines 50-65.
step, but does not stop upon
entry to a called function.
Resume execution until the current function returns.
Single step: execute the current line. If any
functions are called in the current line,
pdb will break upon entering the
Same options and behavior as
but the breakpoint is temporary, that is, it is
removed after the first time it is hit.
Shows your current location in the program as a
stack traceback, with an arrow (
->) pointing to the current stack