--list flag

[brandonkal]

It would be useful if mask --list printing a list of available commands.

[jacobdeichert]

mask --help does this... unless you mean you want an output that shows ALL commands in the tree?

[brandonkal]

Oops.

[brandonkal]

@jakedeichert I've got things installed now and see that mask --help generates a traditional help screen.

The idea with --list is to return a newline separated list of available subcommands for things like bash completion and feeding into fzf.

As an example use case, mask could be well suited to produce an output selection similar to the pet exec experience.

[jacobdeichert]

Regarding bash/zsh/fish completion, there was some discussion in #18. I'm waiting for clap v3 to release and will reconsider if shell completion generation should be built into mask.

Exposing a --list arg I'm unsure about. Just dumping all cmds as rows to stdout is not really following any standard format and though it may work for some tools, it won't be powerful enough for others. Especially if argument options aren't dumped with the cmds...

Instead of mask dumping an unorganized list of everything... it should be easy for people to parse the maskfile for cmd headings with a simple bash(insert lang here) script. It just needs to find lines with headings # and count the depth... very simple.

[brandonkal]

Yes. It is a bit annoying that clap sorts subcommands rather than allowing it to be the order in the markdown file.

[jacobdeichert]

Instead of mask dumping an unorganized list of everything... it should be easy for people to parse the maskfile for cmd headings with a simple bash(insert lang here) script. It just needs to find lines with headings # and count the depth... very simple.

Closing in favour of this recommendation I gave instead of building this into mask.