Home » Support » Index of All Documentation » Wing IDE Reference Manual »

This chapter documents the entire set of available preferences for Wing IDE Professional. Note that this includes preferences that are ignored and unused in Wing IDE Personal and Wing IDE 101.

Most preferences can be set from the Preferences GUI but some users may wish to build preference files manually to control different instances of Wing IDE (see details in Preferences Customization).

User Interface

Display Language

The language to use for the user interface. Either the default for this system, or set to a specific supported language.

Internal Name: main.display-language

Data Specification: [de, en, fr, None]

Default Value: None

Display Style

Configures the overall display style used by Wing IDE.

Internal Name: gui.qt-display-theme

Data Specification: [tuple length 4 of: [selected-colors, selected-style, None], None, [Windows, CDE, Cleanlooks, Motif, Plastique], None]

Default Value: (None, None, u'Windows', None)

Color Palette

The overall color palette used by Wing IDE. All color preferences default to using colors from the palette, but can be overridden individually. The background colors from the palette will only apply to the editor, unless the Display Style preference is set to Match Palette. Additional palettes can be defined and added to the 'palettes' sub-directory of the User Settings directory.

Internal Name: gui.qt-color-palette

Data Specification: <type str>

Default Value: wing-classic

Use System Qt

Use the system-provided Qt library (requires Qt4 4.8 or later). Wing comes with its own private copy of the Qt libraries for which it is built and tested. Use the system Qt option to better integrate with the gnome or other desktop environment, however on some systems this may result in random crashing or other bugs resulting from binary incompatibilities in library versions. This preference may be overridden on the command line with the --system-qt and --private-qt command line options.

Internal Name: gui.use-system-qt

Data Specification: [False, True, None]

Default Value: False

  • Layout

Show Editor Tabs

Controls whether or not Wing shows tabs for switching between editors. When false, a popup menu is used instead.

Internal Name: gui.use-notebook-editors

Data Specification: <boolean: 0 or 1>

Default Value: 1

  • Toolbar

Show Toolbar

Whether toolbar is shown in any window.

Internal Name: gui.show-toolbar

Data Specification: <boolean: 0 or 1>

Default Value: 1

Toolbar Size

Sets size of the toolbar icons. By default, adjusts according to available space.

Internal Name: gui.toolbar-icon-size

Data Specification: [medium, default, xlarge, text-height, large, small]

Default Value: auto

Toolbar Style

Select style of toolbar icons to use. By default, adjusts according to available space.

Internal Name: gui.toolbar-icon-style

Data Specification: [medium, default, auto, xlarge, text-height, large, small]

Default Value: auto

  • Fonts

Display Font/Size

The base font and size to use for the user interface's menus and labels

Internal Name: gui.qt-display-font

Data Specification: [None or <type str>]

Default Value: None

Editor Font/Size

The base font and size to use for the source code editor, Python Shell, Debug Probe, Source Assistant, and other tools that display source code.

Internal Name: edit.qt-display-font

Data Specification: [None or <type str>]

Default Value: None

  • Keyboard

Personality

Selects the overall editor personality, optionally to emulate another commonly used editor.

Internal Name: edit.personality

Data Specification: [normal, vi, eclipse, brief, emacs, visualstudio]

Default Value: normal

Tab Key Action

Defines the action of the Tab key, one of: "Default for Personality" to emulate the selected Keyboard Personality. "Indent To Match" to indent the current line or selected line(s) to match the context, "Move to Next Tab Stop" to enter indentation characters so the caret reaches the next tab stop, "Indent Region" to increase the indentation of the selected line(s) by one level, or "Insert Tab Character" to insert a Tab character (chr(9)). For Python files, "Smart Tab" is an option that varies the tab key action according to the location of the caret within the line.

Internal Name: edit.tab-key-action

Data Specification: [dict; keys: <type str>, values: <type str>]

Default Value: {'*': '--default--', 'text/x-python': '--default--'}

Smart Tab End of Line Indents

Select type of indentation that Smart Tab will place at the end of a line.

Internal Name: edit.smart-tab-eol-indents

Data Specification: [1, 2, 3, 4, None]

Default Value: 4

Use Alt for Accelerators

Specifies whether plain Alt keystrokes should be used only for accelerators. When enabled, Alt-key presses that could be for an accelerator will be used only for accelerators and never for key bindings. When disabled, Alt-key bindings take precedence over accelerators. This preference is ignored when Wing is running with native OS X display style, since in that case accelerators do not exist.

Internal Name: gui.qt-os-alt-for-accelerators

Data Specification: <boolean: 0 or 1>

Default Value: False

VI Mode Ctrl-C/X/V

Controls the behavior of the Ctrl-X/C/V key bindings in vi mode. Either always use these for cut/copy/paste, use them for vi native actions such as initiate-numeric-repeat and start-select-block, or use the default by system (clipboard on win32 and other commands elsewhere).

Internal Name: vi-mode.clipboard-bindings

Data Specification: [other, clipboard, system-default]

Default Value: system-default

Files

Default Directory Policy

Defines how Wing determines the starting directory to use when prompting for a file name: Either based on location of the resource at current focus, location of the current project home directory, the last directory visited for file selection, the current directory at startup (or selected since), or always the specific fixed directory entered here.

Internal Name: main.start-dir-policy

Data Specification: [tuple length 2 of: [current-project, current-directory, recent-directory, current-focus, selected-directory], <type str>]

Default Value: ('current-focus', '')

Title Style

Format used for titles of source files: Use Base Name Only to display just the file name, Prepend Relative Path to use partial relative path from the project file location or configured Project Home Directory, Append Relative Path to instead append the relative path after the file namePrepend Full Path to use full path, or Append Full Path to instead append the fullpath after the file name.

Internal Name: gui.source-title-style

Data Specification: [append-relative, basename, prepend-fullpath, append-fullpath, prepend-relative]

Default Value: append-relative

Default Encoding

The default encoding to use for text files opened in the source editor and other tools, when an encoding for that file cannot be determined by reading the file. Other encodings may also be tried. This also sets the encoding to use for newly created files.

Internal Name: edit.default-encoding

Data Specification: [None or [Central and Eastern European iso8859-2, Japanese iso-2022-jp-2004, Hebrew cp856, Japanese euc-jp, Vietnamese cp1258, Greek cp1253, Baltic Languages cp1257, Korean johab, System default (UTF-8), Baltic Languages cp775, Japanese iso-2022-jp-ext, Korean iso-2022-kr, Icelandic cp861, Hebrew cp424, Cyrillic Languages cp1251, Turkish iso8859-9, Unicode (UTF-16, little endian) utf-16-le, Western European cp500, Chinese (PRC) gb18030, Greek cp875, Arabic cp864, Icelandic mac-iceland, Chinese (PRC) gbk, Turkish mac-turkish, Greek iso8859-7, Baltic Languages iso8859-13, Cyrillic Languages mac-cyrillic, Greek cp869, Japanese iso-2022-jp-1, Central and Eastern European cp852, Japanese iso-2022-jp-2, Chinese (ROC) big5, Urdu cp1006, Hebrew iso8859-8, Celtic Languages iso8859-14, Thai cp874, Cyrillic Languages cp855, Western European iso8859-15, Greek mac-greek, Western European cp1252, Ukrainian koi8-u, Hebrew cp1255, Danish, Norwegian cp865, Cyrillic Languages iso8859-5, Turkish cp1026, Western European mac-roman, Western European cp1140, Chinese (PRC) hz, Portuguese cp860, Chinese (ROC) cp950, US, Canada, and Others cp037, Japanese shift-jis-2004, Turkish cp1254, Japanese iso-2022-jp-3, Hebrew cp862, Western European latin-1, Japanese euc-jisx0213, Unicode (UTF-16, big endian) utf-16-be, Japanese euc-jis-2004, Japanese shift-jisx0213, Central and Eastern European cp1250, Baltic Languages iso8859-4, English ascii, Japanese shift-jis, None, Arabic iso8859-6, Canadian English/French cp863, Russian koi8-r, Japanese iso-2022-jp, Unicode (UTF-8) utf-8, Greek cp737, Nordic Languages iso8859-10, Central and Eastern European mac-latin2, Chinese (PRC) gb2312, Unicode (UTF-7) utf-7, Arabic cp1256, Chinese (PRC) big5hkscs, Western European cp850, Esperanto and Maltese iso8859-3, Turkish cp857, Korean cp949, US, Australia, New Zealand, S. Africa cp437, Unicode (UTF-16) utf-16, Japanese cp932]]

Default Value: None

New File EOL

Default end-of-line to use. Wing matches existing line endings in non-blank files and uses this preference only when a file contains no end-of-line characters.

Internal Name: edit.new-file-eol-style

Data Specification: [lf, cr, crlf]

Default Value: lf

New File Extension

Default file extension for newly created files

Internal Name: edit.new-file-extension

Data Specification: <type str>

Default Value: .py

  • External Display

File Display Commands

Posix only: The commands used to display or edit local disk files selected from the Help menu or project files selected for external display. This is a map from mime type to a list of display commands; each display command is tried in order of the list until one works. The mime type "*" can be used to set a generic viewer, such as a web browser. Use %s to place the file name on the command lines. If unspecified then Wing will use the configured URL viewer in the environment (specified by BROWSER environment variable or by searching the path for common browsers). On Windows, the default viewer for the file type is used instead so this preference is ignored. On OS X, files are opened with "open" by default so this preference is rarely needed.

Internal Name: gui.file-display-cmds

Data Specification: [dict; keys: <type str>, values: [list of: <type str>]]

Default Value: {}

Url Display Commands

Posix only: The commands used to display URLs. This is a map from protocol type to a list of display commands; each display command is tried in order of the list until one works. The protocol "*" can be used to set a generic viewer, such as a multi-protocol web browser. Use %s to place the URL on the command lines. If unspecified then Wing will use the configured URL viewer in the environment (specified by BROWSER environment variable or by searching the path for common browsers). On Windows, the default web browser is used instead so this preference is ignored. On OS X, URLs are opened with "open" by default so this preference is rarely needed.

Internal Name: gui.url-display-cmds

Data Specification: [dict; keys: <type str>, values: [list of: <type str>]]

Default Value: {}

Editor

Error Indicators

Controls whether Wing will show error and/or warning indicators on the editor as red and yellow underlines. When shown, hovering the mouse over the indicator shows the error or warning detail in a tooltip.

Internal Name: edit.error-display

Data Specification: [show-errors, show-none, show-all]

Default Value: show-all

Show Line Numbers

Shows or hides line numbers on the editor.

Internal Name: edit.show-line-numbers

Data Specification: <boolean: 0 or 1>

Default Value: 1

Show Whitespace

Set to true to show whitespace with visible characters by default

Internal Name: edit.show-whitespace

Data Specification: <boolean: 0 or 1>

Default Value: 0

Show EOL

Set to true to show end-of-line with visible characters by default

Internal Name: edit.show-eol

Data Specification: <boolean: 0 or 1>

Default Value: 0

Background Color

Background color to use on the source editor, Python Shell, Debug Probe, Source Assistant, and other tools that display source code. Foreground colors for text may be altered automatically to make them stand out on the selected background color.

Internal Name: edit.background-color

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

Strip Trailing White Space

Controls whether to automatically strip trailing white space in the editor. May be enabled for any file or only files that are part of the current project.

Internal Name: main.auto-rstrip-on-save

Data Specification: [tuple length 2 of: [disabled, on-save-project, on-save], <type str>]

Default Value: disabled

Block Comment Style

Style of commenting to use when commenting out blocks of Python code.

Internal Name: gui.block-comment-style

Data Specification: [indented-pep8, indented, block]

Default Value: indented

Scroll Past End

Set this to allow scrolling the editor past the last line.

Internal Name: edit.scroll-past-end

Data Specification: <boolean: 0 or 1>

Default Value: True

Ensure File Ends With EOL When Saving

Whether to add an eol at the end of the file when it is saved

Internal Name: edit.ensure-ending-eol-on-save

Data Specification: <boolean: 0 or 1>

Default Value: False

Enable Font Size Zooming

Whether to allow font size zooming in the editor, using the mouse wheel, track pad, or zoom-in and zoom-out commands.

Internal Name: edit.enable-font-zoom

Data Specification: <boolean: 0 or 1>

Default Value: True

  • Selection/Caret

Selection Color

The color used to indicate the current text selection on editable text.

Internal Name: gui.qt-text-selection-color

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

Caret Color

Selects the color to use for the editor caret.

Internal Name: edit.caret-color

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

Caret Width

Width of the blinking insertion caret on the editor, in pixels. Currently limited to a value between 1 and 3.

Internal Name: edit.caret-width

Data Specification: [from 1 to 3]

Default Value: 1

Caret Flash Rate (ms)

Sets the time in milliseconds between showing and hiding the caret when it is flashing; use 0 to disable flashing entirely

Internal Name: edit.caret-flash-rate

Data Specification: [from 0 to 2000]

Default Value: 500

Caret Line Highlight

Selects whether to highlight the line the caret is currently on. When enabled, a highlight color and alpha (transparency) can be set.

Internal Name: edit.caret-line-highlight

Data Specification: [None or [tuple length 2 of: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]], <type int>]]

Default Value: None

  • Indentation

Default Indent Size

Sets size of an indent, in spaces, used in new files. This is overridden in non-empty files, according to the actual contents of the file. In files with tab-only indentation, this value may be modified so it is a multiple of the configured tab size. Use the Indentation Manager to alter indentation in existing files.

Internal Name: edit.indent-size

Data Specification: [from 1 to 80]

Default Value: 4

Show Indent Guides

Set to true to show indent guides by default

Internal Name: edit.show-indent-guides

Data Specification: <boolean: 0 or 1>

Default Value: 0

  • Line Wrapping

Wrap Long Lines

Enable to wrap long source lines on the editor display.

Internal Name: edit.wrap-lines

Data Specification: <boolean: 0 or 1>

Default Value: 1

Edge Markers

Control whether and how edge markers are shown in the editor.

Internal Name: edit.qt-show-edge-markers

Data Specification: [tuple length 3 of: [0, 1, 2], [from 0 to 10000], [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]]

Default Value: (1, 80, None)

Reformatting Wrap Column

Column at which text should be wrapped by commands that automatically rearrange text

Internal Name: edit.text-wrap-column

Data Specification: <type int>

Default Value: 77

  • Clipboard

On Empty Selection

Controls whether or not to copy or cut the whole current line when there is no selection on the editor.

Internal Name: edit.smart-clipboard

Data Specification: [disabled, copy-cut, copy]

Default Value: copy

Middle Mouse Paste

Paste text into the editor from the clipboard when the middle mouse button is pressed. Disabling this is mainly useful for wheel mice with a soft wheel that causes pasting of text before wheel scrolling starts.

Internal Name: edit.middle-mouse-paste

Data Specification: <boolean: 0 or 1>

Default Value: True

  • Occurrences

Highlight Occurrences

Selects when to automatically highlight other occurrences of the current selection on the editor

Internal Name: edit.highlight-occurrences

Data Specification: [always, never, words]

Default Value: words

Match Case

Disable to allow occurrences highlighting also where case does not match.

Internal Name: edit.match-case-occurrences

Data Specification: <boolean: 0 or 1>

Default Value: True

Occurrences Indicator Style

The style of indicator to use for highlighting other occurrences of the current selection on the editor.

Internal Name: edit.occurrence-indicator-style

Data Specification: [box, block]

Default Value: block

Occurrences Color

The color used to indicate the current text selection on editable text.

Internal Name: edit.occurrence-color

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

  • Printing

Print Header Format

Set the header format to use for printing. This can be any text with any of the following special fields mixed in: %basename% - base file name; %prepend-fullpath% - full path file name; %prepend-relative% - relative path with from project file; %append-relative% - file name with relative path appended; %append-fullpath% - file name with full path appended; %file-time% - file modification time; %file-date% - file modification date; %current-time% - current time; %current-date% - current date; %page% - current page being printed

Internal Name: edit.print-header-format

Data Specification: <type str>

Default Value: %prepend-fullpath%

Print Footer Format

Set the footer format to use for printing. The values allowed are the same as those for print-header-format.

Internal Name: edit.print-footer-format

Data Specification: <type str>

Default Value: Page %page%, last modified %file-date% %file-time%

Print Header Font

Font to use in print header.

Internal Name: edit.print-header-font

Data Specification: [None or <type str>]

Default Value: None

Print Footer Font

Font to use in print footer.

Internal Name: edit.print-footer-font

Data Specification: [None or <type str>]

Default Value: None

Use Default Foreground Colors

Use default foreground colors for all text when printing. This is necessary when using a dark background in the GUI and printing on white paper.

Internal Name: edit.use-default-foreground-when-printing

Data Specification: <boolean: 0 or 1>

Default Value: False

Debugger

Integer Display Mode

Select the display style for integer values.

Internal Name: debug.default-integer-mode

Data Specification: [dec, hex, oct]

Default Value: dec

Hover Over Symbols

Enable to display debug data values for any symbol on the editor when the mouse cursor hovers over it.

Internal Name: debug.hover-over-symbols

Data Specification: <boolean: 0 or 1>

Default Value: 1

Hover Over Selection

Controls whether debug values are shown when the mouse hovers over a selection in the editor. This may be disabled, enabled for symbols (like x.y.z) only, or enabled for all selections including function or methods calls. WARNING: Enabling evaluation of any selection may result in function or method calls that have side effects such as altering the program state or even making unintended database or disk accesses!

Internal Name: debug.hover-over-selections

Data Specification: [0, 1, all]

Default Value: 1

Run Marker Color

The color of the text highlight used for the run position during debugging

Internal Name: debug.debug-marker-color

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

Run Marker Alpha

Select transparency (0-160) of the text highlight used for the run position during debugging

Internal Name: debug.run-marker-alpha

Data Specification: [None or <type int>]

Default Value: None

Line Threshold

Defines the character length threshold under which a value will always be shown on a single line, even if the value is a complex type like a list or dict.

Internal Name: debug.line-threshold

Data Specification: <type int>

Default Value: 65

  • I/O

Debug I/O Encoding

Encoding of input/output in the Debug I/O panel

Internal Name: debug.debug-io-encoding

Data Specification: [None or [Central and Eastern European iso8859-2, Japanese iso-2022-jp-2004, Hebrew cp856, Japanese euc-jp, Vietnamese cp1258, Greek cp1253, Baltic Languages cp1257, Korean johab, Western European cp1252, Baltic Languages cp775, Japanese iso-2022-jp-ext, Korean iso-2022-kr, Icelandic cp861, Hebrew cp424, Cyrillic Languages cp1251, Turkish iso8859-9, Unicode (UTF-16, little endian) utf-16-le, Western European cp500, Chinese (PRC) gb18030, Greek cp875, Arabic cp864, Icelandic mac-iceland, Chinese (PRC) gbk, Turkish mac-turkish, Greek iso8859-7, Baltic Languages iso8859-13, Cyrillic Languages mac-cyrillic, Greek cp869, Turkish cp1254, Japanese iso-2022-jp-1, Central and Eastern European cp852, Japanese iso-2022-jp-2, Chinese (ROC) big5, Urdu cp1006, Hebrew iso8859-8, Celtic Languages iso8859-14, Thai cp874, Cyrillic Languages cp855, Western European iso8859-15, Greek mac-greek, Ukrainian koi8-u, Hebrew cp1255, Danish, Norwegian cp865, Cyrillic Languages iso8859-5, Turkish cp1026, Western European mac-roman, Western European cp1140, Chinese (PRC) hz, Portuguese cp860, Chinese (ROC) cp950, US, Canada, and Others cp037, Japanese shift-jis-2004, Console default (UTF-8), Japanese iso-2022-jp-3, Hebrew cp862, Western European latin-1, Japanese euc-jisx0213, Unicode (UTF-16, big endian) utf-16-be, Japanese euc-jis-2004, Japanese shift-jisx0213, Central and Eastern European cp1250, Baltic Languages iso8859-4, English ascii, Japanese shift-jis, None, Arabic iso8859-6, Canadian English/French cp863, Russian koi8-r, Japanese iso-2022-jp, Unicode (UTF-8) utf-8, Greek cp737, Nordic Languages iso8859-10, Central and Eastern European mac-latin2, Chinese (PRC) gb2312, Unicode (UTF-7) utf-7, Arabic cp1256, Chinese (PRC) big5hkscs, Western European cp850, Esperanto and Maltese iso8859-3, Turkish cp857, Korean cp949, US, Australia, New Zealand, S. Africa cp437, Unicode (UTF-16) utf-16, Japanese cp932]]

Default Value: None

Shell Encoding

Encoding of input/output in the integrated Python Shell

Internal Name: debug.debug-probe-encoding

Data Specification: [None or [Central and Eastern European iso8859-2, Japanese iso-2022-jp-2004, Hebrew cp856, Japanese euc-jp, Vietnamese cp1258, Greek cp1253, Baltic Languages cp1257, Korean johab, Western European cp1252, Baltic Languages cp775, Japanese iso-2022-jp-ext, Korean iso-2022-kr, Icelandic cp861, Hebrew cp424, Cyrillic Languages cp1251, Turkish iso8859-9, Unicode (UTF-16, little endian) utf-16-le, Western European cp500, Chinese (PRC) gb18030, Greek cp875, Arabic cp864, Icelandic mac-iceland, Chinese (PRC) gbk, Turkish mac-turkish, Greek iso8859-7, Baltic Languages iso8859-13, Cyrillic Languages mac-cyrillic, Greek cp869, Central and Eastern European mac-latin2, Japanese iso-2022-jp-1, Central and Eastern European cp852, Japanese iso-2022-jp-2, Chinese (ROC) big5, Urdu cp1006, Hebrew iso8859-8, Celtic Languages iso8859-14, Thai cp874, Cyrillic Languages cp855, Western European iso8859-15, Greek mac-greek, Ukrainian koi8-u, Hebrew cp1255, Danish, Norwegian cp865, Cyrillic Languages iso8859-5, Turkish cp1026, Western European mac-roman, Western European cp1140, Chinese (PRC) hz, Portuguese cp860, Chinese (ROC) cp950, US, Canada, and Others cp037, Japanese shift-jis-2004, Turkish cp1254, Japanese iso-2022-jp-3, Hebrew cp862, Western European latin-1, Japanese euc-jisx0213, Unicode (UTF-16, big endian) utf-16-be, Japanese euc-jis-2004, Japanese shift-jisx0213, Central and Eastern European cp1250, Baltic Languages iso8859-4, English ascii, Japanese shift-jis, None, Use default stdin / stdout encoding, Canadian English/French cp863, Russian koi8-r, Japanese iso-2022-jp, Unicode (UTF-8) utf-8, Greek cp737, Nordic Languages iso8859-10, Arabic iso8859-6, Chinese (PRC) gb2312, Unicode (UTF-7) utf-7, Arabic cp1256, Chinese (PRC) big5hkscs, Western European cp850, Esperanto and Maltese iso8859-3, Turkish cp857, Korean cp949, US, Australia, New Zealand, S. Africa cp437, Unicode (UTF-16) utf-16, Japanese cp932]]

Default Value: None

Pretty Print in Shells

Enable to use pprint.pprint to display values in the Python Shell and Debug Probe.

Internal Name: debug.pretty-print-in-shells

Data Specification: <boolean: 0 or 1>

Default Value: False

  • Diagnostics

Debug Internals Log File

This is used to obtain verbose information about debugger internals in cases where you are having problems getting debugging working. Logging can be disabled, or sent to stderr, stdout, or a file.

Internal Name: debug.logfile

Data Specification: [one of: None, [<stdout>, <stderr>], <type str>]

Default Value: None

Python Shell Debug Log

This is used to obtain verbose information about the Python Shell internals in cases where you are having problems getting it working. Logging can be disabled, or sent to stderr, stdout, or a file.

Internal Name: debug.shell-logfile

Data Specification: [one of: None, [<stdout>, <stderr>], <type str>]

Default Value: None

Network

HTTP Proxy Server

Allows manual configuration of an http proxy to be used for feedback, bug reports, and license activation, all of which result in Wing connecting to wingware.com via http. Leave user name and password blank if not required.

Internal Name: main.http-proxy

Data Specification: [None or [tuple length 4 of: <type str>, <type int>, <type str>, <type str>]]

Default Value: None

Internal Preferences

Core Preferences

main.auto-check-updates

Automatically attempt to connect to wingware.com to check for updates once every day after Wing is started.

Internal Name: main.auto-check-updates

Data Specification: <boolean: 0 or 1>

Default Value: 0

main.auto-reload-scripts

When enabled, Wing will automatically reload scripts that extend the IDE when they are edited and saved from the IDE. This makes developing extension scripts for the IDE very fast, and should work in most cases. Disable this when working on extension scripts that do not reload properly, such as those that reach through the scripting API extensively.

Internal Name: main.auto-reload-scripts

Data Specification: <boolean: 0 or 1>

Default Value: True

main.auto-reopen-last-project

Controls whether most recent project is reopened at startup, in the absence of any other project on the command line.

Internal Name: main.auto-reopen-last-project

Data Specification: <boolean: 0 or 1>

Default Value: 1

main.debug-break-on-critical

If True and a gtk, gdk, or glib critical message is logged, Wing tries to start a C debugger and break at the current execution point

Internal Name: main.debug-break-on-critical

Data Specification: <boolean: 0 or 1>

Default Value: False

cache.changed-reload-policy

Selects action to perform on files found to be externally changed and that also have been altered in the IDE. One of Immediately Request Reload to ask via a dialog box upon detection, Request Reload on Edit to ask if the file is edited further, or Never Reload to ignore external changes (although you will always be warned if you try to save over an externally changed file)

Internal Name: cache.changed-reload-policy

Data Specification: [never-reload, request-reload, edit-reload]

Default Value: request-reload

cache.check-hash-before-reload

Don't reload files if size has not changed and a hash of the contents matches the hash when it was last read. This check is skipped if file is larger than 5 MB.

Internal Name: cache.check-hash-before-reload

Data Specification: <boolean: 0 or 1>

Default Value: True

main.documentation-language

The language to use for the documentation, when available (not all documentation is translated into all supported languages).

Internal Name: main.documentation-language

Data Specification: [de, en, fr, None]

Default Value: en

cache.external-check-freq

Time in seconds indicating the frequency with which the IDE should check the disk for files that have changed externally. Set to 0 to disable entirely.

Internal Name: cache.external-check-freq

Data Specification: <type int>, <type float>

Default Value: 5

main.extra-mime-type-comments

This is a map from mime type to tuple of start/end comment characters for each mime type. One entry should be added for each new mime type added with the main.extra-mime-types preference.

Internal Name: main.extra-mime-type-comments

Data Specification: [dict; keys: <type str>, values: [tuple length 2 of: <type str>, <type str>]]

Default Value: {}

main.extra-mime-type-names

This is a map from mime type to displayable name for that mime type; one entry should be added for each new mime type added with the main.extra-mime-types preference.

Internal Name: main.extra-mime-type-names

Data Specification: [dict; keys: <type str>, values: <type str>]

Default Value: {}

main.extra-mime-types

This is a map from file extension or wildcard to mime type. It adds additional file type mappings to those built into Wing IDE. File extensions can be specified alone without dot or wildcard, for example "xcf" or using wildcards containing "*" and/or "?", for example "Makefile*". The mime type to use for Python files is "text/x-python".

Internal Name: main.extra-mime-types

Data Specification: [dict; keys: <type str>, values: [text/x-smalltalk, text/x-sql, text/x-pov, text/x-ave, text/x-pl-sql, text/x-bash, text/x-java-source, text/x-lua-source, text/x-eiffel, text/x-vxml, text/x-lot, text/x-errorlist, text/x-caml, text/xml, text/x-octave, text/x-asn1, text/x-php-source, text/x-cython, application/x-tex, text/x-dos-batch, text/x-bullant, text/x-baan, text/x-python, text/x-mako, text/x-metaport, text/x-mmixal, text/x-nncrontab, text/postscript, text/x-django, text/x-erlang, text/x-javascript, text/x-scss, text/x-fortran, text/x-mysql, text/x-vhdl, text/x-escript, text/x-lisp, text/x-makefile, text/x-diff, text/x-haskell, text/x-ms-idl, text/x-cpp-source, text/x-asm, text/x-ruby, text/x-abaqus, text/x-ada, text/x-d, text/x-idl, text/x-nsis, text/x-scriptol, text/x-perl, text/x-po, text/x-docbook, text/x-rc, text/x-coffee, text/x-verilog, text/x-xcode, text/x-c-source, text/plain, text/x-spice, text/x-zope-pt, text/x-lout, text/x-matlab, text/x-inno-setup, text/html, text/x-forth, text/x-tcl, text/x-qss, text/x-vb-source, text/x-pascal, text/x-yaml, text/x-conf, text/x-ms-makefile, text/x-properties, text/css, text/x-r]]

Default Value: {}

main.file-filters

Defines file filters to apply to file names for inclusion and exclusion from a larger set (such as scanned disk files or all project files).

Each filter is named and contains one list of inclusion patterns and one list of exclusion patterns. The patterns can be a wildcard on the file name, wildcard on a directory name, or a mime type name.

Only a single pattern needs to be matched for inclusion or exclusion. Exclusion patterns take precedence over inclusion patterns, so any match on an exclusion pattern will always exclude a file from the selected set. Filters are used in constraining search, adding project files, and for other operations on collections of files.

Internal Name: main.file-filters

Data Specification: [file filters]

Default Value: {u'All Source Files': (set([]), set([('wildcard-filename', '*.pyo'), ('wildcard-filename', '*$py.class'), ('wildcard-filename', '*.exe'), ('wildcard-filename', '*.dsw'), ('wildcard-filename', '*.bsc'), ('wildcard-directory', '__pycache__'), ('wildcard-filename', '.#*'), ('wildcard-filename', '*.lib'), ('wildcard-filename', '*.bak'), ('wildcard-filename', '*.tgz'), ('wildcard-filename', '*.sln'), ('wildcard-directory', '.git'), ('wildcard-filename', '*.obj'), ('wildcard-directory', '.hg'), ('wildcard-filename', 'core'), ('wildcard-filename', '*.ilk'), ('wildcard-filename', '*.temp'), ('wildcard-filename', '*~'), ('wildcard-filename', '*.manifest'), ('wildcard-filename', '*.pdb'), ('wildcard-filename', '*.old'), ('wildcard-filename', '*.wpr'), ('wildcard-filename', '*.log'), ('wildcard-filename', '*.ncb'), ('wildcard-filename', '*.user'), ('wildcard-directory', '_svn'), ('wildcard-filename', '*.so'), ('wildcard-filename', '*.tmp'), ('wildcard-directory', '.xvpics'), ('wildcard-filename', '#*#'), ('wildcard-filename', '*.pyd'), ('wildcard-filename', '*.zip'), ('wildcard-filename', '.coverage'), ('wildcard-filename', '*.wpu'), ('wildcard-filename', '*.a'), ('wildcard-directory', '.svn'), ('wildcard-filename', '*.dll'), ('wildcard-filename', '*.dsp'), ('wildcard-filename', '*.pyc'), ('wildcard-filename', '*.tar.gz'), ('wildcard-directory', '.bzr'), ('wildcard-directory', 'CVS'), ('wildcard-filename', '*.sbr'), ('wildcard-filename', '*.o'), ('wildcard-filename', '*-old'), ('wildcard-filename', '*.suo'), ('wildcard-filename', '*.svn-base'), ('wildcard-filename', '*.vcproj')])), u'HTML and XML Files': (set([('mime-type', 'text/html'), ('mime-type', 'text/xml'), ('mime-type', 'text/x-zope-pt')]), set([('wildcard-directory', '_svn'), ('wildcard-directory', '.xvpics'), ('wildcard-filename', '*~'), ('wildcard-directory', '.bzr'), ('wildcard-directory', 'CVS'), ('wildcard-filename', '#*#'), ('wildcard-filename', '*.svn-base'), ('wildcard-directory', '__pycache__'), ('wildcard-filename', '.coverage'), ('wildcard-directory', '.git'), ('wildcard-filename', '.#*'), ('wildcard-directory', '.svn'), ('wildcard-directory', '.hg')])), u'C/C++ Files': (set([('mime-type', 'text/x-c-source'), ('mime-type', 'text/x-cpp-source')]), set([('wildcard-directory', '_svn'), ('wildcard-directory', '.xvpics'), ('wildcard-filename', '*~'), ('wildcard-directory', '.bzr'), ('wildcard-directory', 'CVS'), ('wildcard-filename', '#*#'), ('wildcard-filename', '*.svn-base'), ('wildcard-directory', '__pycache__'), ('wildcard-filename', '.coverage'), ('wildcard-directory', '.git'), ('wildcard-filename', '.#*'), ('wildcard-directory', '.svn'), ('wildcard-directory', '.hg')])), u'Hidden & Temporary Files': (set([('wildcard-filename', '*.pyo'), ('wildcard-filename', '*$py.class'), ('wildcard-filename', '*.exe'), ('wildcard-filename', '*.bsc'), ('wildcard-filename', '.#*'), ('wildcard-filename', '*.lib'), ('wildcard-filename', '*.bak'), ('wildcard-filename', '*.tgz'), ('wildcard-directory', '.git'), ('wildcard-filename', '*.obj'), ('wildcard-filename', 'core'), ('wildcard-filename', '*.ilk'), ('wildcard-filename', '*.temp'), ('wildcard-filename', '*~'), ('wildcard-directory', '__pycache__'), ('wildcard-filename', '*.pdb'), ('wildcard-filename', '*.old'), ('wildcard-filename', '*.wpr'), ('wildcard-filename', '*.ncb'), ('wildcard-directory', '_svn'), ('wildcard-filename', '*.so'), ('wildcard-filename', '*.tmp'), ('wildcard-directory', '.xvpics'), ('wildcard-filename', '#*#'), ('wildcard-filename', '*.pyd'), ('wildcard-filename', '*.zip'), ('wildcard-filename', '.coverage'), ('wildcard-filename', '*.wpu'), ('wildcard-filename', '*.a'), ('wildcard-filename', '*.dll'), ('wildcard-directory', '.hg'), ('wildcard-filename', '*.pyc'), ('wildcard-filename', '*.tar.gz'), ('wildcard-directory', '.bzr'), ('wildcard-directory', 'CVS'), ('wildcard-filename', '*.sbr'), ('wildcard-filename', '*.o'), ('wildcard-filename', '*-old'), ('wildcard-filename', '*.svn-base'), ('wildcard-directory', '.svn')]), set([])), u'Python Files': (set([('mime-type', 'text/x-cython'), ('mime-type', 'text/x-python')]), set([('wildcard-directory', '_svn'), ('wildcard-directory', '.xvpics'), ('wildcard-filename', '*~'), ('wildcard-directory', '.bzr'), ('wildcard-directory', 'CVS'), ('wildcard-filename', '#*#'), ('wildcard-filename', '*.svn-base'), ('wildcard-directory', '__pycache__'), ('wildcard-filename', '.coverage'), ('wildcard-directory', '.git'), ('wildcard-filename', '.#*'), ('wildcard-directory', '.svn'), ('wildcard-directory', '.hg')]))}

main.fileset-shared-file

Selects the file to use for storing and retrieving shared named files sets. By default (when value is None) the file 'filesets' in the user settings directory is used.

Internal Name: main.fileset-shared-file

Data Specification: [one of: <type NoneType>, <type str>]

Default Value: None

main.help-font-zoom

The amount by which to zoom font sizes in or out in the documentation viewer.

Internal Name: main.help-font-zoom

Data Specification: <type float>

Default Value: 1.0

main.ignored-updates

Used internally to keep track of updates the user is not interested in

Internal Name: main.ignored-updates

Data Specification: [list of: <type str>]

Default Value: []

main.max-error-log-size

The number of bytes at which the error log file (USER_SETTINGS_DIR/error-log) is truncated. This file can be sent to technical support to help diagnose problems with the IDE.

Internal Name: main.max-error-log-size

Data Specification: [from 10000 to 10000000]

Default Value: 500000

main.monitor-support-upgrades

Show a reminder when Support+Upgrades for the active license is expired or will expire soon.

Internal Name: main.monitor-support-upgrades

Data Specification: <boolean: 0 or 1>

Default Value: 0

main.perspective-auto-save

Selects whether to auto-save perspectives when switching to another perspective. Can always auto-save, never auto-save, prompt each time a perspective is left, or auto-save as configured on a per-perspective basis.

Internal Name: main.perspective-auto-save

Data Specification: [tuple length 2 of: [always, never, prompt, choose], <type str>]

Default Value: always

main.perspective-shared-file

Selects the file to use for storing and retrieving shared perspectives. By default (when value is None) the file 'perspectives' in the user settings directory is used.

Internal Name: main.perspective-shared-file

Data Specification: [one of: <type NoneType>, <type str>]

Default Value: None

main.plugin-overrides

Defines which plugins are enabled or disabled.

Internal Name: main.plugin-overrides

Data Specification: [dict; keys: <type str>, values: <boolean: 0 or 1>]

Default Value: {}

main.script-path

Specifies the directories in which Wing will look for user-defined scripts that extend the functionality of the IDE itself. The directory names may contain environment variables in the $(envname) form. Use $(WING:PROJECT_DIR) for the project directory.For each directory, Wing will load all found Python modules and packages, treating any function whose name starts with a letter (not _ or __) as a script-provided command. Extension scripts found in files within directories later in the list will override scripts of the same name found earlier, except that scripts can never override commands that are defined internally in Wing itself (these are documented in the Command Reference in the users manual). See the Scripting and Extending chapter of the manual for more information on writing and using extension scripts. Note that WINGHOME/scripts is always appended to the given path since it contains scripts that ship with Wing.

Internal Name: main.script-path

Data Specification: [list of: <type str>]

Default Value: [u'USER_SETTINGS_DIR/scripts']

main.show-splash-screen

Controls whether or not the splash screen is shown at startup.

Internal Name: main.show-splash-screen

Data Specification: <boolean: 0 or 1>

Default Value: 1

main.sassist-allow-pep287-errors

Whether show docstrings as ReST even if they contain parse errors. When disabled, they are shown as plain text instead. When enabled, this may destroy formatting of some docstrings.

Internal Name: main.sassist-allow-pep287-errors

Data Specification: <boolean: 0 or 1>

Default Value: False

main.sassist-always-show-docstrings

Whether to always show docstrings in the Source Assistant. When disabled, only the docstring for the last displayed symbol is shown.

Internal Name: main.sassist-always-show-docstrings

Data Specification: <boolean: 0 or 1>

Default Value: False

main.sassist-tries-rewrap

Whether to rewrap plain text docstrings for display in the Source Assistant. This may destroy formatting of some docstrings.

Internal Name: main.sassist-tries-rewrap

Data Specification: <boolean: 0 or 1>

Default Value: True

main.sassist-show-validity

Whether show docstring type and validity in the Source Assistant.

Internal Name: main.sassist-show-validity

Data Specification: <boolean: 0 or 1>

Default Value: True

main.sassist-tries-pep287

Whether to try parsing docstrings as ReST format for display in the Source Assistant. This may destroy formatting of some docstrings.

Internal Name: main.sassist-tries-pep287

Data Specification: <boolean: 0 or 1>

Default Value: True

cache.unchanged-reload-policy

Selects action to perform on files found to be externally changed but unaltered within the IDE. Use Auto Reload to automatically reload these files, Immediately Request Reload to ask via a dialog box upon detection, Requst Reload on Edit to ask only if the unchanged file is edited within the IDE subsequently, or Never Reload to ignore external changes (although you will still be warned if you try to save over an externally changed file)

Internal Name: cache.unchanged-reload-policy

Data Specification: [never-reload, auto-reload, request-reload, edit-reload]

Default Value: auto-reload

User Interface Preferences

gui.all-editors-in-all-splits

Whether to show all open editors in a window in every split.

Internal Name: gui.all-editors-in-all-splits

Data Specification: <boolean: 0 or 1>

Default Value: True

gui.alphabetize-tabs

Whether to keep tabs in alphabetical order.

Internal Name: gui.alphabetize-tabs

Data Specification: <boolean: 0 or 1>

Default Value: True

gui.auto-focus-tools

Controls whether to automatically move keyboard focus from the editor to tools when they are revealed.

Internal Name: gui.auto-focus-tools

Data Specification: <boolean: 0 or 1>

Default Value: 1

gui.auto-save-before-action

Controls whether or not all edited files are saved without asking before a debug run, before starting unit tests, or before a file or build process is executed.

Internal Name: gui.auto-save-before-action

Data Specification: <boolean: 0 or 1>

Default Value: 1

gui.enable-tooltips

Controls whether or not tooltips containing help are shown when the mouse hovers over areas of the user interface.

Internal Name: gui.enable-tooltips

Data Specification: <boolean: 0 or 1>

Default Value: 1

gui.feedback-email

Email address to use by default in the Feedback and Bug Report dialogs

Internal Name: gui.feedback-email

Data Specification: <type str>

Default Value: ""

gui.full-path-in-tooltips

Enable to always show the full path of a file name in the tooltips shown from the editor tabs and file selection menus. When disabled, the configured Source Title Style is used instead.

Internal Name: gui.full-path-in-tooltips

Data Specification: <boolean: 0 or 1>

Default Value: True

gui.icon-color-primary

Primary color for icons

Internal Name: gui.icon-color-primary

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

gui.icon-color-quaternary

Quaternary color for icons

Internal Name: gui.icon-color-quaternary

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

gui.icon-color-quinary

Quinary color for icons

Internal Name: gui.icon-color-quinary

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

gui.icon-color-secondary

Secondary color for icons

Internal Name: gui.icon-color-secondary

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

gui.icon-color-senary

Senary color for icons

Internal Name: gui.icon-color-senary

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

gui.icon-color-tertiary

Tertiary color for icons

Internal Name: gui.icon-color-tertiary

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

gui.ignore-unsaved-before-action

Controls whether or not Wing ignores files that were not saved before starting debug or that have changed since they were loaded by the debug process. Wing normally will warn of unsynchronized files since breakpoints may not be reached and stepping through the files may not work properly if lines have moved. Checking this option turns off these warnings.

Internal Name: gui.ignore-unsaved-before-action

Data Specification: <boolean: 0 or 1>

Default Value: 0

gui.keymap-override

Override key bindings in the keymap. To enter the key, place focus on the entry area and type the key combination desired. The command is one of those documented in the user manual's Command Reference, or the name of any user scripts that have been loaded into the IDE. Leave the command name blank to remove the default binding for a key (this is useful when adding multi-key bindings that conflict with a default).

Internal Name: gui.keymap-override

Data Specification: [dict; keys: <type str>, values: <type str>]

Default Value: {}

gui.keymap

Defines location of the keymap override file. Use None for default according to configured editor personality. See the Wing IDE Manual for details on building your keymap override file -- in general this is used only in development or debugging keymaps; use the keymap-override preference instead for better tracking across Wing versions.

Internal Name: gui.keymap

Data Specification: [None or <type str>]

Default Value: None

gui.last-feedback-shown

Used internally to avoid showing the feedback dialog on exit over and over again.

Internal Name: gui.last-feedback-shown

Data Specification: <type float>

Default Value: 0.0

gui.max-file-size

Maximum size of files that Wing will try to open, in MB.

Internal Name: gui.max-file-size

Data Specification: [from 1 to 100000]

Default Value: 100

gui.max-non-sticky-editors

Maximum number of non-sticky (auto-closing) editors to keep open at one time, in addition to any that are visible on screen

Internal Name: gui.max-non-sticky-editors

Data Specification: <type int>

Default Value: 1

gui.max-recent-files

Maximum number of items to display in the Recent menus.

Internal Name: gui.max-recent-files

Data Specification: [from 3 to 200]

Default Value: 20

gui.message-config

Controls the format and verbosity of messages shown to the user for each message domain in the message area. Each domain specifies the format (in Python 2.3 logging.Formatter format), and the minimum logging level that should be shown in the display. If a message domain is left unspecified, then the parent domain settings are used instead ("" is the parent of all domains).

Internal Name: gui.message-config

Data Specification: [dict; keys: [search, debugger, analysis, general, project, editor, scripts, browser], values: [tuple length 3 of: <type str>, [0, 40, 30], <type int>]]

Default Value: {'': ('%(message)s', 0, 100000)}

gui.more-controls-for-search-in-files

Controls whether "Search in Files" dialog has an extra row of visible options as buttons.

Internal Name: gui.more-controls-for-search-in-files

Data Specification: <boolean: 0 or 1>

Default Value: 0

gui.open-projects-as-text

Controls whether project files are opened as project or as text when opened from the File menu. This does not affect opening from the Project menu.

Internal Name: gui.open-projects-as-text

Data Specification: <boolean: 0 or 1>

Default Value: 0

gui.prefered-symbol-order

Control preferred order in source index displays such as the editor browse menus. Either sort in the order found in the file or alphabetical order.

Internal Name: gui.prefered-symbol-order

Data Specification: [file-order, alpha-order]

Default Value: alpha-order

gui.qt-osx-key-for-alt

Selects the key to use as the Alt- modifier in key bindings. Note that the Option key is also used to enter characters, such as ® on US keyboards or ] on German keyboards. When the Option key is used for the Alt key, Alt-key bindings take precedence and thus may block entering of characters with the Option key. If both functions are needed, use the left Option key for the Alt-key and enter characters with the right Option key. If the Command keys are used for the Alt key, any Alt-key bindings will override Command-key bindings for the same key.

Internal Name: gui.qt-osx-key-for-alt

Data Specification: [both-option-keys, command-keys, left-option-key, none]

Default Value: left-option-key

guimgr.quit-on-last-window-close-osx

Quit application when last document window closes

Internal Name: guimgr.quit-on-last-window-close-osx

Data Specification: <boolean: 0 or 1>

Default Value: False

gui.reported-exceptions

Used internally to remember which unexpected exceptions have already been reported so we only show error reporting dialog once for each.

Internal Name: gui.reported-exceptions

Data Specification: [dict; keys: <type str>, values: [dict; keys: <type str>, values: <boolean: 0 or 1>]]

Default Value: {}

gui.scan-for-pythoncom-shell-extensions

Scan for pythoncom shell extensions on Windows

Internal Name: gui.scan-for-pythoncom-shell-extensions

Data Specification: <boolean: 0 or 1>

Default Value: True

gui.set-win32-foreground-lock-timeout

Controls whether or not to set the foreground lock timeout on Windows XP, where normally Wing will be unable to bring source windows to front whenever the debug process has windows in the foreground. When this preference is true, the system-wide value that prevents background applications from raising windows is cleared whenever Wing is running. This means that other apps will also be able to raise windows without these restrictions while Wing is running. Set the preference to false to avoid this, but be prepared for windows to fail to raise in some instances. Note: If Wing is terminated abnormally or from the task manager, the changed value will persist until the user logs out.

Internal Name: gui.set-win32-foreground-lock-timeout

Data Specification: <boolean: 0 or 1>

Default Value: 1

gui.show-report-error-dialog

Whether the error bug reporting dialog (also available from the Help menu) is shown automatically when an unexpected exception is encountered inside Wing IDE.

Internal Name: gui.show-report-error-dialog

Data Specification: <boolean: 0 or 1>

Default Value: False

gui.show-feedback-dialog

Whether feedback dialog is shown to user on quit.

Internal Name: gui.show-feedback-dialog

Data Specification: <boolean: 0 or 1>

Default Value: 1

gui.sort-case-sensitive

Controls whether names are sorted case sensitively (with all caps preceding small letters) or case insensitively

Internal Name: gui.sort-case-sensitive

Data Specification: <boolean: 0 or 1>

Default Value: 0

gui.startup-show-wingtips

Controls whether or not the Wing Tips tool is shown automatically at startup of the IDE.

Internal Name: gui.startup-show-wingtips

Data Specification: <boolean: 0 or 1>

Default Value: 1

guimgr.toolbar-custom-items

Extra items to add to the tool bar.

Internal Name: guimgr.toolbar-custom-items

Data Specification: [tuple of: [tuple length 3 of: <icon spec>, <type str>, <type str>]]

Default Value: ()

guimgr.toolbar-groups

Controls which groups of tools will be shown in the toolbar.

Internal Name: guimgr.toolbar-groups

Data Specification: [tuple of: [search, indent, clip, proj, file, diff, debug, batch-search]]

Default Value: ['file', 'clip', 'search', 'diff', 'indent', 'proj', 'debug']

gui.typing-group-timeout

Sets the timeout in seconds to use for typing, after which keys pressed are considered a separate group of characters. This is used for typing-to-select on lists and in other GUI areas. Before the timeout subsequent keys are added to previous ones to refine the selection during keyboard navigation.

Internal Name: gui.typing-group-timeout

Data Specification: <type int>, <type float>

Default Value: 1

gui.windowing-policy

Policy to use for window creation: Combined Toolbox and Editor mode places toolboxes into editor windows, Separate Toolbox mode creates separate toolbox windows, and One Window per Editor mode also creates a new window for each file opened in an editor.

Internal Name: gui.windowing-policy

Data Specification: [combined-window, one-window-per-editor, separate-toolbox-window]

Default Value: combined-window

gui.work-area-rect

Rectangle to use for the IDE work area on screen. All windows open within this area. Format is (x, y, width, height), or use None for full screen.

Internal Name: gui.work-area-rect

Data Specification: [None or [tuple length 4 of: <type int>, <type int>, <type int>, <type int>]]

Default Value: None

Editor Preferences

edit.adjust-indent-after-paste

Controls whether Wing automatically adjusts indents after multi-line text is pasted. When enabled, a single undo will remove any alterations in indentation.

Internal Name: edit.adjust-indent-after-paste

Data Specification: <boolean: 0 or 1>

Default Value: True

edit.auto-brace-match

Enabled to automatically highlight the matching braces next to the cursor or as they are typed.

Internal Name: edit.auto-brace-match

Data Specification: <boolean: 0 or 1>

Default Value: 1

consoles.auto-clear

Automatically clear the OS Commands consoles each time the command is re-executed

Internal Name: consoles.auto-clear

Data Specification: <boolean: 0 or 1>

Default Value: False

edit.auto-edit-close

Enable to auto-close quotes, parenthesis, braces, comments, and so forth.

Internal Name: edit.auto-edit-close

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.auto-edit-colon

Auto-enter newline and auto-indent after typing a colon that starts a new Python block and indent following line or block of lines when colon is pressed repeatedly. This also starts a new Python block using a selected range of lines as the body, if colon is pressed on a non-empty selection.

Internal Name: edit.auto-edit-colon

Data Specification: <boolean: 0 or 1>

Default Value: 0

edit.auto-edit-colon-creates-block

Enable creating a new block with a selected range of lines when colon is pressed.

Internal Name: edit.auto-edit-colon-creates-block

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.auto-edit-comment

Enable commenting out a non-empty selection when a comment character is pressed.

Internal Name: edit.auto-edit-comment

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.auto-edit-continue

Automatically continue comments or strings in the form ("") or () after a newline is typed within the comment or string text

Internal Name: edit.auto-edit-continue

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.auto-edit-enabled

Enable or disable Wing's auto-editing capability. When enabled, a default set of individual auto-editing operations (such as auto-closing quotes and parenthesis and auto-entering invocation arguments) will be activated. The individual operations can then be enabled or disabled independently in preferences.

Internal Name: edit.auto-edit-enabled

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.auto-edit-fixups

Automatically correct code when typing keys out of order. This handles cases such as x(.) -> x(). and x(:) -> x(): as well as auto-inserting . when missing

Internal Name: edit.auto-edit-fixups

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.auto-edit-invoke

Enable auto-entry of invocation arguments for a function or method call.

Internal Name: edit.auto-edit-invoke

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.auto-edit-parens

Enable surrounding non-empty selection when a parenthesis is pressed.

Internal Name: edit.auto-edit-parens

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.auto-edit-quotes

Enable placing quotes around a non-empty selection.

Internal Name: edit.auto-edit-quotes

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.auto-edit-spaces

Enable auto-entering spaces around operators and punctuation.

Internal Name: edit.auto-edit-spaces

Data Specification: <boolean: 0 or 1>

Default Value: 0

edit.auto-edit-spaces-enforce

When auto-entering spaces is enabled, enforce PEP8 style spacing by preventing redundant spaces.

Internal Name: edit.auto-edit-spaces-enforce

Data Specification: <boolean: 0 or 1>

Default Value: 0

edit.auto-edit-spaces-args

When auto-entering spaces is enabled, also auto-enter spaces in argument lists.

Internal Name: edit.auto-edit-spaces-args

Data Specification: <boolean: 0 or 1>

Default Value: 0

edit.auto-edit-spaces-kw

Enable auto-entering spaces after keywords.

Internal Name: edit.auto-edit-spaces-kw

Data Specification: <boolean: 0 or 1>

Default Value: 0

edit.auto-indent

Controls when Wing automatically indents when return or enter is typed.

Internal Name: edit.auto-indent

Data Specification: [0, 1, blank-only]

Default Value: 1

edit.autocomplete-autoshow

Controls whether or not the completer is shown automatically during typing. When disabled, it can still be shown on demand with the Show Completer item in the Source menu.

Internal Name: edit.autocomplete-autoshow

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.autocomplete-autoshow-option

Controls whether or not the completer is always shown automatically during typing, never auto-shown, or shown only after a certain number of characters are in the completion fragment. When auto-show is disabled, the auto-completer can still be shown on demand with the Show Completer item in the Source menu.

Internal Name: edit.autocomplete-autoshow-option

Data Specification: [always, never]

Default Value: always

edit.autocomplete-case-insensitive

Controls whether matching in the completer is case sensitive or not. The correct case is always used when a completion is chosen.

Internal Name: edit.autocomplete-case-insensitive

Data Specification: <boolean: 0 or 1>

Default Value: True

edit.autocomplete-delay

Delay in seconds from last key press to wait before the auto-completer is shown. If 0.0, the auto-completer is shown immediately.

Internal Name: edit.autocomplete-delay

Data Specification: <type float>, <type int>

Default Value: 0.0

edit.autocomplete-keys

Controls which keys will enter selected completion value into the editor.

Internal Name: edit.autocomplete-keys

Data Specification: [tuple of: [f1, f3, return, space, period, bracketleft, tab, f12, colon, f10, parenleft]]

Default Value: ['tab']

edit.autocomplete-mode

Selects how completion is done in the editor: Either insert the completion at the cursor, replace any symbols that match the leading part of the completion (and insert in other cases), or replace any existing symbol with the new symbol.

Internal Name: edit.autocomplete-mode

Data Specification: [replace-matching, insert, replace]

Default Value: insert

edit.autocomplete-non-python-word-size

Sets the minimum size of words to add to the completion list for non-Python files. This affects only words found in the file, and not words included because they are keywords for that file type.

Internal Name: edit.autocomplete-non-python-word-size

Data Specification: <type int>

Default Value: 4

edit.autocomplete-non-python-option

Controls whether or not use the completer in non-Python files, where it uses a simple word list generated from the existing contents of the file. If enabled, the number of characters required before the completer is shown may be specified here.This value overrides any character threshold set above.

Internal Name: edit.autocomplete-non-python-option

Data Specification: [always, never]

Default Value: 3

edit.autocomplete-timeout

Timeout in seconds from last key press after which the auto-completer is automatically hidden. If 0.0, the auto-completer does not time out.

Internal Name: edit.autocomplete-timeout

Data Specification: <type float>, <type int>

Default Value: 0

edit.autocomplete-turbo-mode

When enabled, the Python auto-completer enters the completion automatically whenever a key other than a valid symbol name key is pressed. When disabled, only the configured completion keys enter the completion into the editor.

Internal Name: edit.autocomplete-turbo-mode

Data Specification: <boolean: 0 or 1>

Default Value: 0

edit.autocompleter-height

The maximum number of lines to show in the auto-completer at once.

Internal Name: edit.autocompleter-height

Data Specification: <type int>

Default Value: 10

edit.qt-bookmark-color

Color to use on the source editor to indicate the location of user-defined bookmarks.

Internal Name: edit.qt-bookmark-color

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

edit.bookmark-style

Visual display style to use for bookmarks: Either an underline, a background color change, or no visible marker.

Internal Name: edit.bookmark-style

Data Specification: [underline, background, None]

Default Value: background

edit.context-menu-custom-items

Extra menu items to add to the editor context menu.

Internal Name: edit.context-menu-custom-items

Data Specification: [tuple of: [tuple length 2 of: <type str>, <type str>]]

Default Value: ()

edit.context-menu-groups

Controls which groups of menu items will be shown in the editor's context menu.

Internal Name: edit.context-menu-groups

Data Specification: [tuple of: [comment, indent, clip, script, vcs, nav, debug]]

Default Value: ['clip', 'nav', 'debug', 'comment', 'indent', 'vcs', 'script']

edit.dataentry-undo-grouping

Whether or not to group all edits made during data entry mode into a single undo action.

Internal Name: edit.dataentry-undo-grouping

Data Specification: <boolean: 0 or 1>

Default Value: False

edit.qt-diff-color

Color to use on the source editor for differences during a diff/merge session. The current mark is drawn in a lighter version of the same color. The within-difference change indicators are drawn transparently with the color set in the Text Selection Color preference.

Internal Name: edit.qt-diff-color

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

edit.enable-folding

Whether to enable folding source code.

Internal Name: edit.enable-folding

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.fold-indicator-style

Selects the type of indicators to draw at fold points.

Internal Name: edit.fold-indicator-style

Data Specification: [from 0 to 3]

Default Value: 1

edit.fold-line-mode

Whether and how to show a line at a collapsed fold point. Controls the position of the line and whether it is shown for collapsed or expanded fold points.

Internal Name: edit.fold-line-mode

Data Specification: [above-collapsed, above-expanded, none, below-collapsed, below-expanded]

Default Value: below-collapsed

edit.fold-mime-types

Selects the mime types for which folding should be allowed when folding in general is enabled.

Internal Name: edit.fold-mime-types

Data Specification: [list of: <type str>]

Default Value: ['text/x-python', 'text/x-c-source', 'text/x-cpp-source', 'text/x-java-source', 'text/x-javascript', 'text/html', 'text/x-mako', 'text/x-django', 'text/xml', 'text/x-zope-pt', 'text/x-eiffel', 'text/x-lisp', 'text/x-ruby', 'text/x-cython']

edit.fold-trailing-whitespace

Controls whether or not trailing white space after a block of code is folded up along with the block, for a more compact folded display.

Internal Name: edit.fold-trailing-whitespace

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.highlight-builtins

Highlight Python builtins

Internal Name: edit.highlight-builtins

Data Specification: <boolean: 0 or 1>

Default Value: True

edit.indent-style

Set the style of indentation used in new files. This is overridden in non-empty files, according to the actual contents of the file. Use the Indentation Manager to alter indentation in existing files.

Internal Name: edit.indent-style

Data Specification: [mixed, spaces-only, tabs-only]

Default Value: spaces-only

edit.gtk-input-method

Input method used for typing characters. This is important primarily for non-Western European languages.

Internal Name: edit.gtk-input-method

Data Specification: []

Default Value: default

.edit.max-symbol-menu-name-count

The maximum number of names allowed on a single symbol menu

Internal Name: .edit.max-symbol-menu-name-count

Data Specification: <type int>

Default Value: 200

edit.qt-merged-diff-color

Color to use on the source editor for already merged differences during a diff/merge session. The current mark is drawn in a lighter version of the same color. The within-difference change indicators are drawn transparently with the color set in the Text Selection Color preference.

Internal Name: edit.qt-merged-diff-color

Data Specification: [None or [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value: None

edit.minisearch-case-sensitive

Whether or not mini-search is case sensitive. May match the current keyboard personality's default, use case sensitive search only if an upper case character is typed, always search case sensitive, or always search case insensitively.

Internal Name: edit.minisearch-case-sensitive

Data Specification: [always, never, if-upper, match-mode]

Default Value: match-mode

consoles.wrap-long-lines

Wrap long output lines in OS Commands tool to fit within available display area.

Internal Name: consoles.wrap-long-lines

Data Specification: <boolean: 0 or 1>

Default Value: False

consoles.encoding

Default encoding of sub-process input/output when run in the OS Commands panel. This can be overridden on a per-command basis, in each command's properties.

Internal Name: consoles.encoding

Data Specification: [None or [Central and Eastern European iso8859-2, Japanese iso-2022-jp-2004, Hebrew cp856, Japanese euc-jp, Vietnamese cp1258, Greek cp1253, Baltic Languages cp1257, Korean johab, Western European cp1252, Baltic Languages cp775, Japanese iso-2022-jp-ext, Korean iso-2022-kr, Icelandic cp861, Hebrew cp424, Cyrillic Languages cp1251, Turkish iso8859-9, Unicode (UTF-16, little endian) utf-16-le, Western European cp500, Chinese (PRC) gb18030, Greek cp875, Arabic cp864, Icelandic mac-iceland, Chinese (PRC) gbk, Turkish mac-turkish, Greek iso8859-7, Baltic Languages iso8859-13, Cyrillic Languages mac-cyrillic, Greek cp869, Turkish cp1254, Japanese iso-2022-jp-1, Central and Eastern European cp852, Japanese iso-2022-jp-2, Chinese (ROC) big5, Urdu cp1006, Hebrew iso8859-8, Celtic Languages iso8859-14, Thai cp874, Cyrillic Languages cp855, Western European iso8859-15, Greek mac-greek, Ukrainian koi8-u, Hebrew cp1255, Danish, Norwegian cp865, Cyrillic Languages iso8859-5, Turkish cp1026, Western European mac-roman, Western European cp1140, Chinese (PRC) hz, Portuguese cp860, Chinese (ROC) cp950, US, Canada, and Others cp037, Japanese shift-jis-2004, Console default (UTF-8), Japanese iso-2022-jp-3, Hebrew cp862, Western European latin-1, Japanese euc-jisx0213, Unicode (UTF-16, big endian) utf-16-be, Japanese euc-jis-2004, Japanese shift-jisx0213, Central and Eastern European cp1250, Baltic Languages iso8859-4, English ascii, Japanese shift-jis, None, Arabic iso8859-6, Canadian English/French cp863, Russian koi8-r, Japanese iso-2022-jp, Unicode (UTF-8) utf-8, Greek cp737, Nordic Languages iso8859-10, Central and Eastern European mac-latin2, Chinese (PRC) gb2312, Unicode (UTF-7) utf-7, Arabic cp1256, Chinese (PRC) big5hkscs, Western European cp850, Esperanto and Maltese iso8859-3, Turkish cp857, Korean cp949, US, Australia, New Zealand, S. Africa cp437, Unicode (UTF-16) utf-16, Japanese cp932]]

Default Value: None

consoles.python-prompt-after-execution

Drop into Python shell after executing any Python file in the OS Commands tool

Internal Name: consoles.python-prompt-after-execution

Data Specification: <boolean: 0 or 1>

Default Value: False

edit.select-policy

This controls whether to retain selection in the editor after certain operations. The editor may always select the text that was operated on, only retain existing selections, or never select after the operation completes.

Internal Name: edit.select-policy

Data Specification: [dict; keys: [(u'Indent Region', 'indent-region'), (u'Indent To Match', 'indent-to-match'), (u'Uncomment out Region', 'uncomment-out-region'), (u'Outdent Region', 'outdent-region'), (u'Comment out Region', 'comment-out-region')], values: [(u'Never Select', 'never-select'), (u'Retain Select', 'retain-select'), (u'Always Select', 'always-select')]]

Default Value: {'uncomment-out-region': 'retain-select', 'outdent-region': 'retain-select', 'comment-out-region': 'retain-select', 'indent-region': 'retain-select', 'indent-to-match': 'retain-select'}

edit.show-non-py-indent-warning

Show indent mismatch warning dialog when user selects an indent style that is incompatible with existing file content. This only applies to non-Python files since Wing disallows overriding the indent style in all Python files.

Internal Name: edit.show-non-py-indent-warning

Data Specification: <boolean: 0 or 1>

Default Value: False

edit.show-python-indent-warnings

Set to show a warning dialog when opening a Python file that contains potentially problematic indentation: Either inconsistent and possibly confusing indentation, a mix of indent styles in a single file, or mixed tab and space indentation (which is not recommended for Python).

Internal Name: edit.show-python-indent-warnings

Data Specification: <boolean: 0 or 1>

Default Value: 1

edit.snippets-in-autocompleter

Whether or not to include code snippets in the auto-completer.

Internal Name: edit.snippets-in-autocompleter

Data Specification: <boolean: 0 or 1>

Default Value: True

edit.sassist-font-zoom

The amount by which to zoom font sizes in or out in the Source Assistant.

Internal Name: edit.sassist-font-zoom

Data Specification: <type float>

Default Value: 1.0

gui.split-reuse-policy

Policy for reusing splits in editors when new files are opened: Either always open in current split, reuse already visible editor falling back on current split, reuse already visible editor falling back on adjacent split, or always open in an adjacent split. This only has an effect when more than one editor split is visible.

Internal Name: gui.split-reuse-policy

Data Specification: [current, reuse-adjacent, reuse-current, adjacent]

Default Value: current

edit.suspend-analysis-timeout

Number of seconds between last key press and when analysis is re-enabled if analysis is to be suspended while typing occurs. If <= 0, analysis is not suspended.

Internal Name: edit.suspend-analysis-timeout

Data Specification: <type int>, <type float>

Default Value: 3

edit.symbol-find-alpha-sort

Controls whether to sort Find Symbol dialog alphabetically or in natural file order

Internal Name: edit.symbol-find-alpha-sort

Data Specification: <boolean: 0 or 1>

Default Value: True

edit.symbol-find-include-args

Controls whether to include argument specs in the searchable text used in the Find Symbol dialog

Internal Name: edit.symbol-find-include-args

Data Specification: <boolean: 0 or 1>

Default Value: False

.edit.syntax-formatting

Formatting options for syntax coloring in editors. Colors are relative to a white background and will be transformed if the background color is set to a color other than white.

Internal Name: .edit.syntax-formatting

Data Specification: [dict; keys: <type str>, values: [dict; keys: [italic, back, fore, bold], values: [one of: None, <type str>, <boolean: 0 or 1>]]]

Default Value: {}

edit.tab-size

Set size of tabs, in spaces, used in new files. Note that in Python files that contain mixed space and tab indentation, tab size is always forced to 8 spaces. Use the Indentation Manager to alter indentation in existing files.

Internal Name: edit.tab-size

Data Specification: [from 1 to 80]

Default Value: 8

edit.use-indent-analysis

Select when to use indent analysis (examination of current file contents) in order to determine tab size and indent size. Either always in all files, only in Python files, or never.

Internal Name: edit.use-indent-analysis

Data Specification: [always, never, python-only]

Default Value: always

Project Manager Preferences

proj.close-also-windows

Controls whether any files open in an editor are also closed when a project file is closed

Internal Name: proj.close-also-windows

Data Specification: <boolean: 0 or 1>

Default Value: 1

proj.confirm-file-drags

Controls whether or not the IDE will confirm file copy/move operations initiated by dragging items around on the Project view.

Internal Name: proj.confirm-file-drags

Data Specification: <boolean: 0 or 1>

Default Value: 1

proj.context-menu-custom-items

Extra menu items to add to the Project tool context menu.

Internal Name: proj.context-menu-custom-items

Data Specification: [tuple of: [tuple length 2 of: <type str>, <type str>]]

Default Value: ()

proj.context-menu-groups

Controls which groups of menu items will be shown in the Project tool's context menu.

Internal Name: proj.context-menu-groups

Data Specification: [tuple of: [clip, script, vcs, nav, proj, file, debug]]

Default Value: ['clip', 'nav', 'debug', 'vcs', 'proj', 'file', 'script']

proj.follow-editor

Controls whether or not the IDE will follow the current editor by expanding the project tree to show the file open in the editor.

Internal Name: proj.follow-editor

Data Specification: <boolean: 0 or 1>

Default Value: 0

proj.follow-selection

Controls whether or not the IDE will follow the current project manager selection by opening the corresponding source file in a non-sticky (auto-closing) editor. In either case, the project manager will always open a file in sticky mode when an item is double clicked or the Goto Source context menu item is used.

Internal Name: proj.follow-selection

Data Specification: <boolean: 0 or 1>

Default Value: 0

proj.open-from-project-full-paths

Match fragments to full path of the file name, rather than just the file name. Full path matching still occurs when the path separation character is included in the search pattern.

Internal Name: proj.open-from-project-full-paths

Data Specification: <boolean: 0 or 1>

Default Value: 1

proj.show-new-project-dialog

Whether to show New Project dialog when creating projects. When this is disabled, a blank project is created and can be configured and saved from the Project menu.

Internal Name: proj.show-new-project-dialog

Data Specification: <boolean: 0 or 1>

Default Value: 1

Debugger Preferences

debug.allow-bytecode-repr

Allow __repr__ methodes implemented in Python to be invoked. Set to false if the __repr__ methods take too long to compute or fail due to other bugs

Internal Name: debug.allow-bytecode-repr

Data Specification: <boolean: 0 or 1>

Default Value: True

debug.allow-dynamic-introspection

Set to allow Python code and other dynamic calls to be invoked while introspecting values in the debugger, for display in the auto-completer, shells, and source assistant. This should be used with caution. In some code bases, enabling this can execute unwanted code, make unexpected changes to runtime state, hang on lengthy computations, trigger thread deadlocks, or crash on buggy user code, while working in the IDE.

Internal Name: debug.allow-dynamic-introspection

Data Specification: <boolean: 0 or 1>

Default Value: False

debug.enable-kill-external

Enable or disable the terminating debug processes that were launched from outside of the IDE. When disabled, Wing just detaches from the process, leaving it running.

Internal Name: debug.enable-kill-external

Data Specification: <boolean: 0 or 1>

Default Value: 0

debug.always-stop-exceptions

Names of builtin exceptions to (nearly) always report. These exceptions are not reported only if they are explicitly caught by the specific subclass in the same frame in which they are raised.

Internal Name: debug.always-stop-exceptions

Data Specification: [tuple of: <type str>]

Default Value: ['AssertionError']

debug.attach-defaults

List of host/port combinations that should be included by default in the attach request list shown with Attach to Process in the Debug menu, in addition to those that are registered at runtime. These are used primarily with externally launched debug processes, since Wing automatically shows IDE-launched processes for attach when appropriate. This value corresponds with kAttachPort configured in wingdbstub.py or by WINGDB_ATTACHPORT environment variable before importing wingdbstub in the debug process.

Internal Name: debug.attach-defaults

Data Specification: [tuple of: [tuple length 2 of: <type str>, [from 0 to 65535]]]

Default Value: (('127.0.0.1', 50015),)

debug.auto-clear-debug-io

Enable to automatically clear the Debug I/O tool each time a new debug session is started

Internal Name: debug.auto-clear-debug-io

Data Specification: <boolean: 0 or 1>

Default Value: 1

debug.auto-show-debug-io

Controls whether and when to automatically show the Debug I/O tool when it receives output.

Internal Name: debug.auto-show-debug-io

Data Specification: [False, True, first]

Default Value: 1

debug.default-python-exec

Sets the default Python Executable to use for debugging and source code analysis. This can be overridden on a project by project basis in Project Properties.

Internal Name: debug.default-python-exec

Data Specification: [None or <type str>]

Default Value: None

debug.default-watch-style

Sets the tracking style used when a value is double clicked in order to watch it. Values may be tracked by symbolic name, by object reference and attribute by name, and by direct object reference.

Internal Name: debug.default-watch-style

Data Specification: [ref, parent-ref, symbolic]

Default Value: symbolic

debug.exception-mode

Controls how Wing reports exceptions that are raised by your debug process. By default, Wing shows exceptions at the time that the exception traceback would normally be printed. Alternatively, Wing can try to predict which exceptions are unhandled, and stop immediately when unhandled exceptions are raised so that any finally clauses can be stepped through in the debugger. Wing can also stop on all exceptions (even if handled) immediately when they are raised, or it can wait to report fatal exceptions as the debug process terminates. In the latter case Wing makes a best effort to stop before the debug process exits or at least to report the exception post-mortem, but one or both may fail if working with externally launched debug processes. In that case, we recommend using When Printed exception reporting mode.

Internal Name: debug.exception-mode

Data Specification: [unhandled, always, never, printed]

Default Value: never

debug.external-console

Selects whether to use the integrated Debug I/O tool for debug process input/output or an external terminal window. Use an external window if your debug process depends on details of the command prompt environment for cursor movement, color text, etc.

Internal Name: debug.external-console

Data Specification: <boolean: 0 or 1>

Default Value: 0

debug.filter-shell-history

Enable to filter shell history traversal when something is entered prior to starting traversal. When enabled, Wing will only show history items starting with the text between the start of the current item and the caret.

Internal Name: debug.filter-shell-history

Data Specification: <boolean: 0 or 1>

Default Value: False

debug.huge-list-threshold

Defines the length threshold over which a list, dict, or other complex type will be considered too large to show in the normal debugger. If this is set too large, the debugger will time out (see the Network Timeout preference)

Internal Name: debug.huge-list-threshold

Data Specification: <type int>

Default Value: 2000

debug.huge-string-threshold

Defines the length over which a string is considered too large to fetch for display in the debugger. If this is set too large, the debugger will time out (see the Network Timeout preference).

Internal Name: debug.huge-string-threshold

Data Specification: <type int>

Default Value: 64000

debug.introspect-in-shells

Set to introspect live Python runtimes for information displayed in autocompletion, the Source Assistant, and debug data value tooltips. Runtimes introspected include the Python Shell and live debug processes stopped at an exception or breakpoint.

Internal Name: debug.introspect-in-shells

Data Specification: <boolean: 0 or 1>

Default Value: 1

main.launch-shared-file

Selects the file to use for storing and retrieving shared launch configurations. By default the file 'launch' in the user settings directory is used.

Internal Name: main.launch-shared-file

Data Specification: [one of: <type NoneType>, <type str>]

Default Value: None

debug.location-map

Defines a mapping between the remote and local locations of files for host-to-host debugging. For each IP address, a remote and local prefix is given. This should be used when full paths of files on the remote host do not match those for the same files on the local host. Wing assumes an external file server or synchronization protocol is in use and does not itself transfer the files.

Internal Name: debug.location-map

Data Specification: [dict; keys: <ip4 address #.#.#.#>, values: [None or [list of: [tuple length 2 of: <type str>, <type str>]]]]

Default Value: {'127.0.0.1': None}

debug.network-port

Determines the TCP/IP port on which the IDE will listen for the connection from the debug process. This needs to be unique for each developer working on a given host. The debug process, if launched from outside of the IDE, needs to be told the value specified here using kWingHostPort inside wingdbstub.py or by WINGDB_HOSTPORT environment variable before importing wingdbstub in the debug process.

Internal Name: debug.network-port

Data Specification: [from 0 to 65535]

Default Value: 50005

debug.network-server

Determines the network interface on which the debugger listens for connections. This can be a symbolic name, an IP address, or left unspecified to indicate that the debugger should listen on all valid network interfaces on the machine. Note that when a debug session is launched from within the IDE (with the Run button), it always connects from the loopback interface (127.0.0.1)

Internal Name: debug.network-server

Data Specification: [None or <type str>]

Default Value: None

debug.network-timeout

Controls the amount of time that the IDE will wait for the debug process to respond before it gives up. This protects the IDE from freezing up if your program running within the debug process crashes or becomes unavailable. It must also be taken into account when network connections are slow or if sending large data values (see the Huge List Threshold and Hug String Threshold preferences).

Internal Name: debug.network-timeout

Data Specification: <type int>, <type float>

Default Value: 10

debug.never-stop-exceptions

Names of builtin exceptions to never report, even if the exception is not handled. This list takes precedence over the Always Report preference and the Report Exceptions preference when it is set to a value other than Always Immediately.

Internal Name: debug.never-stop-exceptions

Data Specification: [tuple of: <type str>]

Default Value: ['SystemExit', 'GeneratorExit']

debug.no-probe-types

Defines types for which values should never be probed for contents. These are types that are known to crash when the debugger probes them because they contain buggy data value extraction code. These values are instead shown as an opaque value with hex object instance id and are never accessed for runtime introspection.

Internal Name: debug.no-probe-types

Data Specification: [tuple of: <type str>]

Default Value: ('GdkColormap', 'IOBTree', 'JPackage')

debug.omit-names

Defines variable/key names for which values are never shown by the debugger.

Internal Name: debug.omit-names

Data Specification: [tuple of: <type str>]

Default Value: ()

debug.omit-types

Defines types for which values are never shown by the debugger.

Internal Name: debug.omit-types

Data Specification: [tuple of: <type str>]

Default Value: ('function', 'builtin_function_or_method', 'class', 'classobj', 'instance method', 'type', 'module', 'ufunc', 'wrapper_descriptor', 'method_descriptor', 'member_descriptor')

debug.passive-hosts

Sets which hosts are allowed to connect to the debugger when it is listening for externally launched programs.

Internal Name: debug.passive-hosts

Data Specification: [tuple of: <type str>]

Default Value: ('127.0.0.1',)

debug.passive-listen

Controls whether or not the debugger listens for connections from an externally launched program. This should be enabled when the debug program is not launched by the IDE.

Internal Name: debug.passive-listen

Data Specification: <boolean: 0 or 1>

Default Value: 0

debug.persist-console

Determines whether to leave up the console after normal program exit, or to close the console right away in all cases. This is only relevant when running with an external native console instead of using the integrated Debug I/O tool.

Internal Name: debug.persist-console

Data Specification: <boolean: 0 or 1>

Default Value: 0

debug.raise-from-tools

Controls whether the debugger raises source files to indicate exception locations encountered when working in the Debug Probe, and other debugger tools.

Internal Name: debug.raise-from-tools

Data Specification: <boolean: 0 or 1>

Default Value: 1

debug.resolve-properties

Set to show property values in the debug data views. This should be used with caution. It enables invocation of the fget() method on the property, which in some code bases can execute unwanted code, make unexpected changes to runtime state, hang on lengthy computations, trigger thread deadlocks, or crash on buggy user code while debug data is being displayed in the IDE.

Internal Name: debug.resolve-properties

Data Specification: <boolean: 0 or 1>

Default Value: False

debug.shell-always-execute-on-paste

Whether to always execute immediately after text is pasted into a shell. Note that if the number of lines exceed the pasted line threshold, the lines are immediately executed.

Internal Name: debug.shell-always-execute-on-paste

Data Specification: <boolean: 0 or 1>

Default Value: False

debug.shell-auto-restart-before-eval

Auto-restart the Python Shell before a file is evaluated within it. When this is disabled, be aware that previously defined symbols will linger in the Python Shell environment.

Internal Name: debug.shell-auto-restart-before-eval

Data Specification: <boolean: 0 or 1>

Default Value: 1

debug.shell-eval-whole-lines

Evaluate whole lines from editor rather than the exact selection, when a selection from the editor is sent to the Python Shell tool.

Internal Name: debug.shell-eval-whole-lines

Data Specification: <boolean: 0 or 1>

Default Value: 1

debug.shell-pasted-line-threshold

The number of lines after which the Python Shell will just print a summary rather than the actual lines of code pasted, dragged, or other transferred to the shell.

Internal Name: debug.shell-pasted-line-threshold

Data Specification: <type int>

Default Value: 30

debug.shells-ignore-editor-modes

Set to False so that shells will act modal in the same way as editors when working with a modal key bindings such as that for VI. When True, the shells always act as if in Insert mode.

Internal Name: debug.shells-ignore-editor-modes

Data Specification: <boolean: 0 or 1>

Default Value: 1

debug.show-debug-data-warnings

Controls whether or not time out, huge value, and error handling value errors are displayed by the debugger the first time they are encountered in each run of Wing.

Internal Name: debug.show-debug-data-warnings

Data Specification: <boolean: 0 or 1>

Default Value: 1

debug.show-args-dialog

Controls whether the Debug Args dialog is shown before each debug run: Either never show the dialog or show it only if 'Show this dialog before each run' is checked in the file's properties (this is the default).

Internal Name: debug.show-args-dialog

Data Specification: [per-file, never]

Default Value: per-file

debug.show-exceptions-tip

Used internally to show information about exception handling to new users. Once turned off, it is never turned on again

Internal Name: debug.show-exceptions-tip

Data Specification: <boolean: 0 or 1>

Default Value: 1

debug.stop-on-logged-exception

Controls whether to stop on exceptions logged with logging.exception if the exception mode is set to 'When Printed'

Internal Name: debug.stop-on-logged-exception

Data Specification: <boolean: 0 or 1>

Default Value: True

debug.stop-timeout

Number of seconds to wait before the debugger will stop in its own code after a pause request is received and no other Python code is reached.

Internal Name: debug.stop-timeout

Data Specification: <type float>, <type int>

Default Value: 3.0

debug.use-members-attrib

Set this to true to have the debug server use the __members__ attribute to try to interpret otherwise opaque data values. This is a preference because some extension modules contain bugs that result in crashing if this attribute is accessed. Note that __members__ has been deprecated since Python version 2.2.

Internal Name: debug.use-members-attrib

Data Specification: <boolean: 0 or 1>

Default Value: 1

debug.use-stdin-wrapper

Whether sys.stdin should be set a wrapper object for user input in the program being debugged. The wrapper allows debug commands, such as pause, to be executed while the program is waiting for user input. The wrapper may cause problems with multi-threaded programs that use C stdio functions to read directly from stdin and will be slower than the normal file object.However, turning this preference off means that your debug process will not pause or accept breakpoint changes while waiting for keyboard input, and any keyboard input that occurs as a side effect of commands typed in the Debug Probe will happen in unmodified stdin instead (even though output will still appear in the Debug Probe as always).

Internal Name: debug.use-stdin-wrapper

Data Specification: <boolean: 0 or 1>

Default Value: 1

debug.very-verbose-log

This is used to turn on very verbose and detailed logging from the debugger. Only recommended when debugging the debugger.

Internal Name: debug.very-verbose-log

Data Specification: <boolean: 0 or 1>

Default Value: False

debug.very-verbose-shell-log

This is used to turn on very verbose and detailed logging from the Python Shell internals. Only recommended when debugging the Python Shell.

Internal Name: debug.very-verbose-shell-log

Data Specification: <boolean: 0 or 1>

Default Value: False

debug.warn-stale-shell

Enable to display a dialog when the Python Shell state no longer matches the configured Python Executable and/or Python Path.

Internal Name: debug.warn-stale-shell

Data Specification: <boolean: 0 or 1>

Default Value: 1

debug.wrap-debug-io

Enables line wrapping in the integrated Debug I/O tool.

Internal Name: debug.wrap-debug-io

Data Specification: <boolean: 0 or 1>

Default Value: 0

debug.wrap-debug-probe

Enables line wrapping in the Debug Probe.

Internal Name: debug.wrap-debug-probe

Data Specification: <boolean: 0 or 1>

Default Value: 0

debug.wrap-python-shell

Enables line wrapping in the Python Shell.

Internal Name: debug.wrap-python-shell

Data Specification: <boolean: 0 or 1>

Default Value: 0

debug.x-terminal

A list of the terminal programs that are used with debug processes when running with an external console. Each is tried in turn until one is found to exist. If just the name is given, Wing will look for each first on the PATH and then in likely places. Specify the full path (starting with "/") to use a specific executable. If program arguments are specified, they must end with the argument that indicates that the rest of arguments are the program to run in the terminal. If the program name starts with ${WINGHOME} , ${WINGHOME} is replaced by the Wing install directory. On OS X if the program name ends is .applescript, the environment is loaded from a file before starting the debugger.

Internal Name: debug.x-terminal

Data Specification: [tuple of: <type str>]

Default Value: ['gnome-terminal "--title=Wing Debug Console" -x', 'xterm -T "Wing Debug Console" -e', 'konsole -T "Wing Debug Console" -e', 'rxvt -T "Wing Debug Console" -e']

Source Analysis Preferences

pysource.analyze-in-background

Whether Wing should try to analyze python source in the background.

Internal Name: pysource.analyze-in-background

Data Specification: <boolean: 0 or 1>

Default Value: 1

pysource.interfaces-path

Path to search for interface files for extension modules. If directory name is relative, it will be interpreted as relative to the user settings directory (USER_SETTINGS_DIR)

Internal Name: pysource.interfaces-path

Data Specification: [tuple of: <type str>]

Default Value: ('pi-files',)

pysource.max-background-buffers

The maximum # of analysis info buffers that can be in-memory at once for files that are not open.

Internal Name: pysource.max-background-buffers

Data Specification: [from 50 to 300]

Default Value: 80

pysource.max-disk-cache-size

The maximum size of the disk cache in megabytes

Internal Name: pysource.max-disk-cache-size

Data Specification: [from 100 to 10000]

Default Value: 500

pysource.python-doc-url-prefix

Prefix for Python Standard Library Documentation. This should be in the form http://docs.python.org/library/ and Wing will append module and symbol specific to the given URL. To use locally stored documentation, you must run a local web server since # bookmarks do not work in file: URLs.

Internal Name: pysource.python-doc-url-prefix

Data Specification: [None or <type int>]

Default Value: None

pysource.scrape-config

This is a dictionary from module name to Python code that should be executed before attempting to load extension modules for scraping. This is needed in cases where the extension modules are designed to be loaded only after some configuration magic is performed. For most extension modules, no extra configuration should be needed.

Internal Name: pysource.scrape-config

Data Specification: [dict; keys: <type str>, values: <type str>]

Default Value: {'QtSvg': 'try:\n  from PyQt4 import QtSvg\nexcept:\n  try:\n    from PyQt5 import QtSvg\n  except:\n    from PySide import QtSvg\n', 'QtWidgets': 'try:\n  from PyQt4 import QtWidgets\nexcept:\n  try:\n    from PyQt5 import QtWidgets\n  except:\n    from PySide import QtWidgets\n', 'wxpython': 'pass', 'QtHelp': 'try:\n  from PyQt4 import QtHelp\nexcept:\n  try:\n    from PyQt5 import QtHelp\n  except:\n    from PySide import QtHelp\n', 'gdk': 'import pygtk\nvers = pygtk._get_available_versions().keys()\nvers.sort()\nvers.reverse()\nfor v in vers:\n  try:\n    pygtk.require(v)\n    break\n  except:\n    pass\n', 'QtGui': 'try:\n  from PyQt4 import QtGui\nexcept:\n  try:\n    from PyQt5 import QtGui\n  except:\n    from PySide import QtGui\n', '_gst': 'from gst import _gst', 'gtk': 'import pygtk\nvers = pygtk._get_available_versions().keys()\nvers.sort()\nvers.reverse()\nfor v in vers:\n  try:\n    pygtk.require(v)\n    break\n  except:\n    pass\n', 'QtXml': 'try:\n  from PyQt4 import QtXml\nexcept:\n  try:\n    from PyQt5 import QtXml\n  except:\n    from PySide import QtXml\n', 'QtWebKit': 'try:\n  from PyQt4 import QtWebKit\nexcept:\n  try:\n    from PyQt5 import QtWebKit\n  except:\n    from PySide import QtWebKit\n', 'QtScriptTools': 'try:\n  from PyQt4 import QtScriptTools\nexcept:\n  try:\n    from PyQt5 import QtScriptTools\n  except:\n    from PySide import QtScriptTools\n', 'QtSql': 'try:\n  from PyQt4 import QtSql\nexcept:\n  try:\n    from PyQt5 import QtSql\n  except:\n    from PySide import QtSql\n', 'Qt': 'try:\n  from PyQt4 import Qt\nexcept:\n  try:\n    from PyQt5 import Qt\n  except:\n    from PySide import Qt\n', 'QtAssistant': 'try:\n  from PyQt4 import QtAssistant\nexcept:\n  try:\n    from PyQt5 import QtAssistant\n  except:\n    from PySide import QtAssistant\n', 'QtXmlPatterns': 'try:\n  from PyQt4 import QtXmlPatterns\nexcept:\n  try:\n    from PyQt5 import QtXmlPatterns\n  except:\n    from PySide import QtXmlPatterns\n', 'QtDeclarative': 'try:\n  from PyQt4 import QtDeclarative\nexcept:\n  try:\n    from PyQt5 import QtDeclarative\n  except:\n    from PySide import QtDeclarative\n', 'QtDesigner': 'try:\n  from PyQt4 import QtDesigner\nexcept:\n  try:\n    from PyQt5 import QtDesigner\n  except:\n    from PySide import QtDesigner\n', 'pango': 'import pygtk\nvers = pygtk._get_available_versions().keys()\nvers.sort()\nvers.reverse()\nfor v in vers:\n  try:\n    pygtk.require(v)\n    break\n  except:\n    pass\n', 'QtOpenGL': 'try:\n  from PyQt4 import QtOpenGL\nexcept:\n  try:\n    from PyQt5 import QtOpenGL\n  except:\n    from PySide import QtOpenGL\n', 'QtUiTools': 'try:\n  from PyQt4 import QtUiTools\nexcept:\n  try:\n    from PyQt5 import QtUiTools\n  except:\n    from PySide import QtUiTools\n', 'QSci': 'try:\n  from PyQt4 import QSci\nexcept:\n  try:\n    from PyQt5 import QSci\n  except:\n    from PySide import QSci\n', 'atk': 'import pygtk\nvers = pygtk._get_available_versions().keys()\nvers.sort()\nvers.reverse()\nfor v in vers:\n  try:\n    pygtk.require(v)\n    break\n  except:\n    pass\n', 'QtTest': 'try:\n  from PyQt4 import QtTest\nexcept:\n  try:\n    from PyQt5 import QtTest\n  except:\n    from PySide import QtTest\n', 'QtScript': 'try:\n  from PyQt4 import QtScript\nexcept:\n  try:\n    from PyQt5 import QtScript\n  except:\n    from PySide import QtScript\n', 'gobject': 'import pygtk\nvers = pygtk._get_available_versions().keys()\nvers.sort()\nvers.reverse()\nfor v in vers:\n  try:\n    pygtk.require(v)\n    break\n  except:\n    pass\n', 'QtCore': 'try:\n  from PyQt4 import QtCore\nexcept:\n  try:\n    from PyQt5 import QtCore\n  except:\n    from PySide import QtCore\n', 'QtNetwork': 'try:\n  from PyQt4 import QtNetwork\nexcept:\n  try:\n    from PyQt5 import QtNetwork\n  except:\n    from PySide import QtNetwork\n'}

pysource.scrape-modules

Enable to automatically load and introspect extension modules and other modules that cannot be statically analysed. These modules are loaded in another process space and 'scraped' to obtain at least some analysis of the module's contents.

Internal Name: pysource.scrape-modules

Data Specification: <boolean: 0 or 1>

Default Value: False

pysource.use-sqllite-dotfile-locking

Use slower, dotfile locking for sqllite databases to work around buggy remote file servers. Only needed if the user cache directory is on a remote file system or can be accessed via a remote file system. It is recommended that the user cache directory be on the local file system for performance reasons.

Internal Name: pysource.use-sqllite-dotfile-locking

Data Specification: <boolean: 0 or 1>

Default Value: False

« 18.4. Obtaining Diagnostic OutputTable of Contents20. Command Reference »

Preferences Reference