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

83 lines
3.1 KiB
Markdown

# Changelog
Notable changes are listed here. Release numbers match
[`pyproject.toml`](./pyproject.toml). Newest entries are first.
Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
- Nothing yet.
## [0.3.0] - 2026-11-18
### Added in 0.3.0
- Shell completion via [argcomplete](https://github.com/kislyuk/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.