jpayne@68: """About Dialog for IDLE jpayne@68: jpayne@68: """ jpayne@68: import os jpayne@68: import sys jpayne@68: from platform import python_version, architecture jpayne@68: jpayne@68: from tkinter import Toplevel, Frame, Label, Button, PhotoImage jpayne@68: from tkinter import SUNKEN, TOP, BOTTOM, LEFT, X, BOTH, W, EW, NSEW, E jpayne@68: jpayne@68: from idlelib import textview jpayne@68: jpayne@68: jpayne@68: def build_bits(): jpayne@68: "Return bits for platform." jpayne@68: if sys.platform == 'darwin': jpayne@68: return '64' if sys.maxsize > 2**32 else '32' jpayne@68: else: jpayne@68: return architecture()[0][:2] jpayne@68: jpayne@68: jpayne@68: class AboutDialog(Toplevel): jpayne@68: """Modal about dialog for idle jpayne@68: jpayne@68: """ jpayne@68: def __init__(self, parent, title=None, *, _htest=False, _utest=False): jpayne@68: """Create popup, do not return until tk widget destroyed. jpayne@68: jpayne@68: parent - parent of this dialog jpayne@68: title - string which is title of popup dialog jpayne@68: _htest - bool, change box location when running htest jpayne@68: _utest - bool, don't wait_window when running unittest jpayne@68: """ jpayne@68: Toplevel.__init__(self, parent) jpayne@68: self.configure(borderwidth=5) jpayne@68: # place dialog below parent if running htest jpayne@68: self.geometry("+%d+%d" % ( jpayne@68: parent.winfo_rootx()+30, jpayne@68: parent.winfo_rooty()+(30 if not _htest else 100))) jpayne@68: self.bg = "#bbbbbb" jpayne@68: self.fg = "#000000" jpayne@68: self.create_widgets() jpayne@68: self.resizable(height=False, width=False) jpayne@68: self.title(title or jpayne@68: f'About IDLE {python_version()} ({build_bits()} bit)') jpayne@68: self.transient(parent) jpayne@68: self.grab_set() jpayne@68: self.protocol("WM_DELETE_WINDOW", self.ok) jpayne@68: self.parent = parent jpayne@68: self.button_ok.focus_set() jpayne@68: self.bind('', self.ok) # dismiss dialog jpayne@68: self.bind('', self.ok) # dismiss dialog jpayne@68: self._current_textview = None jpayne@68: self._utest = _utest jpayne@68: jpayne@68: if not _utest: jpayne@68: self.deiconify() jpayne@68: self.wait_window() jpayne@68: jpayne@68: def create_widgets(self): jpayne@68: frame = Frame(self, borderwidth=2, relief=SUNKEN) jpayne@68: frame_buttons = Frame(self) jpayne@68: frame_buttons.pack(side=BOTTOM, fill=X) jpayne@68: frame.pack(side=TOP, expand=True, fill=BOTH) jpayne@68: self.button_ok = Button(frame_buttons, text='Close', jpayne@68: command=self.ok) jpayne@68: self.button_ok.pack(padx=5, pady=5) jpayne@68: jpayne@68: frame_background = Frame(frame, bg=self.bg) jpayne@68: frame_background.pack(expand=True, fill=BOTH) jpayne@68: jpayne@68: header = Label(frame_background, text='IDLE', fg=self.fg, jpayne@68: bg=self.bg, font=('courier', 24, 'bold')) jpayne@68: header.grid(row=0, column=0, sticky=E, padx=10, pady=10) jpayne@68: jpayne@68: tk_patchlevel = self.tk.call('info', 'patchlevel') jpayne@68: ext = '.png' if tk_patchlevel >= '8.6' else '.gif' jpayne@68: icon = os.path.join(os.path.abspath(os.path.dirname(__file__)), jpayne@68: 'Icons', f'idle_48{ext}') jpayne@68: self.icon_image = PhotoImage(master=self._root(), file=icon) jpayne@68: logo = Label(frame_background, image=self.icon_image, bg=self.bg) jpayne@68: logo.grid(row=0, column=0, sticky=W, rowspan=2, padx=10, pady=10) jpayne@68: jpayne@68: byline_text = "Python's Integrated Development\nand Learning Environment" + 5*'\n' jpayne@68: byline = Label(frame_background, text=byline_text, justify=LEFT, jpayne@68: fg=self.fg, bg=self.bg) jpayne@68: byline.grid(row=2, column=0, sticky=W, columnspan=3, padx=10, pady=5) jpayne@68: email = Label(frame_background, text='email: idle-dev@python.org', jpayne@68: justify=LEFT, fg=self.fg, bg=self.bg) jpayne@68: email.grid(row=6, column=0, columnspan=2, sticky=W, padx=10, pady=0) jpayne@68: docs = Label(frame_background, text='https://docs.python.org/' + jpayne@68: python_version()[:3] + '/library/idle.html', jpayne@68: justify=LEFT, fg=self.fg, bg=self.bg) jpayne@68: docs.grid(row=7, column=0, columnspan=2, sticky=W, padx=10, pady=0) jpayne@68: jpayne@68: Frame(frame_background, borderwidth=1, relief=SUNKEN, jpayne@68: height=2, bg=self.bg).grid(row=8, column=0, sticky=EW, jpayne@68: columnspan=3, padx=5, pady=5) jpayne@68: jpayne@68: pyver = Label(frame_background, jpayne@68: text='Python version: ' + python_version(), jpayne@68: fg=self.fg, bg=self.bg) jpayne@68: pyver.grid(row=9, column=0, sticky=W, padx=10, pady=0) jpayne@68: tkver = Label(frame_background, text='Tk version: ' + tk_patchlevel, jpayne@68: fg=self.fg, bg=self.bg) jpayne@68: tkver.grid(row=9, column=1, sticky=W, padx=2, pady=0) jpayne@68: py_buttons = Frame(frame_background, bg=self.bg) jpayne@68: py_buttons.grid(row=10, column=0, columnspan=2, sticky=NSEW) jpayne@68: self.py_license = Button(py_buttons, text='License', width=8, jpayne@68: highlightbackground=self.bg, jpayne@68: command=self.show_py_license) jpayne@68: self.py_license.pack(side=LEFT, padx=10, pady=10) jpayne@68: self.py_copyright = Button(py_buttons, text='Copyright', width=8, jpayne@68: highlightbackground=self.bg, jpayne@68: command=self.show_py_copyright) jpayne@68: self.py_copyright.pack(side=LEFT, padx=10, pady=10) jpayne@68: self.py_credits = Button(py_buttons, text='Credits', width=8, jpayne@68: highlightbackground=self.bg, jpayne@68: command=self.show_py_credits) jpayne@68: self.py_credits.pack(side=LEFT, padx=10, pady=10) jpayne@68: jpayne@68: Frame(frame_background, borderwidth=1, relief=SUNKEN, jpayne@68: height=2, bg=self.bg).grid(row=11, column=0, sticky=EW, jpayne@68: columnspan=3, padx=5, pady=5) jpayne@68: jpayne@68: idlever = Label(frame_background, jpayne@68: text='IDLE version: ' + python_version(), jpayne@68: fg=self.fg, bg=self.bg) jpayne@68: idlever.grid(row=12, column=0, sticky=W, padx=10, pady=0) jpayne@68: idle_buttons = Frame(frame_background, bg=self.bg) jpayne@68: idle_buttons.grid(row=13, column=0, columnspan=3, sticky=NSEW) jpayne@68: self.readme = Button(idle_buttons, text='README', width=8, jpayne@68: highlightbackground=self.bg, jpayne@68: command=self.show_readme) jpayne@68: self.readme.pack(side=LEFT, padx=10, pady=10) jpayne@68: self.idle_news = Button(idle_buttons, text='NEWS', width=8, jpayne@68: highlightbackground=self.bg, jpayne@68: command=self.show_idle_news) jpayne@68: self.idle_news.pack(side=LEFT, padx=10, pady=10) jpayne@68: self.idle_credits = Button(idle_buttons, text='Credits', width=8, jpayne@68: highlightbackground=self.bg, jpayne@68: command=self.show_idle_credits) jpayne@68: self.idle_credits.pack(side=LEFT, padx=10, pady=10) jpayne@68: jpayne@68: # License, copyright, and credits are of type _sitebuiltins._Printer jpayne@68: def show_py_license(self): jpayne@68: "Handle License button event." jpayne@68: self.display_printer_text('About - License', license) jpayne@68: jpayne@68: def show_py_copyright(self): jpayne@68: "Handle Copyright button event." jpayne@68: self.display_printer_text('About - Copyright', copyright) jpayne@68: jpayne@68: def show_py_credits(self): jpayne@68: "Handle Python Credits button event." jpayne@68: self.display_printer_text('About - Python Credits', credits) jpayne@68: jpayne@68: # Encode CREDITS.txt to utf-8 for proper version of Loewis. jpayne@68: # Specify others as ascii until need utf-8, so catch errors. jpayne@68: def show_idle_credits(self): jpayne@68: "Handle Idle Credits button event." jpayne@68: self.display_file_text('About - Credits', 'CREDITS.txt', 'utf-8') jpayne@68: jpayne@68: def show_readme(self): jpayne@68: "Handle Readme button event." jpayne@68: self.display_file_text('About - Readme', 'README.txt', 'ascii') jpayne@68: jpayne@68: def show_idle_news(self): jpayne@68: "Handle News button event." jpayne@68: self.display_file_text('About - NEWS', 'NEWS.txt', 'utf-8') jpayne@68: jpayne@68: def display_printer_text(self, title, printer): jpayne@68: """Create textview for built-in constants. jpayne@68: jpayne@68: Built-in constants have type _sitebuiltins._Printer. The jpayne@68: text is extracted from the built-in and then sent to a text jpayne@68: viewer with self as the parent and title as the title of jpayne@68: the popup. jpayne@68: """ jpayne@68: printer._Printer__setup() jpayne@68: text = '\n'.join(printer._Printer__lines) jpayne@68: self._current_textview = textview.view_text( jpayne@68: self, title, text, _utest=self._utest) jpayne@68: jpayne@68: def display_file_text(self, title, filename, encoding=None): jpayne@68: """Create textview for filename. jpayne@68: jpayne@68: The filename needs to be in the current directory. The path jpayne@68: is sent to a text viewer with self as the parent, title as jpayne@68: the title of the popup, and the file encoding. jpayne@68: """ jpayne@68: fn = os.path.join(os.path.abspath(os.path.dirname(__file__)), filename) jpayne@68: self._current_textview = textview.view_file( jpayne@68: self, title, fn, encoding, _utest=self._utest) jpayne@68: jpayne@68: def ok(self, event=None): jpayne@68: "Dismiss help_about dialog." jpayne@68: self.grab_release() jpayne@68: self.destroy() jpayne@68: jpayne@68: jpayne@68: if __name__ == '__main__': jpayne@68: from unittest import main jpayne@68: main('idlelib.idle_test.test_help_about', verbosity=2, exit=False) jpayne@68: jpayne@68: from idlelib.idle_test.htest import run jpayne@68: run(AboutDialog)