如何可靠地检测python docstring是否处于rest状态？

Question

我正在开发一个docstring查看器，所以我想将任何docstring正确地转换成好看的html。在

大多数标准库中的docstring不在reST中，但科学图书馆不是这样，它们大部分都采用了numpydoc标准。在

所以我想可靠地检测docstring是否在reST中，以便将其传递给不同的呈现。在

Answer 1

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

我建议您应该尝试将其渲染为ReST，并给最终用户再次关闭它的选项。在