classification
Title: [argparse] Unify options in help output
Type: enhancement Stage:
Components: Library (Lib) Versions: Python 3.6
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: Nosy List: bethard, memeplex, paul.j3
Priority: normal Keywords:

Created on 2016-06-12 20:21 by memeplex, last changed 2016-06-13 03:56 by memeplex.

Messages (4)
msg268400 - (view) Author: Memeplex (memeplex) Date: 2016-06-12 20:21
Currently when you specify more than one name for an option (typically short and long versions) each name is listed with its entire arg list. This is annoying for options taking many args or choices, for example:
 
  --type {html,pdf,github,blogger}, -t {html,pdf,github,blogger}

Wouldn't it be better to just show something like:

  --type|-t {html,pdf,github,blogger}
msg268405 - (view) Author: paul j3 (paul.j3) * (Python triager) Date: 2016-06-12 23:17
There are 2 issues here - 

- how to make the 'choices' list most compact

- how to make the multiple option strings display (long and short) more compact, regardless of why the argument part is long.

When the choices display is too long, 'metavar' is a handy alternative.  You can still display the choices in the body of the help message, either as an explicit list or with the `%(choices)s` string.  The long choices list will still appear in the error messages.

There are other bug/issues about formatting the choices list.

I have participated in discussions about replacing

    -f FOO, --foo FOO etc 

with

    -f/--foo FOO etc

I'm sure that's been raised on Stackoverflow, but there might also be a bug/issue on the topic.  I'd have to do some search to find those.  I believe it can addressed with a HelpFormatter subclass that changes one method.
msg268411 - (view) Author: paul j3 (paul.j3) * (Python triager) Date: 2016-06-13 01:44
http://stackoverflow.com/questions/18275023/dont-show-long-options-twice-in-print-help-from-argparse

Once answer demonstrates how to change the Formatter:

class CustomHelpFormatter(argparse.HelpFormatter):
    def _format_action_invocation(self, action):
        if not action.option_strings or action.nargs == 0:
            return super()._format_action_invocation(action)
        default = self._get_default_metavar_for_optional(action)
        args_string = self._format_args(action, default)
        return ', '.join(action.option_strings) + ' ' + args_string

Another answer suggests using metavar=''.

Another SO question with a few more links:

http://stackoverflow.com/questions/23936145/python-argparse-help-message-disable-metavar-for-short-options
msg268416 - (view) Author: Memeplex (memeplex) Date: 2016-06-13 03:56
Thank you for the tips, Paul. The issue is related to the default behavior but it's always good to know about handy workarounds and extensibility hooks.
History
Date User Action Args
2016-06-13 03:56:17memeplexsetmessages: + msg268416
2016-06-13 01:45:00paul.j3setmessages: + msg268411
2016-06-12 23:17:58paul.j3setnosy: + paul.j3
messages: + msg268405
2016-06-12 20:26:45SilentGhostsetversions: + Python 3.6, - Python 3.5
2016-06-12 20:22:46memeplexsettype: enhancement
2016-06-12 20:21:38memeplexcreate