swift-argument-parser icon indicating copy to clipboard operation
swift-argument-parser copied to clipboard

Customisable command synopsis in help message

Open sharplet opened this issue 5 years ago • 0 comments

I'd like to be able to customise the command synopsis a little bit more. The current synopsis generator in UsageGenerator will collapse all options into a single <options> entry if there are more than twelve. My command has only 3 options, but with the long names being included in the synopsis, it's already unwieldy.

A few of ideas:

  • Allow providing a manual synopsis.
  • Similar to .hidden, allow hiding of options on a case-by-case basis.
  • Collapse options with default values by default.

sharplet avatar Jun 10 '20 22:06 sharplet