1"""About Dialog for IDLE 2 3""" 4import os 5import sys 6import webbrowser 7from platform import python_version, architecture 8 9from tkinter import Toplevel, Frame, Label, Button, PhotoImage 10from tkinter import SUNKEN, TOP, BOTTOM, LEFT, X, BOTH, W, EW, NSEW, E 11 12from idlelib import textview 13 14pyver = python_version() 15 16if sys.platform == 'darwin': 17 bits = '64' if sys.maxsize > 2**32 else '32' 18else: 19 bits = architecture()[0][:2] 20 21 22class AboutDialog(Toplevel): 23 """Modal about dialog for idle 24 25 """ 26 def __init__(self, parent, title=None, *, _htest=False, _utest=False): 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 31 _htest - bool, change box location when running htest 32 _utest - bool, don't wait_window when running unittest 33 """ 34 Toplevel.__init__(self, parent) 35 self.configure(borderwidth=5) 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))) 40 self.bg = "#bbbbbb" 41 self.fg = "#000000" 42 self.create_widgets() 43 self.resizable(height=False, width=False) 44 self.title(title or 45 f'About IDLE {pyver} ({bits} bit)') 46 self.transient(parent) 47 self.grab_set() 48 self.protocol("WM_DELETE_WINDOW", self.ok) 49 self.parent = parent 50 self.button_ok.focus_set() 51 self.bind('<Return>', self.ok) # dismiss dialog 52 self.bind('<Escape>', self.ok) # dismiss dialog 53 self._current_textview = None 54 self._utest = _utest 55 56 if not _utest: 57 self.deiconify() 58 self.wait_window() 59 60 def create_widgets(self): 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')) 74 header.grid(row=0, column=0, sticky=E, padx=10, pady=10) 75 76 tkpatch = self._root().getvar('tk_patchLevel') 77 ext = '.png' if tkpatch >= '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 84 byline_text = "Python's Integrated Development\nand Learning Environment" + 5*'\n' 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 89 forums_url = "https://discuss.python.org" 90 forums = Label(frame_background, text="Python forums: "+forums_url, 91 justify=LEFT, fg=self.fg, bg=self.bg) 92 forums.grid(row=6, column=0, sticky=W, padx=10, pady=0) 93 forums.bind("<Button-1>", lambda event: webbrowser.open(forums_url)) 94 docs_url = ("https://docs.python.org/%d.%d/library/idle.html" % 95 sys.version_info[:2]) 96 docs = Label(frame_background, text=docs_url, 97 justify=LEFT, fg=self.fg, bg=self.bg) 98 docs.grid(row=7, column=0, columnspan=2, sticky=W, padx=10, pady=0) 99 docs.bind("<Button-1>", lambda event: webbrowser.open(docs_url)) 100 101 Frame(frame_background, borderwidth=1, relief=SUNKEN, 102 height=2, bg=self.bg).grid(row=8, column=0, sticky=EW, 103 columnspan=3, padx=5, pady=5) 104 105 tclver = str(self.info_patchlevel()) 106 tkver = ' and ' + tkpatch if tkpatch != tclver else '' 107 versions = f"Python {pyver} with tcl/tk {tclver}{tkver}" 108 vers = Label(frame_background, text=versions, fg=self.fg, bg=self.bg) 109 vers.grid(row=9, column=0, sticky=W, padx=10, pady=0) 110 py_buttons = Frame(frame_background, bg=self.bg) 111 py_buttons.grid(row=10, column=0, columnspan=2, sticky=NSEW) 112 self.py_license = Button(py_buttons, text='License', width=8, 113 highlightbackground=self.bg, 114 command=self.show_py_license) 115 self.py_license.pack(side=LEFT, padx=10, pady=10) 116 self.py_copyright = Button(py_buttons, text='Copyright', width=8, 117 highlightbackground=self.bg, 118 command=self.show_py_copyright) 119 self.py_copyright.pack(side=LEFT, padx=10, pady=10) 120 self.py_credits = Button(py_buttons, text='Credits', width=8, 121 highlightbackground=self.bg, 122 command=self.show_py_credits) 123 self.py_credits.pack(side=LEFT, padx=10, pady=10) 124 125 Frame(frame_background, borderwidth=1, relief=SUNKEN, 126 height=2, bg=self.bg).grid(row=11, column=0, sticky=EW, 127 columnspan=3, padx=5, pady=5) 128 129 idle = Label(frame_background, text='IDLE', fg=self.fg, bg=self.bg) 130 idle.grid(row=12, column=0, sticky=W, padx=10, pady=0) 131 idle_buttons = Frame(frame_background, bg=self.bg) 132 idle_buttons.grid(row=13, column=0, columnspan=3, sticky=NSEW) 133 self.readme = Button(idle_buttons, text='Readme', width=8, 134 highlightbackground=self.bg, 135 command=self.show_readme) 136 self.readme.pack(side=LEFT, padx=10, pady=10) 137 self.idle_news = Button(idle_buttons, text='News', width=8, 138 highlightbackground=self.bg, 139 command=self.show_idle_news) 140 self.idle_news.pack(side=LEFT, padx=10, pady=10) 141 self.idle_credits = Button(idle_buttons, text='Credits', width=8, 142 highlightbackground=self.bg, 143 command=self.show_idle_credits) 144 self.idle_credits.pack(side=LEFT, padx=10, pady=10) 145 146 # License, copyright, and credits are of type _sitebuiltins._Printer 147 def show_py_license(self): 148 "Handle License button event." 149 self.display_printer_text('About - License', license) 150 151 def show_py_copyright(self): 152 "Handle Copyright button event." 153 self.display_printer_text('About - Copyright', copyright) 154 155 def show_py_credits(self): 156 "Handle Python Credits button event." 157 self.display_printer_text('About - Python Credits', credits) 158 159 # Encode CREDITS.txt to utf-8 for proper version of Loewis. 160 # Specify others as ascii until need utf-8, so catch errors. 161 def show_idle_credits(self): 162 "Handle Idle Credits button event." 163 self.display_file_text('About - Credits', 'CREDITS.txt', 'utf-8') 164 165 def show_readme(self): 166 "Handle Readme button event." 167 self.display_file_text('About - Readme', 'README.txt', 'ascii') 168 169 def show_idle_news(self): 170 "Handle News button event." 171 self.display_file_text('About - News', 'News3.txt', 'utf-8') 172 173 def display_printer_text(self, title, printer): 174 """Create textview for built-in constants. 175 176 Built-in constants have type _sitebuiltins._Printer. The 177 text is extracted from the built-in and then sent to a text 178 viewer with self as the parent and title as the title of 179 the popup. 180 """ 181 printer._Printer__setup() 182 text = '\n'.join(printer._Printer__lines) 183 self._current_textview = textview.view_text( 184 self, title, text, _utest=self._utest) 185 186 def display_file_text(self, title, filename, encoding=None): 187 """Create textview for filename. 188 189 The filename needs to be in the current directory. The path 190 is sent to a text viewer with self as the parent, title as 191 the title of the popup, and the file encoding. 192 """ 193 fn = os.path.join(os.path.abspath(os.path.dirname(__file__)), filename) 194 self._current_textview = textview.view_file( 195 self, title, fn, encoding, _utest=self._utest) 196 197 def ok(self, event=None): 198 "Dismiss help_about dialog." 199 self.grab_release() 200 self.destroy() 201 202 203if __name__ == '__main__': 204 from unittest import main 205 main('idlelib.idle_test.test_help_about', verbosity=2, exit=False) 206 207 from idlelib.idle_test.htest import run 208 run(AboutDialog) 209