Click 是否支持 "bunching" 个空头选项？

Question

某些命令行工具允许“组合”短选项。

例如，tar 命令采用短选项 -x、-v 和 -f filespec. 它允许像 -xvf filespec 这样的选项被捆绑在一起，以避免 space-dash.

的冗余输入

正在阅读 documentation for Click 我找不到任何关于这是否受支持的指示。

文档确实说支持替代前缀字符（如 +w/-w），这往往表明它可能不受支持。

所以：

click支持短期权组合吗？
如果是这样，这是自动的，还是需要配置？
我应该使用什么搜索关键字来查找相关文档？

Answer 1

Click绝对支持堆叠短旗选项。不确定这是必然的记录在点击文档中，但这是标准的 POSIX 命令行约定已记录 here. The second bullet point of why to use Click 状态：

支持实施Unix/POSIX命令行约定

测试代码：

import click

@click.command()
@click.option('-x', is_flag=True)
@click.option('-y', is_flag=True)
@click.option('-z')
def cli(x, y, z):
    click.echo(f'x:{x}  y:{y}  z:{z}')


if __name__ == "__main__":
    commands = (
        '-x',
        '-y',
        '-z 1',
        '-xz 2',
        '-yz 3',
        '-xyz 4',
        '-yx',
        '--help',
    )

    import sys, time
    time.sleep(1)
    print('Click Version: {}'.format(click.__version__))
    print('Python Version: {}'.format(sys.version))
    for cmd in commands:
        try:
            time.sleep(0.1)
            print('-----------')
            print('> ' + cmd)
            time.sleep(0.1)
            cli(cmd.split())

        except BaseException as exc:
            if str(exc) != '0' and \
                    not isinstance(exc, (click.ClickException, SystemExit)):
                raise

结果：

Click Version: 7.1.2
Python Version: 3.8.5 (tags/v3.8.5:580fbb0, Jul 20 2020, 15:57:54) [MSC v.1924 64 bit (AMD64)]
-----------
> -x
x:True  y:False  z:None
-----------
> -y
x:False  y:True  z:None
-----------
> -z 1
x:False  y:False  z:1
-----------
> -xz 2
x:True  y:False  z:2
-----------
> -yz 3
x:False  y:True  z:3
-----------
> -xyz 4
x:True  y:True  z:4
-----------
> -yx
x:True  y:True  z:None
-----------
> --help
Usage: test_code.py [OPTIONS]

Options:
  -x
  -y
  -z TEXT
  --help   Show this message and exit.

Click 是否支持 "bunching" 个空头选项？

Does Click support "bunching" short options together?

python

command-line-interface

python-3.x

python-click

测试代码：

结果：