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

Question

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

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

所以我想可靠地检测文档字符串是否处于休息状态，以便将其传递给不同的渲染。

Answer 1

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

我想说你应该尝试将其渲染为 ReST 并为最终用户提供再次关闭它的选项。