mirror of
				https://github.com/python/cpython.git
				synced 2025-10-31 05:31:20 +00:00 
			
		
		
		
	 688722cedd
			
		
	
	
		688722cedd
		
			
		
	
	
	
	
		
			
			Using the system and place-dependent default encoding for open() is a bad idea for IDLE's system and location-independent files.
		
			
				
	
	
		
			136 lines
		
	
	
	
		
			4.5 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			136 lines
		
	
	
	
		
			4.5 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
| """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, 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)
 |