just icon indicating copy to clipboard operation
just copied to clipboard

Group options and arguments by topic

Open john-cd opened this issue 10 months ago • 5 comments

[nitpick] too many commands

  1. Group options by topic when running just --help from the command line
  2. Same thing with commands

a) recipe listing / selection --choose --list --groups --summary

b) justfile formatting / checking --fmt --check

c) justfile management --init --dump --edit

d) variables --variables --evaluate

e) help --help --changelog --man

f) others --version --completions

john-cd avatar Jan 28 '25 17:01 john-cd

I think that's pretty reasonable. There's a help_heading feature that clap provides, that we already use to separate commands from other options, so this would just require using different headings for the different groups of commands.

casey avatar Jan 28 '25 22:01 casey

Part of the confusion is that commands look like options. Thinking loud, could commands behave like built-in recipes??

just --sys help just --sys list just --sys init ...

john-cd avatar Jan 29 '25 17:01 john-cd

It would be pretty annoying to have to type --sys. Also, this would be a very disruptive breaking change.

casey avatar Jan 29 '25 21:01 casey

Yeah, I agree

john-cd avatar Jan 29 '25 22:01 john-cd

It would be nice to have a different command for managing just and another command for running recipes justrun.

Would have justrun as a separate command ease the user experience for #476

Because most of the options of the just command are about managing just or justfiles etc. If we have a dedicated justrun, then have options/flags, commands and subcommands(using modules) etc...?

prathyk avatar Feb 26 '25 06:02 prathyk