python argparse - 使用带有nargs的list选项显示scrambled help message

时间:2017-09-16 17:11:19

标签: python argparse

我正在使用argparse接受选项,其中一个是列表:

parser.add_argument('-S', '--size', help='Number of results to show', default=1000, dest='size', metavar='')
parser.add_argument('-H','--hostname', nargs='*', help='Hostname list', dest='hostname', metavar='')

当我使用nargs选项时,帮助信息看起来不太好:

optional arguments:
  -h, --help            show this help message and exit
  -S , --size           Number of results to show
  -H [ [ ...]], --hostname [ [ ...]]
                        Hostname list

如何让主机名看起来像其他参数? metavar =''技巧在这里不起作用。

感谢。

1 个答案:

答案 0 :(得分:1)

*格式固定为嵌套[]。它应该传达零,一个或多个字符串被接受的感觉。它也会影响使用和帮助热线。 Metavar允许一些控制,但不能完全替换。

In [461]: p=argparse.ArgumentParser()
In [462]: a=p.add_argument('-f','--foo',nargs='*')
In [463]: p.print_help()
usage: ipython3 [-h] [-f [FOO [FOO ...]]]

optional arguments:
  -h, --help            show this help message and exit
  -f [FOO [FOO ...]], --foo [FOO [FOO ...]]

一个字符串:

In [464]: a.metavar = 'F'
In [465]: p.print_help()
usage: ipython3 [-h] [-f [F [F ...]]]

optional arguments:
  -h, --help            show this help message and exit
  -f [F [F ...]], --foo [F [F ...]]

元组:

In [467]: a.metavar = ('A','B')
In [468]: p.print_help()
usage: ipython3 [-h] [-f [A [B ...]]]

optional arguments:
  -h, --help            show this help message and exit
  -f [A [B ...]], --foo [A [B ...]]

完全解除帮助:

In [469]: a.help = argparse.SUPPRESS
In [470]: p.print_help()
usage: ipython3 [-h]

optional arguments:
  -h, --help  show this help message and exit

总是可以选择子类化帮助格式化程序,并更改一个或两个方法。

使用metavar的HelpFormatter方法:

def _format_args(self, action, default_metavar):
    get_metavar = self._metavar_formatter(action, default_metavar)
    if action.nargs is None:
        result = '%s' % get_metavar(1)
    elif action.nargs == OPTIONAL:
        result = '[%s]' % get_metavar(1)
    elif action.nargs == ZERO_OR_MORE:
        result = '[%s [%s ...]]' % get_metavar(2)
    elif action.nargs == ONE_OR_MORE:
        result = '%s [%s ...]' % get_metavar(2)
    elif action.nargs == REMAINDER:
        result = '...'
    elif action.nargs == PARSER:
        result = '%s ...' % get_metavar(1)
    else:
        formats = ['%s' for _ in range(action.nargs)]
        result = ' '.join(formats) % get_metavar(action.nargs)
    return result