使用desc_parameter()函数来给Python函数的参数添加中文描述

def desc_parameter(func):
    def wrapper(*args, **kwargs):
        func_params = func.__code__.co_varnames[:func.__code__.co_argcount]
        params_dict = func.__annotations__
        
        # Print the parameter description before executing the function
        print("函数 {} 的参数描述如下:".format(func.__name__))
        for param in func_params:
            if param in params_dict:
                print("{}: {}".format(param, params_dict[param]))
            else:
                print("{}: 暂未添加描述".format(param))
                
        # Execute the function
        result = func(*args, **kwargs)
        
        return result
    return wrapper

使用例子:

@desc_parameter
def calculate_area(length: "矩形的长度", width: "矩形的宽度") -> "矩形的面积":
    area = length * width
    return area

calculate_area(5, 3)

输出结果:
函数 calculate_area 的参数描述如下:
length: 矩形的长度
width: 矩形的宽度
15

在上述例子中，我们定义了一个装饰器函数 desc_parameter，它可以给被装饰的函数的参数添加中文描述。我们通过向函数的参数添加注解的方式来提供中文描述，即 length: "矩形的长度" 和 width: "矩形的宽度"。在使用 @desc_parameter 装饰器装饰 calculate_area 函数后，调用 calculate_area(5, 3) 会打印出函数的参数描述，并计算矩形的面积，并将结果 15 返回。

这样做的好处是我们可以在函数定义的同时提供参数的中文描述，方便其他开发人员使用该函数时理解参数的含义。装饰器函数 desc_parameter 利用反射机制来获取函数的参数和注解，并将它们一一对应地输出，提供参数的中文描述。