Pytest之收集用例及命令行参数

以下主要介绍：Pytest的用例收集规则及命令行参数详解。

用例收集

 

用例收集规则

• 从一个或者多个目录开始查找，你可以在命令行指定文件或者目录，如果未指定那么从当前目录开始收集用例;

• 在该目录和所有子目录下递归查找测试模块;

• 测试模块是指文件名为test_*.py或者*_test.py的文件;

• 在测试模块中查找以test_开头的函数;

• 查找名字以Test开头的类。其中首先筛选掉包含__init__()函数的类，再查找类中以test_开头的类方法。

 

 运行收集的用例

现有项目结构如下：

具体代码：

login/test_login.py

class TestLogin:
    def test_demo01(self):
        a = 1
        assert a == 1
    def add(self):
        b = 1
        c = 2
        assert b + c == 3

pay/test_pay.py

def test_pay():
    name = "vivi"
    assert "v" in name

 

test_demo.py

def test_demo02():
    print("这是demo02")
    a = 1
    assert a == 1

 

 

运行测试用例

切换到项目路径，在命令行输入：pytest -v

输出结果为：

根据用例收集规则，TestLogin类中add方法不是以test开头，所以pytest不会收集。

 

命令行参数

查看命令行参数

命令行模式下，输入：pytest --help

说明：出现详细的命令行参数。

命令行参数详解

① pytest -v

说明：可以输出用例更加详细的执行信息，比如用例所在的文件及用例名称等。

② pytest -s

说明：输出用例中的调式信息，比如print的打印信息等。

test_demo.py

def test_demo02():
    print("这是demo02")
    a = 1
    assert a == 1

命令行输入：pytest -s test_demo.py

③pytest -m

说明：用于标记测试并分组，执行特定的测试用例。

这个在后续打标记文章详细解释，此处暂不介绍。 

 

④pytest -k

说明：可以通过表达式运行指定的测试用例。

比如使用命令：pytest -k "test_demo01 or test_demo02"，就会指定运行test_demo01和test_demo02两条用例。

⑤pytest -q

说明：简化输出信息。

 

⑥pytest -x

说明：遇到错误或者用例不通过，则退出执行。

手动将login/test_login.py中的用例改成不通过。

 

输入命令：pytest -v -x

收集用例3个，但第二个test_demo01用例执行失败，就会全局停止执行，所以第三个用例将不会执行。

 

⑦pytest --lf

说明：--last-failed 只重新运行上次运行失败的用例(或如果没有失败的话会全部跑)。

命令行输入: pytest -v --lf

通过运行结果看出，本次用例只是运行了上次运行错误的测试用例test_demo01。

 

⑧pytest --ff

说明：--failed-first，先执行完上次失败的测试后，再执行上次正常的测试用例。

输入命令：pytest -v --ff

通过运行结果看出，本次运行，先运行了上次失败的用例，然后执行正常的测试用例。

 

⑨pytest --maxfail=num

说明：用例运行时，允许的最大失败次数，超过则立即停止执行。

输入命令：pytest -v --maxfail=2

 

⑩ 运行指定用例

模块、类、函数及方法之间用::进行分割。

 

我们先看下之前运行的结果图。

 

比如想运行TestLogin类下的测试用例。

使用命令：pytest -v login/test_login.py::TestLogin