装饰器

装饰器

需求：
一个加法函数，想要增强它的功能，能够输出被调用过以及调用的参数信息

def add(x,y):
    renturn x+y

增强信息输出功能

def add(x,y):
    print("call add,x+y")  #日志输出到控制台
    return x+y

上面的加法函数是完成了需求，但有缺点：
打印是一个功能，这条语句和add函数耦合太高
加法函数属于业务功能，而输出信息的功能，属于非业务功能代码，不该放置在业务函数add中

装饰器语法糖

def logger(fn):
    def wrapper(*args,**kwargs):
        print('begin')
        x=fn(*args,**kwargs)
        print('end')
        return x
return wrapper

@logger#等价于add=logger(add)

def add(x,y):
    return x+y
print(add(45,40))

装饰器（无参）

• 它是一个函数
• 函数作为它的形参，无参装饰器实际上就是一个单形参函数
• 返回值也是一个函数
• 可以使用@functionname方式，简化调用
  （此处装饰器的定义知识就目前所学的总结，并不准确，只是现阶段方便理解）
  装饰器可以是高阶函数，但装饰器是对传入函数的功能的装饰（功能增强）
  
  装饰器就可以理解为将画装裱这一过程！能对目标函数的各种功能的增强！

文档字符串

Python的文档：
1、Python文档字符串Documentation Strings；
2、在函数语句块的第一行，且习惯是多行的文本，所以多使用三引号；
3、惯例是首字母大写，第一行写概述，空一行，第三行写详细描述；
4、可以使用特殊属性_doc_访问这个文档

def add(x,y):
 """This is a function of addition"""
    return x+y
 print("name={}\ndoc={}".format(add.__name__,add.__doc__))
 print(help(add)

通过copy_properties函数将被包装函数的属性覆盖掉包装函数
凡是被装饰的函数都需要复制这些属性，这个函数很通用
可以将复制属性的函数构建成装饰器函数，带参装饰器
提供一个函数，被封装函数属性copy>包装函数属性，改造成带参装饰器
###带参装饰器
1、它是一个函数；
2、函数作为它的形参；
3、返回值是一个不带参的装饰器函数；
4、使用@functionname（参数列表）方式调用；
5、可以看做在装饰器外层又加了一层函数，这个函数可以多参数
将记录的功能提取出来，这样就可以通过外部提供的函数来灵活的控制输出

def logger(duration,func=lambda name,delta:print('{}took{:.2f}s'.format(name,delta))):
    def _logger(fn):
        @copy_properties(fn)      #wrapper=wrapper(fn)(wrapper)
        def wrapper(*args,**kwargs):
            start=datetime.datetime.now()
            ret=fn(*args,**kwargs)
            delta=(datetime,datetime.now()-start).total_seconds()
            if delta>duration:
               func(fn._name_,delta)
            return ret
         return wrapper
     return _logger

functools模块

functools.update_wrapper（wrapper,wrapped,assigned=WRAPPER_ASSOGNMENTS,updated=WRAPPER_UPDATES）:
类似copy_properties功能
wrapper 包装函数、被更新者，wrapped被包装函数、数据源
元组WRAPPER_ASSIGNMENTS中国是要被覆盖的属性
（‘module’,‘name’,‘qualname’,‘doc’,‘annotations’）
模块名、名称、限定名、文档、参数注解
元组WRAPPER_UPDATES中是要被更新的属性，_dict_属性字典
增加一个_wrapped_属性，保留着wrapped函数