functools 之 update_wrapper 的使用

448 阅读4分钟
原文链接: mp.weixin.qq.com

我记得5年前来搜狐面试时一个问题就是关于装饰器如何保持函数签名的问题。

由来

xadmin通过实现自己的BaseAdminView(继承自Django的View)来完成xadmin后台界面的处理。在解决一个csrf的问题时,翻了下xadmin BaseAdminView和Django的View部分的代码,关键点少了一条 update_wrapper 使用。导致我的小伙伴调试了半天。

还是看代码

可以对比看下:

  1. ## xadmin代码

  2. @classonlymethod

  3. def as_view(cls):

  4.    def view(request, *args, **kwargs):

  5.        self = cls(request, *args, **kwargs)

  6.        if hasattr(self, 'get') and not hasattr(self, 'head'):

  7.            self.head = self.get

  8.        if self.request_method in self.http_method_names:

  9.            handler = getattr(

  10.                self, self.request_method, self.http_method_not_allowed)

  11.        else:

  12.            handler = self.http_method_not_allowed

  13.        return handler(request, *args, **kwargs)

  14.    # take name and docstring from class

  15.    update_wrapper(view, cls, updated=())

  16.    view.need_site_permission = cls.need_site_permission

  17.    return view

  18. ### django/views/generic/base.py:class View中的代码

  19. @classonlymethod

  20. def as_view(cls, **initkwargs):

  21.    """Main entry point for a request-response process."""

  22.    for key in initkwargs:

  23.        if key in cls.http_method_names:

  24.            raise TypeError("You tried to pass in the %s method name as a "

  25.                            "keyword argument to %s(). Don't do that."

  26.                            % (key, cls.__name__))

  27.        if not hasattr(cls, key):

  28.            raise TypeError("%s() received an invalid keyword %r. as_view "

  29.                            "only accepts arguments that are already "

  30.                            "attributes of the class." % (cls.__name__, key))

  31.    def view(request, *args, **kwargs):

  32.        self = cls(**initkwargs)

  33.        if hasattr(self, 'get') and not hasattr(self, 'head'):

  34.            self.head = self.get

  35.        self.request = request

  36.        self.args = args

  37.        self.kwargs = kwargs

  38.        return self.dispatch(request, *args, **kwargs)

  39.    view.view_class = cls

  40.    view.view_initkwargs = initkwargs

  41.    # take name and docstring from class

  42.    update_wrapper(view, cls, updated=())

  43.    # and possible attributes set by decorators

  44.    # like csrf_exempt from dispatch

  45.    update_wrapper(view, cls.dispatch, assigned=())    ## 差了这个啊!同学们

  46.    return view

xadmin是直接把dispatch的代码放到内部的view中了,这样看起来直观,但是缺少了对外可配置(通过重写增加装饰器)的dispatch函数。导致无法对view进行csrf_exempt装饰(其实是dispatch上装饰@csrf_exempt时,装饰器返回的inner上会设置csrf_exempt = True的属性)。

update_wrapper的用法

上述代码应该挺明显了,update_wrapper的作用就是把cls.dispatch上的所有属性全部赋值到装饰函数上,也就是代码中的  view

在Python中有几个库是“居家旅行”必备的,functools就是之一,其中的partial也十分有用,用法参考这里python中functools宝库下的partial

再举个例子吧

上面的代码,如果不熟悉对应的内容,可能不太懂。

关于保持函数签名,functools提供了两个api,一个是update_wrapper,一个是wrap装饰器函数,但是wrap装饰器函数也是调用了update_wrapper。所以就看update_wrapper就行。

有一个面试题是这样的,写一个函数装饰器,用来缓存函数的值。

函数是这样的:

  1. def exec(sql):

  2.    """ 从执行数据库查询 """

  3.    return conn.execute(sql)

为了避免同样的语句执行多次数据库查询,我们需要做一层缓存,在不改变原函数的情况下。

于是有了这样的代码:

  1. def cache(func):

  2.    cached_dict = {}

  3.    def inner(*args, **kwargs):

  4.        key = repr(args, kwargs)

  5.        try:

  6.            return cached_dict[key]

  7.        except KeyError:

  8.            cached_dict[key] = func(*args, **kwargs)

  9.            return cached_dict[key]

  10.    inner.csrf_exempt = True

  11.    return inner

  12. @cache

  13. def execute_query(sql):

  14.    """ 从执行数据库查询 """

  15.    print 'hit db'  # 插播一条,刚才有人在群里问如何判断是否缓存了,看这个就行了

  16.    return  'result'  # conn.execute(sql)  # 假设拿到了结果

通过装饰器中的cached_dict来缓存同一个sql的结果。

我们print出来函数名称以及执行几个语句

  1. print execute_query

  2. # 输出 <function inner at 0x1025de6e0>

  3. print execute_query('select * from test')

  4. # 输出 hit db

  5. # 输出 result

  6. print execute_query('select * from test')

  7. # 输出 result

第一个print出来的结果是存在问题的,我们调用的是execute_query,然而输出的函数名确实inner。所以这就需要update_wrapper或者wrap这样的函数来把被装饰的函数的属性(包括名称,doc等)放到装饰的函数上。也就是让inner伪装为execute_query。

要怎么做呢?一开始的那段代码就是例子了。两个方法一个是直接在inner上增加@functools.wrap(func)装饰器,另外一个方法是在return inner之前,增加一行: functools.update_wrapper(inner, func),然后重新执行上面的代码,结果是什么?

参考


----EOF----- 

扫码关注,或者搜索微信公众号:码农悟凡