装饰器
需求:
一个加法函数,想要增强它的功能,能够输出被调用过以及调用的参数信息
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函数