Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Group options and arguments by topic #2603

Open
john-cd opened this issue Jan 28, 2025 · 4 comments
Open

Group options and arguments by topic #2603

john-cd opened this issue Jan 28, 2025 · 4 comments

Comments

@john-cd
Copy link

john-cd commented Jan 28, 2025

[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

@casey
Copy link
Owner

casey commented Jan 28, 2025

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.

@john-cd
Copy link
Author

john-cd commented Jan 29, 2025

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
...

@casey
Copy link
Owner

casey commented Jan 29, 2025

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

@john-cd
Copy link
Author

john-cd commented Jan 29, 2025

Yeah, I agree

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants