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