tksheet 7.5.5__py3-none-any.whl → 7.5.7__py3-none-any.whl

tksheet/tooltip.py

@@ -0,0 +1,335 @@
+from __future__ import annotations
+
+import tkinter as tk
+from tkinter import ttk
+from typing import Any, Literal
+
+from .constants import ctrl_key, rc_binding
+
+
+class TooltipTkText(tk.Text):
+    """Custom Text widget for the Tooltip class."""
+
+    def __init__(
+        self,
+        parent: tk.Misc,
+    ) -> None:
+        super().__init__(
+            parent,
+            spacing1=0,
+            spacing2=1,
+            spacing3=0,
+            bd=0,
+            highlightthickness=0,
+            undo=True,
+            maxundo=30,
+        )
+        self.parent = parent
+        self.rc_popup_menu = tk.Menu(self, tearoff=0)
+        self.bind("<1>", lambda event: self.focus_set())
+        self.bind(rc_binding, self.rc)
+        self.bind(f"<{ctrl_key}-a>", self.select_all)
+        self.bind(f"<{ctrl_key}-A>", self.select_all)
+        self.bind("<Delete>", self.delete_key)
+
+    def reset(
+        self,
+        menu_kwargs: dict,
+        sheet_ops: dict,
+        bg: str,
+        fg: str,
+        select_bg: str,
+        select_fg: str,
+        text: str,
+        readonly: bool,
+    ) -> None:
+        """Reset the text widget's appearance and menu options."""
+        self.config(
+            font=sheet_ops.table_font,
+            background=bg,
+            foreground=fg,
+            insertbackground=fg,
+            selectbackground=select_bg,
+            selectforeground=select_fg,
+        )
+        self.editor_del_key = sheet_ops.editor_del_key
+        self.config(state="normal")
+        self.delete(1.0, "end")
+        self.insert(1.0, text)
+        self.edit_reset()
+        self.rc_popup_menu.delete(0, "end")
+        self.rc_popup_menu.add_command(
+            label=sheet_ops.select_all_label,
+            accelerator=sheet_ops.select_all_accelerator,
+            image=sheet_ops.select_all_image,
+            compound=sheet_ops.select_all_compound,
+            command=self.select_all,
+            **menu_kwargs,
+        )
+        if not readonly:
+            self.rc_popup_menu.add_command(
+                label=sheet_ops.cut_label,
+                accelerator=sheet_ops.cut_accelerator,
+                image=sheet_ops.cut_image,
+                compound=sheet_ops.cut_compound,
+                command=self.cut,
+                **menu_kwargs,
+            )
+        self.rc_popup_menu.add_command(
+            label=sheet_ops.copy_label,
+            accelerator=sheet_ops.copy_accelerator,
+            image=sheet_ops.copy_image,
+            compound=sheet_ops.copy_compound,
+            command=self.copy,
+            **menu_kwargs,
+        )
+        if not readonly:
+            self.rc_popup_menu.add_command(
+                label=sheet_ops.paste_label,
+                accelerator=sheet_ops.paste_accelerator,
+                image=sheet_ops.paste_image,
+                compound=sheet_ops.paste_compound,
+                command=self.paste,
+                **menu_kwargs,
+            )
+            self.rc_popup_menu.add_command(
+                label=sheet_ops.undo_label,
+                accelerator=sheet_ops.undo_accelerator,
+                image=sheet_ops.undo_image,
+                compound=sheet_ops.undo_compound,
+                command=self.undo,
+                **menu_kwargs,
+            )
+            self.rc_popup_menu.add_command(
+                label=sheet_ops.redo_label,
+                accelerator=sheet_ops.redo_accelerator,
+                image=sheet_ops.redo_image,
+                compound=sheet_ops.redo_compound,
+                command=self.redo,
+                **menu_kwargs,
+            )
+
+    def rc(self, event: Any) -> None:
+        """Show the right-click popup menu."""
+        self.rc_popup_menu.tk_popup(event.x_root, event.y_root)
+        self.focus_set()
+
+    def delete_key(self, event: Any = None) -> None:
+        """Handle the Delete key based on editor configuration."""
+        if self.editor_del_key == "forward":
+            return
+        elif not self.editor_del_key:
+            return "break"
+        elif self.editor_del_key == "backward":
+            if self.tag_ranges("sel"):
+                return
+            if self.index("insert") == "1.0":
+                return "break"
+            self.delete("insert-1c")
+            return "break"
+
+    def select_all(self, event: Any = None) -> Literal["break"]:
+        """Select all text in the widget."""
+        self.tag_add(tk.SEL, "1.0", "end-1c")
+        self.mark_set(tk.INSERT, "end-1c")
+        return "break"
+
+    def cut(self, event: Any = None) -> Literal["break"]:
+        """Cut selected text."""
+        self.event_generate(f"<{ctrl_key}-x>")
+        self.event_generate("<KeyRelease>")
+        return "break"
+
+    def copy(self, event: Any = None) -> Literal["break"]:
+        """Copy selected text."""
+        self.event_generate(f"<{ctrl_key}-c>")
+        return "break"
+
+    def paste(self, event: Any = None) -> Literal["break"]:
+        """Paste text from clipboard."""
+        self.event_generate(f"<{ctrl_key}-v>")
+        self.event_generate("<KeyRelease>")
+        return "break"
+
+    def undo(self, event: Any = None) -> Literal["break"]:
+        """Undo the last action."""
+        self.event_generate(f"<{ctrl_key}-z>")
+        self.event_generate("<KeyRelease>")
+        return "break"
+
+    def redo(self, event: Any = None) -> Literal["break"]:
+        self.event_generate(f"<{ctrl_key}-Shift-z>")
+        self.event_generate("<KeyRelease>")
+        return "break"
+
+
+class Tooltip(tk.Toplevel):
+    def __init__(
+        self,
+        parent: tk.Misc,
+        sheet_ops: dict,
+        menu_kwargs: dict,
+        bg: str,
+        fg: str,
+        select_bg: str,
+        select_fg: str,
+        scrollbar_style: str,
+    ) -> None:
+        super().__init__(parent)
+        self.withdraw()  # Hide until positioned
+        self.overrideredirect(True)  # Borderless window
+        self.cell_readonly = True
+        self.note_readonly = True
+
+        # Store parameters
+        self.sheet_ops = sheet_ops
+        self.menu_kwargs = menu_kwargs
+        self.font = sheet_ops.table_font
+        self.bg = bg
+        self.fg = fg
+        self.select_bg = select_bg
+        self.select_fg = select_fg
+        self.row = 0
+        self.col = 0
+
+        # Create border frame for visual distinction
+        self.border_frame = tk.Frame(self, background=bg)
+        self.border_frame.pack(fill="both", expand=True, padx=1, pady=1)
+
+        # Create notebook, but don’t pack it yet
+        self.notebook = ttk.Notebook(self.border_frame)
+
+        # Content frame as child of border_frame
+        self.content_frame = ttk.Frame(self.border_frame)
+        self.content_text = TooltipTkText(self.content_frame)
+        self.content_scrollbar = ttk.Scrollbar(self.content_frame, orient="vertical", style=scrollbar_style)
+        self.content_scrollbar.pack(side="right", fill="y")
+        self.content_text.pack(side="left", fill="both", expand=True)
+        self.content_scrollbar.configure(command=self.content_text.yview)
+        self.content_text.configure(yscrollcommand=self.content_scrollbar.set)
+
+        # Note frame as child of border_frame
+        self.note_frame = ttk.Frame(self.border_frame)
+        self.note_text = TooltipTkText(self.note_frame)
+        self.note_scrollbar = ttk.Scrollbar(self.note_frame, orient="vertical", style=scrollbar_style)
+        self.note_scrollbar.pack(side="right", fill="y")
+        self.note_text.pack(side="left", fill="both", expand=True)
+        self.note_scrollbar.configure(command=self.note_text.yview)
+        self.note_text.configure(yscrollcommand=self.note_scrollbar.set)
+
+    def setup_note_only_mode(self):
+        """Configure the tooltip to show only the note text widget."""
+        self.notebook.pack_forget()  # Remove notebook from layout
+        for tab in self.notebook.tabs():  # Clear all tabs to free the frames
+            self.notebook.forget(tab)
+        self.content_frame.pack_forget()  # Ensure content_frame is not directly packed
+        self.note_frame.pack(fill="both", expand=True)  # Show note_frame directly
+
+    def setup_single_text_mode(self):
+        """Configure the tooltip to show only the content text widget."""
+        self.notebook.pack_forget()  # Remove notebook from layout
+        for tab in self.notebook.tabs():  # Clear all tabs
+            self.notebook.forget(tab)
+        self.note_frame.pack_forget()  # Ensure note_frame is not directly packed
+        self.content_frame.pack(fill="both", expand=True)  # Show content_frame directly
+
+    def setup_notebook_mode(self):
+        """Configure the tooltip to show a notebook with Cell and Note tabs."""
+        self.content_frame.pack_forget()  # Ensure content_frame is not directly packed
+        self.note_frame.pack_forget()  # Ensure note_frame is not directly packed
+        self.notebook.add(self.content_frame, text="Cell")  # Add content tab
+        self.notebook.add(self.note_frame, text="Note")  # Add note tab
+        self.notebook.pack(fill="both", expand=True)  # Show notebook
+        self.notebook.select(0)  # Select the "Cell" tab by default
+
+    def reset(
+        self,
+        text: str,
+        cell_readonly: bool,
+        note: str | None,
+        note_readonly: bool,
+        row: int,
+        col: int,
+        menu_kwargs: dict,
+        bg: str,
+        fg: str,
+        select_bg: str,
+        select_fg: str,
+        user_can_create_notes: bool,
+        note_only: bool,
+        width: int,
+        height: int,
+    ) -> None:
+        self.cell_readonly = cell_readonly
+        self.note_readonly = note_readonly
+        self.menu_kwargs = menu_kwargs
+        self.font = self.sheet_ops.table_font
+        self.bg = bg
+        self.fg = fg
+        self.select_bg = select_bg
+        self.select_fg = select_fg
+        self.row = row
+        self.col = col
+        self.config(bg=self.sheet_ops.table_selected_box_cells_fg)
+        self.border_frame.config(background=bg)
+        self.content_text.configure(
+            wrap="word",
+            width=30,
+            height=5,
+            state="disabled" if cell_readonly else "normal",
+        )
+        kws = {
+            "menu_kwargs": menu_kwargs,
+            "sheet_ops": self.sheet_ops,
+            "bg": bg,
+            "fg": fg,
+            "select_bg": select_bg,
+            "select_fg": select_fg,
+        }
+        self.content_text.reset(**kws, text=text, readonly=cell_readonly)
+        self.content_text.configure(state="disabled" if cell_readonly else "normal")
+        self.note_text.configure(
+            wrap="word",
+            width=30,
+            height=5,
+        )
+        self.note_text.reset(**kws, text="" if note is None else note, readonly=note_readonly)
+        self.note_text.configure(state="disabled" if note_readonly else "normal")
+        # Set up UI based on condition
+        if note_only:
+            self.setup_note_only_mode()
+        elif note is None and not user_can_create_notes:
+            self.setup_single_text_mode()
+        else:
+            self.setup_notebook_mode()
+        self.adjust_size(width, height)
+
+    def adjust_size(self, width, height) -> None:
+        """Adjust tooltip size to given dimensions."""
+        self.update_idletasks()
+        self.geometry(f"{width}x{height}")
+
+    def set_position(self, x_root: int, y_root: int) -> None:
+        """Position tooltip near the cell, avoiding screen edges."""
+        self.update_idletasks()
+        screen_width = self.winfo_screenwidth()
+        screen_height = self.winfo_screenheight()
+        width = self.winfo_width()
+        height = self.winfo_height()
+
+        # Adjust position to avoid screen edges
+        x = min(x_root, screen_width - width)
+        y = min(y_root, screen_height - height)
+        self.geometry(f"+{x}+{y}")
+        self.deiconify()
+
+    def get(self) -> tuple[int, int, str, str]:
+        return (
+            self.row,
+            self.col,
+            self.content_text.get("1.0", "end-1c"),
+            self.note_text.get("1.0", "end-1c"),
+        )
+
+    def destroy(self) -> None:
+        super().destroy()

{tksheet-7.5.5.dist-info → tksheet-7.5.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tksheet
-Version: 7.5.5
+Version: 7.5.7
 Summary: Tkinter table / sheet and treeview widget
 Author-email: ragardner <github@ragardner.simplelogin.com>
 License: Copyright (c) 2019 ragardner and open source contributors

tksheet-7.5.7.dist-info/RECORD

@@ -0,0 +1,24 @@
+tksheet/__init__.py,sha256=vNYNahxYlUHr2qV4kIpNVoZMDpCTWetLSBK0t4le_5o,2532
+tksheet/colors.py,sha256=dHhmdFuQDlwohDHsAfT9VdrKoSl_R33L72a3HCin5zo,51591
+tksheet/column_headers.py,sha256=5hwloDxaBO2wf_3qJbDDJWX8I8rKx-WPwv0UPWQ9xnk,110618
+tksheet/constants.py,sha256=4cpU_PmOgN0isBVPWwCwBwqD8Fxnu4HJgDSSjfxjiPo,25467
+tksheet/find_window.py,sha256=aV2U-IDFL6xNRhF4VomdrXEML4qw6QBqlfrVskuiTNY,20954
+tksheet/formatters.py,sha256=r2vjgmKs_xWBYlfqVhPPNKQc67zCawOIl4dp4XAEzYg,10182
+tksheet/functions.py,sha256=8S5u8GXl-uHxsRfGqG5Vt5ec7nOql7QczvTWSNuoRPg,56109
+tksheet/main_table.py,sha256=5pdbQo245ahAXuJpsSNQEkPJHjJ7ETX1yNXdXrL-b7Q,367497
+tksheet/menus.py,sha256=sRHZRgnYWddBtlzvbyWFSN2cVhlmUWyA9zf4vpqun7I,19431
+tksheet/other_classes.py,sha256=6LpexHAxj23ZweuL3a4yCcdMSj_iXP38S7WRNQAehe0,18354
+tksheet/row_index.py,sha256=-B-Fqz-HueJSsygKFFtcwrLUMe-O9MSeemaiCtVvfCo,146992
+tksheet/sheet.py,sha256=i3h1FBko5dAdlWcv57WoP8e2NorRXk2eC_kACYaLK1Q,271847
+tksheet/sheet_options.py,sha256=dhHY4jUULGXH2b_VOjoAfKXm3PAz7QL5CrVnHA0byho,14697
+tksheet/sorting.py,sha256=zcZPpRtP1h_xJGtGkG3E43H7deKQFnh9cMwZ1B2-aGc,17502
+tksheet/text_editor.py,sha256=Ksz4kT7TrCIzDhRZK9EM54M7R_5CvrwC1aeTrUPNOTg,8391
+tksheet/themes.py,sha256=kUUCUmvgu8vUlzfVNk9a3BEbeBcU3asNwPB_u-OejCY,18471
+tksheet/tksheet_types.py,sha256=qthH565jq60QCAeczvIWttIa4X5rFfLWPSwWBMDPilw,4611
+tksheet/tooltip.py,sha256=TTWk3HW5Sltamish9GCnAECwZLa9Rm6QC8-RCDDtQnE,12374
+tksheet/top_left_rectangle.py,sha256=A4wWL8PFl57Pn2Ek71rASCE1-bW844cTl7bgt4tLWzI,8499
+tksheet-7.5.7.dist-info/licenses/LICENSE.txt,sha256=n1UvJHBr-AYNOf6ExICDsEggh9R7U4V4m_gH7FD-y-o,2305
+tksheet-7.5.7.dist-info/METADATA,sha256=2n-VXhCSwYtl-7EZHyVGXXKyc4Jyh6R-tdlemz3QiuY,9474
+tksheet-7.5.7.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+tksheet-7.5.7.dist-info/top_level.txt,sha256=my61PXCcck_HHAc9cq3NAlyAr3A3FXxCy9gptEOaCN8,8
+tksheet-7.5.7.dist-info/RECORD,,

{tksheet-7.5.5.dist-info → tksheet-7.5.7.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.3.1)
+Generator: setuptools (80.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

tksheet-7.5.5.dist-info/RECORD

@@ -1,22 +0,0 @@
-tksheet/__init__.py,sha256=yXPme5a60Uus2oMIIqxg48ULgXvAvzZ2Mfjc2jesjCg,2532
-tksheet/colors.py,sha256=dHhmdFuQDlwohDHsAfT9VdrKoSl_R33L72a3HCin5zo,51591
-tksheet/column_headers.py,sha256=LioLw6JPuSqRD4E2b5EVfeEtz1Kja7N3ad7DdSf8HFs,103401
-tksheet/constants.py,sha256=f-w31-cmBt2PNcCYWYnpWgi7vNzqpFqJKqZoE9HXlRs,25454
-tksheet/find_window.py,sha256=6WMoCZcUbSLwIQNui4VwXfXhP9qtRp6-NE7UlwIaU2M,20929
-tksheet/formatters.py,sha256=DGcRiMsDJnySNpQcjfiX84oJ7TmOSMdU6u9injIhA4g,10095
-tksheet/functions.py,sha256=gonxCkLi6S9OeeAbf3bDeOJm3p3j447tjP9iXW9wCE8,53822
-tksheet/main_table.py,sha256=gFJCJJEiuN46ZyuQDxoP3UEx5ihCXD3lK5xldQcHtBU,378985
-tksheet/other_classes.py,sha256=fKgQRnv8r4ZCum1twz22WKMlUmDMW_qpQV9L8A5BxU8,18203
-tksheet/row_index.py,sha256=Yyk46EQRshGTymvaCBW-nBLmXLR2fnJJbOwIIGQpmYs,139822
-tksheet/sheet.py,sha256=J7WzFHzeuK8QU7EhBHmGPteGswjo0BrSo9ACNdibNBo,269459
-tksheet/sheet_options.py,sha256=bB-XBs1sL2w9a47wSM6GD960ZKbvQuU2VvYIK2JRSjE,14567
-tksheet/sorting.py,sha256=zcZPpRtP1h_xJGtGkG3E43H7deKQFnh9cMwZ1B2-aGc,17502
-tksheet/text_editor.py,sha256=Ksz4kT7TrCIzDhRZK9EM54M7R_5CvrwC1aeTrUPNOTg,8391
-tksheet/themes.py,sha256=kUUCUmvgu8vUlzfVNk9a3BEbeBcU3asNwPB_u-OejCY,18471
-tksheet/tksheet_types.py,sha256=1MjXR34EmvP1KfHlLTvKKVnf0VMz_LU_WOM2q4o5hfI,4598
-tksheet/top_left_rectangle.py,sha256=A4wWL8PFl57Pn2Ek71rASCE1-bW844cTl7bgt4tLWzI,8499
-tksheet-7.5.5.dist-info/licenses/LICENSE.txt,sha256=n1UvJHBr-AYNOf6ExICDsEggh9R7U4V4m_gH7FD-y-o,2305
-tksheet-7.5.5.dist-info/METADATA,sha256=wi3r4icBchk8jhbc7_5xFZWS70B874jVkt6ttjqmFgE,9474
-tksheet-7.5.5.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-tksheet-7.5.5.dist-info/top_level.txt,sha256=my61PXCcck_HHAc9cq3NAlyAr3A3FXxCy9gptEOaCN8,8
-tksheet-7.5.5.dist-info/RECORD,,