看到Python的官方文档,很多都有示例代码,比如re模块就带了很多示例代码:
>>> import re >>> m = re.search('(?<=abc)def', 'abcdef') >>> m.group(0) 'def'
可以把示例代码在Python的交互式环境下输入执行,结果与文档的示例代码显示的一致。
当我们编写注释,写上下面的注释更友好:
def abs(n): ''' Function to get absolute value of number. Example: >>> abs(1) 1 >>> abs(-1) 1 >>>abs(0) 0 ''' return n if n >= 0 else (-n)
好处:
•告诉函数的调用者该函数期望输入和输出
•Python内置的“文档测试”(doctest)模块可以直接提取注释中的代码并执行测试
•doctest 严格按照Python交互式命令行的输入和输出判断测试结果是否正确,只有测试异常的时候,可以用...表示一大推输出
以上就是使用python中文档测试的详解和优点,看完的小伙伴赶紧动手尝试吧~更多Python学习推荐:PyThon学习网教学中心。