tksheet 7.3.0__tar.gz → 7.3.2__tar.gz

{tksheet-7.3.0/tksheet.egg-info → tksheet-7.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: tksheet
-Version: 7.3.0
+Version: 7.3.2
 Summary: Tkinter table / sheet widget
 Author-email: ragardner <github@ragardner.simplelogin.com>
 License: Copyright (c) 2019 ragardner and open source contributors
@@ -95,22 +95,21 @@ This library is maintained with the help of **[others](https://github.com/ragard
 
 ## **Features**
 
-- Display and modify tabular data
-- Stores its display data as a Python list of lists, sublists being rows
-- Runs smoothly even with millions of rows/columns
-- Edit cells directly
+- Smoothly display and modify tabular data
+- [Edit cells directly](https://github.com/ragardner/tksheet/wiki/Version-7#table-functionality-and-bindings)
 - Cell values can potentially be [any class](https://github.com/ragardner/tksheet/wiki/Version-7#data-formatting), the default is any class with a `__str__` method
-- Drag and drop columns and rows
+- [Drag and drop columns and rows](https://github.com/ragardner/tksheet/wiki/Version-7#table-functionality-and-bindings)
 - Multiple line header and index cells
-- Expand row heights and column widths
-- Change fonts and font size (not for individual cells)
-- Change any colors in the sheet
+- [Expand row heights and column widths](https://github.com/ragardner/tksheet/wiki/Version-7#table-functionality-and-bindings)
+- [Change fonts and font size (not for individual cells)](https://github.com/ragardner/tksheet/wiki/Version-7#text-font-and-alignment)
+- [Change any colors in the sheet](https://github.com/ragardner/tksheet/wiki/Version-7#sheet-appearance)
 - [Treeview mode](https://github.com/ragardner/tksheet/wiki/Version-7#treeview-mode)
 - [Dropdown boxes](https://github.com/ragardner/tksheet/wiki/Version-7#dropdown-boxes)
 - [Check boxes](https://github.com/ragardner/tksheet/wiki/Version-7#check-boxes)
 - [Progress bars](https://github.com/ragardner/tksheet/wiki/Version-7#progress-bars)
 - [Hide rows and/or columns](https://github.com/ragardner/tksheet/wiki/Version-7#example-header-dropdown-boxes-and-row-filtering)
-- Left `"w"`, Center `"center"` or Right `"e"` text alignment for any cell/row/column
+- [Left `"w"`, Center `"center"` or Right `"e"` text alignment for any cell/row/column](https://github.com/ragardner/tksheet/wiki/Version-7#text-font-and-alignment)
+- [Optional built-in find window](https://github.com/ragardner/tksheet/wiki/Version-7#table-functionality-and-bindings)
 
 ```python
 """

{tksheet-7.3.0 → tksheet-7.3.2}/README.md

@@ -52,22 +52,21 @@ This library is maintained with the help of **[others](https://github.com/ragard
 
 ## **Features**
 
-- Display and modify tabular data
-- Stores its display data as a Python list of lists, sublists being rows
-- Runs smoothly even with millions of rows/columns
-- Edit cells directly
+- Smoothly display and modify tabular data
+- [Edit cells directly](https://github.com/ragardner/tksheet/wiki/Version-7#table-functionality-and-bindings)
 - Cell values can potentially be [any class](https://github.com/ragardner/tksheet/wiki/Version-7#data-formatting), the default is any class with a `__str__` method
-- Drag and drop columns and rows
+- [Drag and drop columns and rows](https://github.com/ragardner/tksheet/wiki/Version-7#table-functionality-and-bindings)
 - Multiple line header and index cells
-- Expand row heights and column widths
-- Change fonts and font size (not for individual cells)
-- Change any colors in the sheet
+- [Expand row heights and column widths](https://github.com/ragardner/tksheet/wiki/Version-7#table-functionality-and-bindings)
+- [Change fonts and font size (not for individual cells)](https://github.com/ragardner/tksheet/wiki/Version-7#text-font-and-alignment)
+- [Change any colors in the sheet](https://github.com/ragardner/tksheet/wiki/Version-7#sheet-appearance)
 - [Treeview mode](https://github.com/ragardner/tksheet/wiki/Version-7#treeview-mode)
 - [Dropdown boxes](https://github.com/ragardner/tksheet/wiki/Version-7#dropdown-boxes)
 - [Check boxes](https://github.com/ragardner/tksheet/wiki/Version-7#check-boxes)
 - [Progress bars](https://github.com/ragardner/tksheet/wiki/Version-7#progress-bars)
 - [Hide rows and/or columns](https://github.com/ragardner/tksheet/wiki/Version-7#example-header-dropdown-boxes-and-row-filtering)
-- Left `"w"`, Center `"center"` or Right `"e"` text alignment for any cell/row/column
+- [Left `"w"`, Center `"center"` or Right `"e"` text alignment for any cell/row/column](https://github.com/ragardner/tksheet/wiki/Version-7#text-font-and-alignment)
+- [Optional built-in find window](https://github.com/ragardner/tksheet/wiki/Version-7#table-functionality-and-bindings)
 
 ```python
 """

{tksheet-7.3.0 → tksheet-7.3.2}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "tksheet"
 description = "Tkinter table / sheet widget"
 readme = "README.md"
-version = "7.3.0"
+version = "7.3.2"
 authors = [{ name = "ragardner", email = "github@ragardner.simplelogin.com" }]
 requires-python = ">=3.8"
 license = {file = "LICENSE.txt"}

{tksheet-7.3.0 → tksheet-7.3.2}/tksheet/__init__.py

@@ -4,7 +4,7 @@
 tksheet - A Python tkinter table widget
 """
 
-__version__ = "7.3.0"
+__version__ = "7.3.2"
 
 from .colors import (
     color_map,
@@ -96,7 +96,7 @@ from .themes import (
     theme_light_green,
 )
 from .top_left_rectangle import TopLeftRectangle
-from .vars import (
+from .constants import (
     USER_OS,
     ctrl_key,
     emitted_events,

{tksheet-7.3.0 → tksheet-7.3.2}/tksheet/column_headers.py

@@ -23,15 +23,25 @@ from typing import Literal
 from .colors import (
     color_map,
 )
+from .constants import (
+    USER_OS,
+    rc_binding,
+    text_editor_close_bindings,
+    text_editor_newline_bindings,
+    text_editor_to_unbind,
+)
 from .formatters import is_bool_like, try_to_bool
 from .functions import (
     consecutive_ranges,
     event_dict,
+    event_has_char_key,
+    event_opens_dropdown_or_checkbox,
     get_n2a,
+    int_x_tuple,
     is_contiguous,
     new_tk_event,
-    stored_event_dict,
     rounded_box_coords,
+    stored_event_dict,
     try_binding,
 )
 from .other_classes import (
@@ -43,13 +53,8 @@ from .other_classes import (
 from .text_editor import (
     TextEditor,
 )
-from .vars import (
-    USER_OS,
-    rc_binding,
-    symbols_set,
-    text_editor_close_bindings,
-    text_editor_newline_bindings,
-    text_editor_to_unbind,
+from .types import (
+    AnyIter,
 )
 
 
@@ -928,20 +933,31 @@ class ColumnHeaders(tk.Canvas):
 
     def select_col(
         self,
-        c: int,
+        c: int | AnyIter[int],
         redraw: bool = False,
         run_binding_func: bool = True,
         ext: bool = False,
-    ) -> int:
+    ) -> int | list[int]:
         boxes_to_hide = tuple(self.MT.selection_boxes)
-        fill_iid = self.MT.create_selection_box(0, c, len(self.MT.row_positions) - 1, c + 1, "columns", ext=ext)
+        fill_iids = [
+            self.MT.create_selection_box(
+                0,
+                start,
+                len(self.MT.row_positions) - 1,
+                end,
+                "columns",
+                set_current=True,
+                ext=ext,
+            )
+            for start, end in consecutive_ranges(int_x_tuple(c))
+        ]
         for iid in boxes_to_hide:
             self.MT.hide_selection_box(iid)
         if redraw:
             self.MT.main_table_redraw_grid_and_text(redraw_header=True, redraw_row_index=True)
         if run_binding_func:
             self.MT.run_selection_binding("columns")
-        return fill_iid
+        return fill_iids[0] if len(fill_iids) == 1 else fill_iids
 
     def add_selection(
         self,
@@ -1657,8 +1673,8 @@ class ColumnHeaders(tk.Canvas):
 
     def get_redraw_selections(self, startc: int, endc: int) -> dict[str, set[int]]:
         d = defaultdict(set)
-        for item, box in self.MT.get_selection_items():
-            r1, c1, r2, c2 = box.coords
+        for _, box in self.MT.get_selection_items():
+            _, c1, _, c2 = box.coords
             for c in range(startc, endc):
                 if c1 <= c and c2 > c:
                     d[box.type_ if box.type_ != "rows" else "cells"].add(c)
@@ -1674,7 +1690,7 @@ class ColumnHeaders(tk.Canvas):
         if self.get_cell_kwargs(datacn, key="readonly"):
             return
         elif self.get_cell_kwargs(datacn, key="dropdown") or self.get_cell_kwargs(datacn, key="checkbox"):
-            if self.MT.event_opens_dropdown_or_checkbox(event):
+            if event_opens_dropdown_or_checkbox(event):
                 if self.get_cell_kwargs(datacn, key="dropdown"):
                     self.open_dropdown_window(c, event=event)
                 elif self.get_cell_kwargs(datacn, key="checkbox"):
@@ -1700,28 +1716,16 @@ class ColumnHeaders(tk.Canvas):
         state: str = "normal",
         dropdown: bool = False,
     ) -> bool:
-        text = None
+        text = f"{self.get_cell_data(self.MT.datacn(c), none_to_empty_str=True, redirect_int=True)}"
         extra_func_key = "??"
-        if event is None or self.MT.event_opens_dropdown_or_checkbox(event):
-            if event is not None:
-                if hasattr(event, "keysym") and event.keysym == "Return":
-                    extra_func_key = "Return"
-                elif hasattr(event, "keysym") and event.keysym == "F2":
-                    extra_func_key = "F2"
-            text = self.get_cell_data(self.MT.datacn(c), none_to_empty_str=True, redirect_int=True)
-        elif event is not None and (
-            (hasattr(event, "keysym") and event.keysym == "BackSpace") or event.keycode in (8, 855638143)
-        ):
-            extra_func_key = "BackSpace"
-            text = ""
-        elif event is not None and (
-            (hasattr(event, "char") and event.char.isalpha())
-            or (hasattr(event, "char") and event.char.isdigit())
-            or (hasattr(event, "char") and event.char in symbols_set)
-        ):
-            extra_func_key = event.char
-            text = event.char
-        else:
+        if event_opens_dropdown_or_checkbox(event):
+            if hasattr(event, "keysym") and event.keysym in ("Return", "F2", "BackSpace"):
+                extra_func_key = event.keysym
+                if event.keysym == "BackSpace":
+                    text = ""
+        elif event_has_char_key(event):
+            extra_func_key = text = event.char
+        elif event is not None:
             return False
         if self.extra_begin_edit_cell_func:
             try:
@@ -1743,14 +1747,13 @@ class ColumnHeaders(tk.Canvas):
                 return False
             else:
                 text = text if isinstance(text, str) else f"{text}"
-        text = "" if text is None else text
         if self.PAR.ops.cell_auto_resize_enabled:
             if self.height_resizing_enabled:
                 self.set_height_of_header_to_text(text)
             self.set_col_width_run_binding(c)
         if self.text_editor.open and c == self.text_editor.column:
             self.text_editor.set_text(self.text_editor.get() + "" if not isinstance(text, str) else text)
-            return
+            return False
         self.hide_text_editor()
         if not self.MT.see(r=0, c=c, keep_yscroll=True, check_cell_visibility=True):
             self.MT.refresh()
@@ -1758,8 +1761,6 @@ class ColumnHeaders(tk.Canvas):
         y = 0
         w = self.MT.col_positions[c + 1] - x
         h = self.current_height + 1
-        if text is None:
-            text = self.get_cell_data(self.MT.datacn(c), none_to_empty_str=True, redirect_int=True)
         kwargs = {
             "menu_kwargs": DotDict(
                 {

tksheet-7.3.2/tksheet/find_window.py

@@ -0,0 +1,251 @@
+from __future__ import annotations
+
+import tkinter as tk
+from collections.abc import (
+    Callable,
+)
+from typing import Literal
+
+from .other_classes import (
+    DotDict,
+)
+from .constants import (
+    ctrl_key,
+    rc_binding,
+)
+from .functions import (
+    recursive_bind,
+)
+
+
+class FindWindowTkText(tk.Text):
+    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,
+        font: tuple,
+        bg: str,
+        fg: str,
+        select_bg: str,
+        select_fg: str,
+    ) -> None:
+        self.config(
+            font=font,
+            background=bg,
+            foreground=fg,
+            insertbackground=fg,
+            selectbackground=select_bg,
+            selectforeground=select_fg,
+        )
+        self.editor_del_key = sheet_ops.editor_del_key
+        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,
+            command=self.select_all,
+            **menu_kwargs,
+        )
+        self.rc_popup_menu.add_command(
+            label=sheet_ops.cut_label,
+            accelerator=sheet_ops.cut_accelerator,
+            command=self.cut,
+            **menu_kwargs,
+        )
+        self.rc_popup_menu.add_command(
+            label=sheet_ops.copy_label,
+            accelerator=sheet_ops.copy_accelerator,
+            command=self.copy,
+            **menu_kwargs,
+        )
+        self.rc_popup_menu.add_command(
+            label=sheet_ops.paste_label,
+            accelerator=sheet_ops.paste_accelerator,
+            command=self.paste,
+            **menu_kwargs,
+        )
+        self.rc_popup_menu.add_command(
+            label=sheet_ops.undo_label,
+            accelerator=sheet_ops.undo_accelerator,
+            command=self.undo,
+            **menu_kwargs,
+        )
+
+    def rc(self, event: object) -> None:
+        self.focus_set()
+        self.rc_popup_menu.tk_popup(event.x_root, event.y_root)
+
+    def delete_key(self, event: object = None) -> None:
+        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: object = None) -> Literal["break"]:
+        self.tag_add(tk.SEL, "1.0", tk.END)
+        self.mark_set(tk.INSERT, tk.END)
+        # self.see(tk.INSERT)
+        return "break"
+
+    def cut(self, event: object = None) -> Literal["break"]:
+        self.event_generate(f"<{ctrl_key}-x>")
+        self.event_generate("<KeyRelease>")
+        return "break"
+
+    def copy(self, event: object = None) -> Literal["break"]:
+        self.event_generate(f"<{ctrl_key}-c>")
+        return "break"
+
+    def paste(self, event: object = None) -> Literal["break"]:
+        self.event_generate(f"<{ctrl_key}-v>")
+        self.event_generate("<KeyRelease>")
+        return "break"
+
+    def undo(self, event: object = None) -> Literal["break"]:
+        self.event_generate(f"<{ctrl_key}-z>")
+        self.event_generate("<KeyRelease>")
+        return "break"
+
+
+class FindWindow(tk.Frame):
+    def __init__(
+        self,
+        parent: tk.Misc,
+        find_next_func: Callable,
+        find_prev_func: Callable,
+        close_func: Callable,
+    ) -> None:
+        super().__init__(
+            parent,
+            width=0,
+            height=0,
+            bd=0,
+        )
+        self.grid_columnconfigure(0, weight=1)
+        self.grid_rowconfigure(0, weight=1)
+        self.grid_propagate(False)
+        self.parent = parent
+        self.tktext = FindWindowTkText(self)
+        self.tktext.grid(row=0, column=0, sticky="nswe")
+        self.bg = None
+        self.fg = None
+
+        self.find_previous_arrow = tk.Label(self, text="▲", cursor="hand2", highlightthickness=1)
+        self.find_previous_arrow.bind("<Button-1>", find_prev_func)
+        self.find_previous_arrow.grid(row=0, column=1)
+
+        self.find_next_arrow = tk.Label(self, text="▼", cursor="hand2", highlightthickness=1)
+        self.find_next_arrow.bind("<Button-1>", find_next_func)
+        self.find_next_arrow.grid(row=0, column=2)
+
+        self.find_in_selection = False
+        self.in_selection = tk.Label(self, text="🔎", cursor="hand2", highlightthickness=1)
+        self.in_selection.bind("<Button-1>", self.toggle_in_selection)
+        self.in_selection.grid(row=0, column=3)
+
+        self.close = tk.Label(self, text="✕", cursor="hand2", highlightthickness=1)
+        self.close.bind("<Button-1>", close_func)
+        self.close.grid(row=0, column=4)
+
+        for widget in (self.find_previous_arrow, self.find_next_arrow, self.in_selection, self.close):
+            widget.bind("<Enter>", lambda w, widget=widget: self.enter_label(widget=widget))
+            widget.bind("<Leave>", lambda w, widget=widget: self.leave_label(widget=widget))
+
+        for b in ("Option", "Alt"):
+            for c in ("l", "L"):
+                recursive_bind(self, f"<{b}-{c}>", self.toggle_in_selection)
+
+    def enter_label(self, widget: tk.Misc) -> None:
+        widget.config(
+            highlightbackground=self.fg,
+            highlightcolor=self.fg,
+        )
+
+    def leave_label(self, widget: tk.Misc) -> None:
+        if widget == self.in_selection and self.find_in_selection:
+            return
+        widget.config(
+            highlightbackground=self.bg,
+            highlightcolor=self.fg,
+        )
+
+    def toggle_in_selection(self, event: tk.Misc) -> None:
+        self.find_in_selection = not self.find_in_selection
+        self.enter_label(self.in_selection)
+        self.leave_label(self.in_selection)
+
+    def get(self) -> str:
+        return self.tktext.get("1.0", "end-1c")
+
+    def get_num_lines(self) -> int:
+        return int(self.tktext.index("end-1c").split(".")[0])
+
+    def set_text(self, text: str = "") -> None:
+        self.tktext.delete(1.0, "end")
+        self.tktext.insert(1.0, text)
+
+    def reset(
+        self,
+        border_color: str,
+        menu_kwargs: DotDict,
+        sheet_ops: DotDict,
+        bg: str,
+        fg: str,
+        select_bg: str,
+        select_fg: str,
+    ) -> None:
+        self.bg = bg
+        self.fg = fg
+        self.tktext.reset(
+            menu_kwargs=menu_kwargs,
+            sheet_ops=sheet_ops,
+            font=menu_kwargs.font,
+            bg=bg,
+            fg=fg,
+            select_bg=select_bg,
+            select_fg=select_fg,
+        )
+        for widget in (self.find_previous_arrow, self.find_next_arrow, self.in_selection, self.close):
+            widget.config(
+                font=menu_kwargs.font,
+                bg=bg,
+                fg=fg,
+                highlightbackground=bg,
+                highlightcolor=fg,
+            )
+        if self.find_in_selection:
+            self.enter_label(self.in_selection)
+        self.config(
+            background=bg,
+            highlightbackground=border_color,
+            highlightcolor=border_color,
+            highlightthickness=1,
+        )

{tksheet-7.3.0 → tksheet-7.3.2}/tksheet/formatters.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from collections.abc import Callable
 
-from .vars import falsy, nonelike, truthy
+from .constants import falsy, nonelike, truthy
 
 
 def is_none_like(o: object) -> bool: