cpython/Lib/idlelib
Miss Islington (bot) 65c32bbe85
bpo-32837: IDLE - require encoding argument for textview.view_file. (GH-5646)
Using the system and place-dependent default encoding for open()
is a bad idea for IDLE's system and location-independent files.
(cherry picked from commit 688722cedd)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-02-12 15:15:01 -08:00
..
Icons
idle_test bpo-32837: IDLE - require encoding argument for textview.view_file. (GH-5646) 2018-02-12 15:15:01 -08:00
CREDITS.txt Issue #25905: Specify 'ascii' encoding for README.txt and NEWS.txt. 2016-01-16 23:44:04 -05:00
ChangeLog bpo-31462: Remove trailing whitespaces. (#3564) 2017-09-14 09:38:36 +03:00
HISTORY.txt Removed unintentional trailing spaces in text files. 2015-03-29 19:12:58 +03:00
NEWS.txt bpo-30928: IDLE - update NEWS.txt. (GH-5539) (GH-5540) 2018-02-04 20:18:37 -05:00
NEWS2x.txt Move idlelib/NEWS.txt entries for 2.x into a separate file -- NEWS2x.txt. 2016-09-29 23:59:55 -04:00
README.txt bpo-31462: Remove trailing whitespaces. (#3564) 2017-09-14 09:38:36 +03:00
TODO.txt
__init__.py Issue 27372: Stop test_idle from changing locale, so test passes. 2016-06-26 17:48:02 -04:00
__main__.py Issue #24225: Within idlelib files, update idlelib module names. 2016-05-28 13:22:31 -04:00
autocomplete.py bpo-27099: IDLE - Convert built-in extensions to regular features (#2494) 2017-09-10 17:19:47 -04:00
autocomplete_w.py Fix idlelib comment typos reported by Mike on pull request 4803. (#4807) 2017-12-11 22:59:08 -05:00
autoexpand.py bpo-27099: IDLE - Convert built-in extensions to regular features (#2494) 2017-09-10 17:19:47 -04:00
browser.py bpo-32100: IDLE: Fix pathbrowser errors; improve tests. (#4484) 2017-11-22 19:05:25 -05:00
calltip_w.py bpo-29910: IDLE no longer deletes a character after commenting out a region (#825) 2017-06-27 00:02:32 -04:00
calltips.py bpo-27099: IDLE - Convert built-in extensions to regular features (#2494) 2017-09-10 17:19:47 -04:00
codecontext.py bpo-31493: Fix code context update and font update timers. (#3622) 2017-09-17 00:56:56 -04:00
colorizer.py Issue #29071: Use local flags for IDLE colorizer string prefix matcher. 2017-01-01 21:21:39 -05:00
config-extensions.def bpo-31480: IDLE - fix tests to pass with zzdummy extension disabled. (#3590) 2017-09-14 18:51:51 -04:00
config-highlight.def Issue #24820: Add 'IDLE Dark' text color theme, warning, and solution. 2015-10-04 00:31:05 -04:00
config-keys.def bpo-27099: IDLE - Convert built-in extensions to regular features (#2494) 2017-09-10 17:19:47 -04:00
config-main.def Issue #28572: Use system-specific values for configdialog font test 2016-11-07 23:14:53 -05:00
config.py bpo-27099: IDLE - Convert built-in extensions to regular features (#2494) 2017-09-10 17:19:47 -04:00
config_key.py bpo-31649: Make IDLE's _htest, _utest parameters keyword-only. (#3839) 2017-09-30 17:37:53 -04:00
configdialog.py bpo-32765: Update configdialog General tab create page docstring (GH-5529) (GH-5537) 2018-02-04 18:39:22 -05:00
debugger.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
debugger_r.py Issue #24225: Within idlelib files, update idlelib module names. 2016-05-28 13:22:31 -04:00
debugobj.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
debugobj_r.py Issue #24225: Rename many idlelib/*.py and idlelib/idle_test/test_*.py files. 2016-05-22 19:10:31 -04:00
delegator.py Issue #24225: Rename many idlelib/*.py and idlelib/idle_test/test_*.py files. 2016-05-22 19:10:31 -04:00
dynoption.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
editor.py bpo-32100: IDLE: Fix pathbrowser errors; improve tests. (#4484) 2017-11-22 19:05:25 -05:00
extend.txt
filelist.py bpo-31500: IDLE: Scale default fonts on HiDPI displays. (#3639) 2017-09-21 11:20:06 +03:00
grep.py bpo-30674: IDLE: add docstrings to grep.py (#2213) 2017-06-27 02:41:08 -04:00
help.html bpo-314777: IDLE - improve rstrip entry in doc (#3602) 2017-09-15 13:05:28 -04:00
help.py bpo-25514: Improve IDLE's connection refused message (#2177) 2017-06-13 21:32:16 -04:00
help_about.py bpo-31649: Make IDLE's _htest, _utest parameters keyword-only. (#3839) 2017-09-30 17:37:53 -04:00
history.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
hyperparser.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
idle.bat Show what's changed when Travis fails regen check (GH-2095) 2017-06-10 23:04:36 -05:00
idle.py Issue #25488: merge idle.py from 3.5. 2016-09-30 02:56:46 -04:00
idle.pyw Issue #24225: Within idlelib files, update idlelib module names. 2016-05-28 13:22:31 -04:00
iomenu.py IDLE: make filetypes a tuple constant. (#3847) 2017-10-01 19:01:27 -04:00
macosx.py bpo-24813: IDLE: Add default title to help_about (#2366) 2017-06-23 20:00:58 -04:00
mainmenu.py bpo-31459: Rename IDLE's module browser from Class Browser to Module Browser. (#3704) 2017-09-23 16:46:01 -04:00
multicall.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
outwin.py bpo-27099: IDLE - Convert built-in extensions to regular features (#2494) 2017-09-10 17:19:47 -04:00
paragraph.py Fix miscellaneous typos (#4275) 2017-11-05 15:37:50 +02:00
parenmatch.py bpo-31488: IDLE - update former extensions when options change. (#3612) 2017-09-16 01:42:28 -04:00
pathbrowser.py bpo-32100: Delete unneeded import in idlelib.pathbrowser. (#4626) 2017-11-28 21:50:21 -05:00
percolator.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
pyparse.py bpo-30144: Import collections ABC from collections.abc rather than collections. (#1263) 2017-04-24 09:05:00 +03:00
pyshell.py IDLE -- Restrict shell prompt manipulaton to the shell. (#4143) 2017-10-27 20:26:12 -04:00
query.py bpo-29919: Remove unused imports found by pyflakes (#137) 2017-03-27 16:05:26 +02:00
redirector.py Refine geometry of idlelib htests (and a few other fix-ups). 2016-07-10 17:28:10 -04:00
replace.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
rpc.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
rstrip.py bpo-27099: IDLE - Convert built-in extensions to regular features (#2494) 2017-09-10 17:19:47 -04:00
run.py bpo-32207: Improve tk event exception tracebacks in IDLE. (#4703) 2017-12-04 16:16:18 -05:00
runscript.py bpo-27099: IDLE - Convert built-in extensions to regular features (#2494) 2017-09-10 17:19:47 -04:00
scrolledlist.py bpo-29910: IDLE no longer deletes a character after commenting out a region (#825) 2017-06-27 00:02:32 -04:00
search.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
searchbase.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
searchengine.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
stackviewer.py Remove unused imports. 2016-12-16 20:00:15 +02:00
statusbar.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
textview.py bpo-32837: IDLE - require encoding argument for textview.view_file. (GH-5646) 2018-02-12 15:15:01 -08:00
tooltip.py Refine geometry of idlelib htests (and a few other fix-ups). 2016-07-10 17:28:10 -04:00
tree.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
undo.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
windows.py Issue #27891: Consistently group and sort imports within idlelib modules. 2016-08-31 00:50:55 -04:00
zoomheight.py bpo-27099: IDLE - Convert built-in extensions to regular features (#2494) 2017-09-10 17:19:47 -04:00
zzdummy.py bpo-27099: IDLE - Convert built-in extensions to regular features (#2494) 2017-09-10 17:19:47 -04:00

README.txt

README.txt: an index to idlelib files and the IDLE menu.

IDLE is Python's Integrated Development and Learning
Environment.  The user documentation is part of the Library Reference and
is available in IDLE by selecting Help => IDLE Help.  This README documents
idlelib for IDLE developers and curious users.

IDLELIB FILES lists files alphabetically by category,
with a short description of each.

IDLE MENU show the menu tree, annotated with the module
or module object that implements the corresponding function.

This file is descriptive, not prescriptive, and may have errors
and omissions and lag behind changes in idlelib.


IDLELIB FILES
Implementation files not in IDLE MENU are marked (nim).
Deprecated files and objects are listed separately as the end.

Startup
-------
__init__.py  # import, does nothing
__main__.py  # -m, starts IDLE
idle.bat
idle.py
idle.pyw

Implementation
--------------
autocomplete.py   # Complete attribute names or filenames.
autocomplete_w.py # Display completions.
autoexpand.py     # Expand word with previous word in file.
browser.py        # Create module browser window.
calltip_w.py      # Display calltip.
calltips.py       # Create calltip text.
codecontext.py    # Show compound statement headers otherwise not visible.
colorizer.py      # Colorize text (nim)
config.py         # Load, fetch, and save configuration (nim).
configdialog.py   # Display user configuration dialogs.
config_help.py    # Specify help source in configdialog.
config_key.py     # Change keybindings.
dynoption.py      # Define mutable OptionMenu widget (nim).
debugobj.py       # Define class used in stackviewer.
debugobj_r.py     # Communicate objects between processes with rpc (nim).
debugger.py       # Debug code run from shell or editor; show window.
debugger_r.py     # Debug code run in remote process.
delegator.py      # Define base class for delegators (nim).
editor.py         # Define most of editor and utility functions.
filelist.py       # Open files and manage list of open windows (nim).
grep.py           # Find all occurrences of pattern in multiple files.
help.py           # Display IDLE's html doc.
help_about.py     # Display About IDLE dialog.
history.py        # Get previous or next user input in shell (nim)
hyperparser.py    # Parse code around a given index.
iomenu.py         # Open, read, and write files
macosx.py         # Help IDLE run on Macs (nim).
mainmenu.py       # Define most of IDLE menu.
multicall.py      # Wrap tk widget to allow multiple calls per event (nim).
outwin.py         # Create window for grep output.
paragraph.py      # Re-wrap multiline strings and comments.
parenmatch.py     # Match fenceposts: (), [], and {}.
pathbrowser.py    # Create path browser window.
percolator.py     # Manage delegator stack (nim).
pyparse.py        # Give information on code indentation
pyshell.py        # Start IDLE, manage shell, complete editor window
query.py          # Query user for information
redirector.py     # Intercept widget subcommands (for percolator) (nim).
replace.py        # Search and replace pattern in text.
rpc.py            # Commuicate between idle and user processes (nim).
rstrip.py         # Strip trailing whitespace.
run.py            # Manage user code execution subprocess.
runscript.py      # Check and run user code.
scrolledlist.py   # Define scrolledlist widget for IDLE (nim).
search.py         # Search for pattern in text.
searchbase.py     # Define base for search, replace, and grep dialogs.
searchengine.py   # Define engine for all 3 search dialogs.
stackviewer.py    # View stack after exception.
statusbar.py      # Define status bar for windows (nim).
tabbedpages.py    # Define tabbed pages widget (nim).
textview.py       # Define read-only text widget (nim).
tree.py           # Define tree widger, used in browsers (nim).
undo.py           # Manage undo stack.
windows.py        # Manage window list and define listed top level.
zoomheight.py     # Zoom window to full height of screen.

Configuration
-------------
config-extensions.def # Defaults for extensions
config-highlight.def  # Defaults for colorizing
config-keys.def       # Defaults for key bindings
config-main.def       # Defai;ts fpr font and geneal

Text
----
CREDITS.txt  # not maintained, displayed by About IDLE
HISTORY.txt  # NEWS up to July 2001
NEWS.txt     # commits, displayed by About IDLE
README.txt   # this file, displeyed by About IDLE
TODO.txt     # needs review
extend.txt   # about writing extensions
help.html    # copy of idle.html in docs, displayed by IDLE Help

Subdirectories
--------------
Icons        # small image files
idle_test    # files for human test and automated unit tests

Unused and Deprecated files and objects (nim)
---------------------------------------------
tooltip.py # unused



IDLE MENUS
Top level items and most submenu items are defined in mainmenu.
Extenstions add submenu items when active.  The names given are
found, quoted, in one of these modules, paired with a '<<pseudoevent>>'.
Each pseudoevent is bound to an event handler.  Some event handlers
call another function that does the actual work.  The annotations below
are intended to at least give the module where the actual work is done.
'eEW' = editor.EditorWindow

File
  New File         # eEW.new_callback
  Open...          # iomenu.open
  Open Module      # eEw.open_module
  Recent Files
  Class Browser    # eEW.open_class_browser, browser.ClassBrowser
  Path Browser     # eEW.open_path_browser, pathbrowser
  ---
  Save             # iomenu.save
  Save As...       # iomenu.save_as
  Save Copy As...  # iomenu.save_a_copy
  ---
  Print Window     # iomenu.print_window
  ---
  Close            # eEW.close_event
  Exit             # flist.close_all_callback (bound in eEW)

Edit
  Undo             # undodelegator
  Redo             # undodelegator
  ---              # eEW.right_menu_event
  Cut              # eEW.cut
  Copy             # eEW.copy
  Paste            # eEW.past
  Select All       # eEW.select_all (+ see eEW.remove_selection)
  ---              # Next 5 items use searchengine; dialogs use searchbase
  Find             # eEW.find_event, search.SearchDialog.find
  Find Again       # eEW.find_again_event, sSD.find_again
  Find Selection   # eEW.find_selection_event, sSD.find_selection
  Find in Files... # eEW.find_in_files_event, grep
  Replace...       # eEW.replace_event, replace.ReplaceDialog.replace
  Go to Line       # eEW.goto_line_event
  Show Completions # autocomplete extension and autocompleteWidow (&HP)
  Expand Word      # autoexpand extension
  Show call tip    # Calltips extension and CalltipWindow (& Hyperparser)
  Show surrounding parens  # parenmatch (& Hyperparser)

Shell  # pyshell
  View Last Restart    # pyshell.PyShell.view_restart_mark
  Restart Shell        # pyshell.PyShell.restart_shell
  Interrupt Execution  # pyshell.PyShell.cancel_callback

Debug (Shell only)
  Go to File/Line
  debugger         # debugger, debugger_r, PyShell.toggle_debuger
  Stack Viewer     # stackviewer, PyShell.open_stack_viewer
  Auto-open Stack Viewer  # stackviewer

Format (Editor only)
  Indent Region    # eEW.indent_region_event
  Dedent Region    # eEW.dedent_region_event
  Comment Out Reg. # eEW.comment_region_event
  Uncomment Region # eEW.uncomment_region_event
  Tabify Region    # eEW.tabify_region_event
  Untabify Region  # eEW.untabify_region_event
  Toggle Tabs      # eEW.toggle_tabs_event
  New Indent Width # eEW.change_indentwidth_event
  Format Paragraph # paragraph extension
  ---
  Strip tailing whitespace  # rstrip extension

Run (Editor only)
  Python Shell     # pyshell
  ---
  Check Module     # runscript
  Run Module       # runscript

Options
  Configure IDLE   # eEW.config_dialog, configdialog
    (tabs in the dialog)
    Font tab       # config-main.def
    Highlight tab  # query, config-highlight.def
    Keys tab       # query, config_key, config_keys.def
    General tab    # config_help, config-main.def
    Extensions tab # config-extensions.def, corresponding .py
  ---
  Code Context (ed)# codecontext extension

Window
  Zoomheight       # zoomheight extension
  ---
  <open windows>   # windows

Help
  About IDLE       # eEW.about_dialog, help_about.AboutDialog
  ---
  IDLE Help        # eEW.help_dialog, helpshow_idlehelp
  Python Doc       # eEW.python_docs
  Turtle Demo      # eEW.open_turtle_demo
  ---
  <other help sources>

<Context Menu> (right click)
  Defined in editor, PyShelpyshellut
    Cut
    Copy
    Paste
    ---
    Go to file/line (shell and output only)
    Set Breakpoint (editor only)
    Clear Breakpoint (editor only)
  Defined in debugger
    Go to source line
    Show stack frame

<No menu>
Center Insert      # eEW.center_insert_event


CODE STYLE -- Generally PEP 8.

import
------
Put import at the top, unless there is a good reason otherwise.
PEP 8 says to group stdlib, 3rd-party dependencies, and package imports.
For idlelib, the groups are general stdlib, tkinter, and idlelib.
Sort modules within each group, except that tkinter.ttk follows tkinter.
Sort 'from idlelib import mod1' and 'from idlelib.mod2 import object'
together by module, ignoring within module objects.
Put 'import __main__' after other idlelib imports.

Imports only needed for testing are put not at the top but in an
htest function def or "if __name__ == '__main__'" clause.

Within module imports like "from idlelib.mod import class" may cause
circular imports to deadlock.  Even without this, circular imports may
require at least one of the imports to be delayed until a function call.