本文档旨在介绍如何在 Click 命令行应用中获取未被 Click 解析的原始命令行参数。通过 click.Context 对象的 args 属性，开发者可以访问到传递给程序的、但未被 Click 框架处理的参数列表，从而实现更灵活的参数处理和自定义逻辑。
获取未解析参数
Click 是一个流行的 Python 库，用于构建命令行界面。它提供了方便的参数解析和命令组织功能。然而，有时我们需要访问那些未被 Click 自动解析的原始命令行参数。Click 提供了 click.Context 对象的 args 属性来实现这一目的。
click.Context 对象包含了当前命令的上下文信息，包括命令名称、路径和已解析的参数。args 属性则包含了未被 Click 解析的参数列表。
以下是一个示例，展示如何使用 ctx.args 获取未解析的参数：
import click
@click.group("abc")
def abc():
"""ABC Help"""
pass
@abc.command("test")
@click.option("-o", "--option")
@click.option("-o2", "--option2", default="two")
def test(option, option2):
"""Get command CLI info"""
ctx = click.get_current_context()
print("Command name:", ctx.info_name)
print("Command path:", ctx.command_path)
print("Command params:", ctx.params)
print("CLI args:", ' '.join(ctx.args))
if __name__ == "__main__":
abc()在这个例子中，test 命令定义了两个选项：-o 或 --option 和 -o2 或 --option2。当用户传递了未定义的参数时，例如 abc test -o 1 extra_arg，ctx.args 将包含 ['extra_arg']。
示例用法
假设我们运行以下命令：
abc test -o 1 extra_arg another_arg
程序的输出将会是：
Command name: test
Command path: abc test
Command params: {'option': '1', 'option2': 'two'}
CLI args: extra_arg another_arg可以看到，ctx.args 成功捕获了 extra_arg 和 another_arg 这两个未被解析的参数。
注意事项
- ctx.args 返回的是一个列表，包含了所有未被 Click 解析的参数。
- 参数的顺序与在命令行中输入的顺序一致。
- 如果命令行中没有未解析的参数，ctx.args 将返回一个空列表。
- 在使用 ctx.args 之前，请确保已经调用了 click.get_current_context() 获取了当前的上下文对象。
总结
通过使用 click.Context 对象的 args 属性，我们可以方便地获取 Click 应用中未解析的命令行参数。这为开发者提供了更大的灵活性，可以处理一些特殊的参数，或者实现自定义的参数解析逻辑。在设计 Click 应用时，合理利用 ctx.args 可以增强程序的功能和可扩展性。
