wraps其實沒有實際的大用處, 就是用來解決裝飾器導致的原始函數名指向的函數的屬性發生變化的問題;
裝飾器裝飾過函數func, 此時func不是指向真正的func,而是指向裝飾器中的裝飾過的函數
import sys debug_log = sys.stderr def trace(func): if debug_log: def callf(*args, **kwargs): """A wrapper function.""" debug_log.write('Calling function: {}\n'.format(func.__name__)) res = func(*args, **kwargs) debug_log.write('Return value: {}\n'.format(res)) return res return callf else: return func @trace def square(x): """Calculate the square of the given number.""" return x * x
這裡的square 其實指向的是calls, 可以用help(square)或square.__name__ 看下。
square 被裝飾後的函數其實已經是另外一個函數了(函數名稱等函數屬性會改變)
如果使用wraps進行修飾
def trace(func): if debug_log: @functools.wraps(func) def callf(*args, **kwargs): """A wrapper function.""" debug_log.write('Calling function: {}\n'.format(func.__name__)) res = func(*args, **kwargs) debug_log.write('Return value: {}\n'.format(res)) return res return callf else: return func
此時trace 的square 的屬性就不會改變了,可以help(square) 看看
原因:我們把wraps的裝飾的程式碼翻譯如下,其等價為:
def trace(func): if debug_log: def _callf(*args, **kwargs): """A wrapper function.""" debug_log.write('Calling function: {}\n'.format(func.__name__)) res = func(*args, **kwargs) debug_log.write('Return value: {}\n'.format(res)) return res callf = functools.update_wrapper(_callf, wrapped = func,assigned = functools.WRAPPER_ASSIGNMENTS,updated = functools.WRAPPER_UPDATES) return callf else: return func
update_wrapper做的工作很簡單,就是用參數wrapped表示的函數物件(例如:square )的一些屬性(如:__name__、 __doc__)覆寫參數wrapper表示的函數物件(例如:callf,這裡callf只是簡單地呼叫square函數,因此可以說callf是square的一個wrapper function)的這些對應屬性。
因此,本例中使用wraps裝飾器「裝飾」過callf後,callf的__doc__、__name__等屬性和trace要「裝飾」的函數square的這些屬性完全一樣。