26.5. IDLE — Python 3.8.0a0 documentation

-

26.5.1.1. File menu (Shell and Editor)Â¶

+

File menu (Shell and Editor)Â¶

New File: Create a new file editing window.

-

26.5.1.2. Edit menu (Shell and Editor)Â¶

+

Edit menu (Shell and Editor)Â¶

Undo: Undo the last change to the current window. A maximum of 1000 changes may @@ -198,7 +211,7 @@ function parameter hints.

-

26.5.1.3. Format menu (Editor window only)Â¶

+

Format menu (Editor window only)Â¶

Indent Region: Shift selected lines right by the indent width (default 4 spaces).

-

26.5.1.4. Run menu (Editor window only)Â¶

+

Run menu (Editor window only)Â¶

Python Shell: Open or wake up the Python Shell window.

-

26.5.1.5. Shell menu (Shell window only)Â¶

+

Shell menu (Shell window only)Â¶

View Last Restart: Scroll the shell window to the last Shell restart.

-

26.5.1.6. Debug menu (Shell window only)Â¶

+

Debug menu (Shell window only)Â¶

Go to File/Line: Look on the current line. with the cursor, and the line above for a filename @@ -283,7 +296,7 @@ access to locals and globals.

-

26.5.1.7. Options menu (Shell and Editor)Â¶

+

Options menu (Shell and Editor)Â¶

Configure IDLE: Open a configuration dialog and change preferences for the following: @@ -303,7 +316,7 @@ line in this pane exposes that line at the top of the editor.

-

26.5.1.8. Window menu (Shell and Editor)Â¶

+

Window menu (Shell and Editor)Â¶

Zoom Height: Toggles the window between normal size and maximum height. The initial size @@ -314,7 +327,7 @@ Configure IDLE dialog.

-

26.5.1.9. Help menu (Shell and Editor)Â¶

+

Help menu (Shell and Editor)Â¶

About IDLE: Display version, copyright, license, credits, and more.; Access local Python documentation, if installed, or start a web browser and open docs.python.org showing the latest Python documentation.
Turtle Demo: Run the turtledemo module with example python code and turtle drawings.; Run the turtledemo module with example Python code and turtle drawings.

Additional help sources may be added here with the Configure IDLE dialog under the General tab.

-

26.5.1.10. Context MenusÂ¶

+

Context MenusÂ¶

Open a context menu by right-clicking in a window (Control-click on OS X). Context menus have the standard clipboard functions also on the Edit menu.

@@ -359,7 +372,7 @@ debugger. Breakpoints for a file are saved in the userâs .idlerc directory.

-

26.5.2. Editing and navigationÂ¶

+

Editing and navigationÂ¶

In this section, âCâ refers to the Control key on Windows and Unix and the Command key on Mac OSX.

Standard keybindings (like C-c to copy and C-v to paste) may work. Keybindings are selected in the Configure IDLE dialog.

-

26.5.2.1. Automatic indentationÂ¶

+

Automatic indentationÂ¶

After a block-opening statement, the next line is indented by 4 spaces (in the Python Shell window by one tab). After certain keywords (break, return etc.) the next line is dedented. In leading indentation, Backspace deletes up @@ -406,7 +419,7 @@ are restricted to four spaces due to Tcl/Tk limitations.

See also the indent/dedent region commands in the edit menu.

-

26.5.2.2. CompletionsÂ¶

+

CompletionsÂ¶

Completions are supplied for functions, classes, and attributes of classes, both built-in and user-defined. Completions are also provided for filenames.

@@ -441,7 +454,7 @@ much can be found by default, e.g. the re module.

longer or disable the extension.

-

26.5.2.3. CalltipsÂ¶

+

CalltipsÂ¶

A calltip is shown when one types ( after the name of an accessible function. A name expression may include dots and subscripts. A calltip remains until it is clicked, the cursor is moved out of the argument area, @@ -464,7 +477,7 @@ might want to run a file after writing the import statements at the top, or immediately run an existing file before editing.

-

26.5.2.4. Python Shell windowÂ¶

+

Python Shell windowÂ¶

C-c interrupts executing command

C-p

-

26.5.2.5. Text colorsÂ¶

+

Text colorsÂ¶

Idle defaults to black on white text, but colors text with special meanings. For the shell, these are shell output, shell error, user output, and user error. For Python code, at the shell prompt or in an editor, these are @@ -496,7 +509,7 @@ text in popups and dialogs is not user-configurable.

-

26.5.3. Startup and code executionÂ¶

+

Startup and code executionÂ¶

Upon startup with the -s option, IDLE will execute the file referenced by the environment variables IDLESTARTUP or PYTHONSTARTUP. IDLE first checks for IDLESTARTUP; if IDLESTARTUP is present the file @@ -510,7 +523,7 @@ looked for in the userâs home directory. Statements in this file will be executed in the Tk namespace, so this file is not useful for importing functions to be used from IDLEâs Python shell.

-

26.5.3.1. Command line usageÂ¶

+

Command line usageÂ¶

idle.py [-c command] [-d] [-e] [-h] [-i] [-r file] [-s] [-t title] [-] [arg] ...
 
 -c command  run command in the shell window
@@ -535,7 +548,7 @@ set in the Options dialog.

-

26.5.3.2. Startup failureÂ¶

+

Startup failureÂ¶

IDLE uses a socket to communicate between the IDLE GUI process and the user code execution process. A connection must be established whenever the Shell starts or restarts. (The latter is indicated by a divider line that says @@ -571,7 +584,7 @@ be to delete one or more of the configuration files.

starting from a console (python -m idlelib) and see if a message appears.

-

26.5.3.3. IDLE-console differencesÂ¶

+

IDLE-console differencesÂ¶

With rare exceptions, the result of executing Python code with IDLE is intended to be the same as executing the same code in a console window. However, the different interface and operation occasionally affect @@ -589,7 +602,7 @@ Some consoles only work with a single physical line at a time. IDLE uses defined for each statement.

-

26.5.3.4. Developing tkinter applicationsÂ¶

+

Developing tkinter applicationsÂ¶

IDLE is intentionally different from standard Python in order to facilitate development of tkinter programs. Enter import tkinter as tk; root = tk.Tk() in standard Python and nothing appears. Enter the same @@ -609,7 +622,7 @@ interact with the live application. One just has to remember to re-enable the mainloop call when running in standard Python.

-

26.5.3.5. Running without a subprocessÂ¶

+

Running without a subprocessÂ¶

By default, IDLE executes user code in a separate subprocess via a socket, which uses the internal loopback interface. This connection is not externally visible and no data is sent to or received from the Internet. @@ -635,9 +648,9 @@ with the default subprocess if at all possible.

-

26.5.4. Help and preferencesÂ¶

+

Help and preferencesÂ¶

-

26.5.4.1. Additional help sourcesÂ¶

+

Additional help sourcesÂ¶

IDLE includes a help menu entry called âPython Docsâ that will open the extensive sources of help, including tutorials, available at docs.python.org. Selected URLs can be added or removed from the help menu at any time using the @@ -645,14 +658,14 @@ Configure IDLE dialog. See the IDLE help option in the help menu of IDLE for more information.

-

26.5.4.2. Setting preferencesÂ¶

+

Setting preferencesÂ¶

The font preferences, highlighting, keys, and general preferences can be changed via Configure IDLE on the Option menu. Keys can be user defined; IDLE ships with four built-in key sets. In addition, a user can create a custom key set in the Configure IDLE dialog under the keys tab.

-

26.5.4.3. ExtensionsÂ¶

+

ExtensionsÂ¶

IDLE contains an extension facility. Preferences for extensions can be changed with the Extensions tab of the preferences dialog. See the beginning of config-extensions.def in the idlelib directory for further @@ -668,42 +681,42 @@ also used for testing.

26.5. IDLEÂ¶

IDLEÂ¶

26.5.1. MenusÂ¶

MenusÂ¶