editor.py 65 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683
  1. import importlib.abc
  2. import importlib.util
  3. import os
  4. import platform
  5. import re
  6. import string
  7. import sys
  8. import tokenize
  9. import traceback
  10. import webbrowser
  11. from tkinter import *
  12. from tkinter.font import Font
  13. from tkinter.ttk import Scrollbar
  14. from tkinter import simpledialog
  15. from tkinter import messagebox
  16. from idlelib.config import idleConf
  17. from idlelib import configdialog
  18. from idlelib import grep
  19. from idlelib import help
  20. from idlelib import help_about
  21. from idlelib import macosx
  22. from idlelib.multicall import MultiCallCreator
  23. from idlelib import pyparse
  24. from idlelib import query
  25. from idlelib import replace
  26. from idlelib import search
  27. from idlelib.tree import wheel_event
  28. from idlelib.util import py_extensions
  29. from idlelib import window
  30. # The default tab setting for a Text widget, in average-width characters.
  31. TK_TABWIDTH_DEFAULT = 8
  32. _py_version = ' (%s)' % platform.python_version()
  33. darwin = sys.platform == 'darwin'
  34. def _sphinx_version():
  35. "Format sys.version_info to produce the Sphinx version string used to install the chm docs"
  36. major, minor, micro, level, serial = sys.version_info
  37. release = '%s%s' % (major, minor)
  38. release += '%s' % (micro,)
  39. if level == 'candidate':
  40. release += 'rc%s' % (serial,)
  41. elif level != 'final':
  42. release += '%s%s' % (level[0], serial)
  43. return release
  44. class EditorWindow:
  45. from idlelib.percolator import Percolator
  46. from idlelib.colorizer import ColorDelegator, color_config
  47. from idlelib.undo import UndoDelegator
  48. from idlelib.iomenu import IOBinding, encoding
  49. from idlelib import mainmenu
  50. from idlelib.statusbar import MultiStatusBar
  51. from idlelib.autocomplete import AutoComplete
  52. from idlelib.autoexpand import AutoExpand
  53. from idlelib.calltip import Calltip
  54. from idlelib.codecontext import CodeContext
  55. from idlelib.sidebar import LineNumbers
  56. from idlelib.format import FormatParagraph, FormatRegion, Indents, Rstrip
  57. from idlelib.parenmatch import ParenMatch
  58. from idlelib.zoomheight import ZoomHeight
  59. filesystemencoding = sys.getfilesystemencoding() # for file names
  60. help_url = None
  61. allow_code_context = True
  62. allow_line_numbers = True
  63. user_input_insert_tags = None
  64. def __init__(self, flist=None, filename=None, key=None, root=None):
  65. # Delay import: runscript imports pyshell imports EditorWindow.
  66. from idlelib.runscript import ScriptBinding
  67. if EditorWindow.help_url is None:
  68. dochome = os.path.join(sys.base_prefix, 'Doc', 'index.html')
  69. if sys.platform.count('linux'):
  70. # look for html docs in a couple of standard places
  71. pyver = 'python-docs-' + '%s.%s.%s' % sys.version_info[:3]
  72. if os.path.isdir('/var/www/html/python/'): # "python2" rpm
  73. dochome = '/var/www/html/python/index.html'
  74. else:
  75. basepath = '/usr/share/doc/' # standard location
  76. dochome = os.path.join(basepath, pyver,
  77. 'Doc', 'index.html')
  78. elif sys.platform[:3] == 'win':
  79. import winreg # Windows only, block only executed once.
  80. docfile = ''
  81. KEY = (rf"Software\Python\PythonCore\{sys.winver}"
  82. r"\Help\Main Python Documentation")
  83. try:
  84. docfile = winreg.QueryValue(winreg.HKEY_CURRENT_USER, KEY)
  85. except FileNotFoundError:
  86. try:
  87. docfile = winreg.QueryValue(winreg.HKEY_LOCAL_MACHINE,
  88. KEY)
  89. except FileNotFoundError:
  90. pass
  91. if os.path.isfile(docfile):
  92. dochome = docfile
  93. elif sys.platform == 'darwin':
  94. # documentation may be stored inside a python framework
  95. dochome = os.path.join(sys.base_prefix,
  96. 'Resources/English.lproj/Documentation/index.html')
  97. dochome = os.path.normpath(dochome)
  98. if os.path.isfile(dochome):
  99. EditorWindow.help_url = dochome
  100. if sys.platform == 'darwin':
  101. # Safari requires real file:-URLs
  102. EditorWindow.help_url = 'file://' + EditorWindow.help_url
  103. else:
  104. EditorWindow.help_url = ("https://docs.python.org/%d.%d/"
  105. % sys.version_info[:2])
  106. self.flist = flist
  107. root = root or flist.root
  108. self.root = root
  109. self.menubar = Menu(root)
  110. self.top = top = window.ListedToplevel(root, menu=self.menubar)
  111. if flist:
  112. self.tkinter_vars = flist.vars
  113. #self.top.instance_dict makes flist.inversedict available to
  114. #configdialog.py so it can access all EditorWindow instances
  115. self.top.instance_dict = flist.inversedict
  116. else:
  117. self.tkinter_vars = {} # keys: Tkinter event names
  118. # values: Tkinter variable instances
  119. self.top.instance_dict = {}
  120. self.recent_files_path = idleConf.userdir and os.path.join(
  121. idleConf.userdir, 'recent-files.lst')
  122. self.prompt_last_line = '' # Override in PyShell
  123. self.text_frame = text_frame = Frame(top)
  124. self.vbar = vbar = Scrollbar(text_frame, name='vbar')
  125. width = idleConf.GetOption('main', 'EditorWindow', 'width', type='int')
  126. text_options = {
  127. 'name': 'text',
  128. 'padx': 5,
  129. 'wrap': 'none',
  130. 'highlightthickness': 0,
  131. 'width': width,
  132. 'tabstyle': 'wordprocessor', # new in 8.5
  133. 'height': idleConf.GetOption(
  134. 'main', 'EditorWindow', 'height', type='int'),
  135. }
  136. self.text = text = MultiCallCreator(Text)(text_frame, **text_options)
  137. self.top.focused_widget = self.text
  138. self.createmenubar()
  139. self.apply_bindings()
  140. self.top.protocol("WM_DELETE_WINDOW", self.close)
  141. self.top.bind("<<close-window>>", self.close_event)
  142. if macosx.isAquaTk():
  143. # Command-W on editor windows doesn't work without this.
  144. text.bind('<<close-window>>', self.close_event)
  145. # Some OS X systems have only one mouse button, so use
  146. # control-click for popup context menus there. For two
  147. # buttons, AquaTk defines <2> as the right button, not <3>.
  148. text.bind("<Control-Button-1>",self.right_menu_event)
  149. text.bind("<2>", self.right_menu_event)
  150. else:
  151. # Elsewhere, use right-click for popup menus.
  152. text.bind("<3>",self.right_menu_event)
  153. text.bind('<MouseWheel>', wheel_event)
  154. text.bind('<Button-4>', wheel_event)
  155. text.bind('<Button-5>', wheel_event)
  156. text.bind('<Configure>', self.handle_winconfig)
  157. text.bind("<<cut>>", self.cut)
  158. text.bind("<<copy>>", self.copy)
  159. text.bind("<<paste>>", self.paste)
  160. text.bind("<<center-insert>>", self.center_insert_event)
  161. text.bind("<<help>>", self.help_dialog)
  162. text.bind("<<python-docs>>", self.python_docs)
  163. text.bind("<<about-idle>>", self.about_dialog)
  164. text.bind("<<open-config-dialog>>", self.config_dialog)
  165. text.bind("<<open-module>>", self.open_module_event)
  166. text.bind("<<do-nothing>>", lambda event: "break")
  167. text.bind("<<select-all>>", self.select_all)
  168. text.bind("<<remove-selection>>", self.remove_selection)
  169. text.bind("<<find>>", self.find_event)
  170. text.bind("<<find-again>>", self.find_again_event)
  171. text.bind("<<find-in-files>>", self.find_in_files_event)
  172. text.bind("<<find-selection>>", self.find_selection_event)
  173. text.bind("<<replace>>", self.replace_event)
  174. text.bind("<<goto-line>>", self.goto_line_event)
  175. text.bind("<<smart-backspace>>",self.smart_backspace_event)
  176. text.bind("<<newline-and-indent>>",self.newline_and_indent_event)
  177. text.bind("<<smart-indent>>",self.smart_indent_event)
  178. self.fregion = fregion = self.FormatRegion(self)
  179. # self.fregion used in smart_indent_event to access indent_region.
  180. text.bind("<<indent-region>>", fregion.indent_region_event)
  181. text.bind("<<dedent-region>>", fregion.dedent_region_event)
  182. text.bind("<<comment-region>>", fregion.comment_region_event)
  183. text.bind("<<uncomment-region>>", fregion.uncomment_region_event)
  184. text.bind("<<tabify-region>>", fregion.tabify_region_event)
  185. text.bind("<<untabify-region>>", fregion.untabify_region_event)
  186. indents = self.Indents(self)
  187. text.bind("<<toggle-tabs>>", indents.toggle_tabs_event)
  188. text.bind("<<change-indentwidth>>", indents.change_indentwidth_event)
  189. text.bind("<Left>", self.move_at_edge_if_selection(0))
  190. text.bind("<Right>", self.move_at_edge_if_selection(1))
  191. text.bind("<<del-word-left>>", self.del_word_left)
  192. text.bind("<<del-word-right>>", self.del_word_right)
  193. text.bind("<<beginning-of-line>>", self.home_callback)
  194. if flist:
  195. flist.inversedict[self] = key
  196. if key:
  197. flist.dict[key] = self
  198. text.bind("<<open-new-window>>", self.new_callback)
  199. text.bind("<<close-all-windows>>", self.flist.close_all_callback)
  200. text.bind("<<open-class-browser>>", self.open_module_browser)
  201. text.bind("<<open-path-browser>>", self.open_path_browser)
  202. text.bind("<<open-turtle-demo>>", self.open_turtle_demo)
  203. self.set_status_bar()
  204. text_frame.pack(side=LEFT, fill=BOTH, expand=1)
  205. text_frame.rowconfigure(1, weight=1)
  206. text_frame.columnconfigure(1, weight=1)
  207. vbar['command'] = self.handle_yview
  208. vbar.grid(row=1, column=2, sticky=NSEW)
  209. text['yscrollcommand'] = vbar.set
  210. text['font'] = idleConf.GetFont(self.root, 'main', 'EditorWindow')
  211. text.grid(row=1, column=1, sticky=NSEW)
  212. text.focus_set()
  213. self.set_width()
  214. # usetabs true -> literal tab characters are used by indent and
  215. # dedent cmds, possibly mixed with spaces if
  216. # indentwidth is not a multiple of tabwidth,
  217. # which will cause Tabnanny to nag!
  218. # false -> tab characters are converted to spaces by indent
  219. # and dedent cmds, and ditto TAB keystrokes
  220. # Although use-spaces=0 can be configured manually in config-main.def,
  221. # configuration of tabs v. spaces is not supported in the configuration
  222. # dialog. IDLE promotes the preferred Python indentation: use spaces!
  223. usespaces = idleConf.GetOption('main', 'Indent',
  224. 'use-spaces', type='bool')
  225. self.usetabs = not usespaces
  226. # tabwidth is the display width of a literal tab character.
  227. # CAUTION: telling Tk to use anything other than its default
  228. # tab setting causes it to use an entirely different tabbing algorithm,
  229. # treating tab stops as fixed distances from the left margin.
  230. # Nobody expects this, so for now tabwidth should never be changed.
  231. self.tabwidth = 8 # must remain 8 until Tk is fixed.
  232. # indentwidth is the number of screen characters per indent level.
  233. # The recommended Python indentation is four spaces.
  234. self.indentwidth = self.tabwidth
  235. self.set_notabs_indentwidth()
  236. # Store the current value of the insertofftime now so we can restore
  237. # it if needed.
  238. if not hasattr(idleConf, 'blink_off_time'):
  239. idleConf.blink_off_time = self.text['insertofftime']
  240. self.update_cursor_blink()
  241. # When searching backwards for a reliable place to begin parsing,
  242. # first start num_context_lines[0] lines back, then
  243. # num_context_lines[1] lines back if that didn't work, and so on.
  244. # The last value should be huge (larger than the # of lines in a
  245. # conceivable file).
  246. # Making the initial values larger slows things down more often.
  247. self.num_context_lines = 50, 500, 5000000
  248. self.per = per = self.Percolator(text)
  249. self.undo = undo = self.UndoDelegator()
  250. per.insertfilter(undo)
  251. text.undo_block_start = undo.undo_block_start
  252. text.undo_block_stop = undo.undo_block_stop
  253. undo.set_saved_change_hook(self.saved_change_hook)
  254. # IOBinding implements file I/O and printing functionality
  255. self.io = io = self.IOBinding(self)
  256. io.set_filename_change_hook(self.filename_change_hook)
  257. self.good_load = False
  258. self.set_indentation_params(False)
  259. self.color = None # initialized below in self.ResetColorizer
  260. self.code_context = None # optionally initialized later below
  261. self.line_numbers = None # optionally initialized later below
  262. if filename:
  263. if os.path.exists(filename) and not os.path.isdir(filename):
  264. if io.loadfile(filename):
  265. self.good_load = True
  266. is_py_src = self.ispythonsource(filename)
  267. self.set_indentation_params(is_py_src)
  268. else:
  269. io.set_filename(filename)
  270. self.good_load = True
  271. self.ResetColorizer()
  272. self.saved_change_hook()
  273. self.update_recent_files_list()
  274. self.load_extensions()
  275. menu = self.menudict.get('window')
  276. if menu:
  277. end = menu.index("end")
  278. if end is None:
  279. end = -1
  280. if end >= 0:
  281. menu.add_separator()
  282. end = end + 1
  283. self.wmenu_end = end
  284. window.register_callback(self.postwindowsmenu)
  285. # Some abstractions so IDLE extensions are cross-IDE
  286. self.askinteger = simpledialog.askinteger
  287. self.askyesno = messagebox.askyesno
  288. self.showerror = messagebox.showerror
  289. # Add pseudoevents for former extension fixed keys.
  290. # (This probably needs to be done once in the process.)
  291. text.event_add('<<autocomplete>>', '<Key-Tab>')
  292. text.event_add('<<try-open-completions>>', '<KeyRelease-period>',
  293. '<KeyRelease-slash>', '<KeyRelease-backslash>')
  294. text.event_add('<<try-open-calltip>>', '<KeyRelease-parenleft>')
  295. text.event_add('<<refresh-calltip>>', '<KeyRelease-parenright>')
  296. text.event_add('<<paren-closed>>', '<KeyRelease-parenright>',
  297. '<KeyRelease-bracketright>', '<KeyRelease-braceright>')
  298. # Former extension bindings depends on frame.text being packed
  299. # (called from self.ResetColorizer()).
  300. autocomplete = self.AutoComplete(self, self.user_input_insert_tags)
  301. text.bind("<<autocomplete>>", autocomplete.autocomplete_event)
  302. text.bind("<<try-open-completions>>",
  303. autocomplete.try_open_completions_event)
  304. text.bind("<<force-open-completions>>",
  305. autocomplete.force_open_completions_event)
  306. text.bind("<<expand-word>>", self.AutoExpand(self).expand_word_event)
  307. text.bind("<<format-paragraph>>",
  308. self.FormatParagraph(self).format_paragraph_event)
  309. parenmatch = self.ParenMatch(self)
  310. text.bind("<<flash-paren>>", parenmatch.flash_paren_event)
  311. text.bind("<<paren-closed>>", parenmatch.paren_closed_event)
  312. scriptbinding = ScriptBinding(self)
  313. text.bind("<<check-module>>", scriptbinding.check_module_event)
  314. text.bind("<<run-module>>", scriptbinding.run_module_event)
  315. text.bind("<<run-custom>>", scriptbinding.run_custom_event)
  316. text.bind("<<do-rstrip>>", self.Rstrip(self).do_rstrip)
  317. self.ctip = ctip = self.Calltip(self)
  318. text.bind("<<try-open-calltip>>", ctip.try_open_calltip_event)
  319. #refresh-calltip must come after paren-closed to work right
  320. text.bind("<<refresh-calltip>>", ctip.refresh_calltip_event)
  321. text.bind("<<force-open-calltip>>", ctip.force_open_calltip_event)
  322. text.bind("<<zoom-height>>", self.ZoomHeight(self).zoom_height_event)
  323. if self.allow_code_context:
  324. self.code_context = self.CodeContext(self)
  325. text.bind("<<toggle-code-context>>",
  326. self.code_context.toggle_code_context_event)
  327. else:
  328. self.update_menu_state('options', '*ode*ontext', 'disabled')
  329. if self.allow_line_numbers:
  330. self.line_numbers = self.LineNumbers(self)
  331. if idleConf.GetOption('main', 'EditorWindow',
  332. 'line-numbers-default', type='bool'):
  333. self.toggle_line_numbers_event()
  334. text.bind("<<toggle-line-numbers>>", self.toggle_line_numbers_event)
  335. else:
  336. self.update_menu_state('options', '*ine*umbers', 'disabled')
  337. def handle_winconfig(self, event=None):
  338. self.set_width()
  339. def set_width(self):
  340. text = self.text
  341. inner_padding = sum(map(text.tk.getint, [text.cget('border'),
  342. text.cget('padx')]))
  343. pixel_width = text.winfo_width() - 2 * inner_padding
  344. # Divide the width of the Text widget by the font width,
  345. # which is taken to be the width of '0' (zero).
  346. # http://www.tcl.tk/man/tcl8.6/TkCmd/text.htm#M21
  347. zero_char_width = \
  348. Font(text, font=text.cget('font')).measure('0')
  349. self.width = pixel_width // zero_char_width
  350. def new_callback(self, event):
  351. dirname, basename = self.io.defaultfilename()
  352. self.flist.new(dirname)
  353. return "break"
  354. def home_callback(self, event):
  355. if (event.state & 4) != 0 and event.keysym == "Home":
  356. # state&4==Control. If <Control-Home>, use the Tk binding.
  357. return None
  358. if self.text.index("iomark") and \
  359. self.text.compare("iomark", "<=", "insert lineend") and \
  360. self.text.compare("insert linestart", "<=", "iomark"):
  361. # In Shell on input line, go to just after prompt
  362. insertpt = int(self.text.index("iomark").split(".")[1])
  363. else:
  364. line = self.text.get("insert linestart", "insert lineend")
  365. for insertpt in range(len(line)):
  366. if line[insertpt] not in (' ','\t'):
  367. break
  368. else:
  369. insertpt=len(line)
  370. lineat = int(self.text.index("insert").split('.')[1])
  371. if insertpt == lineat:
  372. insertpt = 0
  373. dest = "insert linestart+"+str(insertpt)+"c"
  374. if (event.state&1) == 0:
  375. # shift was not pressed
  376. self.text.tag_remove("sel", "1.0", "end")
  377. else:
  378. if not self.text.index("sel.first"):
  379. # there was no previous selection
  380. self.text.mark_set("my_anchor", "insert")
  381. else:
  382. if self.text.compare(self.text.index("sel.first"), "<",
  383. self.text.index("insert")):
  384. self.text.mark_set("my_anchor", "sel.first") # extend back
  385. else:
  386. self.text.mark_set("my_anchor", "sel.last") # extend forward
  387. first = self.text.index(dest)
  388. last = self.text.index("my_anchor")
  389. if self.text.compare(first,">",last):
  390. first,last = last,first
  391. self.text.tag_remove("sel", "1.0", "end")
  392. self.text.tag_add("sel", first, last)
  393. self.text.mark_set("insert", dest)
  394. self.text.see("insert")
  395. return "break"
  396. def set_status_bar(self):
  397. self.status_bar = self.MultiStatusBar(self.top)
  398. sep = Frame(self.top, height=1, borderwidth=1, background='grey75')
  399. if sys.platform == "darwin":
  400. # Insert some padding to avoid obscuring some of the statusbar
  401. # by the resize widget.
  402. self.status_bar.set_label('_padding1', ' ', side=RIGHT)
  403. self.status_bar.set_label('column', 'Col: ?', side=RIGHT)
  404. self.status_bar.set_label('line', 'Ln: ?', side=RIGHT)
  405. self.status_bar.pack(side=BOTTOM, fill=X)
  406. sep.pack(side=BOTTOM, fill=X)
  407. self.text.bind("<<set-line-and-column>>", self.set_line_and_column)
  408. self.text.event_add("<<set-line-and-column>>",
  409. "<KeyRelease>", "<ButtonRelease>")
  410. self.text.after_idle(self.set_line_and_column)
  411. def set_line_and_column(self, event=None):
  412. line, column = self.text.index(INSERT).split('.')
  413. self.status_bar.set_label('column', 'Col: %s' % column)
  414. self.status_bar.set_label('line', 'Ln: %s' % line)
  415. menu_specs = [
  416. ("file", "_File"),
  417. ("edit", "_Edit"),
  418. ("format", "F_ormat"),
  419. ("run", "_Run"),
  420. ("options", "_Options"),
  421. ("window", "_Window"),
  422. ("help", "_Help"),
  423. ]
  424. def createmenubar(self):
  425. mbar = self.menubar
  426. self.menudict = menudict = {}
  427. for name, label in self.menu_specs:
  428. underline, label = prepstr(label)
  429. postcommand = getattr(self, f'{name}_menu_postcommand', None)
  430. menudict[name] = menu = Menu(mbar, name=name, tearoff=0,
  431. postcommand=postcommand)
  432. mbar.add_cascade(label=label, menu=menu, underline=underline)
  433. if macosx.isCarbonTk():
  434. # Insert the application menu
  435. menudict['application'] = menu = Menu(mbar, name='apple',
  436. tearoff=0)
  437. mbar.add_cascade(label='IDLE', menu=menu)
  438. self.fill_menus()
  439. self.recent_files_menu = Menu(self.menubar, tearoff=0)
  440. self.menudict['file'].insert_cascade(3, label='Recent Files',
  441. underline=0,
  442. menu=self.recent_files_menu)
  443. self.base_helpmenu_length = self.menudict['help'].index(END)
  444. self.reset_help_menu_entries()
  445. def postwindowsmenu(self):
  446. # Only called when Window menu exists
  447. menu = self.menudict['window']
  448. end = menu.index("end")
  449. if end is None:
  450. end = -1
  451. if end > self.wmenu_end:
  452. menu.delete(self.wmenu_end+1, end)
  453. window.add_windows_to_menu(menu)
  454. def update_menu_label(self, menu, index, label):
  455. "Update label for menu item at index."
  456. menuitem = self.menudict[menu]
  457. menuitem.entryconfig(index, label=label)
  458. def update_menu_state(self, menu, index, state):
  459. "Update state for menu item at index."
  460. menuitem = self.menudict[menu]
  461. menuitem.entryconfig(index, state=state)
  462. def handle_yview(self, event, *args):
  463. "Handle scrollbar."
  464. if event == 'moveto':
  465. fraction = float(args[0])
  466. lines = (round(self.getlineno('end') * fraction) -
  467. self.getlineno('@0,0'))
  468. event = 'scroll'
  469. args = (lines, 'units')
  470. self.text.yview(event, *args)
  471. return 'break'
  472. rmenu = None
  473. def right_menu_event(self, event):
  474. text = self.text
  475. newdex = text.index(f'@{event.x},{event.y}')
  476. try:
  477. in_selection = (text.compare('sel.first', '<=', newdex) and
  478. text.compare(newdex, '<=', 'sel.last'))
  479. except TclError:
  480. in_selection = False
  481. if not in_selection:
  482. text.tag_remove("sel", "1.0", "end")
  483. text.mark_set("insert", newdex)
  484. if not self.rmenu:
  485. self.make_rmenu()
  486. rmenu = self.rmenu
  487. self.event = event
  488. iswin = sys.platform[:3] == 'win'
  489. if iswin:
  490. text.config(cursor="arrow")
  491. for item in self.rmenu_specs:
  492. try:
  493. label, eventname, verify_state = item
  494. except ValueError: # see issue1207589
  495. continue
  496. if verify_state is None:
  497. continue
  498. state = getattr(self, verify_state)()
  499. rmenu.entryconfigure(label, state=state)
  500. rmenu.tk_popup(event.x_root, event.y_root)
  501. if iswin:
  502. self.text.config(cursor="ibeam")
  503. return "break"
  504. rmenu_specs = [
  505. # ("Label", "<<virtual-event>>", "statefuncname"), ...
  506. ("Close", "<<close-window>>", None), # Example
  507. ]
  508. def make_rmenu(self):
  509. rmenu = Menu(self.text, tearoff=0)
  510. for item in self.rmenu_specs:
  511. label, eventname = item[0], item[1]
  512. if label is not None:
  513. def command(text=self.text, eventname=eventname):
  514. text.event_generate(eventname)
  515. rmenu.add_command(label=label, command=command)
  516. else:
  517. rmenu.add_separator()
  518. self.rmenu = rmenu
  519. def rmenu_check_cut(self):
  520. return self.rmenu_check_copy()
  521. def rmenu_check_copy(self):
  522. try:
  523. indx = self.text.index('sel.first')
  524. except TclError:
  525. return 'disabled'
  526. else:
  527. return 'normal' if indx else 'disabled'
  528. def rmenu_check_paste(self):
  529. try:
  530. self.text.tk.call('tk::GetSelection', self.text, 'CLIPBOARD')
  531. except TclError:
  532. return 'disabled'
  533. else:
  534. return 'normal'
  535. def about_dialog(self, event=None):
  536. "Handle Help 'About IDLE' event."
  537. # Synchronize with macosx.overrideRootMenu.about_dialog.
  538. help_about.AboutDialog(self.top)
  539. return "break"
  540. def config_dialog(self, event=None):
  541. "Handle Options 'Configure IDLE' event."
  542. # Synchronize with macosx.overrideRootMenu.config_dialog.
  543. configdialog.ConfigDialog(self.top,'Settings')
  544. return "break"
  545. def help_dialog(self, event=None):
  546. "Handle Help 'IDLE Help' event."
  547. # Synchronize with macosx.overrideRootMenu.help_dialog.
  548. if self.root:
  549. parent = self.root
  550. else:
  551. parent = self.top
  552. help.show_idlehelp(parent)
  553. return "break"
  554. def python_docs(self, event=None):
  555. if sys.platform[:3] == 'win':
  556. try:
  557. os.startfile(self.help_url)
  558. except OSError as why:
  559. messagebox.showerror(title='Document Start Failure',
  560. message=str(why), parent=self.text)
  561. else:
  562. webbrowser.open(self.help_url)
  563. return "break"
  564. def cut(self,event):
  565. self.text.event_generate("<<Cut>>")
  566. return "break"
  567. def copy(self,event):
  568. if not self.text.tag_ranges("sel"):
  569. # There is no selection, so do nothing and maybe interrupt.
  570. return None
  571. self.text.event_generate("<<Copy>>")
  572. return "break"
  573. def paste(self,event):
  574. self.text.event_generate("<<Paste>>")
  575. self.text.see("insert")
  576. return "break"
  577. def select_all(self, event=None):
  578. self.text.tag_add("sel", "1.0", "end-1c")
  579. self.text.mark_set("insert", "1.0")
  580. self.text.see("insert")
  581. return "break"
  582. def remove_selection(self, event=None):
  583. self.text.tag_remove("sel", "1.0", "end")
  584. self.text.see("insert")
  585. return "break"
  586. def move_at_edge_if_selection(self, edge_index):
  587. """Cursor move begins at start or end of selection
  588. When a left/right cursor key is pressed create and return to Tkinter a
  589. function which causes a cursor move from the associated edge of the
  590. selection.
  591. """
  592. self_text_index = self.text.index
  593. self_text_mark_set = self.text.mark_set
  594. edges_table = ("sel.first+1c", "sel.last-1c")
  595. def move_at_edge(event):
  596. if (event.state & 5) == 0: # no shift(==1) or control(==4) pressed
  597. try:
  598. self_text_index("sel.first")
  599. self_text_mark_set("insert", edges_table[edge_index])
  600. except TclError:
  601. pass
  602. return move_at_edge
  603. def del_word_left(self, event):
  604. self.text.event_generate('<Meta-Delete>')
  605. return "break"
  606. def del_word_right(self, event):
  607. self.text.event_generate('<Meta-d>')
  608. return "break"
  609. def find_event(self, event):
  610. search.find(self.text)
  611. return "break"
  612. def find_again_event(self, event):
  613. search.find_again(self.text)
  614. return "break"
  615. def find_selection_event(self, event):
  616. search.find_selection(self.text)
  617. return "break"
  618. def find_in_files_event(self, event):
  619. grep.grep(self.text, self.io, self.flist)
  620. return "break"
  621. def replace_event(self, event):
  622. replace.replace(self.text)
  623. return "break"
  624. def goto_line_event(self, event):
  625. text = self.text
  626. lineno = query.Goto(
  627. text, "Go To Line",
  628. "Enter a positive integer\n"
  629. "('big' = end of file):"
  630. ).result
  631. if lineno is not None:
  632. text.tag_remove("sel", "1.0", "end")
  633. text.mark_set("insert", f'{lineno}.0')
  634. text.see("insert")
  635. self.set_line_and_column()
  636. return "break"
  637. def open_module(self):
  638. """Get module name from user and open it.
  639. Return module path or None for calls by open_module_browser
  640. when latter is not invoked in named editor window.
  641. """
  642. # XXX This, open_module_browser, and open_path_browser
  643. # would fit better in iomenu.IOBinding.
  644. try:
  645. name = self.text.get("sel.first", "sel.last").strip()
  646. except TclError:
  647. name = ''
  648. file_path = query.ModuleName(
  649. self.text, "Open Module",
  650. "Enter the name of a Python module\n"
  651. "to search on sys.path and open:",
  652. name).result
  653. if file_path is not None:
  654. if self.flist:
  655. self.flist.open(file_path)
  656. else:
  657. self.io.loadfile(file_path)
  658. return file_path
  659. def open_module_event(self, event):
  660. self.open_module()
  661. return "break"
  662. def open_module_browser(self, event=None):
  663. filename = self.io.filename
  664. if not (self.__class__.__name__ == 'PyShellEditorWindow'
  665. and filename):
  666. filename = self.open_module()
  667. if filename is None:
  668. return "break"
  669. from idlelib import browser
  670. browser.ModuleBrowser(self.root, filename)
  671. return "break"
  672. def open_path_browser(self, event=None):
  673. from idlelib import pathbrowser
  674. pathbrowser.PathBrowser(self.root)
  675. return "break"
  676. def open_turtle_demo(self, event = None):
  677. import subprocess
  678. cmd = [sys.executable,
  679. '-c',
  680. 'from turtledemo.__main__ import main; main()']
  681. subprocess.Popen(cmd, shell=False)
  682. return "break"
  683. def gotoline(self, lineno):
  684. if lineno is not None and lineno > 0:
  685. self.text.mark_set("insert", "%d.0" % lineno)
  686. self.text.tag_remove("sel", "1.0", "end")
  687. self.text.tag_add("sel", "insert", "insert +1l")
  688. self.center()
  689. def ispythonsource(self, filename):
  690. if not filename or os.path.isdir(filename):
  691. return True
  692. base, ext = os.path.splitext(os.path.basename(filename))
  693. if os.path.normcase(ext) in py_extensions:
  694. return True
  695. line = self.text.get('1.0', '1.0 lineend')
  696. return line.startswith('#!') and 'python' in line
  697. def close_hook(self):
  698. if self.flist:
  699. self.flist.unregister_maybe_terminate(self)
  700. self.flist = None
  701. def set_close_hook(self, close_hook):
  702. self.close_hook = close_hook
  703. def filename_change_hook(self):
  704. if self.flist:
  705. self.flist.filename_changed_edit(self)
  706. self.saved_change_hook()
  707. self.top.update_windowlist_registry(self)
  708. self.ResetColorizer()
  709. def _addcolorizer(self):
  710. if self.color:
  711. return
  712. if self.ispythonsource(self.io.filename):
  713. self.color = self.ColorDelegator()
  714. # can add more colorizers here...
  715. if self.color:
  716. self.per.insertfilterafter(filter=self.color, after=self.undo)
  717. def _rmcolorizer(self):
  718. if not self.color:
  719. return
  720. self.color.removecolors()
  721. self.per.removefilter(self.color)
  722. self.color = None
  723. def ResetColorizer(self):
  724. "Update the color theme"
  725. # Called from self.filename_change_hook and from configdialog.py
  726. self._rmcolorizer()
  727. self._addcolorizer()
  728. EditorWindow.color_config(self.text)
  729. if self.code_context is not None:
  730. self.code_context.update_highlight_colors()
  731. if self.line_numbers is not None:
  732. self.line_numbers.update_colors()
  733. IDENTCHARS = string.ascii_letters + string.digits + "_"
  734. def colorize_syntax_error(self, text, pos):
  735. text.tag_add("ERROR", pos)
  736. char = text.get(pos)
  737. if char and char in self.IDENTCHARS:
  738. text.tag_add("ERROR", pos + " wordstart", pos)
  739. if '\n' == text.get(pos): # error at line end
  740. text.mark_set("insert", pos)
  741. else:
  742. text.mark_set("insert", pos + "+1c")
  743. text.see(pos)
  744. def update_cursor_blink(self):
  745. "Update the cursor blink configuration."
  746. cursorblink = idleConf.GetOption(
  747. 'main', 'EditorWindow', 'cursor-blink', type='bool')
  748. if not cursorblink:
  749. self.text['insertofftime'] = 0
  750. else:
  751. # Restore the original value
  752. self.text['insertofftime'] = idleConf.blink_off_time
  753. def ResetFont(self):
  754. "Update the text widgets' font if it is changed"
  755. # Called from configdialog.py
  756. # Update the code context widget first, since its height affects
  757. # the height of the text widget. This avoids double re-rendering.
  758. if self.code_context is not None:
  759. self.code_context.update_font()
  760. # Next, update the line numbers widget, since its width affects
  761. # the width of the text widget.
  762. if self.line_numbers is not None:
  763. self.line_numbers.update_font()
  764. # Finally, update the main text widget.
  765. new_font = idleConf.GetFont(self.root, 'main', 'EditorWindow')
  766. self.text['font'] = new_font
  767. self.set_width()
  768. def RemoveKeybindings(self):
  769. "Remove the keybindings before they are changed."
  770. # Called from configdialog.py
  771. self.mainmenu.default_keydefs = keydefs = idleConf.GetCurrentKeySet()
  772. for event, keylist in keydefs.items():
  773. self.text.event_delete(event, *keylist)
  774. for extensionName in self.get_standard_extension_names():
  775. xkeydefs = idleConf.GetExtensionBindings(extensionName)
  776. if xkeydefs:
  777. for event, keylist in xkeydefs.items():
  778. self.text.event_delete(event, *keylist)
  779. def ApplyKeybindings(self):
  780. "Update the keybindings after they are changed"
  781. # Called from configdialog.py
  782. self.mainmenu.default_keydefs = keydefs = idleConf.GetCurrentKeySet()
  783. self.apply_bindings()
  784. for extensionName in self.get_standard_extension_names():
  785. xkeydefs = idleConf.GetExtensionBindings(extensionName)
  786. if xkeydefs:
  787. self.apply_bindings(xkeydefs)
  788. #update menu accelerators
  789. menuEventDict = {}
  790. for menu in self.mainmenu.menudefs:
  791. menuEventDict[menu[0]] = {}
  792. for item in menu[1]:
  793. if item:
  794. menuEventDict[menu[0]][prepstr(item[0])[1]] = item[1]
  795. for menubarItem in self.menudict:
  796. menu = self.menudict[menubarItem]
  797. end = menu.index(END)
  798. if end is None:
  799. # Skip empty menus
  800. continue
  801. end += 1
  802. for index in range(0, end):
  803. if menu.type(index) == 'command':
  804. accel = menu.entrycget(index, 'accelerator')
  805. if accel:
  806. itemName = menu.entrycget(index, 'label')
  807. event = ''
  808. if menubarItem in menuEventDict:
  809. if itemName in menuEventDict[menubarItem]:
  810. event = menuEventDict[menubarItem][itemName]
  811. if event:
  812. accel = get_accelerator(keydefs, event)
  813. menu.entryconfig(index, accelerator=accel)
  814. def set_notabs_indentwidth(self):
  815. "Update the indentwidth if changed and not using tabs in this window"
  816. # Called from configdialog.py
  817. if not self.usetabs:
  818. self.indentwidth = idleConf.GetOption('main', 'Indent','num-spaces',
  819. type='int')
  820. def reset_help_menu_entries(self):
  821. "Update the additional help entries on the Help menu"
  822. help_list = idleConf.GetAllExtraHelpSourcesList()
  823. helpmenu = self.menudict['help']
  824. # first delete the extra help entries, if any
  825. helpmenu_length = helpmenu.index(END)
  826. if helpmenu_length > self.base_helpmenu_length:
  827. helpmenu.delete((self.base_helpmenu_length + 1), helpmenu_length)
  828. # then rebuild them
  829. if help_list:
  830. helpmenu.add_separator()
  831. for entry in help_list:
  832. cmd = self.__extra_help_callback(entry[1])
  833. helpmenu.add_command(label=entry[0], command=cmd)
  834. # and update the menu dictionary
  835. self.menudict['help'] = helpmenu
  836. def __extra_help_callback(self, helpfile):
  837. "Create a callback with the helpfile value frozen at definition time"
  838. def display_extra_help(helpfile=helpfile):
  839. if not helpfile.startswith(('www', 'http')):
  840. helpfile = os.path.normpath(helpfile)
  841. if sys.platform[:3] == 'win':
  842. try:
  843. os.startfile(helpfile)
  844. except OSError as why:
  845. messagebox.showerror(title='Document Start Failure',
  846. message=str(why), parent=self.text)
  847. else:
  848. webbrowser.open(helpfile)
  849. return display_extra_help
  850. def update_recent_files_list(self, new_file=None):
  851. "Load and update the recent files list and menus"
  852. # TODO: move to iomenu.
  853. rf_list = []
  854. file_path = self.recent_files_path
  855. if file_path and os.path.exists(file_path):
  856. with open(file_path, 'r',
  857. encoding='utf_8', errors='replace') as rf_list_file:
  858. rf_list = rf_list_file.readlines()
  859. if new_file:
  860. new_file = os.path.abspath(new_file) + '\n'
  861. if new_file in rf_list:
  862. rf_list.remove(new_file) # move to top
  863. rf_list.insert(0, new_file)
  864. # clean and save the recent files list
  865. bad_paths = []
  866. for path in rf_list:
  867. if '\0' in path or not os.path.exists(path[0:-1]):
  868. bad_paths.append(path)
  869. rf_list = [path for path in rf_list if path not in bad_paths]
  870. ulchars = "1234567890ABCDEFGHIJK"
  871. rf_list = rf_list[0:len(ulchars)]
  872. if file_path:
  873. try:
  874. with open(file_path, 'w',
  875. encoding='utf_8', errors='replace') as rf_file:
  876. rf_file.writelines(rf_list)
  877. except OSError as err:
  878. if not getattr(self.root, "recentfiles_message", False):
  879. self.root.recentfiles_message = True
  880. messagebox.showwarning(title='IDLE Warning',
  881. message="Cannot save Recent Files list to disk.\n"
  882. f" {err}\n"
  883. "Select OK to continue.",
  884. parent=self.text)
  885. # for each edit window instance, construct the recent files menu
  886. for instance in self.top.instance_dict:
  887. menu = instance.recent_files_menu
  888. menu.delete(0, END) # clear, and rebuild:
  889. for i, file_name in enumerate(rf_list):
  890. file_name = file_name.rstrip() # zap \n
  891. callback = instance.__recent_file_callback(file_name)
  892. menu.add_command(label=ulchars[i] + " " + file_name,
  893. command=callback,
  894. underline=0)
  895. def __recent_file_callback(self, file_name):
  896. def open_recent_file(fn_closure=file_name):
  897. self.io.open(editFile=fn_closure)
  898. return open_recent_file
  899. def saved_change_hook(self):
  900. short = self.short_title()
  901. long = self.long_title()
  902. if short and long:
  903. title = short + " - " + long + _py_version
  904. elif short:
  905. title = short
  906. elif long:
  907. title = long
  908. else:
  909. title = "untitled"
  910. icon = short or long or title
  911. if not self.get_saved():
  912. title = "*%s*" % title
  913. icon = "*%s" % icon
  914. self.top.wm_title(title)
  915. self.top.wm_iconname(icon)
  916. def get_saved(self):
  917. return self.undo.get_saved()
  918. def set_saved(self, flag):
  919. self.undo.set_saved(flag)
  920. def reset_undo(self):
  921. self.undo.reset_undo()
  922. def short_title(self):
  923. filename = self.io.filename
  924. return os.path.basename(filename) if filename else "untitled"
  925. def long_title(self):
  926. return self.io.filename or ""
  927. def center_insert_event(self, event):
  928. self.center()
  929. return "break"
  930. def center(self, mark="insert"):
  931. text = self.text
  932. top, bot = self.getwindowlines()
  933. lineno = self.getlineno(mark)
  934. height = bot - top
  935. newtop = max(1, lineno - height//2)
  936. text.yview(float(newtop))
  937. def getwindowlines(self):
  938. text = self.text
  939. top = self.getlineno("@0,0")
  940. bot = self.getlineno("@0,65535")
  941. if top == bot and text.winfo_height() == 1:
  942. # Geometry manager hasn't run yet
  943. height = int(text['height'])
  944. bot = top + height - 1
  945. return top, bot
  946. def getlineno(self, mark="insert"):
  947. text = self.text
  948. return int(float(text.index(mark)))
  949. def get_geometry(self):
  950. "Return (width, height, x, y)"
  951. geom = self.top.wm_geometry()
  952. m = re.match(r"(\d+)x(\d+)\+(-?\d+)\+(-?\d+)", geom)
  953. return list(map(int, m.groups()))
  954. def close_event(self, event):
  955. self.close()
  956. return "break"
  957. def maybesave(self):
  958. if self.io:
  959. if not self.get_saved():
  960. if self.top.state()!='normal':
  961. self.top.deiconify()
  962. self.top.lower()
  963. self.top.lift()
  964. return self.io.maybesave()
  965. def close(self):
  966. try:
  967. reply = self.maybesave()
  968. if str(reply) != "cancel":
  969. self._close()
  970. return reply
  971. except AttributeError: # bpo-35379: close called twice
  972. pass
  973. def _close(self):
  974. if self.io.filename:
  975. self.update_recent_files_list(new_file=self.io.filename)
  976. window.unregister_callback(self.postwindowsmenu)
  977. self.unload_extensions()
  978. self.io.close()
  979. self.io = None
  980. self.undo = None
  981. if self.color:
  982. self.color.close()
  983. self.color = None
  984. self.text = None
  985. self.tkinter_vars = None
  986. self.per.close()
  987. self.per = None
  988. self.top.destroy()
  989. if self.close_hook:
  990. # unless override: unregister from flist, terminate if last window
  991. self.close_hook()
  992. def load_extensions(self):
  993. self.extensions = {}
  994. self.load_standard_extensions()
  995. def unload_extensions(self):
  996. for ins in list(self.extensions.values()):
  997. if hasattr(ins, "close"):
  998. ins.close()
  999. self.extensions = {}
  1000. def load_standard_extensions(self):
  1001. for name in self.get_standard_extension_names():
  1002. try:
  1003. self.load_extension(name)
  1004. except:
  1005. print("Failed to load extension", repr(name))
  1006. traceback.print_exc()
  1007. def get_standard_extension_names(self):
  1008. return idleConf.GetExtensions(editor_only=True)
  1009. extfiles = { # Map built-in config-extension section names to file names.
  1010. 'ZzDummy': 'zzdummy',
  1011. }
  1012. def load_extension(self, name):
  1013. fname = self.extfiles.get(name, name)
  1014. try:
  1015. try:
  1016. mod = importlib.import_module('.' + fname, package=__package__)
  1017. except (ImportError, TypeError):
  1018. mod = importlib.import_module(fname)
  1019. except ImportError:
  1020. print("\nFailed to import extension: ", name)
  1021. raise
  1022. cls = getattr(mod, name)
  1023. keydefs = idleConf.GetExtensionBindings(name)
  1024. if hasattr(cls, "menudefs"):
  1025. self.fill_menus(cls.menudefs, keydefs)
  1026. ins = cls(self)
  1027. self.extensions[name] = ins
  1028. if keydefs:
  1029. self.apply_bindings(keydefs)
  1030. for vevent in keydefs:
  1031. methodname = vevent.replace("-", "_")
  1032. while methodname[:1] == '<':
  1033. methodname = methodname[1:]
  1034. while methodname[-1:] == '>':
  1035. methodname = methodname[:-1]
  1036. methodname = methodname + "_event"
  1037. if hasattr(ins, methodname):
  1038. self.text.bind(vevent, getattr(ins, methodname))
  1039. def apply_bindings(self, keydefs=None):
  1040. if keydefs is None:
  1041. keydefs = self.mainmenu.default_keydefs
  1042. text = self.text
  1043. text.keydefs = keydefs
  1044. for event, keylist in keydefs.items():
  1045. if keylist:
  1046. text.event_add(event, *keylist)
  1047. def fill_menus(self, menudefs=None, keydefs=None):
  1048. """Add appropriate entries to the menus and submenus
  1049. Menus that are absent or None in self.menudict are ignored.
  1050. """
  1051. if menudefs is None:
  1052. menudefs = self.mainmenu.menudefs
  1053. if keydefs is None:
  1054. keydefs = self.mainmenu.default_keydefs
  1055. menudict = self.menudict
  1056. text = self.text
  1057. for mname, entrylist in menudefs:
  1058. menu = menudict.get(mname)
  1059. if not menu:
  1060. continue
  1061. for entry in entrylist:
  1062. if not entry:
  1063. menu.add_separator()
  1064. else:
  1065. label, eventname = entry
  1066. checkbutton = (label[:1] == '!')
  1067. if checkbutton:
  1068. label = label[1:]
  1069. underline, label = prepstr(label)
  1070. accelerator = get_accelerator(keydefs, eventname)
  1071. def command(text=text, eventname=eventname):
  1072. text.event_generate(eventname)
  1073. if checkbutton:
  1074. var = self.get_var_obj(eventname, BooleanVar)
  1075. menu.add_checkbutton(label=label, underline=underline,
  1076. command=command, accelerator=accelerator,
  1077. variable=var)
  1078. else:
  1079. menu.add_command(label=label, underline=underline,
  1080. command=command,
  1081. accelerator=accelerator)
  1082. def getvar(self, name):
  1083. var = self.get_var_obj(name)
  1084. if var:
  1085. value = var.get()
  1086. return value
  1087. else:
  1088. raise NameError(name)
  1089. def setvar(self, name, value, vartype=None):
  1090. var = self.get_var_obj(name, vartype)
  1091. if var:
  1092. var.set(value)
  1093. else:
  1094. raise NameError(name)
  1095. def get_var_obj(self, name, vartype=None):
  1096. var = self.tkinter_vars.get(name)
  1097. if not var and vartype:
  1098. # create a Tkinter variable object with self.text as master:
  1099. self.tkinter_vars[name] = var = vartype(self.text)
  1100. return var
  1101. # Tk implementations of "virtual text methods" -- each platform
  1102. # reusing IDLE's support code needs to define these for its GUI's
  1103. # flavor of widget.
  1104. # Is character at text_index in a Python string? Return 0 for
  1105. # "guaranteed no", true for anything else. This info is expensive
  1106. # to compute ab initio, but is probably already known by the
  1107. # platform's colorizer.
  1108. def is_char_in_string(self, text_index):
  1109. if self.color:
  1110. # Return true iff colorizer hasn't (re)gotten this far
  1111. # yet, or the character is tagged as being in a string
  1112. return self.text.tag_prevrange("TODO", text_index) or \
  1113. "STRING" in self.text.tag_names(text_index)
  1114. else:
  1115. # The colorizer is missing: assume the worst
  1116. return 1
  1117. # If a selection is defined in the text widget, return (start,
  1118. # end) as Tkinter text indices, otherwise return (None, None)
  1119. def get_selection_indices(self):
  1120. try:
  1121. first = self.text.index("sel.first")
  1122. last = self.text.index("sel.last")
  1123. return first, last
  1124. except TclError:
  1125. return None, None
  1126. # Return the text widget's current view of what a tab stop means
  1127. # (equivalent width in spaces).
  1128. def get_tk_tabwidth(self):
  1129. current = self.text['tabs'] or TK_TABWIDTH_DEFAULT
  1130. return int(current)
  1131. # Set the text widget's current view of what a tab stop means.
  1132. def set_tk_tabwidth(self, newtabwidth):
  1133. text = self.text
  1134. if self.get_tk_tabwidth() != newtabwidth:
  1135. # Set text widget tab width
  1136. pixels = text.tk.call("font", "measure", text["font"],
  1137. "-displayof", text.master,
  1138. "n" * newtabwidth)
  1139. text.configure(tabs=pixels)
  1140. ### begin autoindent code ### (configuration was moved to beginning of class)
  1141. def set_indentation_params(self, is_py_src, guess=True):
  1142. if is_py_src and guess:
  1143. i = self.guess_indent()
  1144. if 2 <= i <= 8:
  1145. self.indentwidth = i
  1146. if self.indentwidth != self.tabwidth:
  1147. self.usetabs = False
  1148. self.set_tk_tabwidth(self.tabwidth)
  1149. def smart_backspace_event(self, event):
  1150. text = self.text
  1151. first, last = self.get_selection_indices()
  1152. if first and last:
  1153. text.delete(first, last)
  1154. text.mark_set("insert", first)
  1155. return "break"
  1156. # Delete whitespace left, until hitting a real char or closest
  1157. # preceding virtual tab stop.
  1158. chars = text.get("insert linestart", "insert")
  1159. if chars == '':
  1160. if text.compare("insert", ">", "1.0"):
  1161. # easy: delete preceding newline
  1162. text.delete("insert-1c")
  1163. else:
  1164. text.bell() # at start of buffer
  1165. return "break"
  1166. if chars[-1] not in " \t":
  1167. # easy: delete preceding real char
  1168. text.delete("insert-1c")
  1169. return "break"
  1170. # Ick. It may require *inserting* spaces if we back up over a
  1171. # tab character! This is written to be clear, not fast.
  1172. tabwidth = self.tabwidth
  1173. have = len(chars.expandtabs(tabwidth))
  1174. assert have > 0
  1175. want = ((have - 1) // self.indentwidth) * self.indentwidth
  1176. # Debug prompt is multilined....
  1177. ncharsdeleted = 0
  1178. while True:
  1179. chars = chars[:-1]
  1180. ncharsdeleted = ncharsdeleted + 1
  1181. have = len(chars.expandtabs(tabwidth))
  1182. if have <= want or chars[-1] not in " \t":
  1183. break
  1184. text.undo_block_start()
  1185. text.delete("insert-%dc" % ncharsdeleted, "insert")
  1186. if have < want:
  1187. text.insert("insert", ' ' * (want - have),
  1188. self.user_input_insert_tags)
  1189. text.undo_block_stop()
  1190. return "break"
  1191. def smart_indent_event(self, event):
  1192. # if intraline selection:
  1193. # delete it
  1194. # elif multiline selection:
  1195. # do indent-region
  1196. # else:
  1197. # indent one level
  1198. text = self.text
  1199. first, last = self.get_selection_indices()
  1200. text.undo_block_start()
  1201. try:
  1202. if first and last:
  1203. if index2line(first) != index2line(last):
  1204. return self.fregion.indent_region_event(event)
  1205. text.delete(first, last)
  1206. text.mark_set("insert", first)
  1207. prefix = text.get("insert linestart", "insert")
  1208. raw, effective = get_line_indent(prefix, self.tabwidth)
  1209. if raw == len(prefix):
  1210. # only whitespace to the left
  1211. self.reindent_to(effective + self.indentwidth)
  1212. else:
  1213. # tab to the next 'stop' within or to right of line's text:
  1214. if self.usetabs:
  1215. pad = '\t'
  1216. else:
  1217. effective = len(prefix.expandtabs(self.tabwidth))
  1218. n = self.indentwidth
  1219. pad = ' ' * (n - effective % n)
  1220. text.insert("insert", pad, self.user_input_insert_tags)
  1221. text.see("insert")
  1222. return "break"
  1223. finally:
  1224. text.undo_block_stop()
  1225. def newline_and_indent_event(self, event):
  1226. """Insert a newline and indentation after Enter keypress event.
  1227. Properly position the cursor on the new line based on information
  1228. from the current line. This takes into account if the current line
  1229. is a shell prompt, is empty, has selected text, contains a block
  1230. opener, contains a block closer, is a continuation line, or
  1231. is inside a string.
  1232. """
  1233. text = self.text
  1234. first, last = self.get_selection_indices()
  1235. text.undo_block_start()
  1236. try: # Close undo block and expose new line in finally clause.
  1237. if first and last:
  1238. text.delete(first, last)
  1239. text.mark_set("insert", first)
  1240. line = text.get("insert linestart", "insert")
  1241. # Count leading whitespace for indent size.
  1242. i, n = 0, len(line)
  1243. while i < n and line[i] in " \t":
  1244. i += 1
  1245. if i == n:
  1246. # The cursor is in or at leading indentation in a continuation
  1247. # line; just inject an empty line at the start.
  1248. text.insert("insert linestart", '\n',
  1249. self.user_input_insert_tags)
  1250. return "break"
  1251. indent = line[:i]
  1252. # Strip whitespace before insert point unless it's in the prompt.
  1253. i = 0
  1254. while line and line[-1] in " \t":
  1255. line = line[:-1]
  1256. i += 1
  1257. if i:
  1258. text.delete("insert - %d chars" % i, "insert")
  1259. # Strip whitespace after insert point.
  1260. while text.get("insert") in " \t":
  1261. text.delete("insert")
  1262. # Insert new line.
  1263. text.insert("insert", '\n', self.user_input_insert_tags)
  1264. # Adjust indentation for continuations and block open/close.
  1265. # First need to find the last statement.
  1266. lno = index2line(text.index('insert'))
  1267. y = pyparse.Parser(self.indentwidth, self.tabwidth)
  1268. if not self.prompt_last_line:
  1269. for context in self.num_context_lines:
  1270. startat = max(lno - context, 1)
  1271. startatindex = repr(startat) + ".0"
  1272. rawtext = text.get(startatindex, "insert")
  1273. y.set_code(rawtext)
  1274. bod = y.find_good_parse_start(
  1275. self._build_char_in_string_func(startatindex))
  1276. if bod is not None or startat == 1:
  1277. break
  1278. y.set_lo(bod or 0)
  1279. else:
  1280. r = text.tag_prevrange("console", "insert")
  1281. if r:
  1282. startatindex = r[1]
  1283. else:
  1284. startatindex = "1.0"
  1285. rawtext = text.get(startatindex, "insert")
  1286. y.set_code(rawtext)
  1287. y.set_lo(0)
  1288. c = y.get_continuation_type()
  1289. if c != pyparse.C_NONE:
  1290. # The current statement hasn't ended yet.
  1291. if c == pyparse.C_STRING_FIRST_LINE:
  1292. # After the first line of a string do not indent at all.
  1293. pass
  1294. elif c == pyparse.C_STRING_NEXT_LINES:
  1295. # Inside a string which started before this line;
  1296. # just mimic the current indent.
  1297. text.insert("insert", indent, self.user_input_insert_tags)
  1298. elif c == pyparse.C_BRACKET:
  1299. # Line up with the first (if any) element of the
  1300. # last open bracket structure; else indent one
  1301. # level beyond the indent of the line with the
  1302. # last open bracket.
  1303. self.reindent_to(y.compute_bracket_indent())
  1304. elif c == pyparse.C_BACKSLASH:
  1305. # If more than one line in this statement already, just
  1306. # mimic the current indent; else if initial line
  1307. # has a start on an assignment stmt, indent to
  1308. # beyond leftmost =; else to beyond first chunk of
  1309. # non-whitespace on initial line.
  1310. if y.get_num_lines_in_stmt() > 1:
  1311. text.insert("insert", indent,
  1312. self.user_input_insert_tags)
  1313. else:
  1314. self.reindent_to(y.compute_backslash_indent())
  1315. else:
  1316. assert 0, "bogus continuation type %r" % (c,)
  1317. return "break"
  1318. # This line starts a brand new statement; indent relative to
  1319. # indentation of initial line of closest preceding
  1320. # interesting statement.
  1321. indent = y.get_base_indent_string()
  1322. text.insert("insert", indent, self.user_input_insert_tags)
  1323. if y.is_block_opener():
  1324. self.smart_indent_event(event)
  1325. elif indent and y.is_block_closer():
  1326. self.smart_backspace_event(event)
  1327. return "break"
  1328. finally:
  1329. text.see("insert")
  1330. text.undo_block_stop()
  1331. # Our editwin provides an is_char_in_string function that works
  1332. # with a Tk text index, but PyParse only knows about offsets into
  1333. # a string. This builds a function for PyParse that accepts an
  1334. # offset.
  1335. def _build_char_in_string_func(self, startindex):
  1336. def inner(offset, _startindex=startindex,
  1337. _icis=self.is_char_in_string):
  1338. return _icis(_startindex + "+%dc" % offset)
  1339. return inner
  1340. # XXX this isn't bound to anything -- see tabwidth comments
  1341. ## def change_tabwidth_event(self, event):
  1342. ## new = self._asktabwidth()
  1343. ## if new != self.tabwidth:
  1344. ## self.tabwidth = new
  1345. ## self.set_indentation_params(0, guess=0)
  1346. ## return "break"
  1347. # Make string that displays as n leading blanks.
  1348. def _make_blanks(self, n):
  1349. if self.usetabs:
  1350. ntabs, nspaces = divmod(n, self.tabwidth)
  1351. return '\t' * ntabs + ' ' * nspaces
  1352. else:
  1353. return ' ' * n
  1354. # Delete from beginning of line to insert point, then reinsert
  1355. # column logical (meaning use tabs if appropriate) spaces.
  1356. def reindent_to(self, column):
  1357. text = self.text
  1358. text.undo_block_start()
  1359. if text.compare("insert linestart", "!=", "insert"):
  1360. text.delete("insert linestart", "insert")
  1361. if column:
  1362. text.insert("insert", self._make_blanks(column),
  1363. self.user_input_insert_tags)
  1364. text.undo_block_stop()
  1365. # Guess indentwidth from text content.
  1366. # Return guessed indentwidth. This should not be believed unless
  1367. # it's in a reasonable range (e.g., it will be 0 if no indented
  1368. # blocks are found).
  1369. def guess_indent(self):
  1370. opener, indented = IndentSearcher(self.text, self.tabwidth).run()
  1371. if opener and indented:
  1372. raw, indentsmall = get_line_indent(opener, self.tabwidth)
  1373. raw, indentlarge = get_line_indent(indented, self.tabwidth)
  1374. else:
  1375. indentsmall = indentlarge = 0
  1376. return indentlarge - indentsmall
  1377. def toggle_line_numbers_event(self, event=None):
  1378. if self.line_numbers is None:
  1379. return
  1380. if self.line_numbers.is_shown:
  1381. self.line_numbers.hide_sidebar()
  1382. menu_label = "Show"
  1383. else:
  1384. self.line_numbers.show_sidebar()
  1385. menu_label = "Hide"
  1386. self.update_menu_label(menu='options', index='*ine*umbers',
  1387. label=f'{menu_label} Line Numbers')
  1388. # "line.col" -> line, as an int
  1389. def index2line(index):
  1390. return int(float(index))
  1391. _line_indent_re = re.compile(r'[ \t]*')
  1392. def get_line_indent(line, tabwidth):
  1393. """Return a line's indentation as (# chars, effective # of spaces).
  1394. The effective # of spaces is the length after properly "expanding"
  1395. the tabs into spaces, as done by str.expandtabs(tabwidth).
  1396. """
  1397. m = _line_indent_re.match(line)
  1398. return m.end(), len(m.group().expandtabs(tabwidth))
  1399. class IndentSearcher:
  1400. # .run() chews over the Text widget, looking for a block opener
  1401. # and the stmt following it. Returns a pair,
  1402. # (line containing block opener, line containing stmt)
  1403. # Either or both may be None.
  1404. def __init__(self, text, tabwidth):
  1405. self.text = text
  1406. self.tabwidth = tabwidth
  1407. self.i = self.finished = 0
  1408. self.blkopenline = self.indentedline = None
  1409. def readline(self):
  1410. if self.finished:
  1411. return ""
  1412. i = self.i = self.i + 1
  1413. mark = repr(i) + ".0"
  1414. if self.text.compare(mark, ">=", "end"):
  1415. return ""
  1416. return self.text.get(mark, mark + " lineend+1c")
  1417. def tokeneater(self, type, token, start, end, line,
  1418. INDENT=tokenize.INDENT,
  1419. NAME=tokenize.NAME,
  1420. OPENERS=('class', 'def', 'for', 'if', 'try', 'while')):
  1421. if self.finished:
  1422. pass
  1423. elif type == NAME and token in OPENERS:
  1424. self.blkopenline = line
  1425. elif type == INDENT and self.blkopenline:
  1426. self.indentedline = line
  1427. self.finished = 1
  1428. def run(self):
  1429. save_tabsize = tokenize.tabsize
  1430. tokenize.tabsize = self.tabwidth
  1431. try:
  1432. try:
  1433. tokens = tokenize.generate_tokens(self.readline)
  1434. for token in tokens:
  1435. self.tokeneater(*token)
  1436. except (tokenize.TokenError, SyntaxError):
  1437. # since we cut off the tokenizer early, we can trigger
  1438. # spurious errors
  1439. pass
  1440. finally:
  1441. tokenize.tabsize = save_tabsize
  1442. return self.blkopenline, self.indentedline
  1443. ### end autoindent code ###
  1444. def prepstr(s):
  1445. # Helper to extract the underscore from a string, e.g.
  1446. # prepstr("Co_py") returns (2, "Copy").
  1447. i = s.find('_')
  1448. if i >= 0:
  1449. s = s[:i] + s[i+1:]
  1450. return i, s
  1451. keynames = {
  1452. 'bracketleft': '[',
  1453. 'bracketright': ']',
  1454. 'slash': '/',
  1455. }
  1456. def get_accelerator(keydefs, eventname):
  1457. keylist = keydefs.get(eventname)
  1458. # issue10940: temporary workaround to prevent hang with OS X Cocoa Tk 8.5
  1459. # if not keylist:
  1460. if (not keylist) or (macosx.isCocoaTk() and eventname in {
  1461. "<<open-module>>",
  1462. "<<goto-line>>",
  1463. "<<change-indentwidth>>"}):
  1464. return ""
  1465. s = keylist[0]
  1466. s = re.sub(r"-[a-z]\b", lambda m: m.group().upper(), s)
  1467. s = re.sub(r"\b\w+\b", lambda m: keynames.get(m.group(), m.group()), s)
  1468. s = re.sub("Key-", "", s)
  1469. s = re.sub("Cancel","Ctrl-Break",s) # dscherer@cmu.edu
  1470. s = re.sub("Control-", "Ctrl-", s)
  1471. s = re.sub("-", "+", s)
  1472. s = re.sub("><", " ", s)
  1473. s = re.sub("<", "", s)
  1474. s = re.sub(">", "", s)
  1475. return s
  1476. def fixwordbreaks(root):
  1477. # On Windows, tcl/tk breaks 'words' only on spaces, as in Command Prompt.
  1478. # We want Motif style everywhere. See #21474, msg218992 and followup.
  1479. tk = root.tk
  1480. tk.call('tcl_wordBreakAfter', 'a b', 0) # make sure word.tcl is loaded
  1481. tk.call('set', 'tcl_wordchars', r'\w')
  1482. tk.call('set', 'tcl_nonwordchars', r'\W')
  1483. def _editor_window(parent): # htest #
  1484. # error if close master window first - timer event, after script
  1485. root = parent
  1486. fixwordbreaks(root)
  1487. if sys.argv[1:]:
  1488. filename = sys.argv[1]
  1489. else:
  1490. filename = None
  1491. macosx.setupApp(root, None)
  1492. edit = EditorWindow(root=root, filename=filename)
  1493. text = edit.text
  1494. text['height'] = 10
  1495. for i in range(20):
  1496. text.insert('insert', ' '*i + str(i) + '\n')
  1497. # text.bind("<<close-all-windows>>", edit.close_event)
  1498. # Does not stop error, neither does following
  1499. # edit.text.bind("<<close-window>>", edit.close_event)
  1500. if __name__ == '__main__':
  1501. from unittest import main
  1502. main('idlelib.idle_test.test_editor', verbosity=2, exit=False)
  1503. from idlelib.idle_test.htest import run
  1504. run(_editor_window)