From 08b62e1cfd59d0b380c89a568b58c622b20a9a59 Mon Sep 17 00:00:00 2001
From: aclist <92275929+aclist@users.noreply.github.com>
Date: Sat, 16 May 2026 20:11:11 +0900
Subject: [PATCH] chore: add boilerplate

---
 dzgui/const/constants.py          | 2 ++
 dzgui/controllers/emitter.py      | 5 ++---
 dzgui/init/migrate.py             | 1 +
 dzgui/init/proc.py                | 1 +
 dzgui/main.py                     | 1 +
 dzgui/managers/mods.py            | 2 +-
 dzgui/views/trees/tree_servers.py | 1 +
 7 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/dzgui/const/constants.py b/dzgui/const/constants.py
index 2035553..47a0e5e 100644
--- a/dzgui/const/constants.py
+++ b/dzgui/const/constants.py
@@ -45,6 +45,7 @@ WEB_BROWSER = "web-browser-symbolic"
 
 SEPARATOR = "SEPARATOR"
 
+# TODO: drop
 NO_PADDING = 0
 NO_EXPAND = False
 NO_FILL = False
@@ -65,4 +66,5 @@ CHANGELOG_PATH = "data/CHANGELOG.md"
 CSS_PATH = "data/app.css"
 
 LOG_FILTERS = ("CRITICAL", "WARNING", "INFO", "DEBUG")
+# TODO: drop
 FOREGROUND_CMDS = ("wmctrl", "xdotool")
diff --git a/dzgui/controllers/emitter.py b/dzgui/controllers/emitter.py
index 3da22a7..a089351 100644
--- a/dzgui/controllers/emitter.py
+++ b/dzgui/controllers/emitter.py
@@ -9,14 +9,14 @@ from gi.repository import Gdk, GObject  # noqa E402
 if TYPE_CHECKING:
     from dzgui.const.enum import NotebookPage, ServerTab
 
-# TODO: rename signals to e.g. maps_keybinding_pressed
 
+# TODO: if servers fail to load, may leave dangling widgets waiting for a signal
 
 class Emitter(GObject.GObject):
     def __init__(self) -> None:
         super().__init__()
 
-    # TODO: rename request verbs
+    # TODO: rename signals to e.g. maps_keybinding_pressed
     @GObject.Signal(flags=GObject.SignalFlags.RUN_LAST, arg_types=())
     def request_keyword_focus(self) -> None:
         """User invoked Ctrl-f keybinding from ServerTreeView"""
@@ -150,4 +150,3 @@ class Emitter(GObject.GObject):
     def keyword_set(self, keyword: str) -> None:
         pass
 
-    # TODO: if servers fail to load, may leave dangling widgets waiting for a signal
diff --git a/dzgui/init/migrate.py b/dzgui/init/migrate.py
index 3f69fbf..554e793 100644
--- a/dzgui/init/migrate.py
+++ b/dzgui/init/migrate.py
@@ -52,4 +52,5 @@ def copy_ipdb(ips_path: Path) -> None:
         return
     if legacy.is_file() is False:
         return
+    # TODO: ensure that month file is copied
     shutil.copy(legacy, ips_path)
diff --git a/dzgui/init/proc.py b/dzgui/init/proc.py
index 40d3848..78acbf1 100644
--- a/dzgui/init/proc.py
+++ b/dzgui/init/proc.py
@@ -39,6 +39,7 @@ def is_steam_running(cmd: str) -> bool:
 
 
 # CHORE: test alternate clients
+# TODO: has_flatpak_steam
 def is_flatpak_steam_running() -> bool:
     if has_cmd(FLATPAK_CMD) is False:
         return False
diff --git a/dzgui/main.py b/dzgui/main.py
index e0a5b61..516d5d5 100644
--- a/dzgui/main.py
+++ b/dzgui/main.py
@@ -102,6 +102,7 @@ def main() -> None:
         make_parents(XDG.debug)
 
     if has_new_config(XDG.config) is False:
+        # TODO: handle this in assistant
         migrate_legacy_conf(XDG.config)
         migrate_cols_file(XDG.columns)
         # TODO: copy notes file
diff --git a/dzgui/managers/mods.py b/dzgui/managers/mods.py
index e1199b2..bb1519f 100644
--- a/dzgui/managers/mods.py
+++ b/dzgui/managers/mods.py
@@ -181,7 +181,7 @@ class ModManager:
                 model[path][4] = True
         self.emitter.emit("mods_highlighted")
 
-    # TODO: strings
+    # TODO: dialog strings
     @call_on_thread("working")
     def highlight_stale(self) -> None:
         stale = find_stale_mods(self.prefs.paths.config)
diff --git a/dzgui/views/trees/tree_servers.py b/dzgui/views/trees/tree_servers.py
index 57220bd..7013d0c 100644
--- a/dzgui/views/trees/tree_servers.py
+++ b/dzgui/views/trees/tree_servers.py
@@ -215,6 +215,7 @@ class ServerTreeView(ContextMixin, TreeView):  # type: ignore
 
     def _check_result_queue(self) -> Literal[True]:
         latest_result = None
+        # FIXME: empty results cause statusbar to be emptied
         while not self.queue.empty():
             latest_result = self.queue.get()