python - 如何可靠地检测 python 文档字符串是否处于静止状态？

Question

我正在开发一个文档字符串查看器，因此我想将任何文档字符串正确转换为好看的 html。

大多数标准库中的文档字符串不在reST中，但对于大部分采用numpydoc标准的科学库来说并非如此。

所以我想可靠地检测一个文档字符串是否在 reST 中，以便将它传递给不同的渲染。

Answer 1

由于 ReST 是一种尽可能看起来像可读纯文本的格式，因此没有可靠的方法来检测是否有任何文本正在使用 ReST，更不用说像文档字符串这样小的内容了。

我想说您应该尝试将其呈现为 ReST，并为最终用户提供再次关闭它的选项。