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表示打印细节，去除后如果没有发现错误，则什么都不显示

测试结果如下：