Debug Process I/O

Index of All Documentation » Wing Pro Reference Manual » Debugger »


For a debug process launched from Wing, I/O associated with print(), writing to stdout or stderr, calls to input(), or reads from stdin, always occurs in the Debug I/O tool, unless an external console has been configured as described in External I/O Consoles.

Debug processes launched outside of Wing, using wingdbstub, always do I/O through the environment from which they were launched, whether that's a console window, web server, or any other I/O environment.

The code that services debug process I/O does two things: (1) any waits on sys.stdin are multiplexed with servicing of the debug network socket, so that the debug process remains responsive to Wing even while waiting for keyboard input, and (2) if the debug process was launched from Wing, I/O is redirected over the network to the IDE.

Multiplexing I/O can cause problems in some code. See Debug Process I/O Multiplexing for details.

If multiple debug processes are active, Wing creates one output buffer for each process launched from the IDE and the process selected in the top left of the tool may be used to move between them.

When commands are typed in the Debug Console in Wing Pro, I/O is redirected temporarily to the Debug Console only during the time that the command is being processed.

Options

The following options are available in the Options menu in the Debug I/O tool:

Clear clears the contents of the current output buffer.

Wrap Lines causes long lines to be wrapped in the display.

Auto-Clear When Debug Starts causes Wing to automatically clear any reused output buffer when debug starts. In Wing Pro this option is ignored when multi-process debugging is enabled and the Retain History option is checked. In that case, a new buffer is created for each debug process.

Never Auto-Show prevents Wing from ever automatically showing the Debug I/O tool.

Always Auto-Show on Output causes Wing to automatically show the Debug I/O tool when any output is received from the debug process.

Auto-Show on First Output causes Wing to automatically show the Debug I/O tool only the first time output is received from a debug process.

Retain History causes Wing to retain old output buffers, up to the number configured with the Files > Max Recent Items preference. When this is unchecked, only one buffer is used.

Configure External Console allows replacing Wing's builtin Debug I/O tool with an OS-appropriate console run in a separate window. See External I/O Consoles for details.

Configure Encoding allows setting the encoding used for I/O to debug processes. This must be set to match the expectation of the debug process.

Section Contents