1  """Define the menu contents, hotkeys, and event bindings.
       2  
       3  There is additional configuration information in the EditorWindow class (and
       4  subclasses): the menus are created there based on the menu_specs (class)
       5  variable, and menus not created are silently skipped in the code here.  This
       6  makes it possible, for example, to define a Debug menu which is only present in
       7  the PythonShell window, and a Format menu which is only present in the Editor
       8  windows.
       9  
      10  """
      11  from importlib.util import find_spec
      12  
      13  from idlelib.config import idleConf
      14  
      15  #   Warning: menudefs is altered in macosx.overrideRootMenu()
      16  #   after it is determined that an OS X Aqua Tk is in use,
      17  #   which cannot be done until after Tk() is first called.
      18  #   Do not alter the 'file', 'options', or 'help' cascades here
      19  #   without altering overrideRootMenu() as well.
      20  #       TODO: Make this more robust
      21  
      22  menudefs = [
      23   # underscore prefixes character to underscore
      24   ('file', [
      25     ('_New File', '<<open-new-window>>'),
      26     ('_Open...', '<<open-window-from-file>>'),
      27     ('Open _Module...', '<<open-module>>'),
      28     ('Module _Browser', '<<open-class-browser>>'),
      29     ('_Path Browser', '<<open-path-browser>>'),
      30     None,
      31     ('_Save', '<<save-window>>'),
      32     ('Save _As...', '<<save-window-as-file>>'),
      33     ('Save Cop_y As...', '<<save-copy-of-window-as-file>>'),
      34     None,
      35     ('Prin_t Window', '<<print-window>>'),
      36     None,
      37     ('_Close Window', '<<close-window>>'),
      38     ('E_xit IDLE', '<<close-all-windows>>'),
      39     ]),
      40  
      41   ('edit', [
      42     ('_Undo', '<<undo>>'),
      43     ('_Redo', '<<redo>>'),
      44     None,
      45     ('Select _All', '<<select-all>>'),
      46     ('Cu_t', '<<cut>>'),
      47     ('_Copy', '<<copy>>'),
      48     ('_Paste', '<<paste>>'),
      49     None,
      50     ('_Find...', '<<find>>'),
      51     ('Find A_gain', '<<find-again>>'),
      52     ('Find _Selection', '<<find-selection>>'),
      53     ('Find in Files...', '<<find-in-files>>'),
      54     ('R_eplace...', '<<replace>>'),
      55     None,
      56     ('Go to _Line', '<<goto-line>>'),
      57     ('S_how Completions', '<<force-open-completions>>'),
      58     ('E_xpand Word', '<<expand-word>>'),
      59     ('Show C_all Tip', '<<force-open-calltip>>'),
      60     ('Show Surrounding P_arens', '<<flash-paren>>'),
      61     ]),
      62  
      63   ('format', [
      64     ('F_ormat Paragraph', '<<format-paragraph>>'),
      65     ('_Indent Region', '<<indent-region>>'),
      66     ('_Dedent Region', '<<dedent-region>>'),
      67     ('Comment _Out Region', '<<comment-region>>'),
      68     ('U_ncomment Region', '<<uncomment-region>>'),
      69     ('Tabify Region', '<<tabify-region>>'),
      70     ('Untabify Region', '<<untabify-region>>'),
      71     ('Toggle Tabs', '<<toggle-tabs>>'),
      72     ('New Indent Width', '<<change-indentwidth>>'),
      73     ('S_trip Trailing Whitespace', '<<do-rstrip>>'),
      74     ]),
      75  
      76   ('run', [
      77     ('R_un Module', '<<run-module>>'),
      78     ('Run... _Customized', '<<run-custom>>'),
      79     ('C_heck Module', '<<check-module>>'),
      80     ('Python Shell', '<<open-python-shell>>'),
      81     ]),
      82  
      83   ('shell', [
      84     ('_View Last Restart', '<<view-restart>>'),
      85     ('_Restart Shell', '<<restart-shell>>'),
      86     None,
      87     ('_Previous History', '<<history-previous>>'),
      88     ('_Next History', '<<history-next>>'),
      89     None,
      90     ('_Interrupt Execution', '<<interrupt-execution>>'),
      91     ]),
      92  
      93   ('debug', [
      94     ('_Go to File/Line', '<<goto-file-line>>'),
      95     ('!_Debugger', '<<toggle-debugger>>'),
      96     ('_Stack Viewer', '<<open-stack-viewer>>'),
      97     ('!_Auto-open Stack Viewer', '<<toggle-jit-stack-viewer>>'),
      98     ]),
      99  
     100   ('options', [
     101     ('Configure _IDLE', '<<open-config-dialog>>'),
     102     None,
     103     ('Show _Code Context', '<<toggle-code-context>>'),
     104     ('Show _Line Numbers', '<<toggle-line-numbers>>'),
     105     ('_Zoom Height', '<<zoom-height>>'),
     106     ]),
     107  
     108   ('window', [
     109     ]),
     110  
     111   ('help', [
     112     ('_About IDLE', '<<about-idle>>'),
     113     None,
     114     ('_IDLE Doc', '<<help>>'),
     115     ('Python _Docs', '<<python-docs>>'),
     116     ]),
     117  ]
     118  
     119  if find_spec('turtledemo'):
     120      menudefs[-1][1].append(('Turtle Demo', '<<open-turtle-demo>>'))
     121  
     122  default_keydefs = idleConf.GetCurrentKeySet()
     123  
     124  if __name__ == '__main__':
     125      from unittest import main
     126      main('idlelib.idle_test.test_mainmenu', verbosity=2)