Shell completions

[Freed-Wu]

Is your feature request related to a problem? Please describe. Add shell completions for huggingface-cli

Describe the solution you'd like https://docs.iterative.ai/shtab Describe alternatives you've considered https://docs.iterative.ai/shtab/#alternatives

[Wauplin]

Hi @Freed-Wu, thanks for the idea. Seems a good suggestion to facilitate user experience. However I don't have experience in it. Would you mind implementing a POC to show how this would integrate with huggingface-cli and make a PR for it ?

Something we should keep it mind is that installing shtab (or argcomplete) should be optional for our users. So I would add the dependency to the "cli" group in setup.py.

Side question: is this something that would integrate well with Windows cmd ?

[Freed-Wu]

should be optional for our users

• https://github.com/andreafrancia/trash-cli/blob/master/setup.cfg#L31-L33
• https://github.com/inducer/pudb/blob/main/setup.py#L28
• https://github.com/piccolomo/plotext/blob/master/setup.py#L25
• https://github.com/wookayin/gpustat/blob/master/setup.py#L114

is this something that would integrate well with Windows cmd

• cmd don't support customization of completion.
• Now shtab only support bash/zsh/tcsh, and will support fish/powershell in roadmap.

[Freed-Wu]

I would add the dependency to the "cli" group in setup.py.

Why not completion to keep same as these examples?

[Wauplin]

Why not completion to keep same as these examples?

Fine with completion ! :)

And thanks for clarification on supported shells.

[Freed-Wu]

Fine with completion ! :)

OK. I've give a PR with 'completion'

And thanks for clarification on supported shells.

You're welcome.

[remyleone]

Using Click might be helpful here: https://click.palletsprojects.com/en/8.1.x/shell-completion/

[Wauplin]

Using Click might be helpful here: https://click.palletsprojects.com/en/8.1.x/shell-completion/

As a matter of fact, yes we are (re-)considering the idea of using click (or Typer). However this would mean adding a (quite big) dependency to the project which we'd like to avoid -since CLI is only an "option" for huggingface_hub, not everyone uses it-. There are also suggestions from @Freed-Wu about how to implement shell completion with the current setup (see https://github.com/huggingface/huggingface_hub/pull/1207#issuecomment-1779536093). We are trying to see which direction we want to take and (hopefully) will get back here once decided. For the context, the CLI has not been our focus until now but this is changing, especially since we release huggingface-cli upload and huggingface-cli download support.