AutoDoc可以用来执行文档字符串中的代码吗?

Can autodoc be used to execute code from docstring?(AutoDoc可以用来执行文档字符串中的代码吗?)
本文介绍了AutoDoc可以用来执行文档字符串中的代码吗?的处理方法,对大家解决问题具有一定的参考价值,需要的朋友们下面随着小编来一起学习吧!

问题描述

当使用Sphinx和AutoDoc来记录一个Python项目时,您可以使用:Example:在您的模块/类/函数文档字符串中包含一个代码样例,Sphinx将友好地为您突出显示它的语法。大概是这样的。

>>> rng = Range(0, 1000)
>>> rng
[0, 1000)
>>> len(rng)
1000
>>> rng.start = 500
>>> rng.start
500
>>> rng.end
1000
>>> 

我从Python解释器复制并粘贴了这段代码。有没有办法让Sphinx或AutoDoc自动执行代码并为文档捕获输出?

我主要担心复制和粘贴的代码/输出与当前的实际代码行为不同步。

推荐答案

标准库包括doctest,可以从文本文件或文档字符串中识别、执行和验证交互示例。

这篇关于AutoDoc可以用来执行文档字符串中的代码吗?的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持编程学习网!

本站部分内容来源互联网,如果有图片或者内容侵犯您的权益请联系我们删除!

相关文档推荐

Leetcode 234: Palindrome LinkedList(Leetcode 234:回文链接列表)
How do I read an Excel file directly from Dropbox#39;s API using pandas.read_excel()?(如何使用PANDAS.READ_EXCEL()直接从Dropbox的API读取Excel文件?)
subprocess.Popen tries to write to nonexistent pipe(子进程。打开尝试写入不存在的管道)
I want to realize Popen-code from Windows to Linux:(我想实现从Windows到Linux的POpen-code:)
Reading stdout from a subprocess in real time(实时读取子进程中的标准输出)
How to call type safely on a random file in Python?(如何在Python中安全地调用随机文件上的类型?)