捕获标准输出及标准错误输出
默认 stdout/stderr/stdin 捕获行为
在测试执行期间,程序中的标准输出/标准错误输出都会被捕获到。 如果测试或setup方法执行失败时,会在报错追溯信息中查看到程序中的标准输出及标准错误输出。(可以通过--show-capture命令行选项配置是否捕获程序中的标准输出/标准错误输出)。
此外,stdin被设置为“null”对象,测试运行过程中无法从中读取数据,因为在运行自动化测试时很少需要等待交互式输入。
捕获默认是通过拦截对低优先级文件描述符的写入来完成的。 这允许捕获简单print语句的输出以及测试启动的子进程的输出。
设置捕获方法或禁用捕获
pytest可以通过两种方式捕获输出：
- 文件描述符(FD)级别捕获(默认)：将捕获进入操作系统文件描述符1和2的所有写入。
-
sys级别捕获：仅捕获Python文件sys.stdout和sys.stderr。 不执行对文件描述符的写入捕获。
你可以在命令行中指定不同的参数来使用不同的捕获机制：
pytest -s # 禁止捕获所有输出
pytest --capture=sys # 使用in-mem文件代替sys.stdout/stderr with
pytest --capture=fd # 同时将filedescriptors 1和2指向临时文件
调试中使用print语句
默认捕获stdout / stderr输出的一个主要好处是可以使用print语句进行调试：
# test_module.py文件内容
def setup_function(function):
print("setting up %s" % function)
def test_func1():
assert True
def test_func2():
assert False
运行此模块将只捕获失败用例相关的print信息,而不显示成功用例的print信息：
$ pytest
=========================== test session starts ============================
platform linux -- Python 3.x.y,pytest-4.x.y,py-1.x.y,pluggy-0.x.y
rootdir: $REGENDOC_TMPDIR,inifile:
collected 2 items
test_module.py .F [100%]
================================= FAILURES =================================
________________________________ test_func2 ________________________________
def test_func2():
> assert False
E assert False
test_module.py:9: AssertionError
-------------------------- Captured stdout setup ---------------------------
setting up <function test_func2 at 0xdeadbeef>
==================== 1 failed,1 passed in 0.12 seconds ====================
在测试用例中使用的捕获的输出
capsys,capsysbinary,capfd和capfdbinary fixture允许访问在测试执行期间创建的stdout / stderr输出。 下面是一个测试函数示例,它执行一些与输出相关的检查：
def test_myoutput(capsys): # or use "capfd" for fd-level
print("hello")
sys.stderr.write("world\n")
captured = capsys.readouterr()
assert captured.out == "hello\n"
assert captured.err == "world\n"
print("next")
captured = capsys.readouterr()
assert captured.out == "next\n"
readouterr()调用时首先对输出流建立快照 - 并继续捕获输出,然后在该测试用例执行完成后,恢复原始输出流。而通过使用capsys可以避免在执行每个测试用例时都进行一次设置/重置输出流,并且还可以与pytest每次测试用例执行时捕获的输出信息进行交互。
如果要在filedescriptor级别捕获,可以使用capfd fixture,它提供完全相同的接口,但也允许捕获直接写入操作系统级输出流(FD1和FD2)的库或子进程的输出流中。
3.3版本新函数readouterr的返回值更改为具有两个属性out和err的namedtuple。
3.3版本新函数
如果测试中的代码写入了非文本数据,则可以使用capsysbinary fixture来捕获它,而后者会从readouterr方法返回字节。 capfsysbinary fixture目前仅在Python 3中可用。
3.0版本新函数
要暂时禁用测试中的捕获,capsys和capfd都有一个disabled()方法,可以用作上下文管理器,禁用with块内的捕获：
def test_disabling_capturing(capsys):
print("输出被捕获到了")
with capsys.disabled():
print("输出未捕获到,直接使用sys.stdout标准输出")
print("这个输出也被捕获到了")