Mercurial > repos > rliterman > csp2

annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/lib/python3.8/idlelib/help_about.py @ 69:33d812a61356

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