Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 1 | """ |
| 2 | Dialogs that query users and verify the answer before accepting. |
| 3 | Use ttk widgets, limiting use to tcl/tk 8.5+, as in IDLE 3.6+. |
| 4 | |
| 5 | Query is the generic base class for a popup dialog. |
| 6 | The user must either enter a valid answer or close the dialog. |
| 7 | Entries are validated when <Return> is entered or [Ok] is clicked. |
| 8 | Entries are ignored when [Cancel] or [X] are clicked. |
| 9 | The 'return value' is .result set to either a valid answer or None. |
| 10 | |
| 11 | Subclass SectionName gets a name for a new config file section. |
| 12 | Configdialog uses it for new highlight theme and keybinding set names. |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 13 | Subclass ModuleName gets a name for File => Open Module. |
| 14 | Subclass HelpSource gets menu item and path for additions to Help menu. |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 15 | """ |
| 16 | # Query and Section name result from splitting GetCfgSectionNameDialog |
| 17 | # of configSectionNameDialog.py (temporarily config_sec.py) into |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 18 | # generic and specific parts. 3.6 only, July 2016. |
| 19 | # ModuleName.entry_ok came from editor.EditorWindow.load_module. |
| 20 | # HelpSource was extracted from configHelpSourceEdit.py (temporarily |
| 21 | # config_help.py), with darwin code moved from ok to path_ok. |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 22 | |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 23 | import importlib |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 24 | import os |
| 25 | from sys import executable, platform # Platform is set for one test. |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 26 | |
Victor Stinner | d6debb2 | 2017-03-27 16:05:26 +0200 | [diff] [blame] | 27 | from tkinter import Toplevel, StringVar, W, E, S |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 28 | from tkinter.ttk import Frame, Button, Entry, Label |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 29 | from tkinter import filedialog |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 30 | from tkinter.font import Font |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 31 | |
| 32 | class Query(Toplevel): |
| 33 | """Base class for getting verified answer from a user. |
| 34 | |
| 35 | For this base class, accept any non-blank string. |
| 36 | """ |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 37 | def __init__(self, parent, title, message, *, text0='', used_names={}, |
| 38 | _htest=False, _utest=False): |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 39 | """Create popup, do not return until tk widget destroyed. |
| 40 | |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 41 | Additional subclass init must be done before calling this |
| 42 | unless _utest=True is passed to suppress wait_window(). |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 43 | |
| 44 | title - string, title of popup dialog |
| 45 | message - string, informational message to display |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 46 | text0 - initial value for entry |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 47 | used_names - names already in use |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 48 | _htest - bool, change box location when running htest |
| 49 | _utest - bool, leave window hidden and not modal |
| 50 | """ |
| 51 | Toplevel.__init__(self, parent) |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 52 | self.withdraw() # Hide while configuring, especially geometry. |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 53 | self.parent = parent |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 54 | self.title(title) |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 55 | self.message = message |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 56 | self.text0 = text0 |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 57 | self.used_names = used_names |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 58 | self.transient(parent) |
| 59 | self.grab_set() |
| 60 | windowingsystem = self.tk.call('tk', 'windowingsystem') |
| 61 | if windowingsystem == 'aqua': |
| 62 | try: |
| 63 | self.tk.call('::tk::unsupported::MacWindowStyle', 'style', |
| 64 | self._w, 'moveableModal', '') |
| 65 | except: |
| 66 | pass |
| 67 | self.bind("<Command-.>", self.cancel) |
| 68 | self.bind('<Key-Escape>', self.cancel) |
| 69 | self.protocol("WM_DELETE_WINDOW", self.cancel) |
| 70 | self.bind('<Key-Return>', self.ok) |
| 71 | self.bind("<KP_Enter>", self.ok) |
| 72 | self.resizable(height=False, width=False) |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 73 | self.create_widgets() |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 74 | self.update_idletasks() # Needed here for winfo_reqwidth below. |
| 75 | self.geometry( # Center dialog over parent (or below htest box). |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 76 | "+%d+%d" % ( |
| 77 | parent.winfo_rootx() + |
| 78 | (parent.winfo_width()/2 - self.winfo_reqwidth()/2), |
| 79 | parent.winfo_rooty() + |
| 80 | ((parent.winfo_height()/2 - self.winfo_reqheight()/2) |
| 81 | if not _htest else 150) |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 82 | ) ) |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 83 | if not _utest: |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 84 | self.deiconify() # Unhide now that geometry set. |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 85 | self.wait_window() |
| 86 | |
| 87 | def create_widgets(self): # Call from override, if any. |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 88 | # Bind to self widgets needed for entry_ok or unittest. |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 89 | self.frame = frame = Frame(self, padding=10) |
| 90 | frame.grid(column=0, row=0, sticky='news') |
| 91 | frame.grid_columnconfigure(0, weight=1) |
| 92 | |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 93 | entrylabel = Label(frame, anchor='w', justify='left', |
| 94 | text=self.message) |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 95 | self.entryvar = StringVar(self, self.text0) |
| 96 | self.entry = Entry(frame, width=30, textvariable=self.entryvar) |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 97 | self.entry.focus_set() |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 98 | self.error_font = Font(name='TkCaptionFont', |
| 99 | exists=True, root=self.parent) |
| 100 | self.entry_error = Label(frame, text=' ', foreground='red', |
| 101 | font=self.error_font) |
| 102 | self.button_ok = Button( |
| 103 | frame, text='OK', default='active', command=self.ok) |
| 104 | self.button_cancel = Button( |
| 105 | frame, text='Cancel', command=self.cancel) |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 106 | |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 107 | entrylabel.grid(column=0, row=0, columnspan=3, padx=5, sticky=W) |
| 108 | self.entry.grid(column=0, row=1, columnspan=3, padx=5, sticky=W+E, |
| 109 | pady=[10,0]) |
| 110 | self.entry_error.grid(column=0, row=2, columnspan=3, padx=5, |
| 111 | sticky=W+E) |
| 112 | self.button_ok.grid(column=1, row=99, padx=5) |
| 113 | self.button_cancel.grid(column=2, row=99, padx=5) |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 114 | |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 115 | def showerror(self, message, widget=None): |
| 116 | #self.bell(displayof=self) |
| 117 | (widget or self.entry_error)['text'] = 'ERROR: ' + message |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 118 | |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 119 | def entry_ok(self): # Example: usually replace. |
| 120 | "Return non-blank entry or None." |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 121 | self.entry_error['text'] = '' |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 122 | entry = self.entry.get().strip() |
| 123 | if not entry: |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 124 | self.showerror('blank line.') |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 125 | return None |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 126 | return entry |
| 127 | |
| 128 | def ok(self, event=None): # Do not replace. |
| 129 | '''If entry is valid, bind it to 'result' and destroy tk widget. |
| 130 | |
| 131 | Otherwise leave dialog open for user to correct entry or cancel. |
| 132 | ''' |
| 133 | entry = self.entry_ok() |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 134 | if entry is not None: |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 135 | self.result = entry |
| 136 | self.destroy() |
| 137 | else: |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 138 | # [Ok] moves focus. (<Return> does not.) Move it back. |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 139 | self.entry.focus_set() |
| 140 | |
| 141 | def cancel(self, event=None): # Do not replace. |
| 142 | "Set dialog result to None and destroy tk widget." |
| 143 | self.result = None |
| 144 | self.destroy() |
| 145 | |
Tal Einat | 10ea940 | 2018-08-02 09:18:29 +0300 | [diff] [blame] | 146 | def destroy(self): |
| 147 | self.grab_release() |
| 148 | super().destroy() |
| 149 | |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 150 | |
| 151 | class SectionName(Query): |
| 152 | "Get a name for a config file section name." |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 153 | # Used in ConfigDialog.GetNewKeysName, .GetNewThemeName (837) |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 154 | |
| 155 | def __init__(self, parent, title, message, used_names, |
| 156 | *, _htest=False, _utest=False): |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 157 | super().__init__(parent, title, message, used_names=used_names, |
| 158 | _htest=_htest, _utest=_utest) |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 159 | |
| 160 | def entry_ok(self): |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 161 | "Return sensible ConfigParser section name or None." |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 162 | self.entry_error['text'] = '' |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 163 | name = self.entry.get().strip() |
| 164 | if not name: |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 165 | self.showerror('no name specified.') |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 166 | return None |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 167 | elif len(name)>30: |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 168 | self.showerror('name is longer than 30 characters.') |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 169 | return None |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 170 | elif name in self.used_names: |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 171 | self.showerror('name is already in use.') |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 172 | return None |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 173 | return name |
| 174 | |
| 175 | |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 176 | class ModuleName(Query): |
| 177 | "Get a module name for Open Module menu entry." |
| 178 | # Used in open_module (editor.EditorWindow until move to iobinding). |
| 179 | |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 180 | def __init__(self, parent, title, message, text0, |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 181 | *, _htest=False, _utest=False): |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 182 | super().__init__(parent, title, message, text0=text0, |
| 183 | _htest=_htest, _utest=_utest) |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 184 | |
| 185 | def entry_ok(self): |
| 186 | "Return entered module name as file path or None." |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 187 | self.entry_error['text'] = '' |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 188 | name = self.entry.get().strip() |
| 189 | if not name: |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 190 | self.showerror('no name specified.') |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 191 | return None |
| 192 | # XXX Ought to insert current file's directory in front of path. |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 193 | try: |
| 194 | spec = importlib.util.find_spec(name) |
| 195 | except (ValueError, ImportError) as msg: |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 196 | self.showerror(str(msg)) |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 197 | return None |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 198 | if spec is None: |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 199 | self.showerror("module not found") |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 200 | return None |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 201 | if not isinstance(spec.loader, importlib.abc.SourceLoader): |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 202 | self.showerror("not a source-based module") |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 203 | return None |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 204 | try: |
| 205 | file_path = spec.loader.get_filename(name) |
| 206 | except AttributeError: |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 207 | self.showerror("loader does not support get_filename", |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 208 | parent=self) |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 209 | return None |
Terry Jan Reedy | 0cd6b97 | 2016-07-03 19:11:13 -0400 | [diff] [blame] | 210 | return file_path |
| 211 | |
| 212 | |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 213 | class HelpSource(Query): |
| 214 | "Get menu name and help source for Help menu." |
| 215 | # Used in ConfigDialog.HelpListItemAdd/Edit, (941/9) |
| 216 | |
| 217 | def __init__(self, parent, title, *, menuitem='', filepath='', |
| 218 | used_names={}, _htest=False, _utest=False): |
| 219 | """Get menu entry and url/local file for Additional Help. |
| 220 | |
| 221 | User enters a name for the Help resource and a web url or file |
| 222 | name. The user can browse for the file. |
| 223 | """ |
| 224 | self.filepath = filepath |
| 225 | message = 'Name for item on Help menu:' |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 226 | super().__init__( |
| 227 | parent, title, message, text0=menuitem, |
| 228 | used_names=used_names, _htest=_htest, _utest=_utest) |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 229 | |
| 230 | def create_widgets(self): |
| 231 | super().create_widgets() |
| 232 | frame = self.frame |
| 233 | pathlabel = Label(frame, anchor='w', justify='left', |
| 234 | text='Help File Path: Enter URL or browse for file') |
| 235 | self.pathvar = StringVar(self, self.filepath) |
| 236 | self.path = Entry(frame, textvariable=self.pathvar, width=40) |
| 237 | browse = Button(frame, text='Browse', width=8, |
| 238 | command=self.browse_file) |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 239 | self.path_error = Label(frame, text=' ', foreground='red', |
| 240 | font=self.error_font) |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 241 | |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 242 | pathlabel.grid(column=0, row=10, columnspan=3, padx=5, pady=[10,0], |
| 243 | sticky=W) |
| 244 | self.path.grid(column=0, row=11, columnspan=2, padx=5, sticky=W+E, |
| 245 | pady=[10,0]) |
| 246 | browse.grid(column=2, row=11, padx=5, sticky=W+S) |
| 247 | self.path_error.grid(column=0, row=12, columnspan=3, padx=5, |
| 248 | sticky=W+E) |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 249 | |
| 250 | def askfilename(self, filetypes, initdir, initfile): # htest # |
| 251 | # Extracted from browse_file so can mock for unittests. |
| 252 | # Cannot unittest as cannot simulate button clicks. |
| 253 | # Test by running htest, such as by running this file. |
| 254 | return filedialog.Open(parent=self, filetypes=filetypes)\ |
| 255 | .show(initialdir=initdir, initialfile=initfile) |
| 256 | |
| 257 | def browse_file(self): |
| 258 | filetypes = [ |
| 259 | ("HTML Files", "*.htm *.html", "TEXT"), |
| 260 | ("PDF Files", "*.pdf", "TEXT"), |
| 261 | ("Windows Help Files", "*.chm"), |
| 262 | ("Text Files", "*.txt", "TEXT"), |
| 263 | ("All Files", "*")] |
| 264 | path = self.pathvar.get() |
| 265 | if path: |
| 266 | dir, base = os.path.split(path) |
| 267 | else: |
| 268 | base = None |
| 269 | if platform[:3] == 'win': |
| 270 | dir = os.path.join(os.path.dirname(executable), 'Doc') |
| 271 | if not os.path.isdir(dir): |
| 272 | dir = os.getcwd() |
| 273 | else: |
| 274 | dir = os.getcwd() |
| 275 | file = self.askfilename(filetypes, dir, base) |
| 276 | if file: |
| 277 | self.pathvar.set(file) |
| 278 | |
| 279 | item_ok = SectionName.entry_ok # localize for test override |
| 280 | |
| 281 | def path_ok(self): |
| 282 | "Simple validity check for menu file path" |
| 283 | path = self.path.get().strip() |
| 284 | if not path: #no path specified |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 285 | self.showerror('no help file path specified.', self.path_error) |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 286 | return None |
| 287 | elif not path.startswith(('www.', 'http')): |
| 288 | if path[:5] == 'file:': |
| 289 | path = path[5:] |
| 290 | if not os.path.exists(path): |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 291 | self.showerror('help file path does not exist.', |
| 292 | self.path_error) |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 293 | return None |
| 294 | if platform == 'darwin': # for Mac Safari |
| 295 | path = "file://" + path |
| 296 | return path |
| 297 | |
| 298 | def entry_ok(self): |
| 299 | "Return apparently valid (name, path) or None" |
Terry Jan Reedy | 65db854 | 2016-08-10 12:50:16 -0400 | [diff] [blame] | 300 | self.entry_error['text'] = '' |
| 301 | self.path_error['text'] = '' |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 302 | name = self.item_ok() |
| 303 | path = self.path_ok() |
| 304 | return None if name is None or path is None else (name, path) |
| 305 | |
| 306 | |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 307 | if __name__ == '__main__': |
Terry Jan Reedy | ea3dc80 | 2018-06-18 04:47:59 -0400 | [diff] [blame] | 308 | from unittest import main |
| 309 | main('idlelib.idle_test.test_query', verbosity=2, exit=False) |
Terry Jan Reedy | 68a53c5 | 2016-06-26 22:05:10 -0400 | [diff] [blame] | 310 | |
| 311 | from idlelib.idle_test.htest import run |
Terry Jan Reedy | 8b22c0a | 2016-07-08 00:22:50 -0400 | [diff] [blame] | 312 | run(Query, HelpSource) |