使用wraps()装饰器为函数添加元数据

在Python中，wraps()是一个装饰器函数，它可以用来帮助我们添加元数据（如函数名、文档字符串等）到被装饰函数中。元数据是指描述数据的数据，它提供了对数据的更多信息，可以帮助程序员更好地理解函数的作用、使用方法以及期望的输入输出。

使用wraps()装饰器的基本语法如下：

from functools import wraps

def decorator(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        # 装饰器逻辑代码
        return func(*args, **kwargs)
    return wrapper

wraps()函数接受一个函数参数，并返回一个新的装饰器函数。这个新的装饰器函数会调用原始函数，并将原始函数的元数据复制到它自己身上。这样，通过调用wraps()函数，我们可以防止元数据在装饰函数中丢失。

下面是一个使用wraps()装饰器为函数添加元数据的例子：

from functools import wraps

def add_metadata(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        """
        这是一个用于测试的装饰器函数
        在执行原始函数之前打印一条消息
        """
        print("执行函数之前...")
        return func(*args, **kwargs)
    
    return wrapper

@add_metadata
def my_function(x, y):
    """
    这是一个加法函数，用于计算两个数的和
    """
    return x + y

# 调用被装饰的函数
result = my_function(2, 3)
print(result)

在上面的例子中，我们定义了一个add_metadata()装饰器函数，它使用wraps()函数来复制原始函数的元数据。装饰器函数内部定义了一个新的函数wrapper()，它在执行原始函数之前打印一条消息。然后，我们使用@add_metadata语法将装饰器函数应用到my_function()函数上。

在调用被装饰的函数时，首先会打印"执行函数之前..."的消息，然后输出函数的返回结果。这样，我们就成功地为函数添加了元数据，并在函数执行之前添加了一些自定义的逻辑。

使用wraps()装饰器可以在不改变原始函数行为的基础上，为函数添加额外的功能。这是一种灵活且方便的方式，可以帮助我们更好地了解和利用被装饰函数。