| """Simple text browser for IDLE |
| |
| """ |
| from tkinter import Toplevel, Text |
| from tkinter.ttk import Frame, Scrollbar, Button |
| from tkinter.messagebox import showerror |
| |
| |
| class TextFrame(Frame): |
| "Display text with scrollbar." |
| |
| def __init__(self, parent, rawtext): |
| """Create a frame for Textview. |
| |
| parent - parent widget for this frame |
| rawtext - text to display |
| """ |
| super().__init__(parent) |
| self['relief'] = 'sunken' |
| self['height'] = 700 |
| # TODO: get fg/bg from theme. |
| self.bg = '#ffffff' |
| self.fg = '#000000' |
| |
| self.text = text = Text(self, wrap='word', highlightthickness=0, |
| fg=self.fg, bg=self.bg) |
| self.scroll = scroll = Scrollbar(self, orient='vertical', |
| takefocus=False, command=text.yview) |
| text['yscrollcommand'] = scroll.set |
| text.insert(0.0, rawtext) |
| text['state'] = 'disabled' |
| text.focus_set() |
| |
| scroll.pack(side='right', fill='y') |
| text.pack(side='left', expand=True, fill='both') |
| |
| |
| class ViewFrame(Frame): |
| "Display TextFrame and Close button." |
| def __init__(self, parent, text): |
| super().__init__(parent) |
| self.parent = parent |
| self.bind('<Return>', self.ok) |
| self.bind('<Escape>', self.ok) |
| self.textframe = TextFrame(self, text) |
| self.button_ok = button_ok = Button( |
| self, text='Close', command=self.ok, takefocus=False) |
| self.textframe.pack(side='top', expand=True, fill='both') |
| button_ok.pack(side='bottom') |
| |
| def ok(self, event=None): |
| """Dismiss text viewer dialog.""" |
| self.parent.destroy() |
| |
| |
| class ViewWindow(Toplevel): |
| "A simple text viewer dialog for IDLE." |
| |
| def __init__(self, parent, title, text, modal=True, |
| *, _htest=False, _utest=False): |
| """Show the given text in a scrollable window with a 'close' button. |
| |
| If modal is left True, users cannot interact with other windows |
| until the textview window is closed. |
| |
| parent - parent of this dialog |
| title - string which is title of popup dialog |
| text - text to display in dialog |
| _htest - bool; change box location when running htest. |
| _utest - bool; don't wait_window when running unittest. |
| """ |
| super().__init__(parent) |
| self['borderwidth'] = 5 |
| # Place dialog below parent if running htest. |
| x = parent.winfo_rootx() + 10 |
| y = parent.winfo_rooty() + (10 if not _htest else 100) |
| self.geometry(f'=750x500+{x}+{y}') |
| |
| self.title(title) |
| self.viewframe = ViewFrame(self, text) |
| self.protocol("WM_DELETE_WINDOW", self.ok) |
| self.button_ok = button_ok = Button(self, text='Close', |
| command=self.ok, takefocus=False) |
| self.viewframe.pack(side='top', expand=True, fill='both') |
| |
| if modal: |
| self.transient(parent) |
| self.grab_set() |
| if not _utest: |
| self.wait_window() |
| |
| def ok(self, event=None): |
| """Dismiss text viewer dialog.""" |
| self.destroy() |
| |
| |
| def view_text(parent, title, text, modal=True, _utest=False): |
| """Create text viewer for given text. |
| |
| parent - parent of this dialog |
| title - string which is the title of popup dialog |
| text - text to display in this dialog |
| modal - controls if users can interact with other windows while this |
| dialog is displayed |
| _utest - bool; controls wait_window on unittest |
| """ |
| return ViewWindow(parent, title, text, modal, _utest=_utest) |
| |
| |
| def view_file(parent, title, filename, encoding=None, modal=True, _utest=False): |
| """Create text viewer for text in filename. |
| |
| Return error message if file cannot be read. Otherwise calls view_text |
| with contents of the file. |
| """ |
| try: |
| with open(filename, 'r', encoding=encoding) as file: |
| contents = file.read() |
| except OSError: |
| showerror(title='File Load Error', |
| message=f'Unable to load file {filename!r} .', |
| parent=parent) |
| except UnicodeDecodeError as err: |
| showerror(title='Unicode Decode Error', |
| message=str(err), |
| parent=parent) |
| else: |
| return view_text(parent, title, contents, modal, _utest=_utest) |
| return None |
| |
| |
| if __name__ == '__main__': |
| import unittest |
| unittest.main('idlelib.idle_test.test_textview', verbosity=2, exit=False) |
| from idlelib.idle_test.htest import run |
| run(ViewWindow) |