ec9848b169
- bash/daedalus_common.sh (new): the shared interface for bash scripts (SPEC item 6.10) - a script sources its sibling helper, defines help() (usage) and main(), and ends with daedalus_bash_dispatch "$@" which routes help/-h/--help to help() and everything else to main() unchanged (clear fallback errors when a script forgets either) - completion for bash scripts (SPEC item 3.13.5.2): after a completed script name daedalus offers --help, -h, help, prefix-filtered, written itself on the fd-8 argcomplete protocol - no script runs on TAB; scripts without the interface get the shell default - bash/hello_bash.sh (new, category test): sample script through the interface, the bash twin of hello, with tests; registry entry, README row, CHANGELOG bullet - tests: bash/tests/test_bash_interface.py (helper behavior, bash -n, enforcement of the interface for every registered .sh), test_hello_bash.py (direct and daedalus runs, help routing, SPEC 3.1 pass-through, completion probes including the user's daedalus hello_bash<TAB><TAB> case), completions units + e2e harness - README/INSTALL/SPEC updated (6.10, 3.13.5.2, tree, boilerplate with shellcheck directive); autotest green (212 tests) Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
103 lines
3.9 KiB
Python
103 lines
3.9 KiB
Python
"""Tests for hello_bash: the shared bash interface end to end (SPEC item 6.10).
|
|
|
|
Direct runs, daedalus runs, help routing, and the completion of the help
|
|
words after the script name (SPEC item 3.13.5.2).
|
|
"""
|
|
import os
|
|
import shlex
|
|
import subprocess
|
|
import sys
|
|
|
|
import pytest
|
|
|
|
from daedalus import REPO_ROOT
|
|
from daedalus import registry
|
|
|
|
SCRIPT = registry.SCRIPTS["hello_bash"].absolute_path
|
|
|
|
|
|
def run_script(*args):
|
|
"""Run the script directly with bash."""
|
|
return subprocess.run(["bash", str(SCRIPT), *args], capture_output=True,
|
|
text=True, check=False)
|
|
|
|
|
|
def run_daedalus(*args):
|
|
"""Run python -m daedalus from the checkout, like the installed CLI."""
|
|
env = {**os.environ, "PYTHONPATH": str(REPO_ROOT)}
|
|
return subprocess.run([sys.executable, "-m", "daedalus", *args],
|
|
capture_output=True, text=True, check=False,
|
|
cwd=REPO_ROOT.parent, env=env)
|
|
|
|
|
|
def test_main_defaults_to_world():
|
|
"""No arguments: one hello line for the default name."""
|
|
result = run_script()
|
|
assert result.returncode == 0
|
|
assert result.stdout == "hello, world (from daedalus bash)\n"
|
|
|
|
|
|
def test_main_prints_one_line_per_name():
|
|
"""Every name gets its hello line, arguments unchanged."""
|
|
result = run_script("me", "you too")
|
|
assert result.returncode == 0
|
|
assert result.stdout == ("hello, me (from daedalus bash)\n"
|
|
"hello, you too (from daedalus bash)\n")
|
|
|
|
|
|
@pytest.mark.parametrize("word", ["help", "-h", "--help"])
|
|
def test_help_words_print_the_usage(word):
|
|
"""The help words route to hello_bash's help() (SPEC item 6.10.4)."""
|
|
result = run_script(word)
|
|
assert result.returncode == 0
|
|
assert result.stdout.startswith("usage: hello_bash [name...]")
|
|
assert "Prints a hello line" in result.stdout
|
|
|
|
|
|
def test_daedalus_runs_it():
|
|
"""daedalus hello_bash runs through the bash runner (SPEC item 5.3)."""
|
|
result = run_daedalus("hello_bash", "pi")
|
|
assert result.returncode == 0, result.stderr
|
|
assert result.stdout == "hello, pi (from daedalus bash)\n"
|
|
|
|
|
|
def test_daedalus_category_prefix_runs_it():
|
|
"""daedalus test hello_bash runs it through the category prefix."""
|
|
result = run_daedalus("test", "hello_bash")
|
|
assert result.returncode == 0, result.stderr
|
|
assert result.stdout == "hello, world (from daedalus bash)\n"
|
|
|
|
|
|
def test_daedalus_help_word_passes_through():
|
|
"""daedalus hello_bash --help shows the script's help, not daedalus's (SPEC item 3.1)."""
|
|
result = run_daedalus("hello_bash", "--help")
|
|
assert result.returncode == 0, result.stderr
|
|
assert result.stdout.startswith("usage: hello_bash [name...]")
|
|
|
|
|
|
def _probe(comp_line):
|
|
"""Replay the argcomplete hook and return the candidates (fd 8)."""
|
|
env = {**os.environ, "_ARGCOMPLETE": "1", "COMP_LINE": comp_line,
|
|
"COMP_POINT": str(len(comp_line)), "_ARGCOMPLETE_IFS": "\n",
|
|
"_ARGCOMPLETE_SHELL": "bash", "PYTHONPATH": str(REPO_ROOT),
|
|
"NO_COLOR": "1"}
|
|
command = (f"exec 8>&1; exec 1>/dev/null; exec 2>/dev/null; "
|
|
f"{shlex.quote(sys.executable)} -m daedalus")
|
|
result = subprocess.run(["bash", "-c", command], env=env, cwd=REPO_ROOT,
|
|
capture_output=True, text=True, check=False)
|
|
return [line.strip() for line in result.stdout.splitlines() if line.strip()]
|
|
|
|
|
|
@pytest.mark.skipif(os.name == "nt", reason="bash completion harness")
|
|
def test_completion_offers_the_script_name():
|
|
"""daedalus hello_ba<TAB> completes hello_bash."""
|
|
assert _probe("daedalus hello_ba") == ["hello_bash"]
|
|
|
|
|
|
@pytest.mark.skipif(os.name == "nt", reason="bash completion harness")
|
|
def test_completion_offers_the_help_words():
|
|
"""After the script name: only the help words (SPEC item 3.13.5.2)."""
|
|
assert _probe("daedalus hello_bash ") == ["--help", "-h", "help"]
|
|
assert _probe("daedalus hello_bash --") == ["--help"]
|
|
assert _probe("daedalus test hello_bash ") == ["--help", "-h", "help"]
|