9、pytest -- 集成文档测试

1. 集成doctest模块

doctest是python内置的一个标准库，它可以查找代码中类似交互式会话形式的注释，并检查它们是否正确；

1.1. 通过指定文本文件的方式

默认情况下，pytest会自动收集所有名称匹配test*.txt规则的文件，并调用doctest执行它们；

下面，我们来看一个简单的例子：

# src/chapter-9/test_example.txt

>>> x = 3
>>> x
3

直接使用pytest命令就可以执行它：

λ pipenv run pytest src/chapter-9/test_example.txt
====================== test session starts ======================= 
platform win32 -- Python 3.7.3, pytest-5.1.3, py-1.8.0, pluggy-0.13.0
rootdir: D:\Personal Files\Projects\pytest-chinese-doc
collected 1 item

src\chapter-9\test_example.txt .                            [100%]

======================= 1 passed in 0.03s ========================

我们也可以使用命令行选项--doctest-glob添加文件名称的匹配规则；

例如，匹配rst格式的文件：

pytest --doct