Python中如何将一个类方法变为多个方法


Posted in Python onDecember 30, 2019

前一篇文章《Python 中如何实现参数化测试?》中,我提到了在 Python 中实现参数化测试的几个库,并留下一个问题:

它们是如何做到把一个方法变成多个方法,并且将每个方法与相应的参数绑定起来的呢?

我们再提炼一下,原问题等于是:在一个类中,如何使用装饰器把一个类方法变成多个类方法(或者产生类似的效果)?

# 带有一个方法的测试类
class TestClass:
  def test_func(self):
    pass

# 使用装饰器,生成多个类方法
class TestClass:
  def test_func1(self):
    pass
  def test_func2(self):
    pass
  def test_func3(self):
    pass

Python 中装饰器的本质就是移花接木,用一个新的方法来替代被装饰的方法。在实现参数化的过程中,我们介绍过的几个库到底用了什么手段/秘密武器呢?

1、ddt 如何实现参数化?

先回顾一下上篇文章中 ddt 库的写法:

import unittest
from ddt import ddt,data,unpack
@ddt
class MyTest(unittest.TestCase):
  @data((3, 1), (-1, 0), (1.2, 1.0))
  @unpack
  def test(self, first, second):
    pass

ddt 可提供 4 个装饰器:1 个加在类上的 @ddt,还有 3 个加在类方法上的 @data、@unpack 和 @file_data(前文未提及)。

先看看加在类方法上的三个装饰器的作用:

import unittest
from ddt import ddt,data,unpack
@ddt
class MyTest(unittest.TestCase):
  @data((3, 1), (-1, 0), (1.2, 1.0))
  @unpack
  def test(self, first, second):
    pass

它们的共同作用是在类方法上 setattr() 添加属性。至于这些属性在什么时候使用?下面看看加在类上的 @ddt 装饰器源码:

Python中如何将一个类方法变为多个方法

Python中如何将一个类方法变为多个方法

第一层 for 循环遍历了所有的类方法,然后是 if/elif 两条分支,分别对应 DATA_ATTR/FILE_ATTR,即对应参数的两种来源:数据(@data)和文件(@file_data)。

elif 分支有解析文件的逻辑,之后跟处理数据相似,所以我们把它略过,主要看前面的 if 分支。这部分的逻辑很清晰,主要完成的任务如下:

  • 遍历类方法的参数键值对
  • 根据原方法及参数对,创建新的方法名
  • 获取原方法的文档字符串
  • 对元组和列表类型的参数作解包
  • 在测试类上添加新的测试方法,并绑定参数与文档字符串

Python中如何将一个类方法变为多个方法

分析源码,可以看出,@data、@unpack 和 @file_data 这三个装饰器主要是设置属性并传参,而 @ddt 装饰器才是核心的处理逻辑。

这种将装饰器分散(分别加在类与类方法上),再组合使用的方案,很不优雅。为什么就不能统一起来使用呢?后面我们会分析它的难言之隐,先按下不表,看看其它的实现方案是怎样的?

2、parameterized 如何实现参数化?

先回顾一下上篇文章中 parameterized 库的写法:

import unittest
from parameterized import parameterized
class MyTest(unittest.TestCase):
  @parameterized.expand([(3,1), (-1,0), (1.5,1.0)])
  def test_values(self, first, second):
    self.assertTrue(first > second)

它提供了一个装饰器类 @parameterized,源码如下(版本 0.7.1),主要做了一些初始的校验和参数解析,并非我们关注的重点,略过。

Python中如何将一个类方法变为多个方法

我们主要关注这个装饰器类的 expand() 方法,它的文档注释中写到:

A "brute force" method of parameterizing test cases. Creates new test cases and injects them into the namespace that the wrapped function is being defined in. Useful for parameterizing tests in subclasses of 'UnitTest', where Nose test generators don't work.

关键的两个动作是:“creates new test cases(创建新的测试单元)”和“inject them into the namespace…(注入到原方法的命名空间)”。

关于第一点,它跟 ddt 是相似的,只是一些命名风格上的差异,以及参数的解析及绑定不同,不值得太关注。

Python中如何将一个类方法变为多个方法

最不同的则是,怎么令新的测试方法生效?

parameterized 使用的是一种“注入”的方式:

Python中如何将一个类方法变为多个方法

inspect 是个功能强大的标准库,在此用于获取程序调用栈的信息。前三句代码的目的是取出 f_locals,它的含义是“local namespace seen by this frame”,此处 f_locals 指的就是类的局部命名空间。

说到局部命名空间,你可能会想到 locals(),但是,我们之前有文章提到过“locals() 与 globals() 的读写问题”,locals() 是可读不可写的,所以这段代码才用了 f_locals。

3、pytest 如何实现参数化?

按惯例先看看上篇文章中的写法:

import pytest
@pytest.mark.parametrize("first,second", [(3,1), (-1,0), (1.5,1.0)])
def test_values(first, second):
  assert(first > second)

首先看到“mark”,pytest 里内置了一些标签,例如 parametrize、timeout、skipif、xfail、tryfirst、trylast 等,还支持用户自定义的标签,可以设置执行条件、分组筛选执行,以及修改原测试行为等等。

用法也是非常简单的,然而,其源码可复杂多了。我们这里只关注 parametrize,先看看核心的一段代码:

Python中如何将一个类方法变为多个方法

根据传入的参数对,它复制了原测试方法的调用信息,存入待调用的列表里。跟前面分析的两个库不同,它并没有在此创建新的测试方法,而是复用了已有的方法。在 parametrize() 所属的 Metafunc 类往上查找,可以追踪到 _calls 列表的使用位置:

Python中如何将一个类方法变为多个方法

最终是在 Function 类中执行:

Python中如何将一个类方法变为多个方法

好玩的是,在这里我们可以看到几行神注释……

Python中如何将一个类方法变为多个方法

阅读(粗浅涉猎) pytest 的源码,真的是自讨苦吃……不过,依稀大致可以看出,它在实现参数化时,使用的是生成器的方案,遍历一个参数则调用一次测试方法,而前面的 ddt 和 parameterized 则是一次性把所有参数解析完,生成 n 个新的测试方法,再交给测试框架去调度。

对比一下,前两个库的思路很清晰,而且由于其设计单纯是为了实现参数化,不像 pytest 有什么标记和过多的抽象设计,所以更易读易懂。前两个库发挥了 Python 的动态特性,设置类属性或者注入局部命名空间,而 pytest 倒像是从什么静态语言中借鉴的思路,略显笨拙。

4、最后小结

回到标题中的问题“如何将一个方法变为多个方法?”除了在参数化测试中,不知还有哪些场景会有此诉求?欢迎留言讨论。

本文分析了三个测试库的装饰器实现思路,通过阅读源码,我们可以发现它们各有千秋,这个发现本身还挺有意思。在使用装饰器时,表面看它们差异不大,但是真功夫的细节都隐藏在底下。

源码分析的意义在于探究其所以然,在这次探究之旅中,读者们可有什么收获啊?一起来聊聊吧!希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Python 相关文章推荐
Python MySQLdb Linux下安装笔记
May 09 Python
Python yield 使用浅析
May 28 Python
jupyter安装小结
Mar 13 Python
python smtplib模块自动收发邮件功能(二)
May 22 Python
Python3.6基于正则实现的计算器示例【无优化简单注释版】
Jun 14 Python
详谈Python 窗体(tkinter)表格数据(Treeview)
Oct 11 Python
如何更改 pandas dataframe 中两列的位置
Dec 27 Python
Python numpy多维数组实现原理详解
Mar 10 Python
pandas 强制类型转换 df.astype实例
Apr 09 Python
windows10在visual studio2019下配置使用openCV4.3.0
Jul 14 Python
python简单实现9宫格图片实例
Sep 03 Python
Pytorch之Tensor和Numpy之间的转换的实现方法
Sep 03 Python
pytorch 实现打印模型的参数值
Dec 30 #Python
Python如何基于smtplib发不同格式的邮件
Dec 30 #Python
pytorch获取模型某一层参数名及参数值方式
Dec 30 #Python
Python类反射机制使用实例解析
Dec 30 #Python
Python读取YAML文件过程详解
Dec 30 #Python
python通过nmap扫描在线设备并尝试AAA登录(实例代码)
Dec 30 #Python
pytorch中获取模型input/output shape实例
Dec 30 #Python
You might like
用PHP来计算某个目录大小的方法
2014/04/01 PHP
angular中使用路由和$location切换视图
2015/01/23 Javascript
JavaScript实现页面5秒后自动跳转的方法
2015/04/16 Javascript
jQuery插件kinMaxShow扩展效果用法实例
2015/05/04 Javascript
纯js代码实现未知宽高的元素在指定元素中垂直水平居中显示
2015/09/12 Javascript
jQuery easyui的validatebox校验规则扩展及easyui校验框validatebox用法
2016/01/18 Javascript
学习 NodeJS 第八天:Socket 通讯实例
2016/12/21 NodeJs
jQuery实现简易的输入框字数计数功能示例
2017/01/16 Javascript
jQuery Ajax前后端使用JSON进行交互示例
2017/03/17 Javascript
集成vue到jquery/bootstrap项目的方法
2018/02/10 jQuery
React之PureComponent的使用作用
2018/07/10 Javascript
微信小程序scroll-view实现字幕滚动
2018/07/14 Javascript
详解ES6系列之私有变量的实现
2018/11/21 Javascript
使用vue实现HTML页面生成图片的方法
2020/03/12 Javascript
Python中的面向对象编程详解(上)
2015/04/13 Python
使用Python判断质数(素数)的简单方法讲解
2016/05/05 Python
浅谈python中的实例方法、类方法和静态方法
2017/02/17 Python
Python中collections模块的基本使用教程
2018/12/07 Python
对Python+opencv将图片生成视频的实例详解
2019/01/08 Python
django 快速启动数据库客户端程序的方法示例
2019/08/16 Python
Tensorflow 多线程设置方式
2020/02/06 Python
python 数据库查询返回list或tuple实例
2020/05/15 Python
Python字典实现伪切片功能
2020/10/28 Python
HTML5使用DOM进行自定义控制示例代码
2013/06/08 HTML / CSS
购买澳大利亚最好的服装和内衣在线:BONDS
2016/10/14 全球购物
Sneaker Studio波兰:购买运动鞋
2018/04/28 全球购物
CK澳大利亚官网:Calvin Klein澳大利亚
2020/12/12 全球购物
凌阳科技股份有限公司C++程序员面试题笔试题
2014/11/20 面试题
我们没有写servlet的构造方法,那么容器是怎么创建servlet的实例呢
2013/04/24 面试题
《兰亭集序》教学反思
2014/02/11 职场文书
2014年党员个人剖析材料
2014/10/08 职场文书
公司开会通知
2015/04/20 职场文书
2015年教导处教学工作总结
2015/07/22 职场文书
如何理解Vue简单状态管理之store模式
2021/05/15 Vue.js
对Keras自带Loss Function的深入研究
2021/05/25 Python
MySQL连接查询你真的学会了吗?
2021/06/02 MySQL