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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops-cli
-Version: 0.3
+Version: 0.5
 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.5
 Requires-Dist: versionreporter>=0.4
 Dynamic: author
 Dynamic: license-file
@@ -48,6 +48,14 @@ 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
+
+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.
+
 ## Available functionality
 
 The following functionality is available in all 3 packages:
@@ -249,6 +257,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 +318,10 @@ backlogops_cli serves 2 purposes:
 
 ## Test summary
 
-- Test result: 2284 passed, 7 deselected in 44s
+- Test result: 2450 passed, 9 deselected in 41s
 - No flake8 warnings.
 - No mypy errors found.
+- No pylint warnings.
 - No python layout warnings.
-- Built version(s): 0.3
+- Built version(s): 0.5
 - Build and test using Python 3.14.6

{backlogops_cli-0.3 → backlogops_cli-0.5}/README_pypi.md

@@ -14,6 +14,14 @@ 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
+
+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.
+
 ## Available functionality
 
 The following functionality is available in all 3 packages:
@@ -215,6 +223,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 +284,10 @@ backlogops_cli serves 2 purposes:
 
 ## Test summary
 
-- Test result: 2284 passed, 7 deselected in 44s
+- Test result: 2450 passed, 9 deselected in 41s
 - No flake8 warnings.
 - No mypy errors found.
+- No pylint warnings.
 - No python layout warnings.
-- Built version(s): 0.3
+- Built version(s): 0.5
 - Build and test using Python 3.14.6

{backlogops_cli-0.3 → backlogops_cli-0.5}/backlogops_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backlogops-cli
-Version: 0.3
+Version: 0.5
 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.5
 Requires-Dist: versionreporter>=0.4
 Dynamic: author
 Dynamic: license-file
@@ -48,6 +48,14 @@ 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
+
+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.
+
 ## Available functionality
 
 The following functionality is available in all 3 packages:
@@ -249,6 +257,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 +318,10 @@ backlogops_cli serves 2 purposes:
 
 ## Test summary
 
-- Test result: 2284 passed, 7 deselected in 44s
+- Test result: 2450 passed, 9 deselected in 41s
 - No flake8 warnings.
 - No mypy errors found.
+- No pylint warnings.
 - No python layout warnings.
-- Built version(s): 0.3
+- Built version(s): 0.5
 - Build and test using Python 3.14.6

{backlogops_cli-0.3 → backlogops_cli-0.5}/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.5}/backlogops_cli.egg-info/requires.txt

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

{backlogops_cli-0.3 → backlogops_cli-0.5}/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.5}/setup.py

@@ -5,7 +5,7 @@ from setuptools import setup
 
 setup(
   name='backlogops-cli',
-  version='0.3',
+  version='0.5',
   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.5',
     'versionreporter >= 0.4'
   ]
 )

{backlogops_cli-0.3 → backlogops_cli-0.5}/src/backlogops_cli/_command_io.py

@@ -12,9 +12,10 @@ underscore in the module name keeps it out of the command listing.
 
 import argparse
 import sys
+from getpass import getpass
 from pathlib import Path
 from collections.abc import Callable
-from typing import Optional, TextIO
+from typing import Optional, TextIO, TypeVar
 import argcomplete
 from backlogops_cli._migrate_warn import (
     CliMigrateWarnHook, CliPresetMigrateWarnHook)
@@ -27,6 +28,9 @@ from backlogops import (
     resolve_output_config, write_backlog_releases, write_content_changes,
     write_date_changes)
 
+ResultT = TypeVar('ResultT')
+"""Result type of a Jira write, carried from the operation to the report."""
+
 RANK_ANCHOR_CHOICES = {
     'backlog-top': JiraRankAnchor.BACKLOG_TOP,
     'backlog-bottom': JiraRankAnchor.BACKLOG_BOTTOM,
@@ -97,6 +101,11 @@ def parsed_args(parser: argparse.ArgumentParser,
     return parser.parse_args(args)
 
 
+def jira_passphrase() -> str:
+    """Ask for the Jira API token pass phrase on the terminal."""
+    return getpass('Jira API token pass phrase: ')
+
+
 def add_input_args(parser: argparse.ArgumentParser) -> None:
     """Add the input-file and input-config arguments."""
     parser.add_argument('-i', '--input', dest='input', required=True,
@@ -120,6 +129,18 @@ def add_config_arg(parser: argparse.ArgumentParser) -> None:
                         '$HOME/.backlogops.cfg.')
 
 
+def add_preset_arg(parser: argparse.ArgumentParser) -> None:
+    """Add the required ``-p``/``--preset`` Jira preset argument."""
+    parser.add_argument('-p', '--preset', dest='preset', required=True,
+                        help='Name of the Jira preset in the configuration.')
+
+
+def add_quiet_arg(parser: argparse.ArgumentParser) -> None:
+    """Add the ``-q``/``--quiet`` flag suppressing the result lists."""
+    parser.add_argument('-q', '--quiet', dest='quiet', action='store_true',
+                        help='Do not print the result lists to stdout.')
+
+
 def _resolve_config(parsed: argparse.Namespace) -> BacklogOpsConfig:
     """Return the backlog-ops configuration from ``-c`` or by discovery.
 
@@ -265,6 +286,23 @@ def build_io_parser(description: str, *, with_input: bool = True,
     return parser
 
 
+def build_jira_parser(description: str, *,
+                      with_input: bool = True) -> argparse.ArgumentParser:
+    """Create a parser with the config, preset and optional input options.
+
+    The Jira commands all take a backlog-ops configuration and a required
+    ``-p``/``--preset``. Most also read an input file, so ``with_input``
+    adds the input-file and input-config options by default; a command
+    that does not read a backlog file passes ``with_input=False``.
+    """
+    parser = argparse.ArgumentParser(description=description)
+    if with_input:
+        add_input_args(parser)
+    add_config_arg(parser)
+    add_preset_arg(parser)
+    return parser
+
+
 def _write_output(parsed: argparse.Namespace,
                   config: Optional[BacklogOpsConfig],
                   data: BacklogReleases) -> None:
@@ -317,6 +355,63 @@ def run_write(parsed: argparse.Namespace,
     return 0
 
 
+def run_write_command(
+        build_parser: Callable[[], argparse.ArgumentParser],
+        produce: Callable[[argparse.Namespace, Optional[BacklogOpsConfig]],
+                          BacklogReleases],
+        args: Optional[list[str]]) -> int:
+    """Parse the command line and write the produced backlog and releases.
+
+    Folds argument parsing and :func:`run_write` so an ordering command's
+    ``main`` stays a single delegating call. ``produce`` receives the
+    parsed args and the resolved config (or None) and returns the data.
+    """
+    parsed = parsed_args(build_parser(), args)
+    return run_write(parsed, lambda config: produce(parsed, config))
+
+
+def write_result_file(config: BacklogOpsConfig, path: str,
+                      data: BacklogReleases, force: bool) -> None:
+    """Write one backlog-and-releases result file, honoring ``--force``."""
+    out_config = resolve_output_config(None, data_file=path,
+                                       presets=config.output_configs,
+                                       auto_ch_hook=CliPresetMigrateWarnHook())
+    write_backlog_releases(data, path, out_config, FormatRules(),
+                           levels=config.get_levels(),
+                           file_exists_callback=overwrite_callback(force))
+    print(f'Wrote {path}')
+
+
+def run_added_to_jira(
+        parsed: argparse.Namespace,
+        add: Callable[
+            [argparse.Namespace, BacklogOpsConfig, BacklogReleases], ResultT],
+        report: Callable[[ResultT], str], exists_error: type[Exception],
+        fail_note: str) -> int:
+    """Read the input, add it to Jira, and print the added lists.
+
+    ``add`` receives the parsed args, the config and the input data, adds
+    to Jira, writes any ``--added``/``--existing`` files, and returns the
+    result. ``report`` formats that result for stdout, printed unless
+    ``-q``/``--quiet`` was given. ``exists_error`` is the key-exists error
+    meaning nothing was added; other value or OS errors are reported with
+    ``fail_note``.
+    """
+    try:
+        config = required_config(parsed)
+        data = read_input(parsed, config)
+        result = add(parsed, config, data)
+    except exists_error:
+        print('Nothing added to Jira.', file=sys.stderr)
+        return 1
+    except (ValueError, TypeError, KeyError, OSError) as error:
+        print(f'{fail_note}: {error}', file=sys.stderr)
+        return 1
+    if not parsed.quiet:
+        print(report(result))
+    return 0
+
+
 DEFAULT_BUFFER_DAYS = 5
 """Default slack in calendar days added when fitting dates."""
 

backlogops_cli-0.5/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.5}/src/backlogops_cli/add_releases_to_jira.py

@@ -20,27 +20,21 @@ asked on the terminal only when it is needed.
 
 import argparse
 import sys
-from getpass import getpass
 from typing import Optional
 from backlogops import (
-    AddedReleasesToJira, BacklogOpsConfig, BacklogReleases, FormatRules,
-    JiraConnections, OnExistingKey, ReleaseExistsError, add_releases_to_jira,
-    format_release_result, resolve_output_config, write_backlog_releases)
+    AddedReleasesToJira, BacklogOpsConfig, BacklogReleases, JiraConnections,
+    OnExistingKey, ReleaseExistsError, add_releases_to_jira,
+    format_release_result)
 from backlogops_cli._command_io import (
-    add_config_arg, add_input_args, overwrite_callback, parsed_args,
-    read_input, required_config)
-from backlogops_cli._migrate_warn import CliPresetMigrateWarnHook
+    add_force_arg, add_quiet_arg, build_jira_parser, jira_passphrase,
+    parsed_args, run_added_to_jira, write_result_file)
 
 DESCRIPTION = 'Add releases to Jira, creating a new version per release'
 
 
 def build_parser() -> argparse.ArgumentParser:
     """Build the command line parser for the add-releases command."""
-    parser = argparse.ArgumentParser(description=DESCRIPTION)
-    add_input_args(parser)
-    add_config_arg(parser)
-    parser.add_argument('-p', '--preset', dest='preset', required=True,
-                        help='Name of the Jira preset in the configuration.')
+    parser = build_jira_parser(DESCRIPTION)
     parser.add_argument('--skip-existing', dest='skip_existing',
                         action='store_true',
                         help='Skip releases whose name already exists in Jira '
@@ -52,26 +46,17 @@ def build_parser() -> argparse.ArgumentParser:
                         metavar='FILE',
                         help='Write the releases already in Jira, with the '
                         'input backlog, to this file. Omit to not write it.')
-    parser.add_argument('-q', '--quiet', dest='quiet', action='store_true',
-                        help='Do not print the added and already-present '
-                        'lists to stdout.')
-    parser.add_argument('-f', '--force', dest='force', action='store_true',
-                        help='Overwrite existing output files without '
-                        'asking.')
+    add_quiet_arg(parser)
+    add_force_arg(parser)
     return parser
 
 
-def _passphrase() -> str:
-    """Ask for the Jira token pass phrase on the terminal."""
-    return getpass('Jira API token pass phrase: ')
-
-
 def _add(parsed: argparse.Namespace, config: BacklogOpsConfig,
          data: BacklogReleases) -> AddedReleasesToJira:
     """Add the input releases to Jira using the named preset."""
     print(f"Adding releases to Jira using preset '{parsed.preset}'...",
           file=sys.stderr)
-    connections = JiraConnections(config.get_jira_config(), _passphrase)
+    connections = JiraConnections(config.get_jira_config(), jira_passphrase)
     mode = (OnExistingKey.SKIP if parsed.skip_existing
             else OnExistingKey.RAISE)
     result = add_releases_to_jira(connections, parsed.preset, data.releases,
@@ -82,18 +67,6 @@ def _add(parsed: argparse.Namespace, config: BacklogOpsConfig,
     return result
 
 
-def _write_file(config: BacklogOpsConfig, path: str, data: BacklogReleases,
-                force: bool) -> None:
-    """Write one backlog-and-releases result to a file."""
-    out_config = resolve_output_config(None, data_file=path,
-                                       presets=config.output_configs,
-                                       auto_ch_hook=CliPresetMigrateWarnHook())
-    write_backlog_releases(data, path, out_config, FormatRules(),
-                           levels=config.get_levels(),
-                           file_exists_callback=overwrite_callback(force))
-    print(f'Wrote {path}')
-
-
 def _write_result_files(parsed: argparse.Namespace, config: BacklogOpsConfig,
                         data: BacklogReleases,
                         result: AddedReleasesToJira) -> None:
@@ -101,29 +74,26 @@ def _write_result_files(parsed: argparse.Namespace, config: BacklogOpsConfig,
     backlog = list(data.backlog)
     if parsed.added_file is not None:
         added = BacklogReleases(backlog=backlog, releases=result.stored)
-        _write_file(config, parsed.added_file, added, parsed.force)
+        write_result_file(config, parsed.added_file, added, parsed.force)
     if parsed.existing_file is not None:
         present = BacklogReleases(backlog=backlog,
                                   releases=result.already_present)
-        _write_file(config, parsed.existing_file, present, parsed.force)
+        write_result_file(config, parsed.existing_file, present, parsed.force)
+
+
+def _add_and_write(parsed: argparse.Namespace, config: BacklogOpsConfig,
+                   data: BacklogReleases) -> AddedReleasesToJira:
+    """Add the releases to Jira and write any requested result files."""
+    result = _add(parsed, config, data)
+    _write_result_files(parsed, config, data, result)
+    return result
 
 
 def _run(parsed: argparse.Namespace) -> int:
     """Read the input, add the releases, write files and print the lists."""
-    try:
-        config = required_config(parsed)
-        data = read_input(parsed, config)
-        result = _add(parsed, config, data)
-        _write_result_files(parsed, config, data, result)
-    except ReleaseExistsError:
-        print('Nothing added to Jira.', file=sys.stderr)
-        return 1
-    except (ValueError, TypeError, KeyError, OSError) as error:
-        print(f'Could not add releases to Jira: {error}', file=sys.stderr)
-        return 1
-    if not parsed.quiet:
-        print(format_release_result(result))
-    return 0
+    return run_added_to_jira(parsed, _add_and_write, format_release_result,
+                             ReleaseExistsError,
+                             'Could not add releases to Jira')
 
 
 def main(args: Optional[list[str]] = None) -> int:
@@ -136,8 +106,7 @@ def main(args: Optional[list[str]] = None) -> int:
         ``0`` on success, ``1`` when the releases cannot be added or a name
         already exists in Jira without ``--skip-existing``.
     """
-    parsed = parsed_args(build_parser(), args)
-    return _run(parsed)
+    return _run(parsed_args(build_parser(), args))
 
 
 if __name__ == '__main__':  # pragma: no cover