pytest

参考链接：安装和入门 — pytest documentation

一、关于pytest

0.安装

pip install -U pytest 或者 在pycharm中安装pytest

 -u代表如果安装了升级到最新版

查看版本

pytest --version

1.关于pytest

        按照一定顺序执行文件和类、方法（（小写英文--->大写英文--->0-9数字））

• 测试文件以test_开头（以_test结尾也可以）
• 测试类以Test开头，并且不能带有 init 方法
• 测试函数以test_开头
• 断言使用基本的assert即可

2.运行方式

运行一个方法（pycharm点击方法或者类前面的运行按钮，选择pytest run。。。）

1）通过主函数启动，可以在运行的文件中写主函数，像这样

        主函数启动需要引入pytest包，不然找不到pytest方法）

import pytest
class TestClass:
    def test_one(self):
        x = 'this'
        assert 'h' in x
    def test_two(self):
        x = 'hello'
        assert hasattr(x, 'check')
if __name__ == '__main__':
#    pytest.main()
    pytest.main('test_study.py')

pytest.main()会自动读取当前目录下的所有test开头的.py文件，运行test方法或者类

可以传入不同的参数，让运行更加定制化

pytest.main(['./'])               # 运行./目录下所有（test_*.py  和 *_test.py）
pytest.main (['./subpath1'])    # 运行./subpath1 目录下用例
pytest.main (['./subpath1/test_module1.py'])    # 运行指定模块
pytest.main (['./subpath1/test_module1.py::test_m1_1'])  # 运行模块中的指定用例
pytest.main (['./subpath2/test_module2.py::TestM2::test_m2_02'])  # 运行类中的指定用例
pytest.main (['-k','pp'])         # 匹配包含pp的用例(匹配目录名、模块名、类名、用例名)
pytest.main(['-k','spec','./subpath1/test_module1.py'])     # 匹配test_module1.py模块下包含spec的用例
pytest.main(['-k','pp','./subpath2/test_module2.py::TestM2'])   # 匹配TestM2类中包含pp的用例

值得注意的一点，如果main中传入的参数没生效，右键运行的时候，默认运行了当前文件的所有用例，这是因为程序识别到了pytest框架，默认pytest运行，要main主函数运行，需要修改陈python解释器

第一步：编辑解释器

第二步：如果列表中没有python解释器，新增一个python解释器，选择要执行的文件

第三步：确定后，查看右上角运行，变为了普通运行，这时候运行文件会运行main函数 

 

另外一种 ：可以直接在控制台使用python xx.py      指定用python解释器运行main主函数

再另外一种： python -m pytest 调用pytest框架

2)通过控制台启动（推荐）

选择pycharm>terminal

• pytest test_mod.py 执行该模块下的测试类测试方法
• pytest testing 执行该文件夹下的所有模块
• pytest test_cgi.py::test_answer，执行test_answer方法
• pytest test_cgi.py::TestMyClass::test_one，执行TestMyClass类下的test_one方法产
• 查看详细的输出：-r随意拼接下方字符 例如-rfp  -fa (展示全部的用例情况）pytest -ra study.py
  • -x 用例一旦失败，就立刻停止执行
  • --maxfile=num 用例达到多少停止执行
  • -m 标记用例
  • -k 执行包含某个关键字的测试用例
  • -v 打印详细日志
  • -s 打印输出日志 和v连用
  • --lf 只重新运行失败的用例
  • --ff 先运行失败的用例再运行正常的用例

3.查看详细情况

        通过-vv查看每个用例通过的时长和详细情况

        pytest -vv test_study.py

        获取长度超过1s的最慢10个测试用例持续时间的列表

        pytest --durations=10 --durations-min=1.0 -vv test_study.py

4.断言  

pytest 允许您使用标准的python assert 用于验证Python测试中的期望和值，pytest 支持显示最常见的子表达式的值

def f():
    return 3
def test_function():
    assert f() == 4

5.套件

# -*-coding:utf-8-*-
import pytest
# module一个模块只会执行一次，最开头和最结尾调用
def setup_module():
    print('每个模块执行一次 开始')
def teardown_module():
    print('每个模块执行一次 结束')
# function 每个用例执行一次，不会对类中的用例生效
def setup_function():
    print('每个类外用例前执行')
def teardown_function():
    print('每个类外用例后执行')
def test_case2():
    print('2')
class TestDemo:
    def setup_class(self):
        print('当前类之前执行')
    def teardown_class(self):
        print('当前类之后执行')
    def setup(self):
        print('类里的每个方法调用  前')
    def teardown(self):
        print('类里的每个方法调用  后')
    def test_case3(self):
        print('我是测试用例')

6.装饰器（常用）

        skip  ： 跳过这个用例  reason是解释

# 跳过这个用例skip装饰器
@pytest.mark.skip(reason = '暂时不执行')
def test_case5():
    print('test5')
def test_case6():
    return  4
# 可以在用例里面做判断，判断结果为真跳过这条用例
def test_case7():
    if 4 == test_case6():
        pytest.skip('跳过原因case6等于4')
    print('case7')
# 可以直接在外面做判断skipif
@pytest.mark.skipif(test_case6() == 4 ,reason='跳过因为是windows系统')
def test_case8():
    print('case8')

        装饰器都已pytest.mark开头，可以自定义装饰器，相当于分组

        运行pytest xx.py -m group2  

        运行所有带有这个装饰器的用例，没有则显示为 deselected

@pytest.mark.group2
def test_case4():
    print('test4')

7.ini配置文件

      它是一个固定的文件pytest.ini文件，读取配置信息，按指定的方式去运行。pytest.ini的位置：一般放在项目工程的根目录（即当前项目的顶级文件夹下）

        注意ini中最好不要写入中文，运行 会报错'gbk' codec can't decode byte 0x80 in position 92: illegal multibyte sequence
        

        配置项解释：

        1)    markers： 默认分组，将标记的用例加入自定义分组，添加到ini中，启动后将忽略非自定义分组带来的warnings

        

        

        运行：pytest run.py -m group1

        

         2) addopts：可以添加指定的OPTS命令行参数集,在执行命令时,不用再每次都输入长串命令

                 addopts：-p no：warning  （忽略warning）

8.读取yaml文件

# 直接读出来是字典
    def read_y(self):
        last_filename = 'yamlfile/' + self.filename+'.yaml'
        print(last_filename)
        f = yaml.safe_load(open(last_filename,encoding='utf-8'))
        print(f)
        print(type(f))
        return f

对应的yaml文件数据长这样：

读取出来的数据为： {'TEST': {'TEST_HOST': '127.0.0.1'}, 'ZS': {'ZS_HOST': '251.214.32.21'}}

 如果想要传入一个列表到用例中，需要在TEST和ZS前面加上-

读取出来的数据为： [{'TEST': None, 'TEST_HOST': '127.0.0.1'}, {'ZS': None, 'ZS_HOST': '251.214.32.21'}]

 装饰器传入数据的时候必须是个列表，才能按照列表下标传入数据,列表中有几个数据，测试用例有几条

    # 传入的argnames必须是列表，yaml文件在key前加上- 读取为列表，不然会自动读取字典的key；
    # 传入一个值
    @pytest.mark.parametrize(('env'),yaml.safe_load(open('./env.yml')))
    def test_demo(self,env):
        print(env)
    def test_read_yaml(self):
        a = yaml.safe_load(open('./env.yml'))
        print(type(a),a)
    # 传入多个值
    @pytest.mark.parametrize('user, pwd', [('root', '123'), ('admin', '456')])
    def test_03(self,user, pwd):
        print(user,pwd)

二、allure

0.安装java1.8

1、安装alluer+ allure-pytest

        1）下载allure 的zip包，下载后放到python文件夹lib下        

        2）进入allure 的bin目录下，复制路径，放到path环境变量

        3）安装alluer-pytest

                pip install allure-pytest

 2、生成报告（terminal）

        1）terminal启动用例，指定数据存在什么文件夹下（目前是存在当前文件夹下的tmp文件夹）

        pytest --alluredir=tmp test_study.py

        2）查看报告

               2.1) 直接打开生成数据图表：allure serve 生成数据文件目录

                注意：如果直接在pycharm中启动命令行，需要定位到allure.bat的详细位置

                D:\python\Lib\allure-2.9.0\bin\ allure serve 生成的数据文件路径

                2.2)生成一个文件夹，存储html，进入report打开html查看报告

                D:\python\Lib\allure-2.9.0\bin\allure generate 生成的数据文件路径 -o html的路径 --clean

3、生成报告（main）

if __name__=='__main__':
# --alluredir  生成allure报告需要的数据文件
    pytest.main(['test_study.py','-s', '--alluredir=tmp'])
# allure generate 生成allure测试报告默认生成一个文件夹allure-result； --clean保证每一次生成的html是最新的数据
    os.system('allure generate tmp --clean')