1README.txt: an index to idlelib files and the IDLE menu. 2 3IDLE is Python's Integrated Development and Learning 4Environment. The user documentation is part of the Library Reference and 5is available in IDLE by selecting Help => IDLE Help. This README documents 6idlelib for IDLE developers and curious users. 7 8IDLELIB FILES lists files alphabetically by category, 9with a short description of each. 10 11IDLE MENU show the menu tree, annotated with the module 12or module object that implements the corresponding function. 13 14This file is descriptive, not prescriptive, and may have errors 15and omissions and lag behind changes in idlelib. 16 17 18IDLELIB FILES 19Implemetation files not in IDLE MENU are marked (nim). 20Deprecated files and objects are listed separately as the end. 21 22Startup 23------- 24__init__.py # import, does nothing 25__main__.py # -m, starts IDLE 26idle.bat 27idle.py 28idle.pyw 29 30Implementation 31-------------- 32AutoComplete.py # Complete attribute names or filenames. 33AutoCompleteWindow.py # Display completions. 34AutoExpand.py # Expand word with previous word in file. 35Bindings.py # Define most of IDLE menu. 36CallTipWindow.py # Display calltip. 37CallTips.py # Create calltip text. 38ClassBrowser.py # Create module browser window. 39CodeContext.py # Show compound statement headers otherwise not visible. 40ColorDelegator.py # Colorize text (nim). 41Debugger.py # Debug code run from editor; show window. 42Delegator.py # Define base class for delegators (nim). 43EditorWindow.py # Define most of editor and utility functions. 44FileList.py # Open files and manage list of open windows (nim). 45FormatParagraph.py# Re-wrap multiline strings and comments. 46GrepDialog.py # Find all occurrences of pattern in multiple files. 47HyperParser.py # Parse code around a given index. 48IOBinding.py # Open, read, and write files 49IdleHistory.py # Get previous or next user input in shell (nim) 50MultiCall.py # Wrap tk widget to allow multiple calls per event (nim). 51MultiStatusBar.py # Define status bar for windows (nim). 52ObjectBrowser.py # Define class used in StackViewer (nim). 53OutputWindow.py # Create window for grep output. 54ParenMatch.py # Match fenceposts: (), [], and {}. 55PathBrowser.py # Create path browser window. 56Percolator.py # Manage delegator stack (nim). 57PyParse.py # Give information on code indentation 58PyShell.py # Start IDLE, manage shell, complete editor window 59RemoteDebugger.py # Debug code run in remote process. 60RemoteObjectBrowser.py # Communicate objects between processes with rpc (nim). 61ReplaceDialog.py # Search and replace pattern in text. 62RstripExtension.py# Strip trailing whitespace 63ScriptBinding.py # Check and run user code. 64ScrolledList.py # Define ScrolledList widget for IDLE (nim). 65SearchDialog.py # Search for pattern in text. 66SearchDialogBase.py # Define base for search, replace, and grep dialogs. 67SearchEngine.py # Define engine for all 3 search dialogs. 68StackViewer.py # View stack after exception. 69TreeWidget.py # Define tree widger, used in browsers (nim). 70UndoDelegator.py # Manage undo stack. 71WidgetRedirector.py # Intercept widget subcommands (for percolator) (nim). 72WindowList.py # Manage window list and define listed top level. 73ZoomHeight.py # Zoom window to full height of screen. 74aboutDialog.py # Display About IDLE dialog. 75configDialog.py # Display user configuration dialogs. 76configHandler.py # Load, fetch, and save configuration (nim). 77configHelpSourceEdit.py # Specify help source. 78configSectionNameDialog.py # Spefify user config section name 79dynOptionMenuWidget.py # define mutable OptionMenu widget (nim). 80help.py # Display IDLE's html doc. 81keybindingDialog.py # Change keybindings. 82macosxSupport.py # Help IDLE run on Macs (nim). 83rpc.py # Commuicate between idle and user processes (nim). 84run.py # Manage user code execution subprocess. 85tabbedpages.py # Define tabbed pages widget (nim). 86textView.py # Define read-only text widget (nim). 87 88Configuration 89------------- 90config-extensions.def # Defaults for extensions 91config-highlight.def # Defaults for colorizing 92config-keys.def # Defaults for key bindings 93config-main.def # Defai;ts fpr font and geneal 94 95Text 96---- 97CREDITS.txt # not maintained, displayed by About IDLE 98HISTORY.txt # NEWS up to July 2001 99NEWS.txt # commits, displayed by About IDLE 100README.txt # this file, displeyed by About IDLE 101TODO.txt # needs review 102extend.txt # about writing extensions 103help.html # copy of idle.html in docs, displayed by IDLE Help 104 105Subdirectories 106-------------- 107Icons # small image files 108idle_test # files for human test and automated unit tests 109 110Unused and Deprecated files and objects (nim) 111--------------------------------------------- 112EditorWindow.py: Helpdialog and helpDialog 113ToolTip.py: unused. 114help.txt 115idlever.py 116 117 118IDLE MENUS 119Top level items and most submenu items are defined in Bindings. 120Extenstions add submenu items when active. The names given are 121found, quoted, in one of these modules, paired with a '<<pseudoevent>>'. 122Each pseudoevent is bound to an event handler. Some event handlers 123call another function that does the actual work. The annotations below 124are intended to at least give the module where the actual work is done. 125 126File # IOBindig except as noted 127 New File 128 Open... # IOBinding.open 129 Open Module 130 Recent Files 131 Class Browser # Class Browser 132 Path Browser # Path Browser 133 --- 134 Save # IDBinding.save 135 Save As... # IOBinding.save_as 136 Save Copy As... # IOBindling.save_a_copy 137 --- 138 Print Window # IOBinding.print_window 139 --- 140 Close 141 Exit 142 143Edit 144 Undo # undoDelegator 145 Redo # undoDelegator 146 --- 147 Cut 148 Copy 149 Paste 150 Select All 151 --- # Next 5 items use SearchEngine; dialogs use SearchDialogBase 152 Find # Search Dialog 153 Find Again 154 Find Selection 155 Find in Files... # GrepDialog 156 Replace... # ReplaceDialog 157 Go to Line 158 Show Completions # AutoComplete extension and AutoCompleteWidow (&HP) 159 Expand Word # AutoExpand extension 160 Show call tip # Calltips extension and CalltipWindow (& Hyperparser) 161 Show surrounding parens # ParenMatch (& Hyperparser) 162 163Shell # PyShell 164 View Last Restart # PyShell.PyShell.view_restart_mark 165 Restart Shell # PyShell.PyShell.restart_shell 166 Interrupt Execution # pyshell.PyShell.cancel_callback 167 168Debug (Shell only) 169 Go to File/Line 170 Debugger # Debugger, RemoteDebugger, PyShell.toggle_debuger 171 Stack Viewer # StackViewer, PyShell.open_stack_viewer 172 Auto-open Stack Viewer # StackViewer 173 174Format (Editor only) 175 Indent Region 176 Dedent Region 177 Comment Out Region 178 Uncomment Region 179 Tabify Region 180 Untabify Region 181 Toggle Tabs 182 New Indent Width 183 Format Paragraph # FormatParagraph extension 184 --- 185 Strip tailing whitespace # RstripExtension extension 186 187Run (Editor only) 188 Python Shell # PyShell 189 --- 190 Check Module # ScriptBinding 191 Run Module # ScriptBinding 192 193Options 194 Configure IDLE # configDialog 195 (tabs in the dialog) 196 Font tab # onfig-main.def 197 Highlight tab # configSectionNameDialog, config-highlight.def 198 Keys tab # keybindingDialog, configSectionNameDialog, onfig-keus.def 199 General tab # configHelpSourceEdit, config-main.def 200 Configure Extensions # configDialog 201 Xyz tab # xyz.py, config-extensions.def 202 --- 203 Code Context (editor only) # CodeContext extension 204 205Window 206 Zoomheight # ZoomHeight extension 207 --- 208 <open windows> # WindowList 209 210Help 211 About IDLE # aboutDialog 212 --- 213 IDLE Help # help 214 Python Doc 215 Turtle Demo 216 --- 217 <other help sources> 218 219<Context Menu> (right click) 220Defined in EditorWindow, PyShell, Output 221 Cut 222 Copy 223 Paste 224 --- 225 Go to file/line (shell and output only) 226 Set Breakpoint (editor only) 227 Clear Breakpoint (editor only) 228 Defined in Debugger 229 Go to source line 230 Show stack frame 231