video_helper.cli_click module
Video Helper — click-based command-line interface.
Twin of video_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 video-helper-click entry point in pyproject.toml.
Design notes
Subcommands mirror
video-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
>>> # video-helper-click validate --input clip.mp4
>>> # video-helper-click dimensions --input clip.mp4
>>> # video-helper-click convert --input in.mov --output out.mp4 --width 640 --height 480
>>> # video-helper-click chunk --input in.mp4 --start 10 --end 20 --output cut.mp4
>>> # video-helper-click extract-frames --input clip.mp4 --output-dir frames/ --frame-step 5