python - 带有常用选项的 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 的子命令。这有点不同，因为我需要命令可以按任何顺序执行。

标签： pythoncommand-line-interfaceargparsepython-click

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.

等等。

有了这个，我们可以从您的问题运行命令行：

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