如何将 Python 文档字符串转换为不同的样式？答案

【问题标题】：How do I convert Python docstrings to a different style?如何将 Python 文档字符串转换为不同的样式？
【发布时间】：2019-07-22 10:18:43
【问题描述】：

我正在开发一个使用Google style Python 文档字符串的代码库，我想将它们自动转换为numpy style。

是否有自动执行此操作的工具？

快速的 Google 搜索显示 pyment，但我不确定这是否合适。

【问题讨论】：

看来你已经用 pyment 回答了你自己的问题。你试过了吗？它没有做你想做的事吗？ github.com/dadadel/pyment/blob/master/doc/sphinx/source/…
我想知道是否有人有在大型代码库上使用它的经验。您对结果满意吗？
但是为什么不直接克隆代码库，使用它，然后自己看看呢？

【解决方案1】：

pyment 绝对看起来像这项工作的工具，因为它声明它可以在两个方向上在 numpydoc 和 google 文档字符串之间进行转换。

目前，输入/输出中的托管样式是 javadoc、reST 的一种变体（Sphinx 使用的重新结构化文本）、numpydoc、google 文档字符串、组（其他分组样式）。

【讨论】：