使用Sphinx扩展自动生成doctest输出
本教程将介绍使用Sphinx扩展自动生成doctest输出的处理方法,这篇教程是从别的地方看到的,然后加了一些国外程序员的疑问与解答,希望能对你有所帮助,好了,下面开始学习吧。
问题描述
我想我漏掉了有关doctest的狮身人面像扩展的某些内容。
文档中的典型示例是:
.. doctest::
>>> print 1
1
有什么办法让Shinx自动生成输出(此处:1
)?
据我所知,可以运行:
$ make doctest
它可以测试代码片段,并将实际输出与预期输出进行比较。例如,如果您有
.. doctest::
>>> print 1
3
doctest将警告您,它在预期3
时获得了1
。
相反,我希望Shinx将实际输出单独插入到我的文档字符串或.rst文件中。例如,如果我们有如下内容:
.. doctest::
>>> print 1
>>> print [2*x for x in range(3)]
我希望当我们使用选项运行make doctest
时,它会将文档字符串更改为:
.. doctest::
>>> print 1
1
>>> print [2*x for x in range(3)]
[0,2,4]
我相信这是可能的,而且会非常方便!
推荐答案
我必须强烈(但善意)建议您不要做您想做的事情。
您问的是doctest module的"测试部分":
doctest模块搜索看起来像交互式Python会话的文本片段,然后执行这些会话以验证它们是否完全如图所示工作。
如果编写输入和预期输出,并让Python检查预期输出是否与实际输出匹配,则这些测试是有理由的。
如果让Python产生预期的输出,那么..它将不再是(由用户/作者),因此文档测试永远不会失败,因此这些测试将毫无用处。
注意:如果函数内部没有逻辑(If/Else、While循环、追加等)没有必要对它们进行测试。并且测试不得重现测试逻辑,否则它们将不再测试函数。
我发现this video关于测试驱动开发非常有趣,如果您想更多地了解这个论点,也许您会感兴趣。
好了关于使用Sphinx扩展自动生成doctest输出的教程就到这里就结束了,希望趣模板源码网找到的这篇技术文章能帮助到大家,更多技术教程可以在站内搜索。