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>
36 lines
899 B
Bash
36 lines
899 B
Bash
#!/usr/bin/env bash
|
|
# Shared interface for daedalus bash scripts (SPEC.md item 6.10).
|
|
#
|
|
# A registered bash script sources this sibling file once and ends with:
|
|
# daedalus_bash_dispatch "$@"
|
|
# The script defines help() (its usage text) and main() (its body).
|
|
# daedalus completes the help words for the script (SPEC item 3.13.5.2);
|
|
# this helper runs them: help, -h, and --help print help(), everything
|
|
# else goes to main() with the arguments unchanged.
|
|
|
|
help() {
|
|
echo "bash script error: help() is not defined (SPEC item 6.10.2)" >&2
|
|
return 2
|
|
}
|
|
|
|
main() {
|
|
echo "bash script error: main() is not defined (SPEC item 6.10.3)" >&2
|
|
return 2
|
|
}
|
|
|
|
daedalus_is_help_request() {
|
|
case "${1-}" in
|
|
help|-h|--help) return 0 ;;
|
|
*) return 1 ;;
|
|
esac
|
|
}
|
|
|
|
daedalus_bash_dispatch() {
|
|
if daedalus_is_help_request "${1:-}"; then
|
|
help
|
|
local status=$?
|
|
exit "$status"
|
|
fi
|
|
main "$@"
|
|
}
|