doctest 从字面意思上看，那就是文档测试。doctest 是 python里面自带的一个模块，它实际上是单元测试的一种。
官方解释：doctest 模块会搜索那些看起来像交互式会话的 Python 代码片段，然后尝试执行并验证结果
doctest 测试用例可以放在两个地方
函数戒者方法下的注释里面
模块的开头
案例
先看第一个案例，将需要测试的片段,标准格式，需要运行的代码前面加>>> ,相当于进入 cmd 这种交互环境执行，期望的结果前面不需要加>>>
运行结果
Trying:
multiply(4, 3)
Expecting:
12
ok
Trying:
multiply('a', 3)
Expecting:
'aaa'
ok
1 items had no tests:
__main__
1 items passed all tests:
2 tests in __main__.multiply
2 tests in 2 items.
2 passed and 0 failed.
Test passed.
从运行的结果可以看出，虽然函数下方的注释里面有其它内容“fuction: 两个数相乘”，但不会去执行，只识别“>>>”这种符号。
2 个测试用例都是通过的，实际的结果与期望的结果一致。
def mutiply(a, b):
'''
fuction: 两个数相乘
>>> mutiply(4, 3)
12
>>> mutiply('a', 3)
'aaa'
'''
return a * b
if __name__=='__main__':
import doctest
doctest.testmod(verbose=True)
失败案例
doctest 的内容放到.py 模块的开头也是可以识别到的
'''
fuction: 两个数相乘
>>> mutiply(4, 8)
12
>>> mutiply('a', 5)
'aaa'
'''
def mutiply(a, b):
'''
fuction: 两个数相乘
'''
return a * b
if __name__=='__main__':
import doctest
doctest.testmod(verbose=True)
verbose 参数，设置为 True 则在执行测试的时候会输出详细信息
cmd 执行
以上案例是在编辑器直接运行的，如果在 cmd 里面，也可以用指令去执行
> python -m doctest -v xxx.py
m 参数指定运行方式 doctest
-v 参数是 verbose，带上-v 参数相当于 verbose=True
pytest 运行
pytest 框架是可以兼容 doctest 用例，执行的时候加个参数 —doctest-modules ,这样它就能自动搜索到 doctest 的用例
> pytest -v --doctest-modules xxx.py
文档里面的每一行都会被执行，当遇到测试不通过的用例时，就不会继续往下执行了
doctest 独立文件
doctest 内容也可以呾代码抽离开，单独用一个.txt 文件保存
在当前 xxx.py 同一目录新建一个 xxx.txt 文件，写入测试的文档，要先导入该功能，导入代码前面也要加>>>
>>> from xxx import multiply
>>> multiply(4, 3)
12
>>> multiply('a', 3)
'aaa'
cmd 执行“python -m doctest -v xxx.txt”测试结果
