知识卡片

结构图卡 · 6366.i.5.g.1.b · 生成模型:未记录

可调用包装不自动保持契约

理解等级:中级

tracer在init保存原函数和calls,在call先加计数、打印,再用*args调用原函数。它没有return,正常结束只返回None;没有**kwargs,也没有让包装实例像普通函数描述符那样自动为方法绑定self。调用语法相似不证明包装透明。

结构图:

classDiagram
class tracer {
 __init__(self, func)
 __call__(self, *args)
 calls
 func
}

图对应01996-01997实际实现,spam是被装饰的函数,不把它画成类。计数发生在目标调用之前,目标失败也可能已被计入;打印还依赖func.name。该例只演示匹配的位置参数调用,原spam本来不返回业务值,不能由三次打印推断返回值或关键字参数契约已经保留。

873的02368-02369复用tracer(init/call):只接*args、不接**kwargs,也没有return目标结果,故不能从spam打印正常就断定可透明包装任意函数。calls统计经过包装入口的调用尝试,递增在目标执行前,失败尝试也会计数;直接拿到原函数的其他引用仍可绕过。

874的02371增强tracer把call扩为(self,*args,kwargs),并return self.func(*args,kwargs),补上前版遗漏的关键字和返回值转发。这个改动仍不自动补方法绑定/元数据等全部契约;完整类和状态图另见本节计数状态卡。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 3 处

    • · 查看原书依据

      没有返回已装饰函数的结果,没有处理关键字参数,并且不能装饰类方法函数(简而言之,对于其__call__方法将只传递一个tracer实例)。正如我们将在第八部分见到的,有各种各样的方式来编写函数装饰器,包括嵌套def语句;其中的一些替代方法比这里给出的版本更适合于方法。

    • · 查看原书依据

      任意多个参数的任何函数(这个版本还不能在类方法上工作,但是,我们将在本小节稍后修改这一点)。 现在,如果导入这个模块的函数并交互地测试它,将会得到如下的一种行为——每次调用都初始地产生一条跟踪信息,因为装饰器类拦截了调用。这段代码在Python 2.6和Python 3.0下都能运行,就像本章中所有其他的代码一样,除非特别提示: 运行的时候,tracer类和

    • · 查看原书依据

      返回包装函数的结果,以支持更多的用例: 就像最初的版本一样,这里的代码使用类实例属性来显式地保存状态。包装的函数和调用计数器都是针对每个实例的信息——每个装饰都有自己的拷贝。当在Python 2.6和Python 3.0下运行一段脚本的时候,这个版本的输出如下所示。注意spam和eggs函数的每一个是如何有自己的调用计数器的,因为每个装饰都创建一个新的类实例

    参考来源

    - 位置:《Python学习手册(原书第4版)》第31章《装饰器例子》(spine970;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0941.html;u704-ch31-011)。 - 结论依据:704正文主动说明三项局限,01996-01998完整tracer/被装饰spam/三次输出显示无return、无kwargs和调用前计数;错误路径按代码次序推导,未执行错误或方法例。 - 原始内容:没有返回已装饰函数的结果,没有处理关键字参数,并且不能装饰类方法函数(简而言之,对于其__call__方法将只传递一个tracer实例)。正如我们将在第八部分见到的,有各种各样的方式来编写函数装饰器,包括嵌套def语句;其中的一些替代方法比这里给出的版本更适合于方法。 - 位置:《Python学习手册(原书第4版)》第38章《跟踪调用》(spine1098;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part1069.html;u873-ch31-011)。 - 结论依据:873的02368-02369复用tracer(__init__/__call__):只接*args、不接**kwargs,也没有return目标结果,故不能从spam打印正常就断定可透明包装任意函数。calls统计经过包装入口的调用尝试,递增在目标执行前,失败尝试也会计数;直接拿到原函数的其他引用仍可绕过。 - 原始内容:任意多个参数的任何函数(这个版本还不能在类方法上工作,但是,我们将在本小节稍后修改这一点)。 现在,如果导入这个模块的函数并交互地测试它,将会得到如下的一种行为——每次调用都初始地产生一条跟踪信息,因为装饰器类拦截了调用。这段代码在Python 2.6和Python 3.0下都能运行,就像本章中所有其他的代码一样,除非特别提示: 运行的时候,tracer类和 - 位置:《Python学习手册(原书第4版)》第38章《状态信息保持选项》(spine1099;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part1070.html;u874-ch31-011)。 - 结论依据:874的02371增强tracer把__call__扩为(self,*args,**kwargs),并return self.func(*args,**kwargs),补上前版遗漏的关键字和返回值转发。这个改动仍不自动补方法绑定/元数据等全部契约;完整类和状态图另见本节计数状态卡。 - 原始内容:返回包装函数的结果,以支持更多的用例: 就像最初的版本一样,这里的代码使用类实例属性来显式地保存状态。包装的函数和调用计数器都是针对每个实例的信息——每个装饰都有自己的拷贝。当在Python 2.6和Python 3.0下运行一段脚本的时候,这个版本的输出如下所示。注意spam和eggs函数的每一个是如何有自己的调用计数器的,因为每个装饰都创建一个新的类实例