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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops-gui
-Version: 0.3
+Version: 0.4
 Summary: Graphical user interface for backlog operations.
 Author: Tom Björkholm
 Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -14,7 +14,7 @@ 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 :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Intended Audience :: Information Technology
 Classifier: Topic :: Office/Business :: Scheduling
@@ -22,7 +22,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
-Requires-Dist: backlogops>=0.3
+Requires-Dist: backlogops>=0.4
 Requires-Dist: argcomplete>=3.7.0
 Requires-Dist: versionreporter>=0.4
 Dynamic: author
@@ -46,6 +46,18 @@ There are 3 related packages for backlog operations:
   interface to use the functions in the library. It is based on TkInter. The
   ambition is to keep it as a thin wrapper around the library.
 
+## 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 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.
+
 ## Available functionality
 
 The following functionality is available in all 3 packages:
@@ -285,6 +297,10 @@ is in the menus.
     - Write configuration...: This lets you write the configuration you
       have in application to a file.
 
+    - Encrypt Jira API token file...: Encrypt a Jira API token to a
+      pass-phrase-protected file, for use with the ENCRYPTED_FILE token
+      storage mode.
+
 - Help
 
     - Report version information: Show version information for the
@@ -337,9 +353,9 @@ one with the list of releases. You will want to use the menus.
 
 ## Test summary
 
-- Test result: 2284 passed, 7 deselected in 44s
+- Test result: 2638 passed, 7 deselected in 51s
 - No flake8 warnings.
 - No mypy errors found.
 - No python layout warnings.
-- Built version(s): 0.3
+- Built version(s): 0.4
 - Build and test using Python 3.14.6

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

@@ -14,6 +14,18 @@ There are 3 related packages for backlog operations:
   interface to use the functions in the library. It is based on TkInter. The
   ambition is to keep it as a thin wrapper around the library.
 
+## 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 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.
+
 ## Available functionality
 
 The following functionality is available in all 3 packages:
@@ -253,6 +265,10 @@ is in the menus.
     - Write configuration...: This lets you write the configuration you
       have in application to a file.
 
+    - Encrypt Jira API token file...: Encrypt a Jira API token to a
+      pass-phrase-protected file, for use with the ENCRYPTED_FILE token
+      storage mode.
+
 - Help
 
     - Report version information: Show version information for the
@@ -305,9 +321,9 @@ one with the list of releases. You will want to use the menus.
 
 ## Test summary
 
-- Test result: 2284 passed, 7 deselected in 44s
+- Test result: 2638 passed, 7 deselected in 51s
 - No flake8 warnings.
 - No mypy errors found.
 - No python layout warnings.
-- Built version(s): 0.3
+- Built version(s): 0.4
 - Build and test using Python 3.14.6

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops-gui
-Version: 0.3
+Version: 0.4
 Summary: Graphical user interface for backlog operations.
 Author: Tom Björkholm
 Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -14,7 +14,7 @@ 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 :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Intended Audience :: Information Technology
 Classifier: Topic :: Office/Business :: Scheduling
@@ -22,7 +22,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
-Requires-Dist: backlogops>=0.3
+Requires-Dist: backlogops>=0.4
 Requires-Dist: argcomplete>=3.7.0
 Requires-Dist: versionreporter>=0.4
 Dynamic: author
@@ -46,6 +46,18 @@ There are 3 related packages for backlog operations:
   interface to use the functions in the library. It is based on TkInter. The
   ambition is to keep it as a thin wrapper around the library.
 
+## 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 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.
+
 ## Available functionality
 
 The following functionality is available in all 3 packages:
@@ -285,6 +297,10 @@ is in the menus.
     - Write configuration...: This lets you write the configuration you
       have in application to a file.
 
+    - Encrypt Jira API token file...: Encrypt a Jira API token to a
+      pass-phrase-protected file, for use with the ENCRYPTED_FILE token
+      storage mode.
+
 - Help
 
     - Report version information: Show version information for the
@@ -337,9 +353,9 @@ one with the list of releases. You will want to use the menus.
 
 ## Test summary
 
-- Test result: 2284 passed, 7 deselected in 44s
+- Test result: 2638 passed, 7 deselected in 51s
 - No flake8 warnings.
 - No mypy errors found.
 - No python layout warnings.
-- Built version(s): 0.3
+- Built version(s): 0.4
 - Build and test using Python 3.14.6

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

@@ -12,6 +12,7 @@ src/backlogops_gui/__init__.py
 src/backlogops_gui/__main__.py
 src/backlogops_gui/_migrate_warn.py
 src/backlogops_gui/application.py
+src/backlogops_gui/auto_scroll.py
 src/backlogops_gui/backlog_actions.py
 src/backlogops_gui/backlog_dialogs.py
 src/backlogops_gui/backlog_io.py
@@ -39,5 +40,8 @@ src/backlogops_gui/python_version.py
 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_form.py
+src/backlogops_gui/wizard_path.py
 src/backlogops_gui/wizard_table.py
 src/backlogops_gui/wizard_window.py

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

@@ -1,3 +1,3 @@
-backlogops>=0.3
+backlogops>=0.4
 argcomplete>=3.7.0
 versionreporter>=0.4

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

@@ -4,7 +4,6 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "backlogops-gui"
-version = "0.3"
 authors = [
   { name="Tom Björkholm", email="klausuler_linnet0q@icloud.com" },
 ]
@@ -22,13 +21,13 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
     "Operating System :: OS Independent",
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Intended Audience :: End Users/Desktop",
     "Intended Audience :: Information Technology",
     "Topic :: Office/Business :: Scheduling",
     "Typing :: Typed"
 ]
-dynamic = ["dependencies"]
+dynamic = ["dependencies", "version"]
 
 [project.urls]
 "Homepage" = "https://github.com/tom-bjorkholm/backlog-ops"

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

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

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

@@ -6,8 +6,13 @@ or from Jira, loads or replaces the active configuration from a file, runs
 the teams configuration wizard, creates a stand-alone input or output
 preset file, migrates a stand-alone preset file to the current format,
 writes the running configuration to a file, and creates a demonstration
-backlog. Each backlog opens in its own
-window. On macOS the menu bar sits at the top of the display rather than in
+backlog. The configuration wizard and the preset wizard first ask whether
+to start empty or be pre-filled from an existing file, so the user can
+edit an existing configuration instead of entering everything again. Each
+backlog opens in its own window, whose information region records where the
+data came from and when, marks the window when the backlog has been
+modified, and offers a "Read again" button that re-reads the same source.
+On macOS the menu bar sits at the top of the display rather than in
 the window, so the main window body shows a short description, the current
 configuration status, and a log of the most recent diagnostic messages, to
 make clear that the application is running. The teams configuration is
@@ -28,29 +33,35 @@ import argparse
 import threading
 import tkinter as tk
 from io import StringIO
+from pathlib import Path
 from tkinter import messagebox, ttk
 from typing import Callable, Optional, TextIO, TypeVar
 import argcomplete
 from config_as_json import Config, migrate_cfg
 from config_as_json.file_extension import fix_file_extension
-from tableio_cfg_json import WizardUiBridge
 from backlogops import (
     AvailableTeams, BacklogOpsConfig, BacklogReleases, GuiDisplayConfig,
     InputFormatConfig, Levels, OutputFormatConfig, Status, get_demo_backlog,
-    get_backlog_ops_config, backlog_ops_wizard, preset_wizard)
+    get_backlog_ops_config, backlog_ops_wizard, preset_wizard,
+    read_backlog_ops_config, read_io_preset, safe_write_config,
+    encrypt_token_file, encrypt_token_to_file)
 from backlogops_gui.backlog_io import read_backlog
-from backlogops_gui.backlog_window import BacklogWindow, JiraHandlers
+from backlogops_gui.backlog_window import (
+    BacklogWindow, BacklogSource, JiraHandlers, current_time)
 from backlogops_gui.blog_version_reporter import BloGuiVersionReporter
 from backlogops_gui.gui_wizard import TkWizardBridge
 from backlogops_gui.choice_dialogs import (
-    ConfigChoice, PresetKind, ask_no_config_choice, ask_preset_kind)
+    ConfigChoice, PresetKind, SourceChoice, ask_no_config_choice,
+    ask_preset_kind, ask_source_choice)
 from backlogops_gui.file_choosers import (
-    choose_config_file, choose_existing_config, choose_input_file,
-    choose_migrated_preset, choose_preset_to_migrate)
+    choose_config_file, choose_existing_config, choose_existing_preset,
+    choose_input_file, choose_migrated_preset, choose_preset_to_migrate)
 from backlogops_gui.format_dialogs import ask_read_options
+from backlogops_gui.token_dialog import ask_encrypt_token, EncryptTokenRequest
 from backlogops_gui.jira_actions import JiraActions
 from backlogops_gui.log_buffer import LogBuffer
-from backlogops_gui._migrate_warn import GuiMigrateWarnHook
+from backlogops_gui._migrate_warn import GuiMigrateWarnHook, \
+    GuiPresetMigrateWarnHook
 from backlogops_gui.python_version import check_python_version
 from backlogops_gui.tcltk_version import check_tcltk_version
 
@@ -75,6 +86,28 @@ PRESET_CLASSES: dict[PresetKind, type[Config]] = {
     PresetKind.INPUT: InputFormatConfig,
     PresetKind.OUTPUT: OutputFormatConfig}
 _WizardConfig = TypeVar('_WizardConfig', bound=Config)
+_CONFIG_SOURCE_TITLE = 'Configuration wizard'
+_CONFIG_SOURCE_TEXT = (
+    'Start the configuration wizard from scratch, or base it on an '
+    'existing configuration file so you edit its values instead of '
+    'entering everything again?')
+_PRESET_SOURCE_TITLE = 'IO preset'
+_PRESET_SOURCE_TEXT = (
+    'Start the preset wizard from scratch, or base it on an existing '
+    'preset file so you edit its values instead of entering everything '
+    'again?')
+
+
+def _read_config_prefill(path: str, captured: TextIO) -> BacklogOpsConfig:
+    """Read an existing configuration to pre-fill the wizard."""
+    return read_backlog_ops_config(path, captured,
+                                   auto_ch_hook=GuiMigrateWarnHook())
+
+
+def _read_preset_prefill(path: str, captured: TextIO
+                         ) -> InputFormatConfig | OutputFormatConfig:
+    """Read an existing preset, auto-detecting direction, to pre-fill."""
+    return read_io_preset(path, GuiPresetMigrateWarnHook(), captured)
 
 
 def initial_config(config_arg: Optional[str], sink: Optional[TextIO] = None
@@ -229,18 +262,20 @@ class BacklogApp:
         self.config_source = path
         return True
 
-    def _run_bridge_wizard(self,
-                           wizard: Callable[[WizardUiBridge], _WizardConfig],
-                           error_title: str) -> Optional[_WizardConfig]:
+    def _run_bridge_wizard(self, wizard: Callable[..., _WizardConfig],
+                           error_title: str,
+                           default: Optional[_WizardConfig] = None
+                           ) -> Optional[_WizardConfig]:
         """Run a wizard over a fresh Tk bridge, returning its config or None.
 
-        An abandoned wizard ends in ``EOFError`` and yields None; any other
+        The wizard is pre-filled from ``default`` when one is given. An
+        abandoned wizard ends in ``EOFError`` and yields None; any other
         wizard failure is reported under ``error_title`` and also yields
         None. The bridge window is always closed afterwards.
         """
         bridge = TkWizardBridge(self.root, self.log)
         try:
-            return wizard(bridge)
+            return wizard(bridge, default=default)
         except EOFError:
             return None
         except IO_ERRORS as error:
@@ -249,9 +284,57 @@ class BacklogApp:
         finally:
             bridge.close()
 
-    def run_wizard(self) -> Optional[BacklogOpsConfig]:
+    def run_wizard(self, default: Optional[BacklogOpsConfig] = None
+                   ) -> Optional[BacklogOpsConfig]:
         """Run the config wizard and return its configuration, or None."""
-        return self._run_bridge_wizard(backlog_ops_wizard, 'Wizard error')
+        return self._run_bridge_wizard(backlog_ops_wizard, 'Wizard error',
+                                       default)
+
+    def _prefill_default(self, title: str, text: str,
+                         chooser: Callable[[tk.Misc], Optional[str]],
+                         reader: Callable[[str, TextIO], _WizardConfig]
+                         ) -> tuple[bool, Optional[_WizardConfig]]:
+        """Ask whether to base a wizard on a file and read it if so.
+
+        Returns a ``(proceed, default)`` pair. ``proceed`` is False when
+        the user cancels the source dialog or the file chooser, or the
+        chosen file cannot be read, and the caller then does nothing.
+        ``default`` is the configuration read from the chosen file, or
+        None to start the wizard empty.
+        """
+        choice = ask_source_choice(self.root, title, text)
+        if choice is SourceChoice.CANCEL:
+            return False, None
+        if choice is SourceChoice.SCRATCH:
+            return True, None
+        path = chooser(self.root)
+        if path is None:
+            return False, None
+        return self._read_prefill(path, reader)
+
+    def _read_prefill(self, path: str,
+                      reader: Callable[[str, TextIO], _WizardConfig]
+                      ) -> tuple[bool, Optional[_WizardConfig]]:
+        """Read a pre-fill file, reporting a failure and yielding no default.
+
+        The reader can raise the IO errors, or ``SystemExit`` from the
+        configuration factory when the file is missing or is not a preset.
+        """
+        captured = StringIO()
+        try:
+            return True, reader(path, captured)
+        except SystemExit:
+            return self._prefill_failed(captured, f'Could not read {path}.')
+        except IO_ERRORS as error:
+            return self._prefill_failed(captured, str(error))
+
+    def _prefill_failed(self, captured: StringIO,
+                        fallback: str) -> tuple[bool, None]:
+        """Log captured diagnostics and report a pre-fill read failure."""
+        self.log.write(captured.getvalue())
+        self.show_error('Could not read file',
+                        _config_failure(captured, fallback))
+        return False, None
 
     def _load_config_file(self) -> None:
         """Load a chosen configuration file and make it the active config.
@@ -276,8 +359,20 @@ class BacklogApp:
                        f'Loaded configuration from {path}.')
 
     def run_config_wizard(self) -> None:
-        """Run the wizard and make a new configuration active on success."""
-        config = self.run_wizard()
+        """Ask the source, run the wizard, and activate a new config.
+
+        The wizard may start from scratch or be pre-filled from an
+        existing configuration file the user chooses. Its result becomes
+        the active configuration; writing it to a file stays with the
+        ``Write configuration…`` action.
+        """
+        proceed, default = self._prefill_default(_CONFIG_SOURCE_TITLE,
+                                                 _CONFIG_SOURCE_TEXT,
+                                                 choose_existing_config,
+                                                 _read_config_prefill)
+        if not proceed:
+            return
+        config = self.run_wizard(default)
         if config is not None:
             self.config = config
             self.config_source = 'the wizard'
@@ -285,8 +380,20 @@ class BacklogApp:
             self.show_info('Wizard', 'The new configuration is now active.')
 
     def create_preset_file(self) -> None:
-        """Run the IO preset wizard and write the preset to a chosen file."""
-        config = self._run_bridge_wizard(preset_wizard, 'Preset wizard error')
+        """Ask the source, run the IO preset wizard, and write the preset.
+
+        The wizard may start from scratch or be pre-filled from an
+        existing preset file the user chooses; its direction is detected
+        from the file.
+        """
+        proceed, default = self._prefill_default(_PRESET_SOURCE_TITLE,
+                                                 _PRESET_SOURCE_TEXT,
+                                                 choose_existing_preset,
+                                                 _read_preset_prefill)
+        if not proceed:
+            return
+        config = self._run_bridge_wizard(preset_wizard, 'Preset wizard error',
+                                         default)
         if config is not None:
             self._write_to_chosen(config, 'Could not write preset',
                                   'Wrote preset')
@@ -351,20 +458,74 @@ class BacklogApp:
         """Write a configuration to a user-chosen file and report the outcome.
 
         The chosen filename receives the ``.cfg`` extension when missing. A
-        cancelled chooser writes nothing; a write failure is reported under
-        ``fail_title`` and a success under ``ok_title``.
+        cancelled chooser writes nothing, and overwriting an existing file
+        is confirmed first. The write is crash-safe: the configuration is
+        put in a ``.in_progress`` sibling and only then moved onto the
+        output file, so a crash loses neither the old file nor the new one.
+        A write failure is reported under ``fail_title`` and a success
+        under ``ok_title``.
         """
         path = choose_config_file(self.root)
         if path is None:
             return
         path = fix_file_extension(path, CONFIG_EXTENSION)
+        if not self._confirm_overwrite(path):
+            return
         try:
-            config.write(to_json_filename=path, stderr_file=self.log)
+            safe_write_config(config, path, self.log)
         except IO_ERRORS as error:
             self.show_error(fail_title, str(error))
             return
         self.show_info(ok_title, f'Wrote {path}')
 
+    def _confirm_overwrite(self, path: str) -> bool:
+        """Confirm overwriting an existing file; a new file needs no asking."""
+        if not Path(path).exists():
+            return True
+        return self._ok_to_overwrite(Path(path))
+
+    def _ok_to_overwrite(self, path: Path) -> bool:
+        """Ask whether to overwrite a file, as the token writer requires."""
+        return messagebox.askyesno('Overwrite file?',
+                                   f'{path} already exists. Overwrite it?',
+                                   parent=self.root)
+
+    def encrypt_token(self) -> None:
+        """Encrypt a Jira API token to a file chosen in a dialog.
+
+        The dialog gathers a typed token or a clear text token file, the
+        encrypted file to write, and the pass phrase entered twice. An
+        existing output file is only overwritten after confirmation, and
+        any failure is reported.
+        """
+        request = ask_encrypt_token(self.root)
+        if request is None:
+            return
+        if self._run_encrypt(request):
+            self.show_info('Token encrypted', f'Wrote {request.out_file}')
+
+    def _run_encrypt(self, request: EncryptTokenRequest) -> bool:
+        """Encrypt the requested token, reporting any failure."""
+        try:
+            self._do_encrypt(request)
+        except IO_ERRORS as error:
+            self.show_error('Could not encrypt token', str(error))
+            return False
+        return True
+
+    def _do_encrypt(self, request: EncryptTokenRequest) -> None:
+        """Dispatch to the token or the file encryption library function."""
+        if request.token is not None:
+            encrypt_token_to_file(request.token, passphrase=request.passphrase,
+                                  filename=request.out_file,
+                                  ok_to_overwrite=self._ok_to_overwrite)
+            return
+        assert request.clear_file is not None
+        encrypt_token_file(clear_file=request.clear_file,
+                           encrypted_file=request.out_file,
+                           passphrase=request.passphrase,
+                           ok_to_overwrite=self._ok_to_overwrite)
+
     def read_backlog_file(self) -> None:
         """Read a backlog from a chosen file into a new window."""
         path = choose_input_file(self.root)
@@ -375,20 +536,52 @@ class BacklogApp:
                                    sorted(presets) if presets else None)
         if options is None:
             return
+        value = options.config_value
         try:
-            data = read_backlog(path, options.config_value, presets, self.log,
-                                self.levels(), self.status_map())
+            data = read_backlog(path, value, presets, self.log, self.levels(),
+                                self.status_map())
         except IO_ERRORS as error:
             self.show_error('Could not read file', str(error))
             return
-        self.open_backlog(data, path)
+        source = self._file_source(path, value, presets)
+        self.open_backlog(data, path, source=source,
+                          reload=self._file_reload(path, value))
+
+    @staticmethod
+    def _file_source(path: str, value: Optional[str],
+                     presets: Optional[dict[str, InputFormatConfig]]
+                     ) -> BacklogSource:
+        """Describe a file backlog source, naming a preset when used."""
+        preset = value if value and presets and value in presets else None
+        return BacklogSource(kind='file', read_time=current_time(),
+                             file_name=path, preset_name=preset)
+
+    def _file_reload(self, path: str, value: Optional[str]) -> Callable[
+            [Callable[[BacklogReleases, Optional[str]], None]], None]:
+        """Return a reload re-reading the same file with the current config."""
+        def reload(apply: Callable[[BacklogReleases, Optional[str]], None]
+                   ) -> None:
+            """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())
+            except IO_ERRORS as error:
+                self.show_error('Could not read file', str(error))
+                return
+            apply(data, None)
+        return reload
 
     def new_demo_backlog(self) -> None:
         """Open a demonstration backlog in a new window."""
-        self.open_backlog(get_demo_backlog(), 'Demo backlog')
+        source = BacklogSource(kind='demo', read_time=current_time())
+        self.open_backlog(get_demo_backlog(), 'Demo backlog', source=source)
 
     def open_backlog(self, data: BacklogReleases, title: str,
-                     warning: Optional[str] = None) -> None:
+                     warning: Optional[str] = None, *,
+                     source: Optional[BacklogSource] = None,
+                     reload: Optional[Callable[
+                         [Callable[[BacklogReleases, Optional[str]], None]],
+                         None]] = None) -> None:
         """Open one backlog and its releases in a new window."""
         handlers = JiraHandlers(
             add_backlog=self.jira.writer.backlog_action(),
@@ -400,7 +593,8 @@ class BacklogApp:
             rename_releases=self.jira.renamer.rename_action())
         BacklogWindow(self.root, data, title, self.out_presets,
                       self.available_teams, self.log, self.levels,
-                      self.gui_display, warning, handlers)
+                      self.gui_display, warning, handlers, source=source,
+                      reload=reload)
 
     def report_versions(self) -> None:
         """Report version information into the log on a worker thread.
@@ -461,6 +655,9 @@ class BacklogApp:
                          command=self.migrate_preset_file)
         menu.add_command(label='Write configuration…',
                          command=self.write_config)
+        menu.add_separator()
+        menu.add_command(label='Encrypt Jira API token file…',
+                         command=self.encrypt_token)
         menubar.add_cascade(label='Configuration', menu=menu)
 
     def _add_help_menu(self, menubar: tk.Menu) -> None:

backlogops_gui-0.4/src/backlogops_gui/auto_scroll.py

@@ -0,0 +1,37 @@
+#! /usr/local/bin/python3
+"""A scroll command that shows a scrollbar only while it can scroll.
+
+A table that fits its area needs no scrollbar, and a scrollbar that is
+always shown wastes space and hints at hidden content that is not there.
+:func:`auto_hide` returns the scroll command for a scrolling widget: the
+command hides the scrollbar while the whole range is visible and shows it
+again once the widget grows past its area. It works for any widget that
+reports its position through an ``xscrollcommand`` or ``yscrollcommand``,
+so the wizard table canvas and the read-only backlog tree can share it.
+"""
+
+# Copyright (c) 2026, Tom Björkholm
+# MIT License
+
+from tkinter import ttk
+from typing import Callable
+
+
+def auto_hide(scrollbar: ttk.Scrollbar
+              ) -> Callable[[float | str, float | str], None]:
+    """Return a scroll command that hides the scrollbar when it is full.
+
+    The result is used as a widget's ``xscrollcommand`` or
+    ``yscrollcommand``. Tk reports the position as two fractions, which it
+    passes as strings, so the command accepts either a number or its
+    string form. The scrollbar must be laid out with the grid manager,
+    whose ``grid_remove`` remembers its cell across the hide.
+    """
+    def command(first: float | str, last: float | str) -> None:
+        """Hide or show the scrollbar, then move its thumb to the view."""
+        if float(first) <= 0.0 and float(last) >= 1.0:
+            scrollbar.grid_remove()
+        else:
+            scrollbar.grid()
+        scrollbar.set(first, last)
+    return command