bucket_helper.cli_click module
Bucket Helper — click-based command-line interface.
Twin of bucket_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 bucket-helper-click entry point in pyproject.toml.
Design notes
Subcommands mirror
bucket-helper(the argparse twin) so both CLIs can be introspected identically by higher layers (FastAPI, MCP).Flags reuse the argparse names (
--input/--key/ …) 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
>>> # bucket-helper-click upload --config s3_config.json --input local.txt --key folder/uploaded.txt
>>> # bucket-helper-click download --config s3_config.json --key folder/uploaded.txt --output local.txt
>>> # bucket-helper-click list --config s3_config.json --prefix folder/
>>> # bucket-helper-click tempfile --config s3_config.json --ext json --prefix runs