PyCharm 2018.1 Help

Configuring Breakpoints

For a breakpoint, you can configure the following properties:

  • Actions to be performed upon hitting a certain breakpoint.
  • Suspend policy, which defines whether the application should be suspended upon hitting the breakpoint.
  • Dependencies on other breakpoints.
  • Conditions defining when a breakpoint is hit.

PyCharm suggests the following way to change the breakpoints properties:

  • Using the Breakpoints dialog box, for a breakpoint selected in the list.
  • Using breakpoint icon in the left gutter

To configure breakpoints

  1. Do one of the following:
    • Right-click a breakpoint in the left gutter, and then click the link More or press Ctrl+Shift+F8.
    • Open the Breakpoints dialog box as described on page Accessing Breakpoint Properties and select the desired breakpoint in the list.
    • In the Favorites tool window, select the desired breakpoint, and click edit1.

    Note that the pop-up window shows less options than the Breakpoints dialog box. To show hidden options, click More.

  2. Define the actions to be performed by PyCharm on hitting the breakpoint:
    • If you want to be notified with a text message in the debugging console when this breakpoint is hit, select "Breakpoint hit" message next to Log to console.

      If you also want to print the breakpoint's stacktrace to console when it's hit, select Stacktrace. This is useful if you want to check which paths have lead to the given point without stopping the program's execution.

      To evaluate an expression in the context of a breakpoint and display its value in the debugging console, check the option Evaluate and log, and enter a valid expression in the option field.

      This feature lets you obtain information about your running application without having to suspend its execution.

    • To set a breakpoint the current one depends on, select it from the Disabled until selected breakpoint hit drop-down list. Once dependency has been set, the current breakpoint is disabled until selected one is hit.
      • Choose Disable again radio button to disable the current breakpoint after selected breakpoint was hit.
      • Choose Leave enable radio button to keep the current breakpoint enabled after selected breakpoint was hit.
    • Enable suspending an application upon reaching a breakpoint by selecting the Suspend checkbox, and then select one of the option buttons to specify the way a running program will be paused. For more information on the Suspend options, refer to Breakpoints dialog reference.
    • To set the break condition, enable condition by selecting the appropriate checkbox, and enter the desired expression in the Condition field.

      If the expression evaluates to true, the user-selected actions are performed. If the evaluation result is false, the breakpoint does not produce any effect.

Last modified: 23 July 2018

See Also