SWAMPy

✎ CARVE FLESH

EDITING: textview.py

"""Simple text browser for IDLE

"""
from tkinter import Toplevel, Text, TclError,\
    HORIZONTAL, VERTICAL, N, S, E, W
from tkinter.ttk import Frame, Scrollbar, Button
from tkinter.messagebox import showerror

from idlelib.colorizer import color_config

class AutoHiddenScrollbar(Scrollbar):
    """A scrollbar that is automatically hidden when not needed.

Only the grid geometry manager is supported.
    """
    def set(self, lo, hi):
        if float(lo) > 0.0 or float(hi) < 1.0:
            self.grid()
        else:
            self.grid_remove()
        super().set(lo, hi)

def pack(self, **kwargs):
        raise TclError(f'{self.__class__.__name__} does not support "pack"')

def place(self, **kwargs):
        raise TclError(f'{self.__class__.__name__} does not support "place"')

class TextFrame(Frame):
    "Display text with scrollbar."

def __init__(self, parent, rawtext, wrap='word'):
        """Create a frame for Textview.

parent - parent widget for this frame
        rawtext - text to display
        """
        super().__init__(parent)
        self['relief'] = 'sunken'
        self['height'] = 700

self.text = text = Text(self, wrap=wrap, highlightthickness=0)
        color_config(text)
        text.grid(row=0, column=0, sticky=N+S+E+W)
        self.grid_rowconfigure(0, weight=1)
        self.grid_columnconfigure(0, weight=1)
        text.insert(0.0, rawtext)
        text['state'] = 'disabled'
        text.focus_set()

# vertical scrollbar
        self.yscroll = yscroll = AutoHiddenScrollbar(self, orient=VERTICAL,
                                                     takefocus=False,
                                                     command=text.yview)
        text['yscrollcommand'] = yscroll.set
        yscroll.grid(row=0, column=1, sticky=N+S)

if wrap == 'none':
            # horizontal scrollbar
            self.xscroll = xscroll = AutoHiddenScrollbar(self, orient=HORIZONTAL,
                                                         takefocus=False,
                                                         command=text.xview)
            text['xscrollcommand'] = xscroll.set
            xscroll.grid(row=1, column=0, sticky=E+W)

class ViewFrame(Frame):
    "Display TextFrame and Close button."
    def __init__(self, parent, text, wrap='word'):
        super().__init__(parent)
        self.parent = parent
        self.bind('<Return>', self.ok)
        self.bind('<Escape>', self.ok)
        self.textframe = TextFrame(self, text, wrap=wrap)
        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, wrap='word',
                 *, _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
        wrap - type of text wrapping to use ('word', 'char' or 'none')
        _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, wrap=wrap)
        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')

self.is_modal = modal
        if self.is_modal:
            self.transient(parent)
            self.grab_set()
            if not _utest:
                self.wait_window()

def ok(self, event=None):
        """Dismiss text viewer dialog."""
        if self.is_modal:
            self.grab_release()
        self.destroy()

def view_text(parent, title, text, modal=True, wrap='word', _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
    wrap - type of text wrapping to use ('word', 'char' or 'none')
    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, wrap=wrap, _utest=_utest)

def view_file(parent, title, filename, encoding, modal=True, wrap='word',
              _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, wrap=wrap,
                         _utest=_utest)
    return None

if __name__ == '__main__':
    from unittest import main
    main('idlelib.idle_test.test_textview', verbosity=2, exit=False)

from idlelib.idle_test.htest import run
    run(ViewWindow)

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📁 __pycache__/	DIR	—	2026-10-27 22:57
📁 Icons/	DIR	—	2026-10-27 22:57
📁 idle_test/	DIR	—	2026-10-27 22:57
📄 __init__.py	PY	396 B	2026-10-26 20:27	EDIT
📄 __main__.py	PY	159 B	2026-10-26 20:27	EDIT
📄 _pyclbr.py	PY	14.8 KB	2026-10-26 20:27	EDIT
📄 autocomplete.py	PY	9.1 KB	2026-10-26 20:27	EDIT
📄 autocomplete_w.py	PY	19.4 KB	2026-10-26 20:27	EDIT
📄 autoexpand.py	PY	3.1 KB	2026-10-26 20:27	EDIT
📄 browser.py	PY	8.1 KB	2026-10-26 20:27	EDIT
📄 calltip.py	PY	5.9 KB	2026-10-26 20:27	EDIT
📄 calltip_w.py	PY	6.9 KB	2026-10-26 20:27	EDIT
📄 ChangeLog	?	55 KB	2021-09-04 03:49	EDIT
📄 codecontext.py	PY	10.2 KB	2026-10-26 20:27	EDIT
📄 colorizer.py	PY	11 KB	2026-10-26 20:27	EDIT
📄 config-extensions.def	DEF	2.2 KB	2021-09-04 03:49	EDIT
📄 config-highlight.def	DEF	2.6 KB	2021-09-04 03:49	EDIT
📄 config-keys.def	DEF	10.5 KB	2021-09-04 03:49	EDIT
📄 config-main.def	DEF	3.1 KB	2021-09-04 03:49	EDIT
📄 config.py	PY	38 KB	2026-10-26 20:27	EDIT
📄 config_key.py	PY	13.1 KB	2026-10-26 20:27	EDIT
📄 configdialog.py	PY	98.7 KB	2026-10-26 20:27	EDIT
📄 CREDITS.txt	TXT	1.8 KB	2021-09-04 03:49	EDIT
📄 debugger.py	PY	18.6 KB	2026-10-26 20:27	EDIT
📄 debugger_r.py	PY	11.9 KB	2026-10-26 20:27	EDIT
📄 debugobj.py	PY	4 KB	2026-10-26 20:27	EDIT
📄 debugobj_r.py	PY	1.1 KB	2026-10-26 20:27	EDIT
📄 delegator.py	PY	1 KB	2026-10-26 20:27	EDIT
📄 dynoption.py	PY	2 KB	2026-10-26 20:27	EDIT
📄 editor.py	PY	65.7 KB	2026-10-26 20:27	EDIT
📄 extend.txt	TXT	3.6 KB	2021-09-04 03:49	EDIT
📄 filelist.py	PY	3.8 KB	2026-10-26 20:27	EDIT
📄 grep.py	PY	6.6 KB	2026-10-26 20:27	EDIT
📄 help.html	HTML	53.8 KB	2021-09-04 03:49	EDIT
📄 help.py	PY	11.1 KB	2026-10-26 20:27	EDIT
📄 help_about.py	PY	8.8 KB	2026-10-26 20:27	EDIT
📄 history.py	PY	3.9 KB	2026-10-26 20:27	EDIT
📄 HISTORY.txt	TXT	10.1 KB	2021-09-04 03:49	EDIT
📄 hyperparser.py	PY	12.6 KB	2026-10-26 20:27	EDIT
📄 idle.py	PY	454 B	2026-10-26 20:27	EDIT
📄 idle.pyw	PYW	570 B	2021-09-04 03:49	EDIT
📄 iomenu.py	PY	20.2 KB	2026-10-26 20:27	EDIT
📄 macosx.py	PY	9.4 KB	2026-10-26 20:27	EDIT
📄 mainmenu.py	PY	3.6 KB	2026-10-26 20:27	EDIT
📄 multicall.py	PY	18.2 KB	2026-10-26 20:27	EDIT
📄 NEWS.txt	TXT	38.9 KB	2021-09-04 03:49	EDIT
📄 NEWS2x.txt	TXT	26.5 KB	2021-09-04 03:49	EDIT
📄 outwin.py	PY	5.7 KB	2026-10-26 20:27	EDIT
📄 paragraph.py	PY	7 KB	2026-10-26 20:27	EDIT
📄 parenmatch.py	PY	7 KB	2026-10-26 20:27	EDIT
📄 pathbrowser.py	PY	3.1 KB	2026-10-26 20:27	EDIT
📄 percolator.py	PY	3.1 KB	2026-10-26 20:27	EDIT
📄 pyparse.py	PY	19.6 KB	2026-10-26 20:27	EDIT
📄 pyshell.py	PY	56.4 KB	2026-10-26 20:27	EDIT
📄 query.py	PY	12.1 KB	2026-10-26 20:27	EDIT
📄 README.txt	TXT	9.4 KB	2021-09-04 03:49	EDIT
📄 redirector.py	PY	6.7 KB	2026-10-26 20:27	EDIT
📄 replace.py	PY	7.3 KB	2026-10-26 20:27	EDIT
📄 rpc.py	PY	20.6 KB	2026-10-26 20:27	EDIT
📄 rstrip.py	PY	868 B	2026-10-26 20:27	EDIT
📄 run.py	PY	16.9 KB	2026-10-26 20:27	EDIT
📄 runscript.py	PY	7.7 KB	2026-10-26 20:27	EDIT
📄 scrolledlist.py	PY	4.4 KB	2026-10-26 20:27	EDIT
📄 search.py	PY	3.1 KB	2026-10-26 20:27	EDIT
📄 searchbase.py	PY	7.3 KB	2026-10-26 20:27	EDIT
📄 searchengine.py	PY	7.3 KB	2026-10-26 20:27	EDIT
📄 squeezer.py	PY	13 KB	2026-10-26 20:27	EDIT
📄 stackviewer.py	PY	4.3 KB	2026-10-26 20:27	EDIT
📄 statusbar.py	PY	1.4 KB	2026-10-26 20:27	EDIT
📄 textview.py	PY	6 KB	2026-10-26 20:27	EDIT
📄 TODO.txt	TXT	8.3 KB	2021-09-04 03:49	EDIT
📄 tooltip.py	PY	6.3 KB	2026-10-26 20:27	EDIT
📄 tree.py	PY	14.7 KB	2026-10-26 20:27	EDIT
📄 undo.py	PY	10.8 KB	2026-10-26 20:27	EDIT
📄 window.py	PY	2.5 KB	2026-10-26 20:27	EDIT
📄 zoomheight.py	PY	1.3 KB	2026-10-26 20:27	EDIT
📄 zzdummy.py	PY	961 B	2026-10-26 20:27	EDIT