Files
daedalus/CHANGELOG.md
T
nvaldez c210e17661 daedalus 0.3.0: argparse CLI + argcomplete shell completion, script-arg delegation
- cli.py rewritten on argparse (build_parser, REMAINDER pass-through: everything
  after the script name still belongs to the script); help/errors are
  argparse-rendered, exit code 2 kept for all daedalus errors
- completions.py (new): category-aware candidates for argcomplete - script names
  + unused labels narrowed by typed labels (daedalus test h<TAB> -> hello);
  --path completes scripts; after a completed script name daedalus offers
  nothing of its own and delegates .py scripts to their own parser via the
  run_python_script child with a rewritten COMP_LINE (daedalus hello -<TAB> ->
  hello's -h --help); SPEC 6.9 documents the autocomplete(parser) opt-in
- SPEC: item 1.5 reuse-first third-party policy, 3.8/3.10/3.11 argparse texts,
  3.13 completion catalog, 6.9 script opt-in, 9.6 argcomplete dependency
- argcomplete>=3.3 as runtime dep (guarded import: CLI runs without it);
  register-python-argcomplete line for ~/.bashrc; PYTHON_ARGCOMPLETE_OK marker
  in bin/daedalus; README/INSTALL/CHANGELOG updated; hello opts in
- tests: argparse CLI suites, completer units, end-to-end argcomplete probes
  through the bash fd-8 protocol and the delegation exec chain (autotest green,
  coverage 97%)

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-11-18 22:09:04 +01:00

3.1 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.3.0] - 2026-11-18

Added in 0.3.0

  • Shell completion via argcomplete (new dependency): daedalus hel<TAB> completes hello, category labels complete together with the scripts they filter (daedalus test h<TAB>), options complete after -, and --path <name> completes script names. Activate with eval "$(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 with argcomplete.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/--help prints 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 (category test) 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 (default general), daedalus <category> listing (AND when several) and daedalus <category>… <name> runs; script names and category labels never collide.
  • New listing format: Daedalus Version: line, script / type / categories table, descriptions wrapped to the terminal width and indented, colors via NO_COLOR / FORCE_COLOR.
  • daedalus/run_python_script.py: .py scripts run through a child entry that sets up sys.path, logging, sys.argv, and exit codes.
  • daedalus.daedalus_logging: file logging to ~/.daedalus/debug.log plus a colored stderr console handler (DAEDALUS_LOGLEVEL, DAEDALUS_NO_LOGGING).
  • Library imports: shared code imports as daedalus.<folder>; the checkout registers python/src/<folder> as packages on import and the child gets REPO_ROOT on PYTHONPATH.
  • Exact error messages for every usage failure, with close matches after a category prefix.

Changed in 0.1.0

  • SPEC.md rewritten 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.