在Python 3.4 中,新增一个方法unwrap,用于将被装饰的函数,逐层进行解包装。
inspect.unwrap(func, *, stop=None)
unwrap方法接受两个参数:func为需要解包装的函数;stop接受一个单参数的函数,作为回调函数,每次会将即将解包装的函数对象传入到回调函数中,如果回调函数返回True,则会提前终止解包,如果没有返回值,或返回Flase,unwrap会逐层解包直至装饰链中的最后一个函数对象。
另外能正常解包装的前提是装饰器上添加了@wraps(func)装饰器。
写一些demo运行看看结果
完整代码: https://github.com/blackmatrix7/python-learning/blob/master/other/unwrap.py
首先定义一些没什么用的函数和装饰器,以及回调函数。
这里每个函数和装饰器都会打印自身的名字,以此标记此函数或装饰器是否被运行。而回调函数会执行传入的函数对象,通过函数对象自身的打印功能,显示回调函数接受函数对象的顺序。
from inspect import unwrap
from functools import wraps __author__ = 'blackmatrix' def test_decorator(func):
@wraps(func)
def wrapper(*args, **kwargs):
print('test_decorator')
return func(*args, **kwargs)
return wrapper def test_decorator2(func):
@wraps(func)
def wrapper(*args, **kwargs):
print('test_decorator2')
return func(*args, **kwargs)
return wrapper def test_decorator3(func):
def wrapper(*args, **kwargs):
print('test_decorator3')
return func(*args, **kwargs)
return wrapper # 测试只有一个装饰器的情况下,能否正常解包
@test_decorator
def spam():
print('spam1', '\n') # 测试两个装饰器情况下,能否正常解包
@test_decorator2
@test_decorator
def spam2():
print('spam2', '\n') # 测试多个装饰器情况下,其中一个装饰器的包装器没有使用@wraps
@test_decorator2
@test_decorator3
@test_decorator
def spam3():
print('spam3', '\n') def callback(obj):
obj() def callback2(obj):
if obj is spam2:
print(True)
return True
调用被装饰的函数spam
spam(value='decorated_spam')
装饰器生效,输出 test_decorator,证明装饰器是能正常工作的。
test_decorator
spam1
使用 unwrap 获取被包装的函数,命名为unwrap_spam,并调用
unwrap_spam = unwrap(spam)
unwrap_spam()
调用已经解包装的函数命名为unwrap_spam,没有输出 test_decorator,(根据上面述说的规则,没有打印装饰器名称,就认为没有执行,所以装饰器没有生效,后面的测试也是相同的判定方式,不再复述)。
说明解包是成功的,成功获取到被装饰的函数(而不是被装饰后的函数)。
spam1
接着试试多个装饰器的情况下,能否正常解包
unwrap_spam2 = unwrap(spam2)
unwrap_spam2()
同样,调用解包后的函数,两个装饰器都没有输出结果,说明多个装饰器也能正常解包
spam2
之前能正常解包的一个前提是装饰器本身的包装函数上,添加了系统内部的装饰器@wraps(func)。
现在我们来试试如果使用了未添加@wraps的装饰器,能否正常解包。
之前定义了一个test_decorator3装饰器,没有添加@wraps。
现在将test_decorator2、test_decorator3、test_decorator三个装饰器逐个添加到函数spam3上(注意test_decorator2在test_decorator3之前)。
尝试解包
unwrap_spam3 = unwrap(spam3)
unwrap_spam3()
从运行结果可以看出,运行解包后的函数unwrap_spam3,test_decorator2没有被打印出来,说明被成功解包,而装饰器test_decorator3、test_decorator都正常运行(都正常打印值),并没有解包成功。
test_decorator3
test_decorator
spam3
所以,多个装饰器情况下,如果其中一个装饰器没有使用@wraps,那么在装饰链中,unwrap只能解包到未使用@wraps的装饰器。
接着,测试一下回调函数的调用。
再提一下,之前提过我们设定的回调函数会执行传入的函数对象,通过函数对象自身的打印功能,显示回调函数接受函数对象的顺序。
unwrap_spam2_unwrap = unwrap(spam2, stop=callback)
输出结果
test_decorator2
test_decorator
spam2 test_decorator
spam2
这个输出结果分两部分,第一部分为
test_decorator2
test_decorator
spam2
这是第一次解包的运行结果,解包此时调用依次调用test_decorator2、test_decorator、spam2所以会由如上的输出结果。
下面是第二部分的输出,这是第二次解包的运行结果,此时回调函数的调用顺序是test_decorator、spam2,所以会输出下面的结果
test_decorator
spam2
而第三次解包,因为已经获取到装饰链的最后一个对象,所以不会再调用回调函数,所以不会有输出结果。
另外还需要再注意下第一次解包的输出结果:test_decorator2、test_decorator、spam2。
说明第一次解包时,传给回调函数是完整的,整个被test_decorator2、test_decorator两个装饰器装饰后的spam2!
而不是解包后的函数对象(如果是解包后的函数对象,因为test_decorator2已经成功解包,所以打印结果应该是test_decorator、spam2)!
换个方法验证,在回调函数中添加 print(obj is spam2) 的判断,也会得到True的结果。
def callback(obj):
obj()
print(obj is spam2)
上面用于判断的spam2是被test_decorator2、test_decorator两个装饰器装饰后的spam2,而不是被装饰的函数spam2,听起来有点拗口,用代码看下就很清楚了:
spam2实际上是
@test_decorator2
@test_decorator
def spam2():
print('spam2', '\n')
而不是
def spam2():
print('spam2', '\n')
所以会返回True
也就是说,传给回调函数的对象,实际上应该是本次待解包的函数对象,而不是解包之后的函数对象!
再试试回调函数返回True的时候是不是真的可以提前终止解包。
unwrap_spam2 = unwrap(spam2, stop=callback2)
执行结果如下,也就是在第一次调用回调函数,返回True时,解包就已经终止。
test_decorator2
test_decorator
spam2
那么第一次解包终止后,获得的函数对象unwrap_spam2又是什么?运行看看,得到如下输出:
test_decorator2
test_decorator
spam2
说明,第一次解包终止后,得到的函数对象实际上是未解包的函数对象,即完整被test_decorator2、test_decorator两个装饰器装饰后的spam2。
所以,整个解包装的流程应该是这样的:
将当前待解包的函数对象传入回调函数中 --> 回调函数返回 True,解包终止,返回当前待解包的函数对象。
--> 回调函数返回 False或者没有返回值,解包继续,返回解包后的函数对象。
其中:
- 如果解包后的函数对象不是装饰链中的最后一个对象,那么重复第一步,将对象传入回调函数
- 如果解包后的函数对象已经是装饰链的最后一个对象(或是一个没有用@wrap装饰的装饰器),那么解包终止。
- 如果没有回调函数,则逐层解包,直至装饰链最后一个对象,或遇到一个没有用@wrap装饰的装饰器(会被当成装饰链最后一个对象处理)。