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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops-cli
-Version: 0.3
+Version: 0.4
 Summary: Command line 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: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
@@ -25,7 +25,7 @@ Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Requires-Dist: argcomplete>=3.7.0
-Requires-Dist: backlogops>=0.3
+Requires-Dist: backlogops>=0.4
 Requires-Dist: versionreporter>=0.4
 Dynamic: author
 Dynamic: license-file
@@ -48,6 +48,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:
@@ -249,6 +261,9 @@ backlogops_cli serves 2 purposes:
   python3 -m backlogops_cli.demo_backlog
      Write a demonstration backlog and releases to a file
 
+  python3 -m backlogops_cli.encrypt_token_file
+     Encrypt a Jira API token file with a pass phrase.
+
   python3 -m backlogops_cli.estimate_ready_date
      Estimate ready dates for the backlog items
 
@@ -307,9 +322,9 @@ backlogops_cli serves 2 purposes:
 
 ## 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_cli-0.3 → backlogops_cli-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:
@@ -215,6 +227,9 @@ backlogops_cli serves 2 purposes:
   python3 -m backlogops_cli.demo_backlog
      Write a demonstration backlog and releases to a file
 
+  python3 -m backlogops_cli.encrypt_token_file
+     Encrypt a Jira API token file with a pass phrase.
+
   python3 -m backlogops_cli.estimate_ready_date
      Estimate ready dates for the backlog items
 
@@ -273,9 +288,9 @@ backlogops_cli serves 2 purposes:
 
 ## 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_cli-0.3 → backlogops_cli-0.4}/backlogops_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops-cli
-Version: 0.3
+Version: 0.4
 Summary: Command line 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: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
@@ -25,7 +25,7 @@ Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Requires-Dist: argcomplete>=3.7.0
-Requires-Dist: backlogops>=0.3
+Requires-Dist: backlogops>=0.4
 Requires-Dist: versionreporter>=0.4
 Dynamic: author
 Dynamic: license-file
@@ -48,6 +48,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:
@@ -249,6 +261,9 @@ backlogops_cli serves 2 purposes:
   python3 -m backlogops_cli.demo_backlog
      Write a demonstration backlog and releases to a file
 
+  python3 -m backlogops_cli.encrypt_token_file
+     Encrypt a Jira API token file with a pass phrase.
+
   python3 -m backlogops_cli.estimate_ready_date
      Estimate ready dates for the backlog items
 
@@ -307,9 +322,9 @@ backlogops_cli serves 2 purposes:
 
 ## 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_cli-0.3 → backlogops_cli-0.4}/backlogops_cli.egg-info/SOURCES.txt

@@ -19,6 +19,7 @@ src/backlogops_cli/bloc_version_reporter.py
 src/backlogops_cli/config_wizard.py
 src/backlogops_cli/convert.py
 src/backlogops_cli/demo_backlog.py
+src/backlogops_cli/encrypt_token_file.py
 src/backlogops_cli/estimate_ready_date.py
 src/backlogops_cli/extract_keys.py
 src/backlogops_cli/jira_fields.py

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

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

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

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

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

@@ -5,7 +5,7 @@ from setuptools import setup
 
 setup(
   name='backlogops-cli',
-  version='0.3',
+  version='0.4',
   description='Command line interface for backlog operations.',
   author='Tom Björkholm',
   author_email='klausuler_linnet0q@icloud.com',
@@ -15,7 +15,7 @@ setup(
   package_data={'backlogops_cli': ['src/py.typed']},
   install_requires=[
     'argcomplete >= 3.7.0',
-    'backlogops >= 0.3',
+    'backlogops >= 0.4',
     'versionreporter >= 0.4'
   ]
 )

backlogops_cli-0.4/src/backlogops_cli/_wizard_io.py

@@ -0,0 +1,126 @@
+#! /usr/local/bin/python3
+"""Shared helpers for the configuration and preset wizard commands.
+
+Both wizard commands write a JSON configuration file built interactively
+through a ``WizardUiBridge``. They share the same command line shape (an
+output file, an optional input file whose contents pre-fill the wizard, a
+switch forcing the plain console interface, and a force flag), the same
+overwrite check, the same read-run-write-report flow, and the same
+crash-safe write. That shared logic lives here; the leading underscore in
+the module name keeps it out of the command listing.
+"""
+# PYTHON_ARGCOMPLETE_OK
+
+# Copyright (c) 2026, Tom Björkholm
+# MIT License
+
+import argparse
+import sys
+from collections.abc import Callable
+from pathlib import Path
+from typing import Optional, TypeVar
+from config_as_json import Config
+from config_as_json.file_extension import fix_file_extension
+from tableio_cfg_json import WizardUiBridge, WizardUiBridgeConsole, \
+    make_text_ui_bridge
+from backlogops import safe_write_config
+from backlogops_cli._command_io import add_force_arg, overwrite_callback
+
+CONFIG_EXTENSION = '.cfg'
+_ConfigT = TypeVar('_ConfigT', bound=Config)
+
+
+def build_wizard_parser(description: str) -> argparse.ArgumentParser:
+    """Build a wizard parser with output, input, no-textual and force."""
+    parser = argparse.ArgumentParser(description=description)
+    parser.add_argument('-o', '--output', dest='output', required=True,
+                        help='Configuration file to write; the '
+                        f'{CONFIG_EXTENSION} extension is added if missing.')
+    parser.add_argument('-i', '--input', dest='input',
+                        help='Existing configuration file whose contents '
+                        'pre-fill the wizard as the starting answers, so you '
+                        'edit them instead of starting empty. Use the same '
+                        'path as -o to edit that file in place; you are then '
+                        f'asked to confirm overwriting it. The '
+                        f'{CONFIG_EXTENSION} extension is assumed when the '
+                        'file is not found as named.')
+    parser.add_argument('--no-textual', dest='no_textual', action='store_true',
+                        help='Force the plain console interface instead of '
+                        'the Textual full-screen interface.')
+    add_force_arg(parser)
+    return parser
+
+
+def _check_overwrite(output: str, force: bool) -> None:
+    """Ask before overwriting an existing configuration file.
+
+    The check runs before the wizard, so the user is not asked to confirm
+    an overwrite only after entering the whole configuration.
+    """
+    if Path(output).exists():
+        overwrite_callback(force)(output)
+
+
+def _make_bridge(no_textual: bool) -> WizardUiBridge:
+    """Return the console bridge when forced, else the best text bridge.
+
+    Without ``--no-textual`` the factory returns a Textual full-screen
+    bridge in a real terminal and a console bridge otherwise, such as when
+    input is redirected or under tests.
+    """
+    if no_textual:
+        return WizardUiBridgeConsole(sys.stdout, sys.stdin, sys.stderr)
+    return make_text_ui_bridge(sys.stdout, sys.stdin, sys.stderr)
+
+
+def _read_default(input_file: Optional[str],
+                  reader: Callable[[str], _ConfigT]) -> Optional[_ConfigT]:
+    """Read the pre-fill file, or return None when none is requested.
+
+    The ``.cfg`` extension is assumed when the named file is not found as
+    given, matching how the output filename is completed.
+    """
+    if input_file is None:
+        return None
+    path = fix_file_extension(input_file, CONFIG_EXTENSION, for_reading=True)
+    if not Path(path).is_file():
+        raise ValueError(f'File to read initial values from not found: {path}')
+    return reader(path)
+
+
+def run_wizard_to_file(parsed: argparse.Namespace,
+                       wizard: Callable[..., _ConfigT],
+                       reader: Callable[[str], _ConfigT], label: str) -> int:
+    """Run a wizard, write its configuration to the output file, report.
+
+    When ``parsed.input`` names an existing file it is read first and used
+    to pre-fill the wizard, so the user edits those values instead of
+    starting from scratch. The output filename receives the ``.cfg``
+    extension when it is not already present, an existing output file is
+    only overwritten after confirmation (or with ``--force``), and the
+    result is written crash-safely through a ``.in_progress`` sibling file.
+
+    Args:
+        parsed: Parsed arguments holding ``output``, ``input``, ``force``
+            and ``no_textual``.
+        wizard: Wizard called with the chosen UI bridge and the pre-fill
+            default; it returns a configuration object that knows how to
+            write itself.
+        reader: Reads the ``input`` file into a default for the wizard.
+        label: Human-readable name of what was written, for the message.
+
+    Returns:
+        ``0`` on success, ``1`` when the wizard is abandoned or the
+        configuration is rejected or cannot be read or written.
+    """
+    output = fix_file_extension(parsed.output, CONFIG_EXTENSION)
+    try:
+        default = _read_default(parsed.input, reader)
+        _check_overwrite(output, parsed.force)
+        config = wizard(_make_bridge(parsed.no_textual), default=default)
+        safe_write_config(config, output, sys.stderr)
+    except (ValueError, TypeError, KeyError, EOFError, OSError) as error:
+        print(f'Could not create the configuration: {error}', file=sys.stderr)
+        return 1
+    print(f'{label} written to {output}')
+    return 0

{backlogops_cli-0.3 → backlogops_cli-0.4}/src/backlogops_cli/config_wizard.py

@@ -8,8 +8,10 @@
 import argparse
 import sys
 from typing import Optional
-from backlogops import backlog_ops_wizard
+from backlogops import BacklogOpsConfig, backlog_ops_wizard, \
+    read_backlog_ops_config
 from backlogops_cli._command_io import parsed_args
+from backlogops_cli._migrate_warn import CliMigrateWarnHook
 from backlogops_cli._wizard_io import build_wizard_parser, run_wizard_to_file
 
 DESCRIPTION = 'Create a backlog-ops configuration file via a wizard'
@@ -20,21 +22,30 @@ def build_parser() -> argparse.ArgumentParser:
     return build_wizard_parser(DESCRIPTION)
 
 
+def _read_config(filename: str) -> BacklogOpsConfig:
+    """Read an existing backlog-ops configuration to pre-fill the wizard."""
+    return read_backlog_ops_config(filename, sys.stderr,
+                                   auto_ch_hook=CliMigrateWarnHook())
+
+
 def main(args: Optional[list[str]] = None) -> int:
     """Run the interactive wizard and write the backlog-ops configuration.
 
-    The output filename receives the ``.cfg`` extension when it is not
-    already present.
+    With ``-i`` an existing configuration file is read first and used to
+    pre-fill the wizard, so the user edits those values; pointing ``-i`` at
+    the same file as ``-o`` edits it in place after confirming the
+    overwrite. The output filename receives the ``.cfg`` extension when it
+    is not already present.
 
     Args:
         args: Optional replacement for ``sys.argv[1:]``, mainly for tests.
 
     Returns:
         ``0`` on success, ``1`` when the entered configuration is rejected
-        or cannot be written.
+        or cannot be read or written.
     """
     parsed = parsed_args(build_parser(), args)
-    return run_wizard_to_file(parsed, backlog_ops_wizard,
+    return run_wizard_to_file(parsed, backlog_ops_wizard, _read_config,
                               'Backlog-ops configuration')
 
 

backlogops_cli-0.4/src/backlogops_cli/encrypt_token_file.py

@@ -0,0 +1,120 @@
+#!/usr/local/bin/python3
+"""Encrypt a Jira API token to a file with a pass phrase.
+
+Read a clear text API token from a file or from standard input, encrypt it
+with a pass phrase and write the encrypted token to a file. The pass phrase
+is requested on the terminal and is not echoed. The clear text token file
+is not modified, unless the the encrypted token file is the same as the
+clear text token file, in which case the clear text token file is overwritten
+with the encrypted token. The encrypted token file is written atomically,
+so that it is either the old version or the new version, and never a
+half-written file.
+"""
+
+# PYTHON_ARGCOMPLETE_OK
+# Copyright (c) 2026, Tom Björkholm
+# MIT License
+
+import argparse
+import sys
+from getpass import getpass
+from pathlib import Path
+from typing import Optional
+from backlogops import encrypt_token_to_file, encrypt_token_file
+from backlogops_cli._command_io import parsed_args
+
+
+DESCRIPTION = 'Encrypt a Jira API token file with a pass phrase.'
+
+
+def _ok_to_overwrite(filename: Path) -> bool:
+    """Return True if the file can be overwritten, False otherwise."""
+    txt = f'The output file {filename} already exists. Overwrite? [y/n] '
+    while True:
+        answer = input(txt)
+        if answer.lower().strip() in ('y', 'ye', 'yes'):
+            return True
+        if answer.lower().strip() in ('n', 'no'):
+            return False
+        print('Please answer yes or no.')
+    return False  # pragma: no cover
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """Build the command line parser for the encrypt-token-file command."""
+    descr = DESCRIPTION + '. The pass phrase is requested on the terminal.'
+    descr += ' The clear text token file is not modified, unless the output'
+    descr += ' file is the same as the input file, in which case the clear'
+    descr += ' text token file is overwritten with the encrypted token.'
+    parser = argparse.ArgumentParser(description=descr)
+    inhelp = 'The clear text token file to read from. Omit to read from stdin.'
+    parser.add_argument('-i', '--infile', required=False, help=inhelp)
+    parser.add_argument('-o', '--outfile', required=True,
+                        help='The encrypted token file to write to.')
+    return parser
+
+
+EXCEPTIONS = (FileNotFoundError, ValueError, FileExistsError,
+              NotADirectoryError, OSError)
+
+
+def _run(parsed: argparse.Namespace) -> int:
+    """Run the encrypt-token-file command with the given parsed arguments.
+
+    Args:
+        parsed: The parsed command line arguments.
+    Returns:
+        0 if the command was successful, 1 if there was an error
+    """
+    outfile = Path(parsed.outfile)
+    token: Optional[str] = None
+    pphrase1 = 'a'
+    phrase2 = 'b'
+    while pphrase1 != phrase2 or not pphrase1:
+        pphrase1 = getpass('Enter the pass phrase to encrypt the token with: ')
+        if not pphrase1:
+            print('No pass phrase entered. Exiting.')
+            return 1
+        phrase2 = getpass('Re-enter the pass phrase to confirm: ')
+        if pphrase1 != phrase2:
+            print('Pass phrases do not match. Please try again.')
+    if not parsed.infile:
+        print('Enter the clear text token on a single line, then press Enter.')
+        token = input().strip()
+        if not token:
+            print('No token entered. Exiting.')
+            return 1
+        try:
+            encrypt_token_to_file(token, passphrase=pphrase1, filename=outfile,
+                                  ok_to_overwrite=_ok_to_overwrite)
+            return 0
+        except EXCEPTIONS as e:
+            print(f'Error encrypting token: {e}')
+            return 1
+    infile = Path(parsed.infile)
+    try:
+        encrypt_token_file(clear_file=infile, encrypted_file=outfile,
+                           passphrase=pphrase1,
+                           ok_to_overwrite=_ok_to_overwrite)
+        return 0
+    except EXCEPTIONS as e:
+        print(f'Error encrypting token file: {e}')
+        return 1
+    return 2  # pragma: no cover  # this should never be reached
+
+
+def main(arguments: Optional[list[str]] = None) -> int:
+    """Encrypt a Jira API token file with a pass phrase.
+
+    Args:
+        arguments: The command line arguments to parse. If None, the arguments
+            are taken from sys.argv.
+    Returns:
+        0 if the command was successful, 1 if there was an error.
+    """
+    parsed = parsed_args(build_parser(), arguments)
+    return _run(parsed)
+
+
+if __name__ == '__main__':  # pragma: no cover
+    sys.exit(main())

{backlogops_cli-0.3 → backlogops_cli-0.4}/src/backlogops_cli/preset_wizard.py

@@ -14,8 +14,10 @@ configuration is taken, by giving its file name.
 import argparse
 import sys
 from typing import Optional
-from backlogops import preset_wizard
+from backlogops import InputFormatConfig, OutputFormatConfig, preset_wizard, \
+    read_io_preset
 from backlogops_cli._command_io import parsed_args
+from backlogops_cli._migrate_warn import CliPresetMigrateWarnHook
 from backlogops_cli._wizard_io import build_wizard_parser, run_wizard_to_file
 
 DESCRIPTION = 'Create an input or output preset config file via a wizard'
@@ -26,22 +28,35 @@ def build_parser() -> argparse.ArgumentParser:
     return build_wizard_parser(DESCRIPTION)
 
 
+def _read_preset(filename: str) -> InputFormatConfig | OutputFormatConfig:
+    """Read a stand-alone preset file, auto-detecting its direction.
+
+    The direction is detected from the file contents; the wizard still
+    lets the user switch direction afterwards.
+    """
+    return read_io_preset(filename, CliPresetMigrateWarnHook(), sys.stderr)
+
+
 def main(args: Optional[list[str]] = None) -> int:
     """Run the interactive IO preset wizard and write the preset file.
 
     The wizard asks whether to build an input or an output preset and then
-    the settings for it. The output filename receives the ``.cfg``
-    extension when it is not already present.
+    the settings for it. With ``-i`` an existing preset file is read first
+    and used to pre-fill the wizard; its direction (input or output) is
+    detected from the file, and pointing ``-i`` at the same file as ``-o``
+    edits it in place after confirming the overwrite. The output filename
+    receives the ``.cfg`` extension when it is not already present.
 
     Args:
         args: Optional replacement for ``sys.argv[1:]``, mainly for tests.
 
     Returns:
         ``0`` on success, ``1`` when the wizard is abandoned or the preset
-        cannot be written.
+        cannot be read or written.
     """
     parsed = parsed_args(build_parser(), args)
-    return run_wizard_to_file(parsed, preset_wizard, 'IO preset configuration')
+    return run_wizard_to_file(parsed, preset_wizard, _read_preset,
+                              'IO preset configuration')
 
 
 if __name__ == '__main__':  # pragma: no cover

backlogops_cli-0.3/src/backlogops_cli/_wizard_io.py

@@ -1,92 +0,0 @@
-#! /usr/local/bin/python3
-"""Shared helpers for the configuration and preset wizard commands.
-
-Both wizard commands write a JSON configuration file built interactively
-through a ``WizardUiBridge``. They share the same command line shape (an
-output file, a switch forcing the plain console interface, and a force
-flag), the same overwrite check, and the same run-write-report flow. That
-shared logic lives here; the leading underscore in the module name keeps
-it out of the command listing.
-"""
-# PYTHON_ARGCOMPLETE_OK
-
-# Copyright (c) 2026, Tom Björkholm
-# MIT License
-
-import argparse
-import sys
-from collections.abc import Callable
-from pathlib import Path
-from config_as_json import Config
-from config_as_json.file_extension import fix_file_extension
-from tableio_cfg_json import WizardUiBridge, WizardUiBridgeConsole, \
-    make_text_ui_bridge
-from backlogops_cli._command_io import add_force_arg, overwrite_callback
-
-CONFIG_EXTENSION = '.cfg'
-
-
-def build_wizard_parser(description: str) -> argparse.ArgumentParser:
-    """Build a wizard parser with output, no-textual and force options."""
-    parser = argparse.ArgumentParser(description=description)
-    parser.add_argument('-o', '--output', dest='output', required=True,
-                        help='Configuration file to write; the '
-                        f'{CONFIG_EXTENSION} extension is added if missing.')
-    parser.add_argument('--no-textual', dest='no_textual', action='store_true',
-                        help='Force the plain console interface instead of '
-                        'the Textual full-screen interface.')
-    add_force_arg(parser)
-    return parser
-
-
-def _check_overwrite(output: str, force: bool) -> None:
-    """Ask before overwriting an existing configuration file.
-
-    The check runs before the wizard, so the user is not asked to confirm
-    an overwrite only after entering the whole configuration.
-    """
-    if Path(output).exists():
-        overwrite_callback(force)(output)
-
-
-def _make_bridge(no_textual: bool) -> WizardUiBridge:
-    """Return the console bridge when forced, else the best text bridge.
-
-    Without ``--no-textual`` the factory returns a Textual full-screen
-    bridge in a real terminal and a console bridge otherwise, such as when
-    input is redirected or under tests.
-    """
-    if no_textual:
-        return WizardUiBridgeConsole(sys.stdout, sys.stdin, sys.stderr)
-    return make_text_ui_bridge(sys.stdout, sys.stdin, sys.stderr)
-
-
-def run_wizard_to_file(parsed: argparse.Namespace,
-                       wizard: Callable[[WizardUiBridge], Config],
-                       label: str) -> int:
-    """Run a wizard, write its configuration to the output file, report.
-
-    The output filename receives the ``.cfg`` extension when it is not
-    already present.
-
-    Args:
-        parsed: Parsed arguments holding ``output``, ``force`` and
-            ``no_textual``.
-        wizard: Wizard called with the chosen UI bridge; it returns a
-            configuration object that knows how to write itself.
-        label: Human-readable name of what was written, for the message.
-
-    Returns:
-        ``0`` on success, ``1`` when the wizard is abandoned or the
-        configuration is rejected or cannot be written.
-    """
-    output = fix_file_extension(parsed.output, CONFIG_EXTENSION)
-    try:
-        _check_overwrite(output, parsed.force)
-        config = wizard(_make_bridge(parsed.no_textual))
-        config.write(to_json_filename=output, stderr_file=sys.stderr)
-    except (ValueError, TypeError, KeyError, EOFError, OSError) as error:
-        print(f'Could not create the configuration: {error}', file=sys.stderr)
-        return 1
-    print(f'{label} written to {output}')
-    return 0