Preferences Reference

Look

User Interface Look

The overall look of Wing's user interface. Modern has flat controls, a single UI font on all OSes and more room around rows and tabs. Classic is the look of earlier Wing versions. Emulate uses the OS's own style and colors for the user interface, with the Modern look's toolbar, status bar and breadcrumbs.

Preferences Dialog Path: Appearance > Look > User Interface Look

Classic Look Dialog Path: User Interface > User Interface Look

Internal Name: gui.ui-look

Data Specification: [modern, classic, native]

Default Value: modern

Display Mode

Display Mode

Selects which display theme Wing uses: the light or dark one, or the one matching the OS's light or dark setting.

Preferences Dialog Path: Appearance > Display Mode

Classic Look Dialog Path: User Interface > Display Mode

Internal Name: gui.display-mode

Data Specification: [follow-os, light, dark]

Default Value: follow-os

Dark Theme

Dark Theme

The display theme for Wing's user interface when in dark background mode. All color preferences default to using colors from the theme, but can be overridden individually. Additional themes can be made from a few colors with New Theme from Colors, imported from VS Code color themes with Import VS Code Theme, or defined and added to the 'palettes' sub-directory of the User Settings directory.

Preferences Dialog Path: Appearance > Dark Theme

Classic Look Dialog Path: User Interface > Dark Theme

Internal Name: gui.dark-display-theme

Data Specification: [None or <type str>]

Default Value: one-dark

Dark Editor

The dark display theme for Wing's editor, either the same as the Dark Theme or a selected theme.

Preferences Dialog Path: Appearance > Dark Theme > Dark Editor

Classic Look Dialog Path: User Interface > Dark Editor

Internal Name: gui.dark-editor-theme

Data Specification: [None or <type str>]

Default Value: None

Dark Console

The dark display theme for OS Commands consoles, either the same as the Dark Editor or a selected theme.

Preferences Dialog Path: Appearance > Dark Theme > Dark Console

Classic Look Dialog Path: User Interface > Dark Console

Internal Name: gui.dark-console-theme

Data Specification: [None or <type str>]

Default Value: None

Light Theme

Light Theme

The display theme for Wing's user interface when in light background mode. All color preferences default to using colors from the theme, but can be overridden individually. Additional themes can be made from a few colors with New Theme from Colors, imported from VS Code color themes with Import VS Code Theme, or defined and added to the 'palettes' sub-directory of the User Settings directory.

Preferences Dialog Path: Appearance > Light Theme

Classic Look Dialog Path: User Interface > Light Theme

Internal Name: gui.light-display-theme

Data Specification: [None or <type str>]

Default Value: wing-classic

Light Editor

The light display theme for Wing's editor, either the same as the Light Theme or a selected theme.

Preferences Dialog Path: Appearance > Light Theme > Light Editor

Classic Look Dialog Path: User Interface > Light Editor

Internal Name: gui.light-editor-theme

Data Specification: [None or <type str>]

Default Value: None

Light Console

The light display theme for OS Commands consoles, either the same as the Light Editor or a selected theme.

Preferences Dialog Path: Appearance > Light Theme > Light Console

Classic Look Dialog Path: User Interface > Light Console

Internal Name: gui.light-console-theme

Data Specification: [None or <type str>]

Default Value: None

Text

UI Font

The user interface font: Wing Default, the Inter font that Wing bundles so text looks the same on every OS, System Default, the OS's own user interface font, or any installed font. The Classic look uses the OS's font in place of Inter.

Preferences Dialog Path: Appearance > Text > UI Font

Classic Look Dialog Path: User Interface > Fonts > UI Font

Internal Name: gui.ui-font-source

Data Specification: <type str>

Default Value: bundled

UI Font Size

The size in points of the user interface font, or the default size for the look and its density

Preferences Dialog Path: Appearance > Text > UI Font Size

Classic Look Dialog Path: User Interface > Fonts > UI Font Size

Internal Name: gui.ui-font-size

Data Specification: [None or <type int>]

Default Value: None

Editor Font/Size

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

Preferences Dialog Path: Appearance > Text > Editor Font/Size

Classic Look Dialog Path: User Interface > Fonts > Editor Font/Size

Internal Name: edit.qt-display-font

Data Specification: [None or <type str>]

Default Value: None

Spacing and Scaling

Density

How much room the Modern look leaves in rows, tabs, toolbars and controls. Compact matches the density of the Classic look.

Preferences Dialog Path: Appearance > Spacing and Scaling > Density

Classic Look Dialog Path: User Interface > Density

Internal Name: gui.ui-density

Data Specification: [comfortable, compact]

Default Value: comfortable

Presentation Mode

Controls whether Wing runs in presentation mode, which magnifies the user interface. Wing must be restarted before this value takes effect.

Preferences Dialog Path: Appearance > Spacing and Scaling > Presentation Mode

Classic Look Dialog Path: User Interface > Layout > Presentation Mode

Internal Name: main.presentation-mode

Data Specification: <boolean: 0 or 1>

Default Value: False

Presentation Mode Scale Factor

The amount by which to increase UI size when presentation mode is enabled. Wing must be restarted before this value takes effect.

Preferences Dialog Path: Appearance > Spacing and Scaling > Presentation Mode Scale Factor

Classic Look Dialog Path: User Interface > Layout > Presentation Mode Scale Factor

Internal Name: main.presentation-scale-factor

Data Specification: <type float>

Default Value: 2.0

Editor Line Spacing

Amount of extra spacing to allocate around lines in the editor.

Preferences Dialog Path: Appearance > Spacing and Scaling > Editor Line Spacing

Classic Look Dialog Path: User Interface > Fonts > Editor Line Spacing

Internal Name: edit.line-spacing

Data Specification: <type int>

Default Value: 0

Colors

Icons

The icons used in the Modern look: Wing's Classic icons, tinted with the display theme's icon colors, or single-color line icons. The Classic look always uses the Classic icons.

Preferences Dialog Path: Appearance > Colors > Icons

Classic Look Dialog Path: User Interface > Icons

Internal Name: gui.ui-icon-set

Data Specification: [classic, modern]

Default Value: classic

Primary Icon Color

Primary color for icons

Preferences Dialog Path: Appearance > Colors > Primary Icon Color

Classic Look Dialog Path: User Interface > Toolbar > Primary Icon Color

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

Secondary Icon Color

Secondary color for icons

Preferences Dialog Path: Appearance > Colors > Secondary Icon Color

Classic Look Dialog Path: User Interface > Toolbar > Secondary Icon Color

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

Tertiary Icon Color

Tertiary color for icons

Preferences Dialog Path: Appearance > Colors > Tertiary Icon Color

Classic Look Dialog Path: User Interface > Toolbar > Tertiary Icon Color

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

Quaternary Icon Color

Quaternary color for icons

Preferences Dialog Path: Appearance > Colors > Quaternary Icon Color

Classic Look Dialog Path: User Interface > Toolbar > Quaternary Icon Color

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

Quinary Icon Color

Quinary color for icons

Preferences Dialog Path: Appearance > Colors > Quinary Icon Color

Classic Look Dialog Path: User Interface > Toolbar > Quinary Icon Color

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

Senary Icon Color

Senary color for icons

Preferences Dialog Path: Appearance > Colors > Senary Icon Color

Classic Look Dialog Path: User Interface > Toolbar > Senary Icon Color

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

Other

Display Language

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

Preferences Dialog Path: Appearance > Other > Display Language

Classic Look Dialog Path: User Interface > Display Language

Internal Name: main.display-language

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

Default Value: None

Enable Tooltips

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

Preferences Dialog Path: Appearance > Other > Enable Tooltips

Classic Look Dialog Path: User Interface > Enable Tooltips

Internal Name: gui.enable-tooltips

Data Specification: <boolean: 0 or 1>

Default Value: 1

Tooltip Delay

The time in seconds to wait after the mouse cursor stops moving before any tooltips are displayed.

Preferences Dialog Path: Appearance > Other > Tooltip Delay

Classic Look Dialog Path: User Interface > Tooltip Delay

Internal Name: gui.tooltips-delay

Data Specification: <type int>

Default Value: 0.5

Always Use 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.

Preferences Dialog Path: Appearance > Other > Always Use Full Path in Tooltips

Classic Look Dialog Path: User Interface > Other > Always Use Full Path in Tooltips

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

Data Specification: <boolean: 0 or 1>

Default Value: True

Toolbar

Show Toolbar

Whether toolbar is shown in any window.

Preferences Dialog Path: Layout > Toolbar > Show Toolbar

Classic Look Dialog Path: User Interface > Toolbar > Show Toolbar

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.

Preferences Dialog Path: Layout > Toolbar > Toolbar Size

Classic Look Dialog Path: User Interface > Toolbar > Toolbar Size

Internal Name: gui.toolbar-icon-size

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

Default Value: auto

Toolbar Style

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

Preferences Dialog Path: Layout > Toolbar > Toolbar Style

Classic Look Dialog Path: User Interface > Toolbar > Toolbar Style

Internal Name: gui.toolbar-icon-style

Data Specification: [auto, icon-only, text-only, text-below, text-right, default]

Default Value: auto

Search Field Searches

What the search field in the toolbar of the Modern and Emulate user interface looks searches. When it searches the current file, the toolbar's Search Current File tool is hidden in those looks.

Preferences Dialog Path: Layout > Toolbar > Search Field Searches

Classic Look Dialog Path: User Interface > Toolbar > Search Field Searches

Internal Name: guimgr.command-field-sources

Data Specification: [list of: [current-file, files, commands, tools, preferences, documentation]]

Default Value: ['current-file', 'files', 'commands', 'tools', 'preferences', 'documentation']

Groups Shown

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

Preferences Dialog Path: Layout > Toolbar > Groups Shown

Classic Look Dialog Path: User Interface > Toolbar > Groups Shown

Internal Name: guimgr.toolbar-groups

Data Specification: [list of: [file, clip, select, search, batch-search, command-field, diff, bookmark, indent, test, vcs, vcs-status, proj, debug]]

Default Value: ['file', 'clip', 'select', 'search', 'command-field', 'diff', 'indent', 'proj', 'debug', 'vcs-status']

Custom Items

Extra items to add to the tool bar.

Preferences Dialog Path: Layout > Toolbar > Custom Items

Classic Look Dialog Path: User Interface > Toolbar > Custom Items

Internal Name: guimgr.toolbar-custom-items

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

Default Value: ()

Perspectives

Auto-save Perspectives

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.

Preferences Dialog Path: Layout > Perspectives > Auto-save Perspectives

Classic Look Dialog Path: User Interface > Perspectives > Auto-save Perspectives

Internal Name: main.perspective-auto-save

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

Default Value: always

Shared Perspective 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.

Preferences Dialog Path: Layout > Perspectives > Shared Perspective File

Classic Look Dialog Path: User Interface > Perspectives > Shared Perspective File

Internal Name: main.perspective-shared-file

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

Default Value: None

Console Keys

Send Keys Directly to Console Tools

Send keys directly to console tools instead of processing them through the key binding system. When disabled, key bindings are applied as in other tools. Individual OS Commands and file/project/launch configurations can override this setting.

Preferences Dialog Path: Keyboard > Console Keys > Send Keys Directly to Console Tools

Classic Look Dialog Path: User Interface > Console Keys > Send Keys Directly to Console Tools

Internal Name: gui.console-send-keys-directly

Data Specification: <boolean: 0 or 1>

Default Value: True

Use Shift-Ctrl for Ctrl Bindings

Look up key bindings that include Ctrl+Shift+ when a console tool has keyboard focus. If no binding is found, the Shift modifier is removed and the lookup is retried. For example, Ctrl+Shift+C finds the copy command (normally bound to Ctrl+C).

Preferences Dialog Path: Keyboard > Console Keys > Use Shift-Ctrl for Ctrl Bindings

Classic Look Dialog Path: User Interface > Console Keys > Use Shift-Ctrl for Ctrl Bindings

Internal Name: gui.console-lookup-shift-ctrl

Data Specification: <boolean: 0 or 1>

Default Value: True

Shift-Esc Leaves Console

Use Shift+Escape to leave a console tool and return focus to an editor.

Preferences Dialog Path: Keyboard > Console Keys > Shift-Esc Leaves Console

Classic Look Dialog Path: User Interface > Console Keys > Shift-Esc Leaves Console

Internal Name: gui.console-shift-esc-leaves

Data Specification: <boolean: 0 or 1>

Default Value: True

IDE Uses Command Key Bindings

Look up IDE key bindings that include Command+ when a console tool has keyboard focus, instead of sending them to the running process. Applies only on macOS.

Preferences Dialog Path: Keyboard > Console Keys > IDE Uses Command Key Bindings

Classic Look Dialog Path: User Interface > Console Keys > IDE Uses Command Key Bindings

Internal Name: gui.console-lookup-command-key

Data Specification: <boolean: 0 or 1>

Default Value: True

IDE Uses F Key Bindings

Look up IDE key bindings for function keys (F1, F2, ...) when a console tool has keyboard focus, instead of sending them to the running process.

Preferences Dialog Path: Keyboard > Console Keys > IDE Uses F Key Bindings

Classic Look Dialog Path: User Interface > Console Keys > IDE Uses F Key Bindings

Internal Name: gui.console-use-function-keys

Data Specification: <boolean: 0 or 1>

Default Value: True

Console Key Bindings

Key bindings that override sending keys to the console tool, to invoke IDE functionality instead. For example, bind Ctrl+F to a search command to open the Search tool even while a console tool has focus.

Preferences Dialog Path: Keyboard > Console Keys > Console Key Bindings

Classic Look Dialog Path: User Interface > Console Keys > Console Key Bindings

Internal Name: gui.console-keymap-override

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

Default Value: {}

Suppress Console Keys Warning

When set, the console key bindings warning dialog is not shown when a console tool is started.

Preferences Dialog Path: Keyboard > Console Keys > Suppress Console Keys Warning

Classic Look Dialog Path: User Interface > Console Keys > Suppress Console Keys Warning

Internal Name: gui.console-keys-hint-suppressed

Data Specification: <boolean: 0 or 1>

Default Value: False

Advanced

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

Preferences Dialog Path: Keyboard > Advanced > Custom Key Bindings

Classic Look Dialog Path: User Interface > Keyboard > Custom Key Bindings

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.

Preferences Dialog Path: Keyboard > Advanced > Typing Group Timeout

Classic Look Dialog Path: User Interface > Keyboard > Typing Group Timeout

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-rectangle, or use the default by system (clipboard on win32 and other commands elsewhere).

Preferences Dialog Path: Keyboard > Advanced > VI Mode Ctrl-C/X/V

Classic Look Dialog Path: User Interface > Keyboard > VI Mode Ctrl-C/X/V

Internal Name: vi-mode.clipboard-bindings

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

Default Value: system-default

Key Map File

Defines location of the keymap override file. Use None for default according to configured editor personality. See the Wing 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.

Preferences Dialog Path: Keyboard > Advanced > Key Map File

Classic Look Dialog Path: User Interface > Advanced > Key Map File

Internal Name: gui.keymap

Data Specification: [None or <type str>]

Default Value: None

Selection/Caret

Selection Color

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

Preferences Dialog Path: Editor > Selection/Caret > Selection Color

Classic Look Dialog Path: Editor > Selection/Caret > Selection Color

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

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Caret Color

Selects the color to use for the editor caret.

Preferences Dialog Path: Editor > Selection/Caret > Caret Color

Classic Look Dialog Path: Editor > Selection/Caret > Caret Color

Internal Name: edit.caret-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each 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.

Preferences Dialog Path: Editor > Selection/Caret > Caret Width

Classic Look Dialog Path: Editor > Selection/Caret > Caret Width

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

Preferences Dialog Path: Editor > Selection/Caret > Caret Flash Rate (ms)

Classic Look Dialog Path: Editor > Selection/Caret > Caret Flash Rate (ms)

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 (to control transparency) can be set.

Preferences Dialog Path: Editor > Selection/Caret > Caret Line Highlight

Classic Look Dialog Path: Editor > Selection/Caret > Caret Line Highlight

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

Scrolling Context Lines

The number of lines of context to show above or below the caret when auto-scrolling the editor to a new position

Preferences Dialog Path: Editor > Selection/Caret > Scrolling Context Lines

Classic Look Dialog Path: Editor > Selection/Caret > Scrolling Context Lines

Internal Name: edit.scroll-context-lines

Data Specification: <type int>

Default Value: 5

Display Selections Popup

When to display multiple selections popup window

Preferences Dialog Path: Editor > Selection/Caret > Display Selections Popup

Classic Look Dialog Path: Editor > Selection/Caret > Display Selections Popup

Internal Name: edit.display-selection-popup

Data Specification: [always, multiple, never]

Default Value: multiple

Clipboard

On Empty Selection

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

Preferences Dialog Path: Editor > Clipboard > On Empty Selection

Classic Look Dialog Path: Editor > Clipboard > On Empty Selection

Internal Name: edit.smart-clipboard

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

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.

Preferences Dialog Path: Editor > Clipboard > Middle Mouse Paste

Classic Look Dialog Path: Editor > Clipboard > Middle Mouse Paste

Internal Name: edit.middle-mouse-paste

Data Specification: <boolean: 0 or 1>

Default Value: True

Convert Indent Style On Paste

Controls whether Wing automatically converts indent style and size on text that is pasted into an editor.

Preferences Dialog Path: Editor > Clipboard > Convert Indent Style On Paste

Classic Look Dialog Path: Editor > Clipboard > Convert Indent Style On Paste

Internal Name: edit.convert-indents-on-paste

Data Specification: <boolean: 0 or 1>

Default Value: True

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.

Preferences Dialog Path: Editor > Clipboard > Adjust Indent After Paste

Classic Look Dialog Path: Editor > Clipboard > Adjust Indent After Paste

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

Data Specification: <boolean: 0 or 1>

Default Value: True

Folding

Enable Folding

Whether to enable folding source code.

Preferences Dialog Path: Editor > Folding > Enable Folding

Classic Look Dialog Path: Editor > Folding > Enable Folding

Internal Name: edit.enable-folding

Data Specification: <boolean: 0 or 1>

Default Value: 1

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.

Preferences Dialog Path: Editor > Folding > Line Mode

Classic Look Dialog Path: Editor > Folding > Line Mode

Internal Name: edit.fold-line-mode

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

Default Value: below-collapsed

Indicator Style

Selects the type of indicators to draw at fold points.

Preferences Dialog Path: Editor > Folding > Indicator Style

Classic Look Dialog Path: Editor > Folding > Indicator Style

Internal Name: edit.fold-indicator-style

Data Specification: [from 0 to 3]

Default Value: 1

Fold Trailing White Space

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.

Preferences Dialog Path: Editor > Folding > Fold Trailing White Space

Classic Look Dialog Path: Editor > Folding > Fold Trailing White Space

Internal Name: edit.fold-trailing-whitespace

Data Specification: <boolean: 0 or 1>

Default Value: 1

Foreground Color

Color to use for the foreground of the fold indicators.

Preferences Dialog Path: Editor > Folding > Foreground Color

Classic Look Dialog Path: Editor > Folding > Foreground Color

Internal Name: edit.fold-mark-foreground-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Background Color

Color to use for the background of the fold indicators.

Preferences Dialog Path: Editor > Folding > Background Color

Classic Look Dialog Path: Editor > Folding > Background Color

Internal Name: edit.fold-mark-background-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Diff/Merge

Orientation

Orientation of difference/merge views: Side-by-side or top/bottom

Preferences Dialog Path: Editor > Diff/Merge > Orientation

Classic Look Dialog Path: Editor > Diff/Merge > Orientation

Internal Name: diff.orientation

Data Specification: [horizontal, vertical]

Default Value: horizontal

Lock Scrolling

Controls whether scrolling of the diff/merge editors is locked to synchronize the editor scroll positions.

Preferences Dialog Path: Editor > Diff/Merge > Lock Scrolling

Classic Look Dialog Path: Editor > Diff/Merge > Lock Scrolling

Internal Name: diff.scroll-lock

Data Specification: <boolean: 0 or 1>

Default Value: True

Ignore White Space

Controls whether differences will ignore changes that alter white space only.

Preferences Dialog Path: Editor > Diff/Merge > Ignore White Space

Classic Look Dialog Path: Editor > Diff/Merge > Ignore White Space

Internal Name: diff.ignore-whitespace

Data Specification: <boolean: 0 or 1>

Default Value: False

Empty Session Warning

Controls whether to warn when changing white space filtering causes sessions to become empty of changes.

Preferences Dialog Path: Editor > Diff/Merge > Empty Session Warning

Classic Look Dialog Path: Editor > Diff/Merge > Empty Session Warning

Internal Name: diff.empty-session-warning

Data Specification: <boolean: 0 or 1>

Default Value: True

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.

Preferences Dialog Path: Editor > Diff/Merge > Diff Color

Classic Look Dialog Path: Editor > Diff/Merge > Diff Color

Internal Name: edit.qt-diff-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

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.

Preferences Dialog Path: Editor > Diff/Merge > Merged Diff Color

Classic Look Dialog Path: Editor > Diff/Merge > Merged Diff Color

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

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Context Menu

Groups Shown

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

Preferences Dialog Path: Editor > Context Menu > Groups Shown

Classic Look Dialog Path: Editor > Context Menu > Groups Shown

Internal Name: edit.context-menu-groups

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

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

Custom Items

Extra menu items to add to the editor context menu.

Preferences Dialog Path: Editor > Context Menu > Custom Items

Classic Look Dialog Path: Editor > Context Menu > Custom Items

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

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

Default Value: ()

Advanced

Maximum 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

Preferences Dialog Path: Editor > Advanced > Maximum Non-Sticky Editors

Classic Look Dialog Path: Editor > Advanced > Maximum Non-Sticky Editors

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

Data Specification: <type int>

Default Value: 5

Use Custom Mouse Cursor

When to use a custom mouse cursor. The color of the cursor will be the color of the caret.

Preferences Dialog Path: Editor > Advanced > Use Custom Mouse Cursor

Classic Look Dialog Path: Editor > Advanced > Use Custom Mouse Cursor

Internal Name: edit.use-custom-mouse-cursor

Data Specification: [on-dark-backgrounds, never, always]

Default Value: on-dark-backgrounds

Mini-search Case Sensitivity

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.

Preferences Dialog Path: Editor > Advanced > Mini-search Case Sensitivity

Classic Look Dialog Path: Editor > Advanced > Mini-search Case Sensitivity

Internal Name: edit.minisearch-case-sensitive

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

Default Value: match-mode

Symbol Menu Max Length

The maximum number of names allowed on a single symbol menu

Preferences Dialog Path: Editor > Advanced > Symbol Menu Max Length

Classic Look Dialog Path: Editor > Advanced > Symbol Menu Max Length

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

Data Specification: <type int>

Default Value: 200

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

Preferences Dialog Path: Editor > Advanced > Selection Policy

Classic Look Dialog Path: Editor > Advanced > Selection Policy

Internal Name: edit.select-policy

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

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

Indentation

Use Indent Analysis

Select when to use indent analysis (examination of current file contents) in order to determine indentation type and size. Either always in all files, only in Python files, or never. When disabled, the Preferred Indent Style from Project Properties and Default Indent Size and Default Tab Size from preferences will be used.

Preferences Dialog Path: Indentation & Wrapping > Indentation > Use Indent Analysis

Classic Look Dialog Path: Editor > Indentation > Use Indent Analysis

Internal Name: edit.use-indent-analysis

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

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.

Preferences Dialog Path: Indentation & Wrapping > Indentation > Default Tab Size

Classic Look Dialog Path: Editor > Indentation > Default Tab Size

Internal Name: edit.tab-size

Data Specification: [from 1 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.

Preferences Dialog Path: Indentation & Wrapping > Indentation > Default Indent Size

Classic Look Dialog Path: Editor > Indentation > Default Indent Size

Internal Name: edit.indent-size

Data Specification: [from 1 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.

Preferences Dialog Path: Indentation & Wrapping > Indentation > Default Indent Style

Classic Look Dialog Path: Editor > Indentation > Default Indent Style

Internal Name: edit.indent-style

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

Default Value: spaces-only

Show Indent Guides

Set to true to show indent guides by default

Preferences Dialog Path: Indentation & Wrapping > Indentation > Show Indent Guides

Classic Look Dialog Path: Editor > Indentation > Show Indent Guides

Internal Name: edit.show-indent-guides

Data Specification: <boolean: 0 or 1>

Default Value: 0

Indent Guide Color

Color to use for the indent guides in the editor.

Preferences Dialog Path: Indentation & Wrapping > Indentation > Indent Guide Color

Classic Look Dialog Path: Editor > Indentation > Indent Guide Color

Internal Name: edit.indent-guide-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

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

Preferences Dialog Path: Indentation & Wrapping > Indentation > Show Python Indent Warning Dialog

Classic Look Dialog Path: Editor > Indentation > Show Python Indent Warning Dialog

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.

Preferences Dialog Path: Indentation & Wrapping > Indentation > Show Override Warning Dialog

Classic Look Dialog Path: Editor > Indentation > Show Override Warning Dialog

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

Data Specification: <boolean: 0 or 1>

Default Value: True

Line Wrapping

Wrap Long Lines

Enable to wrap long source lines on the editor display.

Preferences Dialog Path: Indentation & Wrapping > Line Wrapping > Wrap Long Lines

Classic Look Dialog Path: Editor > Line Wrapping > Wrap Long Lines

Internal Name: edit.wrap-lines

Data Specification: <boolean: 0 or 1>

Default Value: 0

Edge Markers

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

Preferences Dialog Path: Indentation & Wrapping > Line Wrapping > Edge Markers

Classic Look Dialog Path: Editor > Line Wrapping > Edge Markers

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: (0, 80, None)

Syntax Coloring

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.

Preferences Dialog Path: Editor Colors > Syntax Coloring > Syntax Formatting

Classic Look Dialog Path: Editor > Syntax Coloring > Syntax Formatting

Internal Name: edit.syntax-formatting

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

Default Value: {}

Highlight Builtins

Highlight Python builtins

Preferences Dialog Path: Editor Colors > Syntax Coloring > Highlight Builtins

Classic Look Dialog Path: Editor > Syntax Coloring > Highlight Builtins

Internal Name: edit.highlight-builtins

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

Preferences Dialog Path: Editor Colors > Occurrences > Highlight Occurrences

Classic Look Dialog Path: Editor > Occurrences > Highlight Occurrences

Internal Name: edit.highlight-occurrences

Data Specification: [always, words, never]

Default Value: words

Match Case

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

Preferences Dialog Path: Editor Colors > Occurrences > Match Case

Classic Look Dialog Path: Editor > Occurrences > Match Case

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.

Preferences Dialog Path: Editor Colors > Occurrences > Occurrences Indicator Style

Classic Look Dialog Path: Editor > Occurrences > Occurrences Indicator Style

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.

Preferences Dialog Path: Editor Colors > Occurrences > Occurrences Color

Classic Look Dialog Path: Editor > Occurrences > Occurrences Color

Internal Name: edit.occurrence-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Brace Matching

Brace Highlighting

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

Preferences Dialog Path: Editor Colors > Brace Matching > Brace Highlighting

Classic Look Dialog Path: Editor > Brace Matching > Brace Highlighting

Internal Name: edit.auto-brace-match

Data Specification: <boolean: 0 or 1>

Default Value: 1

Brace Highlight Color

The color used to highlight matching braces.

Preferences Dialog Path: Editor Colors > Brace Matching > Brace Highlight Color

Classic Look Dialog Path: Editor > Brace Matching > Brace Highlight Color

Internal Name: edit.brace-highlight-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Brace Highlight Background Color

The background color used to highlight matching braces.

Preferences Dialog Path: Editor Colors > Brace Matching > Brace Highlight Background Color

Classic Look Dialog Path: Editor > Brace Matching > Brace Highlight Background Color

Internal Name: edit.brace-highlight-backcolor

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Brace Badlight Color

The color used to highlight bad braces.

Preferences Dialog Path: Editor Colors > Brace Matching > Brace Badlight Color

Classic Look Dialog Path: Editor > Brace Matching > Brace Badlight Color

Internal Name: edit.brace-badlight-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Brace Badlight Background Color

The background color used to highlight bad braces.

Preferences Dialog Path: Editor Colors > Brace Matching > Brace Badlight Background Color

Classic Look Dialog Path: Editor > Brace Matching > Brace Badlight Background Color

Internal Name: edit.brace-badlight-backcolor

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Callouts

Enable Callouts

Whether to enable display of callouts that are briefly displayed to indicate textvisited in the editor by search, goto-definition, and other navigation features.

Preferences Dialog Path: Editor Colors > Callouts > Enable Callouts

Classic Look Dialog Path: Editor > Callouts > Enable Callouts

Internal Name: edit.callout-enable

Data Specification: <boolean: 0 or 1>

Default Value: True

Callout Color

The color used for callouts on the editor.

Preferences Dialog Path: Editor Colors > Callouts > Callout Color

Classic Look Dialog Path: Editor > Callouts > Callout Color

Internal Name: edit.callout-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Persistence Time (ms)

The time in milliseconds that callouts persist after display on the editor.

Preferences Dialog Path: Editor Colors > Callouts > Persistence Time (ms)

Classic Look Dialog Path: Editor > Callouts > Persistence Time (ms)

Internal Name: edit.callout-persistence

Data Specification: <type int>

Default Value: 500

Code Warnings

Enable Code Warnings

Whether to enable the code warnings system as a whole. When this is disabled, no code warnings are displayed and external code warnings systems will not be launched even if enabled.

Preferences Dialog Path: Editor Colors > Code Warnings > Enable Code Warnings

Classic Look Dialog Path: Editor > Code Warnings > Enable Code Warnings

Internal Name: codewarnings.enable

Data Specification: <boolean: 0 or 1>

Default Value: True

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.

Preferences Dialog Path: Editor Colors > Code Warnings > Indicators

Classic Look Dialog Path: Editor > Code Warnings > Indicators

Internal Name: edit.error-display

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

Default Value: show-all

Indicator Style

Visual display style to use for code errors and warnings shown on the editor.

Preferences Dialog Path: Editor Colors > Code Warnings > Indicator Style

Classic Look Dialog Path: Editor > Code Warnings > Indicator Style

Internal Name: edit.indicator-style

Data Specification: [underline, thick-underline, squiggle, plain-box, filled-box]

Default Value: squiggle

Error Color

Color to use to indicate code errors in the editor.

Preferences Dialog Path: Editor Colors > Code Warnings > Error Color

Classic Look Dialog Path: Editor > Code Warnings > Error Color

Internal Name: edit.code-error-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Warning Color

Color to use to indicate code warnings in the editor.

Preferences Dialog Path: Editor Colors > Code Warnings > Warning Color

Classic Look Dialog Path: Editor > Code Warnings > Warning Color

Internal Name: edit.code-warning-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Code Coverage

Set Visited Lines Background Color

Whether to highlight visited lines for code coverage using background color, in addition to the margin mark.

Preferences Dialog Path: Editor Colors > Code Coverage > Set Visited Lines Background Color

Classic Look Dialog Path: Editor > Code Coverage > Set Visited Lines Background Color

Internal Name: edit.coverage-visited-background

Data Specification: <boolean: 0 or 1>

Default Value: False

Visited Lines Color

Color to use to highlight lines of code that were visited during code coverage tests.

Preferences Dialog Path: Editor Colors > Code Coverage > Visited Lines Color

Classic Look Dialog Path: Editor > Code Coverage > Visited Lines Color

Internal Name: edit.coverage-visited-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Set Missed Lines Background Color

Whether to highlight missed lines for code coverage using background color, in addition to the margin mark.

Preferences Dialog Path: Editor Colors > Code Coverage > Set Missed Lines Background Color

Classic Look Dialog Path: Editor > Code Coverage > Set Missed Lines Background Color

Internal Name: edit.coverage-missed-background

Data Specification: <boolean: 0 or 1>

Default Value: False

Missed Lines Color

Color to use to highlight lines of code that were missed during code coverage tests.

Preferences Dialog Path: Editor Colors > Code Coverage > Missed Lines Color

Classic Look Dialog Path: Editor > Code Coverage > Missed Lines Color

Internal Name: edit.coverage-missed-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Show Editor Tooltips

Whether to show tool tips on the editor when code coverage annotations are present, in order to enumerate the unit tests that invoked the line of code under the mouse cursor.

Preferences Dialog Path: Editor Colors > Code Coverage > Show Editor Tooltips

Classic Look Dialog Path: Editor > Code Coverage > Show Editor Tooltips

Internal Name: edit.coverage-visited-tooltips

Data Specification: <boolean: 0 or 1>

Default Value: True

Bookmarks

Bookmark Color

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

Preferences Dialog Path: Editor Colors > Bookmarks > Bookmark Color

Classic Look Dialog Path: Editor > Bookmarks > Bookmark Color

Internal Name: edit.qt-bookmark-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Bookmark Style

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

Preferences Dialog Path: Editor Colors > Bookmarks > Bookmark Style

Classic Look Dialog Path: Editor > Bookmarks > Bookmark Style

Internal Name: edit.bookmark-style

Data Specification: [None, underline, background]

Default Value: background

Confirm Deletion

Show a confirmation dialog when deleting bookmarks

Preferences Dialog Path: Editor Colors > Bookmarks > Confirm Deletion

Classic Look Dialog Path: Editor > Bookmarks > Confirm Deletion

Internal Name: edit.bookmark-confirm-delete

Data Specification: <boolean: 0 or 1>

Default Value: True

Debugger

Run Marker Color

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

Preferences Dialog Path: Editor Colors > Debugger > Run Marker Color

Classic Look Dialog Path: Debugger > Run Marker Color

Internal Name: debug.debug-marker-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Active Range Color

The color of the active range of code used for quick evaluation in the Python Shell or Debug Console.

Preferences Dialog Path: Editor Colors > Debugger > Active Range Color

Classic Look Dialog Path: Debugger > Active Range Color

Internal Name: debug.active-range-color

Data Specification: [None or [(r, g, b) or (r, g, b, a) each from 0 to 255]]

Default Value: None

Typing

Auto-Editing 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.

Preferences Dialog Path: Auto-editing > Typing > Auto-Editing Enabled

Classic Look Dialog Path: Editor > Auto-editing > Auto-Editing Enabled

Internal Name: edit.auto-edit-enabled

Data Specification: <boolean: 0 or 1>

Default Value: 1

Auto-Close Characters

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

Preferences Dialog Path: Auto-editing > Typing > Auto-Close Characters

Classic Look Dialog Path: Editor > Auto-editing > Auto-Close Characters

Internal Name: edit.auto-edit-close

Data Specification: <boolean: 0 or 1>

Default Value: 1

Auto-Enter Invocation Args

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

Preferences Dialog Path: Auto-editing > Typing > Auto-Enter Invocation Args

Classic Look Dialog Path: Editor > Auto-editing > Auto-Enter Invocation Args

Internal Name: edit.auto-edit-invoke

Data Specification: <boolean: 0 or 1>

Default Value: 1

Auto-wrap Arguments

Enable auto-wrapping of arguments during auto-invocation.

Preferences Dialog Path: Auto-editing > Typing > Auto-wrap Arguments

Classic Look Dialog Path: Editor > Auto-editing > Auto-wrap Arguments

Internal Name: edit.auto-edit-invoke-wraps

Data Specification: <boolean: 0 or 1>

Default Value: 0

Invoke After Completion

Enable auto-invocation to occur automatically after a callable symbol is entered by the auto-completer.

Preferences Dialog Path: Auto-editing > Typing > Invoke After Completion

Classic Look Dialog Path: Editor > Auto-editing > Invoke After Completion

Internal Name: edit.auto-edit-invoke-after-complete

Data Specification: <boolean: 0 or 1>

Default Value: 0

Apply Quotes to Selection

Enable placing quotes around a non-empty selection.

Preferences Dialog Path: Auto-editing > Typing > Apply Quotes to Selection

Classic Look Dialog Path: Editor > Auto-editing > Apply Quotes to Selection

Internal Name: edit.auto-edit-quotes

Data Specification: <boolean: 0 or 1>

Default Value: 1

Mutate Adjacent Quotes

Enable changing quote style by pressing a quote key while the caret is next to an existing quote character.

Preferences Dialog Path: Auto-editing > Typing > Mutate Adjacent Quotes

Classic Look Dialog Path: Editor > Auto-editing > Mutate Adjacent Quotes

Internal Name: edit.auto-edit-mutate-quotes

Data Specification: <boolean: 0 or 1>

Default Value: 1

Apply Comment Key to Selection

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

Preferences Dialog Path: Auto-editing > Typing > Apply Comment Key to Selection

Classic Look Dialog Path: Editor > Auto-editing > Apply Comment Key to Selection

Internal Name: edit.auto-edit-comment

Data Specification: <boolean: 0 or 1>

Default Value: 1

Apply (), [], and {} to Selection

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

Preferences Dialog Path: Auto-editing > Typing > Apply (), [], and {} to Selection

Classic Look Dialog Path: Editor > Auto-editing > Apply (), [], and {} to Selection

Internal Name: edit.auto-edit-parens

Data Specification: <boolean: 0 or 1>

Default Value: 1

Apply Colon to Selection

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

Preferences Dialog Path: Auto-editing > Typing > Apply Colon to Selection

Classic Look Dialog Path: Editor > Auto-editing > Apply Colon to Selection

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

Data Specification: <boolean: 0 or 1>

Default Value: 1

Auto-Enter Spaces

Enable auto-entering spaces around operators and punctuation.

Preferences Dialog Path: Auto-editing > Typing > Auto-Enter Spaces

Classic Look Dialog Path: Editor > Auto-editing > Auto-Enter Spaces

Internal Name: edit.auto-edit-spaces

Data Specification: <boolean: 0 or 1>

Default Value: 1

Auto-Space After Keywords

Enable auto-entering spaces after keywords.

Preferences Dialog Path: Auto-editing > Typing > Auto-Space After Keywords

Classic Look Dialog Path: Editor > Auto-editing > Auto-Space After Keywords

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

Data Specification: <boolean: 0 or 1>

Default Value: 1

Enforce PEP 8 Style Spacing

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

Preferences Dialog Path: Auto-editing > Typing > Enforce PEP 8 Style Spacing

Classic Look Dialog Path: Editor > Auto-editing > Enforce PEP 8 Style Spacing

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

Data Specification: <boolean: 0 or 1>

Default Value: 1

Spaces Around = in Argument Lists

Add spaces around = in argument lists.

Preferences Dialog Path: Auto-editing > Typing > Spaces Around = in Argument Lists

Classic Look Dialog Path: Editor > Auto-editing > Spaces Around = in Argument Lists

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

Data Specification: <boolean: 0 or 1>

Default Value: 0

Spaces Elsewhere in Argument Lists

Add spaces around characters other than = in argument lists.

Preferences Dialog Path: Auto-editing > Typing > Spaces Elsewhere in Argument Lists

Classic Look Dialog Path: Editor > Auto-editing > Spaces Elsewhere in Argument Lists

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

Data Specification: <boolean: 0 or 1>

Default Value: 0

Spaces After : in Type Annotations

When auto-entering spaces is enabled, also auto-enter spaces after ":" in type annotations.

Preferences Dialog Path: Auto-editing > Typing > Spaces After : in Type Annotations

Classic Look Dialog Path: Editor > Auto-editing > Spaces After : in Type Annotations

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

Data Specification: <boolean: 0 or 1>

Default Value: 1

Manage Blocks on Repeated Colon Key Presses

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.

Preferences Dialog Path: Auto-editing > Typing > Manage Blocks on Repeated Colon Key Presses

Classic Look Dialog Path: Editor > Auto-editing > Manage Blocks on Repeated Colon Key Presses

Internal Name: edit.auto-edit-colon

Data Specification: <boolean: 0 or 1>

Default Value: True

Prefer Block Management Over := and Type Hints

Prioritize block management with : over the possibility of entering a var:type variable type annotation (Python 3.6+) or := (Python 3.8+). When this is disabled, typing : a second time will proceed with block management.in the current editing context.

Preferences Dialog Path: Auto-editing > Typing > Prefer Block Management Over := and Type Hints

Classic Look Dialog Path: Editor > Auto-editing > Prefer Block Management Over := and Type Hints

Internal Name: edit.auto-edit-colon-prioritize-blocks

Data Specification: <boolean: 0 or 1>

Default Value: False

Continue Comment or String on New Line

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

Preferences Dialog Path: Auto-editing > Typing > Continue Comment or String on New Line

Classic Look Dialog Path: Editor > Auto-editing > Continue Comment or String on New Line

Internal Name: edit.auto-edit-continue

Data Specification: <boolean: 0 or 1>

Default Value: 1

Correct Out-of-Order Typing

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

Preferences Dialog Path: Auto-editing > Typing > Correct Out-of-Order Typing

Classic Look Dialog Path: Editor > Auto-editing > Correct Out-of-Order Typing

Internal Name: edit.auto-edit-fixups

Data Specification: <boolean: 0 or 1>

Default Value: 1

Reformatting

Auto-Reformat

Controls when Wing automatically reformats code as you edit it. May be disabled, limited to only edited lines after the caret leaves that line, or performed on whole files when they are saved to disk.

Preferences Dialog Path: Auto-editing > Reformatting > Auto-Reformat

Classic Look Dialog Path: Editor > Reformatting > Auto-Reformat

Internal Name: edit.pep8-autoformat

Data Specification: [disabled, lines, files]

Default Value: disabled

Reformatter

Selects the reformatter to use when reformatting code automatically.

Preferences Dialog Path: Auto-editing > Reformatting > Reformatter

Classic Look Dialog Path: Editor > Reformatting > Reformatter

Internal Name: edit.pep8-reformatter

Data Specification: [pep8, black, ruff, yapf]

Default Value: pep8

Reformat Timeout

Number of seconds to wait for auto-formatting to complete before aborting the reformatting process.

Preferences Dialog Path: Auto-editing > Reformatting > Reformat Timeout

Classic Look Dialog Path: Editor > Reformatting > Reformat Timeout

Internal Name: edit.pep8-timeout

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

Default Value: 5

Enforce Line Length

Whether to enforce line length during auto-formatting. The length is specified with the Reformatting Wrap Column preference.

Preferences Dialog Path: Auto-editing > Reformatting > Enforce Line Length

Classic Look Dialog Path: Editor > Reformatting > Enforce Line Length

Internal Name: edit.pep8-enforce-line-length

Data Specification: <boolean: 0 or 1>

Default Value: 0

PEP 8: Reindent All Lines in Files

Whether to reindent all lines during PEP 8 reformatting. This affects only reformatting of whole files. Lines in a selection are never reindented during reformatting.

Preferences Dialog Path: Auto-editing > Reformatting > PEP 8: Reindent All Lines in Files

Classic Look Dialog Path: Editor > Reformatting > PEP 8: Reindent All Lines in Files

Internal Name: edit.pep8-reindent-all-lines

Data Specification: <boolean: 0 or 1>

Default Value: 0

PEP 8: Spaces Around = in Argument Lists

Override PEP 8 by adding spaces around = in argument lists.

Preferences Dialog Path: Auto-editing > Reformatting > PEP 8: Spaces Around = in Argument Lists

Classic Look Dialog Path: Editor > Reformatting > PEP 8: Spaces Around = in Argument Lists

Internal Name: edit.pep8-spaces-args

Data Specification: <boolean: 0 or 1>

Default Value: 0

PEP 8: Spaces After #

When applying PEP 8 rules, follow PEP 8 by enforcing the addition of spaces after # comment start. This option will lose indents in any commented out code.

Preferences Dialog Path: Auto-editing > Reformatting > PEP 8: Spaces After #

Classic Look Dialog Path: Editor > Reformatting > PEP 8: Spaces After #

Internal Name: edit.pep8-spaces-comment

Data Specification: <boolean: 0 or 1>

Default Value: 0

PEP 8: Move Imports to Top

When applying PEP 8 rules, follow PEP 8 by moving all imports to the top of the file.

Preferences Dialog Path: Auto-editing > Reformatting > PEP 8: Move Imports to Top

Classic Look Dialog Path: Editor > Reformatting > PEP 8: Move Imports to Top

Internal Name: edit.pep8-move-indents-to-top

Data Specification: <boolean: 0 or 1>

Default Value: 0

Black: Skip String Normalization

Whether or not to prevent Black from normalizing string quotes during auto-formatting.

Preferences Dialog Path: Auto-editing > Reformatting > Black: Skip String Normalization

Classic Look Dialog Path: Editor > Reformatting > Black: Skip String Normalization

Internal Name: edit.black-skip-string-normalization

Data Specification: <boolean: 0 or 1>

Default Value: 1

Reformatter Run Directory

Selects the current directory to use when running code reformatters, either the reformatted file's directory, the project's directory (or Project Home Directory if set), the user account's home directory, or a selected directory. The run directory may affect which configuration file is used by the reformatter.

Preferences Dialog Path: Auto-editing > Reformatting > Reformatter Run Directory

Classic Look Dialog Path: Editor > Reformatting > Reformatter Run Directory

Internal Name: edit.reformat-run-dir

Data Specification: [file, project, home, custom]

Default Value: ('file', '/Users/sdeibel/')

Reformatting Wrap Column

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

Preferences Dialog Path: Auto-editing > Reformatting > Reformatting Wrap Column

Classic Look Dialog Path: Editor > Line Wrapping > Reformatting Wrap Column

Internal Name: edit.text-wrap-column

Data Specification: <type int>

Default Value: 77

Snippets

Include Default Snippets

Whether to include the default snippets set in the Snippets tool. These are found in the User Settings directory (USER_SETTINGS_DIR)

Preferences Dialog Path: Auto-editing > Snippets > Include Default Snippets

Classic Look Dialog Path: Editor > Snippets > Include Default Snippets

Internal Name: edit.snippets-include-defaults

Data Specification: <boolean: 0 or 1>

Default Value: True

Snippets Path

Path to search for code snippets. Later directories on the path override earlier directories for a particular snippet name. Partial paths are interpreted relative to the current user's home directory (/Users/sdeibel/). New snippets will be created in the last directory on the path.

Preferences Dialog Path: Auto-editing > Snippets > Snippets Path

Classic Look Dialog Path: Editor > Snippets > Snippets Path

Internal Name: edit.snippets-path

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

Default Value: ()

File Types

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

Preferences Dialog Path: Files > File Types > Extra File Types

Classic Look Dialog Path: Files > File Types > Extra File Types

Internal Name: main.extra-mime-types

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

Default Value: {}

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.

Preferences Dialog Path: Files > File Types > File Filters

Classic Look Dialog Path: Files > File Types > File Filters

Internal Name: main.file-filters

Data Specification: [file filters]

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

Reloading

Reload when Unchanged

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

Preferences Dialog Path: Files > Reloading > Reload when Unchanged

Classic Look Dialog Path: Files > Reloading > Reload when Unchanged

Internal Name: cache.unchanged-reload-policy

Data Specification: [auto-reload, request-reload, edit-reload, never-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 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)

Preferences Dialog Path: Files > Reloading > Reload when Changed

Classic Look Dialog Path: Files > Reloading > Reload when Changed

Internal Name: cache.changed-reload-policy

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

Default Value: request-reload

Reloading Deleted Disk Files

Specifies the behavior of reload when a file that is open in an editor disappears on disk. The default Closes Editor is recommended if using revision control. Otherwise, retaining the current editor content reduces the chances of entirely losing a file if it is accidentally deleted on disk.

Preferences Dialog Path: Files > Reloading > Reloading Deleted Disk Files

Classic Look Dialog Path: Files > Reloading > Reloading Deleted Disk Files

Internal Name: guimgr.deleted-disk-file-policy

Data Specification: [list of: [close, blank, prompt]]

Default Value: close

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.

Preferences Dialog Path: Files > Reloading > External Check Freq

Classic Look Dialog Path: Files > Reloading > External Check Freq

Internal Name: cache.external-check-freq

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

Default Value: 5

Check Hash Before Reloading

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.

Preferences Dialog Path: Files > Reloading > Check Hash Before Reloading

Classic Look Dialog Path: Files > Reloading > Check Hash Before Reloading

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

Data Specification: <boolean: 0 or 1>

Default Value: True