backlogops-gui 0.4__tar.gz → 0.6__tar.gz

{backlogops_gui-0.4 → backlogops_gui-0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops-gui
-Version: 0.4
+Version: 0.6
 Summary: Graphical user interface for backlog operations.
 Author: Tom Björkholm
 Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -14,7 +14,6 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Intended Audience :: Information Technology
 Classifier: Topic :: Office/Business :: Scheduling
@@ -22,8 +21,9 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
-Requires-Dist: backlogops>=0.4
+Requires-Dist: backlogops>=0.6
 Requires-Dist: argcomplete>=3.7.0
+Requires-Dist: wizard-ui-bridge>=1.1
 Requires-Dist: versionreporter>=0.4
 Dynamic: author
 Dynamic: license-file
@@ -48,15 +48,11 @@ There are 3 related packages for backlog operations:
 
 ## Project status
 
-backlogops is in beta. The algorithms intended for its initial scope are in
-place, so the main work from here is on the user experience rather than on new
-core functionality. The three packages share a version number and are released
-together.
+The three packages share a version number and are released together.
 
 The library is not meant to ever be "finished": using it for real planning keeps
 surfacing new ideas. Some of those will be added to backlogops itself, and
-others will fit better in separate packages built on top of backlogops. Early
-adopters are very welcome, and their feedback shapes what comes next.
+others will fit better in separate packages built on top of backlogops.
 
 ## Available functionality
 
@@ -353,9 +349,10 @@ one with the list of releases. You will want to use the menus.
 
 ## Test summary
 
-- Test result: 2638 passed, 7 deselected in 51s
+- Test result: 2450 passed, 9 deselected in 39s
 - No flake8 warnings.
 - No mypy errors found.
+- No pylint warnings.
 - No python layout warnings.
-- Built version(s): 0.4
+- Built version(s): 0.6
 - Build and test using Python 3.14.6

{backlogops_gui-0.4 → backlogops_gui-0.6}/README_pypi.md

@@ -16,15 +16,11 @@ There are 3 related packages for backlog operations:
 
 ## Project status
 
-backlogops is in beta. The algorithms intended for its initial scope are in
-place, so the main work from here is on the user experience rather than on new
-core functionality. The three packages share a version number and are released
-together.
+The three packages share a version number and are released together.
 
 The library is not meant to ever be "finished": using it for real planning keeps
 surfacing new ideas. Some of those will be added to backlogops itself, and
-others will fit better in separate packages built on top of backlogops. Early
-adopters are very welcome, and their feedback shapes what comes next.
+others will fit better in separate packages built on top of backlogops.
 
 ## Available functionality
 
@@ -321,9 +317,10 @@ one with the list of releases. You will want to use the menus.
 
 ## Test summary
 
-- Test result: 2638 passed, 7 deselected in 51s
+- Test result: 2450 passed, 9 deselected in 39s
 - No flake8 warnings.
 - No mypy errors found.
+- No pylint warnings.
 - No python layout warnings.
-- Built version(s): 0.4
+- Built version(s): 0.6
 - Build and test using Python 3.14.6

{backlogops_gui-0.4 → backlogops_gui-0.6}/backlogops_gui.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops-gui
-Version: 0.4
+Version: 0.6
 Summary: Graphical user interface for backlog operations.
 Author: Tom Björkholm
 Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -14,7 +14,6 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Intended Audience :: Information Technology
 Classifier: Topic :: Office/Business :: Scheduling
@@ -22,8 +21,9 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
-Requires-Dist: backlogops>=0.4
+Requires-Dist: backlogops>=0.6
 Requires-Dist: argcomplete>=3.7.0
+Requires-Dist: wizard-ui-bridge>=1.1
 Requires-Dist: versionreporter>=0.4
 Dynamic: author
 Dynamic: license-file
@@ -48,15 +48,11 @@ There are 3 related packages for backlog operations:
 
 ## Project status
 
-backlogops is in beta. The algorithms intended for its initial scope are in
-place, so the main work from here is on the user experience rather than on new
-core functionality. The three packages share a version number and are released
-together.
+The three packages share a version number and are released together.
 
 The library is not meant to ever be "finished": using it for real planning keeps
 surfacing new ideas. Some of those will be added to backlogops itself, and
-others will fit better in separate packages built on top of backlogops. Early
-adopters are very welcome, and their feedback shapes what comes next.
+others will fit better in separate packages built on top of backlogops.
 
 ## Available functionality
 
@@ -353,9 +349,10 @@ one with the list of releases. You will want to use the menus.
 
 ## Test summary
 
-- Test result: 2638 passed, 7 deselected in 51s
+- Test result: 2450 passed, 9 deselected in 39s
 - No flake8 warnings.
 - No mypy errors found.
+- No pylint warnings.
 - No python layout warnings.
-- Built version(s): 0.4
+- Built version(s): 0.6
 - Build and test using Python 3.14.6

{backlogops_gui-0.4 → backlogops_gui-0.6}/backlogops_gui.egg-info/SOURCES.txt

@@ -33,6 +33,7 @@ src/backlogops_gui/jira_read.py
 src/backlogops_gui/jira_rename.py
 src/backlogops_gui/jira_update.py
 src/backlogops_gui/jira_write.py
+src/backlogops_gui/key_list_box.py
 src/backlogops_gui/log_buffer.py
 src/backlogops_gui/modal_dialog.py
 src/backlogops_gui/py.typed
@@ -41,7 +42,11 @@ src/backlogops_gui/report_windows.py
 src/backlogops_gui/table_view.py
 src/backlogops_gui/tcltk_version.py
 src/backlogops_gui/token_dialog.py
+src/backlogops_gui/wizard_calendar.py
 src/backlogops_gui/wizard_form.py
 src/backlogops_gui/wizard_path.py
+src/backlogops_gui/wizard_pick_row.py
+src/backlogops_gui/wizard_prefill.py
 src/backlogops_gui/wizard_table.py
+src/backlogops_gui/wizard_typed.py
 src/backlogops_gui/wizard_window.py

{backlogops_gui-0.4 → backlogops_gui-0.6}/backlogops_gui.egg-info/requires.txt

@@ -1,3 +1,4 @@
-backlogops>=0.4
+backlogops>=0.6
 argcomplete>=3.7.0
+wizard-ui-bridge>=1.1
 versionreporter>=0.4

{backlogops_gui-0.4 → backlogops_gui-0.6}/pyproject.toml

@@ -21,7 +21,6 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
     "Operating System :: OS Independent",
-    "Development Status :: 4 - Beta",
     "Intended Audience :: End Users/Desktop",
     "Intended Audience :: Information Technology",
     "Topic :: Office/Business :: Scheduling",

{backlogops_gui-0.4 → backlogops_gui-0.6}/setup.py

@@ -5,7 +5,7 @@ from setuptools import setup
 
 setup(
   name='backlogops-gui',
-  version='0.4',
+  version='0.6',
   description='Graphical user interface for backlog operations.',
   author='Tom Björkholm',
   author_email='klausuler_linnet0q@icloud.com',
@@ -19,8 +19,9 @@ setup(
     ]
   },
   install_requires=[
-    'backlogops >= 0.4',
+    'backlogops >= 0.6',
     'argcomplete >= 3.7.0',
+    'wizard-ui-bridge >= 1.1',
     'versionreporter >= 0.4'
   ]
 )

{backlogops_gui-0.4 → backlogops_gui-0.6}/src/backlogops_gui/application.py

@@ -538,8 +538,9 @@ class BacklogApp:
             return
         value = options.config_value
         try:
-            data = read_backlog(path, value, presets, self.log, self.levels(),
-                                self.status_map())
+            data = read_backlog(path, value, presets, self.log,
+                                levels=self.levels(),
+                                status_map=self.status_map())
         except IO_ERRORS as error:
             self.show_error('Could not read file', str(error))
             return
@@ -564,7 +565,8 @@ class BacklogApp:
             """Re-read the file, reporting a failure and applying success."""
             try:
                 data = read_backlog(path, value, self.in_presets(), self.log,
-                                    self.levels(), self.status_map())
+                                    levels=self.levels(),
+                                    status_map=self.status_map())
             except IO_ERRORS as error:
                 self.show_error('Could not read file', str(error))
                 return

{backlogops_gui-0.4 → backlogops_gui-0.6}/src/backlogops_gui/backlog_dialogs.py

@@ -13,15 +13,15 @@ returns it, or None when the dialog is cancelled.
 # MIT License
 
 import tkinter as tk
-from tkinter import filedialog, messagebox, ttk
+from tkinter import messagebox, ttk
 from dataclasses import dataclass
 from datetime import date
 from typing import Optional, TextIO
-from backlogops import DependencyMode, DEFAULT_LEVELS, read_key_list
+from backlogops import DependencyMode, DEFAULT_LEVELS
 from backlogops_gui.gui_style import style_input
+from backlogops_gui.key_list_box import build_key_box, load_keys_into
 from backlogops_gui.modal_dialog import ModalDialog
 
-KEY_READ_ERRORS = (ValueError, TypeError, KeyError, OSError)
 DEFAULT_BUFFER_DAYS = 5
 
 
@@ -63,29 +63,13 @@ class KeysDialog(ModalDialog):
 
     def _build_text(self) -> tk.Text:
         """Add the entry label, text box and the load-from-file button."""
-        tk.Label(self._win, text='Enter keys separated by spaces or '
-                 'newlines:').pack(anchor='w', padx=12, pady=(10, 2))
-        text = tk.Text(self._win, width=40, height=8)
-        style_input(text)
-        text.pack(padx=12, pady=2)
-        tk.Button(self._win, text='Load from file…',
-                  command=self._load).pack(anchor='w', padx=12, pady=4)
-        return text
+        return build_key_box(self._win,
+                             'Enter keys separated by spaces or newlines:',
+                             self._load)
 
     def _load(self) -> None:
         """Read a key list file into the text box, reporting failures."""
-        name = filedialog.askopenfilename(parent=self._win,
-                                          title='Read key list')
-        if not name:
-            return
-        try:
-            keys = read_key_list(name, stderr_file=self._sink)
-        except KEY_READ_ERRORS as error:
-            messagebox.showerror('Could not read key list', str(error),
-                                 parent=self._win)
-            return
-        self._text.delete('1.0', 'end')
-        self._text.insert('end', '\n'.join(keys))
+        load_keys_into(self._win, self._text, self._sink)
 
     def _confirm(self) -> None:
         """Split the text on whitespace and close the dialog."""

{backlogops_gui-0.4 → backlogops_gui-0.6}/src/backlogops_gui/backlog_io.py

@@ -27,9 +27,10 @@ def _sink(sink: Optional[TextIO]) -> TextIO:
     return sink if sink is not None else NoTextIO()
 
 
+# pylint: disable-next=too-many-arguments
 def read_backlog(path: str, value: Optional[str],
                  presets: Optional[dict[str, InputFormatConfig]],
-                 sink: Optional[TextIO] = None,
+                 sink: Optional[TextIO] = None, *,
                  levels: Optional[Levels] = None,
                  status_map: Optional[dict[str, Status]] = None
                  ) -> BacklogReleases:

{backlogops_gui-0.4 → backlogops_gui-0.6}/src/backlogops_gui/gui_wizard.py

@@ -18,10 +18,11 @@ session happens in a single pop-up that does not jump around the display.
 from typing import Optional, Sequence, TextIO
 from pathlib import Path
 import tkinter as tk
-from tableio_cfg_json import AnswerFields, AskFields, PartialCheck, \
+from wizard_ui_bridge import AnswerFields, AskField, AskFields, PartialCheck, \
     PartialFormValidator, PathAskOptions, TableCell, TableColumn, \
     WizardUiBridge
 from backlogops import NoTextIO
+from backlogops_gui.wizard_form import handles_field
 from backlogops_gui.wizard_window import WizardWindow
 
 
@@ -112,6 +113,10 @@ class TkWizardBridge(WizardUiBridge):
         return self._window_obj().ask_form(long_question, ask_fields,
                                            re_ask_reason, partial_validator)
 
+    def supports_form_field(self, field: AskField) -> bool:
+        """Report that the Tk form shows every current field type."""
+        return handles_field(field)
+
     def show(self, message: str) -> None:
         """Show an informational message to the user."""
         self._window_obj().show(message)

{backlogops_gui-0.4 → backlogops_gui-0.6}/src/backlogops_gui/jira_dialogs.py

@@ -18,18 +18,15 @@ masked pass phrase for an encrypted Jira API token.
 # MIT License
 
 import tkinter as tk
-from tkinter import filedialog, messagebox, ttk
+from tkinter import messagebox, ttk
 from dataclasses import dataclass
 from collections.abc import Mapping
 from typing import Optional, Sequence, TextIO
-from backlogops import (
-    JiraRankAnchor, OnMissingKey, ReleaseRename, read_key_list)
+from backlogops import JiraRankAnchor, OnMissingKey, ReleaseRename
 from backlogops_gui.gui_style import style_input
+from backlogops_gui.key_list_box import build_key_box, load_keys_into
 from backlogops_gui.modal_dialog import ModalDialog
 
-KEY_READ_ERRORS = (ValueError, TypeError, KeyError, OSError)
-"""Errors caught when loading a key list file into the rank dialog."""
-
 MISSING_MODE_TEXT = {
     OnMissingKey.RAISE: 'Stop with an error',
     OnMissingKey.IGNORE: 'Ignore it',
@@ -550,15 +547,9 @@ class JiraRankDialog(ModalDialog):
 
     def _build_keys(self) -> tk.Text:
         """Add the key entry label, text box and load-from-file button."""
-        tk.Label(self._win,
-                 text='Keys to move (separated by spaces or newlines):'
-                 ).pack(anchor='w', padx=12, pady=(8, 2))
-        text = tk.Text(self._win, width=40, height=8)
-        style_input(text)
-        text.pack(padx=12, pady=2)
-        tk.Button(self._win, text='Load from file…',
-                  command=self._load).pack(anchor='w', padx=12, pady=4)
-        return text
+        return build_key_box(self._win,
+                             'Keys to move (separated by spaces or newlines):',
+                             self._load, label_pady=(8, 2))
 
     def _preset_changed(self, _event: object) -> None:
         """Show the selected preset's default issue filter."""
@@ -566,18 +557,7 @@ class JiraRankDialog(ModalDialog):
 
     def _load(self) -> None:
         """Read a key list file into the text box, reporting failures."""
-        name = filedialog.askopenfilename(parent=self._win,
-                                          title='Read key list')
-        if not name:
-            return
-        try:
-            keys = read_key_list(name, stderr_file=self._sink)
-        except KEY_READ_ERRORS as error:
-            messagebox.showerror('Could not read key list', str(error),
-                                 parent=self._win)
-            return
-        self._text.delete('1.0', 'end')
-        self._text.insert('end', '\n'.join(keys))
+        load_keys_into(self._win, self._text, self._sink)
 
     def _confirm(self) -> None:
         """Store the preset, filter, keys and end, requiring preset+keys."""

backlogops_gui-0.6/src/backlogops_gui/key_list_box.py

@@ -0,0 +1,45 @@
+#! /usr/local/bin/python3
+"""Shared key-list text box with a load-from-file button for dialogs.
+
+The order-by-keys dialog and the Jira rank dialog both let the user type
+or paste a list of keys and load it from a file. This module holds that
+shared widget and the file reading so the two dialogs do not repeat it.
+"""
+
+# Copyright (c) 2026, Tom Björkholm
+# MIT License
+
+import tkinter as tk
+from tkinter import filedialog, messagebox
+from collections.abc import Callable
+from typing import TextIO
+from backlogops import read_key_list
+from backlogops_gui.gui_style import style_input
+
+KEY_READ_ERRORS = (ValueError, TypeError, KeyError, OSError)
+
+
+def build_key_box(win: tk.Misc, label: str, command: Callable[[], None], *,
+                  label_pady: tuple[int, int] = (10, 2)) -> tk.Text:
+    """Add a key-entry label, text box and load-from-file button."""
+    tk.Label(win, text=label).pack(anchor='w', padx=12, pady=label_pady)
+    text = tk.Text(win, width=40, height=8)
+    style_input(text)
+    text.pack(padx=12, pady=2)
+    tk.Button(win, text='Load from file…',
+              command=command).pack(anchor='w', padx=12, pady=4)
+    return text
+
+
+def load_keys_into(win: tk.Misc, text: tk.Text, sink: TextIO) -> None:
+    """Read a key list file into the text box, reporting failures."""
+    name = filedialog.askopenfilename(parent=win, title='Read key list')
+    if not name:
+        return
+    try:
+        keys = read_key_list(name, stderr_file=sink)
+    except KEY_READ_ERRORS as error:
+        messagebox.showerror('Could not read key list', str(error), parent=win)
+        return
+    text.delete('1.0', 'end')
+    text.insert('end', '\n'.join(keys))

backlogops_gui-0.6/src/backlogops_gui/wizard_calendar.py

@@ -0,0 +1,170 @@
+#! /usr/local/bin/python3
+"""A modal month calendar for the Tkinter date and date-time fields.
+
+A date field, and the date part of a date-time field, are shown in the
+Tkinter form as a text entry paired with a Pick button. Pressing that
+button, or typing the ``?`` token into the entry, opens this calendar.
+The user steps between months and years and clicks a day to return it;
+Cancel or closing the window returns nothing so the entry keeps its
+value. Days outside a field's inclusive bounds are shown disabled, so the
+calendar only offers acceptable dates.
+
+The calendar is event driven: a day or Cancel button calls the picked
+callback and destroys the window. No nested wait loop is entered, so the
+one already running for the wizard window keeps processing events while
+the calendar is open.
+
+The wizard window holds a modal grab, which would otherwise starve this
+separate window of pointer and keyboard events. The calendar therefore
+takes the grab (and the keyboard focus) while it is open and hands it back
+to the wizard window when it closes.
+"""
+
+# Copyright (c) 2026, Tom Björkholm
+# MIT License
+
+import calendar
+import tkinter as tk
+from datetime import date
+from functools import partial
+from typing import Callable, Optional
+from backlogops_gui.wizard_typed import value_out_of_range
+
+CALENDAR_TITLE = 'Pick a date'
+WEEKDAYS = ('Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa', 'Su')
+
+
+def month_weeks(year: int, month: int) -> list[list[int]]:
+    """Return the weeks of a month as day numbers, 0 for padding days."""
+    return calendar.Calendar().monthdayscalendar(year, month)
+
+
+def shift_month(year: int, month: int, action: str) -> tuple[int, int]:
+    """Return the year and month reached by one navigation action."""
+    if action == 'prev_year':
+        year -= 1
+    elif action == 'next_year':
+        year += 1
+    elif action == 'prev_month':
+        year, month = (year, month - 1) if month > 1 else (year - 1, 12)
+    else:
+        year, month = (year, month + 1) if month < 12 else (year + 1, 1)
+    return (min(max(year, date.min.year), date.max.year), month)
+
+
+def day_out_of_range(day: date, minimum: Optional[date],
+                     maximum: Optional[date]) -> bool:
+    """Return whether a day lies outside the inclusive date bounds."""
+    return value_out_of_range(day, minimum, maximum)
+
+
+def _restore_grab(widget: Optional[tk.Misc]) -> None:
+    """Give the modal grab back to the widget's window, if it survives."""
+    if widget is None or not widget.winfo_exists():
+        return
+    try:
+        widget.winfo_toplevel().grab_set()
+    except tk.TclError:
+        pass
+
+
+# pylint: disable-next=too-few-public-methods
+class CalendarPicker:
+    """A month calendar window returning the date the user clicks."""
+
+    def __init__(self, parent: tk.Misc, seed: date, minimum: Optional[date],
+                 maximum: Optional[date],
+                 on_pick: Callable[[Optional[date]], None]) -> None:
+        """Build the calendar window on the seed month and show it."""
+        self._bounds = (minimum, maximum)
+        self._on_pick = on_pick
+        self._year = seed.year
+        self._month = seed.month
+        self._win = tk.Toplevel(parent)
+        self._win.title(CALENDAR_TITLE)
+        self._win.transient(parent.winfo_toplevel())
+        self._win.protocol('WM_DELETE_WINDOW', self._cancel)
+        self._win.bind('<Escape>', lambda _event: self._cancel())
+        self._title = tk.Label(self._win)
+        self._title.pack(pady=4)
+        self._add_nav()
+        self._grid = tk.Frame(self._win)
+        self._grid.pack(padx=6, pady=6)
+        tk.Button(self._win, text='Cancel', command=self._cancel).pack(pady=4)
+        self._show_month()
+        self._grab()
+
+    def _grab(self) -> None:
+        """Take the modal grab and focus, retrying until the window shows.
+
+        Grabbing fails while the new window is not yet viewable, so it is
+        retried on the wizard's event loop until it succeeds.
+        """
+        if not self._win.winfo_exists():
+            return
+        try:
+            self._win.grab_set()
+        except tk.TclError:
+            self._win.after(50, self._grab)
+            return
+        self._win.focus_set()
+
+    def _add_nav(self) -> None:
+        """Add the previous and next month and year navigation buttons."""
+        box = tk.Frame(self._win)
+        box.pack()
+        for text, action in (('<< year', 'prev_year'), ('< month',
+                             'prev_month'), ('month >', 'next_month'),
+                             ('year >>', 'next_year')):
+            tk.Button(box, text=text,
+                      command=partial(self._navigate, action)).pack(
+                          side='left', padx=2)
+
+    def _navigate(self, action: str) -> None:
+        """Move the shown month by one navigation action and redraw."""
+        self._year, self._month = shift_month(self._year, self._month, action)
+        self._show_month()
+
+    def _show_month(self) -> None:
+        """Show the current month's title and rebuild the day grid."""
+        self._title.configure(text=f'{calendar.month_name[self._month]} '
+                              f'{self._year}')
+        for child in self._grid.winfo_children():
+            child.destroy()
+        for column, name in enumerate(WEEKDAYS):
+            tk.Label(self._grid, text=name).grid(row=0, column=column, padx=1)
+        self._place_days()
+
+    def _place_days(self) -> None:
+        """Place one day button, or a blank cell, per day of the month."""
+        for week, days in enumerate(month_weeks(self._year, self._month), 1):
+            for column, day in enumerate(days):
+                self._day_widget(day).grid(row=week, column=column, padx=1,
+                                           pady=1)
+
+    def _day_widget(self, day: int) -> tk.Widget:
+        """Return a blank cell for a padding day, else a day button."""
+        if day == 0:
+            return tk.Label(self._grid, text='')
+        button = tk.Button(self._grid, text=str(day), width=2,
+                           command=partial(self._pick, day))
+        minimum, maximum = self._bounds
+        if day_out_of_range(date(self._year, self._month, day), minimum,
+                            maximum):
+            button['state'] = 'disabled'
+        return button
+
+    def _pick(self, day: int) -> None:
+        """Return the clicked day's date and close the calendar."""
+        self._finish(date(self._year, self._month, day))
+
+    def _cancel(self) -> None:
+        """Close the calendar without returning a date."""
+        self._finish(None)
+
+    def _finish(self, chosen: Optional[date]) -> None:
+        """Report the outcome, destroy the window and restore the grab."""
+        parent = self._win.master
+        self._on_pick(chosen)
+        self._win.destroy()
+        _restore_grab(parent)