PyCharm 2016.2 Help

Breakpoints

Run | View Breakpoints
Ctrl+Shift+F8
debug_view_breakpoints

In this section:

Toolbar

ItemTooltip and shortcutDescription
addAdd Breakpoint
Alt+Insert
Click to show the list of available breakpoint types. Select the desired type to create a new breakpoint.
deleteRemove BreakpointClick this button to remove selected breakpoints.
fileTypeTextGroup by FileClick this button to display breakpoints under their respective files, rather than under their types:
py_breakpoint_group_by_file

Breakpoint options

The controls of this part of the Breakpoints dialog depend on the type of the selected breakpoint.

OptionDescriptionTypes of breakpoints
SuspendSelect this check box to enable suspend policy for a breakpoint.

Select one of the radio buttons to specify the way the running of the program is paused when a breakpoint is reached. If you work with JavaScript breakpoints, you only need to specify whether you want to suspend program execution when the breakpoint is hit.

If the check box is not selected, no threads are suspended.

Suspend policyDescription
AllWhen a breakpoint is hit, all threads are suspended.
ThreadWhen a breakpoint is hit, the thread where the breakpoint is hit, is suspended.
Make defaultClick this button if you want the suspend policy specified for the breakpoint in question to be used as the default one for the subsequently created breakpoints.

This button only appears, when Thread option is selected.

Python line breakpoints
Condition Select this check box and specify a condition for hitting a breakpoint in the text field.

A condition is a Boolean expression.

This expression should be valid at the line where the breakpoint is set, and is evaluated every time the breakpoint is reached. If the evaluation result is true, user-selected actions are performed.

If the result is false, the breakpoint does not produce any effect. If the Debugger cannot evaluate the expression, it displays the Condition evaluation error message. You can select whether you would like to stop at this breakpoint or ignore it.

To the right of the Condition field, there is the button shift-enter-button(Shift+Enter) that opens the multiline editor.

All types
Log message to console Select this check box if you want a log message to be displayed in the console output when the breakpoint is hit.All types
Evaluate and logSelect this check box if you wish to evaluate a certain expression at this breakpoint and to export result to the console output.

To the right of this field, there is the button shift-enter-button(Shift+Enter) that opens the multiline editor.

Line breakpoints
Remove once hitSelect this check box, if the you want the breakpoint to be deleted after hitting it.All types
Disabled until selected breakpoint is hitFrom the drop-down list, select the breakpoint in question. The option None corresponds to the always enabled breakpoint.

Besides that, you can also choose the behavior of this breakpoint, when the selected one is hit:

  • Disable again
  • Leave enabled
All types
Activation policy
On terminationThe Debugger stops when the process terminates with this exception.Python exception breakpoints
On raise If this option is selected, the Debugger stops on throwing an exception. So doing, the Debugger stops only on the first place where the exception has been thrown. Python exception breakpoints
Ignore library filesIf this check box is selected, the debugger does not stop at the exceptions thrown inside libraries.
If this check box is not selected, the debugger stops at the location in a library file, where the exception is thrown.
Python exception breakpoints

Context menu commands

CommandDescription
Move to groupPoint to this command to move the selected breakpoint to a new group, to one of the existing groups(<group name>), or out of a group (<no group>).
Edit descriptionChoose this command to enter or change description of a breakpoint.

Speed search of a breakpoint

To find a particular breakpoint

  • Start typing address or description of the target breakpoint:
    py_breakpoint_search

    PyCharm highlights the line with the matching address or description.

See Also

Last modified: 23 November 2016