Wing Pro's debugger provides a powerful toolset for rapidly locating and fixing bugs in single and multi-threaded Python code, and in a single or multi-processing environment. The debugger supports breakpoints, stepping through code, inspecting and changing stack or module data, watch points, expression evaluation, and command shell style interaction with the paused debug process.

There are a number of ways to use Wing's debugger. Which you use depends on where your code is running, and how it is invoked:

Local Stand-Alone Code -- Wing can debug stand-alone scripts and applications that run on your local machine and that are launched on demand from within Wing. The next documentation page describes this in more detail.

Remote Stand-Alone Code -- Wing Pro can debug stand-alone code remotely in the same way as it debugs locally running code. This is done by configuring a remote host to which Wing will connect via SSH tunnel. For details on this, see Remote Hosts.

Local Embedded or Externally Launched Code -- Wing can also debug code that runs within a web server, in an embedded Python instance (for example as a script that controls a larger application), and other code that cannot be directly launched from the IDE. For details, see Debugging Externally Launched Code.

Remote Embedded or Externally Launched Code -- Finally, Wing Pro can debug externally launched or embedded code that is running on another host. For details, see Debugging Externally Launched Remote Code.

Because the debugger core is written in optimized C, debug overhead is relatively low. However, you should expect your programs to run 25-50% slower within the debugger in more code. Overhead is proportional to number of Python byte codes executed, so code that does a lot of work in Python and very little in support libraries will incur more overhead.

Sub-sections:

    12.0. Quick Start
    12.1. Specifying Main Entry Point
      12.1.0. Named Entry Points
    12.2. Debug Properties
    12.3. Setting Breakpoints
    12.4. Starting Debug
    12.5. Debugger Status
    12.6. Flow Control
    12.7. Viewing the Stack
    12.8. Viewing Debug Data
      12.8.0. Stack Data View
        12.8.0.0. Popup Menu Options
        12.8.0.1. Filtering Value Display
      12.8.1. Watching Values
      12.8.2. Evaluating Expressions
      12.8.3. Problems Handling Values
    12.9. Debug Process I/O
      12.9.0. External I/O Consoles
      12.9.1. Disabling Debug Process I/O Multiplexing
    12.10. Interactive Debug Probe
      12.10.0. Managing Program State
      12.10.1. Debugging Code Recursively
      12.10.2. Debug Probe Options
      12.10.3. Debug Probe Limitations
    12.11. Multi-Process Debugging
    12.12. Debugging Multi-threaded Code
    12.13. Managing Exceptions
    12.14. Running Without Debug