python单元测试框架pytest简介

发表于:2017-11-13来源:CSDN作者:liuchunming033点击数: 标签:python
pytest是python的一种单元测试框架,与python自带的unittest测试框架类似,但是比unittest框架使用起来更简洁,效率更高。根据pytest的官方网站介绍,它具有如下特点:

1、Pytest介绍

pytest是python的一种单元测试框架,与python自带的unittest测试框架类似,但是比unittest框架使用起来更简洁,效率更高。根据pytest的官方网站介绍,它具有如下特点:

 

  • 非常容易上手,入门简单,文档丰富,文档中有很多实例可以参考
  • 能够支持简单的单元测试和复杂的功能测试
  • 支持参数化
  • 执行测试过程中可以将某些测试跳过,或者对某些预期失败的case标记成失败
  • 支持重复执行失败的case
  • 支持运行由nose, unittest编写的测试case
  • 具有很多第三方插件,并且可以自定义扩展
  • 方便的和持续集成工具集成
由于网上pytest的中文文档比较少,自己学习过程中,基本上看的就是英文的官方文档,对于不想看英文的同学们,本系列文章希望能够帮大家一马。
 

2、安装pytest

与安装其他的python软件无异,直接使用pip安装。
[python] view plain copy
 
  1. pip install -U pytest  
安装完成后,可以验证安装的版本:
[python] view plain copy
 
  1. py.test --version  

3、一个实例

我们可以通过下面的实例,看看使用py.test进行测试是多么简单。
[python] view plain copy
 
  1. # content of test_sample.py  
  2.   
  3. def func(x):  
  4.     return x+1  
  5.   
  6. def test_func():  
  7.     assert func(3) == 5  
这里我们定义了一个被测试函数func,该函数将传递进来的参数加1后返回。我们还定义了一个测试函数test_func用来对func进行测试。test_func中我们使用基本的断言语句assert来对结果进行验证。
下面来运行这个测试:
[python] view plain copy
 
  1. $ py.test  
  2. =========================== test session starts ============================  
  3. platform linux -- Python 3.4.1 -- py-1.4.27 -- pytest-2.7.1  
  4. rootdir: /tmp/doc-exec-101, inifile:  
  5. collected 1 items  
  6. test_sample.py F  
  7. ================================= FAILURES =================================  
  8. _______________________________ test_answer ________________________________  
  9. def test_answer():  
  10. assert func(3) == 5  
  11. assert 4 == 5  
  12. E + where 4 = func(3)  
  13. test_sample.py:5: AssertionError  
  14. ========================= 1 failed in 0.01 seconds =========================  
执行测试的时候,我们只需要在测试文件test_sample所在的目录下,运行py.test即可。pytest会在当前的目录下,寻找以test开头的文件(即测试文件),找到测试文件之后,进入到测试文件中寻找test_开头的测试函数并执行。
通过上面的测试输出,我们可以看到该测试过程中,一个收集到了一个测试函数,测试结果是失败的(标记为F),并且在FAILURES部分输出了详细的错误信息,帮助我们分析测试原因,我们可以看到"assert func(3) == 5"这条语句出错了,错误的原因是func(3)=4,然后我们断言func(3) 等于 5。
 

4、再一个实例

当需要编写多个测试样例的时候,我们可以将其放到一个测试类当中,如:
[python] view plain copy
 
  1. # content of test_class.py  
  2.   
  3. class TestClass:  
  4.     def test_one(self):  
  5.         x = "this"  
  6.         assert 'h' in x  
  7.   
  8.     def test_two(self):  
  9.         x = "hello"  
  10.         assert hasattr(x, 'check')  
我们可以通过执行测试文件的方法,执行上面的测试:
[python] view plain copy
 
  1. $ py.test -q test_class.py  
  2. .F  
  3. ================================= FAILURES =================================  
  4. ____________________________ TestClass.test_two ____________________________  
  5. self = <test_class.TestClass object at 0x7fbf54cf5668>  
  6. def test_two(self):  
  7. x = "hello"  
  8. assert hasattr(x, 'check')  
  9. assert hasattr('hello''check')  
  10. test_class.py:8: AssertionError  
  11. 1 failed, 1 passed in 0.01 seconds  
从测试结果中可以看到,该测试共执行了两个测试样例,一个失败一个成功。同样,我们也看到失败样例的详细信息,和执行过程中的中间结果。

5、如何编写pytest测试样例

通过上面2个实例,我们发现编写pytest测试样例非常简单,只需要按照下面的规则:
  • 测试文件以test_开头(以_test结尾也可以)
  • 测试类以Test开头,并且不能带有 __init__ 方法
  • 测试函数以test_开头
  • 断言使用基本的assert即可

6、如何执行pytest测试样例

执行测试样例的方法很多种,上面第一个实例是直接执行py.test,第二个实例是传递了测试文件给py.test。其实py.test有好多种方法执行测试:
[python] view plain copy
 
  1. py.test               # run all tests below current dir  
  2. py.test test_mod.py   # run tests in module  
  3. py.test somepath      # run all tests below somepath  
  4. py.test -k stringexpr # only run tests with names that match the  
  5.                       # the "string expression", e.g. "MyClass and not method"  
  6.                       # will select TestMyClass.test_something  
  7.                       # but not TestMyClass.test_method_simple  
  8. py.test test_mod.py::test_func # only run tests that match the "node ID",  
  9.                    # e.g "test_mod.py::test_func" will select  
  10.                                # only test_func in test_mod.py  

7、测试报告

pytest可以方便的生成测试报告,即可以生成HTML的测试报告,也可以生成XML格式的测试报告用来与持续集成工具集成。

生成HTML格式报告:

 

[python] view plain copy
 
  1. py.test --resultlog=path  
生成XML格式的报告:

 

 

[python] view plain copy
 
  1. py.test --junitxml=path  

 

8、如何获取帮助信息

[python] view plain copy
 
  1. py.test --version # shows where pytest was imported from  
  2. py.test --fixtures # show available builtin function arguments  
  3. py.test -h | --help # show help on command line and config file options  

9、最佳实践

其实对于测试而言,特别是在持续集成环境中,我们的所有测试最好是在虚拟环境中。这样不同的虚拟环境中的测试不会相互干扰的。
由于我们的实际工作中,在同一个Jekins中,运行了好多种不同项目册的测试,因此,各个测试项目运行在各自的虚拟环境中。
将pytest安装在虚拟环境中:
1、将当前目录创建为虚拟环境
[python] view plain copy
 
  1. virtualenv .        # create a virtualenv directory in the current directory  
  2. source bin/activate # on unix  
2、在虚拟环境中安装pytest:
[python] view plain copy
 
  1. pip install pytest  
  2.  

原文转自:http://blog.csdn.net/liuchunming033/article/details/46501653