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>
4.0 KiB
4.0 KiB
Changelog
Notable changes are listed here. Release numbers match
pyproject.toml. Newest entries are first.
Format follows Keep a Changelog and Semantic Versioning.
[Unreleased]
- Nothing yet.
[0.4.0] - 2026-11-18
Added in 0.4.0
bash/daedalus_common.sh: the shared interface for bash scripts (SPEC item 6.10) — a script sources its sibling helper, defineshelp()(usage) andmain(), and ends withdaedalus_bash_dispatch "$@", which routeshelp/-h/--helptohelp()and everything else tomain()unchanged.- Bash script completion (SPEC item 3.13.5.2):
daedalus <name> <TAB>completes--help,-h, andhelpfor scripts implementing the interface; no script runs on TAB. Scripts without the interface get the shell default. bash/hello_bash.sh: sample bash script (categorytest) through the shared interface, the bash twin ofhello, with tests.bash/tests/: the interface tests — helper behavior through a sample script and enforcement of the interface for every registered.shscript.
[0.3.0] - 2026-11-18
Added in 0.3.0
- Shell completion via argcomplete
(new dependency):
daedalus hel<TAB>completeshello, category labels complete together with the scripts they filter (daedalus test h<TAB>), options complete after-, and--path <name>completes script names. Activate witheval "$(register-python-argcomplete daedalus)"(INSTALL.md). - Script arguments complete from the script's own parser (SPEC item
3.13.5.1): once the script name is typed, daedalus delegates the rest
of the line to the script —
daedalus hello -<TAB>offers hello's-h/--help, never daedalus's options. A Python script opts in withargcomplete.autocomplete(parser)(SPEC item 6.9). daedalus/completions.py: the candidate functions argcomplete calls.
Changed in 0.3.0
- The CLI argument handling now uses
argparse(daedalus.cli.build_parser):-h/--helpprints the argparse rendering, and parser-level errors keep the argparse messages (exit code 2 stays). Options are parsed anywhere before the script words; everything after the script name still goes to the script (SPEC item 3.1 unchanged). - SPEC item 1.5 policy: reuse a popular, tested, trusted third-party package when it exists instead of writing our own; argcomplete is the first such dependency (SPEC item 9.6).
[0.2.0] - 2026-11-18
Added in 0.2.0
hello: sample Python script (categorytest) that prints a hello line and the daedalus version; first registered script, with tests and an installed package entry (daedalus.hello).
[0.1.0] - 2026-11-18
Added in 0.1.0
- Categories:
Script.categories(defaultgeneral),daedalus <category>listing (AND when several) anddaedalus <category>… <name>runs; script names and category labels never collide. - New listing format:
Daedalus Version:line,script/type/categoriestable, descriptions wrapped to the terminal width and indented, colors viaNO_COLOR/FORCE_COLOR. daedalus/run_python_script.py:.pyscripts run through a child entry that sets upsys.path, logging,sys.argv, and exit codes.daedalus.daedalus_logging: file logging to~/.daedalus/debug.logplus a colored stderr console handler (DAEDALUS_LOGLEVEL,DAEDALUS_NO_LOGGING).- Library imports: shared code imports as
daedalus.<folder>; the checkout registerspython/src/<folder>as packages on import and the child getsREPO_ROOTonPYTHONPATH. - Exact error messages for every usage failure, with close matches after a category prefix.
Changed in 0.1.0
SPEC.mdrewritten with stable item numbers (SPEC item 3.7.1), in lockstep with the upstream scriptman specification.
[0.0.0] - 2026-11-11
Added in 0.0.0
- Empty template: CLI, CI, packaging, and script-integration guide with no registered scripts.