hypershell 2.7.0__tar.gz → 2.7.1__tar.gz

hypershell-2.7.1/.github/FUNDING.yml

@@ -0,0 +1,12 @@
+# These are supported funding model platforms
+
+github: glentner
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

hypershell-2.7.1/.github/workflows/publish.yml

@@ -0,0 +1,19 @@
+name: Publish
+on:
+  release:
+    types: [created]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Publish to PyPI
+        run: uv build && uv publish --token ${{ secrets.PYPI_TOKEN }}

hypershell-2.7.1/.github/workflows/tests.yml

@@ -0,0 +1,24 @@
+name: Tests
+on:
+  push:
+    branches: [ master, develop ]
+  pull_request:
+    branches: [ develop ]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [ '3.9', '3.10', '3.11', '3.12', '3.13' ]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Run tests
+        run: uv run --python ${{ matrix.python-version }} pytest -v

{hypershell-2.7.0 → hypershell-2.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypershell
-Version: 2.7.0
+Version: 2.7.1
 Summary: A cross-platform, high-throughput computing utility for processing shell commands over a distributed, asynchronous queue.
 Author-email: Geoffrey Lentner <glentner@purdue.edu>
 License-Expression: Apache-2.0
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Utilities
 Requires-Python: >=3.9
 Requires-Dist: cmdkit[toml]>=2.7.7

{hypershell-2.7.0 → hypershell-2.7.1}/docs/blog/index.rst

@@ -153,6 +153,7 @@ a few quality of life improvements, and a fix for SSH-mode.
     :hidden:
     :maxdepth: 1
 
+    20250504_2_7_0_release
     20250405_2_6_6_release
     20250215_2_6_5_release
     20241231_2_6_1_release

{hypershell-2.7.0 → hypershell-2.7.1}/docs/conf.py

@@ -72,7 +72,7 @@ html_css_files = [
     "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/solid.min.css",
     "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/brands.min.css",
 ]
-html_favicon = '_static/logo.svg'
+html_favicon = '_static/logo-dark-mode.png'
 html_theme_options = {
     # 'announcement': 'See Installation page for not on PyPI package name issue!',
     'sidebar_hide_name': True,

{hypershell-2.7.0 → hypershell-2.7.1}/docs/getting_started.rst

@@ -56,7 +56,7 @@ will manage tasks entirely within memory.
 
     .. code-block:: shell
 
-        seq 4 | hs cluster -t 'echo {}'
+        seq 4 | hsx -t 'echo {}'
 
     .. details:: Output
 
@@ -81,7 +81,7 @@ see additional detail about what is running, where, and when.
 
     .. code-block:: shell
 
-        hs cluster tasks.in -N16 --ssh-group=xyz --capture
+        hsx tasks.in -N16 --ssh-group=xyz --capture
 
     .. details:: Logs
 
@@ -107,7 +107,7 @@ example we stagger the launch process over one minute.
 
     .. code-block:: shell
 
-        hs cluster tasks.in -N128 -b128 --launcher=srun --max-retries=2 --delay-start=-60 >task.out
+        hsx tasks.in -N128 -b128 --launcher=srun --max-retries=2 --delay-start=-60 >task.out
 
     .. details:: Logs
 
@@ -175,7 +175,7 @@ expansion. Many meta-patterns are supported (see full overview of :ref:`template
 
     .. code-block:: shell
 
-        hs cluster tasks.in -N12 -t './some_program.py {} >outputs/{/-}.out'
+        hsx tasks.in -N12 -t './some_program.py {} >outputs/{/-}.out'
 
 Capturing `stdout` and `stderr` is supported directly in fact with the ``--capture`` option.
 See the full documentation for environment variables under :ref:`configuration <config>`.

{hypershell-2.7.0 → hypershell-2.7.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hypershell"
-version = "2.7.0"
+version = "2.7.1"
 description = "A cross-platform, high-throughput computing utility for processing shell commands over a distributed, asynchronous queue."
 readme = "README.rst"
 license = "Apache-2.0"
@@ -25,6 +25,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Operating System :: POSIX :: Linux",
     "Operating System :: MacOS",
     "Operating System :: Microsoft :: Windows",
@@ -54,7 +55,8 @@ dev = [
     "uuid-utils>=0.10.0",
     "pytest>=8.1.1",
     "hypothesis>=6.100.0",
-    "sphinx-autobuild>=2024.2.4"
+    "sphinx-autobuild>=2024.2.4",
+    "pytest-xdist>=3.7.0",
 ]
 docs = [
     "sphinx>=6.0,<8.0",
@@ -81,3 +83,11 @@ hsx = "hypershell:main_x"
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
+
+[tool.pytest.ini_options]
+addopts = ["--strict-markers", ]
+markers = [
+    'unit', # Unit tests are short, interface driven tests on discrete components.",
+    'integration', # Integration tests are often longer and deal with the interaction between systems.",
+    'parameterize', # Placeholder for parameterized tests (not a real type).",
+]

{hypershell-2.7.0 → hypershell-2.7.1}/share/man/man1/hs.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "HS" "1" "May 26, 2025" "2.7.0" "hypershell"
+.TH "HS" "1" "Jun 07, 2025" "2.7.1" "hypershell"
 .SH NAME
 hs \- Process shell commands over a distributed, asynchronous queue
 .SH SYNOPSIS

{hypershell-2.7.0 → hypershell-2.7.1}/share/man/man1/hsx.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "HS" "1" "May 26, 2025" "2.7.0" "hypershell"
+.TH "HS" "1" "Jun 07, 2025" "2.7.1" "hypershell"
 .SH NAME
 hs \- Process shell commands over a distributed, asynchronous queue
 .SH SYNOPSIS

{hypershell-2.7.0 → hypershell-2.7.1}/share/man/man1/hyper-shell.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "HYPER-SHELL" "1" "May 26, 2025" "2.7.0" "hypershell"
+.TH "HYPER-SHELL" "1" "Jun 07, 2025" "2.7.1" "hypershell"
 .SH NAME
 hyper-shell \- Process shell commands over a distributed, asynchronous queue
 .SH SYNOPSIS

{hypershell-2.7.0 → hypershell-2.7.1}/src/hypershell/__init__.py

@@ -3,6 +3,7 @@
 
 """Initialization and entry-point for console application."""
 
+
 # Type annotations
 from __future__ import annotations
 from typing import List
@@ -31,7 +32,12 @@ from hypershell.config import ConfigApp
 from hypershell.data import InitDBApp
 
 # Public interface
-__all__ = ['HyperShellApp', 'main', '__version__']
+__all__ = [
+    'HyperShellApp', 'main', '__version__', '__citation__',
+    'APP_VERSION', 'APP_USAGE', 'APP_HELP',
+    'SubmitApp', 'ServerApp', 'ClientApp', 'InitDBApp', 'ConfigApp',
+    'TaskGroupApp', 'TaskInfoApp', 'TaskWaitApp', 'TaskRunApp', 'TaskSearchApp', 'TaskUpdateApp',
+]
 
 # project metadata
 __version__     = get_version('hypershell')

{hypershell-2.7.0 → hypershell-2.7.1}/src/hypershell/config.py

@@ -6,7 +6,7 @@
 
 # Type annotations
 from __future__ import annotations
-from typing import Any
+from typing import Any, Final
 
 # Standard libs
 import os
@@ -386,16 +386,16 @@ class ConfigWhichApp(Application):
 
 
 if os.name == 'nt':
-    CONFIG_PATH_INFO = f"""\
+    CONFIG_PATH_INFO: Final[str] = f"""\
   --system         %ProgramData%\\HyperShell\\Config.toml
   --user           %AppData%\\HyperShell\\Config.toml
-  --local          {path.local.config}
+  --local          {path.local.config}\
 """
 else:
-    CONFIG_PATH_INFO = f"""\
+    CONFIG_PATH_INFO: Final[str] = f"""\
   --system         /etc/hypershell.toml
   --user           ~/.hypershell/config.toml
-  --local          {path.local.config}
+  --local          {path.local.config}\
 """
 
 

{hypershell-2.7.0 → hypershell-2.7.1}/src/hypershell/data/__init__.py

@@ -258,7 +258,7 @@ class InitDBApp(Application):
             raise ArgumentError('Can only rotate SQLite')
         if self.backup_path and os.path.exists(self.backup_path):
             raise RuntimeError(f'Backup path already exists ({self.backup_path})')
-        if not sys.stdout.isatty():
+        if not sys.stdout.isatty() and not self.auto_confirm:
             raise RuntimeError('Non-interactive prompt cannot confirm (see --yes).')
 
     def confirm_action(self: InitDBApp, message: str) -> bool:

{hypershell-2.7.0 → hypershell-2.7.1}/src/hypershell/submit.py

@@ -766,9 +766,8 @@ class SubmitApp(Application):
     source: IO | List[str] | None = None
     task_args: List[str] = []
     task_file: str = None
-    input_interface = interface.add_mutually_exclusive_group()
-    input_interface.add_argument('task_args', nargs='*')
-    input_interface.add_argument('-f', '--task-file', default=task_file)
+    interface.add_argument('task_args', nargs='*')
+    interface.add_argument('-f', '--task-file', default=task_file)
 
     bundlesize: int = config.submit.bundlesize
     interface.add_argument('-b', '--bundlesize', type=int, default=bundlesize)
@@ -784,7 +783,7 @@ class SubmitApp(Application):
 
     tags: Dict[str, JSONValue] = {}
     taglist: List[str] = None
-    interface.add_argument('-t', '--tag', nargs='*', default=[], dest='taglist')
+    interface.add_argument('-t', '--tag', nargs='+', default=[], dest='taglist')
 
     exceptions = {
         **get_shared_exception_mapping(__name__)
@@ -833,6 +832,8 @@ class SubmitApp(Application):
 
     def check_source(self: SubmitApp) -> None:
         """Determine task submission mode."""
+        if self.task_args and self.task_file:
+            raise ArgumentError(f'Cannot specify both -f/--task-file and positional arguments')
         if self.task_file == '-':
             log.debug(f'Submitted from <stdin> (explicit)')
             self.source = sys.stdin

{hypershell-2.7.0 → hypershell-2.7.1}/src/hypershell/task.py

@@ -1,7 +1,7 @@
 # SPDX-FileCopyrightText: 2025 Geoffrey Lentner
 # SPDX-License-Identifier: Apache-2.0
 
-"""Task based operations."""
+"""Task-based operations."""
 
 
 # Type annotations
@@ -85,7 +85,7 @@ class TaskSubmitApp(Application):
 
     tags: Dict[str, JSONValue] = {}
     taglist: List[str] = []
-    interface.add_argument('-t', '--tag', nargs='*', dest='taglist')
+    interface.add_argument('-t', '--tag', nargs='+', dest='taglist')
 
     exceptions = {
         **get_shared_exception_mapping(__name__)
@@ -382,7 +382,7 @@ class TaskRunApp(Application):
     interface.add_argument('-n', '--interval', type=int, default=interval)
 
     taglist: List[str] = []
-    interface.add_argument('-t', '--tag', nargs='*', dest='taglist')
+    interface.add_argument('-t', '--tag', nargs='+', dest='taglist')
 
     exceptions = {
         **get_shared_exception_mapping(__name__)
@@ -549,10 +549,10 @@ class TaskSearchApp(Application, SearchableMixin):
     interface.add_argument('field_names', nargs='*', default=field_names)
 
     where_clauses: List[str] = None
-    interface.add_argument('-w', '--where', nargs='*', default=[], dest='where_clauses')
+    interface.add_argument('-w', '--where', nargs='+', default=[], dest='where_clauses')
 
     taglist: List[str] = None
-    interface.add_argument('-t', '--with-tag', nargs='*', default=[], dest='taglist')
+    interface.add_argument('-t', '--with-tag', nargs='+', default=[], dest='taglist')
 
     order_by: str = None
     order_desc: bool = False
@@ -815,10 +815,10 @@ class TaskUpdateApp(Application, SearchableMixin):
     field_names: List[str] = []
 
     where_clauses: List[str] = None
-    interface.add_argument('-w', '--where', nargs='*', default=[], dest='where_clauses')
+    interface.add_argument('-w', '--where', nargs='+', default=[], dest='where_clauses')
 
     taglist: List[str] = None
-    interface.add_argument('-t', '--with-tag', nargs='*', default=[], dest='taglist')
+    interface.add_argument('-t', '--with-tag', nargs='+', default=[], dest='taglist')
 
     order_by: str = None
     order_desc: bool = False
@@ -847,7 +847,7 @@ class TaskUpdateApp(Application, SearchableMixin):
     action_interface.add_argument('--delete', action='store_true', dest='delete_mode')
 
     remove_tag: List[str] = None
-    interface.add_argument('--remove-tag', nargs='*')
+    interface.add_argument('--remove-tag', nargs='+')
 
     no_confirm: bool = False
     interface.add_argument('-f', '--no-confirm', action='store_true')

hypershell-2.7.1/tests/__init__.py

@@ -0,0 +1,75 @@
+# SPDX-FileCopyrightText: 2025 Geoffrey Lentner
+# SPDX-License-Identifier: Apache-2.0
+
+"""Automated tests for HyperShell."""
+
+
+# Type annotations
+from __future__ import annotations
+from typing import Final, List, Tuple, Dict, Any
+
+# Standard libs
+import os
+import re
+from pathlib import Path
+from subprocess import run, PIPE
+
+# Public interface
+__all__ = ['NO_OUTPUT', 'main', 'main_lines', 'assert_output',
+           'create_taskfile', 'create_taskfile_echo',
+           'UUID_PATTERN']
+
+
+# Flag for empty output from `main_lines` function
+NO_OUTPUT: Final[List[str]] = ['', ]
+
+
+def main(argv: List[str]) -> Tuple[int, str, str]:
+    """Return stdout, stderr, and exit code of command-line interface."""
+    proc = run(argv, stdout=PIPE, stderr=PIPE, env=os.environ)
+    return (
+        proc.returncode,
+        proc.stdout.decode('utf-8').strip(),
+        proc.stderr.decode('utf-8').strip()
+    )
+
+
+def main_lines(argv: List[str]) -> Tuple[int, List[str], List[str]]:
+    """Return stdout, stderr, and exit code of command-line interface with output as List[str]."""
+    rc, stdout, stderr = main(argv)
+    return (
+        rc,
+        [line.strip() for line in stdout.split('\n')],
+        [line.strip() for line in stderr.split('\n')]
+    )
+
+
+def assert_output(pattern: str, output: str, count: int = 1, groups: Dict[str, str | re.Pattern] = None) -> None:
+    """Assert some count of lines in output match pattern, optionally with capture groups pattern matching."""
+    n = 0
+    for line in output.strip().splitlines():
+        if match := re.search(pattern, line):
+            n += 1
+            for key, value in (groups or {}).items():
+                assert re.match(value, match.group(key))
+    assert n == count
+
+
+def create_taskfile(temp_site: Path, lines: List[str]) -> Path:
+    """Produce task input file for test, return path."""
+    taskfile = temp_site / 'task.in'
+    with open(taskfile, mode='w', encoding='utf-8') as stream:
+        for line in lines:
+            print(line, file=stream)
+    return taskfile
+
+
+def create_taskfile_echo(temp_site: Path, count: int, tags: Dict[str, Any] = None) -> Path:
+    """Produce task input file with 'echo {}' lines, return path."""
+    tagline = ' '.join([f'{k}:{v}' for k, v in (tags or {}).items()])
+    return create_taskfile(temp_site, lines=[f'echo {n}  # HYPERSHELL: {tagline} n:{n}' for n in range(count)])
+
+
+UUID_PATTERN: re.Pattern = re.compile(
+    r'^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$'
+)

hypershell-2.7.1/tests/conftest.py

@@ -0,0 +1,27 @@
+# SPDX-FileCopyrightText: 2025 Geoffrey Lentner
+# SPDX-License-Identifier: Apache-2.0
+
+"""Fixtures for testing."""
+
+
+# Standard libs
+import os
+
+# External libs
+from pytest import fixture
+from pathlib import Path
+
+
+@fixture(scope="function")
+def temp_site(tmpdir_factory) -> Path:
+    """Setup empty site and database path."""
+    for name in os.environ:
+        if name.startswith('HYPERSHELL_'):
+            os.environ.pop(name)
+    site = tmpdir_factory.mktemp('data')
+    db_path = site.join('local.db')
+    os.environ['HYPERSHELL_CONFIG_FILE'] = ''
+    os.environ['HYPERSHELL_SITE'] = str(site)
+    os.environ['HYPERSHELL_DATABASE_FILE'] = str(db_path)
+    os.environ['HYPERSHELL_LOGGING_LEVEL'] = 'DEBUG'
+    return site

hypershell-2.7.1/tests/test_cluster.py

@@ -0,0 +1,184 @@
+# SPDX-FileCopyrightText: 2025 Geoffrey Lentner
+# SPDX-License-Identifier: Apache-2.0
+
+"""Test cluster operations."""
+
+
+# Type annotations
+from __future__ import annotations
+from typing import Final, Dict
+
+# Standard libs
+from pathlib import Path
+
+# External libs
+from pytest import mark
+from cmdkit.app import exit_status
+
+# Internal libs
+from tests import main, main_lines, NO_OUTPUT, create_taskfile_echo, assert_output
+from hypershell.cluster import ClusterApp
+
+
+@mark.integration
+def test_cluster_usage() -> None:
+    """The 'hs cluster' command prints usage statement without arguments."""
+    rc, stdout, stderr = main(['hs', 'cluster', ])
+    assert rc == exit_status.usage
+    assert stdout == ClusterApp.interface.usage_text
+    assert stderr == ''
+
+
+@mark.integration
+def test_cluster_usage_hsx() -> None:
+    """The 'hsx' command prints usage statement without arguments."""
+    rc, stdout, stderr = main(['hsx', ])
+    assert rc == exit_status.usage
+    assert stdout == ClusterApp.interface.usage_text
+    assert stderr == ''
+
+
+@mark.integration
+@mark.parametrize('opt', ['-h', '--help'])
+def test_cluster_help(opt: str) -> None:
+    """The 'hs cluster' command prints help statement with -h, --help option."""
+    rc, stdout, stderr = main(['hs', 'cluster', opt, ])
+    assert rc == exit_status.success
+    assert stdout == ClusterApp.interface.help_text
+    assert stderr == ''
+
+
+@mark.integration
+@mark.parametrize('opt', ['-h', '--help'])
+def test_cluster_help_hsx(opt: str) -> None:
+    """The 'hsx' command prints help statement with -h, --help option."""
+    rc, stdout, stderr = main(['hsx', opt, ])
+    assert rc == exit_status.success
+    assert stdout == ClusterApp.interface.help_text
+    assert stderr == ''
+
+
+@mark.integration
+def test_cluster_mixed_modes() -> None:
+    """Cannot use multiple start methods."""
+    assert main_lines(['hs', 'cluster', '--forever', '--restart']) == (
+        exit_status.bad_argument, NO_OUTPUT, [
+            'CRITICAL [hypershell] Using --forever with --restart is invalid',
+        ]
+    )
+
+
+@mark.integration
+@mark.parametrize('opt', ['--foo', '--bar', '--baz=7'])
+def test_cluster_bad_options(opt: str) -> None:
+    """Error on invalid options."""
+    assert main_lines(['hs', 'cluster', opt]) == (
+        exit_status.bad_argument, NO_OUTPUT, [
+            f'CRITICAL [hypershell] unrecognized arguments: {opt}',
+        ]
+    )
+
+
+@mark.integration
+def test_cluster_missing_file(temp_site: Path) -> None:
+    """Error on missing file."""
+    missing_file = str(temp_site / 'missing_file.txt')
+    rc, stdout, stderr = main(['hs', 'cluster', missing_file])
+    assert rc == exit_status.runtime_error
+    assert stdout == ''
+    assert_output(r'CRITICAL .* FileNotFoundError: .* No such file .*', stderr, 1)
+
+
+@mark.integration
+def test_cluster_multiple_arguments() -> None:
+    """Error on multiple positional arguments."""
+    assert main_lines(['hs', 'cluster', 'file_a', 'file_b']) == (
+        exit_status.bad_argument, NO_OUTPUT, [
+            f'CRITICAL [hypershell] unrecognized arguments: file_b',
+        ]
+    )
+
+
+OPTION_PAIR: Final[Dict[str, str]] = {
+    '-N': '-N/--num-tasks', '--num-tasks': '-N/--num-tasks',
+    '-t': '-t/--template', '--template': '-t/--template',
+    '-p': '-p/--port', '--port': '-p/--port',
+    '-b': '-b/--bundlesize', '--bundlesize': '-b/--bundlesize',
+    '-w': '-w/--bundlewait', '--bundlewait': '-w/--bundlewait',
+    '-r': '-r/--max-retries', '--max-retries': '-r/--max-retries',
+    '-o': '-o/--output', '--output': '-o/--output',
+    '-e': '-e/--errors', '--errors': '-e/--errors',
+    '-f': '-f/--failures', '--failures': '-f/--failures',
+    '--ssh-args': '--ssh-args', '--ssh-group': '--ssh-group',
+    '--remote-exe': '--remote-exe',
+    '-d': '-d/--delay-start', '--delay-start': '-d/--delay-start',
+    '-T': '-T/--timeout', '--timeout': '-T/--timeout',
+    '-W': '-W/--task-timeout', '--task-timeout': '-W/--task-timeout',
+    '-S': '-S/--signalwait', '--signalwait': '-S/--signalwait',
+    '-F': '-F/--factor', '--factor': '-F/--factor',
+    '-P': '-P/--period', '--period': '-P/--period',
+    '-I': '-I/--init-size', '--init-size': '-I/--init-size',
+    '-X': '-X/--min-size', '--min-size': '-X/--min-size',
+    '-Y': '-Y/--max-size', '--max-size': '-Y/--max-size',
+}
+
+
+@mark.integration
+@mark.parametrize('opt', list(OPTION_PAIR))
+def test_cluster_missing_option_value(opt: str) -> None:
+    """Error on missing option value."""
+    assert main_lines(['hs', 'cluster', '-', opt]) == (
+        exit_status.bad_argument, NO_OUTPUT, [
+            f'CRITICAL [hypershell] argument {OPTION_PAIR[opt]}: expected one argument',
+        ]
+    )
+
+
+@mark.integration
+def test_cluster_basic(temp_site: Path) -> None:
+    """Run small collection of tasks without database."""
+    taskfile = create_taskfile_echo(temp_site, count=4)
+    rc, stdout, stderr = main(['hs', 'cluster', taskfile, '--no-db', '--no-confirm'])
+    assert rc == exit_status.success
+    assert stdout == '\n'.join(map(str, range(4)))
+    assert_output(r'Registered client', stderr, 1)
+    assert_output(r'INFO \[hypershell.client\] Running task', stderr, 4)
+    assert_output(r'DEBUG \[hypershell.client\] Running task', stderr, 4)
+    assert_output(r'\[hypershell.server\] Completed task', stderr, 4)
+    assert_output(r'\[hypershell.client\] Completed task', stderr, 4)
+
+
+@mark.integration
+def test_cluster_database(temp_site: Path) -> None:
+    """Run small collection of tasks from file to database."""
+
+    # Start out with an empty database
+    assert main_lines(['hs', 'list', '--count']) == (
+        exit_status.success, ['0', ], NO_OUTPUT
+    )
+
+    # Run with `seq 4` inputs
+    taskfile = create_taskfile_echo(temp_site, count=4)
+    rc, stdout, stderr = main(['hs', 'cluster', taskfile])
+    assert rc == exit_status.success
+    assert stdout == '\n'.join(map(str, range(4)))
+    assert_output(r'Registered client', stderr, 1)
+    assert_output(r'INFO \[hypershell.client\] Running task', stderr, 4)
+    assert_output(r'DEBUG \[hypershell.client\] Running task', stderr, 4)
+    assert_output(r'\[hypershell.server\] Completed task', stderr, 4)
+    assert_output(r'\[hypershell.client\] Completed task', stderr, 4)
+
+    # Now there are 4 tasks in the database
+    assert main_lines(['hs', 'list', '--count']) == (
+        exit_status.success, ['4', ], NO_OUTPUT
+    )
+
+    # Confirm arguments
+    assert main_lines(['hs', 'list', 'args', '-f', 'plain', '-s', 'submit_time']) == (
+        exit_status.success, ['echo 0', 'echo 1', 'echo 2', 'echo 3'], NO_OUTPUT
+    )
+
+    # Confirm status
+    assert main_lines(['hs', 'list', 'exit_status', '-f', 'plain', '-s', 'submit_time']) == (
+        exit_status.success, ['0'] * 4, NO_OUTPUT
+    )