doctest初次体验

测试代码放在两个地方才有效果，一个是模块开头，一个是函数声明语句的下一行

doctest 的概念模型

---

在python的官方文档中，对doctest是这样介绍的：

doctest模块会搜索那些看起来像是python交互式会话中的代码片段，然后尝试执行并验证结果。

从名字上是否会让你联想到docstring呢？

doctest的编写过程就像你在一个交互式shell中导入了一个被测试模块，然后一条一条执行被测试模块里面的函数一样。其实实际上doctest也是这么编写的，写好一个模块之后，在shell中测试这个模块里面的函数，将shell会话中的内容复制粘贴成doctest用例。

 

测试代码验证：unnecessary_math.py

'''
这个例子展示如何在源码中嵌入doctest用例。
'>>>' 开头的行就是doctest测试用例。
不带 '>>>' 的行就是测试用例的输出。
如果实际运行的结果与期望的结果不一致，就标记为测试失败。
'''
def multiply(a, b):
    """
    >>> multiply(4, 3)
    12
    >>> multiply('a', 3)
    'aaa'
    """
    return a * b
if __name__=='__main__':
    import doctest
    doctest.testmod(verbose=True)

然后在命令行中定位到文件所在目录，运行python -m doctest -v unnecessary_math.py即可。

其中参数-v表示打印细节，去除后如果没有发现错误，则什么都不显示

测试结果如下：