使用docopt实现命令行参数解析的完美体验

docopt 是一个 Python 第三方库，用于解析命令行参数。它提供了一种简单直观的方式来定义命令行接口，并自动解析命令行参数，并生成帮助文档。

下面是一个通过 docopt 实现命令行参数解析的使用例子：

1. 首先你需要安装 docopt：pip install docopt。

2. 创建一个 Python 文件 cli.py，并添加以下代码：

"""
Usage:
    cli.py add <a> <b>
    cli.py subtract <a> <b>
    cli.py multiply <a> <b>
    cli.py divide <a> <b>

Options:
    -h, --help     Show this help message and exit.
"""

from docopt import docopt


def add(a, b):
    return a + b


def subtract(a, b):
    return a - b


def multiply(a, b):
    return a * b


def divide(a, b):
    return a / b


if __name__ == '__main__':
    arguments = docopt(__doc__)
    a = int(arguments['<a>'])
    b = int(arguments['<b>'])

    if arguments['add']:
        result = add(a, b)
        print(f"The result of adding {a} and {b} is {result}")
    elif arguments['subtract']:
        result = subtract(a, b)
        print(f"The result of subtracting {b} from {a} is {result}")
    elif arguments['multiply']:
        result = multiply(a, b)
        print(f"The result of multiplying {a} and {b} is {result}")
    elif arguments['divide']:
        result = divide(a, b)
        print(f"The result of dividing {a} by {b} is {result}")

上面的代码示例定义了一个简单的命令行接口，支持四个操作：加法、减法、乘法和除法。用户可以通过命令行参数传递两个操作数，并选择要执行的操作。如果用户运行脚本时没有提供正确的参数，docopt 会自动生成帮助文档，显示命令行参数的使用方式。

运行以上代码时，你可以通过以下方式来执行不同的操作：

- python cli.py add 1 2：执行加法操作，并返回 The result of adding 1 and 2 is 3。

- python cli.py subtract 5 3：执行减法操作，并返回 The result of subtracting 3 from 5 is 2。

- python cli.py multiply 4 6：执行乘法操作，并返回 The result of multiplying 4 and 6 is 24。

- python cli.py divide 10 2：执行除法操作，并返回 The result of dividing 10 by 2 is 5.0。

如果用户运行脚本时提供了无效的参数，docopt 会自动显示帮助文档，提醒用户正确的使用方式。

通过使用 docopt，你可以轻松地实现命令行参数解析，而无需手动解析命令行参数并编写繁杂的帮助文档。docopt 提供了一种简单直观的方式来定义命令行接口，并自动生成帮助文档，使得使用命令行参数变得更加方便和愉快。