安装 pytest
- 在命令行中运行以下命令:
pip install -U pytest
- 检查当前安装的版本:
pytest --version
创建你的第一个测试
创建一个简单的只有四行的测试方法
# content of test_sample.py
def func(x):
return x + 1
def test_answer():
assert func(3) == 5
就是这样. 现在你可以执行这个测试方法了.
$ pytest
=========================== test session starts ============================
platform linux -- Python 3.x.y, pytest-3.x.y, py-1.x.y, pluggy-0.x.y
rootdir: $REGENDOC_TMPDIR, inifile:
collected 1 item
test_sample.py F [100%]
================================= FAILURES =================================
_______________________________ test_answer ________________________________
def test_answer():
> assert func(3) == 5
E assert 4 == 5
E + where 4 = func(3)
test_sample.py:5: AssertionError
========================= 1 failed in 0.12 seconds =========================
这里测试返回了一个错误报告, 因为func(3)
不能返回 5.
Note: 你可以使用`assert`声明验证测试预期. pytest的高级断言内省将会
智能地报告assert表达式的中间值,这样您就可以避免JUnit遗留的许多名称
方法
运行多个测试
pytest将会运行当前文件夹及其子文件夹中所有 test_.py* 及*_test.py格式的测试. 更普遍的, 请参阅 standard test discovery rules.
断言引发了某个异常
断言一些代码引发异常通过使用raise
这一助手
# content of test_sysexit.py
import pytest
def f():
raise SystemExit(1)
def test_mytest():
with pytest.raises(SystemExit):
f()
通过安静报告模式执行测试功能
$ pytest -q test_sysexit.py
. [100%]
1 passed in 0.12 seconds
在一个类中运行多个测试用例
你也许想要将一次开发的多个测试用例放到一个类里. pytest使创建一个类来控制超过一个测试用例变得很简单:
# content of test_class.py
class TestClass(object):
def test_one(self):
x = 'this'
assert 'h' in x
def test_two(self):
x = 'hello'
assert hasattr(x, 'check')
pytest 遵循Python测试发现约定来发现所有测试用例, 因此它会找到所有test_
开头的方法. 这里不需要子类化任何东西. 我们能够简单的通过传递??槲募丛诵心??
$ pytest -q test_class.py
.F [100%]
================================= FAILURES =================================
____________________________ TestClass.test_two ____________________________
self = <test_class.TestClass object at 0xdeadbeef>
def test_two(self):
x = "hello"
> assert hasattr(x, 'check')
E AssertionError: assert False
E + where False = hasattr('hello', 'check')
test_class.py:8: AssertionError
1 failed, 1 passed in 0.12 seconds
第一个用例是'Passed', 第二个是'Failed'. 你能够很容易的看到断言中的中间值来帮助你理解失败的原因.
为功能测试请求一个唯一的临时目录
# content of test_tmpdir.py
def test_needsfiles(tmpdir):
print(tmpdir)
assert 0
在测试函数签名中列出名称tmpdir, pytest将查找并调用一个fixture工厂来创建
执行测试函数调用之前的资源.Pytest 创建一个唯一的每个测试调用的临时目录:
$ pytest -q test_tmpdir.py
F [100%]
================================= FAILURES =================================
_____________________________ test_needsfiles ______________________________
tmpdir = local('PYTEST_TMPDIR/test_needsfiles0')
def test_needsfiles(tmpdir):
print (tmpdir)
> assert 0
E assert 0
test_tmpdir.py:3: AssertionError
--------------------------- Captured stdout call ---------------------------
PYTEST_TMPDIR/test_needsfiles0
1 failed in 0.12 seconds
更多关于临时文件的处理请参阅Temporary directories and files
pytest --fixtures # 显示内置和自定义装置