audio_helper.cli_click module
Audio Helper — click-based command-line interface.
Twin of audio_helper.cli_argparse: same public surface (identical
subcommand names, identical flag semantics), but implemented with
click so users who already have a click-native shell setup
(bash / zsh completion via click.shell_completion, colored –help,
nested command groups) can plug it in without friction. Installed as
the audio-helper-click entry point in pyproject.toml.
Design notes
Subcommands mirror
audio-helper(the argparse twin) so both CLIs can be introspected identically by higher layers (FastAPI, MCP).Flags reuse the argparse names (
--input/--output/ …) rather than the more idiomatic click positional style — consistency across the two CLIs beats micro-idiomaticity here.Errors from the library propagate unchanged; click handles the formatting.
Usage Example
>>> # audio-helper-click convert --input in.mp3 --output out.wav --freq 44100
>>> # audio-helper-click duration --input in.mp3
>>> # audio-helper-click split --input in.mp3 --output-dir chunks/ --seconds 30
>>> # audio-helper-click resemblance --a a.mp3 --b b.mp3