User Interface

Display Theme

Configures the overall display style, or theme, used by Wing IDE. Additional GTK2 themes may be downloaded from http://art.gnome.org/themes and placed into WINGHOME/bin/gtk-bin/share/themes or USER_SETTINGS_DIR/themes. These will be added to the choices below. However, only the pixbuf, metal, and redmond95 theme engines are supported.

Internal Name:

gui.display-theme

Data Specification:

[None, H2O-gtk2-Saphire, H2O-gtk2-Emerald, H2O-gtk2-Amber, AluminumAlloy-Toxic, Redmond95, Smooth-2000, H2O-gtk2-Amythist, HighContrastLargePrint, AluminumAlloy-Cryogenic, HighContrast, AluminumAlloy-Volcanic, LowContrast, LargePrint, HighContrastLargePrintInverse, AluminumAlloy-Smog, HighContrastInverse, Smokey-Blue, Glider, Smooth-Sea-Ice, Default, Glossy P, Redmond, Smooth-Retro, Smooth-Desert, H2O-gtk2-Ruby, LowContrastLargePrint, Black-Background]

Default Value:

None

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:

[None, de, en, fr]

Default Value:

None

Display Font/Size

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

Internal Name:

gui.default-font

Data Specification:

[None or <type str>]

Default Value:

None

Source Code 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.default-font

Data Specification:

[None or <type str>]

Default Value:

None

Use System Gtk

Use the system wide gtk library (requires gtk 2.2 or later). Wing comes with its own private copy of the gtk libraries for which it is built and tested. Use the system gtk 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-gtk and --private-gtk command line options.

Internal Name:

gui.use-system-gtk

Data Specification:

<boolean: 0 or 1>

Default Value:

False

Windowing Policy

Policy to use for window creation: combined-window mode places toolboxes into editor windows, separate-toolbox-window mode creates separate tool box windows, and one-window-per-editor mode also creates a new window for each editor.

Internal Name:

gui.windowing-policy

Data Specification:

[combined-window, one-window-per-editor, separate-toolbox-window]

Default Value:

combined-window

Show Editor Notebook Tabs

Controls whether or not Wing shows notebook 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

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

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. One of "small", "medium", "large", "xlarge", or use "default" to select the system-wide settings.

Internal Name:

gui.toolbar-icon-size

Data Specification:

[medium, default, xlarge, text-height, large, small]

Default Value:

small

Toolbar Style

Select style of toolbar icons to use. One of "icon-only", "text-only", "text-below", "text-right", or use "default" to select the system-wide settings.

Internal Name:

gui.toolbar-icon-style

Data Specification:

[medium, default, xlarge, text-height, large, small]

Default Value:

text-right

Text Selection Color

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

Internal Name:

gui.text-selection-color

Data Specification:

[tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]

Default Value:

(253, 253, 104)

Source Code Background

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

Debugger Run Marker Color

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

Internal Name:

debug.run-marker-color

Data Specification:

[tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]

Default Value:

(255, 163, 163)

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:

{}

Highlight Builtins

Highlight Python builtins

Internal Name:

edit.highlight-builtins

Data Specification:

<boolean: 0 or 1>

Default Value:

True

Personality

Selects editor personality

Internal Name:

edit.personality

Data Specification:

[vi, visualstudio, emacs, brief, normal]

Default Value:

normal

Tab Key Action

Defines the action that the tab key has in files by type when it is bound to the tab key command. Possible actions are "Indent To Match" to indent the current line or selected lines to match the computed indent level for this context, "Increase Indent" to increase indentation one level, or "Insert Tab Character" to insert a Tab character (chr(9)).

Internal Name:

edit.tab-key-action

Data Specification:

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

Default Value:

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

Custom Key Bindings

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.

Internal Name:

gui.keymap-override

Data Specification:

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

Default Value:

{}

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 float>, <type int>

Default Value:

1

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

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

Case Sensitive Sorting

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

Auto-Show Bug Report Dialog

Whether the error bug reporting dialog (also avaiable 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

Auto-check for Product 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:

1

Display Area

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

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:

100000

Key Map File

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

Messages

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)}

Document Text Styles

Defines text styles used in data and document display. Each style is specified as a list of (name, value) tuples. The names and values must be valid Pango text attribute names and values. To set default values that apply to all styles, use the "default" style name (for example adding ("size", 14) changes default dislpay size to 14 points. Note that size of menus, buttons, labels, and other basic GUI elements are set using system-wide theme configuration and not from this preference. The source editor is also configured separately.

Internal Name:

main.text-styles

Data Specification:

[dict; keys: [one of: <type str>, [admonition-title, danger, footnote, citation, admonition, calltip-doc, title-4, calltip-strong, caution, title-3, title-0, title-1, image-link, calltip-type, calltip-poc, hint, calltip-arg-current, tip, literal, note, field, emphasis, title-2, calltip-class-symbol, attention, calltip-def-symbol, link, strong, marked-list-items, calltip-def, list-items, default, docinfo-header, transition, calltip-arg, caption, warning, error, navigation-link, navigation]], values: [tuple of: [one of: [tuple length 2 of: [foreground], [None or <type str>]], [tuple length 2 of: [style], [None or [oblique, italic, normal]]], [tuple length 2 of: [justification], [None or [right, fill, center, left]]], [tuple length 2 of: [font_desc], [None or <type str>]], [tuple length 2 of: [weight], [None or [one of: <type int>, [heavy, bold, ultrabold, normal, light, ultralight]]]], [tuple length 2 of: [right_margin], [None or [1]]], [tuple length 2 of: [stretch], [None or [condensed, expanded, normal, semicondensed, extracondensed, extraexpanded, semiexpanded, ultracondensed, ultraexpanded]]], [tuple length 2 of: [strikethrough], [None or <boolean: 0 or 1>]], [tuple length 2 of: [rise], [None or [from -100000 to 100000]]], [tuple length 2 of: [variant], [None or [smallcaps, normal]]], [tuple length 2 of: [underline], [None or [double, single, low, none]]], [tuple length 2 of: [ypad], [None or [1]]], [tuple length 2 of: [background], [None or <type str>]], [tuple length 2 of: [indent], [None or [1]]], [tuple length 2 of: [left_margin], [None or [1]]], [tuple length 2 of: [font_family], [None or <type str>]], [tuple length 2 of: [xpad], [None or [1]]], [tuple length 2 of: [size], [None or [one of: [from 0 to 1000000], [medium, x-large, xx-large, large, small, xx-small, x-small]]]]]]]

Default Value:

{'calltip-strong': (('font_family', 'sans'), ('weight', 'bold'), ('foreground', '#000066')), 'danger': (('background', '#ffffdd'),), 'footnote': (('weight', 'bold'),), 'navigation-link': (('foreground', '#909090'), ('style', 'italic'), ('weight', 'bold')), 'citation': (('weight', 'bold'),), 'admonition': (), 'list-items': (('xpad', '1'), ('ypad', '1')), 'title-4': (('size', 'small'), ('underline', 'single'), ('foreground', '#000066')), 'warning': (('background', '#ffffdd'),), 'caution': (('background', '#ffffdd'),), 'title-3': (('size', 'small'), ('weight', 'bold'), ('foreground', '#000066')), 'title-0': (('size', 'xx-large'), ('weight', 'bold'), ('foreground', '#000066')), 'title-1': (('size', 'large'), ('weight', 'bold'), ('foreground', '#000066')), 'image-link': (), 'calltip-type': (('font_family', 'sans'),), 'calltip-poc': (('font_family', 'sans'),), 'hint': (('background', '#ffffdd'),), 'admonition-title': (('weight', 'bold'),), 'tip': (('background', '#ffffdd'),), 'literal': (('foreground', '#227722'), ('weight', 'bold')), 'note': (), 'field': (('weight', 'bold'),), 'emphasis': (('style', 'italic'),), 'calltip-class-symbol': (('font_family', 'sans'), ('weight', 'bold'), ('foreground', '#0000ff')), 'attention': (('background', '#ddddff'),), 'calltip-def-symbol': (('font_family', 'sans'), ('weight', 'bold'), ('foreground', '#007f7f')), 'link': (('underline', 'single'), ('foreground', '#3333ff')), 'strong': (('weight', 'bold'), ('foreground', '#000066')), 'marked-list-items': (('weight', 'bold'), ('foreground', '#ff3333')), 'calltip-def': (('font_family', 'sans'), ('weight', 'bold'), ('foreground', '#00007f')), 'calltip-doc': (('font_family', 'sans'),), 'default': (), 'docinfo-header': (('weight', 'bold'),), 'transition': (('justification', 'left'),), 'calltip-arg': (('font_family', 'sans'),), 'calltip-arg-current': (('font_family', 'sans'), ('background', '#ffbbbb')), 'caption': (('style', 'italic'),), 'error': (('background', '#ffdddd'),), 'title-2': (('size', 'medium'), ('weight', 'bold'), ('foreground', '#000066')), 'navigation': (('foreground', '#909090'), ('style', 'italic'))}

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, 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 "basename" to display just the file name, "prepend-relative" to use partial relative path from the project file location, "append-relative" to append partial relative path from project file location after the base file name, "prepend-fullpath" to use full path, or "append-fullpath" to append fullpath after the based 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 [None, 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, 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: One of "lf", "cr", or "crlf" for each entry. Note that 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

Max Recent Items

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

Always Use Full Path in Tooltips

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

Internal Name:

gui.full-path-in-tooltips

Data Specification:

<boolean: 0 or 1>

Default Value:

True

Extra File 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-lua-source, text/x-eiffel, text/x-vxml, text/xml, text/x-errorlist, text/x-caml, text/x-octave, text/x-erlang, text/x-php-source, application/x-tex, text/x-dos-batch, text/x-bullant, text/x-baan, text/x-python, text/x-nncrontab, text/x-mmixal, text/x-verilog, text/postscript, text/x-asn1, text/x-javascript, text/x-fortran, text/x-vhdl, text/x-escript, text/x-lisp, text/x-makefile, text/x-diff, 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-java-source, text/x-docbook, text/x-rc, 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-vb-source, text/x-pascal, text/x-yaml, text/x-conf, text/x-ms-makefile, text/x-properties, text/css]]

Default Value:

{}

File Sets

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

Each file set 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 set. File sets are used in constraining search, adding project files, and for other operations on collections of files.

Internal Name:

main.file-sets

Data Specification:

[dict; keys: <type str>, values: [tuple length 2 of: [tuple of: [tuple length 2 of: [wildcard-filename, wildcard-directory, mime-type], <type str>]], [tuple of: [tuple length 2 of: [wildcard-filename, wildcard-directory, mime-type], <type str>]]]]

Default Value:

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

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 float>, <type int>

Default Value:

5

Reload when Unchanged

Selects action to perform on files found to be externally changed but unaltered within the IDE. One of "auto-reload" to automatically reload these files, "request-reload" to ask via a dialog box upon detection, "edit-reload" 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

Reload when Changed

Selects action to perform on files found to be externally changed and that also have been altered in the IDE. One of "request-reload" to ask via a dialog box upon detection, "edit-reload" 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

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

Close Files with Project

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

Default Type

Controls the type of project file that is written by default for new projects: "normal" for regular single-file format with extension .wpr, and "shared" for split format where the .wpr file contains shared project info that can be checked into a shared revision control repository and the .wpu file contains user-specific information such as location of breakpoints. This is useful to avoid revision control wars on a project with multiple developers.

Internal Name:

proj.file-type

Data Specification:

[shared, normal]

Default Value:

normal

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

File Display Commands

Linux 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 and OS X, the system-wide configured default viewer for the file type is used instead so this preference is ignored.

Internal Name:

gui.file-display-cmds

Data Specification:

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

Default Value:

{}

Url Display Commands

Linux 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 and OS X, the system-wide configured default web browser is used instead so this preference is ignored.

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 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

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

Split Reuse Policy

Policy for reusing splits in editors when new files are opened: Either open in current split or 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, adjacent]

Default Value:

current

Strip Trailing White Space

Controls whether to automatically strip trailing white space in the editor.

Internal Name:

main.auto-rstrip-on-save

Data Specification:

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

Default Value:

disabled

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

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

Default 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 0 to 80]

Default Value:

8

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 0 to 80]

Default Value:

4

Default 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. Indentation style choices are "tabs-only" for tabs only, "spaces-only" for spaces only, or "mixed" to use a tab whenever tab-size spaces have been seen

Internal Name:

edit.indent-style

Data Specification:

[mixed, spaces-only, tabs-only]

Default Value:

spaces-only

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

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

Show Python Indent Warning Dialog

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

Show Override Warning Dialog

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:

True

Wrap Long Lines

Set to true to wrap long source lines on the editor display.

Internal Name:

edit.wrap-lines

Data Specification:

<boolean: 0 or 1>

Default Value:

0

Edge Markers

Tuple that defines how edge markers are shown: (mode, column, color) where mode is 0 to turn off markers, 1 to show a line, or 2 to highlight text that extends past the edge; column is the column at which to draw the marker, if on; and color is the color for the marker (r,g,b) tuple with values from 0x00 to 0xff: (0xff,0xff,0xff) is white.

Internal Name:

edit.show-edge-markers

Data Specification:

[tuple length 3 of: [0, 1, 2], [from 0 to 10000], [tuple length 3 of: [from 0 to 255], [from 0 to 255], [from 0 to 255]]]

Default Value:

(0, 80, (251, 8, 8))

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

Enable Folding

Set to true to enable structural folding on source, false to disable

Internal Name:

edit.enable-folding

Data Specification:

<boolean: 0 or 1>

Default Value:

1

Line Mode

Set to "above-expanded", "below-expanded", "above-collapsed", "below-collapsed", or "none" to indicate where fold lines are shown and whether they are above or below the line where the fold point is located.

Internal Name:

edit.fold-line-mode

Data Specification:

[above-collapsed, above-expanded, none, below-collapsed, below-expanded]

Default Value:

below-collapsed

Indicator Style

Set to 0 to use arrow indicators, 1 to use plus/minus indicators, 2 to rounded tree indicators, and 3 to use square tree indicators.

Internal Name:

edit.fold-indicator-style

Data Specification:

[from 0 to 3]

Default Value:

1

Auto-show Completer

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

Auto-complete 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 int>, <type float>

Default Value:

0.0

Auto-complete 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 int>, <type float>

Default Value:

0

Completion Keys

Controls which keys will enter selected completion value into the editor. Shift or Ctrl click to select multiple items.

Internal Name:

edit.autocomplete-keys

Data Specification:

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

Default Value:

('tab',)

Completion Mode

Selects how completion is done in the editor: Either insert the completion at the cursor, or replace any existing symbol with the new symbol.

Internal Name:

edit.autocomplete-mode

Data Specification:

[insert, replace]

Default Value:

insert

Case Insensitive Matching

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

Include Templates in Completer

Whether or not to include templates in the auto-completer.

Internal Name:

edit.templates-in-autocompleter

Data Specification:

<boolean: 0 or 1>

Default Value:

True

Non-Python Completion

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

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

Print Font

(Posix only) Set the font name used to print Python files. One of Courier, Helvetica, or Times-Roman.

Internal Name:

edit.print-font

Data Specification:

[Times-Roman, Helvetica, Courier]

Default Value:

Courier

Print Size

(Posix only) Set the font size used to print Python files.

Internal Name:

edit.print-size

Data Specification:

[from 0 to 120]

Default Value:

10

Paper

(Posix only) Set the paper size for printing. One of Letter, Legal, A3, A4, A5, B4, or B5

Internal Name:

edit.print-paper

Data Specification:

[A3, A5, Legal, Letter, A4]

Default Value:

Letter

Print Spool Cmd

(Posix only) Sets the command used to spool output produced by Wing's printing facility. Format is text with embedded %s to indicate where the printed output file's name should be inserted. Set to None to use internal defaults. If the default is not working for you and your system does not accept PDF files for printing, try "pdf2ps %s - | kprinter --stdin". To rule out problems with buggy versions of kprinter, try "pdf2ps %s - | lpr" or simply "lpr %s" instead.

Internal Name:

edit.print-spool-cmd

Data Specification:

[one of: None, <type str>]

Default Value:

None

Print Python as Text

(Posix only) Set to true to print Python files faster but without syntax highlighting. Otherwise, the internal Python pretty printing facility is used.

Internal Name:

edit.print-python-as-text

Data Specification:

<boolean: 0 or 1>

Default Value:

0

Text Print Cmd

(Posix only) Sets the command that is issued to print non-Python text files. Format is text with embedded %s to indicate where the printed file's name should be inserted

Internal Name:

edit.text-print-cmd

Data Specification:

<type str>

Default Value:

enscript -E %s

Auto Brace Match

Set to true to automatically match 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

Transient Threshold

Maximum number of transient (non-sticky) 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

Selection Policy

This is a map from actions to policy for leaving a range selected after the action takes place. Possible actions are "indent-region", "outdent-region", "indent-to-match", "comment-out-region", and "uncomment-out-region". Possible policies for each are "always-select", which always leaves a selection, "retain-select" which leaves a selection only if there was one to begin with, and "never-select" which never leaves a selection.

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'}

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

Default Drag-n-Drop Action

Default drag-n-drop action. This is the default and can always be overridden by pressing shift or ctrl while dragging

Internal Name:

edit.default-drop-action

Data Specification:

[os-default, copy, move]

Default Value:

os-default

Debugger

Auto-save Files

Controls whether or not all edited files are autosaved before a debug run, or before a file or build process is executed.

Internal Name:

gui.auto-save-before-action

Data Specification:

<boolean: 0 or 1>

Default Value:

0

Ignore Unsynchronized Files

Controls whether or not Wing ignores unsaved files before a debug run, or before a file or build process is executed.

Internal Name:

gui.ignore-unsaved-before-action

Data Specification:

<boolean: 0 or 1>

Default Value:

0

Raise Source 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

Default Watch Style

Sets the tracking style used when a value is double clicked in order to watch it: Use "symbolic" to track by symbolic name, "parent-ref" to track parent by object reference and attribute by name, and "ref" to track using an object reference directly to the value

Internal Name:

debug.default-watch-style

Data Specification:

[ref, parent-ref, symbolic]

Default Value:

symbolic

Integer Display Mode

This sets the display style for integer values to one of "dec", "hex", or "oct".

Internal Name:

debug.default-integer-mode

Data Specification:

[dec, hex, oct]

Default Value:

dec

Hover Over Symbols

Set to display debug data value of 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 methods 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

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 map

Internal Name:

debug.line-threshold

Data Specification:

<type int>

Default Value:

65

Report Exceptions

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:

printed

Never Report

Names of builtin exceptions to never report, even if the exception is not handled. This list takes precedence over the always report list and the default reporting mode, but is not used if the exception reporting mode is set to always.

Internal Name:

debug.never-stop-exceptions

Data Specification:

[tuple of: <type str>]

Default Value:

['SystemExit', 'GeneratorExit']

Always Report

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

Internal Name:

debug.always-stop-exceptions

Data Specification:

[tuple of: <type str>]

Default Value:

['AssertionError', 'NameError', 'UnboundLocalError']

Use External Console

Selects whether to use the integrated I/O panel 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

External Console Waits on Exit

Set to true to leave up the console after normal program exit, or false 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 panel.

Internal Name:

debug.persist-console

Data Specification:

<boolean: 0 or 1>

Default Value:

0

External Consoles

A list of the xterm-compatible X windows 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.

Internal Name:

debug.x-terminal

Data Specification:

[tuple of: <type str>]

Default Value:

('xterm', 'konsole', 'gnome-terminal', 'rxvt')

Debug I/O Encoding

Encoding of debug i/o panel

Internal Name:

debug.debug-io-encoding

Data Specification:

[None or [None, 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, Unicode (UTF-16, big endian) utf-16-be, Japanese shift-jis-2004, Console default (UTF-8), Japanese iso-2022-jp-3, Hebrew cp862, Western European latin-1, Japanese euc-jisx0213, US, Canada, and Others cp037, Japanese euc-jis-2004, Japanese shift-jisx0213, Central and Eastern European cp1250, Baltic Languages iso8859-4, English ascii, Japanese shift-jis, 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

Debug Shell Encoding

Encoding of debug probe panel and interactive shell

Internal Name:

debug.debug-probe-encoding

Data Specification:

[None or [None, 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, 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

Huge List Threshold

Defines the length threshold over which a list, map, 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 network-timeout preference)

Internal Name:

debug.huge-list-threshold

Data Specification:

<type int>

Default Value:

2000

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 network-timeout preference).

Internal Name:

debug.huge-string-threshold

Data Specification:

<type int>

Default Value:

64000

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')

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:

()

Do Not Expand

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.

Internal Name:

debug.no-probe-types

Data Specification:

[tuple of: <type str>]

Default Value:

('GdkColormap', 'IOBTree')

Enable Passive Listen

Controls whether or not the debugger listens passively for connections from an externally launched program (false to disable; true to enable). This should be on when the debug program is not launched by the IDE (e.g., as with a CGI script).

Internal Name:

debug.passive-listen

Data Specification:

<boolean: 0 or 1>

Default Value:

0

Allowed Hosts

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

Internal Name:

debug.passive-hosts

Data Specification:

[tuple of: <type str>]

Default Value:

('127.0.0.1',)

Server Host

Determines the network interface on which the debugger listens for connections. This can be a symbolic name, an ip address, or left unspecified (use None) 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

Server 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

Location Map

Defines a mapping between the remote and local locations of files for host-to-host debugging. Each mapping key is the ip address of the remote location and the mapping values are arrays of tuples where each tuple is a (remote_prefix, local_prefix) pair. This should be used when files on the remote host are updated via ftp, NFS, Samba, or other method from master copies on the local host, but the full path file system locations on the local and remote hosts do not match.

Internal Name:

debug.location-map

Data Specification:

[dict; keys: <type str>, values: [None or [list of: [tuple length 2 of: <type str>, <type str>]]]]

Default Value:

{'127.0.0.1': None}

Kill Externally Launched

Enable or disable the Kill command for debug processes that were launched from outside of the IDE

Internal Name:

debug.enable-kill-external

Data Specification:

<boolean: 0 or 1>

Default Value:

0

Common Attach Hosts

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),)

Network Timeout

Controls the amount of time that the debug client will wait for the debug server to respond before it gives up. This protects the IDE from freezing up if your program running within the debug server crashes (or if the server itself 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 huge-string-threshold preferences).

Internal Name:

debug.network-timeout

Data Specification:

<type float>, <type int>

Default Value:

10

Allow dynamic introspection

Set to allow python code and other dynamic calls to be invoked while introspecting values in the debugger.

Internal Name:

debug.allow-dynamic-introspection

Data Specification:

<boolean: 0 or 1>

Default Value:

False

Show 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

Use sys.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 erb!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 Internals Log File

This is used to obtain verbose information about debugger internals in cases where you are having problems getting debugging working. When set to non-None value, debugger activity is logged to the given file name. Alternatively, "<stdout>" or "<stderr>" can be used.

Internal Name:

debug.logfile

Data Specification:

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

Default Value:

None

Extremely Verbose Internal 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:

None

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

Source Analysis

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

Introspect in Shells

Set to turn on value introspection in the Python Shell and Debug Probe, so that autocompletion and Source Assistant information can be shown.

Internal Name:

debug.introspect-in-shells

Data Specification:

<boolean: 0 or 1>

Default Value:

1

Max Cache Size (MB)

The maximum size of the disk cache in megabytes

Internal Name:

pysource.max-disk-cache-size

Data Specification:

[from 1 to 1000]

Default Value:

50

Max Memory 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 1 to 100]

Default Value:

40

Typing Suspend Timeout

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

Internal Name:

edit.suspend-analysis-timeout

Data Specification:

<type float>, <type int>

Default Value:

3

Interface File 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',)

Scrape Extension Modules

Set this to False to disable automatic loading of 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:

True

Scraping Helper Snippets

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 some cases such as PyGTK and wxPython because 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:

{'QtSql': 'from PyQt4 import QtSql', 'QtGui': 'from PyQt4 import QtGui', 'QtAssistant': 'from PyQt4 import QtAssistant', '_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', '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', 'QtSvg': 'from PyQt4 import QtSvg', 'QtTest': 'from PyQt4 import QtTest', 'wxpython': 'pass', 'QtOpenGL': 'from PyQt4 import QtOpenGL', 'QtDesigner': 'from PyQt4 import QtDesigner', 'QtXml': 'from PyQt4 import QtXml', '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', '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', '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', 'QtCore': 'from PyQt4 import QtCore', 'QtNetwork': 'from PyQt4 import QtNetwork'}

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

IDE Extension Scripting

Search Path

Specifies the directories in which Wing will look for user-defined scripts that extend the functionality of the IDE itself. 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']

Auto-Reload Scripts on Save

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

Internal Preferences

main.debug-break-on-critical

<boolean: 0 or 1>

False

main.documentation-language

[None, de, en, fr]

en

main.extra-mime-type-comments

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

{}

main.extra-mime-type-names

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

{}

main.ignored-updates

[list of: <type str>]

[]

gui.apple-keyboard

[query-x11, yes, no]

query-x11

gui.feedback-email

<type str>

""

gui.fix-osx-tiger-keyboard-conflict

<boolean: 0 or 1>

True

gui.osx-key-for-alt

[default, command, option2, option]

default

gui.include-file-types

[tuple of: <type str>]

('*.*',)

gui.last-feedback-shown

<type float>

0.0

gui.omit-file-types

[tuple of: <type str>]

('*.o', '*.a', '*.so', '*.pyc', '*.pyo', 'core', '*~', '#*#', 'CVS', '.#*')

gui.prefered-symbol-order

[file-order, alpha-order]

alpha-order

gui.reported-exceptions

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

{}

gui.scan-for-pythoncom-shell-extensions

<boolean: 0 or 1>

True

gui.set-win32-foreground-lock-timeout

<boolean: 0 or 1>

1

gui.show-feedback-dialog

<boolean: 0 or 1>

1

gui.show-osx-keyboard-warning

<boolean: 0 or 1>

1

gui.startup-show-wingtips

<boolean: 0 or 1>

1

consoles.auto-clear

<boolean: 0 or 1>

False

edit.autocomplete-autoshow

<boolean: 0 or 1>

1

edit.fold-mime-types

[list of: <type str>]

['text/x-python', 'text/x-c-source', 'text/x-cpp-source', 'text/x-java-source', 'text/x-javascript', 'text/html', 'text/xml', 'text/x-zope-pt', 'text/x-eiffel', 'text/x-lisp', 'text/x-ruby']

consoles.wrap-long-lines

<boolean: 0 or 1>

False

consoles.python-prompt-after-execution

<boolean: 0 or 1>

False

edit.show-line-numbers

<boolean: 0 or 1>

0

edit.symbol-find-alpha-sort

<boolean: 0 or 1>

True

edit.symbol-find-include-args

<boolean: 0 or 1>

False

edit.use-default-foreground-when-printing

<boolean: 0 or 1>

False

proj.follow-selection

<boolean: 0 or 1>

0

debug.auto-clear-debug-io

<boolean: 0 or 1>

1

debug.default-python-exec

[None or <type str>]

None

debug.python-exec

[None or <type str>]

None

debug.safe-size-checks-only

<boolean: 0 or 1>

1

debug.shell-auto-restart-before-eval

<boolean: 0 or 1>

1

debug.shell-eval-whole-lines

<boolean: 0 or 1>

1

debug.shell-pasted-line-threshold

<type int>

10

debug.show-exceptions-tip

<boolean: 0 or 1>

1

debug.stop-timeout

<type int>, <type float>

3.0

debug.use-members-attrib

<boolean: 0 or 1>

1

debug.wrap-debug-io

<boolean: 0 or 1>

0

debug.wrap-debug-probe

<boolean: 0 or 1>

0

debug.wrap-python-shell

<boolean: 0 or 1>

0

pysource.instance-attrib-scan-mode

[init-only, all-methods]

all-methods

browser.follow-selection

<boolean: 0 or 1>

0