Seperate positional only and keyword only arguments in `--help` similar to argparse and typer about cyclopts

[BrianPugh]

Keep the issues coming! I appreciate you using CYclopts, and It's easier to make larger changes at the beginning of a project :D.

To be concrete, would the proposed output look like:

$ python .\test.py --help
Usage: cli [ARGS] [OPTIONS]

╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────────╮
│ PATH           directory or file [default: C:\Users\raven\Documents\GitHub\testtesttest]             │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Parameters ─────────────────────────────────────────────────────────────────────────────────────────╮
│ --config       config file [default: C:\Users\raven\Documents\GitHub\testtesttest\config.yaml]       │
│ --version      Display application version.                                                          │
│ --help     -h  Display this message and exit.                                                        │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯

I suppose the issue is, where would a POSITIONAL_OR_KEYWORD argument go?

[Ravencentric]

To be concrete, would the proposed output look like:

yes

I suppose the issue is, where would a POSITIONAL_OR_KEYWORD argument go?

obvious answer would be a third box maybe? but will it go in between or last? will it be too much clutter?

Another option would just be rolling POSITIONAL_OR_KEYWORD into the Parameters box in the help screen to encourage users to use keyworded args where possible, since too many positional arguments get confusing real quick and more prone to mistakes (my personal preference would be this)

[BrianPugh]

So I think this could work (where config is POSITIONAL_OR_KEYWORD). I'm worried that it might too heavily encourage the use of POSITIONAL_ONLY values. In most of my CLI applications, I primarily use POSITIONAL_OR_KEYWORD or KEYWORD_ONLY, but I rarely use POSITIONAL_ONLY.

╭─ Arguments ────────────────────────────────────────────────────────────────────────────────────────────╮
│ PATH           directory or file [default: C:\Users\raven\Documents\GitHub\testtesttest]               │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Parameters ───────────────────────────────────────────────────────────────────────────────────────────╮
│ CONFIG,--config  config file [default: C:\Users\raven\Documents\GitHub\testtesttest\config.yaml]       │
│ --version        Display application version.                                                          │
│ --help     -h    Display this message and exit.                                                        │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────╯

[Ravencentric]

that looks good, conveys config is both without being too much clutter

From my experience, usually CLIs usually have atmost one or two positional only args, with the rest mostly being keyword only or keyword_or_positional. And for keyword_or_positional i usually explicitly do keyword to avoid any mistakes.

[BrianPugh]

Closing this issue to centralize discussion over to #39.