具有常用选项的 Python 多命令 CLI

Question

我正在为我的 Python 应用程序添加 CLI。CLI 应允许一次运行多个命令。命令应该有公共选项和个人选项。

例子：

$ python mycliapp.py --common-option1 value1 --common-option2 value2 cmd1 --cmd1-option cmd2 --cmd2-option somevalue cmd3

该示例有两个所有命令都使用的公共选项，并且每个命令可以有或没有仅该命令使用的选项。

我考虑过Python Click。它具有丰富的功能，但它不允许（至少我没有发现）在没有一些主命令的情况下使用常用选项。

使用 Click 时，上面的示例将如下所示：

$ python mycliapp.py maincmd --common-option1 value1 --common-option2 value2 cmd1 --cmd1-option cmd2 --cmd2-option somevalue cmd3

另外，还考虑了 Python Argparse。看起来它可以满足我的需要，并且我已经成功编写了一个代码，该代码可以使用常见选项和单个命令，但无法使用多个命令。此页面Python argparse - Add argument to multiple subparsers有很好的示例，但似乎 command2 应该是 command1 的子命令。它有点不同，因为我需要命令可以按任何顺序执行。

Answer 1

Click绝对支持这种语法。一个简单的例子看起来像：

import click


@click.group(chain=True)
@click.option('--common-option1')
@click.option('--common-option2')
def main(common_option1, common_option2):
    pass


@main.command()
@click.option('--cmd1-option', is_flag=True)
def cmd1(cmd1_option):
    pass


@main.command()
@click.option('--cmd2-option')
def cmd2(cmd2_option):
    pass


@main.command()
def cmd3():
    pass


if __name__ == '__main__':
    main()

假设上面的内容在 中mycliapp.py，我们看到常见的帮助输出：

$ python example.py --help
Usage: example.py [OPTIONS] COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]...

Options:
  --common-option1 TEXT
  --common-option2 TEXT
  --help                 Show this message and exit.

Commands:
  cmd1
  cmd2
  cmd3

对于cmd1：

$ python mycliapp.py cmd1 --help
Usage: mycliapp.py cmd1 [OPTIONS]

Options:
  --cmd1-option
  --help         Show this message and exit.

对于cmd2：

$ python mycliapp.py cmd2 --help
Usage: mycliapp.py cmd2 [OPTIONS]

Options:
  --cmd2-option TEXT
  --help              Show this message and exit.

ETC。

这样我们就可以从您的问题运行命令行：

python mycliapp.py --common-option1 value1 --common-option2 value2 \
  cmd1 --cmd1-option \
  cmd2 --cmd2-option somevalue \
  cmd3

更新1

以下是使用文档中建议的回调模型实现管道的示例：

import click


@click.group(chain=True)
@click.option('--common-option1')
@click.option('--common-option2')
@click.pass_context
def main(ctx, common_option1, common_option2):
    ctx.obj = {
        'common_option1': common_option1,
        'common_option2': common_option2,
    }


@main.resultcallback()
def process_pipeline(processors, common_option1, common_option2):
    print('common_option1 is', common_option1)
    for func in processors:
        res = func()
        if not res:
            raise click.ClickException('Failed processing!')


@main.command()
@click.option('--cmd1-option', is_flag=True)
def cmd1(cmd1_option):
    def process():
        print('This is cmd1')
        return cmd1_option

    return process


@main.command()
@click.option('--cmd2-option')
def cmd2(cmd2_option):
    def process():
        print('This is cmd2')
        return cmd2_option != 'fail'

    return process


@main.command()
@click.pass_context
def cmd3(ctx):
    def process():
        print('This is cmd3 (common option 1 is: {common_option1}'.format(**ctx.obj))
        return True

    return process


if __name__ == '__main__':
    main()

每个命令都会返回一个布尔值，指示它是否成功。失败的命令将中止管道处理。例如，这里cmd1失败了，所以cmd2永远不会执行：

$ python mycliapp.py cmd1 cmd2
This is cmd1
Error: Failed processing!

但如果我们感到cmd1高兴，它就会起作用：

$ python mycliapp.py cmd1 --cmd1-option cmd2
This is cmd1
This is cmd2

同样，比较一下：

$ python mycliapp.py cmd1 --cmd1-option cmd2 --cmd2-option fail cmd3
This is cmd1
This is cmd2
Error: Failed processing!

有了这个：

$ python mycliapp.py cmd1 --cmd1-option cmd2  cmd3
This is cmd1
This is cmd2
This is cmd3

当然，您不需要按顺序调用：

$ python mycliapp.py cmd2 cmd1 --cmd1-option
This is cmd2
This is cmd1