Initial scaffolding to use ttkbootstraps Tableview

WARNING: this code does NOT work

Author: almostearthling

lib/forms/history.py

@@ -6,6 +6,8 @@
 import tkinter as tk
 import ttkbootstrap as ttk
 
+from ttkbootstrap import tableview
+
 from .ui import *
 from ..utility import get_ui_image
 
@@ -98,6 +100,92 @@ def __init__(self, wrapper, main=False):
 
         self._updateform()
 
+    def __init2__(self, wrapper, main=False):
+
+        # the main tree view has an increased row size
+        style = ttk.Style()
+        style.configure("History.Treeview", rowheight=24)
+
+        size = AppConfig.get("SIZE_HISTORY_FORM")
+        assert isinstance(size, tuple)
+        bbox = (BBOX_RELOAD, BBOX_CLOSE)
+        super().__init__(UI_TITLE_HISTORY, size, None, bbox, main)
+
+        # list box icons
+        self._icon_ok = get_ui_image(OK_ICON)
+        self._icon_fail = get_ui_image(FAIL_ICON)
+        self._icon_unknown = get_ui_image(UNK_ICON)
+
+        # form data
+        self._wrapper = wrapper
+        self._history = []
+        self.set_history(self._wrapper.get_history())
+
+        # build the UI: build widgets, arrange them in the box, bind data
+
+        # client area
+        area = ttk.Frame(self.contents)
+        area.grid(row=0, column=0, sticky=tk.NSEW)
+        PAD = WIDGET_PADDING_PIXELS
+
+        # history list section
+        l_history = ttk.Label(area, text=UI_FORM_HISTORYITEMS_SC)
+
+        cols = (
+            "#0",
+            UI_FORM_HS_TIME,
+            UI_FORM_HS_TASK,
+            UI_FORM_HS_TRIGGER,
+            UI_FORM_HS_DURATION,
+            UI_FORM_HS_SUCCESS,
+            UI_FORM_HS_MESSAGE,
+        )
+
+        tab_history = tableview.Tableview(
+            area,
+            coldata=cols,
+            paginated=False,
+            yscrollbar=True,
+        )
+
+        # build a scrolled frame for the treeview
+        tab_history.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
+
+        # tab_history.column("#0", anchor=tk.CENTER, width=30, stretch=tk.NO)
+        # tab_history.heading("#0", anchor=tk.CENTER, text="")
+
+        # NOTE: widths are empirically determined, should be tested on
+        # other platform to verify that they are suitable anyway
+        # tab_history.column("time", anchor=tk.CENTER, width=15)
+        # tab_history.column("task", anchor=tk.W, width=16)
+        # tab_history.column("trigger", anchor=tk.W, width=16)
+        # tab_history.column("duration", anchor=tk.W, width=7)
+        # tab_history.column("success", anchor=tk.CENTER, width=4)
+        # tab_history.column("message", anchor=tk.W, width=38)
+
+        # tab_history.heading("time", anchor=tk.CENTER, text=UI_FORM_HS_TIME)
+        # tab_history.heading("task", anchor=tk.W, text=UI_FORM_HS_TASK)
+        # tab_history.heading("trigger", anchor=tk.W, text=UI_FORM_HS_TRIGGER)
+        # tab_history.heading("duration", anchor=tk.W, text=UI_FORM_HS_DURATION)
+        # tab_history.heading("success", anchor=tk.CENTER, text=UI_FORM_HS_SUCCESS)
+        # tab_history.heading("message", anchor=tk.W, text=UI_FORM_HS_MESSAGE)
+
+        # arrange items in the grid
+        l_history.grid(row=0, column=0, sticky=tk.W, padx=PAD, pady=PAD)
+        tab_history.grid(row=1, column=0, sticky=tk.NSEW, padx=PAD, pady=PAD)
+
+        # expand appropriate sections
+        area.rowconfigure(1, weight=1)
+        area.columnconfigure(0, weight=1)
+
+        # bind data to widgets
+        # NOTE: no data to bind
+
+        # propagate widgets that need to be accessed
+        self._tv_history = tab_history
+
+        self._updateform2()
+
     def set_history(self, history) -> None:
         h = list(
             (
@@ -106,7 +194,7 @@ def set_history(self, history) -> None:
                     x["task"],
                     x["trigger"],
                     ("%.2fs" % x["duration"].total_seconds()).ljust(7),
-                    (
+                    (\
                         SYM_OK
                         if x["success"] == "OK"
                         else SYM_UNKNOWN if x["success"] == "IND" else SYM_FAIL
@@ -130,6 +218,16 @@ def _updateform(self) -> None:
             )
             self._tv_history.insert("", values=entry, index=tk.END, image=icon)
 
+    def _updateform2(self) -> None:
+        self._tv_history.delete_rows()
+        for entry, outcome in self._history:
+            icon = (
+                self._icon_ok
+                if outcome == "OK"
+                else self._icon_unknown if outcome == "IND" else self._icon_fail
+            )
+            self._tv_history.insert_row("", values=entry)
+
     # reload history data when the `reload` button is clicked
     def reload(self) -> None:
         self.set_history(self._wrapper.get_history())

when/when.py

@@ -379,7 +379,7 @@ def main_start(args) -> None:
         exit_error(CLI_ERR_WHENEVER_WRONG_VERSION)
     if DEBUG:
         # setup the scheduler and associate it to the application
-        whenever: str = AppConfig.get("WHENEVER")
+        whenever: str = AppConfig.get("WHENEVER")  # type: ignore
         if (
             whenever is None
             or not os.path.exists(whenever)