课程大纲 第 63 课,共 250 课 · Python 风格代码、测试与综合项目
Python 风格代码、测试与综合项目

装饰器

装饰器是一个包装另一个函数、为它添加行为的函数,它不改变原函数的函数体。你用放在 def 上面的 @ 语法来应用它。

形状总是一样的:接收一个函数,定义一个内部的 wrapper,它做一些额外的事然后调用原函数,再返回这个 wrapper。

def shout(func):
    def wrapper(*args, **kwargs):
        result = func(*args, **kwargs)
        return result.upper()
    return wrapper

@shout
def greet(name):
    return f"hi {name}"

print(greet("ada"))   # HI ADA

在 greet 上面写 @shout,只是 greet = shout(greet) 的简写。从那以后,名字 greet 指向的就是 wrapper。

wrapper 里的 *args, **kwargs 让它能接收原函数接收的任何参数,然后原样转交。这让装饰器保持通用。

functools.wraps

包装会替换掉函数,所以原函数的名字和文档字符串会被藏在 wrapper 后面。解决办法是用 functools.wraps(func) 装饰 wrapper 本身,它会把元数据复制过去。在真实的装饰器上总要这样做:

import functools

def double(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs) * 2
    return wrapper

@double
def add(a, b):
    """Add two numbers."""
    return a + b

print(add(3, 4))        # 14
print(add.__name__)     # 'add'  (preserved by wraps)
轮到你了

写一个装饰器 double,把它包装的任何函数的返回值翻倍。用 functools.wraps,让被包装的函数保留它的 __name__。然后用 @double 把它应用到一个返回 a + b 的函数 add(a, b) 上,这样 add(3, 4) 得到 14,而 add.__name__ 仍然是 "add"。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。