Kurt B. Kaiser | 09cb74b | 2003-06-12 04:20:56 +0000 | [diff] [blame] | 1 | """About Dialog for IDLE |
| 2 | |
Steven M. Gava | 44d3d1a | 2001-07-31 06:59:02 +0000 | [diff] [blame] | 3 | """ |
Neal Norwitz | 9d72bb4 | 2007-04-17 08:48:32 +0000 | [diff] [blame] | 4 | import os |
csabella | 9a02ae3 | 2017-06-26 22:28:58 -0400 | [diff] [blame] | 5 | import sys |
| 6 | from platform import python_version, architecture |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 7 | |
csabella | d352d68 | 2017-06-23 12:00:29 -0400 | [diff] [blame] | 8 | from tkinter import Toplevel, Frame, Label, Button, PhotoImage |
| 9 | from tkinter import SUNKEN, TOP, BOTTOM, LEFT, X, BOTH, W, EW, NSEW, E |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 10 | |
Terry Jan Reedy | 6fa5bdc | 2016-05-28 13:22:31 -0400 | [diff] [blame] | 11 | from idlelib import textview |
Neal Norwitz | 539594f | 2002-11-30 19:12:41 +0000 | [diff] [blame] | 12 | |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 13 | |
csabella | 9a02ae3 | 2017-06-26 22:28:58 -0400 | [diff] [blame] | 14 | def build_bits(): |
| 15 | "Return bits for platform." |
| 16 | if sys.platform == 'darwin': |
| 17 | return '64' if sys.maxsize > 2**32 else '32' |
| 18 | else: |
| 19 | return architecture()[0][:2] |
| 20 | |
| 21 | |
Steven M. Gava | 44d3d1a | 2001-07-31 06:59:02 +0000 | [diff] [blame] | 22 | class AboutDialog(Toplevel): |
Kurt B. Kaiser | 09cb74b | 2003-06-12 04:20:56 +0000 | [diff] [blame] | 23 | """Modal about dialog for idle |
| 24 | |
Kurt B. Kaiser | 6655e4b | 2002-12-31 16:03:23 +0000 | [diff] [blame] | 25 | """ |
Terry Jan Reedy | bfebfd8 | 2017-09-30 17:37:53 -0400 | [diff] [blame^] | 26 | def __init__(self, parent, title=None, *, _htest=False, _utest=False): |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 27 | """Create popup, do not return until tk widget destroyed. |
| 28 | |
| 29 | parent - parent of this dialog |
| 30 | title - string which is title of popup dialog |
Terry Jan Reedy | 1b392ff | 2014-05-24 18:48:18 -0400 | [diff] [blame] | 31 | _htest - bool, change box location when running htest |
mlouielu | 054e091 | 2017-05-22 06:19:35 +0800 | [diff] [blame] | 32 | _utest - bool, don't wait_window when running unittest |
Terry Jan Reedy | 1b392ff | 2014-05-24 18:48:18 -0400 | [diff] [blame] | 33 | """ |
Steven M. Gava | 885c0bb | 2001-07-31 10:44:35 +0000 | [diff] [blame] | 34 | Toplevel.__init__(self, parent) |
| 35 | self.configure(borderwidth=5) |
Terry Jan Reedy | 1b392ff | 2014-05-24 18:48:18 -0400 | [diff] [blame] | 36 | # place dialog below parent if running htest |
| 37 | self.geometry("+%d+%d" % ( |
| 38 | parent.winfo_rootx()+30, |
| 39 | parent.winfo_rooty()+(30 if not _htest else 100))) |
csabella | 9a02ae3 | 2017-06-26 22:28:58 -0400 | [diff] [blame] | 40 | self.bg = "#bbbbbb" |
| 41 | self.fg = "#000000" |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 42 | self.create_widgets() |
| 43 | self.resizable(height=False, width=False) |
csabella | 9a02ae3 | 2017-06-26 22:28:58 -0400 | [diff] [blame] | 44 | self.title(title or |
| 45 | f'About IDLE {python_version()} ({build_bits()} bit)') |
Steven M. Gava | 885c0bb | 2001-07-31 10:44:35 +0000 | [diff] [blame] | 46 | self.transient(parent) |
| 47 | self.grab_set() |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 48 | self.protocol("WM_DELETE_WINDOW", self.ok) |
Steven M. Gava | 885c0bb | 2001-07-31 10:44:35 +0000 | [diff] [blame] | 49 | self.parent = parent |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 50 | self.button_ok.focus_set() |
| 51 | self.bind('<Return>', self.ok) # dismiss dialog |
| 52 | self.bind('<Escape>', self.ok) # dismiss dialog |
mlouielu | 054e091 | 2017-05-22 06:19:35 +0800 | [diff] [blame] | 53 | self._current_textview = None |
| 54 | self._utest = _utest |
| 55 | |
| 56 | if not _utest: |
| 57 | self.deiconify() |
| 58 | self.wait_window() |
Kurt B. Kaiser | 6655e4b | 2002-12-31 16:03:23 +0000 | [diff] [blame] | 59 | |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 60 | def create_widgets(self): |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 61 | frame = Frame(self, borderwidth=2, relief=SUNKEN) |
| 62 | frame_buttons = Frame(self) |
| 63 | frame_buttons.pack(side=BOTTOM, fill=X) |
| 64 | frame.pack(side=TOP, expand=True, fill=BOTH) |
| 65 | self.button_ok = Button(frame_buttons, text='Close', |
| 66 | command=self.ok) |
| 67 | self.button_ok.pack(padx=5, pady=5) |
| 68 | |
| 69 | frame_background = Frame(frame, bg=self.bg) |
| 70 | frame_background.pack(expand=True, fill=BOTH) |
| 71 | |
| 72 | header = Label(frame_background, text='IDLE', fg=self.fg, |
| 73 | bg=self.bg, font=('courier', 24, 'bold')) |
csabella | d352d68 | 2017-06-23 12:00:29 -0400 | [diff] [blame] | 74 | header.grid(row=0, column=0, sticky=E, padx=10, pady=10) |
| 75 | |
| 76 | tk_patchlevel = self.tk.call('info', 'patchlevel') |
| 77 | ext = '.png' if tk_patchlevel >= '8.6' else '.gif' |
| 78 | icon = os.path.join(os.path.abspath(os.path.dirname(__file__)), |
| 79 | 'Icons', f'idle_48{ext}') |
| 80 | self.icon_image = PhotoImage(master=self._root(), file=icon) |
| 81 | logo = Label(frame_background, image=self.icon_image, bg=self.bg) |
| 82 | logo.grid(row=0, column=0, sticky=W, rowspan=2, padx=10, pady=10) |
| 83 | |
Mark Roseman | 592eda1 | 2017-06-27 19:42:10 -0700 | [diff] [blame] | 84 | byline_text = "Python's Integrated Development\nand Learning Environment" + 5*'\n' |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 85 | byline = Label(frame_background, text=byline_text, justify=LEFT, |
| 86 | fg=self.fg, bg=self.bg) |
| 87 | byline.grid(row=2, column=0, sticky=W, columnspan=3, padx=10, pady=5) |
| 88 | email = Label(frame_background, text='email: idle-dev@python.org', |
| 89 | justify=LEFT, fg=self.fg, bg=self.bg) |
| 90 | email.grid(row=6, column=0, columnspan=2, sticky=W, padx=10, pady=0) |
| 91 | docs = Label(frame_background, text='https://docs.python.org/' + |
csabella | 18ede06 | 2017-06-23 20:00:58 -0400 | [diff] [blame] | 92 | python_version()[:3] + '/library/idle.html', |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 93 | justify=LEFT, fg=self.fg, bg=self.bg) |
| 94 | docs.grid(row=7, column=0, columnspan=2, sticky=W, padx=10, pady=0) |
| 95 | |
| 96 | Frame(frame_background, borderwidth=1, relief=SUNKEN, |
Kurt B. Kaiser | 09cb74b | 2003-06-12 04:20:56 +0000 | [diff] [blame] | 97 | height=2, bg=self.bg).grid(row=8, column=0, sticky=EW, |
| 98 | columnspan=3, padx=5, pady=5) |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 99 | |
csabella | 18ede06 | 2017-06-23 20:00:58 -0400 | [diff] [blame] | 100 | pyver = Label(frame_background, |
| 101 | text='Python version: ' + python_version(), |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 102 | fg=self.fg, bg=self.bg) |
| 103 | pyver.grid(row=9, column=0, sticky=W, padx=10, pady=0) |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 104 | tkver = Label(frame_background, text='Tk version: ' + tk_patchlevel, |
| 105 | fg=self.fg, bg=self.bg) |
| 106 | tkver.grid(row=9, column=1, sticky=W, padx=2, pady=0) |
| 107 | py_buttons = Frame(frame_background, bg=self.bg) |
| 108 | py_buttons.grid(row=10, column=0, columnspan=2, sticky=NSEW) |
| 109 | self.py_license = Button(py_buttons, text='License', width=8, |
| 110 | highlightbackground=self.bg, |
| 111 | command=self.show_py_license) |
| 112 | self.py_license.pack(side=LEFT, padx=10, pady=10) |
| 113 | self.py_copyright = Button(py_buttons, text='Copyright', width=8, |
| 114 | highlightbackground=self.bg, |
| 115 | command=self.show_py_copyright) |
| 116 | self.py_copyright.pack(side=LEFT, padx=10, pady=10) |
| 117 | self.py_credits = Button(py_buttons, text='Credits', width=8, |
| 118 | highlightbackground=self.bg, |
| 119 | command=self.show_py_credits) |
| 120 | self.py_credits.pack(side=LEFT, padx=10, pady=10) |
| 121 | |
| 122 | Frame(frame_background, borderwidth=1, relief=SUNKEN, |
Kurt B. Kaiser | 09cb74b | 2003-06-12 04:20:56 +0000 | [diff] [blame] | 123 | height=2, bg=self.bg).grid(row=11, column=0, sticky=EW, |
| 124 | columnspan=3, padx=5, pady=5) |
Steven M. Gava | 885c0bb | 2001-07-31 10:44:35 +0000 | [diff] [blame] | 125 | |
csabella | 18ede06 | 2017-06-23 20:00:58 -0400 | [diff] [blame] | 126 | idlever = Label(frame_background, |
| 127 | text='IDLE version: ' + python_version(), |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 128 | fg=self.fg, bg=self.bg) |
| 129 | idlever.grid(row=12, column=0, sticky=W, padx=10, pady=0) |
| 130 | idle_buttons = Frame(frame_background, bg=self.bg) |
| 131 | idle_buttons.grid(row=13, column=0, columnspan=3, sticky=NSEW) |
| 132 | self.readme = Button(idle_buttons, text='README', width=8, |
| 133 | highlightbackground=self.bg, |
| 134 | command=self.show_readme) |
| 135 | self.readme.pack(side=LEFT, padx=10, pady=10) |
| 136 | self.idle_news = Button(idle_buttons, text='NEWS', width=8, |
| 137 | highlightbackground=self.bg, |
| 138 | command=self.show_idle_news) |
| 139 | self.idle_news.pack(side=LEFT, padx=10, pady=10) |
| 140 | self.idle_credits = Button(idle_buttons, text='Credits', width=8, |
| 141 | highlightbackground=self.bg, |
| 142 | command=self.show_idle_credits) |
| 143 | self.idle_credits.pack(side=LEFT, padx=10, pady=10) |
| 144 | |
| 145 | # License, copyright, and credits are of type _sitebuiltins._Printer |
| 146 | def show_py_license(self): |
| 147 | "Handle License button event." |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 148 | self.display_printer_text('About - License', license) |
Kurt B. Kaiser | 6655e4b | 2002-12-31 16:03:23 +0000 | [diff] [blame] | 149 | |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 150 | def show_py_copyright(self): |
| 151 | "Handle Copyright button event." |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 152 | self.display_printer_text('About - Copyright', copyright) |
Kurt B. Kaiser | 09cb74b | 2003-06-12 04:20:56 +0000 | [diff] [blame] | 153 | |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 154 | def show_py_credits(self): |
| 155 | "Handle Python Credits button event." |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 156 | self.display_printer_text('About - Python Credits', credits) |
Kurt B. Kaiser | 09cb74b | 2003-06-12 04:20:56 +0000 | [diff] [blame] | 157 | |
Terry Jan Reedy | 3567651 | 2016-01-16 23:44:04 -0500 | [diff] [blame] | 158 | # Encode CREDITS.txt to utf-8 for proper version of Loewis. |
| 159 | # Specify others as ascii until need utf-8, so catch errors. |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 160 | def show_idle_credits(self): |
| 161 | "Handle Idle Credits button event." |
Terry Jan Reedy | 3567651 | 2016-01-16 23:44:04 -0500 | [diff] [blame] | 162 | self.display_file_text('About - Credits', 'CREDITS.txt', 'utf-8') |
Steven M. Gava | 885c0bb | 2001-07-31 10:44:35 +0000 | [diff] [blame] | 163 | |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 164 | def show_readme(self): |
| 165 | "Handle Readme button event." |
Terry Jan Reedy | 3567651 | 2016-01-16 23:44:04 -0500 | [diff] [blame] | 166 | self.display_file_text('About - Readme', 'README.txt', 'ascii') |
Kurt B. Kaiser | 09cb74b | 2003-06-12 04:20:56 +0000 | [diff] [blame] | 167 | |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 168 | def show_idle_news(self): |
| 169 | "Handle News button event." |
Terry Jan Reedy | 6ff7a14 | 2016-06-22 03:55:20 -0400 | [diff] [blame] | 170 | self.display_file_text('About - NEWS', 'NEWS.txt', 'utf-8') |
Kurt B. Kaiser | 09cb74b | 2003-06-12 04:20:56 +0000 | [diff] [blame] | 171 | |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 172 | def display_printer_text(self, title, printer): |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 173 | """Create textview for built-in constants. |
| 174 | |
| 175 | Built-in constants have type _sitebuiltins._Printer. The |
| 176 | text is extracted from the built-in and then sent to a text |
| 177 | viewer with self as the parent and title as the title of |
| 178 | the popup. |
| 179 | """ |
Kurt B. Kaiser | 09cb74b | 2003-06-12 04:20:56 +0000 | [diff] [blame] | 180 | printer._Printer__setup() |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 181 | text = '\n'.join(printer._Printer__lines) |
mlouielu | 054e091 | 2017-05-22 06:19:35 +0800 | [diff] [blame] | 182 | self._current_textview = textview.view_text( |
| 183 | self, title, text, _utest=self._utest) |
Kurt B. Kaiser | 09cb74b | 2003-06-12 04:20:56 +0000 | [diff] [blame] | 184 | |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 185 | def display_file_text(self, title, filename, encoding=None): |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 186 | """Create textview for filename. |
| 187 | |
| 188 | The filename needs to be in the current directory. The path |
| 189 | is sent to a text viewer with self as the parent, title as |
| 190 | the title of the popup, and the file encoding. |
| 191 | """ |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 192 | fn = os.path.join(os.path.abspath(os.path.dirname(__file__)), filename) |
mlouielu | 054e091 | 2017-05-22 06:19:35 +0800 | [diff] [blame] | 193 | self._current_textview = textview.view_file( |
| 194 | self, title, fn, encoding, _utest=self._utest) |
Steven M. Gava | 885c0bb | 2001-07-31 10:44:35 +0000 | [diff] [blame] | 195 | |
csabella | 5a346d5 | 2017-05-27 15:49:26 -0400 | [diff] [blame] | 196 | def ok(self, event=None): |
| 197 | "Dismiss help_about dialog." |
Steven M. Gava | 885c0bb | 2001-07-31 10:44:35 +0000 | [diff] [blame] | 198 | self.destroy() |
Kurt B. Kaiser | 6655e4b | 2002-12-31 16:03:23 +0000 | [diff] [blame] | 199 | |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 200 | |
Steven M. Gava | 44d3d1a | 2001-07-31 06:59:02 +0000 | [diff] [blame] | 201 | if __name__ == '__main__': |
Terry Jan Reedy | df1d34c | 2016-06-22 04:50:16 -0400 | [diff] [blame] | 202 | import unittest |
Terry Jan Reedy | 47e00e5 | 2016-06-22 05:49:15 -0400 | [diff] [blame] | 203 | unittest.main('idlelib.idle_test.test_help_about', verbosity=2, exit=False) |
Terry Jan Reedy | 06313b7 | 2014-05-11 23:32:32 -0400 | [diff] [blame] | 204 | from idlelib.idle_test.htest import run |
| 205 | run(AboutDialog) |