tksheet 7.2.3__py3-none-any.whl → 7.2.4__py3-none-any.whl

tksheet/__init__.py

@@ -4,7 +4,7 @@
 tksheet - A Python tkinter table widget
 """
 
-__version__ = "7.2.3"
+__version__ = "7.2.4"
 
 from .colors import (
     color_map,

tksheet/column_headers.py

@@ -1440,7 +1440,7 @@ class ColumnHeaders(tk.Canvas):
             ]
             for c in range(grid_start_col, grid_end_col):
                 draw_x = self.MT.col_positions[c]
-                if self.width_resizing_enabled:
+                if c and self.width_resizing_enabled:
                     self.visible_col_dividers[c] = (draw_x - 2, 1, draw_x + 2, yend)
                 points.extend(
                     (

tksheet/main_table.py

@@ -84,6 +84,7 @@ from .other_classes import (
     EventDataDict,
     FontTuple,
     Loc,
+    ProgressBar,
     Selected,
     SelectionBox,
     TextEditorStorage,
@@ -165,6 +166,7 @@ class MainTable(tk.Canvas):
         self.col_options = {}
         self.row_options = {}
         self.purge_undo_and_redo_stack()
+        self.progress_bars = {}
 
         self.extra_table_rc_menu_funcs = {}
         self.extra_index_rc_menu_funcs = {}
@@ -1102,6 +1104,7 @@ class MainTable(tk.Canvas):
                 tags: {(k[0], full_new_idxs[k[1]]) for k in tagged} for tags, tagged in self.tagged_cells.items()
             }
             self.cell_options = {(k[0], full_new_idxs[k[1]]): v for k, v in self.cell_options.items()}
+            self.progress_bars = {(k[0], full_new_idxs[k[1]]): v for k, v in self.progress_bars.items()}
             self.col_options = {full_new_idxs[k]: v for k, v in self.col_options.items()}
             self.tagged_columns = {
                 tags: {full_new_idxs[k] for k in tagged} for tags, tagged in self.tagged_columns.items()
@@ -1341,6 +1344,7 @@ class MainTable(tk.Canvas):
                 tags: {(full_new_idxs[k[0]], k[1]) for k in tagged} for tags, tagged in self.tagged_cells.items()
             }
             self.cell_options = {(full_new_idxs[k[0]], k[1]): v for k, v in self.cell_options.items()}
+            self.progress_bars = {(full_new_idxs[k[0]], k[1]): v for k, v in self.progress_bars.items()}
             self.tagged_rows = {tags: {full_new_idxs[k] for k in tagged} for tags, tagged in self.tagged_rows.items()}
             self.row_options = {full_new_idxs[k]: v for k, v in self.row_options.items()}
             self.RI.cell_options = {full_new_idxs[k]: v for k, v in self.RI.cell_options.items()}
@@ -3981,6 +3985,9 @@ class MainTable(tk.Canvas):
         self.cell_options = {
             (r, c if not (num := bisect_right(cols, c)) else c + num): v for (r, c), v in self.cell_options.items()
         }
+        self.progress_bars = {
+            (r, c if not (num := bisect_right(cols, c)) else c + num): v for (r, c), v in self.progress_bars.items()
+        }
         self.tagged_columns = {
             tags: {c if not (num := bisect_right(cols, c)) else c + num for c in tagged}
             for tags, tagged in self.tagged_columns.items()
@@ -4050,6 +4057,9 @@ class MainTable(tk.Canvas):
         self.cell_options = {
             (r if not (num := bisect_right(rows, r)) else r + num, c): v for (r, c), v in self.cell_options.items()
         }
+        self.progress_bars = {
+            (r if not (num := bisect_right(rows, r)) else r + num, c): v for (r, c), v in self.progress_bars.items()
+        }
         self.tagged_rows = {
             tags: {r if not (num := bisect_right(rows, r)) else r + num for r in tagged}
             for tags, tagged in self.tagged_rows.items()
@@ -4139,6 +4149,14 @@ class MainTable(tk.Canvas):
             for (r, c), v in self.cell_options.items()
             if c not in to_del
         }
+        self.progress_bars = {
+            (
+                r,
+                c if not (num := bisect_left(to_bis, c)) else c - num,
+            ): v
+            for (r, c), v in self.progress_bars.items()
+            if c not in to_del
+        }
         self.tagged_columns = {
             tags: {c if not (num := bisect_left(to_bis, c)) else c - num for c in tagged if c not in to_del}
             for tags, tagged in self.tagged_columns.items()
@@ -4219,6 +4237,14 @@ class MainTable(tk.Canvas):
             for (r, c), v in self.cell_options.items()
             if r not in to_del
         }
+        self.progress_bars = {
+            (
+                r if not (num := bisect_left(to_bis, r)) else r - num,
+                c,
+            ): v
+            for (r, c), v in self.progress_bars.items()
+            if r not in to_del
+        }
         self.tagged_rows = {
             tags: {r if not (num := bisect_left(to_bis, r)) else r - num for r in tagged if r not in to_del}
             for tags, tagged in self.tagged_rows.items()
@@ -5059,7 +5085,10 @@ class MainTable(tk.Canvas):
         can_width: int | None,
     ) -> str:
         redrawn = False
-        kwargs = self.get_cell_kwargs(datarn, datacn, key="highlight")
+        if (datarn, datacn) in self.progress_bars:
+            kwargs = self.progress_bars[(datarn, datacn)]
+        else:
+            kwargs = self.get_cell_kwargs(datarn, datacn, key="highlight")
         if kwargs:
             if kwargs[0] is not None:
                 c_1 = kwargs[0] if kwargs[0].startswith("#") else color_map[kwargs[0]]
@@ -5104,11 +5133,12 @@ class MainTable(tk.Canvas):
                 if kwargs[0] is not None:
                     fill = kwargs[0]
             if kwargs[0] is not None:
-                redrawn = self.redraw_highlight(
-                    fc + 1,
-                    fr + 1,
-                    sc,
-                    sr,
+                highlight_fn = partial(
+                    self.redraw_highlight,
+                    x1=fc + 1,
+                    y1=fr + 1,
+                    x2=sc,
+                    y2=sr,
                     fill=fill,
                     outline=(
                         self.PAR.ops.table_fg
@@ -5116,8 +5146,20 @@ class MainTable(tk.Canvas):
                         else ""
                     ),
                     tag="hi",
-                    can_width=can_width if (len(kwargs) > 2 and kwargs[2]) else None,
                 )
+                if isinstance(kwargs, ProgressBar):
+                    if kwargs.del_when_done and kwargs.percent >= 100:
+                        del self.progress_bars[(datarn, datacn)]
+                    else:
+                        redrawn = highlight_fn(
+                            can_width=None,
+                            pc=kwargs.percent,
+                        )
+                else:
+                    redrawn = highlight_fn(
+                        can_width=can_width if (len(kwargs) > 2 and kwargs[2]) else None,
+                        pc=None,
+                    )
         elif not kwargs:
             if "cells" in selections and (r, c) in selections["cells"]:
                 tf = self.PAR.ops.table_selected_cells_fg
@@ -5130,13 +5172,15 @@ class MainTable(tk.Canvas):
         return tf, redrawn
 
     def redraw_highlight(self, x1, y1, x2, y2, fill, outline, tag, can_width=None, pc=None):
-        if not is_type_int(pc) or pc >= 100 or pc <= 0:
+        if not is_type_int(pc) or pc >= 100:
             coords = (
                 x1 - 1 if outline else x1,
                 y1 - 1 if outline else y1,
                 x2 if can_width is None else x2 + can_width,
                 y2,
             )
+        elif pc <= 0:
+            coords = (x1, y1, x1, y2)
         else:
             coords = (x1, y1, (x2 - x1) * (pc / 100), y2)
         if self.hidd_high:

tksheet/other_classes.py

@@ -36,7 +36,6 @@ Highlight = namedtuple(
 DrawnItem = namedtuple("DrawnItem", "iid showing")
 TextCfg = namedtuple("TextCfg", "txt tf font align")
 DraggedRowColumn = namedtuple("DraggedRowColumn", "dragged to_move")
-ProgressBar = namedtuple("ProgressBar", "bg fg pc name")
 
 
 def num2alpha(n: int) -> str | None:
@@ -470,3 +469,31 @@ Selected = namedtuple(
         None,
     ),
 )
+
+
+class ProgressBar:
+    __slots__ = ("bg", "fg", "name", "percent", "del_when_done")
+
+    def __init__(self, bg: str, fg: str, name: Hashable, percent: int, del_when_done: bool) -> None:
+        self.bg = bg
+        self.fg = fg
+        self.name = name
+        self.percent = percent
+        self.del_when_done = del_when_done
+
+    def __len__(self):
+        return 2
+
+    def __getitem__(self, key: Hashable) -> object:
+        if key == 0:
+            return self.bg
+        elif key == 1:
+            return self.fg
+        elif key == 2:
+            return self.name
+        elif key == 3:
+            return self.percent
+        elif key == 4:
+            return self.del_when_done
+        else:
+            return self.__getattribute__(key)

tksheet/row_index.py

@@ -1539,7 +1539,7 @@ class RowIndex(tk.Canvas):
             ]
             for r in range(grid_start_row, grid_end_row):
                 draw_y = self.MT.row_positions[r]
-                if self.height_resizing_enabled:
+                if r and self.height_resizing_enabled:
                     self.visible_row_dividers[r] = (1, draw_y - 2, xend, draw_y + 2)
                 points.extend(
                     (

tksheet/sheet.py

@@ -3,7 +3,13 @@ from __future__ import annotations
 import tkinter as tk
 from bisect import bisect_left
 from collections import defaultdict, deque
-from collections.abc import Callable, Generator, Iterator, Sequence
+from collections.abc import (
+    Callable,
+    Generator,
+    Hashable,
+    Iterator,
+    Sequence,
+)
 from itertools import accumulate, chain, islice, product, repeat
 from timeit import default_timer
 from tkinter import ttk
@@ -47,6 +53,7 @@ from .other_classes import (
     FontTuple,
     GeneratedMouseEvent,
     Node,
+    ProgressBar,
     Selected,
     SelectionBox,
     Span,
@@ -4445,6 +4452,60 @@ class Sheet(tk.Frame):
 
     refresh = redraw
 
+    # Progress Bars
+
+    def create_progress_bar(
+        self,
+        row: int,
+        column: int,
+        bg: str,
+        fg: str,
+        name: Hashable,
+        percent: int = 0,
+        del_when_done: bool = False,
+    ) -> Sheet:
+        self.MT.progress_bars[(row, column)] = ProgressBar(
+            bg=bg,
+            fg=fg,
+            name=name,
+            percent=percent,
+            del_when_done=del_when_done,
+        )
+        return self.set_refresh_timer()
+
+    def progress_bar(
+        self,
+        name: Hashable | None = None,
+        cell: tuple[int, int] | None = None,
+        percent: int | None = None,
+        bg: str | None = None,
+        fg: str | None = None,
+    ) -> Sheet:
+        if name is not None:
+            bars = (bar for bar in self.MT.progress_bars.values() if bar.name == name)
+        elif cell is not None:
+            bars = (self.MT.progress_bars[cell],)
+        for bar in bars:
+            if isinstance(percent, int):
+                bar.percent = percent
+            if isinstance(bg, str):
+                bar.bg = bg
+            if isinstance(fg, str):
+                bar.fg = fg
+        return self.set_refresh_timer()
+
+    def del_progress_bar(
+        self,
+        name: Hashable | None = None,
+        cell: tuple[int, int] | None = None,
+    ) -> Sheet:
+        if name is not None:
+            for cell in tuple(cell for cell, bar in self.MT.progress_bars.items() if bar.name == name):
+                del self.MT.progress_bars[cell]
+        elif cell is not None:
+            del self.MT.progress_bars[cell]
+        return self.set_refresh_timer()
+
     # Tags
 
     def tag(
@@ -4685,7 +4746,7 @@ class Sheet(tk.Frame):
                 redraw=False,
                 deselect_all=False,
             )
-        return self.set_refresh_timer(True)
+        return self.set_refresh_timer()
 
     def _tree_open(self, items: set[str]) -> list[int]:
         """
@@ -4920,8 +4981,7 @@ class Sheet(tk.Frame):
             if self.RI.tree[iid].parent and len(self.RI.tree[iid].parent.children) == 1:
                 self.RI.tree_open_ids.discard(self.RI.tree[iid].parent.iid)
             del self.RI.tree[iid]
-        self.set_refresh_timer(True)
-        return self
+        return self.set_refresh_timer()
 
     def set_children(self, parent: str, *newchildren) -> Sheet:
         """
@@ -5010,8 +5070,7 @@ class Sheet(tk.Frame):
         if parent and (parent not in self.RI.tree_open_ids or not self.item_displayed(parent)):
             self.hide_rows(set(mapping.values()), data_indexes=True)
         self.show_rows(to_show)
-        self.set_refresh_timer(True)
-        return self
+        return self.set_refresh_timer()
 
     reattach = move
 

{tksheet-7.2.3.dist-info → tksheet-7.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tksheet
-Version: 7.2.3
+Version: 7.2.4
 Summary: Tkinter table / sheet widget
 Author-email: ragardner <github@ragardner.simplelogin.com>
 License: Copyright (c) 2019 ragardner and open source contributors
@@ -41,7 +41,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 
 <p align="center" width="100%">
-    <img width="33%" src="https://github.com/ragardner/tksheet/assets/26602401/4124c3ce-cf62-4925-9158-c5bdf712765b"> 
+    <img width="33%" src="https://github.com/ragardner/tksheet/assets/26602401/4124c3ce-cf62-4925-9158-c5bdf712765b">
 </p>
 
 # <div align="center">tksheet - python tkinter table widget</div>
@@ -82,7 +82,7 @@ This library is maintained with the help of **[others](https://github.com/ragard
 - Expand row heights and column widths
 - Change fonts and font size (not for individual cells)
 - Change any colors in the sheet
-- Create an unlimited number of high performance dropdown and check boxes
+- Dropdowns, check boxes, 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
 

tksheet-7.2.4.dist-info/RECORD

@@ -0,0 +1,20 @@
+tksheet/__init__.py,sha256=BW3Re3N7ZT4N4duPVUyOe9D4v3KgirJH9kck_Mxl3JA,2124
+tksheet/colors.py,sha256=1k06VorynLmnC4FdJg8H4reIA6rXaeXBpdMwXLhN8oc,51594
+tksheet/column_headers.py,sha256=PTkKI8OHWn4GzBhPJYU7c8Lz0X52DldV-0J4mPQbjkE,102045
+tksheet/formatters.py,sha256=DXif00aq9DgFpXwkbiqD86KxtDg0Meop51hLY-KcGNQ,10037
+tksheet/functions.py,sha256=rNfDpQRoXZm_Ro-tlF92ox3fi37p71Mio1PGTreM_oc,40835
+tksheet/main_table.py,sha256=VIP-SV3Z9QVH9qVbBth1koI-9PVj6yPQZQ4w_yrVp5U,327474
+tksheet/other_classes.py,sha256=CDN38ZjKxZro9YOS_g0DjMC82-Mi9udedny4wdd90W0,14347
+tksheet/row_index.py,sha256=36e4xgNMwMuvciKLIboKpsiFBrMy_URh7y4OZX8Ygvo,108219
+tksheet/sheet.py,sha256=MWd753gZeFZ4u4w7ZLLSloaIqJg2TNsdvJFvAcxuL-E,270230
+tksheet/sheet_options.py,sha256=Azo7_-H0e0ssYEoU7Mq_OWy3S-U05rp4_6Q2E2Ffuu8,12262
+tksheet/text_editor.py,sha256=aRm1Y5GfORiEAJthtN1uQ30CT3VoF8mRWvR-SIXPrJU,6548
+tksheet/themes.py,sha256=N9nAj6vcWk4UdcrAakvz2LPbJEJWXdv3j7Om6AnvX5k,14474
+tksheet/top_left_rectangle.py,sha256=o-M6i5NjaJwo60tV-BDP9SbaT1CzQNoPjuoC7p-nb5Q,8436
+tksheet/types.py,sha256=IgoEHMbceKpakcZtanxKaKJ4RdCq7UW6EoEIIz5O59k,340
+tksheet/vars.py,sha256=86ubZZElsnQuC6Lv6bW2lt2NhD9wAp6PxtkK7ufKqq0,3452
+tksheet-7.2.4.dist-info/LICENSE.txt,sha256=ndbcCPe9SlHfweE_W2RAueWUe2k7yudyxYLq6WjFdn4,1101
+tksheet-7.2.4.dist-info/METADATA,sha256=zPj4U-AFwX_X_Vhzq6SlOAk73teNB50Ple_OvTHLvN4,6284
+tksheet-7.2.4.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+tksheet-7.2.4.dist-info/top_level.txt,sha256=my61PXCcck_HHAc9cq3NAlyAr3A3FXxCy9gptEOaCN8,8
+tksheet-7.2.4.dist-info/RECORD,,

tksheet-7.2.3.dist-info/RECORD

@@ -1,20 +0,0 @@
-tksheet/__init__.py,sha256=ExwA5frHCiXaPMRIH-EKonUH_RKCgMI6IpAps9dtesE,2124
-tksheet/colors.py,sha256=1k06VorynLmnC4FdJg8H4reIA6rXaeXBpdMwXLhN8oc,51594
-tksheet/column_headers.py,sha256=zArcBsPeob8xUvM0cYB4RjwcKMfLLkHiz7oUtDFBAeg,102039
-tksheet/formatters.py,sha256=DXif00aq9DgFpXwkbiqD86KxtDg0Meop51hLY-KcGNQ,10037
-tksheet/functions.py,sha256=rNfDpQRoXZm_Ro-tlF92ox3fi37p71Mio1PGTreM_oc,40835
-tksheet/main_table.py,sha256=CudkuoJ8NSlCwTZjQCxQHRNdBTYdjSyo3CqnIZSmynI,325631
-tksheet/other_classes.py,sha256=P3FYUYreLhstATvHCNow8sDQoCsD_02KB6oXcca3ahE,13628
-tksheet/row_index.py,sha256=aBNZIKMBnbIHdCSsmKdLgZSQ8ESDyAXwFxlSRVR1RO8,108213
-tksheet/sheet.py,sha256=q8MSMTCLHaud-Hddh2vMflWbl785SuiwlZ6H2tam1cw,268536
-tksheet/sheet_options.py,sha256=Azo7_-H0e0ssYEoU7Mq_OWy3S-U05rp4_6Q2E2Ffuu8,12262
-tksheet/text_editor.py,sha256=aRm1Y5GfORiEAJthtN1uQ30CT3VoF8mRWvR-SIXPrJU,6548
-tksheet/themes.py,sha256=N9nAj6vcWk4UdcrAakvz2LPbJEJWXdv3j7Om6AnvX5k,14474
-tksheet/top_left_rectangle.py,sha256=o-M6i5NjaJwo60tV-BDP9SbaT1CzQNoPjuoC7p-nb5Q,8436
-tksheet/types.py,sha256=IgoEHMbceKpakcZtanxKaKJ4RdCq7UW6EoEIIz5O59k,340
-tksheet/vars.py,sha256=86ubZZElsnQuC6Lv6bW2lt2NhD9wAp6PxtkK7ufKqq0,3452
-tksheet-7.2.3.dist-info/LICENSE.txt,sha256=ndbcCPe9SlHfweE_W2RAueWUe2k7yudyxYLq6WjFdn4,1101
-tksheet-7.2.3.dist-info/METADATA,sha256=Phxh9tGDvtVNUVESqLiCDYnot995x8l2rhmkJYbOEK4,6319
-tksheet-7.2.3.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-tksheet-7.2.3.dist-info/top_level.txt,sha256=my61PXCcck_HHAc9cq3NAlyAr3A3FXxCy9gptEOaCN8,8
-tksheet-7.2.3.dist-info/RECORD,,