pytest介绍

pytest是一个非常成熟的全功能的Python测试框架，主要特点有以下几点：

1、简单灵活，容易上手，文档丰富；

2、支持参数化，可以细粒度地控制要测试的测试用例；

3、能够支持简单的单元测试和复杂的功能测试，还可以用来做selenium/appnium等自动化测试、接口自动化测试（pytest+requests）;

4、pytest具有很多第三方插件，并且可以自定义扩展

• 如pytest-selenium（集成selenium）、
• pytest-html（完美html测试报告生成）、
• pytest-rerunfailures（失败case重复执行）、
• pytest-xdist（多CPU分发）、
• pytest--ordering（控制测试运行的顺序）
   

5、测试用例的skip和xfail处理；

6、可以很好的和CI工具结合，例如jenkins

编写规则：

• 测试文件以test_开头（以_test结尾也可以）
• 测试类以Test开头，并且不能带有 init 方法
• 测试函数以test_开头
   

断言使用基本的assert即可

快速示例

test_pyexample.py

import pytest

class TestClass:
    def test_one(self):
      x = "this"
      assert 'h' in x

    def test_two(self):
      x = "hello"
      assert hasattr(x, 'check')

    def test_three(self):
      a = "hello"
      b = "hello world"
      assert a in b

通过命令行运行：

1、cd 到代码所在的目录，执行命令：py.test test_pyexample.py

2、安装pytest-sugar插件可以看到进度条

Pycharm配置运行：

1.file->Setting->Tools->Python Integrated Tools->项目名称->Default test runner->选择py.test

import pytest

class TestClass:
    def test_one(self):
      x = "this"
      assert 'h' in x

    def test_two(self):
      x = "hello"
      assert hasattr(x, 'check')

    def test_three(self):
      a = "hello"
      b = "hello world"
      assert a in b

if __name__ == "__main__":
  pytest.main('-q test_class.py')

Console常用参数介绍：

• -v 用于显示每个测试函数的执行结果
• -q 只显示整体测试结果
• -s 用于显示测试函数中print()函数输出
• -x, --exitfirst, exit instantly on first error or failed test
• -m 只运行带有装饰器配置的测试用例
• -h 帮助

py.test # run all tests below current dir
py.test test_mod.py # run tests in module file test_mod.py
py.test somepath # run all tests below somepath like ./tests/
py.test -k stringexpr # only run tests with names that match the
# the "string expression", e.g. "MyClass and not method"
# will select TestMyClass.test_something
# but not TestMyClass.test_method_simple
py.test test_mod.py::test_func # only run tests that match the "node ID",
# e.g "test_mod.py::test_func" will be selected
# only run test_func in test_mod.py

pytest参数化

使用装饰器:@pytest.mark.parametrize()

单个参数：

import pytest
import random
@pytest.mark.parametrize('x',[(1),(2),(6)])
def test_add(x):
  print(x)
  assert x==random.randrange(1,7)

多个参数：

import pytest
@pytest.mark.parametrize('x,y',[
  (1+2,3),
  (2-0,1),
  (6*2,12),
  (10*2,3),
  ("test","test"),
])
def test_add(x,y):  #必须与上面保持一致，只能用x,y不能用其他字母
  assert x==y

控制测试运行顺序

安装pytest-ordering

pip install pytest-ordering

借助于装饰器@pytest.mark.run(order=1)控制测试运行的顺序

import pytest
import time
value=0
@pytest.mark.run(order=2) #后执行order=2
def test_add2():
  print("I am 2")
  time.sleep(2)
  assert value==10
@pytest.mark.run(order=1)  #先执行order=1
def test_add():
  print("I am add")
  global value
  value=10
  assert value==10

运行后生成测试报告（htmlReport）

安装pytest-html：

pip install -U pytest-html

如何使用：

py.test test_pyexample.py --html=report.html

更详细的测试报告

安装 pytest-cov：

pip install pytest-cov

如何使用

py.test --cov-report=html --cov=./ test_code_target_dir
Console参数介绍
--cov=[path], measure coverage for filesystem path (multi-allowed), 指定被测试对象，用于计算测试覆盖率
--cov-report=type, type of report to generate: term, term-missing, annotate, html, xml (multi-allowed), 测试报告的类型
--cov-config=path, config file for coverage, default: .coveragerc, coverage配置文件
--no-cov-on-fail, do not report coverage if test run fails, default: False，如果测试失败，不生成测试报告
--cov-fail-under=MIN, Fail if the total coverage is less than MIN. 如果测试覆盖率低于MIN，则认为失败

多进程运行

安装pytest-xdist：

pip install -U pytest-xdist

如何使用：

py.test test_pyexample.py -n NUM

其中NUM填写并发的进程数。

重新运行失败的用例

安装pytest- rerunfailures:

import random
def add(x,y):
  return x+y
def test_add():
  random_value=random.randint(2,7)
  print('random_value:'+str(random_value))
  assert add(1,3)==random_value

如何使用：

命令：pytest --reruns 重试次数

　　比如：pytest --reruns 3　　表示：运行失败的用例可以重新运行3次

命令：pytest --reruns 重试次数 --reruns-delay 次数之间的延时设置（单位：秒）

　　比如：pytest --reruns 3 --reruns-delay 5　　表示：（译：瑞软四、地类）运行失败的用例可以重新运行3次，第一次和第二次的间隔时间为5秒钟

另外也可以通过装饰器的方式配置：

@pytest.mark.flaky(reruns=3, reruns_delay=5)